The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

POE::XS::Loop::EPoll - an XS implementation of POE::Loop, using Linux` epoll(2).

SYNOPSIS

  use POE::Kernel { loop => 'POE::XS::Loop::EPoll' };

DESCRIPTION

This class is an implementation of the abstract POE::Loop interface written in C using the Linux epoll(2) family of system calls.

Signals are left to POE::Loop::PerlSignals.

The epoll_ctl() call returns an error when you attempt to poll regular files, POE::XS::Loop::EPoll emulate's poll(2)'s behaviour with regular files under Linux - ie. they're always readable/writeable.

If you see an error:

  POE::XS::Loop::EPoll hasn't been initialized correctly

then the loop hasn't been loaded correctly, in POE <= 1.287 the following:

  # this doesn't work
  use POE qw(XS::Loop::EPoll);

will not load the loop correctly, you will need to do:

  use POE::Kernel { loop => 'POE::XS::Loop::EPoll' };
  use POE;

SEE ALSO

POE, POE::Loop, POE::XS::Loop::Poll.

BUGS

Relies upon small fd numbers, but then a lot of code does.

New bugs should be reported via request tracker, either mail to:

  bug-POE-XS-Loop-EPoll@rt.cpan.org

or using the form at:

  https://rt.cpan.org/Ticket/Create.html?Queue=POE-XS-Loop-EPoll

LICENSE

POE::XS::Loop::EPoll is licensed under the same terms as Perl itself.

AUTHOR

Tony Cook <tonyc@cpan.org>

sub skip_tests { $ENV{POE_EVENT_LOOP} = 'POE::XS::Loop::EPoll'; return; }