NAME

gettimer − get value of a per-process timer

SYNOPSIS

#include <sys/timers.h>

int gettimer(timer_t timerid, struct itimerspec *value);

DESCRIPTION

gettimer() returns an itimerspec structure value to the value argument.  The it_value member of the structure represents the amount of time in the current interval before the timer expires for the timer specified in timerid, or zero if the timer is disabled. The it_interval member has the value last set by reltimer() (see reltimer(3C)). The members of value are subject to the resolution of the timer (see mktimer(3C)).

The behavior of this function is undefined if value is NULL. 

RETURN VALUE

Upon successful completion, gettimer() returns zero; otherwise, it returns −1 and set errno to indicate the error. 

ERRORS

gettimer() fails if any of the following conditions are encountered:

[EINVAL] timerid does not correspond to an ID returned by mktimer(). 

[EIO] An error occurred while accessing the clock device. 

SEE ALSO

reltimer(3C), mktimer(3C), <sys/timers.h>. 

STANDARDS CONFORMANCE

gettimer(): AES

Hewlett-Packard Company  —  HP-UX Release 9.0: August 1992