IO::Async::Signal

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->loop_forever;

This module provides a class of IO::Async::Notifier which 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.

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 to callback to invoke when the signal is received.

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

IO::Async::Signal