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>