[ViewVC] Diff of: cvs/IO-AIO/README

Comparing IO-AIO/README (file contents):
Revision 1.64 by root, Wed Apr 3 03:03:53 2019 UTC vs.
Revision 1.65 by root, Fri Dec 4 01:19:58 2020 UTC

        IO::AIO::nreqs
        IO::AIO::nready
        IO::AIO::npending
        IO::AIO::reinit
-       $nfd = IO::AIO::get_fdlimit [EXPERIMENTAL]
+       $nfd = IO::AIO::get_fdlimit
-       IO::AIO::min_fdlimit $nfd [EXPERIMENTAL]
+       IO::AIO::min_fdlimit $nfd
        IO::AIO::sendfile $ofh, $ifh, $offset, $count
        IO::AIO::fadvise $fh, $offset, $len, $advice
        IO::AIO::mmap $scalar, $length, $prot, $flags[, $fh[, $offset]]
        $nanoseconds = IO::AIO::st_atimensec, IO::AIO::st_mtimensec, IO::AIO::st_ctimensec, IO::AIO::st_btimensec
        $seconds = IO::AIO::st_btimesec
        ($atime, $mtime, $ctime, $btime, ...) = IO::AIO::st_xtimensec
        # very much unportable syscalls
+       IO::AIO::accept4 $r_fh, $sockaddr, $sockaddr_len, $flags
        IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
        IO::AIO::tee $r_fh, $w_fh, $length, $flags
        $actual_size = IO::AIO::pipesize $r_fh[, $new_size]
        ($rfh, $wfh) = IO::AIO::pipe2 [$flags]
        $fh = IO::AIO::memfd_create $pathname[, $flags]
         So in general, you should only use these calls for things that do
         (filesystem) I/O, not for things that wait for other events
         (network, other processes), although if you are careful and know
         what you are doing, you still can.
-        The following constants are available (missing ones are, as usual
+        The following constants are available and can be used for normal
-        0):
+        "ioctl" and "fcntl" as well (missing ones are, as usual 0):
         "F_DUPFD_CLOEXEC",
         "F_OFD_GETLK", "F_OFD_SETLK", "F_OFD_GETLKW",
         "FIFREEZE", "FITHAW", "FITRIM", "FICLONE", "FICLONERANGE",
         "FIDEDUPERANGE".
+        "F_ADD_SEALS", "F_GET_SEALS", "F_SEAL_SEAL", "F_SEAL_SHRINK",
+        "F_SEAL_GROW" and "F_SEAL_WRITE".
         "FS_IOC_GETFLAGS", "FS_IOC_SETFLAGS", "FS_IOC_GETVERSION",
         "FS_IOC_SETVERSION", "FS_IOC_FIEMAP".
         "FS_IOC_FSGETXATTR", "FS_IOC_FSSETXATTR",
         fails the request with "ENOENT", there is often no need for error
         checking in the "aio_wd" callback, as future requests using the
         value will fail in the expected way.
     IO::AIO::CWD
-        This is a compiletime constant (object) that represents the process
+        This is a compile time constant (object) that represents the process
         current working directory.
         Specifying this object as working directory object for a pathname is
         as if the pathname would be specified directly, without a directory
         object. For example, these calls are functionally identical:
     some "Advanced I/O" function not available to in Perl, without going the
     "Asynchronous I/O" route. Many of these have an asynchronous "aio_*"
     counterpart.
     $numfd = IO::AIO::get_fdlimit
-        This function is *EXPERIMENTAL* and subject to change.
         Tries to find the current file descriptor limit and returns it, or
         "undef" and sets $! in case of an error. The limit is one larger
         than the highest valid file descriptor number.
     IO::AIO::min_fdlimit [$numfd]
-        This function is *EXPERIMENTAL* and subject to change.
         Try to increase the current file descriptor limit(s) to at least
         $numfd by changing the soft or hard file descriptor resource limit.
         If $numfd is missing, it will try to set a very high limit, although
         this is not recommended when you know the actual minimum that you
         require.
         Calls the "munlockall" function.
         On systems that do not implement "munlockall", this function returns
         ENOSYS, otherwise the return value of "munlockall".
+    $fh = IO::AIO::accept4 $r_fh, $sockaddr, $sockaddr_maxlen, $flags
+        Uses the GNU/Linux accept4(2) syscall, if available, to accept a
+        socket and return the new file handle on success, or sets $! and
+        returns "undef" on error.
+        The remote name of the new socket will be stored in $sockaddr, which
+        will be extended to allow for at least $sockaddr_maxlen octets. If
+        the socket name does not fit into $sockaddr_maxlen octets, this is
+        signaled by returning a longer string in $sockaddr, which might or
+        might not be truncated.
+        To accept name-less sockets, use "undef" for $sockaddr and 0 for
+        $sockaddr_maxlen.
+        The main reasons to use this syscall rather than portable
+        C«accept(2)> are that you can specify "SOCK_NONBLOCK" and/or
+        "SOCK_CLOEXEC" flags and you can accept name-less sockets by
+        specifying 0 for $sockaddr_maxlen, which is sadly not possible with
+        perl's interface to "accept".
     IO::AIO::splice $r_fh, $r_off, $w_fh, $w_off, $length, $flags
         Calls the GNU/Linux splice(2) syscall, if available. If $r_off or
         $w_off are "undef", then "NULL" is passed for these, otherwise they
         should be the file offset.
     I am not sure anything can be done about this, so this is considered a
     known issue, rather than a bug.
 SEE ALSO
     AnyEvent::AIO for easy integration into event loops, Coro::AIO for a
-    more natural syntax.
+    more natural syntax and IO::FDPass for file descriptor passing.
 AUTHOR
      Marc Lehmann <schmorp@schmorp.de>
      http://home.schmorp.de/

Diff Legend

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

Comparing IO-AIO/README (file contents): Revision 1.64 by root, Wed Apr 3 03:03:53 2019 UTC vs. Revision 1.65 by root, Fri Dec 4 01:19:58 2020 UTC

Diff Legend

Comparing IO-AIO/README (file contents):
Revision 1.64 by root, Wed Apr 3 03:03:53 2019 UTC vs.
Revision 1.65 by root, Fri Dec 4 01:19:58 2020 UTC