Seth Woolley's Man Viewer

stime(2) - stime, stime - set time - man 2 stime

([section] manual, -k keyword, -K [section] search, -f whatis)
man plain no title

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



NAME
       stime - set(7,n,1 builtins) time(1,2,n)

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(1,2,n) and date.  Time, pointed to by
       t, is measured in(1,8) 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(8,n), -1 is returned, and errno is
       set(7,n,1 builtins) appropriately.

ERRORS
       EFAULT Error in(1,8) getting information from user space.

       EPERM  The calling process has insufficient privilege.  Under Linux the
              CAP_SYS_TIME privilege is required.

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), capabilities(7)



Linux 2.6.6                       2004-05-27                          STIME(2)

References for this manual (incoming links)