[Git][NTPsec/ntpsec][master] 6 commits: Fix anchors, slowly
Eric S. Raymond
gitlab at mg.gitlab.com
Wed Nov 30 20:10:21 UTC 2016
Eric S. Raymond pushed to branch master at NTPsec / ntpsec
Commits:
185665be by Sanjeev Gupta at 2016-12-01T01:38:00+08:00
Fix anchors, slowly
Signed-off-by: Sanjeev Gupta <ghane0 at gmail.com>
- - - - -
68e5470b by Sanjeev Gupta at 2016-12-01T01:42:34+08:00
Typo, leading to broken link for ntpviz
- - - - -
d3537a49 by Sanjeev Gupta at 2016-12-01T01:46:47+08:00
Fix anchors in monopt
Signed-off-by: Sanjeev Gupta <ghane0 at gmail.com>
- - - - -
eadef7ab by Sanjeev Gupta at 2016-12-01T01:58:57+08:00
Fix miscopt.html anchors
- - - - -
90d6a5e9 by Sanjeev Gupta at 2016-12-01T02:09:46+08:00
Fix anchors in confopt.html
Signed-off-by: Sanjeev Gupta <ghane0 at gmail.com>
- - - - -
b7b6ac64 by Sanjeev Gupta at 2016-12-01T02:17:36+08:00
Remove repeated lines in discover.html ,
and fix an anchor.
The text for the Multicast needs to be copy-edited, and
revised by someone who can confirm this works.
- - - - -
7 changed files:
- docs/discover.txt
- docs/includes/assoc-commands.txt
- docs/includes/confopt.txt
- docs/includes/misc-options.txt
- docs/includes/mon-commands.txt
- docs/includes/ntpq-body.txt
- docs/monopt.txt
Changes:
=====================================
docs/discover.txt
=====================================
--- a/docs/discover.txt
+++ b/docs/discover.txt
@@ -169,23 +169,23 @@ command but with a multicast (IPv4 class _D_ or IPv6 prefix _FF_)
group address. The IANA has designated IPv4 address 224.1.1.1 and IPv6
address FF05::101 (site local) for NTP.
+A manycast server is configured using the +manycastserver+ command,
+which listens on the specified address for manycast client
+messages. If a manycast server is in scope of the current TTL and is
+itself synchronized to a valid source and operating at a stratum level
+equal to or lower than the manycast client, it replies with an ordinary
+unicast server message.
+
The client sends ordinary client mode messages, but to one of
-these broadcast addresses rather than a unicast address, and sends
+these muticast addresses rather than a unicast address, and sends
only if less than +maxclock+ associations remain and then only at the
minimum feasible rate and minimum feasible time-to-live (TTL)
hops. The polling strategy is designed to reduce as much as possible
-the volume of broadcast messages and the effects of implosion due to
+the volume of manycast client messages and the effects of implosion due to
near-simultaneous arrival of manycast server messages. There can be as
many manycast client associations as different addresses, each one
serving as a template for future unicast client/server associations.
-A manycast server is configured using the +manycastserver+ command,
-which listens on the specified broadcast address for manycast client
-messages. If a manycast server is in scope of the current TTL and is
-itself synchronized to a valid source and operating at a stratum level
-equal to or lower than the manycast client, it replies with an ordinary
-unicast server message.
-
The manycast client receiving this message mobilizes a preemptable
client association according to the matching manycast client template.
This requires the server to be cryptographically authenticated and the
@@ -201,9 +201,6 @@ the "best" associations according to stratum and synchronization
distance. The surviving associations then continue in ordinary
client/server mode.
-The manycast client polling strategy is designed to reduce as much as
-possible the volume of manycast client messages and the effects of
-implosion due to near-simultaneous arrival of manycast server messages.
The strategy is determined by the _manycastclient_, _tos_ and _ttl_
configuration commands. The manycast poll interval is normally eight
times the system poll interval, which starts out at the _minpoll_ value
=====================================
docs/includes/assoc-commands.txt
=====================================
--- a/docs/includes/assoc-commands.txt
+++ b/docs/includes/assoc-commands.txt
@@ -23,6 +23,7 @@ link-local IPV6 address with an interface specified in
local clock can synchronized to the remote server, but the remote
server can never be synchronized to the local clock.
+[[server]]
+server+::
For server addresses, this command mobilizes a persistent client
mode association with the specified remote server or local radio
@@ -30,10 +31,12 @@ link-local IPV6 address with an interface specified in
server, but the remote server can never be synchronized to the local
clock. This command should _not_ be used for broadcast or multicast addresses.
+[[peer]]
+peer+::
NTP peer mode has been removed for security reasons. peer is now just
an alias for the server keyword. See above.
+[[broadcast]]
+broadcast+::
For broadcast and multicast addresses (only), this command mobilizes a persistent
broadcast mode association. Multiple commands can be used to specify
@@ -48,6 +51,7 @@ link-local IPV6 address with an interface specified in
(site local) exclusively to NTP, but other nonconflicting addresses
can be used to contain the messages within administrative boundaries.
+[[manycastclient]]
+manycastclient+::
For multicast addresses (only), this command mobilizes a manycast client
mode association for the multicast address specified. In this case a
@@ -66,6 +70,7 @@ link-local IPV6 address with an interface specified in
_server_ command. The remaining servers are discarded as if never
heard.
+[[unpeer]]
+unpeer+::
This command removes a previously configured association. An address
or association ID can be used to identify the association. Either an
=====================================
docs/includes/confopt.txt
=====================================
--- a/docs/includes/confopt.txt
+++ b/docs/includes/confopt.txt
@@ -5,6 +5,6 @@
* link:confopt.html#manycastclient[manycastclient - configure manycast client association]
* link:confopt.html#pool[pool - configure pool association]
* link:confopt.html#unpeer[unpeer - remove association]
-* link:confopt.html#manycastserver[manycastserver - enable manycast server]
+* link:discover.html#mcst[manycastserver - enable manycast server]
* link:comdex.html[Command Index]
=====================================
docs/includes/misc-options.txt
=====================================
--- a/docs/includes/misc-options.txt
+++ b/docs/includes/misc-options.txt
@@ -1,5 +1,6 @@
// Miscellaneous options. Gets included twice.
+[[broadcastdelay]]
+broadcastdelay+ _seconds_::
The broadcast and multicast modes require a special calibration to
determine the network delay between the local and remote servers.
@@ -16,6 +17,7 @@
packets sent in burst or iburst mode to allow additional time for a
modem or ISDN call to complete.
+[[driftfile]]
+driftfile+ _driftfile_::
This command specifies the complete path and name of the file used to
record the frequency of the local clock oscillator. This is the same
@@ -35,6 +37,7 @@ to replace the old version. This implies that {ntpdman} must
have write permission for the directory the drift file is located in,
and that file system links, symbolic or otherwise, should be avoided.
+[[enable]]
+enable+ [+auth+ | +bclient+ | +calibrate+ | +kernel+ | +monitor+ | +ntp+ | +stats+]; +disable+ [+auth+ | +bclient+ | +calibrate+ | +kernel+ | +monitor+ | +ntp+ | +stats+]::
Provides a way to enable or disable various server options. Flags not
mentioned are unaffected. Note that all of these flags can be
@@ -67,6 +70,7 @@ and that file system links, symbolic or otherwise, should be avoided.
section for further information. The default for this flag is
+disable+.
+[[includefile]]
+includefile+ _includefile_::
This command allows additional configuration commands to be included
from a separate file. Include files may be nested to a depth of
@@ -78,6 +82,7 @@ and that file system links, symbolic or otherwise, should be avoided.
multiple hosts, with (mostly) common options (e.g., a restriction
list).
+[[interface]]
+interface+ [+listen+ | +ignore+ | +drop+] [+all+ | +ipv4+ | +ipv6+ | +wildcard+ | 'name' | 'address'[/'prefixlen']]::
This command controls which network addresses +ntpd+ opens, and
whether input is dropped without processing. The first parameter
@@ -94,6 +99,7 @@ and that file system links, symbolic or otherwise, should be avoided.
are specified in the configuration file, all available network
addresses are opened. The +nic+ command is an alias for +interface+.
+[[leapfile]]
+leapfile+ 'leapfile'::
This command loads the NIST leapseconds file and initializes the
leapsecond values for the next leapsecond time, expiration time and
@@ -112,6 +118,7 @@ checks once a day to see if the _leapfile_ has changed.
hours). DO NOT USE THIS OPTION ON PUBLIC-ACCESS SERVERS! See
http://bugs.ntp.org/2855 for more information.
+[[logconfig]]
+logconfig+ _configkeyword_::
This command controls the amount and type of output written to the
system _syslog(3)_ facility or the alternate log file. By
@@ -150,6 +157,7 @@ and so on is suppressed.
used instead of the default system _syslog_(3)_ facility. This is the
same operation as the -l command line option.
+[[mru]]
+mru+ [+maxdepth+ 'count' | +maxmem+ 'kilobytes' | +mindepth+ 'count' | +maxage+ 'seconds' | +initalloc+ 'count' | +initmem+ 'kilobytes' | +incalloc+ 'count' | +incmem+ 'kilobytes']::
Controls size limits of the monitoring facility Most Recently Used
(MRU) list of client addresses, which is also
@@ -192,6 +200,7 @@ and so on is suppressed.
is reduced by half. This is intended to reduce the frequency of
unnecessary file writes for embedded systems with nonvolatile memory.
+[[phone]]
+phone+ 'dial ...'::
This command is used in conjunction with the ACTS modem driver (type
18). The arguments consist of a maximum of 10 telephone numbers used
@@ -199,10 +208,12 @@ and so on is suppressed.
ATDT is normally prepended to the number, which can contain other
modem control codes as well.
+[[reset]]
+reset [allpeers] [auth] [ctl] [io] [mem] [sys] [timer]+::
Reset one or more groups of counters maintained by ntpd and exposed by
+ntpq+.
+[[setvar]]
+setvar+ _variable_ [_default_]::
This command adds an additional system variable. These variables can
be used to distribute additional information such as the access
@@ -275,6 +286,7 @@ The variables operate as follows:
can be set to any positive number in seconds. If set to zero, the
stepout pulses will not be suppressed.
+[[rlimit]]
+rlimit+ [+memlock+ _megabytes_ | +stacksize+ _4kPages_ | +filenum+ _filedescriptors_]::
+memlock+ _megabytes_;;
=====================================
docs/includes/mon-commands.txt
=====================================
--- a/docs/includes/mon-commands.txt
+++ b/docs/includes/mon-commands.txt
@@ -1,5 +1,6 @@
// Monitoring commands. Is included twice.
+[[statistics]]
+statistics+ _name..._::
Enables writing of statistics records. Currently, eight kinds of
_name_ statistics are supported.
@@ -257,6 +258,7 @@ The remaining fields show the values used since the last report.
|_message_ |text |code path description (see source)
|====================================
+[[statsdir]]
+statsdir+ _directory_path_;;
Indicates the full path of a directory where statistics files should
be created (see below). This keyword allows the (otherwise constant)
=====================================
docs/includes/ntpq-body.txt
=====================================
--- a/docs/includes/ntpq-body.txt
+++ b/docs/includes/ntpq-body.txt
@@ -199,6 +199,7 @@ the server and expect a single response message. The exceptions are the
+peers+ command, which sends a series of messages, and the +mreadlist+
and +mreadvar+ commands, which iterate over a range of associations.
+[[as]]
+associations+::
Display a list of mobilized associations in the form
+
@@ -325,6 +326,7 @@ which could not be verified in parentheses.
Perform the same function as the +associations command+, except that
it uses previously stored data rather than making a new query.
+[[pe]]
+peers+::
Display a list of peers in the form
+
@@ -365,6 +367,7 @@ displayed.
+pstats+ _assocID_::
Show the statistics for the peer with the given _assocID_.
+[[rv]]
+readvar+ 'assocID' [ 'name' ] [,...]::
+rv+ 'assocID' [ 'name' ] [,...]::
Display the specified variables. If +assocID+ is zero, the variables
=====================================
docs/monopt.txt
=====================================
--- a/docs/monopt.txt
+++ b/docs/monopt.txt
@@ -45,7 +45,7 @@ _suffix_::
For more details on the format of statistics files, see
link:statfiles.html[Statistics file formats]. There is a
-visualization tool, linkLntpviz.html[ntpviz], which assists
+visualization tool, link:ntpviz.html[ntpviz], which assists
in making sense of these.
[[cmd]]
View it on GitLab: https://gitlab.com/NTPsec/ntpsec/compare/a67785d989057a88f3213326db1f43816a923672...b7b6ac6462dcef7274f1050e08bf841ec096d15d
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.ntpsec.org/pipermail/vc/attachments/20161130/d7dd96f4/attachment.html>
More information about the vc
mailing list