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.261 by root, Sat May 21 04:43:31 2016 UTC vs.
Revision 1.264 by root, Mon Jul 18 07:48:01 2016 UTC

… …
510As native sendfile syscalls (as practically any non-POSIX interface hacked 510As native sendfile syscalls (as practically any non-POSIX interface hacked
511together in a hurry to improve benchmark numbers) tend to be rather buggy 511together in a hurry to improve benchmark numbers) tend to be rather buggy
512on many systems, this implementation tries to work around some known bugs 512on many systems, this implementation tries to work around some known bugs
513in Linux and FreeBSD kernels (probably others, too), but that might fail, 513in Linux and FreeBSD kernels (probably others, too), but that might fail,
514so you really really should check the return value of C<aio_sendfile> - 514so you really really should check the return value of C<aio_sendfile> -
515fewre bytes than expected might have been transferred. 515fewer bytes than expected might have been transferred.
516 516
517 517
518=item aio_readahead $fh,$offset,$length, $callback->($retval) 518=item aio_readahead $fh,$offset,$length, $callback->($retval)
519 519
520C<aio_readahead> populates the page cache with data from a file so that 520C<aio_readahead> populates the page cache with data from a file so that
… …
1248So in general, you should only use these calls for things that do 1248So in general, you should only use these calls for things that do
1249(filesystem) I/O, not for things that wait for other events (network, 1249(filesystem) I/O, not for things that wait for other events (network,
1250other processes), although if you are careful and know what you are doing, 1250other processes), although if you are careful and know what you are doing,
1251you still can. 1251you still can.
1252 1252
1253The following constants are available (missing ones are, as usual C<0>):
1254
1255C<FIFREEZE>, C<FITHAW>, C<FITRIM>, C<FICLONE>, C<FICLONERANGE>, C<FIDEDUPERANGE>.
1256
1257C<FS_IOC_GETFLAGS>, C<FS_IOC_SETFLAGS>, C<FS_IOC_GETVERSION>, C<FS_IOC_SETVERSION>,
1258C<FS_IOC_FIEMAP>.
1259
1260C<FS_IOC_FSGETXATTR>, C<FS_IOC_FSSETXATTR>, C<FS_IOC_SET_ENCRYPTION_POLICY>,
1261C<FS_IOC_GET_ENCRYPTION_PWSALT>, C<FS_IOC_GET_ENCRYPTION_POLICY>, C<FS_KEY_DESCRIPTOR_SIZE>.
1262
1263C<FS_SECRM_FL>, C<FS_UNRM_FL>, C<FS_COMPR_FL>, C<FS_SYNC_FL>, C<FS_IMMUTABLE_FL>,
1264C<FS_APPEND_FL>, C<FS_NODUMP_FL>, C<FS_NOATIME_FL>, C<FS_DIRTY_FL>,
1265C<FS_COMPRBLK_FL>, C<FS_NOCOMP_FL>, C<FS_ENCRYPT_FL>, C<FS_BTREE_FL>,
1266C<FS_INDEX_FL>, C<FS_JOURNAL_DATA_FL>, C<FS_NOTAIL_FL>, C<FS_DIRSYNC_FL>, C<FS_TOPDIR_FL>,
1267C<FS_FL_USER_MODIFIABLE>.
1268
1269C<FS_XFLAG_REALTIME>, C<FS_XFLAG_PREALLOC>, C<FS_XFLAG_IMMUTABLE>, C<FS_XFLAG_APPEND>,
1270C<FS_XFLAG_SYNC>, C<FS_XFLAG_NOATIME>, C<FS_XFLAG_NODUMP>, C<FS_XFLAG_RTINHERIT>,
1271C<FS_XFLAG_PROJINHERIT>, C<FS_XFLAG_NOSYMLINKS>, C<FS_XFLAG_EXTSIZE>, C<FS_XFLAG_EXTSZINHERIT>,
1272C<FS_XFLAG_NODEFRAG>, C<FS_XFLAG_FILESTREAM>, C<FS_XFLAG_DAX>, C<FS_XFLAG_HASATTR>,
1273
1253=item aio_sync $callback->($status) 1274=item aio_sync $callback->($status)
1254 1275
1255Asynchronously call sync and call the callback when finished. 1276Asynchronously call sync and call the callback when finished.
1256 1277
1257=item aio_fsync $fh, $callback->($status) 1278=item aio_fsync $fh, $callback->($status)
… …
2041=item IO::AIO::madvise $scalar, $offset, $len, $advice 2062=item IO::AIO::madvise $scalar, $offset, $len, $advice
2042 2063
2043Simply calls the C<posix_madvise> function (see its 2064Simply calls the C<posix_madvise> function (see its
2044manpage for details). The following advice constants are 2065manpage for details). The following advice constants are
2045available: C<IO::AIO::MADV_NORMAL>, C<IO::AIO::MADV_SEQUENTIAL>, 2066available: C<IO::AIO::MADV_NORMAL>, C<IO::AIO::MADV_SEQUENTIAL>,
2046C<IO::AIO::MADV_RANDOM>, C<IO::AIO::MADV_WILLNEED>, C<IO::AIO::MADV_DONTNEED>. 2067C<IO::AIO::MADV_RANDOM>, C<IO::AIO::MADV_WILLNEED>, C<IO::AIO::MADV_DONTNEED>,
2068C<IO::AIO::MADV_FREE>.
2047 2069
2048On systems that do not implement C<posix_madvise>, this function returns 2070On systems that do not implement C<posix_madvise>, this function returns
2049ENOSYS, otherwise the return value of C<posix_madvise>. 2071ENOSYS, otherwise the return value of C<posix_madvise>.
2050 2072
2051=item IO::AIO::mprotect $scalar, $offset, $len, $protect 2073=item IO::AIO::mprotect $scalar, $offset, $len, $protect

Diff Legend

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