[ViewVC] Diff of: cvs/IO-AIO/AIO.pm

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.315 by root, Mon Sep 5 00:03:32 2022 UTC vs.
Revision 1.319 by root, Wed Sep 27 03:09:57 2023 UTC

 use common::sense;
 use base 'Exporter';
 BEGIN {
-   our $VERSION = 4.77;
+   our $VERSION = 4.80;
    our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
                      aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
                      aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl
                      aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range
                        max_poll_time max_poll_reqs
                        sendfile fadvise madvise
                        mmap munmap mremap munlock munlockall
                        accept4 tee splice pipe2 pipesize
-                       fexecve memfd_create eventfd
+                       fexecve mount umount memfd_create eventfd
                        timerfd_create timerfd_settime timerfd_gettime
                        pidfd_open pidfd_send_signal pidfd_getfd);
    push @AIO_REQ, qw(aio_busy); # not exported
    $fh = IO::AIO::pidfd_open $pid[, $flags]
    $status = IO::AIO::pidfd_send_signal $pidfh, $signal[, $siginfo[, $flags]]
    $fh = IO::AIO::pidfd_getfd $pidfh, $targetfd[, $flags]
+   $retval = IO::AIO::mount $special, $path, $fstype, $flags = 0, $data = undef
+   $retval = IO::AIO::umount $path, $flags = 0
 =head2 API NOTES
 All the C<aio_*> calls are more or less thin wrappers around the syscall
 with the same name (sans C<aio_>). The arguments are similar or identical,
 and they all accept an additional (and optional) C<$callback> argument
 =item aio_open $pathname, $flags, $mode, $callback->($fh)
 Asynchronously open or create a file and call the callback with a newly
 created filehandle for the file (or C<undef> in case of an error).
-The pathname passed to C<aio_open> must be absolute. See API NOTES, above,
-for an explanation.
 The C<$flags> argument is a bitmask. See the C<Fcntl> module for a
 list. They are the same as used by C<sysopen>.
 Likewise, C<$mode> specifies the mode of the newly created file, if it
 didn't exist and C<O_CREAT> has been given, just like perl's C<sysopen>,
 Works almost exactly like perl's C<stat> or C<lstat> in void context. The
 callback will be called after the stat and the results will be available
 using C<stat _> or C<-s _> and other tests (with the exception of C<-B>
 and C<-T>).
-The pathname passed to C<aio_stat> must be absolute. See API NOTES, above,
-for an explanation.
 Currently, the stats are always 64-bit-stats, i.e. instead of returning an
 error when stat'ing a large file, the results will be silently truncated
 unless perl itself is compiled with large file support.
          my @stat = stat $src_fh; # hmm, might block over nfs?
          aioreq_pri $pri;
          add $grp aio_open $dst, O_CREAT | O_WRONLY | O_TRUNC, 0200, sub {
             if (my $dst_fh = $_[0]) {
+               # best-effort preallocate
+               aioreq_pri $pri;
+               add $grp aio_allocate $dst_fh, IO::AIO::FALLOC_FL_KEEP_SIZE, 0, $stat[7], sub { };
                aioreq_pri $pri;
                add $grp aio_sendfile $dst_fh, $src_fh, 0, $stat[7], sub {
                   if ($_[0] == $stat[7]) {
                      $grp->result (0);
                      close $src_fh;
 C<FS_XFLAG_REALTIME>, C<FS_XFLAG_PREALLOC>, C<FS_XFLAG_IMMUTABLE>, C<FS_XFLAG_APPEND>,
 C<FS_XFLAG_SYNC>, C<FS_XFLAG_NOATIME>, C<FS_XFLAG_NODUMP>, C<FS_XFLAG_RTINHERIT>,
 C<FS_XFLAG_PROJINHERIT>, C<FS_XFLAG_NOSYMLINKS>, C<FS_XFLAG_EXTSIZE>, C<FS_XFLAG_EXTSZINHERIT>,
 C<FS_XFLAG_NODEFRAG>, C<FS_XFLAG_FILESTREAM>, C<FS_XFLAG_DAX>, C<FS_XFLAG_HASATTR>,
+C<BLKROSET>, C<BLKROGET>, C<BLKRRPART>, C<BLKGETSIZE>, C<BLKFLSBUF>, C<BLKRASET>,
+C<BLKRAGET>, C<BLKFRASET>, C<BLKFRAGET>, C<BLKSECTSET>, C<BLKSECTGET>, C<BLKSSZGET>,
+C<BLKBSZGET>, C<BLKBSZSET>, C<BLKGETSIZE64>,
 =item aio_sync $callback->($status)
 Asynchronously call sync and call the callback when finished.
 =item aio_fsync $fh, $callback->($status)
 =item $retval = IO::AIO::fexecve $fh, $argv, $envp
 A more-or-less direct equivalent to the POSIX C<fexecve> functions, which
 allows you to specify the program to be executed via a file descriptor (or
 handle). Returns C<-1> and sets errno to C<ENOSYS> if not available.
+=item $retval = IO::AIO::mount $special, $path, $fstype, $flags = 0, $data = undef
+Calls the GNU/Linux mount syscall with the given arguments. All except
+C<$flags> are strings, and if C<$data> is C<undef>, a C<NULL> will be
+passed.
+The following values for C<$flags> are available:
+C<IO::AIO::MS_RDONLY>, C<IO::AIO::MS_NOSUID>, C<IO::AIO::MS_NODEV>, C<IO::AIO::MS_NOEXEC>, C<IO::AIO::MS_SYNCHRONOUS>,
+C<IO::AIO::MS_REMOUNT>, C<IO::AIO::MS_MANDLOCK>, C<IO::AIO::MS_DIRSYNC>, C<IO::AIO::MS_NOATIME>,
+C<IO::AIO::MS_NODIRATIME>, C<IO::AIO::MS_BIND>, C<IO::AIO::MS_MOVE>, C<IO::AIO::MS_REC>, C<IO::AIO::MS_SILENT>,
+C<IO::AIO::MS_POSIXACL>, C<IO::AIO::MS_UNBINDABLE>, C<IO::AIO::MS_PRIVATE>, C<IO::AIO::MS_SLAVE>, C<IO::AIO::MS_SHARED>,
+C<IO::AIO::MS_RELATIME>, C<IO::AIO::MS_KERNMOUNT>, C<IO::AIO::MS_I_VERSION>, C<IO::AIO::MS_STRICTATIME>,
+C<IO::AIO::MS_LAZYTIME>, C<IO::AIO::MS_ACTIVE>, C<IO::AIO::MS_NOUSER>, C<IO::AIO::MS_RMT_MASK>, C<IO::AIO::MS_MGC_VAL> and
+C<IO::AIO::MS_MGC_MSK>.
+=item $retval = IO::AIO::umount $path, $flags = 0
+Invokes the GNU/Linux C<umount> or C<umount2> syscalls. Always calls
+C<umount> if C<$flags> is C<0>, otherwqise always tries to call
+C<umount2>.
+The following C<$flags> are available:
+C<IO::AIO::MNT_FORCE>, C<IO::AIO::MNT_DETACH>, C<IO::AIO::MNT_EXPIRE> and C<IO::AIO::UMOUNT_NOFOLLOW>.
 =item $numfd = IO::AIO::get_fdlimit
 Tries to find the current file descriptor limit and returns it, or
 C<undef> and sets C<$!> in case of an error. The limit is one larger than

Diff Legend

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

Comparing IO-AIO/AIO.pm (file contents): Revision 1.315 by root, Mon Sep 5 00:03:32 2022 UTC vs. Revision 1.319 by root, Wed Sep 27 03:09:57 2023 UTC

Diff Legend

Comparing IO-AIO/AIO.pm (file contents):
Revision 1.315 by root, Mon Sep 5 00:03:32 2022 UTC vs.
Revision 1.319 by root, Wed Sep 27 03:09:57 2023 UTC