ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/IO-AIO/AIO.pm
(Generate patch)

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.252 by root, Sat Jun 13 00:06:13 2015 UTC vs.
Revision 1.256 by root, Thu Jun 25 15:47:01 2015 UTC

… …
394following POSIX and non-POSIX constants are available (missing ones on 394following POSIX and non-POSIX constants are available (missing ones on
395your system are, as usual, C<0>): 395your system are, as usual, C<0>):
396 396
397C<O_ASYNC>, C<O_DIRECT>, C<O_NOATIME>, C<O_CLOEXEC>, C<O_NOCTTY>, C<O_NOFOLLOW>, 397C<O_ASYNC>, C<O_DIRECT>, C<O_NOATIME>, C<O_CLOEXEC>, C<O_NOCTTY>, C<O_NOFOLLOW>,
398C<O_NONBLOCK>, C<O_EXEC>, C<O_SEARCH>, C<O_DIRECTORY>, C<O_DSYNC>, 398C<O_NONBLOCK>, C<O_EXEC>, C<O_SEARCH>, C<O_DIRECTORY>, C<O_DSYNC>,
399C<O_RSYNC>, C<O_SYNC> and C<O_TTY_INIT>. 399C<O_RSYNC>, C<O_SYNC>, C<O_PATH>, C<O_TMPFILE>, and C<O_TTY_INIT>.
400 400
401 401
402=item aio_close $fh, $callback->($status) 402=item aio_close $fh, $callback->($status)
403 403
404Asynchronously close a file and call the callback with the result 404Asynchronously close a file and call the callback with the result
… …
2057filesize. 2057filesize.
2058 2058
2059C<$prot> is a combination of C<IO::AIO::PROT_NONE>, C<IO::AIO::PROT_EXEC>, 2059C<$prot> is a combination of C<IO::AIO::PROT_NONE>, C<IO::AIO::PROT_EXEC>,
2060C<IO::AIO::PROT_READ> and/or C<IO::AIO::PROT_WRITE>, 2060C<IO::AIO::PROT_READ> and/or C<IO::AIO::PROT_WRITE>,
2061 2061
2062C<$flags> can be a combination of C<IO::AIO::MAP_SHARED> or 2062C<$flags> can be a combination of
2063C<IO::AIO::MAP_PRIVATE>, or a number of system-specific flags (when 2063C<IO::AIO::MAP_SHARED> or
2064not available, the are defined as 0): C<IO::AIO::MAP_ANONYMOUS> 2064C<IO::AIO::MAP_PRIVATE>,
2065or a number of system-specific flags (when not available, the are C<0>):
2065(which is set to C<MAP_ANON> if your system only provides this 2066C<IO::AIO::MAP_ANONYMOUS> (which is set to C<MAP_ANON> if your system only provides this constant),
2066constant), C<IO::AIO::MAP_HUGETLB>, C<IO::AIO::MAP_LOCKED>, 2067C<IO::AIO::MAP_HUGETLB>,
2067C<IO::AIO::MAP_NORESERVE>, C<IO::AIO::MAP_POPULATE> or 2068C<IO::AIO::MAP_LOCKED>,
2069C<IO::AIO::MAP_NORESERVE>,
2070C<IO::AIO::MAP_POPULATE>,
2068C<IO::AIO::MAP_NONBLOCK> 2071C<IO::AIO::MAP_NONBLOCK>,
2072C<IO::AIO::MAP_FIXED>,
2073C<IO::AIO::MAP_GROWSDOWN>,
2074C<IO::AIO::MAP_32BIT>,
2075C<IO::AIO::MAP_HUGETLB> or
2076C<IO::AIO::MAP_STACK>.
2069 2077
2070If C<$fh> is C<undef>, then a file descriptor of C<-1> is passed. 2078If C<$fh> is C<undef>, then a file descriptor of C<-1> is passed.
2071 2079
2072C<$offset> is the offset from the start of the file - it generally must be 2080C<$offset> is the offset from the start of the file - it generally must be
2073a multiple of C<IO::AIO::PAGESIZE> and defaults to C<0>. 2081a multiple of C<IO::AIO::PAGESIZE> and defaults to C<0>.
… …
2125 2133
2126Attempts to query or change the pipe buffer size. Obviously works only 2134Attempts to query or change the pipe buffer size. Obviously works only
2127on pipes, and currently works only on GNU/Linux systems, and fails with 2135on pipes, and currently works only on GNU/Linux systems, and fails with
2128C<-1>/C<ENOSYS> everywhere else. If anybody knows how to influence pipe buffer 2136C<-1>/C<ENOSYS> everywhere else. If anybody knows how to influence pipe buffer
2129size on other systems, drop me a note. 2137size on other systems, drop me a note.
2138
2139=item ($rfh, $wfh) = IO::AIO::pipe2 [$flags]
2140
2141This is a direct interface to the Linux L<pipe2(2)> system call. If
2142C<$flags> is missing or C<0>, then this should be the same as a call to
2143perl's built-in C<pipe> function and create a new pipe, and works on
2144systems that lack the pipe2 syscall. On win32, this case invokes C<_pipe
2145(..., 4096, O_BINARY)>.
2146
2147If C<$flags> is non-zero, it tries to invoke the pipe2 system call with
2148the given flags (Linux 2.6.27, glibc 2.9).
2149
2150On success, the read and write file handles are returned.
2151
2152On error, nothing will be returned. If the pipe2 syscall is missing and
2153C<$flags> is non-zero, fails with C<ENOSYS>.
2154
2155Please refer to L<pipe2(2)> for more info on the C<$flags>, but at the
2156time of this writing, C<IO::AIO::O_CLOEXEC>, C<IO::AIO::O_NONBLOCK> and
2157C<IO::AIO::O_DIRECT> (Linux 3.4, for packet-based pipes) were supported.
2130 2158
2131=back 2159=back
2132 2160
2133=cut 2161=cut
2134 2162

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines