Paul Evans > IO-Async-0.63 > IO::Async::Signal

Download:
IO-Async-0.63.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  7
Open  6
View/Report Bugs
Module Version: 0.63   Source   Latest Release: IO-Async-0.64

NAME ^

IO::Async::Signal - event callback on receipt of a POSIX signal

SYNOPSIS ^

 use IO::Async::Signal;

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

 my $signal = IO::Async::Signal->new(
    name => "HUP",

    on_receipt => sub {
        print "I caught SIGHUP\n";
    },
 );

 $loop->add( $signal );

 $loop->run;

DESCRIPTION ^

This subclass of IO::Async::Notifier invokes its callback when a particular POSIX signal is received.

Multiple objects can be added to a Loop that all watch for the same signal. The callback functions will all be invoked, in no particular order.

EVENTS ^

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

on_receipt

Invoked when the signal is received.

PARAMETERS ^

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

name => STRING

The name of the signal to watch. This should be a bare name like TERM. Can only be given at construction time.

on_receipt => CODE

CODE reference for the on_receipt event.

Once constructed, the Signal will need to be added to the Loop before it will work.

AUTHOR ^

Paul Evans <leonerd@leonerd.org.uk>

syntax highlighting: