NAME

Linux::Perl::eventfd

SYNOPSIS

my $efd = Linux::Perl::eventfd->new(
    initval => 4,
    flags => [ 'NONBLOCK', 'CLOEXEC' ], #only on 2.6.27+
);

#or, e.g., Linux::Perl::eventfd::x86_64

my $fd = $efd->fileno();

$efd->add(12);

my $read = $efd->read();

DESCRIPTION

This is an interface to the eventfd/eventfd2 system call.

METHODS

CLASS->new( %OPTS )

%OPTS is:

  • initval - Optional, as described in the eventfd documentation. Defaults to 0.

  • flags - Optional, an array reference of any or all of: NONBLOCK, CLOEXEC, SEMAPHORE. See man 2 eventfd for more details.

OBJ->fileno()

Returns the file descriptor number.

$val = OBJ->read()

Reads a value from the eventfd instance. Sets $! and returns undef on error.

OBJ->add( NUMBER )

Adds NUMBER to the counter.