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.28 by root, Sat Oct 27 15:10:09 2007 UTC vs.
Revision 1.32 by root, Sat Nov 3 09:29:51 2007 UTC

174 my $w = AnyEvent->signal (signal => "INT", cb => sub { exit 1 }); 174 my $w = AnyEvent->signal (signal => "INT", cb => sub { exit 1 });
175 175
176=head2 CHILD PROCESS WATCHERS 176=head2 CHILD PROCESS WATCHERS
177 177
178You can also listen for the status of a child process specified by the 178You can also listen for the status of a child process specified by the
179C<pid> argument. The watcher will only trigger once. This works by 179C<pid> argument (or any child if the pid argument is 0). The watcher will
180installing a signal handler for C<SIGCHLD>. 180trigger as often as status change for the child are received. This works
181by installing a signal handler for C<SIGCHLD>. The callback will be called with
182the pid and exit status (as returned by waitpid).
181 183
182Example: wait for pid 1333 184Example: wait for pid 1333
183 185
184 my $w = AnyEvent->child (pid => 1333, cb => sub { warn "exit status $?" }); 186 my $w = AnyEvent->child (pid => 1333, cb => sub { warn "exit status $?" });
185 187
195C<AnyEvent::Impl:xxx> modules, but can be any other class in the case 197C<AnyEvent::Impl:xxx> modules, but can be any other class in the case
196AnyEvent has been extended at runtime (e.g. in I<rxvt-unicode>). 198AnyEvent has been extended at runtime (e.g. in I<rxvt-unicode>).
197 199
198The known classes so far are: 200The known classes so far are:
199 201
202 EV::AnyEvent based on EV (an interface to libev, best choice)
200 AnyEvent::Impl::Coro based on Coro::Event, best choice. 203 AnyEvent::Impl::Coro based on Coro::Event, second best choice.
201 EV::AnyEvent based on EV (an interface to libevent)
202 AnyEvent::Impl::Event based on Event, also best choice :) 204 AnyEvent::Impl::Event based on Event, also second best choice :)
203 AnyEvent::Impl::Glib based on Glib, second-best choice. 205 AnyEvent::Impl::Glib based on Glib, second-best choice.
204 AnyEvent::Impl::Tk based on Tk, very bad choice. 206 AnyEvent::Impl::Tk based on Tk, very bad choice.
205 AnyEvent::Impl::Perl pure-perl implementation, inefficient. 207 AnyEvent::Impl::Perl pure-perl implementation, inefficient.
206 208
207=item AnyEvent::detect 209=item AnyEvent::detect
373our $CHLD_W; 375our $CHLD_W;
374our $PID_IDLE; 376our $PID_IDLE;
375our $WNOHANG; 377our $WNOHANG;
376 378
377sub _child_wait { 379sub _child_wait {
378 while (0 < (my $pid = waitpid -1, $WNOHANG)) { 380 while (0 <= (my $pid = waitpid -1, $WNOHANG)) {
379 $_->() for values %{ (delete $PID_CB{$pid}) || {} }; 381 $_->($pid, $?) for (values %{ $PID_CB{$pid} || {} }),
382 (values %{ $PID_CB{0} || {} });
380 } 383 }
381 384
382 undef $PID_IDLE; 385 undef $PID_IDLE;
383} 386}
384 387
385sub child { 388sub child {
386 my (undef, %arg) = @_; 389 my (undef, %arg) = @_;
387 390
388 my $pid = uc $arg{pid} 391 defined (my $pid = $arg{pid} + 0)
389 or Carp::croak "required option 'pid' is missing"; 392 or Carp::croak "required option 'pid' is missing";
390 393
391 $PID_CB{$pid}{$arg{cb}} = $arg{cb}; 394 $PID_CB{$pid}{$arg{cb}} = $arg{cb};
392 395
393 unless ($WNOHANG) { 396 unless ($WNOHANG) {

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines