"Fossies" - the Fresh Open Source Software Archive 
"Fossies" - the Fresh Open Source Software Archive 
4.2.8p14_vs_4.2.8p15.A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.
1 .de1 NOP 2 . it 1 an-trap 3 . if \\n[.$] \,\\$*\/ 4 .. 5 .ie t \ 6 .ds B-Font [CB] 7 .ds I-Font [CI] 8 .ds R-Font [CR] 9 .el \ 10 .ds B-Font B 11 .ds I-Font I 12 .ds R-Font R 13 .TH ntpq 1ntpqman "23 Jun 2020" "4.2.8p15" "User Commands" 14 .\" 15 .\" EDIT THIS FILE WITH CAUTION (in-mem file) 16 .\" 17 .\" It has been AutoGen-ed June 23, 2020 at 02:20:56 AM by AutoGen 5.18.5 18 .\" From the definitions ntpq-opts.def 19 .\" and the template file agman-cmd.tpl 20 .SH NAME 21 \f\*[B-Font]ntpq\fP 22 \- standard NTP query program 23 .SH SYNOPSIS 24 \f\*[B-Font]ntpq\fP 25 .\" Mixture of short (flag) options and long options 26 [\f\*[B-Font]\-flags\f[]] 27 [\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28 [\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29 [ host ...] 30 .sp \n(Ppu 31 .ne 2 32 33 .SH DESCRIPTION 34 .sp \n(Ppu 35 .ne 2 36 37 The 38 \f\*[B-Font]ntpq\fP 39 utility program is used to query NTP servers to monitor NTP operations 40 and performance, requesting 41 information about current state and/or changes in that state. 42 The program may be run either in interactive mode or controlled using 43 command line arguments. 44 Requests to read and write arbitrary 45 variables can be assembled, with raw and pretty-printed output 46 options being available. 47 The 48 \f\*[B-Font]ntpq\fP 49 utility can also obtain and print a 50 list of peers in a common format by sending multiple queries to the 51 server. 52 .sp \n(Ppu 53 .ne 2 54 55 If one or more request options is included on the command line 56 when 57 \f\*[B-Font]ntpq\fP 58 is executed, each of the requests will be sent 59 to the NTP servers running on each of the hosts given as command 60 line arguments, or on localhost by default. 61 If no request options 62 are given, 63 \f\*[B-Font]ntpq\fP 64 will attempt to read commands from the 65 standard input and execute these on the NTP server running on the 66 first host given on the command line, again defaulting to localhost 67 when no other host is specified. 68 The 69 \f\*[B-Font]ntpq\fP 70 utility will prompt for 71 commands if the standard input is a terminal device. 72 .sp \n(Ppu 73 .ne 2 74 75 \f\*[B-Font]ntpq\fP 76 uses NTP mode 6 packets to communicate with the 77 NTP server, and hence can be used to query any compatible server on 78 the network which permits it. 79 Note that since NTP is a UDP protocol 80 this communication will be somewhat unreliable, especially over 81 large distances in terms of network topology. 82 The 83 \f\*[B-Font]ntpq\fP 84 utility makes 85 one attempt to retransmit requests, and will time requests out if 86 the remote host is not heard from within a suitable timeout 87 time. 88 .sp \n(Ppu 89 .ne 2 90 91 Note that in contexts where a host name is expected, a 92 \f\*[B-Font]\-4\f[] 93 qualifier preceding the host name forces resolution to the IPv4 94 namespace, while a 95 \f\*[B-Font]\-6\f[] 96 qualifier forces resolution to the IPv6 namespace. 97 For examples and usage, see the 98 \*[Lq]NTP Debugging Techniques\*[Rq] 99 page. 100 .sp \n(Ppu 101 .ne 2 102 103 Specifying a 104 command line option other than 105 \f\*[B-Font]\-i\f[] 106 or 107 \f\*[B-Font]\-n\f[] 108 will 109 cause the specified query (queries) to be sent to the indicated 110 host(s) immediately. 111 Otherwise, 112 \f\*[B-Font]ntpq\fP 113 will attempt to read 114 interactive format commands from the standard input. 115 .SS "Internal Commands" 116 .sp \n(Ppu 117 .ne 2 118 119 Interactive format commands consist of a keyword followed by zero 120 to four arguments. 121 Only enough characters of the full keyword to 122 uniquely identify the command need be typed. 123 .sp \n(Ppu 124 .ne 2 125 126 A 127 number of interactive format commands are executed entirely within 128 the 129 \f\*[B-Font]ntpq\fP 130 utility itself and do not result in NTP 131 requests being sent to a server. 132 These are described following. 133 .TP 15 134 .NOP \f\*[B-Font]?\f[] [\f\*[I-Font]command\f[]] 135 .br 136 .ns 137 .TP 15 138 .NOP \f\*[B-Font]help\f[] [\f\*[I-Font]command\f[]] 139 A 140 \[oq]\&?\[cq] 141 by itself will print a list of all the commands 142 known to 143 \f\*[B-Font]ntpq\fP. 144 A 145 \[oq]\&?\[cq] 146 followed by a command name will print function and usage 147 information about the command. 148 .br 149 .ns 150 .TP 15 151 .NOP \f\*[B-Font]addvars\f[] \f\*[I-Font]name\f[][\&=\f\*[I-Font]value\f[]][,...] 152 .br 153 .ns 154 .TP 15 155 .NOP \f\*[B-Font]rmvars\f[] \f\*[I-Font]name\f[][,...] 156 .br 157 .ns 158 .TP 15 159 .NOP \f\*[B-Font]clearvars\f[] 160 .br 161 .ns 162 .TP 15 163 .NOP \f\*[B-Font]showvars\f[] 164 The arguments to this command consist of a list of 165 items of the form 166 \f\*[I-Font]name\f[][\&=\f\*[I-Font]value\f[]], 167 where the 168 .NOP \&=\f\*[I-Font]value\f[] 169 is ignored, and can be omitted, 170 in requests to the server to read variables. 171 The 172 \f\*[B-Font]ntpq\fP 173 utility maintains an internal list in which data to be included in 174 messages can be assembled, and displayed or set using the 175 \f\*[B-Font]readlist\f[] 176 and 177 \f\*[B-Font]writelist\f[] 178 commands described below. 179 The 180 \f\*[B-Font]addvars\f[] 181 command allows variables and their optional values to be added to 182 the list. 183 If more than one variable is to be added, the list should 184 be comma-separated and not contain white space. 185 The 186 \f\*[B-Font]rmvars\f[] 187 command can be used to remove individual variables from the list, 188 while the 189 \f\*[B-Font]clearvars\f[] 190 command removes all variables from the 191 list. 192 The 193 \f\*[B-Font]showvars\f[] 194 command displays the current list of optional variables. 195 .br 196 .ns 197 .TP 15 198 .NOP \f\*[B-Font]authenticate\f[] [\f\*[B-Font]yes\f[]|\f\*[B-Font]no\f[]] 199 Normally 200 \f\*[B-Font]ntpq\fP 201 does not authenticate requests unless 202 they are write requests. 203 The command 204 \f\*[B-Font]authenticate\f[] \f\*[B-Font]yes\f[] 205 causes 206 \f\*[B-Font]ntpq\fP 207 to send authentication with all requests it 208 makes. 209 Authenticated requests causes some servers to handle 210 requests slightly differently. 211 The command 212 \f\*[B-Font]authenticate\f[] 213 causes 214 \f\*[B-Font]ntpq\fP 215 to display whether or not 216 it is currently authenticating requests. 217 .br 218 .ns 219 .TP 15 220 .NOP \f\*[B-Font]cooked\f[] 221 Causes output from query commands to be "cooked", so that 222 variables which are recognized by 223 \f\*[B-Font]ntpq\fP 224 will have their 225 values reformatted for human consumption. 226 Variables which 227 \f\*[B-Font]ntpq\fP 228 could not decode completely are 229 marked with a trailing 230 \[oq]\&?\[cq]. 231 .br 232 .ns 233 .TP 15 234 .NOP \f\*[B-Font]debug\f[] [\f\*[B-Font]more\f[]|\f\*[B-Font]less\f[]|\f\*[B-Font]off\f[]] 235 With no argument, displays the current debug level. 236 Otherwise, the debugging level is changed as indicated. 237 .br 238 .ns 239 .TP 15 240 .NOP \f\*[B-Font]delay\f[] [\f\*[I-Font]milliseconds\f[]] 241 Specify a time interval to be added to timestamps included in 242 requests which require authentication. 243 This is used to enable 244 (unreliable) server reconfiguration over long delay network paths 245 or between machines whose clocks are unsynchronized. 246 Actually the 247 server does not now require timestamps in authenticated requests, 248 so this command may be obsolete. 249 Without any arguments, displays the current delay. 250 .br 251 .ns 252 .TP 15 253 .NOP \f\*[B-Font]drefid\f[] [\f\*[B-Font]hash\f[]|\f\*[B-Font]ipv4\f[]] 254 Display refids as IPv4 or hash. 255 Without any arguments, displays whether refids are shown as IPv4 256 addresses or hashes. 257 .br 258 .ns 259 .TP 15 260 .NOP \f\*[B-Font]exit\f[] 261 Exit 262 \f\*[B-Font]ntpq\fP. 263 .br 264 .ns 265 .TP 15 266 .NOP \f\*[B-Font]host\f[] [\f\*[I-Font]name\f[]] 267 Set the host to which future queries will be sent. 268 The 269 \f\*[I-Font]name\f[] 270 may be either a host name or a numeric address. 271 Without any arguments, displays the current host. 272 .br 273 .ns 274 .TP 15 275 .NOP \f\*[B-Font]hostnames\f[] [\f\*[B-Font]yes\f[]|\f\*[B-Font]no\f[]] 276 If 277 \f\*[B-Font]yes\f[] 278 is specified, host names are printed in 279 information displays. 280 If 281 \f\*[B-Font]no\f[] 282 is specified, numeric 283 addresses are printed instead. 284 The default is 285 \f\*[B-Font]yes\f[], 286 unless 287 modified using the command line 288 \f\*[B-Font]\-n\f[] 289 switch. 290 Without any arguments, displays whether host names or numeric addresses 291 are shown. 292 .br 293 .ns 294 .TP 15 295 .NOP \f\*[B-Font]keyid\f[] [\f\*[I-Font]keyid\f[]] 296 This command allows the specification of a key number to be 297 used to authenticate configuration requests. 298 This must correspond 299 to the 300 \f\*[B-Font]controlkey\f[] 301 key number the server has been configured to use for this 302 purpose. 303 Without any arguments, displays the current 304 \f\*[I-Font]keyid\f[]. 305 .br 306 .ns 307 .TP 15 308 .NOP \f\*[B-Font]keytype\f[] [\f\*[I-Font]digest\f[]] 309 Specify the digest algorithm to use for authenticating requests, with default 310 \f\*[B-Font]MD5\f[]. 311 If 312 \f\*[B-Font]ntpq\fP 313 was built with OpenSSL support, and OpenSSL is installed, 314 \f\*[I-Font]digest\f[] 315 can be any message digest algorithm supported by OpenSSL. 316 If no argument is given, the current 317 \f\*[B-Font]keytype\f[] \f\*[I-Font]digest\f[] 318 algorithm used is displayed. 319 .br 320 .ns 321 .TP 15 322 .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[]] 323 Sets the NTP version number which 324 \f\*[B-Font]ntpq\fP 325 claims in 326 packets. 327 Defaults to 3, and note that mode 6 control messages (and 328 modes, for that matter) didn't exist in NTP version 1. 329 There appear 330 to be no servers left which demand version 1. 331 With no argument, displays the current NTP version that will be used 332 when communicating with servers. 333 .br 334 .ns 335 .TP 15 336 .NOP \f\*[B-Font]passwd\f[] 337 This command prompts you to type in a password (which will not 338 be echoed) which will be used to authenticate configuration 339 requests. 340 The password must correspond to the key configured for 341 use by the NTP server for this purpose if such requests are to be 342 successful. 343 .br 344 .ns 345 .TP 15 346 .NOP \f\*[B-Font]poll\f[] [\f\*[I-Font]n\f[]] [\f\*[B-Font]verbose\f[]] 347 Poll an NTP server in client mode 348 \f\*[I-Font]n\f[] 349 times. 350 Poll not implemented yet. 351 .br 352 .ns 353 .TP 15 354 .NOP \f\*[B-Font]quit\f[] 355 Exit 356 \f\*[B-Font]ntpq\fP. 357 .br 358 .ns 359 .TP 15 360 .NOP \f\*[B-Font]raw\f[] 361 Causes all output from query commands is printed as received 362 from the remote server. 363 The only formating/interpretation done on 364 the data is to transform nonascii data into a printable (but barely 365 understandable) form. 366 .br 367 .ns 368 .TP 15 369 .NOP \f\*[B-Font]timeout\f[] [\f\*[I-Font]milliseconds\f[]] 370 Specify a timeout period for responses to server queries. 371 The 372 default is about 5000 milliseconds. 373 Without any arguments, displays the current timeout period. 374 Note that since 375 \f\*[B-Font]ntpq\fP 376 retries each query once after a timeout, the total waiting time for 377 a timeout will be twice the timeout value set. 378 .br 379 .ns 380 .TP 15 381 .NOP \f\*[B-Font]version\f[] 382 Display the version of the 383 \f\*[B-Font]ntpq\fP 384 program. 385 .PP 386 .SS "Control Message Commands" 387 Association ids are used to identify system, peer and clock variables. 388 System variables are assigned an association id of zero and system name 389 space, while each association is assigned a nonzero association id and 390 peer namespace. 391 Most control commands send a single message to the server and expect a 392 single response message. 393 The exceptions are the 394 \f\*[B-Font]peers\f[] 395 command, which sends a series of messages, 396 and the 397 \f\*[B-Font]mreadlist\f[] 398 and 399 \f\*[B-Font]mreadvar\f[] 400 commands, which iterate over a range of associations. 401 .TP 10 402 .NOP \f\*[B-Font]apeers\f[] 403 Display a list of peers in the form: 404 .Dl [tally]remote refid assid st t when pool reach delay offset jitter 405 where the output is just like the 406 \f\*[B-Font]peers\f[] 407 command except that the 408 \f\*[B-Font]refid\f[] 409 is displayed in hex format and the association number is also displayed. 410 .br 411 .ns 412 .TP 10 413 .NOP \f\*[B-Font]associations\f[] 414 Display a list of mobilized associations in the form: 415 .Dl ind assid status conf reach auth condition last_event cnt 416 .RS 417 .IP \fB\(bu\fP 2 418 .IP \fB\(bu\fP 2 \f\*[B-Font]ind\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]index\f[] \f\*[B-Font]on\f[] \f\*[B-Font]this\f[] \f\*[B-Font]list\f[] 419 .IP \fB\(bu\fP 2 \f\*[B-Font]assid\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]association\f[] \f\*[B-Font]id\f[] 420 .IP \fB\(bu\fP 2 \f\*[B-Font]status\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]peer\f[] \f\*[B-Font]status\f[] \f\*[B-Font]word\f[] 421 .IP \fB\(bu\fP 2 \f\*[B-Font]conf\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]yes\f[]: \f\*[B-Font]No\f[] \f\*[B-Font]persistent,\f[] \f\*[B-Font]no\f[]: \f\*[B-Font]No\f[] \f\*[B-Font]ephemeral\f[] 422 .IP \fB\(bu\fP 2 \f\*[B-Font]reach\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]yes\f[]: \f\*[B-Font]No\f[] \f\*[B-Font]reachable,\f[] \f\*[B-Font]no\f[]: \f\*[B-Font]No\f[] \f\*[B-Font]unreachable\f[] 423 .IP \fB\(bu\fP 2 \f\*[B-Font]auth\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]ok\f[], \f\*[B-Font]yes\f[], \f\*[B-Font]bad\f[] \f\*[B-Font]No\f[] \f\*[B-Font]and\f[] \f\*[B-Font]none\f[] 424 .IP \fB\(bu\fP 2 \f\*[B-Font]condition\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]selection\f[] \f\*[B-Font]status\f[] \f\*[B-Font]\&(see\f[] \f\*[B-Font]the\f[] \f\*[B-Font]select\f[] \f\*[B-Font]No\f[] \f\*[B-Font]field\f[] \f\*[B-Font]of\f[] \f\*[B-Font]the\f[] \f\*[B-Font]peer\f[] \f\*[B-Font]status\f[] \f\*[B-Font]word\&)\f[] 425 .IP \fB\(bu\fP 2 \f\*[B-Font]last_event\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]event\f[] \f\*[B-Font]report\f[] \f\*[B-Font]\&(see\f[] \f\*[B-Font]the\f[] \f\*[B-Font]event\f[] \f\*[B-Font]No\f[] \f\*[B-Font]field\f[] \f\*[B-Font]of\f[] \f\*[B-Font]the\f[] \f\*[B-Font]peer\f[] \f\*[B-Font]status\f[] \f\*[B-Font]word\&)\f[] 426 .IP \fB\(bu\fP 2 \f\*[B-Font]cnt\f[] \f\*[B-Font]Ta\f[] \f\*[B-Font]event\f[] \f\*[B-Font]count\f[] \f\*[B-Font]\&(see\f[] \f\*[B-Font]the\f[] \f\*[B-Font]count\f[] \f\*[B-Font]No\f[] \f\*[B-Font]field\f[] \f\*[B-Font]of\f[] \f\*[B-Font]the\f[] \f\*[B-Font]peer\f[] \f\*[B-Font]status\f[] \f\*[B-Font]word\&)\f[] 427 .RE 428 .br 429 .ns 430 .TP 10 431 .NOP \f\*[B-Font]authinfo\f[] 432 Display the authentication statistics counters: 433 time since reset, stored keys, free keys, key lookups, keys not found, 434 uncached keys, expired keys, encryptions, decryptions. 435 .br 436 .ns 437 .TP 10 438 .NOP \f\*[B-Font]clocklist\f[] [\f\*[I-Font]associd\f[]] 439 .br 440 .ns 441 .TP 10 442 .NOP \f\*[B-Font]cl\f[] [\f\*[I-Font]associd\f[]] 443 Display all clock variables in the variable list for those associations 444 supporting a reference clock. 445 .br 446 .ns 447 .TP 10 448 .NOP \f\*[B-Font]clockvar\f[] [\f\*[I-Font]associd\f[]] [\f\*[I-Font]name\f[][\&=\f\*[I-Font]value\f[]][] ,...] 449 .br 450 .ns 451 .TP 10 452 .NOP \f\*[B-Font]cv\f[] [\f\*[I-Font]associd\f[]] [\f\*[I-Font]name\f[][\&=\f\*[I-Font]value\f[]][] ,...] 453 Display a list of clock variables for those associations supporting a 454 reference clock. 455 .br 456 .ns 457 .TP 10 458 .NOP \f\*[B-Font]:config\f[] \f\*[I-Font]configuration command line\f[] 459 Send the remainder of the command line, including whitespace, to the 460 server as a run-time configuration command in the same format as a line 461 in the configuration file. 462 This command is experimental until further notice and clarification. 463 Authentication is of course required. 464 .br 465 .ns 466 .TP 10 467 .NOP \f\*[B-Font]config-from-file\f[] \f\*[I-Font]filename\f[] 468 Send each line of 469 \f\*[I-Font]filename\f[] 470 to the server as run-time configuration commands in the same format as 471 lines in the configuration file. 472 This command is experimental until further notice and clarification. 473 Authentication is required. 474 .br 475 .ns 476 .TP 10 477 .NOP \f\*[B-Font]ifstats\f[] 478 Display status and statistics counters for each local network interface address: 479 interface number, interface name and address or broadcast, drop, flag, 480 ttl, mc, received, sent, send failed, peers, uptime. 481 Authentication is required. 482 .br 483 .ns 484 .TP 10 485 .NOP \f\*[B-Font]iostats\f[] 486 Display network and reference clock I/O statistics: 487 time since reset, receive buffers, free receive buffers, used receive buffers, 488 low water refills, dropped packets, ignored packets, received packets, 489 packets sent, packet send failures, input wakeups, useful input wakeups. 490 .br 491 .ns 492 .TP 10 493 .NOP \f\*[B-Font]kerninfo\f[] 494 Display kernel loop and PPS statistics: 495 associd, status, pll offset, pll frequency, maximum error, 496 estimated error, kernel status, pll time constant, precision, 497 frequency tolerance, pps frequency, pps stability, pps jitter, 498 calibration interval, calibration cycles, jitter exceeded, 499 stability exceeded, calibration errors. 500 As with other ntpq output, times are in milliseconds; very small values 501 may be shown as exponentials. 502 The precision value displayed is in milliseconds as well, unlike the 503 precision system variable. 504 .br 505 .ns 506 .TP 10 507 .NOP \f\*[B-Font]lassociations\f[] 508 Perform the same function as the associations command, except display 509 mobilized and unmobilized associations, including all clients. 510 .br 511 .ns 512 .TP 10 513 .NOP \f\*[B-Font]lopeers\f[] [\f\*[B-Font]\-4\f[]|\f\*[B-Font]\-6\f[]] 514 Display a list of all peers and clients showing 515 \f\*[B-Font]dstadr\f[] 516 (associated with the given IP version). 517 .br 518 .ns 519 .TP 10 520 .NOP \f\*[B-Font]lpassociations\f[] 521 Display the last obtained list of associations, including all clients. 522 .br 523 .ns 524 .TP 10 525 .NOP \f\*[B-Font]lpeers\f[] [\f\*[B-Font]\-4\f[]|\f\*[B-Font]\-6\f[]] 526 Display a list of all peers and clients (associated with the given IP version). 527 .br 528 .ns 529 .TP 10 530 .NOP \f\*[B-Font]monstats\f[] 531 Display monitor facility status, statistics, and limits: 532 enabled, addresses, peak addresses, maximum addresses, 533 reclaim above count, reclaim older than, kilobytes, maximum kilobytes. 534 .br 535 .ns 536 .TP 10 537 .NOP \f\*[B-Font]mreadlist\f[] \f\*[I-Font]associdlo\f[] \f\*[I-Font]associdhi\f[] 538 .br 539 .ns 540 .TP 10 541 .NOP \f\*[B-Font]mrl\f[] \f\*[I-Font]associdlo\f[] \f\*[I-Font]associdhi\f[] 542 Perform the same function as the 543 \f\*[B-Font]readlist\f[] 544 command for a range of association ids. 545 .br 546 .ns 547 .TP 10 548 .NOP \f\*[B-Font]mreadvar\f[] \f\*[I-Font]associdlo\f[] \f\*[I-Font]associdhi\f[] [\f\*[I-Font]name\f[]][,...] 549 This range may be determined from the list displayed by any 550 command showing associations. 551 .br 552 .ns 553 .TP 10 554 .NOP \f\*[B-Font]mrv\f[] \f\*[I-Font]associdlo\f[] \f\*[I-Font]associdhi\f[] [\f\*[I-Font]name\f[]][,...] 555 Perform the same function as the 556 \f\*[B-Font]readvar\f[] 557 command for a range of association ids. 558 This range may be determined from the list displayed by any 559 command showing associations. 560 .br 561 .ns 562 .TP 10 563 .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[]] 564 Display traffic counts of the most recently seen source addresses 565 collected and maintained by the monitor facility. 566 With the exception of 567 \f\*[B-Font]sort\f[]\&=[\&-]\f\*[I-Font]sortorder\f[], 568 the options filter the list returned by 569 \fCntpd\f[]\fR(8)\f[]. 570 The 571 \f\*[B-Font]limited\f[] 572 and 573 \f\*[B-Font]kod\f[] 574 options return only entries representing client addresses from which the 575 last packet received triggered either discarding or a KoD response. 576 The 577 \f\*[B-Font]mincount\f[]=\f\*[I-Font]count\f[] 578 option filters entries representing less than 579 \f\*[I-Font]count\f[] 580 packets. 581 The 582 \f\*[B-Font]laddr\f[]=\f\*[I-Font]localaddr\f[] 583 option filters entries for packets received on any local address other than 584 \f\*[I-Font]localaddr\f[]. 585 \f\*[B-Font]resany\f[]=\f\*[I-Font]hexmask\f[] 586 and 587 \f\*[B-Font]resall\f[]=\f\*[I-Font]hexmask\f[] 588 filter entries containing none or less than all, respectively, of the bits in 589 \f\*[I-Font]hexmask\f[], 590 which must begin with 591 \f\*[B-Font]0x\f[]. 592 The 593 \f\*[I-Font]sortorder\f[] 594 defaults to 595 \f\*[B-Font]lstint\f[] 596 and may be 597 \f\*[B-Font]addr\f[], 598 \f\*[B-Font]avgint\f[], 599 \f\*[B-Font]count\f[], 600 \f\*[B-Font]lstint\f[], 601 or any of those preceded by 602 \[oq]\&-\[cq] 603 to reverse the sort order. 604 The output columns are: 605 .RS 606 .TP 10 607 .NOP Column 608 Description 609 .br 610 .ns 611 .TP 10 612 .NOP \f\*[B-Font]lstint\f[] 613 Interval in seconds between the receipt of the most recent packet from 614 this address and the completion of the retrieval of the MRU list by 615 \f\*[B-Font]ntpq\fP. 616 .br 617 .ns 618 .TP 10 619 .NOP \f\*[B-Font]avgint\f[] 620 Average interval in s between packets from this address. 621 .br 622 .ns 623 .TP 10 624 .NOP \f\*[B-Font]rstr\f[] 625 Restriction flags associated with this address. 626 Most are copied unchanged from the matching 627 \f\*[B-Font]restrict\f[] 628 command, however 0x400 (kod) and 0x20 (limited) flags are cleared unless 629 the last packet from this address triggered a rate control response. 630 .br 631 .ns 632 .TP 10 633 .NOP \f\*[B-Font]r\f[] 634 Rate control indicator, either 635 a period, 636 \f\*[B-Font]L\f[] 637 or 638 \f\*[B-Font]K\f[] 639 for no rate control response, 640 rate limiting by discarding, or rate limiting with a KoD response, respectively. 641 .br 642 .ns 643 .TP 10 644 .NOP \f\*[B-Font]m\f[] 645 Packet mode. 646 .br 647 .ns 648 .TP 10 649 .NOP \f\*[B-Font]v\f[] 650 Packet version number. 651 .br 652 .ns 653 .TP 10 654 .NOP \f\*[B-Font]count\f[] 655 Packets received from this address. 656 .br 657 .ns 658 .TP 10 659 .NOP \f\*[B-Font]rport\f[] 660 Source port of last packet from this address. 661 .br 662 .ns 663 .TP 10 664 .NOP \f\*[B-Font]remote\f[] \f\*[B-Font]address\f[] 665 host or DNS name, numeric address, or address followed by 666 claimed DNS name which could not be verified in parentheses. 667 .RE 668 .br 669 .ns 670 .TP 10 671 .NOP \f\*[B-Font]opeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] 672 Obtain and print the old-style list of all peers and clients showing 673 \f\*[B-Font]dstadr\f[] 674 (associated with the given IP version), 675 rather than the 676 \f\*[B-Font]refid\f[]. 677 .br 678 .ns 679 .TP 10 680 .NOP \f\*[B-Font]passociations\f[] 681 Perform the same function as the 682 \f\*[B-Font]associations\f[] 683 command, 684 except that it uses previously stored data rather than making a new query. 685 .br 686 .ns 687 .TP 10 688 .NOP \f\*[B-Font]peers\f[] 689 Display a list of peers in the form: 690 .Dl [tally]remote refid st t when pool reach delay offset jitter 691 .RS 692 .TP 10 693 .NOP Variable 694 Description 695 .br 696 .ns 697 .TP 10 698 .NOP \f\*[B-Font][tally]\f[] 699 single-character code indicating current value of the 700 \f\*[B-Font]select\f[] 701 field of the 702 .Lk decode.html#peer "peer status word" 703 .br 704 .ns 705 .TP 10 706 .NOP \f\*[B-Font]remote\f[] 707 host name (or IP number) of peer. 708 The value displayed will be truncated to 15 characters unless the 709 \f\*[B-Font]ntpq\fP 710 \f\*[B-Font]\-w\f[] 711 option is given, in which case the full value will be displayed 712 on the first line, and if too long, 713 the remaining data will be displayed on the next line. 714 .br 715 .ns 716 .TP 10 717 .NOP \f\*[B-Font]refid\f[] 718 source IP address or 719 .Lk decode.html#kiss "'kiss code" 720 .br 721 .ns 722 .TP 10 723 .NOP \f\*[B-Font]st\f[] 724 stratum: 0 for local reference clocks, 1 for servers with local 725 reference clocks, ..., 16 for unsynchronized server clocks 726 .br 727 .ns 728 .TP 10 729 .NOP \f\*[B-Font]t\f[] 730 \f\*[B-Font]u\f[]: 731 unicast or manycast client, 732 \f\*[B-Font]b\f[]: 733 broadcast or multicast client, 734 \f\*[B-Font]p\f[]: 735 pool source, 736 \f\*[B-Font]l\f[]: 737 local (reference clock), 738 \f\*[B-Font]s\f[]: 739 symmetric (peer), 740 \f\*[B-Font]A\f[]: 741 manycast server, 742 \f\*[B-Font]B\f[]: 743 broadcast server, 744 \f\*[B-Font]M\f[]: 745 multicast server 746 .br 747 .ns 748 .TP 10 749 .NOP \f\*[B-Font]when\f[] 750 time in seconds, minutes, hours, or days since the last packet 751 was received, or 752 \[oq]\&-\[cq] 753 if a packet has never been received 754 .br 755 .ns 756 .TP 10 757 .NOP \f\*[B-Font]poll\f[] 758 poll interval (s) 759 .br 760 .ns 761 .TP 10 762 .NOP \f\*[B-Font]reach\f[] 763 reach shift register (octal) 764 .br 765 .ns 766 .TP 10 767 .NOP \f\*[B-Font]delay\f[] 768 roundtrip delay 769 .br 770 .ns 771 .TP 10 772 .NOP \f\*[B-Font]offset\f[] 773 offset of server relative to this host 774 .br 775 .ns 776 .TP 10 777 .NOP \f\*[B-Font]jitter\f[] 778 offset RMS error estimate. 779 .RE 780 .br 781 .ns 782 .TP 10 783 .NOP \f\*[B-Font]pstats\f[] \f\*[I-Font]associd\f[] 784 Display the statistics for the peer with the given 785 \f\*[I-Font]associd\f[]: 786 associd, status, remote host, local address, time last received, 787 time until next send, reachability change, packets sent, 788 packets received, bad authentication, bogus origin, duplicate, 789 bad dispersion, bad reference time, candidate order. 790 .br 791 .ns 792 .TP 10 793 .NOP \f\*[B-Font]readlist\f[] [\f\*[I-Font]associd\f[]] 794 .br 795 .ns 796 .TP 10 797 .NOP \f\*[B-Font]rl\f[] [\f\*[I-Font]associd\f[]] 798 Display all system or peer variables. 799 If the 800 \f\*[I-Font]associd\f[] 801 is omitted, it is assumed to be zero. 802 .br 803 .ns 804 .TP 10 805 .NOP \f\*[B-Font]readvar\f[] [\f\*[I-Font]associd\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...]] 806 .br 807 .ns 808 .TP 10 809 .NOP \f\*[B-Font]rv\f[] [\f\*[I-Font]associd\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...]] 810 Display the specified system or peer variables. 811 If 812 \f\*[I-Font]associd\f[] 813 is zero, the variables are from the 814 \fISystem\f[] \fIVariables\f[] 815 name space, otherwise they are from the 816 \fIPeer\f[] \fIVariables\f[] 817 name space. 818 The 819 \f\*[I-Font]associd\f[] 820 is required, as the same name can occur in both spaces. 821 If no 822 \f\*[I-Font]name\f[] 823 is included, all operative variables in the name space are displayed. 824 In this case only, if the 825 \f\*[I-Font]associd\f[] 826 is omitted, it is assumed to be zero. 827 Multiple names are specified with comma separators and without whitespace. 828 Note that time values are represented in milliseconds 829 and frequency values in parts-per-million (PPM). 830 Some NTP timestamps are represented in the format 831 \f\*[I-Font]YYYY\f[]\f\*[I-Font]MM\f[] \f\*[I-Font]DD\f[] \f\*[I-Font]TTTT\f[], 832 where 833 \f\*[I-Font]YYYY\f[] 834 is the year, 835 \f\*[I-Font]MM\f[] 836 the month of year, 837 \f\*[I-Font]DD\f[] 838 the day of month and 839 \f\*[I-Font]TTTT\f[] 840 the time of day. 841 .br 842 .ns 843 .TP 10 844 .NOP \f\*[B-Font]reslist\f[] 845 Display the access control (restrict) list for 846 \f\*[B-Font]ntpq\fP. 847 Authentication is required. 848 .br 849 .ns 850 .TP 10 851 .NOP \f\*[B-Font]saveconfig\f[] \f\*[I-Font]filename\f[] 852 Save the current configuration, 853 including any runtime modifications made by 854 \f\*[B-Font]:config\f[] 855 or 856 \f\*[B-Font]config-from-file\f[], 857 to the NTP server host file 858 \f\*[I-Font]filename\f[]. 859 This command will be rejected by the server unless 860 .Lk miscopt.html#saveconfigdir "saveconfigdir" 861 appears in the 862 \fCntpd\f[]\fR(8)\f[] 863 configuration file. 864 \f\*[I-Font]filename\f[] 865 can use 866 \fCdate\f[]\fR(1)\f[] 867 format specifiers to substitute the current date and time, for 868 example, 869 .in +4 870 \f\*[B-Font]saveconfig\f[] \fIntp-%Y%m%d-%H%M%S.conf\f[]. 871 .in -4 872 The filename used is stored in system variable 873 \f\*[B-Font]savedconfig\f[]. 874 Authentication is required. 875 .br 876 .ns 877 .TP 10 878 .NOP \f\*[B-Font]sysinfo\f[] 879 Display system operational summary: 880 associd, status, system peer, system peer mode, leap indicator, 881 stratum, log2 precision, root delay, root dispersion, 882 reference id, reference time, system jitter, clock jitter, 883 clock wander, broadcast delay, symm. auth. delay. 884 .br 885 .ns 886 .TP 10 887 .NOP \f\*[B-Font]sysstats\f[] 888 Display system uptime and packet counts maintained in the 889 protocol module: 890 uptime, sysstats reset, packets received, current version, 891 older version, bad length or format, authentication failed, 892 declined, restricted, rate limited, KoD responses, 893 processed for time. 894 .br 895 .ns 896 .TP 10 897 .NOP \f\*[B-Font]timerstats\f[] 898 Display interval timer counters: 899 time since reset, timer overruns, calls to transmit. 900 .br 901 .ns 902 .TP 10 903 .NOP \f\*[B-Font]writelist\f[] \f\*[I-Font]associd\f[] 904 Set all system or peer variables included in the variable list. 905 .br 906 .ns 907 .TP 10 908 .NOP \f\*[B-Font]writevar\f[] \f\*[I-Font]associd\f[] \f\*[I-Font]name\f[]=\f\*[I-Font]value\f[] [, ...] 909 Set the specified variables in the variable list. 910 If the 911 \f\*[I-Font]associd\f[] 912 is zero, the variables are from the 913 \fISystem\f[] \fIVariables\f[] 914 name space, otherwise they are from the 915 \fIPeer\f[] \fIVariables\f[] 916 name space. 917 The 918 \f\*[I-Font]associd\f[] 919 is required, as the same name can occur in both spaces. 920 Authentication is required. 921 .PP 922 .SS Status Words and Kiss Codes 923 The current state of the operating program is shown 924 in a set of status words 925 maintained by the system. 926 Status information is also available on a per-association basis. 927 These words are displayed by the 928 \f\*[B-Font]readlist\f[] 929 and 930 \f\*[B-Font]associations\f[] 931 commands both in hexadecimal and in decoded short tip strings. 932 The codes, tips and short explanations are documented on the 933 .Lk decode.html "Event Messages and Status Words" 934 page. 935 The page also includes a list of system and peer messages, 936 the code for the latest of which is included in the status word. 937 .sp \n(Ppu 938 .ne 2 939 940 Information resulting from protocol machine state transitions 941 is displayed using an informal set of ASCII strings called 942 .Lk decode.html#kiss "kiss codes" . 943 The original purpose was for kiss-o'-death (KoD) packets 944 sent by the server to advise the client of an unusual condition. 945 They are now displayed, when appropriate, 946 in the reference identifier field in various billboards. 947 .SS System Variables 948 The following system variables appear in the 949 \f\*[B-Font]readlist\f[] 950 billboard. 951 Not all variables are displayed in some configurations. 952 .sp \n(Ppu 953 .ne 2 954 955 .TP 10 956 .NOP Variable 957 Description 958 .br 959 .ns 960 .TP 10 961 .NOP \f\*[B-Font]status\f[] 962 .Lk decode.html#sys "system status word" 963 .br 964 .ns 965 .TP 10 966 .NOP \f\*[B-Font]version\f[] 967 NTP software version and build time 968 .br 969 .ns 970 .TP 10 971 .NOP \f\*[B-Font]processor\f[] 972 hardware platform and version 973 .br 974 .ns 975 .TP 10 976 .NOP \f\*[B-Font]system\f[] 977 operating system and version 978 .br 979 .ns 980 .TP 10 981 .NOP \f\*[B-Font]leap\f[] 982 leap warning indicator (0-3) 983 .br 984 .ns 985 .TP 10 986 .NOP \f\*[B-Font]stratum\f[] 987 stratum (1-15) 988 .br 989 .ns 990 .TP 10 991 .NOP \f\*[B-Font]precision\f[] 992 precision (log2 s) 993 .br 994 .ns 995 .TP 10 996 .NOP \f\*[B-Font]rootdelay\f[] 997 total roundtrip delay to the primary reference clock 998 .br 999 .ns 1000 .TP 10 1001 .NOP \f\*[B-Font]rootdisp\f[] 1002 total dispersion to the primary reference clock 1003 .br 1004 .ns 1005 .TP 10 1006 .NOP \f\*[B-Font]refid\f[] 1007 reference id or 1008 .Lk decode.html#kiss "kiss code" 1009 .br 1010 .ns 1011 .TP 10 1012 .NOP \f\*[B-Font]reftime\f[] 1013 reference time 1014 .br 1015 .ns 1016 .TP 10 1017 .NOP \f\*[B-Font]clock\f[] 1018 date and time of day 1019 .br 1020 .ns 1021 .TP 10 1022 .NOP \f\*[B-Font]peer\f[] 1023 system peer association id 1024 .br 1025 .ns 1026 .TP 10 1027 .NOP \f\*[B-Font]tc\f[] 1028 time constant and poll exponent (log2 s) (3-17) 1029 .br 1030 .ns 1031 .TP 10 1032 .NOP \f\*[B-Font]mintc\f[] 1033 minimum time constant (log2 s) (3-10) 1034 .br 1035 .ns 1036 .TP 10 1037 .NOP \f\*[B-Font]offset\f[] 1038 combined offset of server relative to this host 1039 .br 1040 .ns 1041 .TP 10 1042 .NOP \f\*[B-Font]frequency\f[] 1043 frequency drift (PPM) relative to hardware clock 1044 .br 1045 .ns 1046 .TP 10 1047 .NOP \f\*[B-Font]sys_jitter\f[] 1048 combined system jitter 1049 .br 1050 .ns 1051 .TP 10 1052 .NOP \f\*[B-Font]clk_wander\f[] 1053 clock frequency wander (PPM) 1054 .br 1055 .ns 1056 .TP 10 1057 .NOP \f\*[B-Font]clk_jitter\f[] 1058 clock jitter 1059 .br 1060 .ns 1061 .TP 10 1062 .NOP \f\*[B-Font]tai\f[] 1063 TAI-UTC offset (s) 1064 .br 1065 .ns 1066 .TP 10 1067 .NOP \f\*[B-Font]leapsec\f[] 1068 NTP seconds when the next leap second is/was inserted 1069 .br 1070 .ns 1071 .TP 10 1072 .NOP \f\*[B-Font]expire\f[] 1073 NTP seconds when the NIST leapseconds file expires 1074 .PP 1075 The jitter and wander statistics are exponentially-weighted RMS averages. 1076 The system jitter is defined in the NTPv4 specification; 1077 the clock jitter statistic is computed by the clock discipline module. 1078 .sp \n(Ppu 1079 .ne 2 1080 1081 When the NTPv4 daemon is compiled with the OpenSSL software library, 1082 additional system variables are displayed, 1083 including some or all of the following, 1084 depending on the particular Autokey dance: 1085 .TP 10 1086 .NOP Variable 1087 Description 1088 .br 1089 .ns 1090 .TP 10 1091 .NOP \f\*[B-Font]host\f[] 1092 Autokey host name for this host 1093 .br 1094 .ns 1095 .TP 10 1096 .NOP \f\*[B-Font]ident\f[] 1097 Autokey group name for this host 1098 .br 1099 .ns 1100 .TP 10 1101 .NOP \f\*[B-Font]flags\f[] 1102 host flags (see Autokey specification) 1103 .br 1104 .ns 1105 .TP 10 1106 .NOP \f\*[B-Font]digest\f[] 1107 OpenSSL message digest algorithm 1108 .br 1109 .ns 1110 .TP 10 1111 .NOP \f\*[B-Font]signature\f[] 1112 OpenSSL digest/signature scheme 1113 .br 1114 .ns 1115 .TP 10 1116 .NOP \f\*[B-Font]update\f[] 1117 NTP seconds at last signature update 1118 .br 1119 .ns 1120 .TP 10 1121 .NOP \f\*[B-Font]cert\f[] 1122 certificate subject, issuer and certificate flags 1123 .br 1124 .ns 1125 .TP 10 1126 .NOP \f\*[B-Font]until\f[] 1127 NTP seconds when the certificate expires 1128 .PP 1129 .SS Peer Variables 1130 The following peer variables appear in the 1131 \f\*[B-Font]readlist\f[] 1132 billboard for each association. 1133 Not all variables are displayed in some configurations. 1134 .sp \n(Ppu 1135 .ne 2 1136 1137 .TP 10 1138 .NOP Variable 1139 Description 1140 .br 1141 .ns 1142 .TP 10 1143 .NOP \f\*[B-Font]associd\f[] 1144 association id 1145 .br 1146 .ns 1147 .TP 10 1148 .NOP \f\*[B-Font]status\f[] 1149 .Lk decode.html#peer "peer status word" 1150 .br 1151 .ns 1152 .TP 10 1153 .NOP \f\*[B-Font]srcadr\f[] 1154 source (remote) IP address 1155 .br 1156 .ns 1157 .TP 10 1158 .NOP \f\*[B-Font]srcport\f[] 1159 source (remote) port 1160 .br 1161 .ns 1162 .TP 10 1163 .NOP \f\*[B-Font]dstadr\f[] 1164 destination (local) IP address 1165 .br 1166 .ns 1167 .TP 10 1168 .NOP \f\*[B-Font]dstport\f[] 1169 destination (local) port 1170 .br 1171 .ns 1172 .TP 10 1173 .NOP \f\*[B-Font]leap\f[] 1174 leap indicator (0-3) 1175 .br 1176 .ns 1177 .TP 10 1178 .NOP \f\*[B-Font]stratum\f[] 1179 stratum (0-15) 1180 .br 1181 .ns 1182 .TP 10 1183 .NOP \f\*[B-Font]precision\f[] 1184 precision (log2 s) 1185 .br 1186 .ns 1187 .TP 10 1188 .NOP \f\*[B-Font]rootdelay\f[] 1189 total roundtrip delay to the primary reference clock 1190 .br 1191 .ns 1192 .TP 10 1193 .NOP \f\*[B-Font]rootdisp\f[] 1194 total root dispersion to the primary reference clock 1195 .br 1196 .ns 1197 .TP 10 1198 .NOP \f\*[B-Font]refid\f[] 1199 reference id or 1200 .Lk decode.html#kiss "kiss code" 1201 .br 1202 .ns 1203 .TP 10 1204 .NOP \f\*[B-Font]reftime\f[] 1205 reference time 1206 .br 1207 .ns 1208 .TP 10 1209 .NOP \f\*[B-Font]rec\f[] 1210 last packet received time 1211 .br 1212 .ns 1213 .TP 10 1214 .NOP \f\*[B-Font]reach\f[] 1215 reach register (octal) 1216 .br 1217 .ns 1218 .TP 10 1219 .NOP \f\*[B-Font]unreach\f[] 1220 unreach counter 1221 .br 1222 .ns 1223 .TP 10 1224 .NOP \f\*[B-Font]hmode\f[] 1225 host mode (1-6) 1226 .br 1227 .ns 1228 .TP 10 1229 .NOP \f\*[B-Font]pmode\f[] 1230 peer mode (1-5) 1231 .br 1232 .ns 1233 .TP 10 1234 .NOP \f\*[B-Font]hpoll\f[] 1235 host poll exponent (log2 s) (3-17) 1236 .br 1237 .ns 1238 .TP 10 1239 .NOP \f\*[B-Font]ppoll\f[] 1240 peer poll exponent (log2 s) (3-17) 1241 .br 1242 .ns 1243 .TP 10 1244 .NOP \f\*[B-Font]headway\f[] 1245 headway (see 1246 .Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) 1247 .br 1248 .ns 1249 .TP 10 1250 .NOP \f\*[B-Font]flash\f[] 1251 .Lk decode.html#flash "flash status word" 1252 .br 1253 .ns 1254 .TP 10 1255 .NOP \f\*[B-Font]keyid\f[] 1256 symmetric key id 1257 .br 1258 .ns 1259 .TP 10 1260 .NOP \f\*[B-Font]offset\f[] 1261 filter offset 1262 .br 1263 .ns 1264 .TP 10 1265 .NOP \f\*[B-Font]delay\f[] 1266 filter delay 1267 .br 1268 .ns 1269 .TP 10 1270 .NOP \f\*[B-Font]dispersion\f[] 1271 filter dispersion 1272 .br 1273 .ns 1274 .TP 10 1275 .NOP \f\*[B-Font]jitter\f[] 1276 filter jitter 1277 .br 1278 .ns 1279 .TP 10 1280 .NOP \f\*[B-Font]bias\f[] 1281 unicast/broadcast bias 1282 .br 1283 .ns 1284 .TP 10 1285 .NOP \f\*[B-Font]xleave\f[] 1286 interleave delay (see 1287 .Lk xleave.html "NTP Interleaved Modes" ) 1288 .PP 1289 The 1290 \f\*[B-Font]bias\f[] 1291 variable is calculated when the first broadcast packet is received 1292 after the calibration volley. 1293 It represents the offset of the broadcast subgraph relative to the 1294 unicast subgraph. 1295 The 1296 \f\*[B-Font]xleave\f[] 1297 variable appears only for the interleaved symmetric and interleaved modes. 1298 It represents the internal queuing, buffering and transmission delays 1299 for the preceding packet. 1300 .sp \n(Ppu 1301 .ne 2 1302 1303 When the NTPv4 daemon is compiled with the OpenSSL software library, 1304 additional peer variables are displayed, including the following: 1305 .TP 10 1306 .NOP Variable 1307 Description 1308 .br 1309 .ns 1310 .TP 10 1311 .NOP \f\*[B-Font]flags\f[] 1312 peer flags (see Autokey specification) 1313 .br 1314 .ns 1315 .TP 10 1316 .NOP \f\*[B-Font]host\f[] 1317 Autokey server name 1318 .br 1319 .ns 1320 .TP 10 1321 .NOP \f\*[B-Font]flags\f[] 1322 peer flags (see Autokey specification) 1323 .br 1324 .ns 1325 .TP 10 1326 .NOP \f\*[B-Font]signature\f[] 1327 OpenSSL digest/signature scheme 1328 .br 1329 .ns 1330 .TP 10 1331 .NOP \f\*[B-Font]initsequence\f[] 1332 initial key id 1333 .br 1334 .ns 1335 .TP 10 1336 .NOP \f\*[B-Font]initkey\f[] 1337 initial key index 1338 .br 1339 .ns 1340 .TP 10 1341 .NOP \f\*[B-Font]timestamp\f[] 1342 Autokey signature timestamp 1343 .br 1344 .ns 1345 .TP 10 1346 .NOP \f\*[B-Font]ident\f[] 1347 Autokey group name for this association 1348 .PP 1349 .SS Clock Variables 1350 The following clock variables appear in the 1351 \f\*[B-Font]clocklist\f[] 1352 billboard for each association with a reference clock. 1353 Not all variables are displayed in some configurations. 1354 .TP 10 1355 .NOP Variable 1356 Description 1357 .br 1358 .ns 1359 .TP 10 1360 .NOP \f\*[B-Font]associd\f[] 1361 association id 1362 .br 1363 .ns 1364 .TP 10 1365 .NOP \f\*[B-Font]status\f[] 1366 .Lk decode.html#clock "clock status word" 1367 .br 1368 .ns 1369 .TP 10 1370 .NOP \f\*[B-Font]device\f[] 1371 device description 1372 .br 1373 .ns 1374 .TP 10 1375 .NOP \f\*[B-Font]timecode\f[] 1376 ASCII time code string (specific to device) 1377 .br 1378 .ns 1379 .TP 10 1380 .NOP \f\*[B-Font]poll\f[] 1381 poll messages sent 1382 .br 1383 .ns 1384 .TP 10 1385 .NOP \f\*[B-Font]noreply\f[] 1386 no reply 1387 .br 1388 .ns 1389 .TP 10 1390 .NOP \f\*[B-Font]badformat\f[] 1391 bad format 1392 .br 1393 .ns 1394 .TP 10 1395 .NOP \f\*[B-Font]baddata\f[] 1396 bad date or time 1397 .br 1398 .ns 1399 .TP 10 1400 .NOP \f\*[B-Font]fudgetime1\f[] 1401 fudge time 1 1402 .br 1403 .ns 1404 .TP 10 1405 .NOP \f\*[B-Font]fudgetime2\f[] 1406 fudge time 2 1407 .br 1408 .ns 1409 .TP 10 1410 .NOP \f\*[B-Font]stratum\f[] 1411 driver stratum 1412 .br 1413 .ns 1414 .TP 10 1415 .NOP \f\*[B-Font]refid\f[] 1416 driver reference id 1417 .br 1418 .ns 1419 .TP 10 1420 .NOP \f\*[B-Font]flags\f[] 1421 driver flags 1422 .PP 1423 .SH "OPTIONS" 1424 .TP 1425 .NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[] 1426 Force IPv4 name resolution. 1427 This option must not appear in combination with any of the following options: 1428 ipv6. 1429 .sp 1430 Force resolution of following host names on the command line 1431 to the IPv4 namespace. 1432 .TP 1433 .NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[] 1434 Force IPv6 name resolution. 1435 This option must not appear in combination with any of the following options: 1436 ipv4. 1437 .sp 1438 Force resolution of following host names on the command line 1439 to the IPv6 namespace. 1440 .TP 1441 .NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]cmd\f[], \f\*[B-Font]\-\-command\f[]=\f\*[I-Font]cmd\f[] 1442 run a command and exit. 1443 This option may appear an unlimited number of times. 1444 .sp 1445 The following argument is interpreted as an interactive format command 1446 and is added to the list of commands to be executed on the specified 1447 host(s). 1448 .TP 1449 .NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[] 1450 Increase debug verbosity level. 1451 This option may appear an unlimited number of times. 1452 .sp 1453 .TP 1454 .NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[] 1455 Set the debug verbosity level. 1456 This option may appear an unlimited number of times. 1457 This option takes an integer number as its argument. 1458 .sp 1459 .TP 1460 .NOP \f\*[B-Font]\-i\f[], \f\*[B-Font]\-\-interactive\f[] 1461 Force ntpq to operate in interactive mode. 1462 This option must not appear in combination with any of the following options: 1463 command, peers. 1464 .sp 1465 Force \fBntpq\fP to operate in interactive mode. 1466 Prompts will be written to the standard output and 1467 commands read from the standard input. 1468 .TP 1469 .NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[] 1470 numeric host addresses. 1471 .sp 1472 Output all host addresses in dotted-quad numeric format rather than 1473 converting to the canonical host names. 1474 .TP 1475 .NOP \f\*[B-Font]\-\-old\-rv\f[] 1476 Always output status line with readvar. 1477 .sp 1478 By default, \fBntpq\fP now suppresses the \fBassocid=...\fP 1479 line that precedes the output of \fBreadvar\fP 1480 (alias \fBrv\fP) when a single variable is requested, such as 1481 \fBntpq \-c "rv 0 offset"\fP. 1482 This option causes \fBntpq\fP to include both lines of output 1483 for a single-variable \fBreadvar\fP. 1484 Using an environment variable to 1485 preset this option in a script will enable both older and 1486 newer \fBntpq\fP to behave identically in this regard. 1487 .TP 1488 .NOP \f\*[B-Font]\-p\f[], \f\*[B-Font]\-\-peers\f[] 1489 Print a list of the peers. 1490 This option must not appear in combination with any of the following options: 1491 interactive. 1492 .sp 1493 Print a list of the peers known to the server as well as a summary 1494 of their state. This is equivalent to the 'peers' interactive command. 1495 .TP 1496 .NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]keyword\f[], \f\*[B-Font]\-\-refid\f[]=\f\*[I-Font]keyword\f[] 1497 Set default display type for S2+ refids. 1498 This option takes a keyword as its argument. The argument sets an enumeration value that can 1499 be tested by comparing them against the option value macro. 1500 The available keywords are: 1501 .in +4 1502 .nf 1503 .na 1504 hash ipv4 1505 .fi 1506 or their numeric equivalent. 1507 .in -4 1508 .sp 1509 The default 1510 \f\*[I-Font]keyword\f[] 1511 for this option is: 1512 .ti +4 1513 ipv4 1514 .sp 1515 Set the default display format for S2+ refids. 1516 .TP 1517 .NOP \f\*[B-Font]\-w\f[], \f\*[B-Font]\-\-wide\f[] 1518 Display the full 'remote' value. 1519 .sp 1520 Display the full value of the 'remote' value. If this requires 1521 more than 15 characters, display the full value, emit a newline, 1522 and continue the data display properly indented on the next line. 1523 .TP 1524 .NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 1525 Display usage information and exit. 1526 .TP 1527 .NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 1528 Pass the extended usage information through a pager. 1529 .TP 1530 .NOP \f\*[B-Font]\->\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]] 1531 Save the option state to \fIcfgfile\fP. The default is the \fIlast\fP 1532 configuration file listed in the \fBOPTION PRESETS\fP section, below. 1533 The command will exit after updating the config file. 1534 .TP 1535 .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[] 1536 Load options from \fIcfgfile\fP. 1537 The \fIno-load-opts\fP form will disable the loading 1538 of earlier config/rc/ini files. \fI\-\-no-load-opts\fP is handled early, 1539 out of order. 1540 .TP 1541 .NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}] 1542 Output version of program and exit. The default mode is `v', a simple 1543 version. The `c' mode will print copyright information and `n' will 1544 print the full copyright notice. 1545 .PP 1546 .SH "OPTION PRESETS" 1547 Any option that is not marked as \fInot presettable\fP may be preset 1548 by loading values from configuration ("RC" or ".INI") file(s) and values from 1549 environment variables named: 1550 .nf 1551 \fBNTPQ_<option-name>\fP or \fBNTPQ\fP 1552 .fi 1553 .ad 1554 The environmental presets take precedence (are processed later than) 1555 the configuration files. 1556 The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP". 1557 If any of these are directories, then the file \fI.ntprc\fP 1558 is searched for within those directories. 1559 .SH "ENVIRONMENT" 1560 See \fBOPTION PRESETS\fP for configuration environment variables. 1561 .SH "FILES" 1562 See \fBOPTION PRESETS\fP for configuration files. 1563 .SH "EXIT STATUS" 1564 One of the following exit values will be returned: 1565 .TP 1566 .NOP 0 " (EXIT_SUCCESS)" 1567 Successful program execution. 1568 .TP 1569 .NOP 1 " (EXIT_FAILURE)" 1570 The operation failed or the command syntax was not valid. 1571 .TP 1572 .NOP 66 " (EX_NOINPUT)" 1573 A specified configuration file could not be loaded. 1574 .TP 1575 .NOP 70 " (EX_SOFTWARE)" 1576 libopts had an internal operational error. Please report 1577 it to autogen-users@lists.sourceforge.net. Thank you. 1578 .PP 1579 .SH "AUTHORS" 1580 The University of Delaware and Network Time Foundation 1581 .SH "COPYRIGHT" 1582 Copyright (C) 1992-2020 The University of Delaware and Network Time Foundation all rights reserved. 1583 This program is released under the terms of the NTP license, <http://ntp.org/license>. 1584 .SH "BUGS" 1585 Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org 1586 .SH "NOTES" 1587 This manual page was \fIAutoGen\fP-erated from the \fBntpq\fP 1588 option definitions.