diff options
Diffstat (limited to 'ntpq/ntpq.1ntpqman')
-rw-r--r-- | ntpq/ntpq.1ntpqman | 1408 |
1 files changed, 1408 insertions, 0 deletions
diff --git a/ntpq/ntpq.1ntpqman b/ntpq/ntpq.1ntpqman new file mode 100644 index 0000000..bc203c3 --- /dev/null +++ b/ntpq/ntpq.1ntpqman @@ -0,0 +1,1408 @@ +.de1 NOP +. it 1 an-trap +. if \\n[.$] \,\\$*\/ +.. +.ie t \ +.ds B-Font [CB] +.ds I-Font [CI] +.ds R-Font [CR] +.el \ +.ds B-Font B +.ds I-Font I +.ds R-Font R +.TH ntpq 1ntpqman "02 Dec 2014" "4.2.7p482" "User Commands" +.\" +.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-fJaqSO/ag-rJaiRO) +.\" +.\" It has been AutoGen-ed December 2, 2014 at 08:58:04 AM by AutoGen 5.18.5pre4 +.\" From the definitions ntpq-opts.def +.\" and the template file agman-cmd.tpl +.SH NAME +\f\*[B-Font]ntpq\fP +\- standard NTP query program +.SH SYNOPSIS +\f\*[B-Font]ntpq\fP +.\" Mixture of short (flag) options and long options +[\f\*[B-Font]\-flags\f[]] +[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] +[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] +[ host ...] +.sp \n(Ppu +.ne 2 + +.SH DESCRIPTION +The +\f\*[B-Font]ntpq\fP +utility program is used to query NTP servers which +implement the standard NTP mode 6 control message formats defined +in Appendix B of the NTPv3 specification RFC1305, requesting +information about current state and/or changes in that state. +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 program may 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 +\f\*[B-Font]ntpq\fP +utility 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 +\f\*[B-Font]ntpq\fP +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, +\f\*[B-Font]ntpq\fP +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. +The +\f\*[B-Font]ntpq\fP +utility will prompt for +commands if the standard input is a terminal device. +\f\*[B-Font]ntpq\fP +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. +The +\f\*[B-Font]ntpq\fP +utility makes +one attempt to retransmit requests, and will time requests out if +the remote host is not heard from within a suitable timeout +time. +Specifying a +command line option other than +\f\*[B-Font]\-i\f[] +or +\f\*[B-Font]\-n\f[] +will +cause the specified query (queries) to be sent to the indicated +host(s) immediately. +Otherwise, +\f\*[B-Font]ntpq\fP +will attempt to read +interactive format commands from the standard input. +.SS "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. +A +number of interactive format commands are executed entirely within +the +\f\*[B-Font]ntpq\fP +utility itself and do not result in NTP mode 6 +requests being sent to a server. +These are described following. +.TP 20 +.NOP \f\*[B-Font]?\f[] [\f\*[I-Font]command_keyword\f[]] +.br +.ns +.TP 20 +.NOP \f\*[B-Font]help\f[] [\f\*[I-Font]command_keyword\f[]] +A +\[oq]\&?\[cq] +by itself will print a list of all the command +keywords known to this incarnation of +\f\*[B-Font]ntpq\fP. +A +\[oq]\&?\[cq] +followed by a command keyword will print function and usage +information about the command. +This command is probably a better +source of information about +\f\*[B-Font]ntpq\fP +than this manual +page. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]addvars\f[] \f\*[I-Font]variable_name\f[][\f\*[B-Font]=value\f[]] \f\*[B-Font]...\f[] +.br +.ns +.TP 20 +.NOP \f\*[B-Font]rmvars\f[] \f\*[I-Font]variable_name\f[] \f\*[B-Font]...\f[] +.br +.ns +.TP 20 +.NOP \f\*[B-Font]clearvars\f[] +.br +.ns +.TP 20 +.NOP \f\*[B-Font]showvars\f[] +The data carried by NTP mode 6 messages consists of a list of +items of the form +\[oq]variable_name=value\[cq], +where the +\[oq]=value\[cq] +is ignored, and can be omitted, +in requests to the server to read variables. +The +\f\*[B-Font]ntpq\fP +utility maintains an internal list in which data to be included in control +messages can be assembled, and sent using the +\f\*[B-Font]readlist\f[] +and +\f\*[B-Font]writelist\f[] +commands described below. +The +\f\*[B-Font]addvars\f[] +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. +The +\f\*[B-Font]rmvars\f[] +command can be used to remove individual variables from the list, +while the +\f\*[B-Font]clearlist\f[] +command removes all variables from the +list. +The +\f\*[B-Font]showvars\f[] +command displays the current list of optional variables. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]authenticate\f[] [yes | no] +Normally +\f\*[B-Font]ntpq\fP +does not authenticate requests unless +they are write requests. +The command +\[oq]authenticate yes\[cq] +causes +\f\*[B-Font]ntpq\fP +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 +\f\*[B-Font]peer\f[] +display. +The command +\[oq]authenticate\[cq] +causes +\f\*[B-Font]ntpq\fP +to display whether or not +\f\*[B-Font]ntpq\fP +is currently autheinticating requests. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]cooked\f[] +Causes output from query commands to be "cooked", so that +variables which are recognized by +\f\*[B-Font]ntpq\fP +will have their +values reformatted for human consumption. +Variables which +\f\*[B-Font]ntpq\fP +thinks should have a decodable value but didn't are +marked with a trailing +\[oq]\&?\[cq]. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]debug\f[] [\f\*[B-Font]more\f[] | \f\*[B-Font]less\f[] | \f\*[B-Font]off\f[]] +With no argument, displays the current debug level. +Otherwise, the debug level is changed to the indicated level. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]delay\f[] \f\*[I-Font]milliseconds\f[] +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. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]exit\f[] +Exit +\f\*[B-Font]ntpq\fP. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]host\f[] \f\*[I-Font]hostname\f[] +Set the host to which future queries will be sent. +\f\*[I-Font]hostname\f[] +may be either a host name or a numeric address. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]hostnames\f[] [\f\*[B-Font]yes\f[] | \f\*[B-Font]no\f[]] +If +\f\*[B-Font]yes\f[] +is specified, host names are printed in +information displays. +If +\f\*[B-Font]no\f[] +is specified, numeric +addresses are printed instead. +The default is +\f\*[B-Font]yes\f[], +unless +modified using the command line +\f\*[B-Font]\-n\f[] +switch. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]keyid\f[] \f\*[I-Font]keyid\f[] +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. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]keytype\f[] [\f\*[B-Font]md5\f[] | \f\*[B-Font]OpenSSLDigestType\f[]] +Specify the type of key to use for authenticating requests. +\f\*[B-Font]md5\f[] +is alway supported. +If +\f\*[B-Font]ntpq\fP +was built with OpenSSL support, +any digest type supported by OpenSSL can also be provided. +If no argument is given, the current +\f\*[B-Font]keytype\f[] +is displayed. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]ntpversion\f[] [\f\*[B-Font]1\f[] | \f\*[B-Font]2\f[] | \f\*[B-Font]3\f[] | \f\*[B-Font]4\f[]] +Sets the NTP version number which +\f\*[B-Font]ntpq\fP +claims in +packets. +Defaults to 3, and note that mode 6 control messages (and +modes, for that matter) didn't exist in NTP version 1. +There appear +to be no servers left which demand version 1. +With no argument, displays the current NTP version that will be used +when communicating with servers. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]passwd\f[] +This command prompts you to type in a password (which will not +be 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. +.\" Not yet implemented. +.\" .It Ic poll +.\" .Op Ar n +.\" .Op Ic verbose +.\" Poll an NTP server in client mode +.\" .Ar n +.\" times. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]quit\f[] +Exit +\f\*[B-Font]ntpq\fP. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]raw\f[] +Causes all output from query commands is printed as received +from the remote server. +The only formating/interpretation done on +the data is to transform nonascii data into a printable (but barely +understandable) form. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]timeout\f[] \f\*[I-Font]milliseconds\f[] +Specify a timeout period for responses to server queries. +The +default is about 5000 milliseconds. +Note that since +\f\*[B-Font]ntpq\fP +retries each query once after a timeout, the total waiting time for +a timeout will be twice the timeout value set. +.br +.ns +.TP 20 +.NOP \f\*[B-Font]version\f[] +Print the version of the +\f\*[B-Font]ntpq\fP +program. +.PP +.SS "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 +\f[C]peers\f[] +command, which sends a series of messages, +and the +\f[C]mreadlist\f[] +and +\f[C]mreadvar\f[] +commands, which iterate over a range of associations. +.TP 10 +.NOP \f\*[B-Font]associations\f[] +Display a list of mobilized associations in the form: +.Dl ind assid status conf reach auth condition last_event cnt +.RS +.IP \fB\(bu\fP 2 +.IP \fB\(bu\fP 2 \f[C]ind\f[] \f[C]Ta\f[] \f[C]index\f[] \f[C]on\f[] \f[C]this\f[] \f[C]list\f[] +.IP \fB\(bu\fP 2 \f[C]assid\f[] \f[C]Ta\f[] \f[C]association\f[] \f[C]ID\f[] +.IP \fB\(bu\fP 2 \f[C]status\f[] \f[C]Ta\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word\f[] +.IP \fB\(bu\fP 2 \f[C]conf\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]persistent,\f[] \f[C]no\f[]: \f[C]ephemeral\f[] +.IP \fB\(bu\fP 2 \f[C]reach\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]reachable,\f[] \f[C]no\f[]: \f[C]unreachable\f[] +.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]yes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] +.IP \fB\(bu\fP 2 \f[C]condition\f[] \f[C]Ta\f[] \f[C]selection\f[] \f[C]status\f[] \f[C](see\f[] \f[C]the\f[] \f[C]select\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] +.IP \fB\(bu\fP 2 \f[C]last_event\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]report\f[] \f[C](see\f[] \f[C]the\f[] \f[C]event\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] +.IP \fB\(bu\fP 2 \f[C]cnt\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]count\f[] \f[C](see\f[] \f[C]the\f[] \f[C]count\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] +.RE +.br +.ns +.TP 10 +.NOP \f\*[B-Font]authinfo\f[] +Display the authentication statistics. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]clockvar\f[] \f\*[I-Font]assocID\f[] [\f\*[I-Font]name\f[][\f\*[B-Font]=\f[]\f\*[I-Font]value\f[]] [] ...] +.br +.ns +.TP 10 +.NOP \f\*[B-Font]cv\f[] \f\*[I-Font]assocID\f[] [\f\*[I-Font]name\f[][\f\*[B-Font]=\f[]\f\*[I-Font]value\f[]] [] ...] +Display a list of clock variables for those associations supporting a reference clock. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]:config\f[] [...] +Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is of course required. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]config-from-file\f[] \f\*[I-Font]filename\f[] +Send the each line of +\f\*[I-Font]filename\f[] +to the server as run-time configuration commands in the same format as a line in the configuration file. This command is experimental until further notice and clarification. Authentication is required. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]ifstats\f[] +Display statistics for each local network address. Authentication is required. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]iostats\f[] +Display network and reference clock I/O statistics. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]kerninfo\f[] +Display kernel loop and PPS statistics. As with other ntpq output, times are in milliseconds. The precision value displayed is in milliseconds as well, unlike the precision system variable. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]lassociations\f[] +Perform the same function as the associations command, except display mobilized and unmobilized associations. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]lopeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] +Obtain and print a list of all peers and clients showing +\f\*[I-Font]dstadr\f[] +(associated with any given IP version). +.br +.ns +.TP 10 +.NOP \f\*[B-Font]lpeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] +Print a peer spreadsheet for the appropriate IP version(s). +\f\*[I-Font]dstadr\f[] +(associated with any given IP version). +.br +.ns +.TP 10 +.NOP \f\*[B-Font]monstats\f[] +Display monitor facility statistics. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]mrulist\f[] [\f\*[B-Font]limited\f[] | \f\*[B-Font]kod\f[] | \f\*[B-Font]mincount\f[]=\f\*[I-Font]count\f[] | \f\*[B-Font]laddr\f[]=\f\*[I-Font]localaddr\f[] | \f\*[B-Font]sort\f[]=\f\*[I-Font]sortorder\f[] | \f\*[B-Font]resany\f[]=\f\*[I-Font]hexmask\f[] | \f\*[B-Font]resall\f[]=\f\*[I-Font]hexmask\f[]] +Obtain and print traffic counts collected and maintained by the monitor facility. +With the exception of +\f\*[B-Font]sort\f[]=\f\*[I-Font]sortorder\f[], +the options filter the list returned by +\f\*[B-Font]ntpd.\f[] +The +\f\*[B-Font]limited\f[] +and +\f\*[B-Font]kod\f[] +options return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response. +The +\f\*[B-Font]mincount\f[]=\f\*[I-Font]count\f[] +option filters entries representing less than +\f\*[I-Font]count\f[] +packets. +The +\f\*[B-Font]laddr\f[]=\f\*[I-Font]localaddr\f[] +option filters entries for packets received on any local address other than +\f\*[I-Font]localaddr\f[]. +\f\*[B-Font]resany\f[]=\f\*[I-Font]hexmask\f[] +and +\f\*[B-Font]resall\f[]=\f\*[I-Font]hexmask\f[] +filter entries containing none or less than all, respectively, of the bits in +\f\*[I-Font]hexmask\f[], +which must begin with +\f\*[B-Font]0x\f[]. +The +\f\*[I-Font]sortorder\f[] +defaults to +\f\*[B-Font]lstint\f[] +and may be any of +\f\*[B-Font]addr\f[], +\f\*[B-Font]count\f[], +\f\*[B-Font]avgint\f[], +\f\*[B-Font]lstint\f[], +or any of those preceded by a minus sign (hyphen) to reverse the sort order. +The output columns are: +.RS +.TP 10 +.NOP Column +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]lstint\f[] +Interval in s between the receipt of the most recent packet from this address and the completion of the retrieval of the MRU list by +\f\*[B-Font]ntpq\fP. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]avgint\f[] +Average interval in s between packets from this address. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rstr\f[] +Restriction flags associated with this address. +Most are copied unchanged from the matching +\f\*[B-Font]restrict\f[] +command, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this address triggered a rate control response. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]r\f[] +Rate control indicator, either +a period, +\f\*[B-Font]L\f[] +or +\f\*[B-Font]K\f[] +for no rate control response, +rate limiting by discarding, or rate limiting with a KoD response, respectively. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]m\f[] +Packet mode. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]v\f[] +Packet version number. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]count\f[] +Packets received from this address. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rport\f[] +Source port of last packet from this address. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]remote\f[] \f\*[B-Font]address\f[] +DNS name, numeric address, or address followed by +claimed DNS name which could not be verified in parentheses. +.RE +.br +.ns +.TP 10 +.NOP \f\*[B-Font]mreadvar\f[] \f\*[B-Font]assocID\f[] \f\*[B-Font]assocID\f[] [\f\*[I-Font]variable_name\f[][=\f\*[I-Font]value\f[]]] ... +.br +.ns +.TP 10 +.NOP \f\*[B-Font]mrv\f[] \f\*[B-Font]assocID\f[] \f\*[B-Font]assocID\f[] [\f\*[I-Font]variable_name\f[][=\f\*[I-Font]value\f[]]] ... +Perform the same function as the +\f\*[B-Font]readvar\f[] +command, except for a range of association IDs. +This range is determined from the association list cached by the most recent +\f\*[B-Font]associations\f[] +command. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]opeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] +Obtain and print the old-style list of all peers and clients showing +\f\*[I-Font]dstadr\f[] +(associated with any given IP version), +rather than the +\f\*[I-Font]refid\f[]. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]passociations\f[] +Perform the same function as the +\f\*[B-Font]associations\f[] +command, +except that it uses previously stored data rather than making a new query. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]peers\f[] +Display a list of peers in the form: +.Dl [tally]remote refid st t when pool reach delay offset jitter +.RS +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font][tally]\f[] +single-character code indicating current value of the +\f\*[B-Font]select\f[] +field of the +.Lk decode.html#peer "peer status word" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]remote\f[] +host name (or IP number) of peer. +The value displayed will be truncated to 15 characters unless the +\f\*[B-Font]\-w\f[] +flag is given, in which case the full value will be displayed +on the first line, +and the remaining data is displayed on the next line. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]refid\f[] +association ID or +.Lk decode.html#kiss "'kiss code" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]st\f[] +stratum +.br +.ns +.TP 10 +.NOP \f\*[B-Font]t\f[] +\f\*[B-Font]u\f[]: +unicast or manycast client, +\f\*[B-Font]b\f[]: +broadcast or multicast client, +\f\*[B-Font]l\f[]: +local (reference clock), +\f\*[B-Font]s\f[]: +symmetric (peer), +\f\*[B-Font]A\f[]: +manycast server, +\f\*[B-Font]B\f[]: +broadcast server, +\f\*[B-Font]M\f[]: +multicast server +.br +.ns +.TP 10 +.NOP \f\*[B-Font]when\f[] +sec/min/hr since last received packet +.br +.ns +.TP 10 +.NOP \f\*[B-Font]poll\f[] +poll interval (log2 s) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]reach\f[] +reach shift register (octal) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]delay\f[] +roundtrip delay +.br +.ns +.TP 10 +.NOP \f\*[B-Font]offset\f[] +offset of server relative to this host +.br +.ns +.TP 10 +.NOP \f\*[B-Font]jitter\f[] +jitter +.RE +.br +.ns +.TP 10 +.NOP \f\*[B-Font]pstats\f[] \f\*[I-Font]assocID\f[] +Show the statistics for the peer with the given +\f\*[I-Font]assocID\f[]. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]readlist\f[] \f\*[I-Font]assocID\f[] +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rl\f[] \f\*[I-Font]assocID\f[] +Read the system or peer variables included in the variable list. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]readvar\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...] +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rv\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...] +Display the specified variables. +If +\f\*[I-Font]assocID\f[] +is zero, the variables are from the +\fISystem\f[] \fIVariables\f[] +name space, otherwise they are from the +\fIPeer\f[] \fIVariables\f[] +name space. +The +\f\*[I-Font]assocID\f[] +is required, as the same name can occur in both spaces. +If no +\f\*[I-Font]name\f[] +is included, all operative variables in the name space are displayed. +In this case only, if the +\f\*[I-Font]assocID\f[] +is omitted, it is assumed zero. +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. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]reslist\f[] +Show the access control (restrict) list for +\f\*[B-Font]ntpq\fP. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]saveconfig\f[] \f\*[I-Font]filename\f[] +Write the current configuration, +including any runtime modifications given with +\f\*[B-Font]:config\f[] +or +\f\*[B-Font]config-from-file\f[], +to the ntpd host's file +\f\*[I-Font]filename\f[]. +This command will be rejected by the server unless +.Lk miscopt.html#saveconfigdir "saveconfigdir" +appears in the +\f\*[B-Font]ntpd\f[] +configuration file. +\f\*[I-Font]filename\f[] +can use +\fCstrftime\fR()\f[] +format specifies to substitute the current date and time, for example, +\f\*[B-Font]q]saveconfig\f[] \f\*[B-Font]ntp-%Y%m%d-%H%M%S.confq]\f[]. +The filename used is stored in system variable +\f\*[B-Font]savedconfig\f[]. +Authentication is required. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]timerstats\f[] +Display interval timer counters. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]writelist\f[] \f\*[I-Font]assocID\f[] +Write the system or peer variables included in the variable list. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]writevar\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[]=\f\*[I-Font]value\f[] [, ...] +Write the specified variables. +If the +\f\*[I-Font]assocID\f[] +is zero, the variables are from the +\fISystem\f[] \fIVariables\f[] +name space, otherwise they are from the +\fIPeer\f[] \fIVariables\f[] +name space. +The +\f\*[I-Font]assocID\f[] +is required, as the same name can occur in both spaces. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]sysinfo\f[] +Display operational summary. +.br +.ns +.TP 10 +.NOP \f\*[B-Font]sysstats\f[] +Print statistics counters maintained in the protocol module. +.PP +.SS Status Words and Kiss Codes +The current state of the operating program is shown +in a set of status words +maintained by the system. +Status information is also available on a per-association basis. +These words are displayed in the +\f\*[B-Font]rv\f[] +and +\f\*[B-Font]as\f[] +commands both in hexadecimal and in decoded short tip strings. +The codes, tips and short explanations are documented on the +.Lk decode.html "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. +.sp \n(Ppu +.ne 2 + +Information resulting from protocol machine state transitions +is displayed using an informal set of ASCII strings called +.Lk decode.html#kiss "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. +.SS System Variables +The following system variables appear in the +\f\*[B-Font]rv\f[] +billboard. +Not all variables are displayed in some configurations. +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]status\f[] +.Lk decode.html#sys "system status word" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]version\f[] +NTP software version and build time +.br +.ns +.TP 10 +.NOP \f\*[B-Font]processor\f[] +hardware platform and version +.br +.ns +.TP 10 +.NOP \f\*[B-Font]system\f[] +operating system and version +.br +.ns +.TP 10 +.NOP \f\*[B-Font]leap\f[] +leap warning indicator (0-3) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]stratum\f[] +stratum (1-15) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]precision\f[] +precision (log2 s) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rootdelay\f[] +total roundtrip delay to the primary reference clock +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rootdisp\f[] +total dispersion to the primary reference clock +.br +.ns +.TP 10 +.NOP \f\*[B-Font]peer\f[] +system peer association ID +.br +.ns +.TP 10 +.NOP \f\*[B-Font]tc\f[] +time constant and poll exponent (log2 s) (3-17) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]mintc\f[] +minimum time constant (log2 s) (3-10) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]clock\f[] +date and time of day +.br +.ns +.TP 10 +.NOP \f\*[B-Font]refid\f[] +reference ID or +.Lk decode.html#kiss "kiss code" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]reftime\f[] +reference time +.br +.ns +.TP 10 +.NOP \f\*[B-Font]offset\f[] +combined offset of server relative to this host +.br +.ns +.TP 10 +.NOP \f\*[B-Font]sys_jitter\f[] +combined system jitter +.br +.ns +.TP 10 +.NOP \f\*[B-Font]frequency\f[] +frequency offset (PPM) relative to hardware clock +.br +.ns +.TP 10 +.NOP \f\*[B-Font]clk_wander\f[] +clock frequency wander (PPM) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]clk_jitter\f[] +clock jitter +.br +.ns +.TP 10 +.NOP \f\*[B-Font]tai\f[] +TAI-UTC offset (s) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]leapsec\f[] +NTP seconds when the next leap second is/was inserted +.br +.ns +.TP 10 +.NOP \f\*[B-Font]expire\f[] +NTP seconds when the NIST leapseconds file expires +.PP +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. +.sp \n(Ppu +.ne 2 + +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: +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]host\f[] +Autokey host name for this host +.br +.ns +.TP 10 +.NOP \f\*[B-Font]ident\f[] +Autokey group name for this host +.br +.ns +.TP 10 +.NOP \f\*[B-Font]flags\f[] +host flags (see Autokey specification) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]digest\f[] +OpenSSL message digest algorithm +.br +.ns +.TP 10 +.NOP \f\*[B-Font]signature\f[] +OpenSSL digest/signature scheme +.br +.ns +.TP 10 +.NOP \f\*[B-Font]update\f[] +NTP seconds at last signature update +.br +.ns +.TP 10 +.NOP \f\*[B-Font]cert\f[] +certificate subject, issuer and certificate flags +.br +.ns +.TP 10 +.NOP \f\*[B-Font]until\f[] +NTP seconds when the certificate expires +.PP +.SS Peer Variables +The following peer variables appear in the +\f\*[B-Font]rv\f[] +billboard for each association. +Not all variables are displayed in some configurations. +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]associd\f[] +association ID +.br +.ns +.TP 10 +.NOP \f\*[B-Font]status\f[] +.Lk decode.html#peer "peer status word" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]srcadr\f[] +source (remote) IP address +.br +.ns +.TP 10 +.NOP \f\*[B-Font]srcport\f[] +source (remote) port +.br +.ns +.TP 10 +.NOP \f\*[B-Font]dstadr\f[] +destination (local) IP address +.br +.ns +.TP 10 +.NOP \f\*[B-Font]dstport\f[] +destination (local) port +.br +.ns +.TP 10 +.NOP \f\*[B-Font]leap\f[] +leap indicator (0-3) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]stratum\f[] +stratum (0-15) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]precision\f[] +precision (log2 s) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rootdelay\f[] +total roundtrip delay to the primary reference clock +.br +.ns +.TP 10 +.NOP \f\*[B-Font]rootdisp\f[] +total root dispersion to the primary reference clock +.br +.ns +.TP 10 +.NOP \f\*[B-Font]refid\f[] +reference ID or +.Lk decode.html#kiss "kiss code" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]reftime\f[] +reference time +.br +.ns +.TP 10 +.NOP \f\*[B-Font]reach\f[] +reach register (octal) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]unreach\f[] +unreach counter +.br +.ns +.TP 10 +.NOP \f\*[B-Font]hmode\f[] +host mode (1-6) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]pmode\f[] +peer mode (1-5) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]hpoll\f[] +host poll exponent (log2 s) (3-17) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]ppoll\f[] +peer poll exponent (log2 s) (3-17) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]headway\f[] +headway (see +.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]flash\f[] +.Lk decode.html#flash "flash status word" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]offset\f[] +filter offset +.br +.ns +.TP 10 +.NOP \f\*[B-Font]delay\f[] +filter delay +.br +.ns +.TP 10 +.NOP \f\*[B-Font]dispersion\f[] +filter dispersion +.br +.ns +.TP 10 +.NOP \f\*[B-Font]jitter\f[] +filter jitter +.br +.ns +.TP 10 +.NOP \f\*[B-Font]ident\f[] +Autokey group name for this association +.br +.ns +.TP 10 +.NOP \f\*[B-Font]bias\f[] +unicast/broadcast bias +.br +.ns +.TP 10 +.NOP \f\*[B-Font]xleave\f[] +interleave delay (see +.Lk xleave.html "NTP Interleaved Modes" ) +.PP +The +\f\*[B-Font]bias\f[] +variable is calculated when the first broadcast packet is received +after the calibration volley. +It represents the offset of the broadcast subgraph relative to the unicast subgraph. +The +\f\*[B-Font]xleave\f[] +variable appears only for the interleaved symmetric and interleaved modes. +It represents the internal queuing, buffering and transmission delays +for the preceding packet. +.sp \n(Ppu +.ne 2 + +When the NTPv4 daemon is compiled with the OpenSSL software library, +additional peer variables are displayed, including the following: +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]flags\f[] +peer flags (see Autokey specification) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]host\f[] +Autokey server name +.br +.ns +.TP 10 +.NOP \f\*[B-Font]flags\f[] +peer flags (see Autokey specification) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]signature\f[] +OpenSSL digest/signature scheme +.br +.ns +.TP 10 +.NOP \f\*[B-Font]initsequence\f[] +initial key ID +.br +.ns +.TP 10 +.NOP \f\*[B-Font]initkey\f[] +initial key index +.br +.ns +.TP 10 +.NOP \f\*[B-Font]timestamp\f[] +Autokey signature timestamp +.PP +.SS Clock Variables +The following clock variables appear in the +\f\*[B-Font]cv\f[] +billboard for each association with a reference clock. +Not all variables are displayed in some configurations. +.TP 10 +.NOP Variable +Description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]associd\f[] +association ID +.br +.ns +.TP 10 +.NOP \f\*[B-Font]status\f[] +.Lk decode.html#clock "clock status word" +.br +.ns +.TP 10 +.NOP \f\*[B-Font]device\f[] +device description +.br +.ns +.TP 10 +.NOP \f\*[B-Font]timecode\f[] +ASCII time code string (specific to device) +.br +.ns +.TP 10 +.NOP \f\*[B-Font]poll\f[] +poll messages sent +.br +.ns +.TP 10 +.NOP \f\*[B-Font]noreply\f[] +no reply +.br +.ns +.TP 10 +.NOP \f\*[B-Font]badformat\f[] +bad format +.br +.ns +.TP 10 +.NOP \f\*[B-Font]baddata\f[] +bad date or time +.br +.ns +.TP 10 +.NOP \f\*[B-Font]fudgetime1\f[] +fudge time 1 +.br +.ns +.TP 10 +.NOP \f\*[B-Font]fudgetime2\f[] +fudge time 2 +.br +.ns +.TP 10 +.NOP \f\*[B-Font]stratum\f[] +driver stratum +.br +.ns +.TP 10 +.NOP \f\*[B-Font]refid\f[] +driver reference ID +.br +.ns +.TP 10 +.NOP \f\*[B-Font]flags\f[] +driver flags +.PP +.SH "OPTIONS" +.TP +.NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[] +Force IPv4 DNS name resolution. +This option must not appear in combination with any of the following options: +ipv6. +.sp +Force DNS resolution of following host names on the command line +to the IPv4 namespace. +.TP +.NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[] +Force IPv6 DNS name resolution. +This option must not appear in combination with any of the following options: +ipv4. +.sp +Force DNS resolution of following host names on the command line +to the IPv6 namespace. +.TP +.NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]cmd\f[], \f\*[B-Font]\-\-command\f[]=\f\*[I-Font]cmd\f[] +run a command and exit. +This option may appear an unlimited number of times. +.sp +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). +.TP +.NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[] +Increase debug verbosity level. +This option may appear an unlimited number of times. +.sp +.TP +.NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[] +Set the debug verbosity level. +This option may appear an unlimited number of times. +This option takes an integer number as its argument. +.sp +.TP +.NOP \f\*[B-Font]\-i\f[], \f\*[B-Font]\-\-interactive\f[] +Force ntpq to operate in interactive mode. +This option must not appear in combination with any of the following options: +command, peers. +.sp +Force \fBntpq\fP to operate in interactive mode. +Prompts will be written to the standard output and +commands read from the standard input. +.TP +.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[] +numeric host addresses. +.sp +Output all host addresses in dotted-quad numeric format rather than +converting to the canonical host names. +.TP +.NOP \f\*[B-Font]\-\-old\-rv\f[] +Always output status line with readvar. +.sp +By default, \fBntpq\fP now suppresses the \fBassocid=...\fP +line that precedes the output of \fBreadvar\fP +(alias \fBrv\fP) when a single variable is requested, such as +\fBntpq \-c "rv 0 offset"\fP. +This option causes \fBntpq\fP to include both lines of output +for a single-variable \fBreadvar\fP. +Using an environment variable to +preset this option in a script will enable both older and +newer \fBntpq\fP to behave identically in this regard. +.TP +.NOP \f\*[B-Font]\-p\f[], \f\*[B-Font]\-\-peers\f[] +Print a list of the peers. +This option must not appear in combination with any of the following options: +interactive. +.sp +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. +.TP +.NOP \f\*[B-Font]\-w\f[], \f\*[B-Font]\-\-wide\f[] +Display the full 'remote' value. +.sp +Display the full value of the 'remote' value. If this requires +more than 15 characters, display the full value, emit a newline, +and continue the data display properly indented on the next line. +.TP +.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] +Display usage information and exit. +.TP +.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] +Pass the extended usage information through a pager. +.TP +.NOP \f\*[B-Font]\->\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]] +Save the option state to \fIcfgfile\fP. The default is the \fIlast\fP +configuration file listed in the \fBOPTION PRESETS\fP section, below. +The command will exit after updating the config file. +.TP +.NOP \f\*[B-Font]\-<\f[] \f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-load-opts\f[]=\f\*[I-Font]cfgfile\f[], \f\*[B-Font]\-\-no-load-opts\f[] +Load options from \fIcfgfile\fP. +The \fIno-load-opts\fP form will disable the loading +of earlier config/rc/ini files. \fI\-\-no-load-opts\fP is handled early, +out of order. +.TP +.NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}] +Output version of program and exit. The default mode is `v', a simple +version. The `c' mode will print copyright information and `n' will +print the full copyright notice. +.PP +.SH "OPTION PRESETS" +Any option that is not marked as \fInot presettable\fP may be preset +by loading values from configuration ("RC" or ".INI") file(s) and values from +environment variables named: +.nf + \fBNTPQ_<option-name>\fP or \fBNTPQ\fP +.fi +.ad +The environmental presets take precedence (are processed later than) +the configuration files. +The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP". +If any of these are directories, then the file \fI.ntprc\fP +is searched for within those directories. +.SH "ENVIRONMENT" +See \fBOPTION PRESETS\fP for configuration environment variables. +.SH "FILES" +See \fBOPTION PRESETS\fP for configuration files. +.SH "EXIT STATUS" +One of the following exit values will be returned: +.TP +.NOP 0 " (EXIT_SUCCESS)" +Successful program execution. +.TP +.NOP 1 " (EXIT_FAILURE)" +The operation failed or the command syntax was not valid. +.TP +.NOP 66 " (EX_NOINPUT)" +A specified configuration file could not be loaded. +.TP +.NOP 70 " (EX_SOFTWARE)" +libopts had an internal operational error. Please report +it to autogen-users@lists.sourceforge.net. Thank you. +.PP +.SH "AUTHORS" +The University of Delaware +.SH "COPYRIGHT" +Copyright (C) 1970-2014 The University of Delaware all rights reserved. +This program is released under the terms of the NTP license, <http://ntp.org/license>. +.SH "BUGS" +Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org +.SH "NOTES" +This manual page was \fIAutoGen\fP-erated from the \fBntpq\fP +option definitions. |