rmtimer(3) [osf1 man page]

rmtimer(3)						     Library Functions Manual							rmtimer(3)

NAME

       rmtimer -  Frees a per-process timer

LIBRARY

       Standard C Library (libc.a)

SYNOPSIS

       #include <sys/timers.h>
       int rmtimer(	 timer_t timer_id );

PARAMETERS

       Specifies the per-process timer to deallocate.

DESCRIPTION

       The rmtimer() function is used to free a previously allocated per-process timer (previously returned by the mktimer() function).  Any pend-
       ing per-process timer event generated by the timer specified by the timer_id parameter is canceled when	this  function	successfully  exe-
       cutes.

NOTES

       Trial use

RETURN VALUES

       Upon successful completion, the value 0 (zero) is returned.  Otherwise, the value -1 is returned and errno is set to indicate the error.

ERRORS

       If  the	rmtimer() function fails, errno may be set to the following value: The timerid parameter does not specify an allocated per-process
       timer.

RELATED INFORMATION

       Functions: gettimer(3), mktimer(3), reltimer(3) delim off

																	rmtimer(3)

reltimer(3C)															      reltimer(3C)

NAME

       reltimer - relatively arm a per-process timer

SYNOPSIS

DESCRIPTION

       The function sets the of the specified timer to an offset from the current clock setting.

       If  specifies  a  value	argument  with the member equal to zero, the timer is disabled.  updates the it_interval value of the timer to the
       value specified.  Time values smaller than the resolution of the specified timer are rounded up to its resolution; timer values larger than
       the maximum value of the specified timer are rounded down to the maximum value (see mktimer(3C)).

       returns	in  the ovalue parameter a value representing the previous amount of time before the timer would have expired or zero if the timer
       was disabled, together with the previous interval timer period.	The members of ovalue are subject to the resolution of the timer, and  are
       the same values that would be returned by a call.

       The behavior of this function is undefined if value 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 or the value structure specified a nanosecond value less than zero or greater
			  than or equal to 1000 million.

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

FILES

SEE ALSO

       timers(2), gettimer(3C), mktimer(3C), thread_safety(5).

STANDARDS CONFORMANCE

																      reltimer(3C)