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.199 by root, Wed Jun 29 12:46:36 2011 UTC vs.
Revision 1.205 by root, Mon Jul 18 03:09:06 2011 UTC

… …
168use common::sense; 168use common::sense;
169 169
170use base 'Exporter'; 170use base 'Exporter';
171 171
172BEGIN { 172BEGIN {
173 our $VERSION = '3.92'; 173 our $VERSION = '4.0';
174 174
175 our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close 175 our @AIO_REQ = qw(aio_sendfile aio_read aio_write aio_open aio_close
176 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx 176 aio_stat aio_lstat aio_unlink aio_rmdir aio_readdir aio_readdirx
177 aio_scandir aio_symlink aio_readlink aio_sync aio_fsync 177 aio_scandir aio_symlink aio_readlink aio_realpath aio_sync aio_fsync
178 aio_fdatasync aio_sync_file_range aio_pathsync aio_readahead 178 aio_fdatasync aio_sync_file_range aio_fallocate
179 aio_pathsync aio_readahead
179 aio_rename aio_link aio_move aio_copy aio_group 180 aio_rename aio_link aio_move aio_copy aio_group
180 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown 181 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown
181 aio_chmod aio_utime aio_truncate 182 aio_chmod aio_utime aio_truncate
182 aio_msync aio_mtouch aio_mlock aio_mlockall 183 aio_msync aio_mtouch aio_mlock aio_mlockall
183 aio_statvfs); 184 aio_statvfs);
… …
222 aio_unlink $pathname, $callback->($status) 223 aio_unlink $pathname, $callback->($status)
223 aio_mknod $path, $mode, $dev, $callback->($status) 224 aio_mknod $path, $mode, $dev, $callback->($status)
224 aio_link $srcpath, $dstpath, $callback->($status) 225 aio_link $srcpath, $dstpath, $callback->($status)
225 aio_symlink $srcpath, $dstpath, $callback->($status) 226 aio_symlink $srcpath, $dstpath, $callback->($status)
226 aio_readlink $path, $callback->($link) 227 aio_readlink $path, $callback->($link)
228 aio_realpath $path, $callback->($link)
227 aio_rename $srcpath, $dstpath, $callback->($status) 229 aio_rename $srcpath, $dstpath, $callback->($status)
228 aio_mkdir $pathname, $mode, $callback->($status) 230 aio_mkdir $pathname, $mode, $callback->($status)
229 aio_rmdir $pathname, $callback->($status) 231 aio_rmdir $pathname, $callback->($status)
230 aio_readdir $pathname, $callback->($entries) 232 aio_readdir $pathname, $callback->($entries)
231 aio_readdirx $pathname, $flags, $callback->($entries, $flags) 233 aio_readdirx $pathname, $flags, $callback->($entries, $flags)
… …
643Asynchronously read the symlink specified by C<$path> and pass it to 645Asynchronously read the symlink specified by C<$path> and pass it to
644the callback. If an error occurs, nothing or undef gets passed to the 646the callback. If an error occurs, nothing or undef gets passed to the
645callback. 647callback.
646 648
647 649
650=item aio_realpath $path, $callback->($path)
651
652Asynchronously make the path absolute and resolve any symlinks in
653C<$path>. The resulting path only consists of directories (Same as
654L<Cwd::realpath>).
655
656This request can be used to get the absolute path of the current working
657directory by passing it a path of F<.> (a single dot).
658
659
648=item aio_rename $srcpath, $dstpath, $callback->($status) 660=item aio_rename $srcpath, $dstpath, $callback->($status)
649 661
650Asynchronously rename the object at C<$srcpath> to C<$dstpath>, just as 662Asynchronously rename the object at C<$srcpath> to C<$dstpath>, just as
651rename(2) and call the callback with the result code. 663rename(2) and call the callback with the result code.
652 664
… …
1792=head2 FORK BEHAVIOUR 1804=head2 FORK BEHAVIOUR
1793 1805
1794Usage of pthreads in a program changes the semantics of fork 1806Usage of pthreads in a program changes the semantics of fork
1795considerably. Specifically, only async-safe functions can be called after 1807considerably. Specifically, only async-safe functions can be called after
1796fork. Perl doesn't know about this, so in general, you cannot call fork 1808fork. Perl doesn't know about this, so in general, you cannot call fork
1797with defined behaviour in perl. IO::AIO uses pthreads, so this applies, 1809with defined behaviour in perl if pthreads are involved. IO::AIO uses
1798but many other extensions and (for inexplicable reasons) perl itself often 1810pthreads, so this applies, but many other extensions and (for inexplicable
1799is linked against pthreads, so this limitation applies. 1811reasons) perl itself often is linked against pthreads, so this limitation
1812applies to quite a lot of perls.
1800 1813
1801Some operating systems have extensions that allow safe use of fork, and 1814This module no longer tries to fight your OS, or POSIX. That means IO::AIO
1802this module should do "the right thing" on those, and tries on others. At 1815only works in the process that loaded it. Forking is fully supported, but
1803the time of this writing (2011) only GNU/Linux supports these extensions 1816using IO::AIO in the child is not.
1804to POSIX. 1817
1818You might get around by not I<using> IO::AIO before (or after)
1819forking. You could also try to call the L<IO::AIO::reinit> function in the
1820child:
1821
1822=over 4
1823
1824=item IO::AIO::reinit
1825
1826Abondons all current requests and I/O threads and simply reinitialises all
1827data structures. This is not an operation suppported by any standards, but
1828happens to work on GNU/Linux and some newer BSD systems.
1829
1830The only reasonable use for this function is to call it after forking, if
1831C<IO::AIO> was used in the parent. Calling it while IO::AIO is active in
1832the process will result in undefined behaviour. Calling it at any time
1833will also result in any undefined (by POSIX) behaviour.
1834
1835=back
1805 1836
1806=head2 MEMORY USAGE 1837=head2 MEMORY USAGE
1807 1838
1808Per-request usage: 1839Per-request usage:
1809 1840

Diff Legend

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