hpux man page for settimeofday

settimeofday(2) 						System Calls Manual						   settimeofday(2)

NAME
       settimeofday - set the date and time

SYNOPSIS

DESCRIPTION
       The function sets the current time, expressed as seconds and microseconds since Epoch, and passed as the structure pointed to by tp.

       The resolution of the system clock is one microsecond.

   Security Restrictions
       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 systems that support fine-grained privileges.

PARAMETERS
       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  following
	    fields:

	    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.

RETURN VALUE
       returns the following values under HP-UX:

	      Successful completion.

	      Failure.
		     is set to indicate the error.

ERRORS
       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.

WARNINGS
       Relying on a granularity of one microsecond may result in code that is not portable to other platforms.

AUTHOR
       was developed by the University of California, Berkeley, and HP.

SEE ALSO
       date(1), ftime(2), gettimeofday(2), stime(2), time(2), ctime(3C), privileges(5).

																   settimeofday(2)