stime(2)

1STIME(2)                   Linux Programmer's Manual                  STIME(2)
2
3
4

NAME

6       stime - set time
7

SYNOPSIS

9       #define _SVID_SOURCE /* glibc2 needs this */
10       #include <time.h>
11
12       int stime(time_t *t);
13

DESCRIPTION

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

RETURN VALUE

20       On  success,  zero is returned.  On error, -1 is returned, and errno is
21       set appropriately.
22

ERRORS

24       EFAULT Error in getting information from user space.
25
26       EPERM  The calling process has insufficient privilege.  Under Linux the
27              CAP_SYS_TIME privilege is required.
28

CONFORMING TO

30       SVr4.
31

NOTES

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