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.111 by root, Mon Aug 13 12:08:13 2007 UTC vs.
Revision 1.113 by root, Thu Sep 20 14:06:21 2007 UTC

329Reads or writes C<$length> bytes from the specified C<$fh> and C<$offset> 329Reads or writes C<$length> bytes from the specified C<$fh> and C<$offset>
330into the scalar given by C<$data> and offset C<$dataoffset> and calls the 330into the scalar given by C<$data> and offset C<$dataoffset> and calls the
331callback without the actual number of bytes read (or -1 on error, just 331callback without the actual number of bytes read (or -1 on error, just
332like the syscall). 332like the syscall).
333 333
334If C<$offset> is undefined, then the current file offset will be used (and 334If C<$offset> is undefined, then the current file descriptor offset will
335updated), otherwise the file offset will not be changed by these calls. 335be used (and updated), otherwise the file descriptor offset will not be
336changed by these calls.
336 337
337If C<$length> is undefined in C<aio_write>, use the remaining length of C<$data>. 338If C<$length> is undefined in C<aio_write>, use the remaining length of C<$data>.
338 339
339If C<$dataoffset> is less than zero, it will be counted from the end of 340If C<$dataoffset> is less than zero, it will be counted from the end of
340C<$data>. 341C<$data>.
1206This is a very bad function to use in interactive programs because it 1207This is a very bad function to use in interactive programs because it
1207blocks, and a bad way to reduce concurrency because it is inexact: Better 1208blocks, and a bad way to reduce concurrency because it is inexact: Better
1208use an C<aio_group> together with a feed callback. 1209use an C<aio_group> together with a feed callback.
1209 1210
1210Sets the maximum number of outstanding requests to C<$nreqs>. If you 1211Sets the maximum number of outstanding requests to C<$nreqs>. If you
1211to queue up more than this number of requests, the next call to the 1212do queue up more than this number of requests, the next call to the
1212C<poll_cb> (and C<poll_some> and other functions calling C<poll_cb>) 1213C<poll_cb> (and C<poll_some> and other functions calling C<poll_cb>)
1213function will block until the limit is no longer exceeded. 1214function will block until the limit is no longer exceeded.
1214 1215
1215The default value is very large, so there is no practical limit on the 1216The default value is very large, so there is no practical limit on the
1216number of outstanding requests. 1217number of outstanding requests.

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines