NAME

gettimer − Gets value of a per-process timer

LIBRARY

Standard C Library (libc.a)

SYNOPSIS

#include <sys/timers.h>

int gettimer(
timer_t timerid,
struct itimerspec ∗tp) ;

PARAMETERS

timeridSpecifies the per-process timer to use; this value is obtained from a call to mktimer(). 

tpPoints to an itimerspec structure. 

DESCRIPTION

The gettimer() function gets the current value of a per-process timer. 

NOTES

The gettimer() function is part of the POSIX 1003.4 real-time extensions, which is not an approved standard.  As such, it is liable to change. 

AES Support Level:
Trial use

RETURN VALUES

Upon successful completion, the gettimer() function returns the value 0 (zero). Otherwise, the gettimer() function returns a value of -1 and sets errno to indicate the error. 

ERRORS

If the gettimer() function fails, errno may be set to the following value:

[EINVAL]The timerid parameter does not specify a known timer. 

RELATED INFORMATION

Functions: mktimer(2), reltimer(3), rmtimer(3)