NAME¶
"IO::Async::PID" - event callback on exit of a child process
SYNOPSIS¶
use IO::Async::PID;
use POSIX qw( WEXITSTATUS );
use IO::Async::Loop;
my $loop = IO::Async::Loop->new;
my $kid = $loop->fork(
code => sub {
print "Child sleeping..\n";
sleep 10;
print "Child exiting\n";
return 20;
},
);
print "Child process $kid started\n";
my $pid = IO::Async::PID->new(
pid => $kid,
on_exit => sub {
my ( $self, $exitcode ) = @_;
printf "Child process %d exited with status %d\n",
$self->pid, WEXITSTATUS($exitcode);
},
);
$loop->add( $pid );
$loop->run;
DESCRIPTION¶
This subclass of IO::Async::Notifier invokes its callback when a process exits.
For most use cases, a IO::Async::Process object provides more control of setting
up the process, connecting filehandles to it, sending data to and receiving
data from it.
EVENTS¶
The following events are invoked, either using subclass methods or CODE
references in parameters:
on_exit $exitcode¶
Invoked when the watched process exits.
PARAMETERS¶
The following named parameters may be passed to "new" or
"configure":
- pid => INT
- The process ID to watch. Must be given before the object
has been added to the containing "IO::Async::Loop" object.
- on_exit => CODE
- CODE reference for the "on_exit" event.
Once the "on_exit" continuation has been invoked, the
"IO::Async::PID" object is removed from the containing
"IO::Async::Loop" object.
METHODS¶
$process_id = $pid->pid¶
Returns the underlying process ID
$pid->kill( $signal )¶
Sends a signal to the process
AUTHOR¶
Paul Evans <leonerd@leonerd.org.uk>