NAME

       Linux::FD::Signal - Signal filehandles for Linux

VERSION

       version 0.011

SYNOPSIS

        use Linux::FD::Signal;

        my $fh = Linux::FD::Signal->new($sigset);

METHODS

   new($sigmask)
       This creates a signalfd file descriptor that can be used to accept signals targeted at the
       caller. This provides an alternative to the use of a signal handler or sigwaitinfo, and
       has the advantage that the file descriptor may be monitored by select, poll, and epoll.

       The $sigmask argument specifies the set of signals that the caller wishes to accept via
       the file descriptor. This should either be a signal name(without the "SIG" prefix) or a
       POSIX::SigSet object. Normally, the set of signals to be received via the file descriptor
       should be blocked to prevent the signals being handled according to their default
       dispositions. It is not possible to receive SIGKILL or SIGSTOP signals via a signalfd file
       descriptor; these signals are silently ignored if specified in $sigmask.

   set_mask($sigmask)
       Sets the signal mask to a new value. It's argument works exactly the same as "new"'s

   receive()
       If one or more of the signals specified in mask is pending for the process, then it
       returns the information of one signalfd_siginfo structures (see below) that describe the
       signals.

       As a consequence of the receive, the signals are consumed, so that they are no longer
       pending for the process (i.e., will not be caught by signal handlers, and cannot be
       accepted using sigwaitinfo).

       If none of the signals in mask is pending for the process, then the receive either blocks
       until one of the signals in mask is generated for the process, or fails with the error
       EAGAIN if the file descriptor has been made non-blocking.

       The information is returned as a hashref with the following keys: signo, errno, code, pid,
       uid, fd, tid, band, overrun, trapno, status, int, ptr, utime, stime, address. All of these
       are returned as integers. Some of them are only useful in certain circumstances, others
       may not be useful from perl at all.

SEE ALSO

       Signal::Mask

AUTHOR

       Leon Timmermans <leont@cpan.org>

COPYRIGHT AND LICENSE

       This software is copyright (c) 2010 by Leon Timmermans.

       This is free software; you can redistribute it and/or modify it under the same terms as
       the Perl 5 programming language system itself.