NAME

AnyEvent::Subprocess::Done - represents a completed subprocess run

VERSION

version 1.102912

SYNOPSIS

We are $done in a sequence like:

   my $job = AnyEvent::Subprocess->new ( ... );
   my $run = $job->run;
   $run->delegate('stdin')->push_write('Hello, my child!');
   say "Running child as ", $run->child_pid;
   $run->kill(11) if $you_enjoy_that_sort_of_thing;
   my $done = $job->delegate('completion_condvar')->recv;
   say "Child exited with signal ", $done->exit_signal;
   say "Child produced some stdout: ",
       $done->delegate('stdout_capture')->output;

DESCRIPTION

An instance of this class is returned to your "on_completion" callback when the child process exists.

METHODS

delegate( $name )

Returns the delegate named $name.

exit_status

$? from waitpid on the child. Parsed into the various fields below:

exit_value

The value the child supplied to "exit". (0 if ""exit 0"", etc.)

exit_signal

The signal number the child was killed by, if any.

dumped_core

True if the child dumped core.

is_success

True if the exit_status is 0. If this is false, your process dumped core, exited due to a signal, or exited with a value other than 0.

AUTHOR

Jonathan Rockway <jrockway@cpan.org>

COPYRIGHT AND LICENSE

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.