HP-UX Reference (11i v2 03/08) - 3 Library Functions A-M (vol 6)
g
getclock(3C) getclock(3C)
NAME
getclock - get current value of system-wide clock
SYNOPSIS
#include <sys/timers.h>
int getclock(int clock_type, struct timespec *tp);
DESCRIPTION
The getclock() function gets the current value tp
of the specified system-wide clock, clock_type.
getclock() supports a clock_type of TIMEOFDAY, defined in <
sys/timers.h>, which
represents the time-of-day clock for the system. For this clock, the values returned by
getclock()
represent the amount of time since the Epoch.
RETURN VALUE
Upon successful completion,
getclock() returns a value of zero; otherwise it returns a value of −1 and
sets
errno to indicate the error.
ERRORS
getclock() fails if any of the following conditions are encountered:
[EINVAL]
clock_type does not specify a known system-wide clock.
[EIO] An error occurred while accessing the clock device.
FILES
/usr/include/sys/timers.h
SEE ALSO
clocks(2), clock_gettime(2), gettimer(3C), setclock(3C), thread_safety(5).
STANDARDS CONFORMANCE
getclock(): AES
Section 3−−354 Hewlett-Packard Company − 1 − HP-UX 11i Version 2: August 2003