NAME
POSIX::RT::Timer - POSIX real-time timers
VERSION
version 0.011
SYNOPSIS
use POSIX::RT::Timer;
my $timer = POSIX::RT::Timer->new(value => 1, signal => $signo, id => 42);DESCRIPTION
This module provides for timers. Unlike getitimer/setitimer an arbitrary number of timers is supported.
Signal timers send a signal to the process, much like itimers. You can specify which signal is sent, using realtime signals is recommended.
METHODS
Class methods
new(%options)
Create a new timer. Options include
value = 0
The time in factional seconds for timer expiration. If it is 0 the timer is disarmed.
interval = 0
The value the timer is set to after expiration. If this is set to 0, it is a one-shot timer.
clock = 'realtime'
The type of clock. This must either be the stringname of a supported clock or a POSIX::RT::Clock object.
signal
The signal number to send a signal to on timer expiration.
id
An integer identifier added to the signal. Do note that perl's default signal handling throws away this information. You'll have to use either unsafe signals, with a risk of crashing your program, or a synchronous signal receiving mechanism (such as POSIX::RT::Signal or Linux::FD::Signal), which may ruin your reason for using timers. YMMV.
Instance methods
get_timeout()
Get the timeout value. In list context, it also returns the interval value. Note that this value is always relative to the current time.
set_timeout($value, $interval = 0, $abstime = 0)
Set the timer and interval values. If
$abstimeis true, they are absolute values, otherwise they are relative to the current time. Returns the old value likeget_timedoes.get_overrun()
Get the overrun count for the timer. The timer overrun count is the number of additional timer expirations that occurred since the signal was sent.
AUTHOR
Leon Timmermans <fawaka@gmail.com>
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.