NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES
#include <time.h>int clock_settime(clockid_t clock_id, const struct timespec * tp);
The clock_settime function sets the specified clock, clock_id , to the value specified by tp . Time values that are between two consecutive, non-negative, integer multiples of the resolution of the clock specified are truncated to the smaller multiple of the resolution. Only supervisor threads or threads of system actors (see actorCreate (2K)) are permitted to set a clock value.
The clock_gettime function stores the current value for the specified clock, clock_id , in tp .
The clock_getres function returns the resolution of the specified clock in res unless res is NULL, in which case only validity checking is performed. The clock resolution is platform-defined and is not settable by an application.
The only clock supported is the system-wide realtime clock, with the clock_id of CLOCK_REALTIME. This clock, as set by clock_settime , usu ally represents the time of day.
Upon successful completion, clock_settime , clock_gettime , and clock_getres return zero.
Otherwise a value of -1 is returned and errno is set to indicate the error condition.
A pointer argument contains an address outside the current actor's address space.
The clock_id argument specifies a clock other than CLOCK_REALTIME. The tp argument is NULL ( clock_settime and clock_gettime only). The time specification referenced by the tp argument contains an impossible value ( clock_settime only).
The current thread is neither a supervisor thread nor a thread of a system actor ( clock_settime only).
See attributes(5) for descriptions of the following attributes:
ATTRIBUTE TYPE | ATTRIBUTE VALUE |
---|---|
Interface Stability | Evolving |
NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES