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.196 by root, Fri Jun 10 06:50:42 2011 UTC vs.
Revision 1.202 by root, Tue Jul 5 14:02:15 2011 UTC

… …
168use common::sense; 168use common::sense;
169 169
170use base 'Exporter'; 170use base 'Exporter';
171 171
172BEGIN { 172BEGIN {
173 our $VERSION = '3.9'; 173 our $VERSION = '3.93';
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_pathsync aio_readahead
179 aio_rename aio_link aio_move aio_copy aio_group 179 aio_rename aio_link aio_move aio_copy aio_group
180 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown 180 aio_nop aio_mknod aio_load aio_rmtree aio_mkdir aio_chown
181 aio_chmod aio_utime aio_truncate 181 aio_chmod aio_utime aio_truncate
182 aio_msync aio_mtouch aio_mlock aio_mlockall 182 aio_msync aio_mtouch aio_mlock aio_mlockall
… …
222 aio_unlink $pathname, $callback->($status) 222 aio_unlink $pathname, $callback->($status)
223 aio_mknod $path, $mode, $dev, $callback->($status) 223 aio_mknod $path, $mode, $dev, $callback->($status)
224 aio_link $srcpath, $dstpath, $callback->($status) 224 aio_link $srcpath, $dstpath, $callback->($status)
225 aio_symlink $srcpath, $dstpath, $callback->($status) 225 aio_symlink $srcpath, $dstpath, $callback->($status)
226 aio_readlink $path, $callback->($link) 226 aio_readlink $path, $callback->($link)
227 aio_realpath $path, $callback->($link)
227 aio_rename $srcpath, $dstpath, $callback->($status) 228 aio_rename $srcpath, $dstpath, $callback->($status)
228 aio_mkdir $pathname, $mode, $callback->($status) 229 aio_mkdir $pathname, $mode, $callback->($status)
229 aio_rmdir $pathname, $callback->($status) 230 aio_rmdir $pathname, $callback->($status)
230 aio_readdir $pathname, $callback->($entries) 231 aio_readdir $pathname, $callback->($entries)
231 aio_readdirx $pathname, $flags, $callback->($entries, $flags) 232 aio_readdirx $pathname, $flags, $callback->($entries, $flags)
… …
643Asynchronously read the symlink specified by C<$path> and pass it to 644Asynchronously read the symlink specified by C<$path> and pass it to
644the callback. If an error occurs, nothing or undef gets passed to the 645the callback. If an error occurs, nothing or undef gets passed to the
645callback. 646callback.
646 647
647 648
649=item aio_realpath $path, $callback->($path)
650
651Asynchronously make the path absolute and resolve any symlinks in
652C<$path>. The resulting path only consists of directories (Same as
653L<Cwd::realpath>).
654
655This request can be used to get the absolute path of the current working
656directory by passing it a path of F<.> (a single dot).
657
658
648=item aio_rename $srcpath, $dstpath, $callback->($status) 659=item aio_rename $srcpath, $dstpath, $callback->($status)
649 660
650Asynchronously rename the object at C<$srcpath> to C<$dstpath>, just as 661Asynchronously rename the object at C<$srcpath> to C<$dstpath>, just as
651rename(2) and call the callback with the result code. 662rename(2) and call the callback with the result code.
652 663
… …
1789 Danga::Socket->AddOtherFds (IO::AIO::poll_fileno => 1800 Danga::Socket->AddOtherFds (IO::AIO::poll_fileno =>
1790 \&IO::AIO::poll_cb); 1801 \&IO::AIO::poll_cb);
1791 1802
1792=head2 FORK BEHAVIOUR 1803=head2 FORK BEHAVIOUR
1793 1804
1794This module should do "the right thing" when the process using it forks: 1805Usage of pthreads in a program changes the semantics of fork
1806considerably. Specifically, only async-safe functions can be called after
1807fork. Perl doesn't know about this, so in general, you cannot call fork
1808with defined behaviour in perl. IO::AIO uses pthreads, so this applies,
1809but many other extensions and (for inexplicable reasons) perl itself often
1810is linked against pthreads, so this limitation applies.
1795 1811
1796Before the fork, IO::AIO enters a quiescent state where no requests 1812Some operating systems have extensions that allow safe use of fork, and
1797can be added in other threads and no results will be processed. After 1813this module should do "the right thing" on those, and tries on others. At
1798the fork the parent simply leaves the quiescent state and continues 1814the time of this writing (2011) only GNU/Linux supports these extensions
1799request/result processing, while the child frees the request/result queue 1815to POSIX.
1800(so that the requests started before the fork will only be handled in the
1801parent). Threads will be started on demand until the limit set in the
1802parent process has been reached again.
1803
1804In short: the parent will, after a short pause, continue as if fork had
1805not been called, while the child will act as if IO::AIO has not been used
1806yet.
1807 1816
1808=head2 MEMORY USAGE 1817=head2 MEMORY USAGE
1809 1818
1810Per-request usage: 1819Per-request usage:
1811 1820

Diff Legend

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