timer_getoverrun(3C)

NAME
     timer_getoverrun - get the posix timer overrun count

SYNOPSIS
     #include <time.h>
     int timer_getoverrun (timer_t timerid);

DESCRIPTION
     timer_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 ALSO
     timer_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.