settimeofday - set the date and time
The function sets the current time, expressed as seconds and microsec‐
onds since Epoch, and passed as the structure pointed to by tp.
The resolution of the system clock is one microsecond.
Setting the time of day requires the privilege (SYSATTR). 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.
tp A pointer to a structure in which the current time is returned.
The structure includes the following members:
tzp If this parameter is not a null pointer, it is interpreted as a
pointer to a structure under HP-UX. The structure has the follow‐
tz_minuteswest The number of minutes that the local time zone is
west of Coordinated Universal Time (UTC) or Epoch.
tz_dsttime A flag that, if nonzero, indicates that Daylight
Savings Time (DST) applies locally during the
appropriate part of the year.
returns the following values under HP-UX:
is set to indicate the error.
If fails, is set to the following value under HP-UX:
An argument address referenced invalid memory.
The member of the tp parameter to was less than zero
or greater than 2^31.
A user lacking appropriate privileges attempted to
set the time.
Relying on a granularity of one microsecond may result in code that is
not portable to other platforms.
was developed by the University of California, Berkeley, and HP.
SEE ALSOdate(1), ftime(2), gettimeofday(2), stime(2), time(2), ctime(3C), priv‐