redhat man page for stime

STIME(2)						     Linux Programmer's Manual							  STIME(2)

NAME
       stime - set time

SYNOPSIS
       #define _SVID_SOURCE /* glibc2 needs this */
       #include <time.h>

       int stime(time_t *t);

DESCRIPTION
       stime  sets  the  system's  idea  of  the  time and date.  Time, pointed to by t, is measured in seconds from 00:00:00 GMT January 1, 1970.
       stime() may only be executed by the super user.

RETURN VALUE
       On success, zero is returned.  On error, -1 is returned, and errno is set appropriately.

ERRORS
       EPERM  The caller is not the super-user.

CONFORMING TO
       SVr4, SVID, X/OPEN

NOTES
       Under glibc2, <time.h> only provides a prototype when _SVID_SOURCE is defined.

SEE ALSO
       date(1), settimeofday(2)

Linux 0.99.11							    1993-07-24								  STIME(2)