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)