setclock.3c (2010 09)

setclock(3C) setclock(3C)

NAME

setclock - set value of system-wide clock

SYNOPSIS

#include <sys/timers.h>

int setclock(int clock_type, struct timespec *tp);

DESCRIPTION

The setclock() function sets the current value tp

of the speciﬁed system-wide clock, clock_type.

setclock() supports a clock_type of TIMEOFDAY, deﬁned in <

sys/timers.h>, which

represents the time-of-day clock for the system. For this clock, the values returned by

setclock()

represent the amount of time since the Epoch.

The calling process must have appropriate privileges to set the

TIMEOFDAY clock.

RETURN VALUE

Upon successful completion,

setclock() returns a value of zero; otherwise it returns −1 and sets

errno to indicate the error.

ERRORS

setclock() fails if any of the following conditions are encountered:

[EINVAL]

clock_type does not specify a known system-wide clock, or

tp either is outside the

range for a given clock type, or it speciﬁes a nanosecond value less than zero or greater

than or equal to 1000 million.

[EIO] An error occurred while accessing the clock device.

[EPERM] The requesting process does not have the required appropriate privileges to set the

speciﬁed clock.

FILES

/usr/include/sys/timers.h

PAGE 1
setclock(3C) setclock(3C) NAME setclock - set value of system-wide clock SYNOPSIS #include int setclock(int clock_type, struct timespec *tp); DESCRIPTION The setclock() function sets the current value tp of the specified system-wide clock, clock_type. setclock() supports a clock_type of TIMEOFDAY, defined in , which represents the time-of-day clock for the system. For this clock, the values returned by setclock() represent the amount of time since the Epoch.
PAGE 2
(Notes) A (Notes) sA 2 Hewlett-Packard Company −1− HP-UX 11i Version 3: September 2010