STIME(2) STIME(2)
NAME
stime, settod - set time
SYNOPSIS
stime(tp)
long *tp;
long settod(toy)
long toy;
DESCRIPTION
Stime sets the system's idea of the time and date. Time,
pointed to by tp, is measured in seconds from 0000 GMT Jan
1, 1970.
Settod sets the VAX hardware time-of-year clock to toy, and
returns the previous value. When the system is booted, the
system's time is set from the time-of-year clock; while the
system is running, the time-of-year clock is examined peri-
odically, and the system's time adjusted slowly if necessary
to make the two agree.
Only the super-user may use these calls.
SEE ALSO
date(1), time(2), ctime(3)
DIAGNOSTICS
Zero is returned if the time was set; -1 if user is not the
super-user.