reltimer(3C)reltimer(3C)NAMEreltimer - relatively arm a per-process timer
SYNOPSISDESCRIPTION
The function sets the of the specified timer to an offset from the cur‐
rent 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.
FILESSEE ALSOtimers(2), gettimer(3C), mktimer(3C), thread_safety(5).
STANDARDS CONFORMANCEreltimer(3C)