1275970Scy.de1 NOP 2275970Scy. it 1 an-trap 3275970Scy. if \\n[.$] \,\\$*\/ 4275970Scy.. 5275970Scy.ie t \ 6275970Scy.ds B-Font [CB] 7275970Scy.ds I-Font [CI] 8275970Scy.ds R-Font [CR] 9275970Scy.el \ 10275970Scy.ds B-Font B 11275970Scy.ds I-Font I 12275970Scy.ds R-Font R 13310419Sdelphij.TH ntpq 1ntpqman "21 Nov 2016" "4.2.8p9" "User Commands" 14275970Scy.\" 15310419Sdelphij.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-nWaWmk/ag-AWaOlk) 16275970Scy.\" 17310419Sdelphij.\" It has been AutoGen-ed November 21, 2016 at 08:03:02 AM by AutoGen 5.18.5 18275970Scy.\" From the definitions ntpq-opts.def 19275970Scy.\" and the template file agman-cmd.tpl 20275970Scy.SH NAME 21275970Scy\f\*[B-Font]ntpq\fP 22275970Scy\- standard NTP query program 23275970Scy.SH SYNOPSIS 24275970Scy\f\*[B-Font]ntpq\fP 25275970Scy.\" Mixture of short (flag) options and long options 26275970Scy[\f\*[B-Font]\-flags\f[]] 27275970Scy[\f\*[B-Font]\-flag\f[] [\f\*[I-Font]value\f[]]] 28275970Scy[\f\*[B-Font]\-\-option-name\f[][[=| ]\f\*[I-Font]value\f[]]] 29275970Scy[ host ...] 30275970Scy.sp \n(Ppu 31275970Scy.ne 2 32275970Scy 33275970Scy.SH DESCRIPTION 34275970ScyThe 35275970Scy\f\*[B-Font]ntpq\fP 36275970Scyutility program is used to query NTP servers which 37275970Scyimplement the standard NTP mode 6 control message formats defined 38275970Scyin Appendix B of the NTPv3 specification RFC1305, requesting 39275970Scyinformation about current state and/or changes in that state. 40275970ScyThe same formats are used in NTPv4, although some of the 41275970Scyvariables have changed and new ones added. The description on this 42275970Scypage is for the NTPv4 variables. 43275970ScyThe program may be run either in interactive mode or controlled using 44275970Scycommand line arguments. 45275970ScyRequests to read and write arbitrary 46275970Scyvariables can be assembled, with raw and pretty-printed output 47275970Scyoptions being available. 48275970ScyThe 49275970Scy\f\*[B-Font]ntpq\fP 50275970Scyutility can also obtain and print a 51275970Scylist of peers in a common format by sending multiple queries to the 52275970Scyserver. 53275970ScyIf one or more request options is included on the command line 54275970Scywhen 55275970Scy\f\*[B-Font]ntpq\fP 56275970Scyis executed, each of the requests will be sent 57275970Scyto the NTP servers running on each of the hosts given as command 58275970Scyline arguments, or on localhost by default. 59275970ScyIf no request options 60275970Scyare given, 61275970Scy\f\*[B-Font]ntpq\fP 62275970Scywill attempt to read commands from the 63275970Scystandard input and execute these on the NTP server running on the 64275970Scyfirst host given on the command line, again defaulting to localhost 65275970Scywhen no other host is specified. 66275970ScyThe 67275970Scy\f\*[B-Font]ntpq\fP 68275970Scyutility will prompt for 69275970Scycommands if the standard input is a terminal device. 70275970Scy\f\*[B-Font]ntpq\fP 71275970Scyuses NTP mode 6 packets to communicate with the 72275970ScyNTP server, and hence can be used to query any compatible server on 73275970Scythe network which permits it. 74275970ScyNote that since NTP is a UDP protocol 75275970Scythis communication will be somewhat unreliable, especially over 76275970Scylarge distances in terms of network topology. 77275970ScyThe 78275970Scy\f\*[B-Font]ntpq\fP 79275970Scyutility makes 80275970Scyone attempt to retransmit requests, and will time requests out if 81275970Scythe remote host is not heard from within a suitable timeout 82275970Scytime. 83275970ScySpecifying a 84275970Scycommand line option other than 85275970Scy\f\*[B-Font]\-i\f[] 86275970Scyor 87275970Scy\f\*[B-Font]\-n\f[] 88275970Scywill 89275970Scycause the specified query (queries) to be sent to the indicated 90275970Scyhost(s) immediately. 91275970ScyOtherwise, 92275970Scy\f\*[B-Font]ntpq\fP 93275970Scywill attempt to read 94275970Scyinteractive format commands from the standard input. 95275970Scy.SS "Internal Commands" 96275970ScyInteractive format commands consist of a keyword followed by zero 97275970Scyto four arguments. 98275970ScyOnly enough characters of the full keyword to 99275970Scyuniquely identify the command need be typed. 100275970ScyA 101275970Scynumber of interactive format commands are executed entirely within 102275970Scythe 103275970Scy\f\*[B-Font]ntpq\fP 104275970Scyutility itself and do not result in NTP mode 6 105275970Scyrequests being sent to a server. 106275970ScyThese are described following. 107275970Scy.TP 20 108275970Scy.NOP \f\*[B-Font]?\f[] [\f\*[I-Font]command_keyword\f[]] 109275970Scy.br 110275970Scy.ns 111275970Scy.TP 20 112275970Scy.NOP \f\*[B-Font]help\f[] [\f\*[I-Font]command_keyword\f[]] 113275970ScyA 114275970Scy\[oq]\&?\[cq] 115275970Scyby itself will print a list of all the command 116275970Scykeywords known to this incarnation of 117275970Scy\f\*[B-Font]ntpq\fP. 118275970ScyA 119275970Scy\[oq]\&?\[cq] 120275970Scyfollowed by a command keyword will print function and usage 121275970Scyinformation about the command. 122275970ScyThis command is probably a better 123275970Scysource of information about 124275970Scy\f\*[B-Font]ntpq\fP 125275970Scythan this manual 126275970Scypage. 127275970Scy.br 128275970Scy.ns 129275970Scy.TP 20 130275970Scy.NOP \f\*[B-Font]addvars\f[] \f\*[I-Font]variable_name\f[][\f\*[B-Font]=value\f[]] \f\*[B-Font]...\f[] 131275970Scy.br 132275970Scy.ns 133275970Scy.TP 20 134275970Scy.NOP \f\*[B-Font]rmvars\f[] \f\*[I-Font]variable_name\f[] \f\*[B-Font]...\f[] 135275970Scy.br 136275970Scy.ns 137275970Scy.TP 20 138275970Scy.NOP \f\*[B-Font]clearvars\f[] 139275970Scy.br 140275970Scy.ns 141275970Scy.TP 20 142275970Scy.NOP \f\*[B-Font]showvars\f[] 143275970ScyThe data carried by NTP mode 6 messages consists of a list of 144275970Scyitems of the form 145275970Scy\[oq]variable_name=value\[cq], 146275970Scywhere the 147275970Scy\[oq]=value\[cq] 148275970Scyis ignored, and can be omitted, 149275970Scyin requests to the server to read variables. 150275970ScyThe 151275970Scy\f\*[B-Font]ntpq\fP 152275970Scyutility maintains an internal list in which data to be included in control 153275970Scymessages can be assembled, and sent using the 154275970Scy\f\*[B-Font]readlist\f[] 155275970Scyand 156275970Scy\f\*[B-Font]writelist\f[] 157275970Scycommands described below. 158275970ScyThe 159275970Scy\f\*[B-Font]addvars\f[] 160275970Scycommand allows variables and their optional values to be added to 161275970Scythe list. 162275970ScyIf more than one variable is to be added, the list should 163275970Scybe comma-separated and not contain white space. 164275970ScyThe 165275970Scy\f\*[B-Font]rmvars\f[] 166275970Scycommand can be used to remove individual variables from the list, 167275970Scywhile the 168275970Scy\f\*[B-Font]clearlist\f[] 169275970Scycommand removes all variables from the 170275970Scylist. 171275970ScyThe 172275970Scy\f\*[B-Font]showvars\f[] 173275970Scycommand displays the current list of optional variables. 174275970Scy.br 175275970Scy.ns 176275970Scy.TP 20 177275970Scy.NOP \f\*[B-Font]authenticate\f[] [yes | no] 178275970ScyNormally 179275970Scy\f\*[B-Font]ntpq\fP 180275970Scydoes not authenticate requests unless 181275970Scythey are write requests. 182275970ScyThe command 183275970Scy\[oq]authenticate yes\[cq] 184275970Scycauses 185275970Scy\f\*[B-Font]ntpq\fP 186275970Scyto send authentication with all requests it 187275970Scymakes. 188275970ScyAuthenticated requests causes some servers to handle 189275970Scyrequests slightly differently, and can occasionally melt the CPU in 190275970Scyfuzzballs if you turn authentication on before doing a 191275970Scy\f\*[B-Font]peer\f[] 192275970Scydisplay. 193275970ScyThe command 194275970Scy\[oq]authenticate\[cq] 195275970Scycauses 196275970Scy\f\*[B-Font]ntpq\fP 197275970Scyto display whether or not 198275970Scy\f\*[B-Font]ntpq\fP 199275970Scyis currently autheinticating requests. 200275970Scy.br 201275970Scy.ns 202275970Scy.TP 20 203275970Scy.NOP \f\*[B-Font]cooked\f[] 204275970ScyCauses output from query commands to be "cooked", so that 205275970Scyvariables which are recognized by 206275970Scy\f\*[B-Font]ntpq\fP 207275970Scywill have their 208275970Scyvalues reformatted for human consumption. 209275970ScyVariables which 210275970Scy\f\*[B-Font]ntpq\fP 211275970Scythinks should have a decodable value but didn't are 212275970Scymarked with a trailing 213275970Scy\[oq]\&?\[cq]. 214275970Scy.br 215275970Scy.ns 216275970Scy.TP 20 217275970Scy.NOP \f\*[B-Font]debug\f[] [\f\*[B-Font]more\f[] | \f\*[B-Font]less\f[] | \f\*[B-Font]off\f[]] 218275970ScyWith no argument, displays the current debug level. 219275970ScyOtherwise, the debug level is changed to the indicated level. 220275970Scy.br 221275970Scy.ns 222275970Scy.TP 20 223275970Scy.NOP \f\*[B-Font]delay\f[] \f\*[I-Font]milliseconds\f[] 224275970ScySpecify a time interval to be added to timestamps included in 225275970Scyrequests which require authentication. 226275970ScyThis is used to enable 227275970Scy(unreliable) server reconfiguration over long delay network paths 228275970Scyor between machines whose clocks are unsynchronized. 229275970ScyActually the 230275970Scyserver does not now require timestamps in authenticated requests, 231275970Scyso this command may be obsolete. 232275970Scy.br 233275970Scy.ns 234275970Scy.TP 20 235275970Scy.NOP \f\*[B-Font]exit\f[] 236275970ScyExit 237275970Scy\f\*[B-Font]ntpq\fP. 238275970Scy.br 239275970Scy.ns 240275970Scy.TP 20 241275970Scy.NOP \f\*[B-Font]host\f[] \f\*[I-Font]hostname\f[] 242275970ScySet the host to which future queries will be sent. 243275970Scy\f\*[I-Font]hostname\f[] 244275970Scymay be either a host name or a numeric address. 245275970Scy.br 246275970Scy.ns 247275970Scy.TP 20 248275970Scy.NOP \f\*[B-Font]hostnames\f[] [\f\*[B-Font]yes\f[] | \f\*[B-Font]no\f[]] 249275970ScyIf 250275970Scy\f\*[B-Font]yes\f[] 251275970Scyis specified, host names are printed in 252275970Scyinformation displays. 253275970ScyIf 254275970Scy\f\*[B-Font]no\f[] 255275970Scyis specified, numeric 256275970Scyaddresses are printed instead. 257275970ScyThe default is 258275970Scy\f\*[B-Font]yes\f[], 259275970Scyunless 260275970Scymodified using the command line 261275970Scy\f\*[B-Font]\-n\f[] 262275970Scyswitch. 263275970Scy.br 264275970Scy.ns 265275970Scy.TP 20 266275970Scy.NOP \f\*[B-Font]keyid\f[] \f\*[I-Font]keyid\f[] 267275970ScyThis command allows the specification of a key number to be 268275970Scyused to authenticate configuration requests. 269275970ScyThis must correspond 270290000Sglebiusto the 271290000Sglebius\f\*[B-Font]controlkey\f[] 272290000Sglebiuskey number the server has been configured to use for this 273275970Scypurpose. 274275970Scy.br 275275970Scy.ns 276275970Scy.TP 20 277275970Scy.NOP \f\*[B-Font]keytype\f[] [\f\*[B-Font]md5\f[] | \f\*[B-Font]OpenSSLDigestType\f[]] 278275970ScySpecify the type of key to use for authenticating requests. 279275970Scy\f\*[B-Font]md5\f[] 280275970Scyis alway supported. 281275970ScyIf 282275970Scy\f\*[B-Font]ntpq\fP 283275970Scywas built with OpenSSL support, 284275970Scyany digest type supported by OpenSSL can also be provided. 285275970ScyIf no argument is given, the current 286275970Scy\f\*[B-Font]keytype\f[] 287275970Scyis displayed. 288275970Scy.br 289275970Scy.ns 290275970Scy.TP 20 291275970Scy.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[]] 292275970ScySets the NTP version number which 293275970Scy\f\*[B-Font]ntpq\fP 294275970Scyclaims in 295275970Scypackets. 296275970ScyDefaults to 3, and note that mode 6 control messages (and 297275970Scymodes, for that matter) didn't exist in NTP version 1. 298275970ScyThere appear 299275970Scyto be no servers left which demand version 1. 300275970ScyWith no argument, displays the current NTP version that will be used 301275970Scywhen communicating with servers. 302275970Scy.br 303275970Scy.ns 304275970Scy.TP 20 305275970Scy.NOP \f\*[B-Font]passwd\f[] 306275970ScyThis command prompts you to type in a password (which will not 307275970Scybe echoed) which will be used to authenticate configuration 308275970Scyrequests. 309275970ScyThe password must correspond to the key configured for 310275970Scyuse by the NTP server for this purpose if such requests are to be 311275970Scysuccessful. 312275970Scy.\" Not yet implemented. 313275970Scy.\" .It Ic poll 314275970Scy.\" .Op Ar n 315275970Scy.\" .Op Ic verbose 316275970Scy.\" Poll an NTP server in client mode 317275970Scy.\" .Ar n 318275970Scy.\" times. 319275970Scy.br 320275970Scy.ns 321275970Scy.TP 20 322275970Scy.NOP \f\*[B-Font]quit\f[] 323275970ScyExit 324275970Scy\f\*[B-Font]ntpq\fP. 325275970Scy.br 326275970Scy.ns 327275970Scy.TP 20 328275970Scy.NOP \f\*[B-Font]raw\f[] 329275970ScyCauses all output from query commands is printed as received 330275970Scyfrom the remote server. 331275970ScyThe only formating/interpretation done on 332275970Scythe data is to transform nonascii data into a printable (but barely 333275970Scyunderstandable) form. 334275970Scy.br 335275970Scy.ns 336275970Scy.TP 20 337275970Scy.NOP \f\*[B-Font]timeout\f[] \f\*[I-Font]milliseconds\f[] 338275970ScySpecify a timeout period for responses to server queries. 339275970ScyThe 340275970Scydefault is about 5000 milliseconds. 341275970ScyNote that since 342275970Scy\f\*[B-Font]ntpq\fP 343275970Scyretries each query once after a timeout, the total waiting time for 344275970Scya timeout will be twice the timeout value set. 345275970Scy.br 346275970Scy.ns 347275970Scy.TP 20 348275970Scy.NOP \f\*[B-Font]version\f[] 349275970ScyPrint the version of the 350275970Scy\f\*[B-Font]ntpq\fP 351275970Scyprogram. 352275970Scy.PP 353275970Scy.SS "Control Message Commands" 354275970ScyAssociation IDs are used to identify system, peer and clock variables. 355275970ScySystem variables are assigned an association ID of zero and system name space, while each association is assigned a nonzero association ID and peer namespace. 356275970ScyMost control commands send a single mode-6 message to the server and expect a single response message. 357275970ScyThe exceptions are the 358275970Scy\f[C]peers\f[] 359275970Scycommand, which sends a series of messages, 360275970Scyand the 361275970Scy\f[C]mreadlist\f[] 362275970Scyand 363275970Scy\f[C]mreadvar\f[] 364275970Scycommands, which iterate over a range of associations. 365275970Scy.TP 10 366275970Scy.NOP \f\*[B-Font]associations\f[] 367275970ScyDisplay a list of mobilized associations in the form: 368275970Scy.Dl ind assid status conf reach auth condition last_event cnt 369275970Scy.RS 370275970Scy.IP \fB\(bu\fP 2 371275970Scy.IP \fB\(bu\fP 2 \f[C]ind\f[] \f[C]Ta\f[] \f[C]index\f[] \f[C]on\f[] \f[C]this\f[] \f[C]list\f[] 372275970Scy.IP \fB\(bu\fP 2 \f[C]assid\f[] \f[C]Ta\f[] \f[C]association\f[] \f[C]ID\f[] 373275970Scy.IP \fB\(bu\fP 2 \f[C]status\f[] \f[C]Ta\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word\f[] 374275970Scy.IP \fB\(bu\fP 2 \f[C]conf\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]persistent,\f[] \f[C]no\f[]: \f[C]ephemeral\f[] 375275970Scy.IP \fB\(bu\fP 2 \f[C]reach\f[] \f[C]Ta\f[] \f[C]yes\f[]: \f[C]reachable,\f[] \f[C]no\f[]: \f[C]unreachable\f[] 376275970Scy.IP \fB\(bu\fP 2 \f[C]auth\f[] \f[C]Ta\f[] \f[C]ok\f[], \f[C]yes\f[], \f[C]bad\f[] \f[C]and\f[] \f[C]none\f[] 377275970Scy.IP \fB\(bu\fP 2 \f[C]condition\f[] \f[C]Ta\f[] \f[C]selection\f[] \f[C]status\f[] \f[C](see\f[] \f[C]the\f[] \f[C]select\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] 378275970Scy.IP \fB\(bu\fP 2 \f[C]last_event\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]report\f[] \f[C](see\f[] \f[C]the\f[] \f[C]event\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] 379275970Scy.IP \fB\(bu\fP 2 \f[C]cnt\f[] \f[C]Ta\f[] \f[C]event\f[] \f[C]count\f[] \f[C](see\f[] \f[C]the\f[] \f[C]count\f[] \f[C]field\f[] \f[C]of\f[] \f[C]the\f[] \f[C]peer\f[] \f[C]status\f[] \f[C]word)\f[] 380275970Scy.RE 381275970Scy.br 382275970Scy.ns 383275970Scy.TP 10 384275970Scy.NOP \f\*[B-Font]authinfo\f[] 385275970ScyDisplay the authentication statistics. 386275970Scy.br 387275970Scy.ns 388275970Scy.TP 10 389275970Scy.NOP \f\*[B-Font]clockvar\f[] \f\*[I-Font]assocID\f[] [\f\*[I-Font]name\f[][\f\*[B-Font]=\f[]\f\*[I-Font]value\f[]] [] ...] 390275970Scy.br 391275970Scy.ns 392275970Scy.TP 10 393275970Scy.NOP \f\*[B-Font]cv\f[] \f\*[I-Font]assocID\f[] [\f\*[I-Font]name\f[][\f\*[B-Font]=\f[]\f\*[I-Font]value\f[]] [] ...] 394275970ScyDisplay a list of clock variables for those associations supporting a reference clock. 395275970Scy.br 396275970Scy.ns 397275970Scy.TP 10 398275970Scy.NOP \f\*[B-Font]:config\f[] [...] 399275970ScySend 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. 400275970Scy.br 401275970Scy.ns 402275970Scy.TP 10 403275970Scy.NOP \f\*[B-Font]config-from-file\f[] \f\*[I-Font]filename\f[] 404275970ScySend the each line of 405275970Scy\f\*[I-Font]filename\f[] 406275970Scyto 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. 407275970Scy.br 408275970Scy.ns 409275970Scy.TP 10 410275970Scy.NOP \f\*[B-Font]ifstats\f[] 411275970ScyDisplay statistics for each local network address. Authentication is required. 412275970Scy.br 413275970Scy.ns 414275970Scy.TP 10 415275970Scy.NOP \f\*[B-Font]iostats\f[] 416275970ScyDisplay network and reference clock I/O statistics. 417275970Scy.br 418275970Scy.ns 419275970Scy.TP 10 420275970Scy.NOP \f\*[B-Font]kerninfo\f[] 421275970ScyDisplay 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. 422275970Scy.br 423275970Scy.ns 424275970Scy.TP 10 425275970Scy.NOP \f\*[B-Font]lassociations\f[] 426275970ScyPerform the same function as the associations command, except display mobilized and unmobilized associations. 427275970Scy.br 428275970Scy.ns 429275970Scy.TP 10 430275970Scy.NOP \f\*[B-Font]lopeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] 431275970ScyObtain and print a list of all peers and clients showing 432275970Scy\f\*[I-Font]dstadr\f[] 433275970Scy(associated with any given IP version). 434275970Scy.br 435275970Scy.ns 436275970Scy.TP 10 437275970Scy.NOP \f\*[B-Font]lpeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] 438275970ScyPrint a peer spreadsheet for the appropriate IP version(s). 439275970Scy\f\*[I-Font]dstadr\f[] 440275970Scy(associated with any given IP version). 441275970Scy.br 442275970Scy.ns 443275970Scy.TP 10 444275970Scy.NOP \f\*[B-Font]monstats\f[] 445275970ScyDisplay monitor facility statistics. 446275970Scy.br 447275970Scy.ns 448275970Scy.TP 10 449275970Scy.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[]] 450275970ScyObtain and print traffic counts collected and maintained by the monitor facility. 451275970ScyWith the exception of 452275970Scy\f\*[B-Font]sort\f[]=\f\*[I-Font]sortorder\f[], 453275970Scythe options filter the list returned by 454275970Scy\f\*[B-Font]ntpd.\f[] 455275970ScyThe 456275970Scy\f\*[B-Font]limited\f[] 457275970Scyand 458275970Scy\f\*[B-Font]kod\f[] 459275970Scyoptions return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response. 460275970ScyThe 461275970Scy\f\*[B-Font]mincount\f[]=\f\*[I-Font]count\f[] 462275970Scyoption filters entries representing less than 463275970Scy\f\*[I-Font]count\f[] 464275970Scypackets. 465275970ScyThe 466275970Scy\f\*[B-Font]laddr\f[]=\f\*[I-Font]localaddr\f[] 467275970Scyoption filters entries for packets received on any local address other than 468275970Scy\f\*[I-Font]localaddr\f[]. 469275970Scy\f\*[B-Font]resany\f[]=\f\*[I-Font]hexmask\f[] 470275970Scyand 471275970Scy\f\*[B-Font]resall\f[]=\f\*[I-Font]hexmask\f[] 472275970Scyfilter entries containing none or less than all, respectively, of the bits in 473275970Scy\f\*[I-Font]hexmask\f[], 474275970Scywhich must begin with 475275970Scy\f\*[B-Font]0x\f[]. 476275970ScyThe 477275970Scy\f\*[I-Font]sortorder\f[] 478275970Scydefaults to 479275970Scy\f\*[B-Font]lstint\f[] 480275970Scyand may be any of 481275970Scy\f\*[B-Font]addr\f[], 482275970Scy\f\*[B-Font]count\f[], 483275970Scy\f\*[B-Font]avgint\f[], 484275970Scy\f\*[B-Font]lstint\f[], 485275970Scyor any of those preceded by a minus sign (hyphen) to reverse the sort order. 486275970ScyThe output columns are: 487275970Scy.RS 488275970Scy.TP 10 489275970Scy.NOP Column 490275970ScyDescription 491275970Scy.br 492275970Scy.ns 493275970Scy.TP 10 494275970Scy.NOP \f\*[B-Font]lstint\f[] 495275970ScyInterval in s between the receipt of the most recent packet from this address and the completion of the retrieval of the MRU list by 496275970Scy\f\*[B-Font]ntpq\fP. 497275970Scy.br 498275970Scy.ns 499275970Scy.TP 10 500275970Scy.NOP \f\*[B-Font]avgint\f[] 501275970ScyAverage interval in s between packets from this address. 502275970Scy.br 503275970Scy.ns 504275970Scy.TP 10 505275970Scy.NOP \f\*[B-Font]rstr\f[] 506275970ScyRestriction flags associated with this address. 507275970ScyMost are copied unchanged from the matching 508275970Scy\f\*[B-Font]restrict\f[] 509275970Scycommand, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this address triggered a rate control response. 510275970Scy.br 511275970Scy.ns 512275970Scy.TP 10 513275970Scy.NOP \f\*[B-Font]r\f[] 514275970ScyRate control indicator, either 515275970Scya period, 516275970Scy\f\*[B-Font]L\f[] 517275970Scyor 518275970Scy\f\*[B-Font]K\f[] 519275970Scyfor no rate control response, 520275970Scyrate limiting by discarding, or rate limiting with a KoD response, respectively. 521275970Scy.br 522275970Scy.ns 523275970Scy.TP 10 524275970Scy.NOP \f\*[B-Font]m\f[] 525275970ScyPacket mode. 526275970Scy.br 527275970Scy.ns 528275970Scy.TP 10 529275970Scy.NOP \f\*[B-Font]v\f[] 530275970ScyPacket version number. 531275970Scy.br 532275970Scy.ns 533275970Scy.TP 10 534275970Scy.NOP \f\*[B-Font]count\f[] 535275970ScyPackets received from this address. 536275970Scy.br 537275970Scy.ns 538275970Scy.TP 10 539275970Scy.NOP \f\*[B-Font]rport\f[] 540275970ScySource port of last packet from this address. 541275970Scy.br 542275970Scy.ns 543275970Scy.TP 10 544275970Scy.NOP \f\*[B-Font]remote\f[] \f\*[B-Font]address\f[] 545275970ScyDNS name, numeric address, or address followed by 546275970Scyclaimed DNS name which could not be verified in parentheses. 547275970Scy.RE 548275970Scy.br 549275970Scy.ns 550275970Scy.TP 10 551275970Scy.NOP \f\*[B-Font]mreadvar\f[] \f\*[B-Font]assocID\f[] \f\*[B-Font]assocID\f[] [\f\*[I-Font]variable_name\f[][=\f\*[I-Font]value\f[]]] ... 552275970Scy.br 553275970Scy.ns 554275970Scy.TP 10 555275970Scy.NOP \f\*[B-Font]mrv\f[] \f\*[B-Font]assocID\f[] \f\*[B-Font]assocID\f[] [\f\*[I-Font]variable_name\f[][=\f\*[I-Font]value\f[]]] ... 556275970ScyPerform the same function as the 557275970Scy\f\*[B-Font]readvar\f[] 558275970Scycommand, except for a range of association IDs. 559275970ScyThis range is determined from the association list cached by the most recent 560275970Scy\f\*[B-Font]associations\f[] 561275970Scycommand. 562275970Scy.br 563275970Scy.ns 564275970Scy.TP 10 565275970Scy.NOP \f\*[B-Font]opeers\f[] [\f\*[B-Font]\-4\f[] | \f\*[B-Font]\-6\f[]] 566275970ScyObtain and print the old-style list of all peers and clients showing 567275970Scy\f\*[I-Font]dstadr\f[] 568275970Scy(associated with any given IP version), 569275970Scyrather than the 570275970Scy\f\*[I-Font]refid\f[]. 571275970Scy.br 572275970Scy.ns 573275970Scy.TP 10 574275970Scy.NOP \f\*[B-Font]passociations\f[] 575275970ScyPerform the same function as the 576275970Scy\f\*[B-Font]associations\f[] 577275970Scycommand, 578275970Scyexcept that it uses previously stored data rather than making a new query. 579275970Scy.br 580275970Scy.ns 581275970Scy.TP 10 582275970Scy.NOP \f\*[B-Font]peers\f[] 583275970ScyDisplay a list of peers in the form: 584275970Scy.Dl [tally]remote refid st t when pool reach delay offset jitter 585275970Scy.RS 586275970Scy.TP 10 587275970Scy.NOP Variable 588275970ScyDescription 589275970Scy.br 590275970Scy.ns 591275970Scy.TP 10 592275970Scy.NOP \f\*[B-Font][tally]\f[] 593275970Scysingle-character code indicating current value of the 594275970Scy\f\*[B-Font]select\f[] 595275970Scyfield of the 596275970Scy.Lk decode.html#peer "peer status word" 597275970Scy.br 598275970Scy.ns 599275970Scy.TP 10 600275970Scy.NOP \f\*[B-Font]remote\f[] 601275970Scyhost name (or IP number) of peer. 602275970ScyThe value displayed will be truncated to 15 characters unless the 603275970Scy\f\*[B-Font]\-w\f[] 604275970Scyflag is given, in which case the full value will be displayed 605275970Scyon the first line, 606275970Scyand the remaining data is displayed on the next line. 607275970Scy.br 608275970Scy.ns 609275970Scy.TP 10 610275970Scy.NOP \f\*[B-Font]refid\f[] 611275970Scyassociation ID or 612275970Scy.Lk decode.html#kiss "'kiss code" 613275970Scy.br 614275970Scy.ns 615275970Scy.TP 10 616275970Scy.NOP \f\*[B-Font]st\f[] 617275970Scystratum 618275970Scy.br 619275970Scy.ns 620275970Scy.TP 10 621275970Scy.NOP \f\*[B-Font]t\f[] 622275970Scy\f\*[B-Font]u\f[]: 623275970Scyunicast or manycast client, 624275970Scy\f\*[B-Font]b\f[]: 625275970Scybroadcast or multicast client, 626275970Scy\f\*[B-Font]l\f[]: 627275970Scylocal (reference clock), 628275970Scy\f\*[B-Font]s\f[]: 629275970Scysymmetric (peer), 630275970Scy\f\*[B-Font]A\f[]: 631275970Scymanycast server, 632275970Scy\f\*[B-Font]B\f[]: 633275970Scybroadcast server, 634275970Scy\f\*[B-Font]M\f[]: 635275970Scymulticast server 636275970Scy.br 637275970Scy.ns 638275970Scy.TP 10 639275970Scy.NOP \f\*[B-Font]when\f[] 640275970Scysec/min/hr since last received packet 641275970Scy.br 642275970Scy.ns 643275970Scy.TP 10 644275970Scy.NOP \f\*[B-Font]poll\f[] 645275970Scypoll interval (log2 s) 646275970Scy.br 647275970Scy.ns 648275970Scy.TP 10 649275970Scy.NOP \f\*[B-Font]reach\f[] 650275970Scyreach shift register (octal) 651275970Scy.br 652275970Scy.ns 653275970Scy.TP 10 654275970Scy.NOP \f\*[B-Font]delay\f[] 655275970Scyroundtrip delay 656275970Scy.br 657275970Scy.ns 658275970Scy.TP 10 659275970Scy.NOP \f\*[B-Font]offset\f[] 660275970Scyoffset of server relative to this host 661275970Scy.br 662275970Scy.ns 663275970Scy.TP 10 664275970Scy.NOP \f\*[B-Font]jitter\f[] 665275970Scyjitter 666275970Scy.RE 667275970Scy.br 668275970Scy.ns 669275970Scy.TP 10 670290000Sglebius.NOP \f\*[B-Font]apeers\f[] 671290000SglebiusDisplay a list of peers in the form: 672290000Sglebius.Dl [tally]remote refid assid st t when pool reach delay offset jitter 673290000Sglebiuswhere the output is just like the 674290000Sglebius\f\*[B-Font]peers\f[] 675290000Sglebiuscommand except that the 676290000Sglebius\f\*[B-Font]refid\f[] 677290000Sglebiusis displayed in hex format and the association number is also displayed. 678290000Sglebius.br 679290000Sglebius.ns 680290000Sglebius.TP 10 681275970Scy.NOP \f\*[B-Font]pstats\f[] \f\*[I-Font]assocID\f[] 682275970ScyShow the statistics for the peer with the given 683275970Scy\f\*[I-Font]assocID\f[]. 684275970Scy.br 685275970Scy.ns 686275970Scy.TP 10 687275970Scy.NOP \f\*[B-Font]readlist\f[] \f\*[I-Font]assocID\f[] 688275970Scy.br 689275970Scy.ns 690275970Scy.TP 10 691275970Scy.NOP \f\*[B-Font]rl\f[] \f\*[I-Font]assocID\f[] 692275970ScyRead the system or peer variables included in the variable list. 693275970Scy.br 694275970Scy.ns 695275970Scy.TP 10 696275970Scy.NOP \f\*[B-Font]readvar\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...] 697275970Scy.br 698275970Scy.ns 699275970Scy.TP 10 700275970Scy.NOP \f\*[B-Font]rv\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[][=\f\*[I-Font]value\f[]] [, ...] 701275970ScyDisplay the specified variables. 702275970ScyIf 703275970Scy\f\*[I-Font]assocID\f[] 704275970Scyis zero, the variables are from the 705275970Scy\fISystem\f[] \fIVariables\f[] 706275970Scyname space, otherwise they are from the 707275970Scy\fIPeer\f[] \fIVariables\f[] 708275970Scyname space. 709275970ScyThe 710275970Scy\f\*[I-Font]assocID\f[] 711275970Scyis required, as the same name can occur in both spaces. 712275970ScyIf no 713275970Scy\f\*[I-Font]name\f[] 714275970Scyis included, all operative variables in the name space are displayed. 715275970ScyIn this case only, if the 716275970Scy\f\*[I-Font]assocID\f[] 717275970Scyis omitted, it is assumed zero. 718275970ScyMultiple names are specified with comma separators and without whitespace. 719275970ScyNote that time values are represented in milliseconds 720275970Scyand frequency values in parts-per-million (PPM). 721275970ScySome NTP timestamps are represented in the format 722275970ScyYYYYMMDDTTTT , 723275970Scywhere YYYY is the year, 724275970ScyMM the month of year, 725275970ScyDD the day of month and 726275970ScyTTTT the time of day. 727275970Scy.br 728275970Scy.ns 729275970Scy.TP 10 730275970Scy.NOP \f\*[B-Font]reslist\f[] 731275970ScyShow the access control (restrict) list for 732275970Scy\f\*[B-Font]ntpq\fP. 733275970Scy.br 734275970Scy.ns 735275970Scy.TP 10 736275970Scy.NOP \f\*[B-Font]saveconfig\f[] \f\*[I-Font]filename\f[] 737275970ScyWrite the current configuration, 738275970Scyincluding any runtime modifications given with 739275970Scy\f\*[B-Font]:config\f[] 740275970Scyor 741275970Scy\f\*[B-Font]config-from-file\f[], 742275970Scyto the ntpd host's file 743275970Scy\f\*[I-Font]filename\f[]. 744275970ScyThis command will be rejected by the server unless 745275970Scy.Lk miscopt.html#saveconfigdir "saveconfigdir" 746275970Scyappears in the 747275970Scy\f\*[B-Font]ntpd\f[] 748275970Scyconfiguration file. 749275970Scy\f\*[I-Font]filename\f[] 750275970Scycan use 751290000Sglebius\fCstrftime\f[]\fR()\f[] 752275970Scyformat specifies to substitute the current date and time, for example, 753275970Scy\f\*[B-Font]q]saveconfig\f[] \f\*[B-Font]ntp-%Y%m%d-%H%M%S.confq]\f[]. 754275970ScyThe filename used is stored in system variable 755275970Scy\f\*[B-Font]savedconfig\f[]. 756275970ScyAuthentication is required. 757275970Scy.br 758275970Scy.ns 759275970Scy.TP 10 760275970Scy.NOP \f\*[B-Font]timerstats\f[] 761275970ScyDisplay interval timer counters. 762275970Scy.br 763275970Scy.ns 764275970Scy.TP 10 765275970Scy.NOP \f\*[B-Font]writelist\f[] \f\*[I-Font]assocID\f[] 766275970ScyWrite the system or peer variables included in the variable list. 767275970Scy.br 768275970Scy.ns 769275970Scy.TP 10 770275970Scy.NOP \f\*[B-Font]writevar\f[] \f\*[I-Font]assocID\f[] \f\*[I-Font]name\f[]=\f\*[I-Font]value\f[] [, ...] 771275970ScyWrite the specified variables. 772275970ScyIf the 773275970Scy\f\*[I-Font]assocID\f[] 774275970Scyis zero, the variables are from the 775275970Scy\fISystem\f[] \fIVariables\f[] 776275970Scyname space, otherwise they are from the 777275970Scy\fIPeer\f[] \fIVariables\f[] 778275970Scyname space. 779275970ScyThe 780275970Scy\f\*[I-Font]assocID\f[] 781275970Scyis required, as the same name can occur in both spaces. 782275970Scy.br 783275970Scy.ns 784275970Scy.TP 10 785275970Scy.NOP \f\*[B-Font]sysinfo\f[] 786275970ScyDisplay operational summary. 787275970Scy.br 788275970Scy.ns 789275970Scy.TP 10 790275970Scy.NOP \f\*[B-Font]sysstats\f[] 791275970ScyPrint statistics counters maintained in the protocol module. 792275970Scy.PP 793275970Scy.SS Status Words and Kiss Codes 794275970ScyThe current state of the operating program is shown 795275970Scyin a set of status words 796275970Scymaintained by the system. 797275970ScyStatus information is also available on a per-association basis. 798275970ScyThese words are displayed in the 799275970Scy\f\*[B-Font]rv\f[] 800275970Scyand 801275970Scy\f\*[B-Font]as\f[] 802275970Scycommands both in hexadecimal and in decoded short tip strings. 803275970ScyThe codes, tips and short explanations are documented on the 804275970Scy.Lk decode.html "Event Messages and Status Words" 805275970Scypage. 806275970ScyThe page also includes a list of system and peer messages, 807275970Scythe code for the latest of which is included in the status word. 808275970Scy.sp \n(Ppu 809275970Scy.ne 2 810275970Scy 811275970ScyInformation resulting from protocol machine state transitions 812275970Scyis displayed using an informal set of ASCII strings called 813275970Scy.Lk decode.html#kiss "kiss codes" . 814275970ScyThe original purpose was for kiss-o'-death (KoD) packets 815275970Scysent by the server to advise the client of an unusual condition. 816275970ScyThey are now displayed, when appropriate, 817275970Scyin the reference identifier field in various billboards. 818275970Scy.SS System Variables 819275970ScyThe following system variables appear in the 820275970Scy\f\*[B-Font]rv\f[] 821275970Scybillboard. 822275970ScyNot all variables are displayed in some configurations. 823275970Scy.TP 10 824275970Scy.NOP Variable 825275970ScyDescription 826275970Scy.br 827275970Scy.ns 828275970Scy.TP 10 829275970Scy.NOP \f\*[B-Font]status\f[] 830275970Scy.Lk decode.html#sys "system status word" 831275970Scy.br 832275970Scy.ns 833275970Scy.TP 10 834275970Scy.NOP \f\*[B-Font]version\f[] 835275970ScyNTP software version and build time 836275970Scy.br 837275970Scy.ns 838275970Scy.TP 10 839275970Scy.NOP \f\*[B-Font]processor\f[] 840275970Scyhardware platform and version 841275970Scy.br 842275970Scy.ns 843275970Scy.TP 10 844275970Scy.NOP \f\*[B-Font]system\f[] 845275970Scyoperating system and version 846275970Scy.br 847275970Scy.ns 848275970Scy.TP 10 849275970Scy.NOP \f\*[B-Font]leap\f[] 850275970Scyleap warning indicator (0-3) 851275970Scy.br 852275970Scy.ns 853275970Scy.TP 10 854275970Scy.NOP \f\*[B-Font]stratum\f[] 855275970Scystratum (1-15) 856275970Scy.br 857275970Scy.ns 858275970Scy.TP 10 859275970Scy.NOP \f\*[B-Font]precision\f[] 860275970Scyprecision (log2 s) 861275970Scy.br 862275970Scy.ns 863275970Scy.TP 10 864275970Scy.NOP \f\*[B-Font]rootdelay\f[] 865275970Scytotal roundtrip delay to the primary reference clock 866275970Scy.br 867275970Scy.ns 868275970Scy.TP 10 869275970Scy.NOP \f\*[B-Font]rootdisp\f[] 870275970Scytotal dispersion to the primary reference clock 871275970Scy.br 872275970Scy.ns 873275970Scy.TP 10 874275970Scy.NOP \f\*[B-Font]peer\f[] 875275970Scysystem peer association ID 876275970Scy.br 877275970Scy.ns 878275970Scy.TP 10 879275970Scy.NOP \f\*[B-Font]tc\f[] 880275970Scytime constant and poll exponent (log2 s) (3-17) 881275970Scy.br 882275970Scy.ns 883275970Scy.TP 10 884275970Scy.NOP \f\*[B-Font]mintc\f[] 885275970Scyminimum time constant (log2 s) (3-10) 886275970Scy.br 887275970Scy.ns 888275970Scy.TP 10 889275970Scy.NOP \f\*[B-Font]clock\f[] 890275970Scydate and time of day 891275970Scy.br 892275970Scy.ns 893275970Scy.TP 10 894275970Scy.NOP \f\*[B-Font]refid\f[] 895275970Scyreference ID or 896275970Scy.Lk decode.html#kiss "kiss code" 897275970Scy.br 898275970Scy.ns 899275970Scy.TP 10 900275970Scy.NOP \f\*[B-Font]reftime\f[] 901275970Scyreference time 902275970Scy.br 903275970Scy.ns 904275970Scy.TP 10 905275970Scy.NOP \f\*[B-Font]offset\f[] 906275970Scycombined offset of server relative to this host 907275970Scy.br 908275970Scy.ns 909275970Scy.TP 10 910275970Scy.NOP \f\*[B-Font]sys_jitter\f[] 911275970Scycombined system jitter 912275970Scy.br 913275970Scy.ns 914275970Scy.TP 10 915275970Scy.NOP \f\*[B-Font]frequency\f[] 916275970Scyfrequency offset (PPM) relative to hardware clock 917275970Scy.br 918275970Scy.ns 919275970Scy.TP 10 920275970Scy.NOP \f\*[B-Font]clk_wander\f[] 921275970Scyclock frequency wander (PPM) 922275970Scy.br 923275970Scy.ns 924275970Scy.TP 10 925275970Scy.NOP \f\*[B-Font]clk_jitter\f[] 926275970Scyclock jitter 927275970Scy.br 928275970Scy.ns 929275970Scy.TP 10 930275970Scy.NOP \f\*[B-Font]tai\f[] 931275970ScyTAI-UTC offset (s) 932275970Scy.br 933275970Scy.ns 934275970Scy.TP 10 935275970Scy.NOP \f\*[B-Font]leapsec\f[] 936275970ScyNTP seconds when the next leap second is/was inserted 937275970Scy.br 938275970Scy.ns 939275970Scy.TP 10 940275970Scy.NOP \f\*[B-Font]expire\f[] 941275970ScyNTP seconds when the NIST leapseconds file expires 942275970Scy.PP 943275970ScyThe jitter and wander statistics are exponentially-weighted RMS averages. 944275970ScyThe system jitter is defined in the NTPv4 specification; 945275970Scythe clock jitter statistic is computed by the clock discipline module. 946275970Scy.sp \n(Ppu 947275970Scy.ne 2 948275970Scy 949275970ScyWhen the NTPv4 daemon is compiled with the OpenSSL software library, 950275970Scyadditional system variables are displayed, 951275970Scyincluding some or all of the following, 952275970Scydepending on the particular Autokey dance: 953275970Scy.TP 10 954275970Scy.NOP Variable 955275970ScyDescription 956275970Scy.br 957275970Scy.ns 958275970Scy.TP 10 959275970Scy.NOP \f\*[B-Font]host\f[] 960275970ScyAutokey host name for this host 961275970Scy.br 962275970Scy.ns 963275970Scy.TP 10 964275970Scy.NOP \f\*[B-Font]ident\f[] 965275970ScyAutokey group name for this host 966275970Scy.br 967275970Scy.ns 968275970Scy.TP 10 969275970Scy.NOP \f\*[B-Font]flags\f[] 970275970Scyhost flags (see Autokey specification) 971275970Scy.br 972275970Scy.ns 973275970Scy.TP 10 974275970Scy.NOP \f\*[B-Font]digest\f[] 975275970ScyOpenSSL message digest algorithm 976275970Scy.br 977275970Scy.ns 978275970Scy.TP 10 979275970Scy.NOP \f\*[B-Font]signature\f[] 980275970ScyOpenSSL digest/signature scheme 981275970Scy.br 982275970Scy.ns 983275970Scy.TP 10 984275970Scy.NOP \f\*[B-Font]update\f[] 985275970ScyNTP seconds at last signature update 986275970Scy.br 987275970Scy.ns 988275970Scy.TP 10 989275970Scy.NOP \f\*[B-Font]cert\f[] 990275970Scycertificate subject, issuer and certificate flags 991275970Scy.br 992275970Scy.ns 993275970Scy.TP 10 994275970Scy.NOP \f\*[B-Font]until\f[] 995275970ScyNTP seconds when the certificate expires 996275970Scy.PP 997275970Scy.SS Peer Variables 998275970ScyThe following peer variables appear in the 999275970Scy\f\*[B-Font]rv\f[] 1000275970Scybillboard for each association. 1001275970ScyNot all variables are displayed in some configurations. 1002275970Scy.TP 10 1003275970Scy.NOP Variable 1004275970ScyDescription 1005275970Scy.br 1006275970Scy.ns 1007275970Scy.TP 10 1008275970Scy.NOP \f\*[B-Font]associd\f[] 1009275970Scyassociation ID 1010275970Scy.br 1011275970Scy.ns 1012275970Scy.TP 10 1013275970Scy.NOP \f\*[B-Font]status\f[] 1014275970Scy.Lk decode.html#peer "peer status word" 1015275970Scy.br 1016275970Scy.ns 1017275970Scy.TP 10 1018275970Scy.NOP \f\*[B-Font]srcadr\f[] 1019275970Scysource (remote) IP address 1020275970Scy.br 1021275970Scy.ns 1022275970Scy.TP 10 1023275970Scy.NOP \f\*[B-Font]srcport\f[] 1024275970Scysource (remote) port 1025275970Scy.br 1026275970Scy.ns 1027275970Scy.TP 10 1028275970Scy.NOP \f\*[B-Font]dstadr\f[] 1029275970Scydestination (local) IP address 1030275970Scy.br 1031275970Scy.ns 1032275970Scy.TP 10 1033275970Scy.NOP \f\*[B-Font]dstport\f[] 1034275970Scydestination (local) port 1035275970Scy.br 1036275970Scy.ns 1037275970Scy.TP 10 1038275970Scy.NOP \f\*[B-Font]leap\f[] 1039275970Scyleap indicator (0-3) 1040275970Scy.br 1041275970Scy.ns 1042275970Scy.TP 10 1043275970Scy.NOP \f\*[B-Font]stratum\f[] 1044275970Scystratum (0-15) 1045275970Scy.br 1046275970Scy.ns 1047275970Scy.TP 10 1048275970Scy.NOP \f\*[B-Font]precision\f[] 1049275970Scyprecision (log2 s) 1050275970Scy.br 1051275970Scy.ns 1052275970Scy.TP 10 1053275970Scy.NOP \f\*[B-Font]rootdelay\f[] 1054275970Scytotal roundtrip delay to the primary reference clock 1055275970Scy.br 1056275970Scy.ns 1057275970Scy.TP 10 1058275970Scy.NOP \f\*[B-Font]rootdisp\f[] 1059275970Scytotal root dispersion to the primary reference clock 1060275970Scy.br 1061275970Scy.ns 1062275970Scy.TP 10 1063275970Scy.NOP \f\*[B-Font]refid\f[] 1064275970Scyreference ID or 1065275970Scy.Lk decode.html#kiss "kiss code" 1066275970Scy.br 1067275970Scy.ns 1068275970Scy.TP 10 1069275970Scy.NOP \f\*[B-Font]reftime\f[] 1070275970Scyreference time 1071275970Scy.br 1072275970Scy.ns 1073275970Scy.TP 10 1074275970Scy.NOP \f\*[B-Font]reach\f[] 1075275970Scyreach register (octal) 1076275970Scy.br 1077275970Scy.ns 1078275970Scy.TP 10 1079275970Scy.NOP \f\*[B-Font]unreach\f[] 1080275970Scyunreach counter 1081275970Scy.br 1082275970Scy.ns 1083275970Scy.TP 10 1084275970Scy.NOP \f\*[B-Font]hmode\f[] 1085275970Scyhost mode (1-6) 1086275970Scy.br 1087275970Scy.ns 1088275970Scy.TP 10 1089275970Scy.NOP \f\*[B-Font]pmode\f[] 1090275970Scypeer mode (1-5) 1091275970Scy.br 1092275970Scy.ns 1093275970Scy.TP 10 1094275970Scy.NOP \f\*[B-Font]hpoll\f[] 1095275970Scyhost poll exponent (log2 s) (3-17) 1096275970Scy.br 1097275970Scy.ns 1098275970Scy.TP 10 1099275970Scy.NOP \f\*[B-Font]ppoll\f[] 1100275970Scypeer poll exponent (log2 s) (3-17) 1101275970Scy.br 1102275970Scy.ns 1103275970Scy.TP 10 1104275970Scy.NOP \f\*[B-Font]headway\f[] 1105275970Scyheadway (see 1106275970Scy.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) 1107275970Scy.br 1108275970Scy.ns 1109275970Scy.TP 10 1110275970Scy.NOP \f\*[B-Font]flash\f[] 1111275970Scy.Lk decode.html#flash "flash status word" 1112275970Scy.br 1113275970Scy.ns 1114275970Scy.TP 10 1115275970Scy.NOP \f\*[B-Font]offset\f[] 1116275970Scyfilter offset 1117275970Scy.br 1118275970Scy.ns 1119275970Scy.TP 10 1120275970Scy.NOP \f\*[B-Font]delay\f[] 1121275970Scyfilter delay 1122275970Scy.br 1123275970Scy.ns 1124275970Scy.TP 10 1125275970Scy.NOP \f\*[B-Font]dispersion\f[] 1126275970Scyfilter dispersion 1127275970Scy.br 1128275970Scy.ns 1129275970Scy.TP 10 1130275970Scy.NOP \f\*[B-Font]jitter\f[] 1131275970Scyfilter jitter 1132275970Scy.br 1133275970Scy.ns 1134275970Scy.TP 10 1135275970Scy.NOP \f\*[B-Font]ident\f[] 1136275970ScyAutokey group name for this association 1137275970Scy.br 1138275970Scy.ns 1139275970Scy.TP 10 1140275970Scy.NOP \f\*[B-Font]bias\f[] 1141275970Scyunicast/broadcast bias 1142275970Scy.br 1143275970Scy.ns 1144275970Scy.TP 10 1145275970Scy.NOP \f\*[B-Font]xleave\f[] 1146275970Scyinterleave delay (see 1147275970Scy.Lk xleave.html "NTP Interleaved Modes" ) 1148275970Scy.PP 1149275970ScyThe 1150275970Scy\f\*[B-Font]bias\f[] 1151275970Scyvariable is calculated when the first broadcast packet is received 1152275970Scyafter the calibration volley. 1153275970ScyIt represents the offset of the broadcast subgraph relative to the unicast subgraph. 1154275970ScyThe 1155275970Scy\f\*[B-Font]xleave\f[] 1156275970Scyvariable appears only for the interleaved symmetric and interleaved modes. 1157275970ScyIt represents the internal queuing, buffering and transmission delays 1158275970Scyfor the preceding packet. 1159275970Scy.sp \n(Ppu 1160275970Scy.ne 2 1161275970Scy 1162275970ScyWhen the NTPv4 daemon is compiled with the OpenSSL software library, 1163275970Scyadditional peer variables are displayed, including the following: 1164275970Scy.TP 10 1165275970Scy.NOP Variable 1166275970ScyDescription 1167275970Scy.br 1168275970Scy.ns 1169275970Scy.TP 10 1170275970Scy.NOP \f\*[B-Font]flags\f[] 1171275970Scypeer flags (see Autokey specification) 1172275970Scy.br 1173275970Scy.ns 1174275970Scy.TP 10 1175275970Scy.NOP \f\*[B-Font]host\f[] 1176275970ScyAutokey server name 1177275970Scy.br 1178275970Scy.ns 1179275970Scy.TP 10 1180275970Scy.NOP \f\*[B-Font]flags\f[] 1181275970Scypeer flags (see Autokey specification) 1182275970Scy.br 1183275970Scy.ns 1184275970Scy.TP 10 1185275970Scy.NOP \f\*[B-Font]signature\f[] 1186275970ScyOpenSSL digest/signature scheme 1187275970Scy.br 1188275970Scy.ns 1189275970Scy.TP 10 1190275970Scy.NOP \f\*[B-Font]initsequence\f[] 1191275970Scyinitial key ID 1192275970Scy.br 1193275970Scy.ns 1194275970Scy.TP 10 1195275970Scy.NOP \f\*[B-Font]initkey\f[] 1196275970Scyinitial key index 1197275970Scy.br 1198275970Scy.ns 1199275970Scy.TP 10 1200275970Scy.NOP \f\*[B-Font]timestamp\f[] 1201275970ScyAutokey signature timestamp 1202275970Scy.PP 1203275970Scy.SS Clock Variables 1204275970ScyThe following clock variables appear in the 1205275970Scy\f\*[B-Font]cv\f[] 1206275970Scybillboard for each association with a reference clock. 1207275970ScyNot all variables are displayed in some configurations. 1208275970Scy.TP 10 1209275970Scy.NOP Variable 1210275970ScyDescription 1211275970Scy.br 1212275970Scy.ns 1213275970Scy.TP 10 1214275970Scy.NOP \f\*[B-Font]associd\f[] 1215275970Scyassociation ID 1216275970Scy.br 1217275970Scy.ns 1218275970Scy.TP 10 1219275970Scy.NOP \f\*[B-Font]status\f[] 1220275970Scy.Lk decode.html#clock "clock status word" 1221275970Scy.br 1222275970Scy.ns 1223275970Scy.TP 10 1224275970Scy.NOP \f\*[B-Font]device\f[] 1225275970Scydevice description 1226275970Scy.br 1227275970Scy.ns 1228275970Scy.TP 10 1229275970Scy.NOP \f\*[B-Font]timecode\f[] 1230275970ScyASCII time code string (specific to device) 1231275970Scy.br 1232275970Scy.ns 1233275970Scy.TP 10 1234275970Scy.NOP \f\*[B-Font]poll\f[] 1235275970Scypoll messages sent 1236275970Scy.br 1237275970Scy.ns 1238275970Scy.TP 10 1239275970Scy.NOP \f\*[B-Font]noreply\f[] 1240275970Scyno reply 1241275970Scy.br 1242275970Scy.ns 1243275970Scy.TP 10 1244275970Scy.NOP \f\*[B-Font]badformat\f[] 1245275970Scybad format 1246275970Scy.br 1247275970Scy.ns 1248275970Scy.TP 10 1249275970Scy.NOP \f\*[B-Font]baddata\f[] 1250275970Scybad date or time 1251275970Scy.br 1252275970Scy.ns 1253275970Scy.TP 10 1254275970Scy.NOP \f\*[B-Font]fudgetime1\f[] 1255275970Scyfudge time 1 1256275970Scy.br 1257275970Scy.ns 1258275970Scy.TP 10 1259275970Scy.NOP \f\*[B-Font]fudgetime2\f[] 1260275970Scyfudge time 2 1261275970Scy.br 1262275970Scy.ns 1263275970Scy.TP 10 1264275970Scy.NOP \f\*[B-Font]stratum\f[] 1265275970Scydriver stratum 1266275970Scy.br 1267275970Scy.ns 1268275970Scy.TP 10 1269275970Scy.NOP \f\*[B-Font]refid\f[] 1270275970Scydriver reference ID 1271275970Scy.br 1272275970Scy.ns 1273275970Scy.TP 10 1274275970Scy.NOP \f\*[B-Font]flags\f[] 1275275970Scydriver flags 1276275970Scy.PP 1277275970Scy.SH "OPTIONS" 1278275970Scy.TP 1279275970Scy.NOP \f\*[B-Font]\-4\f[], \f\*[B-Font]\-\-ipv4\f[] 1280275970ScyForce IPv4 DNS name resolution. 1281275970ScyThis option must not appear in combination with any of the following options: 1282275970Scyipv6. 1283275970Scy.sp 1284275970ScyForce DNS resolution of following host names on the command line 1285275970Scyto the IPv4 namespace. 1286275970Scy.TP 1287275970Scy.NOP \f\*[B-Font]\-6\f[], \f\*[B-Font]\-\-ipv6\f[] 1288275970ScyForce IPv6 DNS name resolution. 1289275970ScyThis option must not appear in combination with any of the following options: 1290275970Scyipv4. 1291275970Scy.sp 1292275970ScyForce DNS resolution of following host names on the command line 1293275970Scyto the IPv6 namespace. 1294275970Scy.TP 1295275970Scy.NOP \f\*[B-Font]\-c\f[] \f\*[I-Font]cmd\f[], \f\*[B-Font]\-\-command\f[]=\f\*[I-Font]cmd\f[] 1296275970Scyrun a command and exit. 1297275970ScyThis option may appear an unlimited number of times. 1298275970Scy.sp 1299275970ScyThe following argument is interpreted as an interactive format command 1300275970Scyand is added to the list of commands to be executed on the specified 1301275970Scyhost(s). 1302275970Scy.TP 1303275970Scy.NOP \f\*[B-Font]\-d\f[], \f\*[B-Font]\-\-debug\-level\f[] 1304275970ScyIncrease debug verbosity level. 1305275970ScyThis option may appear an unlimited number of times. 1306275970Scy.sp 1307275970Scy.TP 1308275970Scy.NOP \f\*[B-Font]\-D\f[] \f\*[I-Font]number\f[], \f\*[B-Font]\-\-set\-debug\-level\f[]=\f\*[I-Font]number\f[] 1309275970ScySet the debug verbosity level. 1310275970ScyThis option may appear an unlimited number of times. 1311275970ScyThis option takes an integer number as its argument. 1312275970Scy.sp 1313275970Scy.TP 1314275970Scy.NOP \f\*[B-Font]\-i\f[], \f\*[B-Font]\-\-interactive\f[] 1315275970ScyForce ntpq to operate in interactive mode. 1316275970ScyThis option must not appear in combination with any of the following options: 1317275970Scycommand, peers. 1318275970Scy.sp 1319275970ScyForce \fBntpq\fP to operate in interactive mode. 1320275970ScyPrompts will be written to the standard output and 1321275970Scycommands read from the standard input. 1322275970Scy.TP 1323275970Scy.NOP \f\*[B-Font]\-n\f[], \f\*[B-Font]\-\-numeric\f[] 1324275970Scynumeric host addresses. 1325275970Scy.sp 1326275970ScyOutput all host addresses in dotted-quad numeric format rather than 1327275970Scyconverting to the canonical host names. 1328275970Scy.TP 1329275970Scy.NOP \f\*[B-Font]\-\-old\-rv\f[] 1330275970ScyAlways output status line with readvar. 1331275970Scy.sp 1332275970ScyBy default, \fBntpq\fP now suppresses the \fBassocid=...\fP 1333275970Scyline that precedes the output of \fBreadvar\fP 1334275970Scy(alias \fBrv\fP) when a single variable is requested, such as 1335275970Scy\fBntpq \-c "rv 0 offset"\fP. 1336275970ScyThis option causes \fBntpq\fP to include both lines of output 1337275970Scyfor a single-variable \fBreadvar\fP. 1338275970ScyUsing an environment variable to 1339275970Scypreset this option in a script will enable both older and 1340275970Scynewer \fBntpq\fP to behave identically in this regard. 1341275970Scy.TP 1342275970Scy.NOP \f\*[B-Font]\-p\f[], \f\*[B-Font]\-\-peers\f[] 1343275970ScyPrint a list of the peers. 1344275970ScyThis option must not appear in combination with any of the following options: 1345275970Scyinteractive. 1346275970Scy.sp 1347275970ScyPrint a list of the peers known to the server as well as a summary 1348275970Scyof their state. This is equivalent to the 'peers' interactive command. 1349275970Scy.TP 1350298770Sdelphij.NOP \f\*[B-Font]\-r\f[] \f\*[I-Font]keyword\f[], \f\*[B-Font]\-\-refid\f[]=\f\*[I-Font]keyword\f[] 1351298770SdelphijSet default display type for S2+ refids. 1352298770SdelphijThis option takes a keyword as its argument. The argument sets an enumeration value that can 1353298770Sdelphijbe tested by comparing them against the option value macro. 1354298770SdelphijThe available keywords are: 1355298770Sdelphij.in +4 1356298770Sdelphij.nf 1357298770Sdelphij.na 1358298770Sdelphijhash ipv4 1359298770Sdelphij.fi 1360298770Sdelphijor their numeric equivalent. 1361298770Sdelphij.in -4 1362298770Sdelphij.sp 1363298770SdelphijThe default 1364298770Sdelphij\f\*[I-Font]keyword\f[] 1365298770Sdelphijfor this option is: 1366298770Sdelphij.ti +4 1367298770Sdelphij ipv4 1368298770Sdelphij.sp 1369298770SdelphijSet the default display format for S2+ refids. 1370298770Sdelphij.TP 1371275970Scy.NOP \f\*[B-Font]\-w\f[], \f\*[B-Font]\-\-wide\f[] 1372275970ScyDisplay the full 'remote' value. 1373275970Scy.sp 1374275970ScyDisplay the full value of the 'remote' value. If this requires 1375275970Scymore than 15 characters, display the full value, emit a newline, 1376275970Scyand continue the data display properly indented on the next line. 1377275970Scy.TP 1378275970Scy.NOP \f\*[B-Font]\-\&?\f[], \f\*[B-Font]\-\-help\f[] 1379275970ScyDisplay usage information and exit. 1380275970Scy.TP 1381275970Scy.NOP \f\*[B-Font]\-\&!\f[], \f\*[B-Font]\-\-more-help\f[] 1382275970ScyPass the extended usage information through a pager. 1383275970Scy.TP 1384275970Scy.NOP \f\*[B-Font]\->\f[] [\f\*[I-Font]cfgfile\f[]], \f\*[B-Font]\-\-save-opts\f[] [=\f\*[I-Font]cfgfile\f[]] 1385275970ScySave the option state to \fIcfgfile\fP. The default is the \fIlast\fP 1386275970Scyconfiguration file listed in the \fBOPTION PRESETS\fP section, below. 1387275970ScyThe command will exit after updating the config file. 1388275970Scy.TP 1389275970Scy.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[] 1390275970ScyLoad options from \fIcfgfile\fP. 1391275970ScyThe \fIno-load-opts\fP form will disable the loading 1392275970Scyof earlier config/rc/ini files. \fI\-\-no-load-opts\fP is handled early, 1393275970Scyout of order. 1394275970Scy.TP 1395275970Scy.NOP \f\*[B-Font]\-\-version\f[] [{\f\*[I-Font]v|c|n\f[]}] 1396275970ScyOutput version of program and exit. The default mode is `v', a simple 1397275970Scyversion. The `c' mode will print copyright information and `n' will 1398275970Scyprint the full copyright notice. 1399275970Scy.PP 1400275970Scy.SH "OPTION PRESETS" 1401275970ScyAny option that is not marked as \fInot presettable\fP may be preset 1402275970Scyby loading values from configuration ("RC" or ".INI") file(s) and values from 1403275970Scyenvironment variables named: 1404275970Scy.nf 1405275970Scy \fBNTPQ_<option-name>\fP or \fBNTPQ\fP 1406275970Scy.fi 1407275970Scy.ad 1408275970ScyThe environmental presets take precedence (are processed later than) 1409275970Scythe configuration files. 1410275970ScyThe \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP". 1411275970ScyIf any of these are directories, then the file \fI.ntprc\fP 1412275970Scyis searched for within those directories. 1413275970Scy.SH "ENVIRONMENT" 1414275970ScySee \fBOPTION PRESETS\fP for configuration environment variables. 1415275970Scy.SH "FILES" 1416275970ScySee \fBOPTION PRESETS\fP for configuration files. 1417275970Scy.SH "EXIT STATUS" 1418275970ScyOne of the following exit values will be returned: 1419275970Scy.TP 1420275970Scy.NOP 0 " (EXIT_SUCCESS)" 1421275970ScySuccessful program execution. 1422275970Scy.TP 1423275970Scy.NOP 1 " (EXIT_FAILURE)" 1424275970ScyThe operation failed or the command syntax was not valid. 1425275970Scy.TP 1426275970Scy.NOP 66 " (EX_NOINPUT)" 1427275970ScyA specified configuration file could not be loaded. 1428275970Scy.TP 1429275970Scy.NOP 70 " (EX_SOFTWARE)" 1430275970Scylibopts had an internal operational error. Please report 1431275970Scyit to autogen-users@lists.sourceforge.net. Thank you. 1432275970Scy.PP 1433275970Scy.SH "AUTHORS" 1434280849ScyThe University of Delaware and Network Time Foundation 1435275970Scy.SH "COPYRIGHT" 1436294904SdelphijCopyright (C) 1992-2016 The University of Delaware and Network Time Foundation all rights reserved. 1437275970ScyThis program is released under the terms of the NTP license, <http://ntp.org/license>. 1438275970Scy.SH "BUGS" 1439275970ScyPlease send bug reports to: http://bugs.ntp.org, bugs@ntp.org 1440275970Scy.SH "NOTES" 1441275970ScyThis manual page was \fIAutoGen\fP-erated from the \fBntpq\fP 1442275970Scyoption definitions. 1443