setclock(3C)															      setclock(3C)

NAME

       setclock - set value of system-wide clock

SYNOPSIS

DESCRIPTION

       The function sets the current value of the specified system-wide clock,

       supports  a  of	defined  in  which  represents the time-of-day clock for the system.  For this clock, the values returned by represent the
       amount of time since the Epoch.

       The calling process must have appropriate privileges to set the clock.

RETURN VALUE

       Upon successful completion, returns a value of zero; otherwise it returns -1 and sets to indicate the error.

ERRORS

       fails if any of the following conditions are encountered:

	      [EINVAL]	  does not specify a known system-wide clock, or either is outside the range for a given clock type,  or  it  specifies  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 specified clock.

FILES

SEE ALSO

       clocks(2), getclock(3C), gettimer(3C), thread_safety(5).

STANDARDS CONFORMANCE

																      setclock(3C)