NAME

timer_getoverrun − get overrun count for per-process timer

SYNOPSIS

#include <sys/types.h>
#include <time.h>

int timer_getoverrun(timerid)
timer_t            timerid

DESCRIPTION

The timer_getoverrun function returns the expiration overrun count of the timer specified by timerid previously allocated by the timer_create(3P4) function.  For each timer expiration signal delivered, the overrun count shall be zero unless the delivery of the signal was delayed.  If the delivery was delayed, the overrun count contains the number of extra timer expirations which occurred during the delay. 

RETURN VALUE

Upon successful completion, the timer_getoverrun returns the timer expiration overrun count for the specified timer.  If any of the following conditions occur, the timer_getoverrun function shall return -1 and set errno to the corresponding value:

[EINVAL] The timer ID specified by timerid is not a valid timer ID. 

FILES

/usr/lib/libposix4.a

SEE ALSO

timer_create(3P4), timer_delete(3P4), timer_gettime(3P4), timer_settime(3P4). 

WARNING

The interface to timer_getoverrun is based on IEEE Draft Standard P1003.4/D12.  This is an unapproved draft, subject to change.  Use of information contained in this unapproved draft is at your own risk.  This interface will change to reflect any changes made by future drafts of POSIX 1003.4. 

CX/UX Programmer’s Reference Manual