STIME(2)                             SysV                             STIME(2)



NAME
     stime - set time

SYNOPSIS
     int stime (tp)
     long *tp;

DESCRIPTION
     stime sets the system's idea of the time and date.  tp points to the
     value of time as measured in seconds from 00:00:00 GMT January 1, 1970.


     [EPERM]   stime will fail if the effective user ID of the calling process
               is not super-user.

SEE ALSO
     time(2).

DIAGNOSTICS
     Upon successful completion, a value of 0 is returned.  Otherwise, a value
     of -1 is returned and errno is set to indicate the error.

NOTES
     Domain/OS uses *tp to seed the algorithm by which it computes UIDs
     (unique identifiers).  The UID generator is seeded when the system is
     booted.  Setting *tp backwards, therefore, incurs the risk that objects
     created during the interval of time starting after the workstation is
     shut down and lasting for as long as *tp was set backwards will be
     assigned the same UIDs as existing objects.  The only way to eliminate
     this risk entirely is not to create any objects during this time:  when
     shutting down, wait for as much time as *tp was set backwards before
     rebooting.