Technical data

Configuring and Managing NTP
12.8 NTP Utilities
• passwd
Prompts you to enter a password (not echoed) that is used to authenticate
configuration requests. The password must correspond to the key value
configured for use by the NTP server for this purpose if such requests are to
be successful (see Section 12.7.2).
• quit
Exits NTPQ.
•
raw
Displays all output from query commands as received from the remote server.
The only data formatting performed is to translate non-ASCII data into a
printable form.
• timeout milliseconds
Specifies a timeout period for responses to server queries. The default is
about 5000 milliseconds. Since NTPQ retries each query once after a timeout,
the total waiting time for a timeout will be twice the timeout value.
12.8.4.1 NTPQ Control Message Commands
Each peer known to an NTP server has a 16-bit integer association identifier
assigned to it. NTP control messages that carry peer variables must identify
the peer that the values correspond to by including the peer’s association ID. An
association ID of zero indicates the variables are system variables whose names
are drawn from a separate name space.
Control message commands result in one or more NTP mode 6 messages being
sent to the server, and cause the data returned to be displayed in a format that
you control using the commands listed in Section 12.8.4. Most commands send
a single message and expect a single response. The exceptions are the
peers
command, which sends a preprogrammed series of messages to obtain the data it
needs, and the mreadlist and mreadvar commands, which are repeated for each
specified association.
• associations
Displays a list of association identifiers and peer status for recognized peers
of the server being queried. The list is printed in columns. The first of these
is an index numbering the associations from 1 for internal use; the second is
the actual association identifier returned by the server; and the third is the
status word for the peer. This is followed by a number of columns containing
data decoded from the status word. The data returned by the associations
command is cached internally in NTPQ. The index is then used when dealing
with servers that use association identifiers. For any subsequent commands
that require an association identifier as an argument, the form
index\\ may
be used as an alternative.
• lassociations
Obtains and displays a list of association identifiers and peer status for all
associations for which the server is maintaining state. This command differs
from the associations command only for servers which retain state for out-
of-spec client associations. Such associations are normally omitted from the
display when the associations command is used but are included in the
output of the lassociations command..
12–24 Configuring and Managing NTP