From a236411350ac45c20499c8ac466b07e49e4a0688 Mon Sep 17 00:00:00 2001
From: Kirk McKusick <mckusick@ucbvax.Berkeley.EDU>
Date: Fri, 10 May 1985 00:56:09 -0800
Subject: [PATCH 1/1] manual page distributed with 4.2BSD

SCCS-vsn: lib/libc/sys/gettimeofday.2 5.1
---
 usr/src/lib/libc/sys/gettimeofday.2 | 92 ++++++++++++++++++++++-------
 1 file changed, 70 insertions(+), 22 deletions(-)

diff --git a/usr/src/lib/libc/sys/gettimeofday.2 b/usr/src/lib/libc/sys/gettimeofday.2
index 13d64b7fed..78289ccdba 100644
--- a/usr/src/lib/libc/sys/gettimeofday.2
+++ b/usr/src/lib/libc/sys/gettimeofday.2
@@ -2,33 +2,81 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
-.\"	@(#)gettimeofday.2	4.1 (Berkeley) %G%
+.\"	@(#)gettimeofday.2	5.1 (Berkeley) %G%
 .\"
-.TH STIME 2 
+.TH GETTIMEOFDAY 2 "27 July 1983"
 .UC 4
 .SH NAME
-stime \- set time
+gettimeofday, settimeofday \- get/set date and time
 .SH SYNOPSIS
 .nf
-.B stime(tp)
-.B long *tp;
+.ft B
+#include <sys/time.h>
+.PP
+.ft B
+gettimeofday(tp, tzp)
+struct timeval *tp;
+struct timezone *tzp;
+.PP
+.ft B
+settimeofday(tp, tzp)
+struct timeval *tp;
+struct timezone *tzp;
 .fi
 .SH DESCRIPTION
-.I Stime
-sets the system's idea of the time and date.
-Time, pointed to by
-.I tp,
-is measured in seconds from 0000 GMT Jan 1, 1970.
-Only the super-user may use this call.
-.SH "SEE ALSO"
-date(1), time(2), ctime(3)
-.SH DIAGNOSTICS
-Zero is returned if the time was set;
-\-1 if user is not the super-user.
-.SH "ASSEMBLER (PDP-11)"
-(stime = 25.)
-.br
-(time in r0-r1)
-.br
-.B sys stime
+.I Gettimeofday
+returns the system's notion of the current Greenwich time and
+the current time zone.  Time returned is expressed relative
+in seconds and microseconds since midnight January 1, 1970.
 .PP
+The structures pointed to by
+.I tp
+and
+.I tzp
+are defined in 
+.I <sys/time.h>
+as:
+.PP
+.nf
+.RS
+.DT
+struct timeval {
+	u_long	tv_sec;		/* seconds since Jan. 1, 1970 */
+	long	tv_usec;		/* and microseconds */
+};
+.sp 1
+struct timezone {
+	int	tz_minuteswest;	/* of Greenwich */
+	int	tz_dsttime;	/* type of dst correction to apply */
+};
+.RE
+.fi
+.PP
+The 
+.I timezone
+structure indicates the local time zone
+(measured in minutes of time westward from Greenwich),
+and a flag that, if nonzero, indicates that
+Daylight Saving time applies locally during
+the appropriate part of the year.
+.PP
+Only the super-user may set the time of day.
+.SH RETURN
+A 0 return value indicates that the call succeeded.
+A \-1 return value indicates an error occurred, and in this
+case an error code is stored into the global variable \fIerrno\fP.
+.SH "ERRORS
+The following error codes may be set in \fIerrno\fP:
+.TP 15
+[EFAULT]
+An argument address referenced invalid memory.
+.TP 15
+[EPERM]
+A user other than the super-user attempted to set the time.
+.SH "SEE ALSO"
+date(1), ctime(3)
+.SH BUGS
+Time is never correct enough to believe the microsecond
+values.  There should a mechanism by which, at least,
+local clusters of systems might synchronize their clocks
+to millisecond granularity.
-- 
2.20.1