STIME

Section: Linux Programmer's Manual (2)
Updated: 2007-07-26
Index Return to Main Contents
 

NAME

stime - set time  

SYNOPSIS

#include <time.h>

int stime(time_t *t);

Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

stime(): _SVID_SOURCE  

DESCRIPTION

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.  

RETURN VALUE

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

ERRORS

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

CONFORMING TO

SVr4.  

SEE ALSO

date(1), settimeofday(2), capabilities(7)  

COLOPHON

This page is part of release 3.22 of the Linux man-pages project. A description of the project, and information about reporting bugs, can be found at http://www.kernel.org/doc/man-pages/.