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.259 by root, Tue Feb 23 19:42:43 2016 UTC vs.
Revision 1.263 by root, Tue Jul 12 20:46:33 2016 UTC

… …
167use common::sense; 167use common::sense;
168 168
169use base 'Exporter'; 169use base 'Exporter';
170 170
171BEGIN { 171BEGIN {
172 our $VERSION = 4.33; 172 our $VERSION = 4.34;
173 173
174 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close 174 our @AIO_REQ = qw(aio_sendfile aio_seek aio_read aio_write aio_open aio_close
175 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx 175 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
176 aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl 176 aio_scandir aio_symlink aio_readlink aio_realpath aio_fcntl aio_ioctl
177 aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range 177 aio_sync aio_fsync aio_syncfs aio_fdatasync aio_sync_file_range
… …
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
… …
524whole pages, so that offset is effectively rounded down to a page boundary 524whole pages, so that offset is effectively rounded down to a page boundary
525and bytes are read up to the next page boundary greater than or equal to 525and bytes are read up to the next page boundary greater than or equal to
526(off-set+length). C<aio_readahead> does not read beyond the end of the 526(off-set+length). C<aio_readahead> does not read beyond the end of the
527file. The current file offset of the file is left unchanged. 527file. The current file offset of the file is left unchanged.
528 528
529If that syscall doesn't exist (likely if your OS isn't Linux) it will be 529If that syscall doesn't exist (likely if your kernel isn't Linux) it will
530emulated by simply reading the data, which would have a similar effect. 530be emulated by simply reading the data, which would have a similar effect.
531 531
532 532
533=item aio_stat $fh_or_path, $callback->($status) 533=item aio_stat $fh_or_path, $callback->($status)
534 534
535=item aio_lstat $fh, $callback->($status) 535=item aio_lstat $fh, $callback->($status)
… …
2041=item IO::AIO::madvise $scalar, $offset, $len, $advice 2041=item IO::AIO::madvise $scalar, $offset, $len, $advice
2042 2042
2043Simply calls the C<posix_madvise> function (see its 2043Simply calls the C<posix_madvise> function (see its
2044manpage for details). The following advice constants are 2044manpage for details). The following advice constants are
2045available: C<IO::AIO::MADV_NORMAL>, C<IO::AIO::MADV_SEQUENTIAL>, 2045available: 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>. 2046C<IO::AIO::MADV_RANDOM>, C<IO::AIO::MADV_WILLNEED>, C<IO::AIO::MADV_DONTNEED>,
2047C<IO::AIO::MADV_FREE>.
2047 2048
2048On systems that do not implement C<posix_madvise>, this function returns 2049On systems that do not implement C<posix_madvise>, this function returns
2049ENOSYS, otherwise the return value of C<posix_madvise>. 2050ENOSYS, otherwise the return value of C<posix_madvise>.
2050 2051
2051=item IO::AIO::mprotect $scalar, $offset, $len, $protect 2052=item IO::AIO::mprotect $scalar, $offset, $len, $protect

Diff Legend

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