stime.2 (2010 09)

s
stime(2) stime(2)
NAME
stime() - set time and date
SYNOPSIS
#include <time.h>
int stime(const time_t *tp);
DESCRIPTION
The stime() system call sets the system time and date. tp points to the value of time as measured in
seconds from 00:00:00 on January 1, 1970, Coordinated Universal Time (UTC).
Security Restrictions
Some or all of the actions associated with this system call require the
SYSATTR privilege. Processes
owned by the superuser will have this privilege. Processes owned by other users may have this privilege,
depending on system configuration. See privileges (5) for more information about privileged access on sys-
tems that support fine-grained privileges.
RETURN VALUE
stime() returns the following values:
0 Successful completion.
-1 Failure. errno is set to indicate the error.
ERRORS
If
stime() fails, errno is set to one of the following values.
[EPERM] The calling process does not have the
SYSATTR privilege.
[EINVAL] The
tp parameter points to an invalid (negative) time value.
[EFAULT] The
tp parameter is an invalid address.
SEE ALSO
date(1), gettimeofday(2), time(2), privileges(5).
STANDARDS CONFORMANCE
stime(): SVID2, SVID3, XPG2
HP-UX 11i Version 3: September 2010 1 Hewlett-Packard Company 1

Summary of content (2 pages)