timer_getoverrun(3)					     Library Functions Manual					       timer_getoverrun(3)

NAME

       timer_getoverrun - Obtains the overrun count for a specified timer

LIBRARY

       Realtime Library (librt.so, librt.a)

SYNOPSIS

       include <time.h>

       int timer_getoverrun (	   timer_t timerid );

PARAMETERS

       timerid	   The timer for which to return the overrun count.

DESCRIPTION

       The  timer_getoverrun  function	returns  the overrun count for a specified timer. The count contains the number of extra timer expirations
       that occurred between the time the signal was queued and when it was delivered, up to but not including the implementation-defined  maximum
       DELAYTIMER_MAX.

RETURN VALUES

       Upon successful completion, the timer_getoverrun function returns the overrun count for the timer specified.  If the timer overrun count is
       equal to or greater than DELAYTIMER_MAX, the overrun count is set to DELAYTIMER_MAX.  If the function fails, it returns -1 and  sets  errno
       to indicate the type of error that occurred.

ERRORS

       The timer_getoverrun function fails under the following condition:

       [EINVAL]       The specified clock ID is not defined.

RELATED INFORMATION

       Functions: clock_getres(3), clock_gettime(3), clock_settime(3), timer_delete(3), timer_gettime(3), timer_settime(3)

       Guide to Realtime Programming delim off

															       timer_getoverrun(3)