---

System Calls - Manual Reference Pages  - STIME (2)

---

stime - set time

CONTENTS

Synopsis
Description
Errors
Notes

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

int stime(time_t *t);

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 superuser.

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

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

SVr4.

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

date(1), settimeofday(2), capabilities(7) or go to Top of page |  Section 2 |  Main Man Index.