STIMESection: Linux Programmer's Manual (2)
Index Return to Main Contents
NAMEstime - set time
SYNOPSIS#define _SVID_SOURCE /* glibc2 needs this */
DESCRIPTIONstime() 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 superuser.
RETURN VALUEOn success, zero is returned. On error, -1 is returned, and errno is set appropriately.
- Error in getting information from user space.
- The calling process has insufficient privilege. Under Linux the CAP_SYS_TIME privilege is required.
NOTESUnder glibc2, <time.h> only provides a prototype when _SVID_SOURCE is defined.
SEE ALSOdate(1), settimeofday(2), capabilities(7), feature_test_macros(7)