HPlogo HP-UX Reference > G

getclock(3C)

HP-UX 11i Version 2: December 2007 Update
» 

Technical documentation

 » Table of Contents

 » Index

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