xref: /freebsd/contrib/ntp/ntpq/ntpq-opts.def (revision bd18fd57db1df29da1a3adf94d47924a977a29c2)
1/* -*- Mode: Text -*- */
2
3autogen definitions options;
4
5#include copyright.def
6#include homerc.def
7#include autogen-version.def
8
9prog-name      = "ntpq";
10prog-title     = "standard NTP query program";
11argument       = '[ host ...]';
12
13flag = {
14    name      = ipv4;
15    flags-cant = ipv6;
16    value     = 4;
17    descrip   = "Force IPv4 DNS name resolution";
18    doc = <<-  _EndOfDoc_
19	Force DNS resolution of following host names on the command line
20	to the IPv4 namespace.
21	_EndOfDoc_;
22};
23
24flag = {
25    name      = ipv6;
26    flags-cant = ipv4;
27    value     = 6;
28    descrip   = "Force IPv6 DNS name resolution";
29    doc = <<-  _EndOfDoc_
30	Force DNS resolution of following host names on the command line
31	to the IPv6 namespace.
32	_EndOfDoc_;
33};
34
35flag = {
36    name      = command;
37    value     = c;
38    arg-type  = string;
39    descrip   = "run a command and exit";
40    max       = NOLIMIT;
41    arg-name  = cmd;
42    call-proc = ntpq_custom_opt_handler;
43    doc = <<-  _EndOfDoc_
44	The following argument is interpreted as an interactive format command
45	and is added to the list of commands to be executed on the specified
46	host(s).
47	_EndOfDoc_;
48};
49
50#include debug-opt.def
51
52flag = {
53    name      = interactive;
54    value     = i;
55    flags-cant = command, peers;
56    descrip   = "Force ntpq to operate in interactive mode";
57    doc = <<-  _EndOfDoc_
58	Force @code{ntpq} to operate in interactive mode.
59	Prompts will be written to the standard output and
60	commands read from the standard input.
61	_EndOfDoc_;
62};
63
64flag = {
65    name      = numeric;
66    value     = n;
67    descrip   = "numeric host addresses";
68    doc = <<-  _EndOfDoc_
69	Output all host addresses in dotted-quad numeric format rather than
70	converting to the canonical host names.
71	_EndOfDoc_;
72};
73
74flag = {
75    name      = old-rv;
76    descrip   = "Always output status line with readvar";
77    doc = <<-  _EndOfDoc_
78	By default, @code{ntpq} now suppresses the @code{associd=...}
79	line that precedes the output of @code{readvar}
80	(alias @code{rv}) when a single variable is requested, such as
81	@code{ntpq -c "rv 0 offset"}.
82	This option causes @code{ntpq} to include both lines of output
83	for a single-variable @code{readvar}.
84	Using an environment variable to
85	preset this option in a script will enable both older and
86	newer @code{ntpq} to behave identically in this regard.
87	_EndOfDoc_;
88};
89
90flag = {
91    name      = peers;
92    value     = p;
93    descrip   = "Print a list of the peers";
94    flags-cant = interactive;
95    call-proc = ntpq_custom_opt_handler;
96    doc = <<-  _EndOfDoc_
97	Print a list of the peers known to the server as well as a summary
98	of their state. This is equivalent to the 'peers' interactive command.
99	_EndOfDoc_;
100};
101
102flag = {
103    name      = wide;
104    value     = w;
105    descrip   = "Display the full 'remote' value";
106    doc = <<-  _EndOfDoc_
107	Display the full value of the 'remote' value.  If this requires
108	more than 15 characters, display the full value, emit a newline,
109	and continue the data display properly indented on the next line.
110	_EndOfDoc_;
111};
112
113doc-section	= {
114  ds-type	= 'DESCRIPTION';
115  ds-format	= 'mdoc';
116  ds-text	= <<-  _END_PROG_MDOC_DESCRIP
117
118The
119.Nm
120utility program is used to query NTP servers which
121implement the standard NTP mode 6 control message formats defined
122in Appendix B of the NTPv3 specification RFC1305, requesting
123information about current state and/or changes in that state.
124The same formats are used in NTPv4, although some of the
125variables have changed and new ones added. The description on this
126page is for the NTPv4 variables.
127The program may be run either in interactive mode or controlled using
128command line arguments.
129Requests to read and write arbitrary
130variables can be assembled, with raw and pretty-printed output
131options being available.
132The
133.Nm
134utility can also obtain and print a
135list of peers in a common format by sending multiple queries to the
136server.
137
138If one or more request options is included on the command line
139when
140.Nm
141is executed, each of the requests will be sent
142to the NTP servers running on each of the hosts given as command
143line arguments, or on localhost by default.
144If no request options
145are given,
146.Nm
147will attempt to read commands from the
148standard input and execute these on the NTP server running on the
149first host given on the command line, again defaulting to localhost
150when no other host is specified.
151The
152.Nm
153utility will prompt for
154commands if the standard input is a terminal device.
155
156.Nm
157uses NTP mode 6 packets to communicate with the
158NTP server, and hence can be used to query any compatible server on
159the network which permits it.
160Note that since NTP is a UDP protocol
161this communication will be somewhat unreliable, especially over
162large distances in terms of network topology.
163The
164.Nm
165utility makes
166one attempt to retransmit requests, and will time requests out if
167the remote host is not heard from within a suitable timeout
168time.
169
170Specifying a
171command line option other than
172.Fl i
173or
174.Fl n
175will
176cause the specified query (queries) to be sent to the indicated
177host(s) immediately.
178Otherwise,
179.Nm
180will attempt to read
181interactive format commands from the standard input.
182.Ss "Internal Commands"
183Interactive format commands consist of a keyword followed by zero
184to four arguments.
185Only enough characters of the full keyword to
186uniquely identify the command need be typed.
187
188A
189number of interactive format commands are executed entirely within
190the
191.Nm
192utility itself and do not result in NTP mode 6
193requests being sent to a server.
194These are described following.
195.Bl -tag -width "? [command_keyword]" -compact -offset indent
196.It Ic ? Op  Ar command_keyword
197.It Ic help Op Ar command_keyword
198A
199.Ql \&?
200by itself will print a list of all the command
201keywords known to this incarnation of
202.Nm .
203A
204.Ql \&?
205followed by a command keyword will print function and usage
206information about the command.
207This command is probably a better
208source of information about
209.Nm
210than this manual
211page.
212.It Ic addvars Ar variable_name Ns Xo Op Ic =value
213.Ic ...
214.Xc
215.It Ic rmvars Ar variable_name Ic ...
216.It Ic clearvars
217.It Ic showvars
218The data carried by NTP mode 6 messages consists of a list of
219items of the form
220.Ql variable_name=value ,
221where the
222.Ql =value
223is ignored, and can be omitted,
224in requests to the server to read variables.
225The
226.Nm
227utility maintains an internal list in which data to be included in control
228messages can be assembled, and sent using the
229.Ic readlist
230and
231.Ic writelist
232commands described below.
233The
234.Ic addvars
235command allows variables and their optional values to be added to
236the list.
237If more than one variable is to be added, the list should
238be comma-separated and not contain white space.
239The
240.Ic rmvars
241command can be used to remove individual variables from the list,
242while the
243.Ic clearlist
244command removes all variables from the
245list.
246The
247.Ic showvars
248command displays the current list of optional variables.
249.It Ic authenticate Op yes | no
250Normally
251.Nm
252does not authenticate requests unless
253they are write requests.
254The command
255.Ql authenticate yes
256causes
257.Nm
258to send authentication with all requests it
259makes.
260Authenticated requests causes some servers to handle
261requests slightly differently, and can occasionally melt the CPU in
262fuzzballs if you turn authentication on before doing a
263.Ic peer
264display.
265The command
266.Ql authenticate
267causes
268.Nm
269to display whether or not
270.Nm
271is currently autheinticating requests.
272.It Ic cooked
273Causes output from query commands to be "cooked", so that
274variables which are recognized by
275.Nm
276will have their
277values reformatted for human consumption.
278Variables which
279.Nm
280thinks should have a decodable value but didn't are
281marked with a trailing
282.Ql \&? .
283.It Xo
284.Ic debug
285.Oo
286.Cm more |
287.Cm less |
288.Cm off
289.Oc
290.Xc
291With no argument, displays the current debug level.
292Otherwise, the debug level is changed to the indicated level.
293.It Ic delay Ar milliseconds
294Specify a time interval to be added to timestamps included in
295requests which require authentication.
296This is used to enable
297(unreliable) server reconfiguration over long delay network paths
298or between machines whose clocks are unsynchronized.
299Actually the
300server does not now require timestamps in authenticated requests,
301so this command may be obsolete.
302.It Ic exit
303Exit
304.Nm .
305.It Ic host Ar hostname
306Set the host to which future queries will be sent.
307.Ar hostname
308may be either a host name or a numeric address.
309.It Ic hostnames Op Cm yes | Cm no
310If
311.Cm yes
312is specified, host names are printed in
313information displays.
314If
315.Cm no
316is specified, numeric
317addresses are printed instead.
318The default is
319.Cm yes ,
320unless
321modified using the command line
322.Fl n
323switch.
324.It Ic keyid Ar keyid
325This command allows the specification of a key number to be
326used to authenticate configuration requests.
327This must correspond
328to the
329.Cm controlkey
330key number the server has been configured to use for this
331purpose.
332.It Ic keytype Xo Oo
333.Cm md5 |
334.Cm OpenSSLDigestType
335.Oc
336.Xc
337Specify the type of key to use for authenticating requests.
338.Cm md5
339is alway supported.
340If
341.Nm
342was built with OpenSSL support,
343any digest type supported by OpenSSL can also be provided.
344If no argument is given, the current
345.Ic keytype
346is displayed.
347.It Ic ntpversion Xo Oo
348.Cm 1 |
349.Cm 2 |
350.Cm 3 |
351.Cm 4
352.Oc
353.Xc
354Sets the NTP version number which
355.Nm
356claims in
357packets.
358Defaults to 3, and note that mode 6 control messages (and
359modes, for that matter) didn't exist in NTP version 1.
360There appear
361to be no servers left which demand version 1.
362With no argument, displays the current NTP version that will be used
363when communicating with servers.
364.It Ic passwd
365This command prompts you to type in a password (which will not
366be echoed) which will be used to authenticate configuration
367requests.
368The password must correspond to the key configured for
369use by the NTP server for this purpose if such requests are to be
370successful.
371.\" Not yet implemented.
372.\" .It Ic poll
373.\" .Op Ar n
374.\" .Op Ic verbose
375.\" Poll an NTP server in client mode
376.\" .Ar n
377.\" times.
378.It Ic quit
379Exit
380.Nm .
381.It Ic raw
382Causes all output from query commands is printed as received
383from the remote server.
384The only formating/interpretation done on
385the data is to transform nonascii data into a printable (but barely
386understandable) form.
387.It Ic timeout Ar milliseconds
388Specify a timeout period for responses to server queries.
389The
390default is about 5000 milliseconds.
391Note that since
392.Nm
393retries each query once after a timeout, the total waiting time for
394a timeout will be twice the timeout value set.
395.It Ic version
396Print the version of the
397.Nm
398program.
399.El
400
401.Ss "Control Message Commands"
402Association IDs are used to identify system, peer and clock variables.
403System variables are assigned an association ID of zero and system name space, while each association is assigned a nonzero association ID and peer namespace.
404Most control commands send a single mode-6 message to the server and expect a single response message.
405The exceptions are the
406.Li peers
407command, which sends a series of messages,
408and the
409.Li mreadlist
410and
411.Li mreadvar
412commands, which iterate over a range of associations.
413.Bl -tag -width "something" -compact -offset indent
414.It Cm associations
415Display a list of mobilized associations in the form:
416.Dl ind assid status conf reach auth condition last_event cnt
417.Bl -column -offset indent ".Sy Variable" ".Sy Description"
418.It Sy String Ta Sy Description
419.It Li ind Ta index on this list
420.It Li assid Ta association ID
421.It Li status Ta peer status word
422.It Li conf Ta Li yes : persistent, Li no : ephemeral
423.It Li reach Ta Li yes : reachable, Li no : unreachable
424.It Li auth Ta Li ok , Li yes , Li bad and Li none
425.It Li condition Ta selection status (see the Li select field of the peer status word)
426.It Li last_event Ta event report (see the Li event field of the peer status word)
427.It Li cnt Ta event count (see the Li count field of the peer status word)
428.El
429.It Cm authinfo
430Display the authentication statistics.
431.It Cm clockvar Ar assocID Oo Ar name Ns Oo Cm = Ns Ar value Oc Oc Op ...
432.It Cm cv Ar assocID Oo Ar name Ns Oo Cm = Ns Ar value Oc Oc Op ...
433Display a list of clock variables for those associations supporting a reference clock.
434.It Cm :config Op ...
435Send 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.
436.It Cm config-from-file Ar filename
437Send the each line of
438.Ar filename
439to 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.
440.It Ic ifstats
441Display statistics for each local network address. Authentication is required.
442.It Ic iostats
443Display network and reference clock I/O statistics.
444.It Ic kerninfo
445Display 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.
446.It Ic lassociations
447Perform the same function as the associations command, except display mobilized and unmobilized associations.
448.It Ic lopeers Xo
449.Oo Ic -4 |
450.Ic -6
451.Oc
452.Xc
453Obtain and print a list of all peers and clients showing
454.Ar dstadr
455(associated with any given IP version).
456.It Ic lpeers Xo
457.Oo Ic -4 |
458.Ic -6
459.Oc
460.Xc
461Print a peer spreadsheet for the appropriate IP version(s).
462.Ar dstadr
463(associated with any given IP version).
464.It Ic monstats
465Display monitor facility statistics.
466.It Ic mrulist Oo Ic limited | Ic kod | Ic mincount Ns = Ns Ar count | Ic laddr Ns = Ns Ar localaddr | Ic sort Ns = Ns Ar sortorder | Ic resany Ns = Ns Ar hexmask | Ic resall Ns = Ns Ar hexmask Oc
467Obtain and print traffic counts collected and maintained by the monitor facility.
468With the exception of
469.Cm sort Ns = Ns Ar sortorder ,
470the options filter the list returned by
471.Cm ntpd.
472The
473.Cm limited
474and
475.Cm kod
476options return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response.
477The
478.Cm mincount Ns = Ns Ar count
479option filters entries representing less than
480.Ar count
481packets.
482The
483.Cm laddr Ns = Ns Ar localaddr
484option filters entries for packets received on any local address other than
485.Ar localaddr .
486.Cm resany Ns = Ns Ar hexmask
487and
488.Cm resall Ns = Ns Ar hexmask
489filter entries containing none or less than all, respectively, of the bits in
490.Ar hexmask ,
491which must begin with
492.Cm 0x .
493The
494.Ar sortorder
495defaults to
496.Cm lstint
497and may be any of
498.Cm addr ,
499.Cm count ,
500.Cm avgint ,
501.Cm lstint ,
502or any of those preceded by a minus sign (hyphen) to reverse the sort order.
503The output columns are:
504.Bl -tag -width "something" -compact -offset indent
505.It Column
506Description
507.It Ic lstint
508Interval in s between the receipt of the most recent packet from this address and the completion of the retrieval of the MRU list by
509.Nm .
510.It Ic avgint
511Average interval in s between packets from this address.
512.It Ic rstr
513Restriction flags associated with this address.
514Most are copied unchanged from the matching
515.Ic restrict
516command, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this address triggered a rate control response.
517.It Ic r
518Rate control indicator, either
519a period,
520.Ic L
521or
522.Ic K
523for no rate control response,
524rate limiting by discarding, or rate limiting with a KoD response, respectively.
525.It Ic m
526Packet mode.
527.It Ic v
528Packet version number.
529.It Ic count
530Packets received from this address.
531.It Ic rport
532Source port of last packet from this address.
533.It Ic remote address
534DNS name, numeric address, or address followed by
535claimed DNS name which could not be verified in parentheses.
536.El
537.It Ic mreadvar assocID assocID Oo Ar variable_name Ns Oo = Ns Ar value Oc Oc ...
538.It Ic mrv assocID assocID Oo Ar variable_name Ns Oo = Ns Ar value Oc Oc ...
539Perform the same function as the
540.Ic readvar
541command, except for a range of association IDs.
542This range is determined from the association list cached by the most recent
543.Ic associations
544command.
545.It Ic opeers Xo
546.Oo Ic -4 |
547.Ic -6
548.Oc
549.Xc
550Obtain and print the old-style list of all peers and clients showing
551.Ar dstadr
552(associated with any given IP version),
553rather than the
554.Ar refid .
555.It Ic passociations
556Perform the same function as the
557.Ic associations
558command,
559except that it uses previously stored data rather than making a new query.
560.It Ic peers
561Display a list of peers in the form:
562.Dl [tally]remote refid st t when pool reach delay offset jitter
563.Bl -tag -width "something" -compact -offset indent
564.It Variable
565Description
566.It Ic [tally]
567single-character code indicating current value of the
568.Ic select
569field of the
570.Lk decode.html#peer "peer status word"
571.It Ic remote
572host name (or IP number) of peer.
573The value displayed will be truncated to 15 characters  unless the
574.Fl w
575flag is given, in which case the full value will be displayed
576on the first line,
577and the remaining data is displayed on the next line.
578.It Ic refid
579association ID or
580.Lk decode.html#kiss "'kiss code"
581.It Ic st
582stratum
583.It Ic t
584.Ic u :
585unicast or manycast client,
586.Ic b :
587broadcast or multicast client,
588.Ic l :
589local (reference clock),
590.Ic s :
591symmetric (peer),
592.Ic A :
593manycast server,
594.Ic B :
595broadcast server,
596.Ic M :
597multicast server
598.It Ic when
599sec/min/hr since last received packet
600.It Ic poll
601poll interval (log2 s)
602.It Ic reach
603reach shift register (octal)
604.It Ic delay
605roundtrip delay
606.It Ic offset
607offset of server relative to this host
608.It Ic jitter
609jitter
610.El
611.It Ic apeers
612Display a list of peers in the form:
613.Dl [tally]remote refid assid st t when pool reach delay offset jitter
614where the output is just like the
615.Ic peers
616command except that the
617.Ic refid
618is displayed in hex format and the association number is also displayed.
619.It Ic pstats Ar assocID
620Show the statistics for the peer with the given
621.Ar assocID .
622.It Ic readlist Ar assocID
623.It Ic rl Ar assocID
624Read the system or peer variables included in the variable list.
625.It Ic readvar Ar assocID Ar name Ns Oo Ns = Ns Ar value Oc  Oo , ... Oc
626.It Ic rv Ar assocID Ar name Ns Oo Ns = Ns Ar value Oc  Oo , ... Oc
627Display the specified variables.
628If
629.Ar assocID
630is zero, the variables are from the
631.Sx System Variables
632name space, otherwise they are from the
633.Sx Peer Variables
634name space.
635The
636.Ar assocID
637is required, as the same name can occur in both spaces.
638If no
639.Ar name
640is included, all operative variables in the name space are displayed.
641
642In this case only, if the
643.Ar assocID
644is omitted, it is assumed zero.
645Multiple names are specified with comma separators and without whitespace.
646Note that time values are represented in milliseconds
647and frequency values in parts-per-million (PPM).
648Some NTP timestamps are represented in the format
649YYYYMMDDTTTT ,
650where YYYY is the year,
651MM the month of year,
652DD the day of month and
653TTTT the time of day.
654.It Ic reslist
655Show the access control (restrict) list for
656.Nm .
657
658.It Ic saveconfig Ar filename
659Write the current configuration,
660including any runtime modifications given with
661.Ic :config
662or
663.Ic config-from-file ,
664to the ntpd host's file
665.Ar filename .
666This command will be rejected by the server unless
667.Lk miscopt.html#saveconfigdir "saveconfigdir"
668appears in the
669.Ic ntpd
670configuration file.
671.Ar filename
672can use
673.Xr strftime
674format specifies to substitute the current date and time, for example,
675.Ic q]saveconfig ntp-%Y%m%d-%H%M%S.confq] .
676The filename used is stored in system variable
677.Ic savedconfig .
678Authentication is required.
679.It Ic timerstats
680Display interval timer counters.
681.It Ic writelist Ar assocID
682Write the system or peer variables included in the variable list.
683.It Ic writevar Ar assocID Ar name Ns = Ns Ar value Op , ...
684Write the specified variables.
685If the
686.Ar assocID
687is zero, the variables are from the
688.Sx System Variables
689name space, otherwise they are from the
690.Sx Peer Variables
691name space.
692The
693.Ar assocID
694is required, as the same name can occur in both spaces.
695.It Ic sysinfo
696Display operational summary.
697.It Ic sysstats
698Print statistics counters maintained in the protocol module.
699.El
700
701.Ss Status Words and Kiss Codes
702
703The current state of the operating program is shown
704in a set of status words
705maintained by the system.
706Status information is also available on a per-association basis.
707These words are displayed in the
708.Ic rv
709and
710.Ic as
711commands both in hexadecimal and in decoded short tip strings.
712The codes, tips and short explanations are documented on the
713.Lk decode.html "Event Messages and Status Words"
714page.
715The page also includes a list of system and peer messages,
716the code for the latest of which is included in the status word.
717.Pp
718Information resulting from protocol machine state transitions
719is displayed using an informal set of ASCII strings called
720.Lk decode.html#kiss "kiss codes" .
721The original purpose was for kiss-o'-death (KoD) packets
722sent by the server to advise the client of an unusual condition.
723They are now displayed, when appropriate,
724in the reference identifier field in various billboards.
725
726.Ss System Variables
727The following system variables appear in the
728.Ic rv
729billboard.
730Not all variables are displayed in some configurations.
731.Bl -tag -width "something" -compact -offset indent
732.It Variable
733Description
734.It Ic status
735.Lk decode.html#sys "system status word"
736.It Ic version
737NTP software version and build time
738.It Ic processor
739hardware platform and version
740.It Ic system
741operating system and version
742.It Ic leap
743leap warning indicator (0-3)
744.It Ic stratum
745stratum (1-15)
746.It Ic precision
747precision (log2 s)
748.It Ic rootdelay
749total roundtrip delay to the primary reference clock
750.It Ic rootdisp
751total dispersion to the primary reference clock
752.It Ic peer
753system peer association ID
754.It Ic tc
755time constant and poll exponent (log2 s) (3-17)
756.It Ic mintc
757minimum time constant (log2 s) (3-10)
758.It Ic clock
759date and time of day
760.It Ic refid
761reference ID or
762.Lk decode.html#kiss "kiss code"
763.It Ic reftime
764reference time
765.It Ic offset
766combined  offset of server relative to this host
767.It Ic sys_jitter
768combined system jitter
769.It Ic frequency
770frequency offset (PPM) relative to hardware clock
771.It Ic clk_wander
772clock frequency wander (PPM)
773.It Ic clk_jitter
774clock jitter
775.It Ic tai
776TAI-UTC offset (s)
777.It Ic leapsec
778NTP seconds when the next leap second is/was inserted
779.It Ic expire
780NTP seconds when the NIST leapseconds file expires
781.El
782The jitter and wander statistics are exponentially-weighted RMS averages.
783The system jitter is defined in the NTPv4 specification;
784the clock jitter statistic is computed by the clock discipline module.
785.Pp
786When the NTPv4 daemon is compiled with the OpenSSL software library,
787additional system variables are displayed,
788including some or all of the following,
789depending on the particular Autokey dance:
790
791.Bl -tag -width "something" -compact -offset indent
792.It Variable
793Description
794.It Ic host
795Autokey host name for this host
796.It Ic ident
797Autokey group name for this host
798.It Ic flags
799host flags  (see Autokey specification)
800.It Ic digest
801OpenSSL message digest algorithm
802.It Ic signature
803OpenSSL digest/signature scheme
804.It Ic update
805NTP seconds at last signature update
806.It Ic cert
807certificate subject, issuer and certificate flags
808.It Ic until
809NTP seconds when the certificate expires
810.El
811.Ss Peer Variables
812The following peer variables appear in the
813.Ic rv
814billboard for each association.
815Not all variables are displayed in some configurations.
816
817.Bl -tag -width "something" -compact -offset indent
818.It Variable
819Description
820.It Ic associd
821association ID
822.It Ic status
823.Lk decode.html#peer "peer status word"
824.It Ic srcadr
825source (remote) IP address
826.It Ic srcport
827source (remote) port
828.It Ic dstadr
829destination (local) IP address
830.It Ic dstport
831destination (local) port
832.It Ic leap
833leap indicator (0-3)
834.It Ic stratum
835stratum (0-15)
836.It Ic precision
837precision (log2 s)
838.It Ic rootdelay
839total roundtrip delay to the primary reference clock
840.It Ic rootdisp
841total root dispersion to the primary reference clock
842.It Ic refid
843reference ID or
844.Lk decode.html#kiss "kiss code"
845.It Ic reftime
846reference time
847.It Ic reach
848reach register (octal)
849.It Ic unreach
850unreach counter
851.It Ic hmode
852host mode (1-6)
853.It Ic pmode
854peer mode (1-5)
855.It Ic hpoll
856host poll exponent (log2 s) (3-17)
857.It Ic ppoll
858peer poll exponent (log2 s) (3-17)
859.It Ic headway
860headway (see
861.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" )
862.It Ic flash
863.Lk decode.html#flash "flash status word"
864.It Ic offset
865filter offset
866.It Ic delay
867filter delay
868.It Ic dispersion
869filter dispersion
870.It Ic jitter
871filter jitter
872.It Ic ident
873Autokey group name for this association
874.It Ic bias
875unicast/broadcast bias
876.It Ic xleave
877interleave delay (see
878.Lk xleave.html "NTP Interleaved Modes" )
879.El
880The
881.Ic bias
882variable is calculated when the first broadcast packet is received
883after the calibration volley.
884It represents the offset of the broadcast subgraph relative to the unicast subgraph.
885The
886.Ic xleave
887variable appears only for the interleaved symmetric and interleaved modes.
888It represents the internal queuing, buffering and transmission delays
889for the preceding packet.
890.Pp
891When the NTPv4 daemon is compiled with the OpenSSL software library,
892additional peer variables are displayed, including the following:
893.Bl -tag -width "something" -compact -offset indent
894.It Variable
895Description
896.It Ic flags
897peer flags (see Autokey specification)
898.It Ic host
899Autokey server name
900.It Ic flags
901peer flags (see Autokey specification)
902.It Ic signature
903OpenSSL digest/signature scheme
904.It Ic initsequence
905initial key ID
906.It Ic initkey
907initial key index
908.It Ic timestamp
909Autokey signature timestamp
910.El
911
912.Ss Clock Variables
913The following clock variables appear in the
914.Ic cv
915billboard for each association with a reference clock.
916Not all variables are displayed in some configurations.
917.Bl -tag -width "something" -compact -offset indent
918.It Variable
919Description
920.It Ic associd
921association ID
922.It Ic status
923.Lk decode.html#clock "clock status word"
924.It Ic device
925device description
926.It Ic timecode
927ASCII time code string (specific to device)
928.It Ic poll
929poll messages sent
930.It Ic noreply
931no reply
932.It Ic badformat
933bad format
934.It Ic baddata
935bad date or time
936.It Ic fudgetime1
937fudge time 1
938.It Ic fudgetime2
939fudge time 2
940.It Ic stratum
941driver stratum
942.It Ic refid
943driver reference ID
944.It Ic flags
945driver flags
946.El
947	_END_PROG_MDOC_DESCRIP;
948};
949