ntpq.1m (2010 09)

n
ntpq(1M) ntpq(1M)
included in control messages can be assembled, and sent using the
readlist and writel-
ist commands described below.
addvars This command allows variables and their 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.
rmvars This command can be used to remove individual variables from the list.
clearlist
This command removes all variables from the list.
authenticate [ yes|no ]
Normally ntpq does not authenticate requests unless they are write requests. The command
authenticate yes causes ntpq to send authentication with all requests it makes.
Authenticated requests causes some servers to handle requests slightly differently, and can
occasionally melt the CPU in fuzzballs if you turn authentication on before doing a peer
display.
cooked Causes output from query commands to be
cooked. Variables which are recognized by the
server have their values reformatted for human usage.
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 authenti-
cation. 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 hostname
Set the host to which future queries will be sent. Hostname may be either a host 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
option.
keyid keyid-id
This command allows the specification of a 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 ]
Sets the NTP version number which ntpq claims in packets. Defaults to 3. Note that mode 6
control messages (and modes) did not exist in NTP version 1. There appears to be no servers
left which demand version 1.
quit Exit ntpq.
passwd This command prompts you to type in a password (which is not echoed) which will be used to
authenticate configuration requests. The password must correspond to the key configured for
use by the NTP server for this purpose if such requests are to be successful.
raw Causes all output from query commands to be printed as received from the remote server. The
only formatting/interpretation done on the data is to transform nonascii data into a printable
form.
timeout milliseconds
Specify a timeout period for responses to server queries. The default is about 5000 mil-
liseconds. Note that since ntpq retries each query once after a timeout, the total waiting time
for a timeout is twice the timeout value set.
Control Message Commands
Each peer known to an
NTP server has 16 bit integer association identifier assigned to it. NTP control
messages which carry peer variables must identify the peer, the values it corresponds to by including its
association ID. An association ID of 0 is special, and indicates the variables are system variables, whose
names are drawn from a separate name space.
2 Hewlett-Packard Company − 2 − HP-UX 11i Version 3: September 2010