HP-UX Reference (11i v2 04/09) - 3 Library Functions A-M (vol 6)

gettimer(3C) gettimer(3C)

NAME

gettimer - get value of a per-process timer

SYNOPSIS

#include <sys/timers.h>

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

DESCRIPTION

The gettimer() function 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 speciﬁed 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 undeﬁned if

value is NULL.

RETURN VALUE

Upon successful completion,

gettimer() returns zero; otherwise, it returns −1 and sets

errno to indi-

cate 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.

FILES

/usr/include/sys/timers.h