From Code to Community: Sponsoring The Perl and Raku Conference 2025 Learn more

package Linux::FD;
$Linux::FD::VERSION = '0.017';
use 5.006;
use strict;
use Exporter 5.57 'import';
our @EXPORT_OK = qw/eventfd signalfd timerfd/;
XSLoader::load(__PACKAGE__, __PACKAGE__->VERSION);
1;
#ABSTRACT: Linux specific special filehandles
__END__
=pod
=encoding UTF-8
=head1 NAME
Linux::FD - Linux specific special filehandles
=head1 VERSION
version 0.017
=head1 DESCRIPTION
Linux::FD provides you Linux specific special file handles. These are
=over 4
=item * Event filehandles
=item * Signal filehandles
=item * Timer filehandles
=back
These allow you to use conventional polling mechanisms to wait for a large variety of events.
=head1 FUNCTIONS
=head2 eventfd($initial_value, @flags)
This creates an eventfd handle. See L<Linux::FD::Event> for more information on it.
=head2 signalfd($sigset)
This creates an signalfd handle. See L<Linux::FD::Signal> for more information on it.
=head2 timerfd($clock_id)
This creates an timerfd handle. See L<Linux::FD::Timer> for more information on it.
=head1 AUTHOR
Leon Timmermans <leont@cpan.org>
=head1 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.
=cut