io::async::timer::absolute(3pm) [debian man page]

IO::Async::Timer::Absolute(3pm) 			User Contributed Perl Documentation			   IO::Async::Timer::Absolute(3pm)

NAME

       "IO::Async::Timer::Absolute" - event callback at a fixed future time

SYNOPSIS

	use IO::Async::Timer::Absolute;

	use POSIX qw( mktime );

	use IO::Async::Loop;
	my $loop = IO::Async::Loop->new;

	my @time = gmtime;

	my $timer = IO::Async::Timer::Absolute->new(
	   time => mktime( 0, 0, 0, $time[4]+1, $time[5], $time[6] ),

	   on_expire => sub {
	      print "It's midnight
";
	      $loop->stop;
	   },
	);

	$loop->add( $timer );

	$loop->run;

DESCRIPTION

       This subclass of IO::Async::Timer implements one-shot events at a fixed time in the future. The object waits for a given timestamp, and
       invokes its callback at that point in the future.

       For a "Timer" object that waits for a delay relative to the time it is started, see instead IO::Async::Timer::Countdown.

EVENTS

       The following events are invoked, either using subclass methods or CODE references in parameters:

   on_expire
       Invoked when the timer expires.

PARAMETERS

       The following named parameters may be passed to "new" or "configure":

       on_expire => CODE
	       CODE reference for the "on_expire" event.

       time => NUM
	       The epoch time at which the timer will expire.

       Once constructed, the timer object will need to be added to the "Loop" before it will work.

       Unlike other timers, it does not make sense to "start" this object, because its expiry time is absolute, and not relative to the time it is
       started.

AUTHOR

       Paul Evans <leonerd@leonerd.org.uk>

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

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)