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.26 by root, Sun Aug 7 03:34:07 2005 UTC vs.
Revision 1.30 by root, Wed Aug 17 04:47:38 2005 UTC

… …
63use base 'Exporter'; 63use base 'Exporter';
64 64
65use Fcntl (); 65use Fcntl ();
66 66
67BEGIN { 67BEGIN {
68 $VERSION = 1.1; 68 $VERSION = 1.2;
69 69
70 @EXPORT = qw(aio_read aio_write aio_open aio_close aio_stat aio_lstat aio_unlink 70 @EXPORT = qw(aio_read aio_write aio_open aio_close aio_stat aio_lstat aio_unlink
71 aio_fsync aio_fdatasync aio_readahead); 71 aio_rmdir aio_symlink aio_fsync aio_fdatasync aio_readahead);
72 @EXPORT_OK = qw(poll_fileno poll_cb min_parallel max_parallel max_outstanding nreqs); 72 @EXPORT_OK = qw(poll_fileno poll_cb min_parallel max_parallel max_outstanding nreqs);
73 73
74 require XSLoader; 74 require XSLoader;
75 XSLoader::load IO::AIO, $VERSION; 75 XSLoader::load IO::AIO, $VERSION;
76} 76}
… …
88syscall has been executed asynchronously. 88syscall has been executed asynchronously.
89 89
90All functions expecting a filehandle keep a copy of the filehandle 90All functions expecting a filehandle keep a copy of the filehandle
91internally until the request has finished. 91internally until the request has finished.
92 92
93The filenames you pass to these routines I<must> be absolute. The reason 93The pathnames you pass to these routines I<must> be absolute and
94for this is that at the time the request is being executed, the current 94encoded in byte form. The reason for the former is that at the time the
95working directory could have changed. Alternatively, you can make sure 95request is being executed, the current working directory could have
96that you never change the current working directory. 96changed. Alternatively, you can make sure that you never change the
97current working directory.
98
99To encode pathnames to byte form, either make sure you either: a)
100always pass in filenames you got from outside (command line, readdir
101etc.), b) are ASCII or ISO 8859-1, c) use the Encode module and encode
102your pathnames to the locale (or other) encoding in effect in the user
103environment, d) use Glib::filename_from_unicode on unicode filenames or e)
104use something else.
97 105
98=over 4 106=over 4
99 107
100=item aio_open $pathname, $flags, $mode, $callback 108=item aio_open $pathname, $flags, $mode, $callback
101 109
… …
191=item aio_unlink $pathname, $callback 199=item aio_unlink $pathname, $callback
192 200
193Asynchronously unlink (delete) a file and call the callback with the 201Asynchronously unlink (delete) a file and call the callback with the
194result code. 202result code.
195 203
204=item aio_rmdir $pathname, $callback
205
206Asynchronously rmdir (delete) a directory and call the callback with the
207result code.
208
196=item aio_fsync $fh, $callback 209=item aio_fsync $fh, $callback
197 210
198Asynchronously call fsync on the given filehandle and call the callback 211Asynchronously call fsync on the given filehandle and call the callback
199with the fsync result code. 212with the fsync result code.
200 213
… …
318 331
319 # try to generate nice filehandles 332 # try to generate nice filehandles
320 my $sym = "IO::AIO::fd#$_[0]"; 333 my $sym = "IO::AIO::fd#$_[0]";
321 local *$sym; 334 local *$sym;
322 335
323 open *$sym, "+<&$_[0]" # usually under any unix 336 open *$sym, "+<&=$_[0]" # usually works under any unix
324 or open *$sym, "<&$_[0]" # cygwin needs this 337 or open *$sym, "<&=$_[0]" # cygwin needs this
325 or open *$sym, ">&$_[0]" # cygwin needs this 338 or open *$sym, ">&=$_[0]" # or this
326 or return undef; 339 or return undef;
327 340
328 *$sym 341 *$sym
329} 342}
330 343
… …
334 max_parallel 0; 347 max_parallel 0;
335} 348}
336 349
3371; 3501;
338 351
352=head2 FORK BEHAVIOUR
353
354Before the fork IO::AIO first handles all outstanding requests - if other
355threads add requests during this period, this time is prolonged. It then
356enters a quiescent state where no requests can be added in other threads
357and no results will be processed. After the fork the parent simply leaves
358the quiescent state and continues request processing, while the child
359starts the same number of threads as were in use by the parent.
360
339=head1 SEE ALSO 361=head1 SEE ALSO
340 362
341L<Coro>, L<Linux::AIO>. 363L<Coro>, L<Linux::AIO>.
342 364
343=head1 AUTHOR 365=head1 AUTHOR

Diff Legend

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