--- IO-AIO/AIO.pm	2008/10/22 16:30:49	1.141
+++ IO-AIO/AIO.pm	2009/04/21 20:06:05	1.146
@@ -195,12 +195,12 @@
 use base 'Exporter';
 
 BEGIN {
-   our $VERSION = '3.16';
+   our $VERSION = '3.19';
 
    our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close
                      aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir
                      aio_scandir aio_symlink aio_readlink aio_sync aio_fsync
-                     aio_fdatasync aio_pathsync aio_readahead
+                     aio_fdatasync aio_sync_file_range aio_pathsync aio_readahead
                      aio_rename aio_link aio_move aio_copy aio_group
                      aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown
                      aio_chmod aio_utime aio_truncate);
@@ -211,6 +211,8 @@
                        nreqs nready npending nthreads
                        max_poll_time max_poll_reqs);
 
+   push @AIO_REQ, qw(aio_busy); # not exported
+
    @IO::AIO::GRP::ISA = 'IO::AIO::REQ';
 
    require XSLoader;
@@ -338,16 +340,20 @@
 
 =item aio_write $fh,$offset,$length, $data,$dataoffset, $callback->($retval)
 
-Reads or writes C<$length> bytes from the specified C<$fh> and C<$offset>
-into the scalar given by C<$data> and offset C<$dataoffset> and calls the
-callback without the actual number of bytes read (or -1 on error, just
-like the syscall).
+Reads or writes C<$length> bytes from or to the specified C<$fh> and
+C<$offset> into the scalar given by C<$data> and offset C<$dataoffset>
+and calls the callback without the actual number of bytes read (or -1 on
+error, just like the syscall).
+
+C<aio_read> will, like C<sysread>, shrink or grow the C<$data> scalar to
+offset plus the actual number of bytes read.
 
 If C<$offset> is undefined, then the current file descriptor offset will
 be used (and updated), otherwise the file descriptor offset will not be
 changed by these calls.
 
-If C<$length> is undefined in C<aio_write>, use the remaining length of C<$data>.
+If C<$length> is undefined in C<aio_write>, use the remaining length of
+C<$data>.
 
 If C<$dataoffset> is less than zero, it will be counted from the end of
 C<$data>.
@@ -857,6 +863,18 @@
 If this call isn't available because your OS lacks it or it couldn't be
 detected, it will be emulated by calling C<fsync> instead.
 
+=item aio_sync_file_range $fh, $offset, $nbytes, $flags, $callback->($status)
+
+Sync the data portion of the file specified by C<$offset> and C<$length>
+to disk (but NOT the metadata), by calling the Linux-specific
+sync_file_range call. If sync_file_range is not available or it returns
+ENOSYS, then fdatasync or fsync is being substituted.
+
+C<$flags> can be a combination of C<IO::AIO::SYNC_FILE_RANGE_WAIT_BEFORE>,
+C<IO::AIO::SYNC_FILE_RANGE_WRITE> and
+C<IO::AIO::SYNC_FILE_RANGE_WAIT_AFTER>: refer to the sync_file_range
+manpage for details.
+
 =item aio_pathsync $path, $callback->($status)
 
 This request tries to open, fsync and close the given path. This is a