Go to main content

man pages section 2: System Calls

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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.

EINTR

The calling process belongs to a non-global zone and receive a signal while setting the time.

ECANCELED

The calling process belongs to a non-global zone and there exists an internal I/O error.

See Also

time(2), privileges(7)