hpux man page for gettimeofday

gettimeofday(2) 						System Calls Manual						   gettimeofday(2)

NAME
       gettimeofday - get the date and time

SYNOPSIS

DESCRIPTION
       The function obtains the current time, expressed as seconds and microseconds since Epoch, and stores it in the structure pointed to by tp.

       The resolution of the system clock is one microsecond.

PARAMETERS
       Programs should use this time zone information only in the absence of the environment variable.

       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:

	      [EFAULT]	     An argument address referenced invalid memory.

EXAMPLES
       The  following  HP-UX  example  calls twice.  It then computes the lapsed time between the calls in seconds and microseconds and stores the
       result in a timeval structure:

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), settimeofda(2), stime(2), time(2), ctime(3C).

																   gettimeofday(2)