stime(2)                                                              stime(2)


NAME
     stime - set time

C SYNOPSIS
     #include <unistd.h>

     int stime(const time_t *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 UTC January 1, 1970.

     stime will fail if:

     EPERM          the calling process does not have the super-user
                    privilege.

SEE ALSO
     time(2), gettimeofday(3B), ctime(3C).

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.


                                                                        Page 1