gettimer(3C)															      gettimer(3C)

NAME

       gettimer - get value of a per-process timer

SYNOPSIS

DESCRIPTION

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

       The behavior of this function is undefined if is NULL.

RETURN VALUE

       Upon successful completion, returns zero; otherwise, it returns -1 and sets to indicate the error.

ERRORS

       fails if any of the following conditions are encountered:

	      [EINVAL]	  does not correspond to an ID returned by

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

FILES

SEE ALSO

       timers(2), timer_gettime(2), mktimer(3C), reltimer(3C), thread_safety(5).

STANDARDS CONFORMANCE

																      gettimer(3C)