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.278 by root, Sun Oct 1 07:24:34 2017 UTC vs.
Revision 1.281 by root, Tue Feb 20 04:32:59 2018 UTC

… …
171use common::sense; 171use common::sense;
172 172
173use base 'Exporter'; 173use base 'Exporter';
174 174
175BEGIN { 175BEGIN {
176 our $VERSION = 4.35; 176 our $VERSION = 4.4;
177 177
178 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close 178 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
179 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx 179 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
180 aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl 180 aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl
181 aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range 181 aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range
… …
183 aio_rename aio_rename2 aio_link aio_move aio_copy aio_group 183 aio_rename aio_rename2 aio_link aio_move aio_copy aio_group
184 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown 184 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown
185 aio_chmod aio_utime aio_truncate 185 aio_chmod aio_utime aio_truncate
186 aio_msync aio_mtouch aio_mlock aio_mlockall 186 aio_msync aio_mtouch aio_mlock aio_mlockall
187 aio_statvfs 187 aio_statvfs
188 aio_slurp
188 aio_wd); 189 aio_wd);
189 190
190 our @EXPORT = (@AIO_REQ, qw(aioreq_pri aioreq_nice)); 191 our @EXPORT = (@AIO_REQ, qw(aioreq_pri aioreq_nice));
191 our @EXPORT_OK = qw(poll_fileno poll_cb poll_wait flush 192 our @EXPORT_OK = qw(poll_fileno poll_cb poll_wait flush
192 min_parallel max_parallel max_idle idle_timeout 193 min_parallel max_parallel max_idle idle_timeout
… …
611 namemax => 255, 612 namemax => 255,
612 frsize => 1024, 613 frsize => 1024,
613 fsid => 1810 614 fsid => 1810
614 } 615 }
615 616
616Here is a (likely partial - send me updates!) list of fsid values used by
617Linux - it is safe to hardcode these when C<$^O> is C<linux>:
618
619 0x0000adf5 adfs
620 0x0000adff affs
621 0x5346414f afs
622 0x09041934 anon-inode filesystem
623 0x00000187 autofs
624 0x42465331 befs
625 0x1badface bfs
626 0x42494e4d binfmt_misc
627 0x9123683e btrfs
628 0x0027e0eb cgroupfs
629 0xff534d42 cifs
630 0x73757245 coda
631 0x012ff7b7 coh
632 0x28cd3d45 cramfs
633 0x453dcd28 cramfs-wend (wrong endianness)
634 0x64626720 debugfs
635 0x00001373 devfs
636 0x00001cd1 devpts
637 0x0000f15f ecryptfs
638 0x00414a53 efs
639 0x0000137d ext
640 0x0000ef53 ext2/ext3/ext4
641 0x0000ef51 ext2
642 0xf2f52010 f2fs
643 0x00004006 fat
644 0x65735546 fuseblk
645 0x65735543 fusectl
646 0x0bad1dea futexfs
647 0x01161970 gfs2
648 0x47504653 gpfs
649 0x00004244 hfs
650 0xf995e849 hpfs
651 0x00c0ffee hostfs
652 0x958458f6 hugetlbfs
653 0x2bad1dea inotifyfs
654 0x00009660 isofs
655 0x000072b6 jffs2
656 0x3153464a jfs
657 0x6b414653 k-afs
658 0x0bd00bd0 lustre
659 0x0000137f minix
660 0x0000138f minix 30 char names
661 0x00002468 minix v2
662 0x00002478 minix v2 30 char names
663 0x00004d5a minix v3
664 0x19800202 mqueue
665 0x00004d44 msdos
666 0x0000564c novell
667 0x00006969 nfs
668 0x6e667364 nfsd
669 0x00003434 nilfs
670 0x5346544e ntfs
671 0x00009fa1 openprom
672 0x7461636F ocfs2
673 0x00009fa0 proc
674 0x6165676c pstorefs
675 0x0000002f qnx4
676 0x68191122 qnx6
677 0x858458f6 ramfs
678 0x52654973 reiserfs
679 0x00007275 romfs
680 0x67596969 rpc_pipefs
681 0x73636673 securityfs
682 0xf97cff8c selinux
683 0x0000517b smb
684 0x534f434b sockfs
685 0x73717368 squashfs
686 0x62656572 sysfs
687 0x012ff7b6 sysv2
688 0x012ff7b5 sysv4
689 0x01021994 tmpfs
690 0x15013346 udf
691 0x00011954 ufs
692 0x54190100 ufs byteswapped
693 0x00009fa2 usbdevfs
694 0x01021997 v9fs
695 0xa501fcf5 vxfs
696 0xabba1974 xenfs
697 0x012ff7b4 xenix
698 0x58465342 xfs
699 0x012fd16d xia
700
701=item aio_utime $fh_or_path, $atime, $mtime, $callback->($status) 617=item aio_utime $fh_or_path, $atime, $mtime, $callback->($status)
702 618
703Works like perl's C<utime> function (including the special case of $atime 619Works like perl's C<utime> function (including the special case of $atime
704and $mtime being undef). Fractional times are supported if the underlying 620and $mtime being undef). Fractional times are supported if the underlying
705syscalls support them. 621syscalls support them.
… …
926C<$type>'s are known, which can be used to speed up some algorithms. 842C<$type>'s are known, which can be used to speed up some algorithms.
927 843
928=back 844=back
929 845
930 846
847=item aio_slurp $pathname, $offset, $length, $data, $callback->($status)
848
849Opens, reads and closes the given file. The data is put into C<$data>,
850which is resized as required.
851
852If C<$offset> is negative, then it is counted from the end of the file.
853
854If C<$length> is zero, then the remaining length of the file is
855used. Also, in this case, the same limitations to modifying C<$data> apply
856as when IO::AIO::mmap is used, i.e. it must only be modified in-place
857with C<substr>. If the size of the file is known, specifying a non-zero
858C<$length> results in a performance advantage.
859
860This request is similar to the older C<aio_load> request, but since it is
861a single request, it might be more efficient to use.
862
863Example: load F</etc/passwd> into C<$passwd>.
864
865 my $passwd;
866 aio_slurp "/etc/passwd", 0, 0, $passwd, sub {
867 $_[0] >= 0
868 or die "/etc/passwd: $!\n";
869
870 printf "/etc/passwd is %d bytes long, and contains:\n", length $passwd;
871 print $passwd;
872 };
873 IO::AIO::flush;
874
875
931=item aio_load $pathname, $data, $callback->($status) 876=item aio_load $pathname, $data, $callback->($status)
932 877
933This is a composite request that tries to fully load the given file into 878This is a composite request that tries to fully load the given file into
934memory. Status is the same as with aio_read. 879memory. Status is the same as with aio_read.
880
881Using C<aio_slurp> might be more efficient, as it is a single request.
935 882
936=cut 883=cut
937 884
938sub aio_load($$;$) { 885sub aio_load($$;$) {
939 my ($path, undef, $cb) = @_; 886 my ($path, undef, $cb) = @_;
… …
2268 2215
2269Please refer to L<pipe2(2)> for more info on the C<$flags>, but at the 2216Please refer to L<pipe2(2)> for more info on the C<$flags>, but at the
2270time of this writing, C<IO::AIO::O_CLOEXEC>, C<IO::AIO::O_NONBLOCK> and 2217time of this writing, C<IO::AIO::O_CLOEXEC>, C<IO::AIO::O_NONBLOCK> and
2271C<IO::AIO::O_DIRECT> (Linux 3.4, for packet-based pipes) were supported. 2218C<IO::AIO::O_DIRECT> (Linux 3.4, for packet-based pipes) were supported.
2272 2219
2220Example: create a pipe race-free w.r.t. threads and fork:
2221
2222 my ($rfh, $wfh) = IO::AIO::pipe2 IO::AIO::O_CLOEXEC
2223 or die "pipe2: $!\n";
2224
2225=item $fh = IO::AIO::eventfd ([$initval, [$flags]])
2226
2227This is a direct interface to the Linux L<eventfd(2)> system call. The
2228(unhelpful) defaults for C<$initval> and C<$flags> are C<0> for both.
2229
2230On success, the new eventfd filehandle is returned, otherwise returns
2231C<undef>. If the eventfd syscall is missing, fails with C<ENOSYS>.
2232
2233Please refer to L<eventfd(2)> for more info on this call.
2234
2235The following symbol flag values are available: C<IO::AIO::EFD_CLOEXEC>,
2236C<IO::AIO::EFD_NONBLOCK> and C<IO::AIO::EFD_SEMAPHORE> (Linux 2.6.30).
2237
2273=back 2238=back
2274 2239
2275=cut 2240=cut
2276 2241
2277min_parallel 8; 2242min_parallel 8;

Diff Legend

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