man pages section 2: System Calls

Exit Print View

Updated: July 2014
 
 

stime(2)

Name

stime - set system time and date

Synopsis

#include <unistd.h>

int stime(const time_t *tp);

Description

The stime() function sets the system's idea of the time and date. The tp argument points to the value of time as measured in seconds from 00:00:00 UTC January 1, 1970.

Return Values

Upon successful completion, 0 is returned. Otherwise, −1 is returned and errno is set to indicate the error.

Errors

The stime() function will fail if:

EINVAL

The tp argument points to an invalid (negative) value.

EPERM

The {PRIV_SYS_TIME} privilege is not asserted in the effective set of the calling process.

See also

time(2), privileges(5)