child::link::proc(3pm) [debian man page]

Child::Link::Proc(3pm)					User Contributed Perl Documentation				    Child::Link::Proc(3pm)

NAME

       Child::Link::Proc - Proc object used by Child.

SEE ALSO

       This class inherits from:

       Child::Link

METHODS

       $bool = $proc->is_complete()
	   Check if the child is finished (non-blocking)

       $proc->wait()
	   Wait until child terminates, destroy remaining zombie process (blocking)

       $proc->kill($SIG)
	   Send the $SIG signal to the child process.

	   NOTE: kill() is unpredictable on windows, strawberry perl sends the kill signal to the parent as well as the child.

       $proc->pid()
	   Returns the process PID.

       $proc->exit_status()
	   Will be undef unless the process has exited, otherwise it will have the exit status.

	   Note: When you call exit($N) the actual unix exit status will be bit shifed with extra information added. exit_status() will shift the
	   value back for you.	That means exit_status() will return 2 whun your child calls exit(2) see unix_exit() if you want the actual value
	   wait() assigned to $?.

       $proc->unix_exit()
	   When you call exit($N) the actual unix exit status will be bit shifed with extra information added. See exit_status() if you want the
	   actual value used in exit() in the child.

HISTORY

       Most of this was part of Parrallel::Runner intended for use in the Fennec project. Fennec is being broken into multiple parts, this is one
       such part.

FENNEC PROJECT

       This module is part of the Fennec project. See Fennec for more details.	Fennec is a project to develop an extendable and powerful testing
       framework.  Together the tools that make up the Fennec framework provide a potent testing environment.

       The tools provided by Fennec are also useful on their own. Sometimes a tool created for Fennec is useful outside the greator framework.
       Such tools are turned into their own projects. This is one such project.

       Fennec - The core framework
	 The primary Fennec project that ties them all together.

AUTHORS

       Chad Granum exodist7@gmail.com

COPYRIGHT

       Copyright (C) 2010 Chad Granum

       Child is free software; Standard perl licence.

       Child is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
       FITNESS FOR A PARTICULAR PURPOSE.  See the license for more details.

perl v5.10.1							    2011-03-07						    Child::Link::Proc(3pm)

Check Out this Related Man Page

IO::Async::PID(3pm)					User Contributed Perl Documentation				       IO::Async::PID(3pm)

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..
";
	      sleep 10;
	      print "Child exiting
";
	      return 20;
	   },
	);

	print "Child process $kid started
";

	my $pid = IO::Async::PID->new(
	   pid => $kid,

	   on_exit => sub {
	      my ( $self, $exitcode ) = @_;
	      printf "Child process %d exited with status %d
",
		 $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>

perl v5.14.2							    2012-10-24						       IO::Async::PID(3pm)

Linux and UNIX Man Pages

child::link::proc(3pm) [debian man page]

Check Out this Related Man Page