Browse Source

document the optional "weight" keyword, and a little cleanup;

from henning and myself
OPENBSD_4_0
jmc 18 years ago
parent
commit
146a76e0cb
1 changed files with 28 additions and 9 deletions
  1. +28
    -9
      src/usr.sbin/ntpd/ntpd.conf.5

+ 28
- 9
src/usr.sbin/ntpd/ntpd.conf.5 View File

@ -1,4 +1,4 @@
.\" $OpenBSD: ntpd.conf.5,v 1.12 2006/05/28 07:58:52 jmc Exp $
.\" $OpenBSD: ntpd.conf.5,v 1.13 2006/05/29 18:47:19 jmc Exp $
.\" .\"
.\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org> .\" Copyright (c) 2003, 2004 Henning Brauer <henning@openbsd.org>
.\" .\"
@ -24,7 +24,20 @@
This manual page describes the format of the This manual page describes the format of the
.Xr ntpd 8 .Xr ntpd 8
configuration file. configuration file.
It has the following format:
.Pp
The optional
.Ic weight
keyword permits finer control over the relative importance
of time sources (servers or sensor devices).
Weights are specified in the range 1 to 10:
a server with a weight of 5
will have five times more importance on time offset calculation
than a server with a weight of 1.
If no weight is given,
the default is 1.
.Pp
.Nm
has the following format:
.Pp .Pp
Empty lines and lines beginning with the Empty lines and lines beginning with the
.Sq # .Sq #
@ -57,14 +70,16 @@ or
listen on 127.0.0.1 listen on 127.0.0.1
listen on ::1 listen on ::1
.Ed .Ed
.It Ic sensor Ar device
.It Xo Ic sensor Ar device
.Op Ic weight Ar offset
.Xc
Specify a timedelta sensor device Specify a timedelta sensor device
.Xr ntpd 8 .Xr ntpd 8
should use. should use.
It can be specified multiple times:
The sensor can be specified multiple times:
.Xr ntpd 8 .Xr ntpd 8
will use each given sensor that actually exists. will use each given sensor that actually exists.
Nonexistant sensors are ignored.
Non-existent sensors are ignored.
If If
.Sq * .Sq *
is given as device name, is given as device name,
@ -77,7 +92,9 @@ For example:
sensor * sensor *
sensor udcf0 sensor udcf0
.Ed .Ed
.It Ic server Ar address
.It Xo Ic server Ar address
.Op Ic weight Ar offset
.Xc
Specify the IP address or the hostname of an NTP Specify the IP address or the hostname of an NTP
server to synchronize to. server to synchronize to.
If it appears multiple times, If it appears multiple times,
@ -92,14 +109,16 @@ retries with the next address and continues to do so until a working address
is found. is found.
For example: For example:
.Bd -literal -offset indent .Bd -literal -offset indent
server 10.0.0.2
server ntp.example.org
server 10.0.0.2 weight 5
server ntp.example.org weight 1
.Ed .Ed
.Pp .Pp
To provide redundancy, it is good practice to configure multiple servers. To provide redundancy, it is good practice to configure multiple servers.
In general, best accuracy is obtained by using servers that have a low In general, best accuracy is obtained by using servers that have a low
network latency. network latency.
.It Ic servers Ar address
.It Xo Ic servers Ar address
.Op Ic weight Ar offset
.Xc
As with As with
.Cm server , .Cm server ,
specify the IP address or hostname of an NTP server to synchronize to. specify the IP address or hostname of an NTP server to synchronize to.


Loading…
Cancel
Save