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.230 by root, Fri Jul 27 17:24:06 2012 UTC vs.
Revision 1.235 by root, Wed Aug 22 22:28:03 2012 UTC

… …
168use common::sense; 168use common::sense;
169 169
170use base 'Exporter'; 170use base 'Exporter';
171 171
172BEGIN { 172BEGIN {
173 our $VERSION = '4.15'; 173 our $VERSION = '4.16';
174 174
175 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close 175 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
176 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx 176 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
177 aio_scandir aio_symlink aio_readlink aio_realpath aio_sync 177 aio_scandir aio_symlink aio_readlink aio_realpath aio_sync
178 aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range aio_fallocate 178 aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range aio_fallocate
… …
362 362
363 363
364=item aio_open $pathname, $flags, $mode, $callback->($fh) 364=item aio_open $pathname, $flags, $mode, $callback->($fh)
365 365
366Asynchronously open or create a file and call the callback with a newly 366Asynchronously open or create a file and call the callback with a newly
367created filehandle for the file. 367created filehandle for the file (or C<undef> in case of an error).
368 368
369The pathname passed to C<aio_open> must be absolute. See API NOTES, above, 369The pathname passed to C<aio_open> must be absolute. See API NOTES, above,
370for an explanation. 370for an explanation.
371 371
372The C<$flags> argument is a bitmask. See the C<Fcntl> module for a 372The C<$flags> argument is a bitmask. See the C<Fcntl> module for a
… …
603 namemax => 255, 603 namemax => 255,
604 frsize => 1024, 604 frsize => 1024,
605 fsid => 1810 605 fsid => 1810
606 } 606 }
607 607
608Here is a (likely partial) list of fsid values used by Linux - it is safe
609to hardcode these when the $^O is C<linux>:
610
611 0x0000adf5 adfs
612 0x0000adff affs
613 0x5346414f afs
614 0x09041934 anon-inode filesystem
615 0x00000187 autofs
616 0x42465331 befs
617 0x1badface bfs
618 0x42494e4d binfmt_misc
619 0x9123683e btrfs
620 0x0027e0eb cgroupfs
621 0xff534d42 cifs
622 0x73757245 coda
623 0x012ff7b7 coh
624 0x28cd3d45 cramfs
625 0x453dcd28 cramfs-wend (wrong endianness)
626 0x64626720 debugfs
627 0x00001373 devfs
628 0x00001cd1 devpts
629 0x0000f15f ecryptfs
630 0x00414a53 efs
631 0x0000137d ext
632 0x0000ef53 ext2/ext3
633 0x0000ef51 ext2
634 0x00004006 fat
635 0x65735546 fuseblk
636 0x65735543 fusectl
637 0x0bad1dea futexfs
638 0x01161970 gfs2
639 0x47504653 gpfs
640 0x00004244 hfs
641 0xf995e849 hpfs
642 0x958458f6 hugetlbfs
643 0x2bad1dea inotifyfs
644 0x00009660 isofs
645 0x000072b6 jffs2
646 0x3153464a jfs
647 0x6b414653 k-afs
648 0x0bd00bd0 lustre
649 0x0000137f minix
650 0x0000138f minix 30 char names
651 0x00002468 minix v2
652 0x00002478 minix v2 30 char names
653 0x00004d5a minix v3
654 0x19800202 mqueue
655 0x00004d44 msdos
656 0x0000564c novell
657 0x00006969 nfs
658 0x6e667364 nfsd
659 0x00003434 nilfs
660 0x5346544e ntfs
661 0x00009fa1 openprom
662 0x7461636F ocfs2
663 0x00009fa0 proc
664 0x6165676c pstorefs
665 0x0000002f qnx4
666 0x858458f6 ramfs
667 0x52654973 reiserfs
668 0x00007275 romfs
669 0x67596969 rpc_pipefs
670 0x73636673 securityfs
671 0xf97cff8c selinux
672 0x0000517b smb
673 0x534f434b sockfs
674 0x73717368 squashfs
675 0x62656572 sysfs
676 0x012ff7b6 sysv2
677 0x012ff7b5 sysv4
678 0x01021994 tmpfs
679 0x15013346 udf
680 0x00011954 ufs
681 0x54190100 ufs byteswapped
682 0x00009fa2 usbdevfs
683 0x01021997 v9fs
684 0xa501fcf5 vxfs
685 0xabba1974 xenfs
686 0x012ff7b4 xenix
687 0x58465342 xfs
688 0x012fd16d xia
608 689
609=item aio_utime $fh_or_path, $atime, $mtime, $callback->($status) 690=item aio_utime $fh_or_path, $atime, $mtime, $callback->($status)
610 691
611Works like perl's C<utime> function (including the special case of $atime 692Works like perl's C<utime> function (including the special case of $atime
612and $mtime being undef). Fractional times are supported if the underlying 693and $mtime being undef). Fractional times are supported if the underlying
… …
1277 1358
1278 aio_mlockall IO::AIO::MCL_FUTURE; 1359 aio_mlockall IO::AIO::MCL_FUTURE;
1279 1360
1280=item aio_fiemap $fh, $start, $length, $flags, $count, $cb->(\@extents) 1361=item aio_fiemap $fh, $start, $length, $flags, $count, $cb->(\@extents)
1281 1362
1282Queries the extents of the given file (by calling the Linux FIEMAP ioctl, 1363Queries the extents of the given file (by calling the Linux C<FIEMAP>
1283see L<http://cvs.schmorp.de/IO-AIO/doc/fiemap.txt> for details). If the 1364ioctl, see L<http://cvs.schmorp.de/IO-AIO/doc/fiemap.txt> for details). If
1284C<ioctl> is not available on your OS, then this request will fail with 1365the ioctl is not available on your OS, then this request will fail with
1285C<ENOSYS>. 1366C<ENOSYS>.
1286 1367
1287C<$start> is the starting offset to query extents for, C<$length> is the 1368C<$start> is the starting offset to query extents for, C<$length> is the
1288size of the range to query - if it is C<undef>, then the whole file will 1369size of the range to query - if it is C<undef>, then the whole file will
1289be queried. 1370be queried.
… …
1292C<IO::AIO::FIEMAP_FLAG_XATTR> - C<IO::AIO::FIEMAP_FLAGS_COMPAT> is also 1373C<IO::AIO::FIEMAP_FLAG_XATTR> - C<IO::AIO::FIEMAP_FLAGS_COMPAT> is also
1293exported), and is normally C<0> or C<IO::AIO::FIEMAP_FLAG_SYNC> to query 1374exported), and is normally C<0> or C<IO::AIO::FIEMAP_FLAG_SYNC> to query
1294the data portion. 1375the data portion.
1295 1376
1296C<$count> is the maximum number of extent records to return. If it is 1377C<$count> is the maximum number of extent records to return. If it is
1297C<undef>, then IO::AIO queries all extents of the file. As a very special 1378C<undef>, then IO::AIO queries all extents of the range. As a very special
1298case, if it is C<0>, then the callback receives the number of extents 1379case, if it is C<0>, then the callback receives the number of extents
1299instead of the extents themselves. 1380instead of the extents themselves (which is unreliable, see below).
1300 1381
1301If an error occurs, the callback receives no arguments. The special 1382If an error occurs, the callback receives no arguments. The special
1302C<errno> value C<IO::AIO::EBADR> is available to test for flag errors. 1383C<errno> value C<IO::AIO::EBADR> is available to test for flag errors.
1303 1384
1304Otherwise, the callback receives an array reference with extent 1385Otherwise, the callback receives an array reference with extent
… …
1306following members: 1387following members:
1307 1388
1308 [$logical, $physical, $length, $flags] 1389 [$logical, $physical, $length, $flags]
1309 1390
1310Flags is any combination of the following flag values (typically either C<0> 1391Flags is any combination of the following flag values (typically either C<0>
1311or C<IO::AIO::FIEMAP_EXTENT_LAST>): 1392or C<IO::AIO::FIEMAP_EXTENT_LAST> (1)):
1312 1393
1313C<IO::AIO::FIEMAP_EXTENT_LAST>, C<IO::AIO::FIEMAP_EXTENT_UNKNOWN>, 1394C<IO::AIO::FIEMAP_EXTENT_LAST>, C<IO::AIO::FIEMAP_EXTENT_UNKNOWN>,
1314C<IO::AIO::FIEMAP_EXTENT_DELALLOC>, C<IO::AIO::FIEMAP_EXTENT_ENCODED>, 1395C<IO::AIO::FIEMAP_EXTENT_DELALLOC>, C<IO::AIO::FIEMAP_EXTENT_ENCODED>,
1315C<IO::AIO::FIEMAP_EXTENT_DATA_ENCRYPTED>, C<IO::AIO::FIEMAP_EXTENT_NOT_ALIGNED>, 1396C<IO::AIO::FIEMAP_EXTENT_DATA_ENCRYPTED>, C<IO::AIO::FIEMAP_EXTENT_NOT_ALIGNED>,
1316C<IO::AIO::FIEMAP_EXTENT_DATA_INLINE>, C<IO::AIO::FIEMAP_EXTENT_DATA_TAIL>, 1397C<IO::AIO::FIEMAP_EXTENT_DATA_INLINE>, C<IO::AIO::FIEMAP_EXTENT_DATA_TAIL>,
1317C<IO::AIO::FIEMAP_EXTENT_UNWRITTEN>, C<IO::AIO::FIEMAP_EXTENT_MERGED> or 1398C<IO::AIO::FIEMAP_EXTENT_UNWRITTEN>, C<IO::AIO::FIEMAP_EXTENT_MERGED> or
1318C<IO::AIO::FIEMAP_EXTENT_SHARED>. 1399C<IO::AIO::FIEMAP_EXTENT_SHARED>.
1400
1401At the time of this writing (Linux 3.2), this requets is unreliable unless
1402C<$count> is C<undef>, as the kernel has all sorts of bugs preventing
1403it to return all extents of a range for files with large number of
1404extents. The code works around all these issues if C<$count> is undef.
1319 1405
1320=item aio_group $callback->(...) 1406=item aio_group $callback->(...)
1321 1407
1322This is a very special aio request: Instead of doing something, it is a 1408This is a very special aio request: Instead of doing something, it is a
1323container for other aio requests, which is useful if you want to bundle 1409container for other aio requests, which is useful if you want to bundle

Diff Legend

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