stime(2)
_________________________________________________________________
stime System Call
Set time.
_________________________________________________________________
SYNTAX
int stime (seconds)
long * seconds;
PARAMETERS
seconds Address of an initialized longword interpreted as
the new system time.
DESCRIPTION
Stime sets the system's notion of the current Greenwich time to
the value contained in the longword at the location specified by
<seconds>.
When the time is successfully changed, a log of the change is
sent to the error logger device.
The time value specified is interpreted as Greenwich time
expressed in seconds since midnight January 1, 1970.
Setting the system clock may interfere with other timing
functions.
ACCESS CONTROL
Only the superuser may set the time of day.
RETURN VALUE
0 Completed successfully.
-1 An error occurred. Errno is set to indicate the
error.
EXCEPTIONS
Errno may be set to one of the following error codes:
DG/UX 4.00 Page 1
Licensed material--property of copyright holder(s)
stime(2)
EPERM Permission to change the system time is denied to
the calling process.
EFAULT The <seconds> argument references invalid memory.
SEE ALSO
The related manual section: time(2).
DG/UX 4.00 Page 2
Licensed material--property of copyright holder(s)