ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent/lib/AnyEvent.pm
(Generate patch)

Comparing AnyEvent/lib/AnyEvent.pm (file contents):
Revision 1.80 by root, Fri Apr 25 09:11:59 2008 UTC vs.
Revision 1.82 by root, Fri Apr 25 13:32:39 2008 UTC

… …
80module. 80module.
81 81
82During the first call of any watcher-creation method, the module tries 82During the first call of any watcher-creation method, the module tries
83to detect the currently loaded event loop by probing whether one of the 83to detect the currently loaded event loop by probing whether one of the
84following modules is already loaded: L<Coro::EV>, L<Coro::Event>, L<EV>, 84following modules is already loaded: L<Coro::EV>, L<Coro::Event>, L<EV>,
85L<Event>, L<Glib>, L<Tk>, L<AnyEvent::Impl::Perl>, L<Event::Lib>, L<Qt>, 85L<Event>, L<Glib>, L<AnyEvent::Impl::Perl>, L<Tk>, L<Event::Lib>, L<Qt>,
86L<POE>. The first one found is used. If none are found, the module tries 86L<POE>. The first one found is used. If none are found, the module tries
87to load these modules (excluding Event::Lib, Qt and POE as the pure perl 87to load these modules (excluding Tk, Event::Lib, Qt and POE as the pure perl
88adaptor should always succeed) in the order given. The first one that can 88adaptor should always succeed) in the order given. The first one that can
89be successfully loaded will be used. If, after this, still none could be 89be successfully loaded will be used. If, after this, still none could be
90found, AnyEvent will fall back to a pure-perl event loop, which is not 90found, AnyEvent will fall back to a pure-perl event loop, which is not
91very efficient, but should work everywhere. 91very efficient, but should work everywhere.
92 92
… …
147events. C<poll> must be a string that is either C<r> or C<w>, which 147events. C<poll> must be a string that is either C<r> or C<w>, which
148creates a watcher waiting for "r"eadable or "w"ritable events, 148creates a watcher waiting for "r"eadable or "w"ritable events,
149respectively. C<cb> is the callback to invoke each time the file handle 149respectively. C<cb> is the callback to invoke each time the file handle
150becomes ready. 150becomes ready.
151 151
152As long as the I/O watcher exists it will keep the file descriptor or a 152The I/O watcher might use the underlying file descriptor or a copy of it.
153copy of it alive/open.
154
155It is not allowed to close a file handle as long as any watcher is active 153It is not allowed to close a file handle as long as any watcher is active
156on the underlying file descriptor. 154on the underlying file descriptor.
157 155
158Some event loops issue spurious readyness notifications, so you should 156Some event loops issue spurious readyness notifications, so you should
159always use non-blocking calls when reading/writing from/to your file 157always use non-blocking calls when reading/writing from/to your file
… …
253watches for any child process exit). The watcher will trigger as often 251watches for any child process exit). The watcher will trigger as often
254as status change for the child are received. This works by installing a 252as status change for the child are received. This works by installing a
255signal handler for C<SIGCHLD>. The callback will be called with the pid 253signal handler for C<SIGCHLD>. The callback will be called with the pid
256and exit status (as returned by waitpid). 254and exit status (as returned by waitpid).
257 255
258Example: wait for pid 1333 256There is a slight catch to child watchers, however: you usually start them
257I<after> the child process was created, and this means the process could
258have exited already (and no SIGCHLD will be sent anymore).
259
260Not all event models handle this correctly (POE doesn't), but even for
261event models that I<do> handle this correctly, they usually need to be
262loaded before the process exits (i.e. before you fork in the first place).
263
264This means you cannot create a child watcher as the very first thing in an
265AnyEvent program, you I<have> to create at least one watcher before you
266C<fork> the child (alternatively, you can call C<AnyEvent::detect>).
267
268Example: fork a process and wait for it
269
270 my $done = AnyEvent->condvar;
271
272 AnyEvent::detect; # force event module to be initialised
273
274 my $pid = fork or exit 5;
259 275
260 my $w = AnyEvent->child ( 276 my $w = AnyEvent->child (
261 pid => 1333, 277 pid => $pid,
262 cb => sub { 278 cb => sub {
263 my ($pid, $status) = @_; 279 my ($pid, $status) = @_;
264 warn "pid $pid exited with status $status"; 280 warn "pid $pid exited with status $status";
281 $done->broadcast;
265 }, 282 },
266 ); 283 );
284
285 # do something else, then wait for process exit
286 $done->wait;
267 287
268=head2 CONDITION VARIABLES 288=head2 CONDITION VARIABLES
269 289
270Condition variables can be created by calling the C<< AnyEvent->condvar >> 290Condition variables can be created by calling the C<< AnyEvent->condvar >>
271method without any arguments. 291method without any arguments.
… …
359 AnyEvent::Impl::CoroEV based on Coro::EV, best choice. 379 AnyEvent::Impl::CoroEV based on Coro::EV, best choice.
360 AnyEvent::Impl::CoroEvent based on Coro::Event, second best choice. 380 AnyEvent::Impl::CoroEvent based on Coro::Event, second best choice.
361 AnyEvent::Impl::EV based on EV (an interface to libev, best choice). 381 AnyEvent::Impl::EV based on EV (an interface to libev, best choice).
362 AnyEvent::Impl::Event based on Event, second best choice. 382 AnyEvent::Impl::Event based on Event, second best choice.
363 AnyEvent::Impl::Glib based on Glib, third-best choice. 383 AnyEvent::Impl::Glib based on Glib, third-best choice.
384 AnyEvent::Impl::Perl pure-perl implementation, inefficient but portable.
364 AnyEvent::Impl::Tk based on Tk, very bad choice. 385 AnyEvent::Impl::Tk based on Tk, very bad choice.
365 AnyEvent::Impl::Perl pure-perl implementation, inefficient but portable.
366 AnyEvent::Impl::Qt based on Qt, cannot be autoprobed (see its docs). 386 AnyEvent::Impl::Qt based on Qt, cannot be autoprobed (see its docs).
367 AnyEvent::Impl::EventLib based on Event::Lib, leaks memory and worse. 387 AnyEvent::Impl::EventLib based on Event::Lib, leaks memory and worse.
368 AnyEvent::Impl::POE based on POE, not generic enough for full support. 388 AnyEvent::Impl::POE based on POE, not generic enough for full support.
369 389
370There is no support for WxWidgets, as WxWidgets has no support for 390There is no support for WxWidgets, as WxWidgets has no support for

Diff Legend

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