From: Harlan Stenn Date: Sun, 7 Feb 2016 07:35:03 +0000 (+0000) Subject: Update ntp.conf documentation. Harlan Stenn. X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=6fc441ffa4517f64a944487444e7045d59c25c75;p=thirdparty%2Fntp.git Update ntp.conf documentation. Harlan Stenn. bk: 56b6f3a7MTj_cxFlEnPf38y12Xewtw --- diff --git a/ChangeLog b/ChangeLog index 8ccb9f0c4..d524d00f0 100644 --- a/ChangeLog +++ b/ChangeLog @@ -12,6 +12,7 @@ * [Bug 2995] Fixes to compile on Windows * Document ntp.key's optional IP list in authenetic.html. Harlan Stenn. * Update html/xleave.html documentation. Harlan Stenn. +* Update ntp.conf documentation. Harlan Stenn. --- (4.2.8p6) 2016/01/20 Released by Harlan Stenn diff --git a/ntpd/invoke-ntp.conf.texi b/ntpd/invoke-ntp.conf.texi index 1d8a62162..3c87eb87a 100644 --- a/ntpd/invoke-ntp.conf.texi +++ b/ntpd/invoke-ntp.conf.texi @@ -6,7 +6,7 @@ # # EDIT THIS FILE WITH CAUTION (invoke-ntp.conf.texi) # -# It has been AutoGen-ed January 20, 2016 at 04:17:59 AM by AutoGen 5.18.5 +# It has been AutoGen-ed February 6, 2016 at 07:23:05 AM by AutoGen 5.18.5 # From the definitions ntp.conf.def # and the template file agtexi-file.tpl @end ignore @@ -249,7 +249,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +@code{calldelay} +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -260,7 +262,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +@code{calldelay} +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -293,6 +297,10 @@ option to a lower limit of 4 (16 s). @item @code{noselect} Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. +@item @code{preempt} +Says the association can be preempted. +@item @code{true} +Marks the server as a truechimer. @item @code{prefer} Marks the server as preferred. All other things being equal, @@ -323,6 +331,12 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1-4 are the choices, with version 4 the default. +@item @code{xleave} +Valid in +@code{peer} +and +@code{broadcast} +modes only, this flag enables interleave mode. @end table @subsubsection Auxiliary Commands @table @asis @@ -1363,7 +1377,9 @@ Source address based restrictions are easily circumvented by a determined cracker. Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +@code{restrict} +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1429,7 +1445,9 @@ Packets that violate these minima are discarded and a kiss-o'-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +@code{monitor} +subcommand specifies the probability of discard for packets that overflow the rate-control window. @item @code{restrict} @code{address} @code{[@code{mask} @kbd{mask}]} @code{[@kbd{flag} @kbd{...}]} The @@ -1485,7 +1503,9 @@ If another KoD packet occurs within one second after the last one, the packet is dropped. @item @code{limited} Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +@code{discard} +command. A history of clients is kept using the monitoring capability of @code{ntpd(1ntpdmdoc)}. @@ -1613,8 +1633,11 @@ The library can also be used with other NTPv4 modes as well and is highly recommended, especially for broadcast modes. A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +@code{manycastclient} +command, which is similar to the +@code{server} +command but with a multicast (IPv4 class @code{D} or IPv6 prefix @code{FF}) @@ -1684,7 +1707,9 @@ command and, under normal circumstances, increments to the @code{maxpolll} value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +@code{ttl} +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2526,7 +2551,9 @@ This command specifies the location of an alternate log file to be used instead of the default system @code{syslog(3)} facility. -This is the same operation as the -l command line option. +This is the same operation as the +@code{-l} +command line option. @item @code{setvar} @kbd{variable} @code{[@code{default}]} This command adds an additional system variable. These diff --git a/ntpd/ntp.conf.5man b/ntpd/ntp.conf.5man index 1e5e464e6..f09ab32c3 100644 --- a/ntpd/ntp.conf.5man +++ b/ntpd/ntp.conf.5man @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntp.conf 5man "20 Jan 2016" "4.2.8p6" "File Formats" +.TH ntp.conf 5man "06 Feb 2016" "4.2.8p6" "File Formats" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-gsaOxR/ag-XsaGwR) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed January 20, 2016 at 04:17:45 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 6, 2016 at 07:23:07 AM by AutoGen 5.18.5 .\" From the definitions ntp.conf.def .\" and the template file agman-cmd.tpl .SH NAME @@ -289,7 +289,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +\f\*[B-Font]calldelay\f[] +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -301,7 +303,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +\f\*[B-Font]calldelay\f[] +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -339,6 +343,12 @@ option to a lower limit of 4 (16 s). Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. .TP 7 +.NOP \f\*[B-Font]preempt\f[] +Says the association can be preempted. +.TP 7 +.NOP \f\*[B-Font]true\f[] +Marks the server as a truechimer. +.TP 7 .NOP \f\*[B-Font]prefer\f[] Marks the server as preferred. All other things being equal, @@ -371,6 +381,13 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1-4 are the choices, with version 4 the default. +.TP 7 +.NOP \f\*[B-Font]xleave\f[] +Valid in +\f\*[B-Font]peer\f[] +and +\f\*[B-Font]broadcast\f[] +modes only, this flag enables interleave mode. .PP .SS Auxiliary Commands .TP 7 @@ -1559,7 +1576,9 @@ by a determined cracker. .ne 2 Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +\f\*[B-Font]restrict\f[] +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1627,7 +1646,9 @@ Packets that violate these minima are discarded and a kiss-o'-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +\f\*[B-Font]monitor\f[] +subcommand specifies the probability of discard for packets that overflow the rate-control window. .TP 7 .NOP \f\*[B-Font]restrict\f[] \f\*[B-Font]address\f[] [\f\*[B-Font]mask\f[] \f\*[I-Font]mask\f[]] [\f\*[I-Font]flag\f[] \f\*[I-Font]...\f[]] @@ -1687,7 +1708,9 @@ last one, the packet is dropped. .TP 7 .NOP \f\*[B-Font]limited\f[] Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +\f\*[B-Font]discard\f[] +command. A history of clients is kept using the monitoring capability of \fCntpd\f[]\fR(1ntpdmdoc)\f[]. @@ -1832,8 +1855,11 @@ as well and is highly recommended, especially for broadcast modes. .ne 2 A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +\f\*[B-Font]manycastclient\f[] +command, which is similar to the +\f\*[B-Font]server\f[] +command but with a multicast (IPv4 class \f\*[B-Font]D\f[] or IPv6 prefix \f\*[B-Font]FF\f[]) @@ -1909,7 +1935,9 @@ command and, under normal circumstances, increments to the \f\*[B-Font]maxpolll\f[] value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +\f\*[B-Font]ttl\f[] +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2833,7 +2861,9 @@ This command specifies the location of an alternate log file to be used instead of the default system \fCsyslog\f[]\fR(3)\f[] facility. -This is the same operation as the \-l command line option. +This is the same operation as the +\f\*[B-Font]\-l\f[] +command line option. .TP 7 .NOP \f\*[B-Font]setvar\f[] \f\*[I-Font]variable\f[] [\f\*[B-Font]default\f[]] This command adds an additional system variable. diff --git a/ntpd/ntp.conf.5mdoc b/ntpd/ntp.conf.5mdoc index f2b418b31..274f145f7 100644 --- a/ntpd/ntp.conf.5mdoc +++ b/ntpd/ntp.conf.5mdoc @@ -1,9 +1,9 @@ -.Dd January 20 2016 +.Dd February 6 2016 .Dt NTP_CONF 5mdoc File Formats .Os .\" EDIT THIS FILE WITH CAUTION (ntp.mdoc) .\" -.\" It has been AutoGen-ed January 20, 2016 at 04:18:07 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 6, 2016 at 07:23:02 AM by AutoGen 5.18.5 .\" From the definitions ntp.conf.def .\" and the template file agmdoc-cmd.tpl .Sh NAME @@ -286,7 +286,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -297,7 +299,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -330,6 +334,10 @@ option to a lower limit of 4 (16 s). .It Cm noselect Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. +.It Cm preempt +Says the association can be preempted. +.It Cm true +Marks the server as a truechimer. .It Cm prefer Marks the server as preferred. All other things being equal, @@ -360,6 +368,12 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1\-4 are the choices, with version 4 the default. +.It Cm xleave +Valid in +.Cm peer +and +.Cm broadcast +modes only, this flag enables interleave mode. .El .Ss Auxiliary Commands .Bl -tag -width indent @@ -1423,7 +1437,9 @@ Source address based restrictions are easily circumvented by a determined cracker. .Pp Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +.Ic restrict +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1493,7 +1509,9 @@ Packets that violate these minima are discarded and a kiss\-o'\-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +.Ic monitor +subcommand specifies the probability of discard for packets that overflow the rate\-control window. .It Xo Ic restrict address .Op Cm mask Ar mask @@ -1552,7 +1570,9 @@ If another KoD packet occurs within one second after the last one, the packet is dropped. .It Cm limited Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +.Ic discard +command. A history of clients is kept using the monitoring capability of .Xr ntpd 1ntpdmdoc . @@ -1679,8 +1699,11 @@ The library can also be used with other NTPv4 modes as well and is highly recommended, especially for broadcast modes. .Pp A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +.Ic manycastclient +command, which is similar to the +.Ic server +command but with a multicast (IPv4 class .Cm D or IPv6 prefix .Cm FF ) @@ -1750,7 +1773,9 @@ command and, under normal circumstances, increments to the .Cm maxpolll value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +.Ic ttl +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2651,7 +2676,9 @@ This command specifies the location of an alternate log file to be used instead of the default system .Xr syslog 3 facility. -This is the same operation as the \-l command line option. +This is the same operation as the +.Fl l +command line option. .It Ic setvar Ar variable Op Cm default This command adds an additional system variable. These diff --git a/ntpd/ntp.conf.def b/ntpd/ntp.conf.def index 25d9fd09f..97b91d6ec 100644 --- a/ntpd/ntp.conf.def +++ b/ntpd/ntp.conf.def @@ -288,7 +288,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -299,7 +301,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -332,6 +336,10 @@ option to a lower limit of 4 (16 s). .It Cm noselect Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. +.It Cm preempt +Says the association can be preempted. +.It Cm true +Marks the server as a truechimer. .It Cm prefer Marks the server as preferred. All other things being equal, @@ -362,6 +370,12 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1-4 are the choices, with version 4 the default. +.It Cm xleave +Valid in +.Cm peer +and +.Cm broadcast +modes only, this flag enables interleave mode. .El .Ss Auxiliary Commands .Bl -tag -width indent @@ -1425,7 +1439,9 @@ Source address based restrictions are easily circumvented by a determined cracker. .Pp Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +.Ic restrict +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1495,7 +1511,9 @@ Packets that violate these minima are discarded and a kiss-o'-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +.Ic monitor +subcommand specifies the probability of discard for packets that overflow the rate-control window. .It Xo Ic restrict address .Op Cm mask Ar mask @@ -1554,7 +1572,9 @@ If another KoD packet occurs within one second after the last one, the packet is dropped. .It Cm limited Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +.Ic discard +command. A history of clients is kept using the monitoring capability of .Xr ntpd 1ntpdmdoc . @@ -1681,8 +1701,11 @@ The library can also be used with other NTPv4 modes as well and is highly recommended, especially for broadcast modes. .Pp A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +.Ic manycastclient +command, which is similar to the +.Ic server +command but with a multicast (IPv4 class .Cm D or IPv6 prefix .Cm FF ) @@ -1752,7 +1775,9 @@ command and, under normal circumstances, increments to the .Cm maxpolll value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +.Ic ttl +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2653,7 +2678,9 @@ This command specifies the location of an alternate log file to be used instead of the default system .Xr syslog 3 facility. -This is the same operation as the -l command line option. +This is the same operation as the +.Fl l +command line option. .It Ic setvar Ar variable Op Cm default This command adds an additional system variable. These diff --git a/ntpd/ntp.conf.man.in b/ntpd/ntp.conf.man.in index 7a5b7502d..8eabacb0e 100644 --- a/ntpd/ntp.conf.man.in +++ b/ntpd/ntp.conf.man.in @@ -10,11 +10,11 @@ .ds B-Font B .ds I-Font I .ds R-Font R -.TH ntp.conf 5 "20 Jan 2016" "4.2.8p6" "File Formats" +.TH ntp.conf 5 "06 Feb 2016" "4.2.8p6" "File Formats" .\" -.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-gsaOxR/ag-XsaGwR) +.\" EDIT THIS FILE WITH CAUTION (in-mem file) .\" -.\" It has been AutoGen-ed January 20, 2016 at 04:17:45 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 6, 2016 at 07:23:07 AM by AutoGen 5.18.5 .\" From the definitions ntp.conf.def .\" and the template file agman-cmd.tpl .SH NAME @@ -289,7 +289,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +\f\*[B-Font]calldelay\f[] +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -301,7 +303,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +\f\*[B-Font]calldelay\f[] +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -339,6 +343,12 @@ option to a lower limit of 4 (16 s). Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. .TP 7 +.NOP \f\*[B-Font]preempt\f[] +Says the association can be preempted. +.TP 7 +.NOP \f\*[B-Font]true\f[] +Marks the server as a truechimer. +.TP 7 .NOP \f\*[B-Font]prefer\f[] Marks the server as preferred. All other things being equal, @@ -371,6 +381,13 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1-4 are the choices, with version 4 the default. +.TP 7 +.NOP \f\*[B-Font]xleave\f[] +Valid in +\f\*[B-Font]peer\f[] +and +\f\*[B-Font]broadcast\f[] +modes only, this flag enables interleave mode. .PP .SS Auxiliary Commands .TP 7 @@ -1559,7 +1576,9 @@ by a determined cracker. .ne 2 Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +\f\*[B-Font]restrict\f[] +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1627,7 +1646,9 @@ Packets that violate these minima are discarded and a kiss-o'-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +\f\*[B-Font]monitor\f[] +subcommand specifies the probability of discard for packets that overflow the rate-control window. .TP 7 .NOP \f\*[B-Font]restrict\f[] \f\*[B-Font]address\f[] [\f\*[B-Font]mask\f[] \f\*[I-Font]mask\f[]] [\f\*[I-Font]flag\f[] \f\*[I-Font]...\f[]] @@ -1687,7 +1708,9 @@ last one, the packet is dropped. .TP 7 .NOP \f\*[B-Font]limited\f[] Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +\f\*[B-Font]discard\f[] +command. A history of clients is kept using the monitoring capability of \fCntpd\f[]\fR(@NTPD_MS@)\f[]. @@ -1832,8 +1855,11 @@ as well and is highly recommended, especially for broadcast modes. .ne 2 A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +\f\*[B-Font]manycastclient\f[] +command, which is similar to the +\f\*[B-Font]server\f[] +command but with a multicast (IPv4 class \f\*[B-Font]D\f[] or IPv6 prefix \f\*[B-Font]FF\f[]) @@ -1909,7 +1935,9 @@ command and, under normal circumstances, increments to the \f\*[B-Font]maxpolll\f[] value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +\f\*[B-Font]ttl\f[] +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2833,7 +2861,9 @@ This command specifies the location of an alternate log file to be used instead of the default system \fCsyslog\f[]\fR(3)\f[] facility. -This is the same operation as the \-l command line option. +This is the same operation as the +\f\*[B-Font]\-l\f[] +command line option. .TP 7 .NOP \f\*[B-Font]setvar\f[] \f\*[I-Font]variable\f[] [\f\*[B-Font]default\f[]] This command adds an additional system variable. diff --git a/ntpd/ntp.conf.mdoc.in b/ntpd/ntp.conf.mdoc.in index fe85d8548..225f11156 100644 --- a/ntpd/ntp.conf.mdoc.in +++ b/ntpd/ntp.conf.mdoc.in @@ -1,9 +1,9 @@ -.Dd January 20 2016 +.Dd February 6 2016 .Dt NTP_CONF 5 File Formats .Os .\" EDIT THIS FILE WITH CAUTION (ntp.mdoc) .\" -.\" It has been AutoGen-ed January 20, 2016 at 04:18:07 AM by AutoGen 5.18.5 +.\" It has been AutoGen-ed February 6, 2016 at 07:23:02 AM by AutoGen 5.18.5 .\" From the definitions ntp.conf.def .\" and the template file agmdoc-cmd.tpl .Sh NAME @@ -286,7 +286,9 @@ when the server is reachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first and second packets -can be changed with the calldelay command to allow +can be changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to improve timekeeping quality with the @@ -297,7 +299,9 @@ When the server is unreachable, send a burst of eight packets instead of the usual one. The packet spacing is normally 2 s; however, the spacing between the first two packets can be -changed with the calldelay command to allow +changed with the +.Ic calldelay +command to allow additional time for a modem or ISDN call to complete. This is designed to speed the initial synchronization acquisition with the @@ -330,6 +334,10 @@ option to a lower limit of 4 (16 s). .It Cm noselect Marks the server as unused, except for display purposes. The server is discarded by the selection algroithm. +.It Cm preempt +Says the association can be preempted. +.It Cm true +Marks the server as a truechimer. .It Cm prefer Marks the server as preferred. All other things being equal, @@ -360,6 +368,12 @@ Specifies the version number to be used for outgoing NTP packets. Versions 1\-4 are the choices, with version 4 the default. +.It Cm xleave +Valid in +.Cm peer +and +.Cm broadcast +modes only, this flag enables interleave mode. .El .Ss Auxiliary Commands .Bl -tag -width indent @@ -1423,7 +1437,9 @@ Source address based restrictions are easily circumvented by a determined cracker. .Pp Clients can be denied service because they are explicitly -included in the restrict list created by the restrict command +included in the restrict list created by the +.Ic restrict +command or implicitly as the result of cryptographic or rate limit violations. Cryptographic violations include certificate @@ -1493,7 +1509,9 @@ Packets that violate these minima are discarded and a kiss\-o'\-death packet returned if enabled. The default minimum average and minimum are 5 and 2, respectively. -The monitor subcommand specifies the probability of discard +The +.Ic monitor +subcommand specifies the probability of discard for packets that overflow the rate\-control window. .It Xo Ic restrict address .Op Cm mask Ar mask @@ -1552,7 +1570,9 @@ If another KoD packet occurs within one second after the last one, the packet is dropped. .It Cm limited Deny service if the packet spacing violates the lower limits specified -in the discard command. +in the +.Ic discard +command. A history of clients is kept using the monitoring capability of .Xr ntpd @NTPD_MS@ . @@ -1679,8 +1699,11 @@ The library can also be used with other NTPv4 modes as well and is highly recommended, especially for broadcast modes. .Pp A persistent manycast client association is configured -using the manycastclient command, which is similar to the -server command but with a multicast (IPv4 class +using the +.Ic manycastclient +command, which is similar to the +.Ic server +command but with a multicast (IPv4 class .Cm D or IPv6 prefix .Cm FF ) @@ -1750,7 +1773,9 @@ command and, under normal circumstances, increments to the .Cm maxpolll value specified in this command. Initially, the TTL is -set at the minimum hops specified by the ttl command. +set at the minimum hops specified by the +.Ic ttl +command. At each retransmission the TTL is increased until reaching the maximum hops specified by this command or a sufficient number client associations have been found. @@ -2651,7 +2676,9 @@ This command specifies the location of an alternate log file to be used instead of the default system .Xr syslog 3 facility. -This is the same operation as the \-l command line option. +This is the same operation as the +.Fl l +command line option. .It Ic setvar Ar variable Op Cm default This command adds an additional system variable. These