From: Harlan Stenn Date: Thu, 15 Oct 2009 04:53:23 +0000 (-0400) Subject: Documentation cleanup and updates X-Git-Tag: NTP_4_2_5P233_RC~1^2 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7acecf1d3378e1f413ad91ca149a706e8bfc98eb;p=thirdparty%2Fntp.git Documentation cleanup and updates bk: 4ad6aac3ufbvEacguRAk7CLeTc06_g --- diff --git a/ChangeLog b/ChangeLog index e16d50716..7708f0a65 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,4 @@ +* Documentation cleanup and updates. (4.2.5p232-RC) 2009/10/14 Released by Harlan Stenn * [Bug 1302] OpenSSL under Windows needs applink support. * [Bug 1337] fix incorrect args to setsockopt(fd, IP_MULTICAST_IF,...). diff --git a/html/miscopt.html b/html/miscopt.html index dd51e2eec..f3b52d7f0 100644 --- a/html/miscopt.html +++ b/html/miscopt.html @@ -13,7 +13,7 @@ giffrom Pogo, Walt Kelly

We have three, now looking for more.

Last update: - 04-Oct-2009 21:36 + 14-Oct-2009 20:53 UTC


Related Links

diff --git a/html/ntpd.html b/html/ntpd.html index 450408bc6..2973b8880 100644 --- a/html/ntpd.html +++ b/html/ntpd.html @@ -10,10 +10,10 @@ -

ntpd - Network Time Protocol (NTP) daemon

+

ntpd - Network Time Protocol (NTP) Daemon

giffrom The Wizard of Oz, L. Frank Baum

You need help from the monkeys.

-

Last update: 18-jun-09 19:45

+

Last update: 14-oct-09 22:23


Related Links

@@ -28,7 +28,7 @@
  • Additional Features
  • Command Line Options
  • The Configuration File
    • -
  • Files +
  • Files

    • Synopsis

    @@ -47,7 +47,7 @@

    The ntpd program normally operates continuously while adjusting the time and frequency, but in some cases it may not be practical to run it continuously. With the -q option ntpd operates as in continous mode, but exits just after setting the clock for the first time. Most applications will probably want to specify the iburst option with the server command. With this option a volley of messages is exchanged to groom the data and set the clock in about 10 s. If nothing is heard after a few minutes, the daemon times out and exits.

    Poll Interval Control

    NTP uses an intricate heuristic algorithm to automatically control the poll interval for maximum accuracy consistent with minimum network overhead. The algorithm measures the incidental offset and jitter to determine the best poll interval. When ntpd starts, the interval is the default minimum 64 s. Under normal conditions when the clock discipline has stabilized, the interval increases in steps to the default maximum 1024 s. In addition, should a server become unreachable after some time, the interval increases in steps to the maximum in order to reduce network overhead.

    -

    The default poll interval range is suitable for most conditions, but can be changed using options on the Server Options and Miscellaneous Options pages. However, when using maximum intervals much larger than the default, the residual clock frequency error must be small enough for the discipline loop to capture and correct. The capture range is 500 PPM with a 64-s interval decreasing by a factor of two for each interval doubling. At a 36-hr interval, for example, the capture range is only 0.24 PPM.

    +

    The default poll interval range is suitable for most conditions, but can be changed using options on the Server Options and Miscellaneous Options pages. However, when using maximum intervals much larger than the default, the residual clock frequency error must be small enough for the discipline loop to capture and correct. The capture range is 500 PPM with a 64-s interval decreasing by a factor of two for each interval doubling. At a 36-hr interval, for example, the capture range is only 0.24 PPM.

    The huff-n'-puff Filter

    In scenarios where a considerable amount of data are to be downloaded or uploaded over telephone modems, timekeeping quality can be seriously degraded. This occurs because the differential delays on the two directions of transmission can be quite large. In many cases the apparent time errors are so large as to exceed the step threshold and a step correction can occur during and after the data transfer.

    The huff-n'-puff filter is designed to correct the apparent time offset in these cases. It depends on knowledge of the propagation delay when no other traffic is present, such as during other than work hours. The filter remembers the minimum delay over the most recent interval measured usually in hours. Under conditions of severe delay, the filter corrects the apparent offset using the sign of the offset and the difference between the apparent delay and minimum delay. The name of the filter reflects the negative (huff) and positive (puff) correction, which depends on the sign of the offset. The filter is activated by the tinker huffpuff command, as described in the Miscellaneous Options page.

    @@ -90,57 +90,75 @@

    When ntpd starts it looks at the value of umask, and if zero ntpd will set the umask to 022.

    Command Line Options

    -
    -a -
    Require cryptographic authentication for broadcast client, multicast client and symmetric passive associations. This is the same operation as the enable auth command and is the default.
    -A -
    Do not require cryptographic authentication for broadcast client, multicast client and symmetric passive associations. This is the same operation as the disable auth command and almost never a good idea.
    -b -
    Enable the client to synchronize to broadcast servers. -
    -c conffile -
    Specify the name and path of the configuration file, default /etc/ntp.conf. -
    -d -
    Specify debugging mode. This option may occur more than once, with each occurrence indicating greater detail of display. -
    -D level -
    Specify debugging level directly. -
    -f driftfile -
    Specify the name and path of the frequency file, default /etc/ntp.drift. This is the same operation as the driftfile driftfile command.
    -g -
    Normally, ntpd exits with a message to the system log if the offset exceeds the panic threshold, which is 1000 s by default. This option allows the time to be set to any value without restriction; however, this can happen only once. If the threshold is exceeded after that, ntpd will exit with a message to the system log. This option can be used with the -q and -x options. See the tinker command for other options. -
    -i jaildir -
    Chroot the server to the directory jaildir. This option also implies that the server attempts to drop root privileges at startup (otherwise, chroot gives very little additional security), and it is only available if the OS supports to run the server without full root privileges. You may need to also specify a -u option. -
    -I [address | interface name] -
    Open the network address given, or all the addresses associated with the given interface name. This option may appear multiple times. This option also implies not opening other addresses, except wildcard and localhost. This option is deprecated. Please consider using the configuration file interface command, which is more versatile. -
    -k keyfile -
    Specify the name and path of the symmetric key file, default /etc/ntp.keys. This is the same operation as the keys keyfile command. -
    -l logfile -
    Specify the name and path of the log file. The default is the system log file. This is the same operation as the logfile logfile command. -
    -L -
    Do not listen to virtual interfaces, defined as those with names containing a colon. This option is deprecated. Please consider using the configuration file interface command, which is more versatile. -
    -M -
    Raise scheduler precision to its maximum (1 msec) using timeBeginPeriod.  (Windows only) -
    -n -
    Don't fork. -
    -N -
    To the extent permitted by the operating system, run the ntpd at the highest priority. -
    -p pidfile -
    Specify the name and path of the file used to record the ntpd process ID. This is the same operation as the pidfile pidfile command.
    -P priority -
    To the extent permitted by the operating system, run the ntpd at the specified priority. -
    -q -
    Exit the ntpd just after the first time the clock is set. This behavior mimics that of the ntpdate program, which is to be retired. The -g and -x options can be used with this option. Note: The kernel time discipline is disabled with this option. -
    -r broadcastdelay -
    Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol. -
    -s statsdir -
    Specify the directory path for files created by the statistics facility. This is the same operation as the statsdir statsdir command.
    -t key -
    Add a key number to the trusted key list. This option can occur more than once. This is the same operation as the trustedkey key command.
    -u user[:group] -
    Specify a user, and optionally a group, to switch to. This option is only available if the OS supports running the server without full root privileges. Currently, this option is supported under NetBSD (configure with --enable-clockctl) and Linux (configure with --enable-linuxcaps).
    -U interface update interval +
    -a
    +
    Require cryptographic authentication for broadcast client, multicast client and symmetric passive associations. This is the same operation as the enable auth command and is the default.
    +
    -A
    +
    Do not require cryptographic authentication for broadcast client, multicast client and symmetric passive associations. This is the same operation as the disable auth command and almost never a good idea.
    +
    -b
    +
    Enable the client to synchronize to broadcast servers.
    +
    -c conffile
    +
    Specify the name and path of the configuration file, default /etc/ntp.conf.
    +
    -d
    +
    Specify debugging mode. This option may occur more than once, with each occurrence indicating greater detail of display.
    +
    -D level
    +
    Specify debugging level directly.
    +
    -f driftfile
    +
    Specify the name and path of the frequency file, default /etc/ntp.drift. This is the same operation as the driftfile driftfile command.
    +
    -g
    +
    Normally, ntpd exits with a message to the system log if the offset exceeds the panic threshold, which is 1000 s by default. This option allows the time to be set to any value without restriction; however, this can happen only once. If the threshold is exceeded after that, ntpd will exit with a message to the system log. This option can be used with the -q and -x options. See the tinker command for other options.
    +
    -i jaildir
    +
    Chroot the server to the directory jaildir. This option also implies that the server attempts to drop root privileges at startup (otherwise, chroot gives very little additional security), and it is only available if the OS supports to run the server without full root privileges. You may need to also specify a -u option.
    +
    -I [address | interface name]
    +
    Open the network address given, or all the addresses associated with the given interface name. This option may appear multiple times. This option also implies not opening other addresses, except wildcard and localhost. This option is deprecated. Please consider using the configuration file interface command, which is more versatile.
    +
    -k keyfile
    +
    Specify the name and path of the symmetric key file, default /etc/ntp.keys. This is the same operation as the keys keyfile command.
    +
    -l logfile
    +
    Specify the name and path of the log file. The default is the system log file. This is the same operation as the logfile logfile command.
    +
    -L
    +
    Do not listen to virtual interfaces, defined as those with names containing a colon. This option is deprecated. Please consider using the configuration file interface command, which is more versatile.
    +
    -M
    +
    Raise scheduler precision to its maximum (1 msec) using timeBeginPeriod. (Windows only)
    +
    -n
    +
    Don't fork.
    +
    -N
    +
    To the extent permitted by the operating system, run the ntpd at the highest priority.
    +
    -p pidfile
    +
    Specify the name and path of the file used to record the ntpd process ID. This is the same operation as the pidfile pidfile command.
    +
    -P priority
    +
    To the extent permitted by the operating system, run the ntpd at the specified priority.
    +
    -q
    +
    Exit the ntpd just after the first time the clock is set. This behavior mimics that of the ntpdate program, which is to be retired. The -g and -x options can be used with this option. Note: The kernel time discipline is disabled with this option.
    +
    -r broadcastdelay
    +
    Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol.
    +
    -s statsdir
    +
    Specify the directory path for files created by the statistics facility. This is the same operation as the statsdir statsdir command.
    +
    -t key
    +
    Add a key number to the trusted key list. This option can occur more than once. This is the same operation as the trustedkey key command.
    +
    -u user[:group]
    +
    Specify a user, and optionally a group, to switch to. This option is only available if the OS supports running the server without full root privileges. Currently, this option is supported under NetBSD (configure with --enable-clockctl) and Linux (configure with --enable-linuxcaps).
    +
    -U interface update interval
    Number of seconds to wait between interface list scans to pick up new and delete network interface. Set to 0 to disable dynamic interface list updating. The default is to scan every 5 minutes.
    -
    -v variable -
    -V variable -
    Add a system variable listed by default. -
    -x -
    Normally, the time is slewed if the offset is less than the step threshold, which is 128 ms by default, and stepped if above the threshold. This option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. Note: Since the slew rate of typical Unix kernels is limited to 0.5 ms/s, each second of adjustment requires an amortization interval of 2000 s. Thus, an adjustment as much as 600 s will take almost 14 days to complete. This option can be used with the -g and -q options. See the tinker command for other options. Note: The kernel time discipline is disabled with this option. -
    --pccfreq frequency -
    Substitute processor cycle counter for QueryPerformanceCounter unconditionally using the given frequency (in Hz).  --pccfreq can be used on systems which do not use the PCC to implement QueryPerformanceCounter and have a fixed PCC frequency.  The frequency specified must be accurate within 0.5 percent.  --usepcc is equivalent on many systems and should be tried first, as it does not require determining the frequency of the processor cycle counter.  For x86-compatible processors, the PCC is also referred to as RDTSC, which is the assembly-language instruction to retrieve the current value.  (Windows only) -
    --usepcc -
    Substitute processor cycle counter for QueryPerformanceCounter if they appear equivalent.  This option should be used only if the PCC frequency is fixed.  Power-saving functionality on many laptops varies the PCC frequency.  (Windows only) -
    +
    -v variable
    +
    -V variable
    +
    Add a system variable listed by default.
    +
    -x
    +
    Normally, the time is slewed if the offset is less than the step threshold, which is 128 ms by default, and stepped if above the threshold. This option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually. Note: Since the slew rate of typical Unix kernels is limited to 0.5 ms/s, each second of adjustment requires an amortization interval of 2000 s. Thus, an adjustment as much as 600 s will take almost 14 days to complete. This option can be used with the -g and -q options. See the tinker command for other options. Note: The kernel time discipline is disabled with this option.
    +
    --pccfreq frequency
    +
    Substitute processor cycle counter for QueryPerformanceCounter unconditionally + using the given frequency (in Hz). --pccfreq can be used on systems + which do not use the PCC to implement QueryPerformanceCounter + and have a fixed PCC frequency. The frequency specified must + be accurate within 0.5 percent. --usepcc is equivalent on many systems and should + be tried first, as it does not require determining the frequency + of the processor cycle counter. For x86-compatible processors, the PCC is + also referred to as RDTSC, which is the assembly-language instruction to retrieve + the current value.  (Windows only)
    +
    --usepcc
    +
    Substitute processor cycle counter for QueryPerformanceCounter if they + appear equivalent. This option should be used only if the PCC + frequency is fixed. Power-saving functionality on many laptops varies the + PCC frequency. (Windows only)
    +

    The Configuration File

    Ordinarily, ntpd reads the ntp.conf configuration file at startup in order to determine the synchronization sources and operating modes. It is also possible to specify a working, although limited, configuration entirely on the command line, obviating the need for a configuration file. This may be particularly useful when the local host is to be configured as a broadcast client, with servers determined by listening to broadcasts at run time.

    Usually, the configuration file is installed as/etc/ntp.conf, but could be installed elsewhere (see the -c conffile command line option). The file format is similar to other Unix configuration files - comments begin with a # character and extend to the end of the line; blank lines are ignored.

    diff --git a/html/ntpq.html b/html/ntpq.html index 4b06c42ca..542d19a8f 100644 --- a/html/ntpq.html +++ b/html/ntpq.html @@ -7,21 +7,28 @@ ntpq - standard NTP query program - +

    ntpq - standard NTP query program

    giffrom Pogo, Walt Kelly

    A typical NTP monitoring packet

    -

    Last update: July 5, 2008

    -
    +

    Last update: + 15-Oct-2009 1:09 + UTC

    +

    More Help

    Synopsis

    ntpq [-inp] [-c command] [host] [...]

    Description

    -

    The ntpq utility program is used to monitor NTP daemon ntpd operations and determine performance. It uses the standard NTP mode 6 control message formats defined in Appendix B of the NTPv3 specification RFC1305. The same formats are used in NTPv4, although some of the variables have changed and new ones added. The description on this page is for the NTPv4 variables.

    +

    The ntpq utility program is used to monitor NTP daemon ntpd operations + and determine performance. It uses the standard NTP mode 6 control + message formats defined in Appendix B of the NTPv3 specification + RFC1305. The same formats are used in NTPv4, although some of the + variable names have changed and new ones added. The description + on this page is for the NTPv4 variables.

    The program can be run either in interactive mode or controlled using command line arguments. Requests to read and write arbitrary variables can be assembled, with raw and pretty-printed output options being available. The ntpq can also obtain and print a list of peers in a common format by sending multiple queries to the server.

    If one or more request options is included on the command line when ntpq is executed, each of the requests will be sent to the NTP servers running on each of the hosts given as command line arguments, or on localhost by default. If no request options are given, ntpq will attempt to read commands from the standard input and execute these on the NTP server running on the first host given on the command line, again defaulting to localhost when no other host is specified. ntpq will prompt for commands if the standard input is a terminal device.

    ntpq uses NTP mode 6 packets to communicate with the NTP server, and hence can be used to query any compatible server on the network which permits it. Note that since NTP is a UDP protocol this communication will be somewhat unreliable, especially over large distances in terms of network topology. ntpq makes one attempt to retransmit requests, and will time requests out if the remote host is not heard from within a suitable timeout time.

    @@ -29,56 +36,60 @@

    For examples and usage, see the NTP Debugging Techniques page.

    Command line options are described following. Specifying a command line option other than -i or -n will cause the specified query (queries) to be sent to the indicated host(s) immediately. Otherwise, ntpq will attempt to read interactive format commands from the standard input.

    -
    -4 -
    Force DNS resolution of following host names on the command line to the IPv4 namespace. -
    -6 -
    Force DNS resolution of following host names on the command line to the IPv6 namespace. -
    -c -
    The following argument is interpreted as an interactive format command and is added to the list of commands to be executed on the specified host(s). Multiple -c options may be given. -
    -d -
    Turn on debugging mode. -
    -i -
    Force ntpq to operate in interactive mode. Prompts will be written to the standard output and commands read from the standard input. -
    -n -
    Output all host addresses in dotted-quad numeric format rather than converting to the canonical host names. -
    -p -
    Print a list of the peers known to the server as well as a summary of their state. This is equivalent to the peers interactive command. -
    --old-rv -
    When querying a single variable, such as ntpq -c 'rv 0 version', precede the requested variable with a status line. +
    -4
    +
    Force DNS resolution of following host names on the command line to the IPv4 namespace.
    +
    -6
    +
    Force DNS resolution of following host names on the command line to the IPv6 namespace.
    +
    -c
    +
    The following argument is interpreted as an interactive format command and is added to the list of commands to be executed on the specified host(s). Multiple -c options may be given.
    +
    -d
    +
    Turn on debugging mode.
    +
    -i
    +
    Force ntpq to operate in interactive mode. Prompts will be written to the standard output and commands read from the standard input.
    +
    -n
    +
    Output all host addresses in dotted-quad numeric format rather than converting to the canonical host names.
    +
    -p
    +
    Print a list of the peers known to the server as well as a summary of their state. This is equivalent to the peers interactive command.

    Internal Commands

    Interactive format commands consist of a keyword followed by zero to four arguments. Only enough characters of the full keyword to uniquely identify the command need be typed. The output of a command is normally sent to the standard output, but optionally the output of individual commands may be sent to a file by appending a >, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the ntpq program itself and do not result in NTP mode-6 requests being sent to a server. These are described following.

    ? [command_keyword]
    - help [command_keyword] -
    A ? by itself will print a list of all the command keywords known to ntpq. A ? followed by a command keyword will print function and usage information about the command. + help [command_keyword] +
    A ? by itself will print a list of all the command keywords known to ntpq. A ? followed by a command keyword will print function and usage information about the command.
    addvars name [ = value] [...]
    rmvars name [...]
    - clearvars -
    The arguments to this command consist of a list of items of the form name = value, where the = value is ignored, and can be omitted in read requests. ntpq maintains an internal list in which data to be included in control messages can be assembled, and sent using the readlist and writelist commands described below. The addvars command allows variables and optional values to be added to the list. If more than one variable is to be added, the list should be comma-separated and not contain white space. The rmvars command can be used to remove individual variables from the list, while the clearlist command removes all variables from the list. -
    cooked -
    Display server messages in prettyprint format.
    debug more | less | off -
    Turns internal query program debugging on and off. -
    delay milliseconds -
    Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete. -
    host name -
    Set the host to which future queries will be sent. The name may be either a DNS name or a numeric address.
    hostnames [yes | no] -
    If yes is specified, host names are printed in information displays. If no is specified, numeric addresses are printed instead. The default is yes, unless modified using the command line -n switch. -
    keyid keyid -
    This command specifies the key number to be used to authenticate configuration requests. This must correspond to a key number the server has been configured to use for this purpose. -
    ntpversion 1 | 2 | 3 | 4 -
    Sets the NTP version number which ntpq claims in packets. Defaults to 2, Note that mode-6 control messages (and modes, for that matter) didn't exist in NTP version 1.
    passwd -
    This command prompts for a password to authenticate configuration requests. The password must correspond to the key configured for NTP server for this purpose.
    quit -
    Exit ntpq. -
    raw -
    Display server messages as received and without reformatting.
    timeout millseconds -
    Specify a timeout period for responses to server queries. The default is about 5000 milliseconds. Note that since ntpq retries each query once after a timeout, the total waiting time for a timeout will be twice the timeout value set. + clearvars +
    The arguments to this command consist of a list of items of the form name = value, where the = value is ignored, and can be omitted in read requests. ntpq maintains an internal list in which data to be included in control messages can be assembled, and sent using the readlist and writelist commands described below. The addvars command allows variables and optional values to be added to the list. If more than one variable is to be added, the list should be comma-separated and not contain white space. The rmvars command can be used to remove individual variables from the list, while the clearlist command removes all variables from the list.
    +
    cooked
    +
    Display server messages in prettyprint format.
    +
    debug more | less | off
    +
    Turns internal query program debugging on and off.
    +
    delay milliseconds
    +
    Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete.
    +
    host name
    +
    Set the host to which future queries will be sent. The name may be either a DNS name or a numeric address.
    +
    hostnames [yes | no]
    +
    If yes is specified, host names are printed in information displays. If no is specified, numeric addresses are printed instead. The default is yes, unless modified using the command line -n switch.
    +
    keyid keyid
    +
    This command specifies the key number to be used to authenticate configuration requests. This must correspond to a key number the server has been configured to use for this purpose.
    +
    ntpversion 1 | 2 | 3 | 4
    +
    Sets the NTP version number which ntpq claims in packets. Defaults to 2, Note that mode-6 control messages (and modes, for that matter) didn't exist in NTP version 1.
    +
    passwd
    +
    This command prompts for a password to authenticate configuration requests. The password must correspond to the key configured for NTP server for this purpose.
    +
    quit
    +
    Exit ntpq.
    +
    raw
    +
    Display server messages as received and without reformatting.
    +
    timeout millseconds
    +
    Specify a timeout period for responses to server queries. The default is about 5000 milliseconds. Note that since ntpq retries each query once after a timeout, the total waiting time for a timeout will be twice the timeout value set.

    Control Message Commands

    Association IDs are used to identify system, peer and clock variables. System variables are assigned an association ID of zero and system name space, while each association is assigned a nonzero association ID and peer namespace. Most control commands send a single mode-6 message to 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.

    -
    associations -
    Display a list of mobilized associations in the form
    ind assid status conf reach auth condition last_event cnt +
    associations
    +
    Display a list of mobilized associations in the form
    +
    ind assid status conf reach auth condition last_event cnt
    @@ -122,25 +133,28 @@
    event count (see peer status word)
    -
    clockvar [assocID] [name [ = value [...]] [...]
    - cv [assocID] [name [ = value [...] ][...] -
    Display a list of clock variables for those assocations supporting a reference clock. -
    :config [...] -
    Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. -
    config-from-file filename -
    Send the each line of filename to the server as run-time configuration commands in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. -
    keyid -
    Specify the key ID to use for write requests.
    lassociations -
    Perform the same function as the associations command, execept display mobilized and unmobilized associations.
    mreadvar assocID assocID [ variable_name [ = value[ ... ]
    - mrv assocID assocID [ variable_name [ = value[ ... ] -
    Perform the same function as the readvar command, except for a range of association IDs. This range is determined from the association list cached by the most recent associations command. -
    passociations -
    Perform the same function as the associations command, except that it uses previously stored data rather than making a new query. -
    passwd -
    Specify the password to use for write requests. -
    peers -
    Display a list of associations in the form -
    ind assid status conf reach auth condition last_event cnt +
    +
    clockvar assocID [name [ = value [...]] [...]
    + cv assocID [name [ = value [...] ][...]
    +
    Display a list of clock variables for those assocations supporting a reference clock.
    +
    :config [...]
    +
    Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is of course required.
    +
    config-from-file filename
    +
    Send the each line of filename to the server as run-time configuration commands in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is of course required.
    +
    keyid
    +
    Specify the key ID to use for write requests.
    +
    lassociations
    +
    Perform the same function as the associations command, execept display mobilized and unmobilized associations.
    +
    mreadvar assocID assocID [ variable_name [ = value[ ... ]
    + mrv assocID assocID [ variable_name [ = value[ ... ]
    +
    Perform the same function as the readvar command, except for a range of association IDs. This range is determined from the association list cached by the most recent associations command.
    +
    passociations
    +
    Perform the same function as the associations command, except that it uses previously stored data rather than making a new query.
    +
    passwd
    +
    Specify the password to use for write requests.
    +
    peers
    +
    Display a list of associations in the form
    +
    ind assid status conf reach auth condition last_event cnt
    @@ -188,14 +202,27 @@
    jitter
    +
    readvar assocID name [ = value ] [,...]
    - rv assocID [ name ] [,...] -
    Display the specified variables. If the association ID is omitted or is given as zero, the variables are from the system variables name space, otherwise they are from the peer variables name space. If no name is included, all operative variables in the name space are displayed. Multiple names are specified with comma separators and without whitespace. Note that time values are represented in milliseconds and frequency values in parts-per-million (PPM). Some NTP timestamps are represented in the format YYYYMMDDTTTT, where YYYY is the year, MM the month of year, DD the day of month and TTTT the time of day. -
    saveconfig filename -
    Write the current configuration, including any runtime modifications given with :config or config-from-file, to the ntpd host's file filename. This command will be rejected by the server unless saveconfigdir appears in the ntpd configuration file. filename can use strftime() format specifiers to substitute the current date and time, for example, saveconfig ntp-%Y%m%d-%H%M%S.conf. The filename used is stored in system variable savedconfig. Authentication is required. -
    writevar assocID name = value [,...] -
    Write the specified variables. If the association ID is omitted or is given as zero, the variables are from the system variables name space, otherwise they are from the peer variables name space.
    -

    Status Words and Kiss Codes

    + rv assocID [ name ] [,...] +
    Display the specified variables. If assocID is zero, the variables + are from the system variables name space, otherwise + they are from the peer variables name space. The assocID is + required, as the same name can occur in both spaces. If no name is + included, all operative variables in the name space are displayed. + Multiple names are specified with comma separators and without whitespace. + Note that time values are represented in milliseconds and frequency + values in parts-per-million (PPM). Some NTP timestamps are represented in + the format YYYYMMDDTTTT, where YYYY is the year, MM the month of year, DD + the day of month and TTTT the time of day.
    +
    saveconfig filename
    +
    Write the current configuration, including any runtime modifications given with :config or config-from-file, to the ntpd host's file filename. This command will be rejected by the server unless saveconfigdir appears in the ntpd configuration file. filename can use strftime() format specifiers to substitute the current date and time, for example, saveconfig ntp-%Y%m%d-%H%M%S.conf. The filename used is stored in system variable savedconfig. Authentication is required.
    +
    writevar assocID name = value [,...]
    +
    Write the specified variables. If the assocID is zero, the variables + are from the system variables name space, otherwise they are from the peer variables name space. The assocID is required, as the same name can occur + in both spaces.
    + +

    Status Words and Kiss Codes

    The current state of the operating program is shown in a set of status words maintained by the system and each association separately. These words are displayed in the rv and as commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the Event Messages and Status Words page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word.

    Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called kiss codes. The original purpose was for kiss-o'-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, in the reference identifier field in various billboards.

    System Variables

    @@ -301,13 +328,12 @@
    The jitter and wander statistics are exponentially-weighted RMS averages. The system jitter is defined in the NTPv4 specification; the - clock jitter statistic is computed by the clock discipline module. -
     
    + clock jitter statistic is computed by the clock discipline module.
    When the NTPv4 daemon is compiled with the OpenSSL software library, additional system variables are displayed, including some or all of the following, depending on the particular Autokey dance:
    - +
    @@ -488,7 +514,7 @@
    Variable DescriptionAutokey signature timestamp
    -

    Clock Variables

    +

    Clock Variables

    The following clock variables apear in the cv billboard for each association with a reference clock. Not all variables are displayed in some configurations.