timer_getoverrun(3C)timer_getoverrun(3C)NAMEtimer_getoverrun - get the posix timer overrun count
SYNOPSIS
#include <time.h>
int timer_getoverrun (timer_t timerid);
DESCRIPTIONtimer_getoverrun returns the current expiration notification overrun
count for the posix timer named by timerid.
An overrun count is the number of timer expiration notifications which
were not delivered to the process due to an already pending signal from
timerid. This overrun condition may occur because a given posix timer
can only queue one signal to the process at any point in time.
If the returned overrun count is positive, then the count represents the
number of timer overruns up to, but not including {DELAYTIMER_MAX} [see
sysconf(3C)].
If the returned overrun count is zero, then no timer expiration overruns
have occurred between the last expiration notification and the time of
the call to timer_getoverrun.
timer_getoverrun will fail if the following is true:
[EINVAL] The timerid does not name a valid posix timer.
SEE ALSOtimer_create(3C), timer_delete(3C), timer_gettime(3C), timer_settime(3C),
sysconf(3C)DIAGNOSTICS
Upon successful completion, the timer overrun count is returned to the
calling process. Otherwise, a value of -1 is returned and errno is set to
indicate the error.
Page 1
