NAME

IO::Async::Loop::Ppoll - use IO::Async with ppoll(2)

SYNOPSIS

   use IO::Async::Loop::Ppoll;

   my $loop = IO::Async::Loop::Ppoll->new();

   $loop->add( ... );

   $loop->add( IO::Async::Signal->new(
         name =< 'HUP',
         on_receipt => sub { ... },
   ) );

   $loop->run;

DESCRIPTION

This subclass of IO::Async::Loop::Poll uses an IO::Ppoll object instead of a IO::Poll to perform read-ready and write-ready tests so that they can be mixed with signal handling.

The ppoll() system call atomically switches the process's signal mask, performs a wait exactly as poll() would, then switches it back. This allows a process to block the signals it cares about, but switch in an empty signal mask during the poll, allowing it to handle file IO and signals concurrently.

CONSTRUCTOR

new

   $loop = IO::Async::Loop::Ppoll->new( %args )

This function returns a new instance of a IO::Async::Loop::Ppoll object. It takes the following named arguments:

poll

The IO::Ppoll object to use for notification. Optional; if a value is not given, a new IO::Ppoll object will be constructed.

METHODS

As this is a subclass of IO::Async::Loop::Poll, all of its methods are inherited. Expect where noted below, all of the class's methods behave identically to IO::Async::Loop::Poll.

loop_once

   $count = $loop->loop_once( $timeout )

This method calls the poll() method on the stored IO::Ppoll object, passing in the value of $timeout, and processes the results of that call. It returns the total number of IO::Async::Notifier callbacks invoked, or undef if the underlying poll() method returned an error. If the poll() was interrupted by a signal, then 0 is returned instead.

SEE ALSO

• IO::Ppoll - Object interface to Linux's ppoll() call

• IO::Async::Loop::Poll - a set using an IO::Poll object

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>