NAME    [Toc]    [Back]

       timer_getoverrun  - Obtains the overrun count for a specified
 timer

SYNOPSIS    [Toc]    [Back]

       include <time.h>

       int timer_getoverrun (      timer_t timerid );

LIBRARY    [Toc]    [Back]

       Realtime Library (librt.so, librt.a)

PARAMETERS    [Toc]    [Back]

       The timer for which to return the overrun count.

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The timer_getoverrun function fails  under  the  following
       condition: The specified clock ID is not defined.

SEE ALSO    [Toc]    [Back]

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

       Guide to Realtime Programming



                                              timer_getoverrun(3)