HP-UX Reference (11i v2 07/12) - 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 reso-

lution 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