updates, rm machine-dependent comments (no longer accurate on vax)

SCCS-vsn: lib/libc/sys/adjtime.2 1.2

diff --git a/usr/src/lib/libc/sys/adjtime.2 b/usr/src/lib/libc/sys/adjtime.2
index 2d922a5..02c7054 100644 (file)
--- a/usr/src/lib/libc/sys/adjtime.2
+++ b/usr/src/lib/libc/sys/adjtime.2
@@ -2,7 +2,7 @@
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"
 .\" All rights reserved.  The Berkeley software License Agreement
 .\" specifies the terms and conditions for redistribution.
 .\"

-.\"    @(#)adjtime.2   1.1 (Berkeley) %G%
+.\"    @(#)adjtime.2   1.2 (Berkeley) %G%

 .\"
 .TH ADJTIME 2 ""
 .UC 6
 .\"
 .TH ADJTIME 2 ""
 .UC 6


@@ -20,19 +20,17 @@ struct timeval *olddelta;
 .fi
 .SH DESCRIPTION
 .I Adjtime
 .fi
 .SH DESCRIPTION
 .I Adjtime

-changes the system time, as returned by
+makes small adjustments to the system time, as returned by

 .IR gettimeofday (2),
 .IR gettimeofday (2),

-moving it backward or forward 
-by the number of microseconds corresponding to the timeval
+advancing or retarding it
+by the time speicified by the timeval

 \fIdelta\fP.
 \fIdelta\fP.

-.PP
-The time is maintained by incrementing it with a machine-dependent tick
-every clock interrupt.

 If \fIdelta\fP is negative, the clock is
 If \fIdelta\fP is negative, the clock is

-slowed down by incrementing it in smaller ticks until
-the correction is made.
-If \fIdelta\fP is positive, a larger tick
+slowed down by incrementing it more slowly than normal until
+the correction is complete.
+If \fIdelta\fP is positive, a larger increment than normal

 is used.
 is used.

+The skew used to perform the correction is generally a fraction of one percent.

 Thus, the time is always
 a monotonically increasing function.
 A time correction from an earlier call to \fIadjtime\fP
 Thus, the time is always
 a monotonically increasing function.
 A time correction from an earlier call to \fIadjtime\fP


@@ -42,7 +40,7 @@ then the structure pointed to will contain, upon return, the
 number of microseconds still to be corrected
 from the earlier call.
 .PP
 number of microseconds still to be corrected
 from the earlier call.
 .PP

-This call can be used in time servers that synchronize the clocks
+This call may be used by time servers that synchronize the clocks

 of computers in a local area network.
 Such time servers would slow down the clocks of some machines
 and speed up the clocks of others to bring them to the average network time.
 of computers in a local area network.
 Such time servers would slow down the clocks of some machines
 and speed up the clocks of others to bring them to the average network time.


@@ -50,12 +48,6 @@ and speed up the clocks of others to bring them to the average network time.
 The call 
 .IR adjtime (2)
 is restricted to the super-user.
 The call 
 .IR adjtime (2)
 is restricted to the super-user.

-.SH NOTES
-On a VAX the time is incremented 
-in 10ms ticks.
-When \fIadjtime\fP is called with an argument other than zero,
-ticks of 9ms or 11ms are used until the time is corrected.
-A \fIdelta\fP of less than 1ms would have no effect.

 .SH "RETURN VALUE
 A return value of 0 indicates that the call succeeded.
 A return value of \-1 indicates that an error occurred, and in this
 .SH "RETURN VALUE
 A return value of 0 indicates that the call succeeded.
 A return value of \-1 indicates that an error occurred, and in this