timer_getoverrun(2)            DG/UX R4.11MU05           timer_getoverrun(2)


NAME
       timer_getoverrun - get the overrun count for a per-process timer

SYNOPSIS
       #include <time.h>

       int timergetoverrun (timerid)
            timerttimerid;

DESCRIPTION
       When a timer expires, it queues an expiration signal to the process
       that created it. If the timer expires again before the queued signal
       has been delivered, no new signal is queued. Instead, a timer overrun
       occurs. Use timergetoverrun to get this count for a timer:

       0    means no timer overrun has occurred for timerid.

       >0   means timerid has expired this number of times since queuing an
            undelivered expiration signal for its first expiration. The
            count does not include the first expiration.

       The timerid is the identifier of a per-process timer established by
       timercreate(2).

       Do not use timergetoverrun except in a signal handler. If you do,
       the value it returns is undefined.

       The maximum timer overrun value is stored in the system variable
       DELAYTIMER_MAX. You can obtain this value by calling sysconf(2) with
       parameter _SC_DELAYTIMER_MAX. The timergetoverrun call retrieves the
       smaller of the timer overrun count and this value.

   Note
        * This routine is based on POSIX realtime extension document P1003.4
          draft 14. It is therefore subject to change.

        * Compilation of a source file using this routine requires that
          feature macro _POSIX4_DRAFT_SOURCE be defined.  This feature macro
          is not enabled by any other feature macro, nor does it enable any
          other feature macro.

        * The compiled routine must be linked to library librte.a.

RETURN VALUE
       If successful, timergetoverrun returns the timer overrun count. If
       unsuccessful, the call returns -1 and sets ERRNO to:

        EINVAL The timerid is invalid.

SEE ALSO
       clockgetres(2), clockgettime(2), sysconf(2), timercreate(2),
       timerdelete(2), timersettime(2), timergettime(2).


Licensed material--property of copyright holder(s)