NAME | SYNOPSIS | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES
$(OS_DIR)/lib/libc.a #include <time.h>int clock_settime(clockid_t clock_id, const struct timespec * tp);
The function or functions documented here may not be used safely in all application contexts with all APIs provided in the ChorusOS 5.0 product.
See API(5FEA) for details.
The clock_settime() function sets the specified clock, clock_id , to the value specified by tp . Time values 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 can not be set 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 , usually represents the time of day.
On 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 | API RESTRICTIONS | DESCRIPTION | RETURN VALUE | ERRORS | ATTRIBUTES