stime(2)

NAME

     stime - set system time and date

SYNOPSIS

     #include <unistd.h>

     int stime(const time_t *tp);

DESCRIPTION

     The stime() function sets the system's idea of the time  and
     date.   The tp argument points to the value of time as meas-
     ured in seconds from 00:00:00 UTC January 1, 1970.

RETURN VALUES

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

ERRORS

     The stime() function will fail if:

     EINVAL
           The tp argument points to an invalid  (negative)  time
           value.

     EPERM The effective user  of  the  calling  process  is  not
           super-user.

SEE ALSO

     time(2)