1ntpq(8)                          User Commands                         ntpq(8)
2
3
4

NAME

6       ntpq - standard NTP query program
7

SYNOPSIS

9       ntpq [-flags] [-flag [value]] [--option-name[[=| ]value]] [ host ...]
10
11

DESCRIPTION

13       The  ntpq  utility  program is used to query NTP servers to monitor NTP
14       operations and performance, requesting information about current  state
15       and/or  changes in that state.  The program may be run either in inter‐
16       active mode or controlled using command line  arguments.   Requests  to
17       read  and  write  arbitrary  variables  can  be assembled, with raw and
18       pretty-printed output options being available.  The  ntpq  utility  can
19       also  obtain  and  print  a list of peers in a common format by sending
20       multiple queries to the server.
21
22       If one or more request options is included on  the  command  line  when
23       ntpq  is executed, each of the requests will be sent to the NTP servers
24       running on each of the hosts given as command  line  arguments,  or  on
25       localhost  by  default.   If  no  request  options are given, ntpq will
26       attempt to read commands from the standard input and execute  these  on
27       the  NTP  server  running  on the first host given on the command line,
28       again defaulting to localhost when no other  host  is  specified.   The
29       ntpq utility will prompt for commands if the standard input is a termi‐
30       nal device.
31
32       ntpq uses NTP mode 6 packets to communicate with the  NTP  server,  and
33       hence  can  be used to query any compatible server on the network which
34       permits it.  Note that since NTP is a UDP protocol  this  communication
35       will  be  somewhat unreliable, especially over large distances in terms
36       of network topology.  The ntpq utility makes one attempt to  retransmit
37       requests,  and  will  time requests out if the remote host is not heard
38       from within a suitable timeout time.
39
40       Note that in contexts where a host name is  expected,  a  -4  qualifier
41       preceding  the host name forces resolution to the IPv4 namespace, while
42       a -6 qualifier forces resolution to the IPv6 namespace.   For  examples
43       and usage, see the NTP Debugging Techniques page.
44
45       Specifying  a  command  line  option other than -i or -n will cause the
46       specified query (queries) to be sent to the indicated  host(s)  immedi‐
47       ately.   Otherwise,  ntpq  will attempt to read interactive format com‐
48       mands from the standard input.
49
50   Internal Commands
51       Interactive format commands consist of a keyword followed  by  zero  to
52       four arguments.  Only enough characters of the full keyword to uniquely
53       identify the command need be typed.
54
55       A number of interactive format commands are  executed  entirely  within
56       the ntpq utility itself and do not result in NTP requests being sent to
57       a server.  These are described following.
58
59       ? [command]
60       help [command] A ‘?’ by itself will print a list of  all  the  commands
61                      known  to  ntpq.   A ‘?’ followed by a command name will
62                      print function and usage information about the command.
63       addvars name[=value][,...]
64       rmvars name[,...]
65       clearvars
66       showvars       The arguments to this command consist of a list of items
67                      of  the  form name[=value], where the =value is ignored,
68                      and can be omitted, in requests to the  server  to  read
69                      variables.   The ntpq utility maintains an internal list
70                      in which data to be included in messages can  be  assem‐
71                      bled,  and  displayed  or  set  using  the  readlist and
72                      writelist commands described below.  The addvars command
73                      allows  variables  and their optional values to be added
74                      to the list.  If more than one variable is to be  added,
75                      the list should be comma-separated and not contain white
76                      space.  The rmvars command can be used to  remove  indi‐
77                      vidual variables from the list, while the clearvars com‐
78                      mand removes all variables from the list.  The  showvars
79                      command displays the current list of optional variables.
80       authenticate [yes|no]
81                      Normally ntpq does not authenticate requests unless they
82                      are write requests.  The command authenticate yes causes
83                      ntpq  to send authentication with all requests it makes.
84                      Authenticated requests causes  some  servers  to  handle
85                      requests slightly differently.  The command authenticate
86                      causes ntpq to display whether or not  it  is  currently
87                      authenticating requests.
88       cooked         Causes  output  from  query  commands to be "cooked", so
89                      that variables which are recognized by  ntpq  will  have
90                      their  values  reformatted for human consumption.  Vari‐
91                      ables which ntpq could not decode completely are  marked
92                      with a trailing ‘?’.
93       debug [more|less|off]
94                      With  no  argument,  displays  the  current debug level.
95                      Otherwise, the debugging level is changed as indicated.
96       delay [milliseconds]
97                      Specify a  time  interval  to  be  added  to  timestamps
98                      included in requests which require authentication.  This
99                      is used to enable  (unreliable)  server  reconfiguration
100                      over  long delay network paths or between machines whose
101                      clocks are unsynchronized.  Actually the server does not
102                      now  require  timestamps  in  authenticated requests, so
103                      this command may be obsolete.   Without  any  arguments,
104                      displays the current delay.
105       drefid [hash|ipv4]
106                      Display  refids as IPv4 or hash.  Without any arguments,
107                      displays whether refids are shown as IPv4  addresses  or
108                      hashes.
109       exit           Exit ntpq.
110       host [name]    Set  the host to which future queries will be sent.  The
111                      name may be either a host name  or  a  numeric  address.
112                      Without any arguments, displays the current host.
113       hostnames [yes|no]
114                      If  yes is specified, host names are printed in informa‐
115                      tion displays.  If no is  specified,  numeric  addresses
116                      are  printed  instead.  The default is yes, unless modi‐
117                      fied using the command  line  -n  switch.   Without  any
118                      arguments,   displays  whether  host  names  or  numeric
119                      addresses are shown.
120       keyid [keyid]  This command allows the specification of a key number to
121                      be  used  to  authenticate configuration requests.  This
122                      must correspond to the controlkey key number the  server
123                      has  been  configured  to use for this purpose.  Without
124                      any arguments, displays the current keyid.
125       keytype [digest]
126                      Specify the digest algorithm to use  for  authenticating
127                      requests,  with  default  MD5.   If  ntpq was built with
128                      OpenSSL support, and OpenSSL is installed, digest can be
129                      any  message  digest algorithm supported by OpenSSL.  If
130                      no argument is given, the current keytype  digest  algo‐
131                      rithm used is displayed.
132       ntpversion [1|2|3|4]
133                      Sets  the  NTP version number which ntpq claims in pack‐
134                      ets.  Defaults to 3, and note that mode 6  control  mes‐
135                      sages  (and  modes, for that matter) didn't exist in NTP
136                      version 1.  There appear to be  no  servers  left  which
137                      demand  version  1.  With no argument, displays the cur‐
138                      rent NTP version that will be  used  when  communicating
139                      with servers.
140       passwd         This  command  prompts  you to type in a password (which
141                      will not be echoed) which will be used  to  authenticate
142                      configuration requests.  The password must correspond to
143                      the key configured for use by the NTP  server  for  this
144                      purpose if such requests are to be successful.
145       poll [n] [verbose]
146                      Poll  an  NTP  server  in client mode n times.  Poll not
147                      implemented yet.
148       quit           Exit ntpq.
149       raw            Causes all output from  query  commands  is  printed  as
150                      received  from  the  remote  server.   The  only format‐
151                      ing/interpretation done on  the  data  is  to  transform
152                      nonascii  data  into a printable (but barely understand‐
153                      able) form.
154       timeout [milliseconds]
155                      Specify  a  timeout  period  for  responses  to   server
156                      queries.  The default is about 5000 milliseconds.  With‐
157                      out any arguments, displays the current timeout  period.
158                      Note  that  since  ntpq  retries each query once after a
159                      timeout, the total waiting time for a  timeout  will  be
160                      twice the timeout value set.
161       version        Display the version of the ntpq program.
162
163   Control Message Commands
164       Association  ids are used to identify system, peer and clock variables.
165       System variables are assigned an association id of zero and system name
166       space,  while each association is assigned a nonzero association id and
167       peer namespace.  Most control commands send a  single  message  to  the
168       server  and  expect  a single response message.  The exceptions are the
169       peers command, which sends a series of messages, and the mreadlist  and
170       mreadvar commands, which iterate over a range of associations.
171
172       apeers    Display a list of peers in the form: where the output is just
173                 like the peers command except that the refid is displayed  in
174                 hex format and the association number is also displayed.
175       associations
176                 Display a list of mobilized associations in the form:
177
178                 ·
179
180                 ·
181
182                 ·
183
184                 ·
185
186                 ·
187
188                 ·
189
190                 ·
191
192                 ·
193
194                 ·
195
196                 ·
197       authinfo  Display  the  authentication  statistics counters: time since
198                 reset, stored keys, free keys, key lookups, keys  not  found,
199                 uncached keys, expired keys, encryptions, decryptions.
200       clocklist [associd]
201       cl [associd]
202                 Display  all  clock  variables in the variable list for those
203                 associations supporting a reference clock.
204       clockvar [associd] [name[=value][] ,...]
205       cv [associd] [name[=value][] ,...]
206                 Display a list of clock variables for those associations sup‐
207                 porting a reference clock.
208       :config configuration command line
209                 Send the remainder of the command line, including whitespace,
210                 to the server as a run-time configuration command in the same
211                 format  as a line in the configuration file.  This command is
212                 experimental until further notice and clarification.  Authen‐
213                 tication is of course required.
214       config-from-file filename
215                 Send each line of filename to the server as run-time configu‐
216                 ration commands in the same format as lines in the configura‐
217                 tion file.  This command is experimental until further notice
218                 and clarification.  Authentication is required.
219       ifstats   Display status and statistics counters for each local network
220                 interface  address:  interface  number,  interface  name  and
221                 address or broadcast, drop, flag, ttl,  mc,  received,  sent,
222                 send failed, peers, uptime.  Authentication is required.
223       iostats   Display  network  and  reference  clock  I/O statistics: time
224                 since reset, receive  buffers,  free  receive  buffers,  used
225                 receive  buffers, low water refills, dropped packets, ignored
226                 packets, received packets, packets sent,  packet  send  fail‐
227                 ures, input wakeups, useful input wakeups.
228       kerninfo  Display  kernel loop and PPS statistics: associd, status, pll
229                 offset, pll frequency, maximum error, estimated error, kernel
230                 status,  pll  time  constant, precision, frequency tolerance,
231                 pps frequency, pps stability, pps jitter, calibration  inter‐
232                 val, calibration cycles, jitter exceeded, stability exceeded,
233                 calibration errors.  As with other ntpq output, times are  in
234                 milliseconds; very small values may be shown as exponentials.
235                 The precision value displayed is  in  milliseconds  as  well,
236                 unlike the precision system variable.
237       lassociations
238                 Perform the same function as the associations command, except
239                 display mobilized and unmobilized associations, including all
240                 clients.
241       lopeers [-4|-6]
242                 Display a list of all peers and clients showing dstadr (asso‐
243                 ciated with the given IP version).
244       lpassociations
245                 Display the last obtained list of associations, including all
246                 clients.
247       lpeers [-4|-6]
248                 Display  a list of all peers and clients (associated with the
249                 given IP version).
250       monstats  Display monitor  facility  status,  statistics,  and  limits:
251                 enabled,   addresses,   peak  addresses,  maximum  addresses,
252                 reclaim above count, reclaim older than,  kilobytes,  maximum
253                 kilobytes.
254       mreadlist associdlo associdhi
255       mrl associdlo associdhi
256                 Perform the same function as the readlist command for a range
257                 of association ids.
258       mreadvar associdlo associdhi [name][,...]
259                 This range may be determined from the list displayed  by  any
260                 command showing associations.
261       mrv associdlo associdhi [name][,...]
262                 Perform  the same function as the readvar command for a range
263                 of association ids.  This range may be  determined  from  the
264                 list displayed by any command showing associations.
265       mrulist   [limited   |   kod   |  mincount=count  |  laddr=localaddr  |
266       sort=[-]sortorder | resany=hexmask | resall=hexmask]
267                 Display traffic counts  of  the  most  recently  seen  source
268                 addresses  collected  and maintained by the monitor facility.
269                 With the exception of sort=[-]sortorder, the  options  filter
270                 the  list  returned  by ntpd(8).  The limited and kod options
271                 return only entries representing client addresses from  which
272                 the last packet received triggered either discarding or a KoD
273                 response.  The mincount=count option filters  entries  repre‐
274                 senting  less than count packets.  The laddr=localaddr option
275                 filters entries for packets received  on  any  local  address
276                 other than localaddr.  resany=hexmask and resall=hexmask fil‐
277                 ter entries containing none or less than  all,  respectively,
278                 of  the  bits in hexmask, which must begin with 0x.  The sor‐
279                 torder defaults to lstint and may  be  addr,  avgint,  count,
280                 lstint,  or  any of those preceded by ‘-’ to reverse the sort
281                 order.  The output columns are:
282
283                 Column    Description
284                 lstint    Interval in seconds between the receipt of the most
285                           recent  packet from this address and the completion
286                           of the retrieval of the MRU list by ntpq.
287                 avgint    Average interval in s  between  packets  from  this
288                           address.
289                 rstr      Restriction  flags  associated  with  this address.
290                           Most  are  copied  unchanged  from   the   matching
291                           restrict  command,  however  0x400  (kod)  and 0x20
292                           (limited) flags are cleared unless the last  packet
293                           from   this   address   triggered  a  rate  control
294                           response.
295                 r         Rate control indicator, either a period, L or K for
296                           no rate control response, rate limiting by discard‐
297                           ing, or rate limiting with a KoD response,  respec‐
298                           tively.
299                 m         Packet mode.
300                 v         Packet version number.
301                 count     Packets received from this address.
302                 rport     Source port of last packet from this address.
303                 remote address
304                           host  or DNS name, numeric address, or address fol‐
305                           lowed by claimed DNS name which could not be  veri‐
306                           fied in parentheses.
307       opeers [-4 | -6]
308                 Obtain  and print the old-style list of all peers and clients
309                 showing dstadr (associated with the given IP version), rather
310                 than the refid.
311       passociations
312                 Perform the same function as the associations command, except
313                 that it uses previously stored data rather than making a  new
314                 query.
315       peers     Display a list of peers in the form:
316
317                 Variable  Description
318                 [tally]   single-character  code  indicating current value of
319                           the select field of the
320                 remote    host name (or IP number) of peer.  The  value  dis‐
321                           played  will  be  truncated to 15 characters unless
322                           the ntpq -w option is given, in which case the full
323                           value  will  be displayed on the first line, and if
324                           too long, the remaining data will be  displayed  on
325                           the next line.
326                 refid     source IP address or
327                 st        stratum:  0  for  local  reference  clocks,  1  for
328                           servers with local reference clocks,  ...,  16  for
329                           unsynchronized server clocks
330                 t         u: unicast or manycast client, b: broadcast or mul‐
331                           ticast client, p: pool source, l: local  (reference
332                           clock), s: symmetric (peer), A: manycast server, B:
333                           broadcast server, M: multicast server
334                 when      time in seconds, minutes, hours, or days since  the
335                           last  packet  was  received, or ‘-’ if a packet has
336                           never been received
337                 poll      poll interval (s)
338                 reach     reach shift register (octal)
339                 delay     roundtrip delay
340                 offset    offset of server relative to this host
341                 jitter    offset RMS error estimate.
342       pstats associd
343                 Display the statistics for the peer with the  given  associd:
344                 associd,  status,  remote  host,  local  address,  time  last
345                 received, time until next send, reachability change,  packets
346                 sent,  packets  received,  bad  authentication, bogus origin,
347                 duplicate, bad  dispersion,  bad  reference  time,  candidate
348                 order.
349       readlist [associd]
350       rl [associd]
351                 Display  all  system  or  peer  variables.  If the associd is
352                 omitted, it is assumed to be zero.
353       readvar [associd name[=value] [, ...]]
354       rv [associd name[=value] [, ...]]
355                 Display the specified system or peer variables.   If  associd
356                 is  zero,  the  variables  are from the System Variables name
357                 space, otherwise they are from the Peer Variables name space.
358                 The  associd  is required, as the same name can occur in both
359                 spaces.  If no name is included, all operative  variables  in
360                 the  name  space  are  displayed.   In this case only, if the
361                 associd is omitted, it is assumed to be zero.  Multiple names
362                 are  specified  with comma separators and without whitespace.
363                 Note that time values are  represented  in  milliseconds  and
364                 frequency  values in parts-per-million (PPM).  Some NTP time‐
365                 stamps are represented in the format YYYYMM  DD  TTTT,  where
366                 YYYY  is  the year, MM the month of year, DD the day of month
367                 and TTTT the time of day.
368       reslist   Display the access control (restrict) list for ntpq.  Authen‐
369                 tication is required.
370       saveconfig filename
371                 Save the current configuration, including any runtime modifi‐
372                 cations made by  :config  or  config-from-file,  to  the  NTP
373                 server  host file filename.  This command will be rejected by
374                 the server unless appears in the ntpd(8) configuration  file.
375                 filename  can use date(1) format specifiers to substitute the
376                 current date and time, for example,
377                     saveconfig ntp-%Y%m%d-%H%M%S.conf.
378                 The filename used is stored in system  variable  savedconfig.
379                 Authentication is required.
380       sysinfo   Display  system  operational summary: associd, status, system
381                 peer, system peer mode, leap indicator, stratum, log2  preci‐
382                 sion,  root  delay,  root dispersion, reference id, reference
383                 time, system jitter, clock jitter,  clock  wander,  broadcast
384                 delay, symm. auth. delay.
385       sysstats  Display  system  uptime  and  packet counts maintained in the
386                 protocol module: uptime, sysstats  reset,  packets  received,
387                 current version, older version, bad length or format, authen‐
388                 tication failed,  declined,  restricted,  rate  limited,  KoD
389                 responses, processed for time.
390       timerstats
391                 Display  interval  timer  counters:  time  since reset, timer
392                 overruns, calls to transmit.
393       writelist associd
394                 Set all system or peer variables  included  in  the  variable
395                 list.
396       writevar associd name=value [, ...]
397                 Set  the  specified  variables  in the variable list.  If the
398                 associd is zero, the variables are from the System  Variables
399                 name  space,  otherwise they are from the Peer Variables name
400                 space.  The associd is required, as the same name  can  occur
401                 in both spaces.  Authentication is required.
402
403   Status Words and Kiss Codes
404       The  current state of the operating program is shown in a set of status
405       words maintained by the system.  Status information is  also  available
406       on  a per-association basis.  These words are displayed by the readlist
407       and associations commands both in hexadecimal and in decoded short  tip
408       strings.   The codes, tips and short explanations are documented on the
409       page.  The page also includes a list of system and peer  messages,  the
410       code for the latest of which is included in the status word.
411
412       Information  resulting  from protocol machine state transitions is dis‐
413       played using an informal set of ASCII strings called The original  pur‐
414       pose  was  for kiss-o'-death (KoD) packets sent by the server to advise
415       the client of an unusual  condition.   They  are  now  displayed,  when
416       appropriate, in the reference identifier field in various billboards.
417
418   System Variables
419       The  following  system variables appear in the readlist billboard.  Not
420       all variables are displayed in some configurations.
421
422
423       Variable  Description
424       status
425       version   NTP software version and build time
426       processor hardware platform and version
427       system    operating system and version
428       leap      leap warning indicator (0-3)
429       stratum   stratum (1-15)
430       precision precision (log2 s)
431       rootdelay total roundtrip delay to the primary reference clock
432       rootdisp  total dispersion to the primary reference clock
433       refid     reference id or
434       reftime   reference time
435       clock     date and time of day
436       peer      system peer association id
437       tc        time constant and poll exponent (log2 s) (3-17)
438       mintc     minimum time constant (log2 s) (3-10)
439       offset    combined offset of server relative to this host
440       frequency frequency drift (PPM) relative to hardware clock
441       sys_jitter
442                 combined system jitter
443       clk_wander
444                 clock frequency wander (PPM)
445       clk_jitter
446                 clock jitter
447       tai       TAI-UTC offset (s)
448       leapsec   NTP seconds when the next leap second is/was inserted
449       expire    NTP seconds when the NIST leapseconds file expires
450
451       The jitter and wander statistics are exponentially-weighted  RMS  aver‐
452       ages.   The  system  jitter  is defined in the NTPv4 specification; the
453       clock jitter statistic is computed by the clock discipline module.
454
455       When the NTPv4 daemon is compiled with the  OpenSSL  software  library,
456       additional system variables are displayed, including some or all of the
457       following, depending on the particular Autokey dance:
458
459       Variable  Description
460       host      Autokey host name for this host
461       ident     Autokey group name for this host
462       flags     host flags  (see Autokey specification)
463       digest    OpenSSL message digest algorithm
464       signature OpenSSL digest/signature scheme
465       update    NTP seconds at last signature update
466       cert      certificate subject, issuer and certificate flags
467       until     NTP seconds when the certificate expires
468
469   Peer Variables
470       The following peer variables appear in the readlist billboard for  each
471       association.  Not all variables are displayed in some configurations.
472
473
474       Variable  Description
475       associd   association id
476       status
477       srcadr    source (remote) IP address
478       srcport   source (remote) port
479       dstadr    destination (local) IP address
480       dstport   destination (local) port
481       leap      leap indicator (0-3)
482       stratum   stratum (0-15)
483       precision precision (log2 s)
484       rootdelay total roundtrip delay to the primary reference clock
485       rootdisp  total root dispersion to the primary reference clock
486       refid     reference id or
487       reftime   reference time
488       rec       last packet received time
489       reach     reach register (octal)
490       unreach   unreach counter
491       hmode     host mode (1-6)
492       pmode     peer mode (1-5)
493       hpoll     host poll exponent (log2 s) (3-17)
494       ppoll     peer poll exponent (log2 s) (3-17)
495       headway   headway (see
496       flash
497       keyid     symmetric key id
498       offset    filter offset
499       delay     filter delay
500       dispersion
501                 filter dispersion
502       jitter    filter jitter
503       bias      unicast/broadcast bias
504       xleave    interleave delay (see
505
506       The  bias  variable  is  calculated  when the first broadcast packet is
507       received after the calibration volley.  It represents the offset of the
508       broadcast  subgraph relative to the unicast subgraph.  The xleave vari‐
509       able appears only for the interleaved symmetric and interleaved  modes.
510       It  represents  the internal queuing, buffering and transmission delays
511       for the preceding packet.
512
513       When the NTPv4 daemon is compiled with the  OpenSSL  software  library,
514       additional peer variables are displayed, including the following:
515
516       Variable  Description
517       flags     peer flags (see Autokey specification)
518       host      Autokey server name
519       flags     peer flags (see Autokey specification)
520       signature OpenSSL digest/signature scheme
521       initsequence
522                 initial key id
523       initkey   initial key index
524       timestamp Autokey signature timestamp
525       ident     Autokey group name for this association
526
527   Clock Variables
528       The  following  clock  variables  appear in the clocklist billboard for
529       each association with a reference clock.  Not all  variables  are  dis‐
530       played in some configurations.
531
532       Variable  Description
533       associd   association id
534       status
535       device    device description
536       timecode  ASCII time code string (specific to device)
537       poll      poll messages sent
538       noreply   no reply
539       badformat bad format
540       baddata   bad date or time
541       fudgetime1
542                 fudge time 1
543       fudgetime2
544                 fudge time 2
545       stratum   driver stratum
546       refid     driver reference id
547       flags     driver flags
548

OPTIONS

550       -4, --ipv4
551              Force IPv4 name resolution.  This option must not appear in com‐
552              bination with any of the following options: ipv6.
553
554              Force resolution of following host names on the command line  to
555              the IPv4 namespace.
556
557       -6, --ipv6
558              Force IPv6 name resolution.  This option must not appear in com‐
559              bination with any of the following options: ipv4.
560
561              Force resolution of following host names on the command line  to
562              the IPv6 namespace.
563
564       -c cmd, --command=cmd
565              run  a  command  and  exit.  This option may appear an unlimited
566              number of times.
567
568              The following argument is interpreted as an  interactive  format
569              command  and  is added to the list of commands to be executed on
570              the specified host(s).
571
572       -d, --debug-level
573              Increase debug verbosity  level.   This  option  may  appear  an
574              unlimited number of times.
575
576
577       -D number, --set-debug-level=number
578              Set the debug verbosity level.  This option may appear an unlim‐
579              ited number of times.  This option takes an  integer  number  as
580              its argument.
581
582
583       -i, --interactive
584              Force ntpq to operate in interactive mode.  This option must not
585              appear in combination with any of the  following  options:  com‐
586              mand, peers.
587
588              Force  ntpq  to  operate  in  interactive mode.  Prompts will be
589              written to the standard output and commands read from the  stan‐
590              dard input.
591
592       -n, --numeric
593              numeric host addresses.
594
595              Output  all  host addresses in dotted-quad numeric format rather
596              than converting to the canonical host names.
597
598       --old-rv
599              Always output status line with readvar.
600
601              By default, ntpq now suppresses the associd=...  line that  pre‐
602              cedes the output of readvar (alias rv) when a single variable is
603              requested, such as ntpq -c "rv 0 offset".   This  option  causes
604              ntpq to include both lines of output for a single-variable read‐
605              var.  Using an environment variable to preset this option  in  a
606              script  will  enable both older and newer ntpq to behave identi‐
607              cally in this regard.
608
609       -p, --peers
610              Print a list of the peers.  This option must not appear in  com‐
611              bination with any of the following options: interactive.
612
613              Print  a list of the peers known to the server as well as a sum‐
614              mary of their state. This is equivalent to the 'peers'  interac‐
615              tive command.
616
617       -r keyword, --refid=keyword
618              Set  default  display  type for S2+ refids.  This option takes a
619              keyword as its argument.  The argument sets an enumeration value
620              that  can  be  tested by comparing them against the option value
621              macro.  The available keywords are:
622                  hash ipv4
623                  or their numeric equivalent.
624
625              The default keyword for this option is:
626                   ipv4
627
628              Set the default display format for S2+ refids.
629
630       -w, --wide
631              Display the full 'remote' value.
632
633              Display the full value of the 'remote' value.  If this requires
634              more than 15 characters, display the full value, emit a newline,
635              and continue the data display properly indented on the next
636              line.
637
638       -?, --help
639              Display usage information and exit.
640
641       -!, --more-help
642              Pass the extended usage information through a pager.
643
644       -> [cfgfile], --save-opts [=cfgfile]
645              Save the option state to cfgfile.  The default is the last con‐
646              figuration file listed in the OPTION PRESETS section, below.
647              The command will exit after updating the config file.
648
649       -< cfgfile, --load-opts=cfgfile, --no-load-opts
650              Load options from cfgfile.  The no-load-opts form will disable
651              the loading of earlier config/rc/ini files.  --no-load-opts is
652              handled early, out of order.
653
654       --version [{v|c|n}]
655              Output version of program and exit.  The default mode is `v', a
656              simple version.  The `c' mode will print copyright information
657              and `n' will print the full copyright notice.
658

OPTION PRESETS

660       Any option that is not marked as not presettable may be preset by load‐
661       ing values from configuration ("RC" or ".INI") file(s) and values from
662       environment variables named:
663         NTPQ_<option-name> or NTPQ
664       The  environmental  presets  take precedence (are processed later than)
665       the configuration files.  The homerc files are "$HOME",  and  ".".   If
666       any  of  these  are  directories,  then the file .ntprc is searched for
667       within those directories.
668

ENVIRONMENT

670       See OPTION PRESETS for configuration environment variables.
671

FILES

673       See OPTION PRESETS for configuration files.
674

EXIT STATUS

676       One of the following exit values will be returned:
677
678       0  (EXIT_SUCCESS)
679              Successful program execution.
680
681       1  (EXIT_FAILURE)
682              The operation failed or the command syntax was not valid.
683
684       66  (EX_NOINPUT)
685              A specified configuration file could not be loaded.
686
687       70  (EX_SOFTWARE)
688              libopts had an internal operational error.  Please report it  to
689              autogen-users@lists.sourceforge.net.  Thank you.
690

AUTHORS

692       The University of Delaware and Network Time Foundation
693
695       Copyright  (C)  1992-2017  The  University of Delaware and Network Time
696       Foundation all rights reserved.  This program  is  released  under  the
697       terms of the NTP license, <http://ntp.org/license>.
698

BUGS

700       Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
701

NOTES

703       This manual page was AutoGen-erated from the ntpq option definitions.
704
705
706
7074.2.8p13                          20 Feb 2019                          ntpq(8)
Impressum