gettimer(3) [osf1 man page]

gettimer(3)						     Library Functions Manual						       gettimer(3)

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

       Specifies the per-process timer to use; this value is obtained from a call to mktimer().  Points 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.	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: The timerid parameter does not specify a known timer.

RELATED INFORMATION

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

																       gettimer(3)

mktimer(3C)															       mktimer(3C)

NAME

       mktimer - allocate a per-process timer

SYNOPSIS

DESCRIPTION

       The  function is used to allocate a per-process timer using the specified system-wide clock as the timing base.	returns an unique timer ID
       of type used to identify the timer in timer requests (see gettimer(3C)).  specifies the system-wide clock to be used as the timing base for
       the new timer.  specifies the mechanism by which the process is to be notified when the timer expires.

       supports one per-process timer with a of and of

       If is the system causes a signal to be sent to the process whenever the timer expires.

       For the machine-dependent clock resolution and maximum value are and seconds, respectively.  These constants are defined in

RETURN VALUE

       Upon  successful completion, returns a which can be passed to the per_process timer calls.  If unsuccessful, returns a value of and sets to
       indicate the error.

ERRORS

       fails if any of the following conditions are encountered:

	      [EAGAIN]	  The calling process has already allocated all of the timers it is allowed.

	      [EINVAL]	  is not defined, or does not allow the specified notification mechanism.

FILES

       SEE ALSO
	      timers(2), getclock(3C), gettimer(3C), reltimer(3C), rmtimer(3C), setclock(3C), thread_safety(5).

STANDARDS CONFORMANCE

																       mktimer(3C)