/ 
IO-Async-Loop-IO_Ppoll-0.02
/ IO::Async::Loop::IO_Ppoll

NAME

IO::Async::Loop::IO_Ppoll - a Loop using an IO::Ppoll object

SYNOPSIS

use IO::Async::Loop::IO_Ppoll;

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

$loop->add( ... );
$loop->attach_signal( HUP => sub { ... } );

$loop->loop_forever();

DESCRIPTION

This subclass of IO::Async::Loop::IO_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

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

This function returns a new instance of a IO::Async::Loop::IO_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::IO_Poll, all of its methods are inherited. Expect where noted below, all of the class's methods behave identically to IO::Async::Loop::IO_Poll.

$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

AUTHOR

Paul Evans <leonerd@leonerd.org.uk>