From 33ea5e65d78da3a3063a0d4786ba2a65edb3cc74 Mon Sep 17 00:00:00 2001 From: jmc <> Date: Tue, 11 Dec 2007 11:26:27 +0000 Subject: [PATCH] rearrange the page to read better; ok otto henning --- src/usr.sbin/ntpd/ntpd.8 | 99 ++++++++++++++++++++-------------------- 1 file changed, 49 insertions(+), 50 deletions(-) diff --git a/src/usr.sbin/ntpd/ntpd.8 b/src/usr.sbin/ntpd/ntpd.8 index 65baab6f..e7dcf13e 100644 --- a/src/usr.sbin/ntpd/ntpd.8 +++ b/src/usr.sbin/ntpd/ntpd.8 @@ -1,4 +1,4 @@ -.\" $OpenBSD: ntpd.8,v 1.22 2007/12/07 20:05:32 jmc Exp $ +.\" $OpenBSD: ntpd.8,v 1.23 2007/12/11 11:26:27 jmc Exp $ .\" .\" Copyright (c) 2003, 2004, 2006 Henning Brauer .\" @@ -14,7 +14,7 @@ .\" AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT .\" OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. .\" -.Dd $Mdocdate: December 7 2007 $ +.Dd $Mdocdate: December 11 2007 $ .Dt NTPD 8 .Os .Sh NAME @@ -39,6 +39,40 @@ as described in RFC 2030, and the Network Time Protocol version 3, as described in RFC 1305. .Pp +The options are as follows: +.Bl -tag -width "-f fileXXX" +.It Fl d +Do not daemonize. +If this option is specified, +.Nm +will run in the foreground and log to +.Em stderr . +.It Fl f Ar file +Use +.Ar file +as the configuration file, +instead of the default +.Pa /etc/ntpd.conf . +.It Fl n +Configtest mode. +Only check the configuration file for validity. +.It Fl S +Do not set the time immediately at startup. +This is the default. +.It Fl s +Set the time immediately at startup if the local clock is off by more +than 180 seconds. +Allows for a large time correction, +eliminating the need to run +.Xr rdate 8 +before starting +.Nm . +.It Fl v +This option allows +.Nm +to send DEBUG priority messages to syslog. +.El +.Pp .Nm uses the .Xr adjtime 2 @@ -63,11 +97,10 @@ system call to compensate for systematic drift. .Pp .Nm is usually started at boot time, and can be enabled by -setting the following in -.Pa /etc/rc.conf.local : -.Pp -.Dl ntpd_flags=\&"\&" -.Pp +setting +.Va ntpd_flags +in +.Pa /etc/rc.conf.local . See .Xr rc 8 and @@ -77,59 +110,25 @@ and enabling daemons. .Pp When .Nm -starts up, it reads settings from a configuration file, +starts up, it reads settings from its configuration file, typically -.Xr ntpd.conf 5 . -.Pp -The options are as follows: -.Bl -tag -width "-f fileXXX" -.It Fl d -Do not daemonize. -If this option is specified, -.Nm -will run in the foreground and log to -.Em stderr . -.It Fl f Ar file -Use -.Ar file -as the configuration file, -instead of the default -.Pa /etc/ntpd.conf . -.It Fl n -Configtest mode. -Only check the configuration file for validity. -.It Fl S -Do not set the time immediately at startup. -This is the default. -.It Fl s -Set the time immediately at startup if the local clock is off by more -than 180 seconds. -Allows for a large time correction, -eliminating the need to run -.Xr rdate 8 -before starting -.Nm . -.It Fl v -This option allows -.Nm -to send DEBUG priority messages to syslog. -.El +.Xr ntpd.conf 5 , +and its initial clock drift from +.Pa /var/db/ntpd.drift . +Clock drift is periodically written to the drift file thereafter. .Pp When .Nm receives a .Dv SIGINFO -signal, it will write its peer and sensor status to syslog. +signal, it writes its peer and sensor status to +.Xr syslog 3 . .Sh FILES .Bl -tag -width "/var/db/ntpd.driftXXX" -compact .It Pa /etc/ntpd.conf -default -.Nm -configuration file +Default configuration file. .It Pa /var/db/ntpd.drift -drift file, written by -.Nm -periodically and used at startup to get the initial clock drift +Drift file. .El .Sh SEE ALSO .Xr date 1 ,