1275970Scy@node ntpq Invocation 2275970Scy@section Invoking ntpq 3275970Scy@pindex ntpq 4275970Scy@cindex standard NTP query program 5275970Scy@ignore 6275970Scy# 7275970Scy# EDIT THIS FILE WITH CAUTION (invoke-ntpq.texi) 8275970Scy# 9310419Sdelphij# It has been AutoGen-ed November 21, 2016 at 08:03:06 AM by AutoGen 5.18.5 10275970Scy# From the definitions ntpq-opts.def 11275970Scy# and the template file agtexi-cmd.tpl 12275970Scy@end ignore 13275970Scy 14275970Scy 15275970ScyThe 16275970Scy@code{ntpq} 17275970Scyutility program is used to query NTP servers which 18275970Scyimplement the standard NTP mode 6 control message formats defined 19275970Scyin Appendix B of the NTPv3 specification RFC1305, requesting 20275970Scyinformation about current state and/or changes in that state. 21275970ScyThe same formats are used in NTPv4, although some of the 22275970Scyvariables have changed and new ones added. The description on this 23275970Scypage is for the NTPv4 variables. 24275970ScyThe program may be run either in interactive mode or controlled using 25275970Scycommand line arguments. 26275970ScyRequests to read and write arbitrary 27275970Scyvariables can be assembled, with raw and pretty-printed output 28275970Scyoptions being available. 29275970ScyThe 30275970Scy@code{ntpq} 31275970Scyutility can also obtain and print a 32275970Scylist of peers in a common format by sending multiple queries to the 33275970Scyserver. 34275970Scy 35275970ScyIf one or more request options is included on the command line 36275970Scywhen 37275970Scy@code{ntpq} 38275970Scyis executed, each of the requests will be sent 39275970Scyto the NTP servers running on each of the hosts given as command 40275970Scyline arguments, or on localhost by default. 41275970ScyIf no request options 42275970Scyare given, 43275970Scy@code{ntpq} 44275970Scywill attempt to read commands from the 45275970Scystandard input and execute these on the NTP server running on the 46275970Scyfirst host given on the command line, again defaulting to localhost 47275970Scywhen no other host is specified. 48275970ScyThe 49275970Scy@code{ntpq} 50275970Scyutility will prompt for 51275970Scycommands if the standard input is a terminal device. 52275970Scy 53275970Scy@code{ntpq} 54275970Scyuses NTP mode 6 packets to communicate with the 55275970ScyNTP server, and hence can be used to query any compatible server on 56275970Scythe network which permits it. 57275970ScyNote that since NTP is a UDP protocol 58275970Scythis communication will be somewhat unreliable, especially over 59275970Scylarge distances in terms of network topology. 60275970ScyThe 61275970Scy@code{ntpq} 62275970Scyutility makes 63275970Scyone attempt to retransmit requests, and will time requests out if 64275970Scythe remote host is not heard from within a suitable timeout 65275970Scytime. 66275970Scy 67275970ScySpecifying a 68275970Scycommand line option other than 69275970Scy@code{-i} 70275970Scyor 71275970Scy@code{-n} 72275970Scywill 73275970Scycause the specified query (queries) to be sent to the indicated 74275970Scyhost(s) immediately. 75275970ScyOtherwise, 76275970Scy@code{ntpq} 77275970Scywill attempt to read 78275970Scyinteractive format commands from the standard input. 79275970Scy@subsubsection Internal Commands 80275970ScyInteractive format commands consist of a keyword followed by zero 81275970Scyto four arguments. 82275970ScyOnly enough characters of the full keyword to 83275970Scyuniquely identify the command need be typed. 84275970Scy 85275970ScyA 86275970Scynumber of interactive format commands are executed entirely within 87275970Scythe 88275970Scy@code{ntpq} 89275970Scyutility itself and do not result in NTP mode 6 90275970Scyrequests being sent to a server. 91275970ScyThese are described following. 92275970Scy@table @asis 93275970Scy@item @code{?} @code{[@kbd{command_keyword}]} 94275970Scy@item @code{help} @code{[@kbd{command_keyword}]} 95275970ScyA 96275970Scy@quoteleft{}?@quoteright{} 97275970Scyby itself will print a list of all the command 98275970Scykeywords known to this incarnation of 99275970Scy@code{ntpq} 100275970ScyA 101275970Scy@quoteleft{}?@quoteright{} 102275970Scyfollowed by a command keyword will print function and usage 103275970Scyinformation about the command. 104275970ScyThis command is probably a better 105275970Scysource of information about 106275970Scy@code{ntpq} 107275970Scythan this manual 108275970Scypage. 109275970Scy@item @code{addvars} @kbd{variable_name}@code{[@code{=value}]} @code{...} 110275970Scy@item @code{rmvars} @kbd{variable_name} @code{...} 111275970Scy@item @code{clearvars} 112275970Scy@item @code{showvars} 113275970ScyThe data carried by NTP mode 6 messages consists of a list of 114275970Scyitems of the form 115275970Scy@quoteleft{}variable_name=value@quoteright{}, 116275970Scywhere the 117275970Scy@quoteleft{}=value@quoteright{} 118275970Scyis ignored, and can be omitted, 119275970Scyin requests to the server to read variables. 120275970ScyThe 121275970Scy@code{ntpq} 122275970Scyutility maintains an internal list in which data to be included in control 123275970Scymessages can be assembled, and sent using the 124275970Scy@code{readlist} 125275970Scyand 126275970Scy@code{writelist} 127275970Scycommands described below. 128275970ScyThe 129275970Scy@code{addvars} 130275970Scycommand allows variables and their optional values to be added to 131275970Scythe list. 132275970ScyIf more than one variable is to be added, the list should 133275970Scybe comma-separated and not contain white space. 134275970ScyThe 135275970Scy@code{rmvars} 136275970Scycommand can be used to remove individual variables from the list, 137275970Scywhile the 138275970Scy@code{clearlist} 139275970Scycommand removes all variables from the 140275970Scylist. 141275970ScyThe 142275970Scy@code{showvars} 143275970Scycommand displays the current list of optional variables. 144275970Scy@item @code{authenticate} @code{[yes | no]} 145275970ScyNormally 146275970Scy@code{ntpq} 147275970Scydoes not authenticate requests unless 148275970Scythey are write requests. 149275970ScyThe command 150275970Scy@quoteleft{}authenticate yes@quoteright{} 151275970Scycauses 152275970Scy@code{ntpq} 153275970Scyto send authentication with all requests it 154275970Scymakes. 155275970ScyAuthenticated requests causes some servers to handle 156275970Scyrequests slightly differently, and can occasionally melt the CPU in 157275970Scyfuzzballs if you turn authentication on before doing a 158275970Scy@code{peer} 159275970Scydisplay. 160275970ScyThe command 161275970Scy@quoteleft{}authenticate@quoteright{} 162275970Scycauses 163275970Scy@code{ntpq} 164275970Scyto display whether or not 165275970Scy@code{ntpq} 166275970Scyis currently autheinticating requests. 167275970Scy@item @code{cooked} 168275970ScyCauses output from query commands to be "cooked", so that 169275970Scyvariables which are recognized by 170275970Scy@code{ntpq} 171275970Scywill have their 172275970Scyvalues reformatted for human consumption. 173275970ScyVariables which 174275970Scy@code{ntpq} 175275970Scythinks should have a decodable value but didn't are 176275970Scymarked with a trailing 177275970Scy@quoteleft{}?@quoteright{}. 178275970Scy@item @code{debug} @code{[@code{more} | @code{less} | @code{off}]} 179275970ScyWith no argument, displays the current debug level. 180275970ScyOtherwise, the debug level is changed to the indicated level. 181275970Scy@item @code{delay} @kbd{milliseconds} 182275970ScySpecify a time interval to be added to timestamps included in 183275970Scyrequests which require authentication. 184275970ScyThis is used to enable 185275970Scy(unreliable) server reconfiguration over long delay network paths 186275970Scyor between machines whose clocks are unsynchronized. 187275970ScyActually the 188275970Scyserver does not now require timestamps in authenticated requests, 189275970Scyso this command may be obsolete. 190275970Scy@item @code{exit} 191275970ScyExit 192275970Scy@code{ntpq} 193275970Scy@item @code{host} @kbd{hostname} 194275970ScySet the host to which future queries will be sent. 195275970Scy@kbd{hostname} 196275970Scymay be either a host name or a numeric address. 197275970Scy@item @code{hostnames} @code{[@code{yes} | @code{no}]} 198275970ScyIf 199275970Scy@code{yes} 200275970Scyis specified, host names are printed in 201275970Scyinformation displays. 202275970ScyIf 203275970Scy@code{no} 204275970Scyis specified, numeric 205275970Scyaddresses are printed instead. 206275970ScyThe default is 207275970Scy@code{yes}, 208275970Scyunless 209275970Scymodified using the command line 210275970Scy@code{-n} 211275970Scyswitch. 212275970Scy@item @code{keyid} @kbd{keyid} 213275970ScyThis command allows the specification of a key number to be 214275970Scyused to authenticate configuration requests. 215275970ScyThis must correspond 216285612Sdelphijto the 217285612Sdelphij@code{controlkey} 218285612Sdelphijkey number the server has been configured to use for this 219275970Scypurpose. 220275970Scy@item @code{keytype} @code{[@code{md5} | @code{OpenSSLDigestType}]} 221275970ScySpecify the type of key to use for authenticating requests. 222275970Scy@code{md5} 223275970Scyis alway supported. 224275970ScyIf 225275970Scy@code{ntpq} 226275970Scywas built with OpenSSL support, 227275970Scyany digest type supported by OpenSSL can also be provided. 228275970ScyIf no argument is given, the current 229275970Scy@code{keytype} 230275970Scyis displayed. 231275970Scy@item @code{ntpversion} @code{[@code{1} | @code{2} | @code{3} | @code{4}]} 232275970ScySets the NTP version number which 233275970Scy@code{ntpq} 234275970Scyclaims in 235275970Scypackets. 236275970ScyDefaults to 3, and note that mode 6 control messages (and 237275970Scymodes, for that matter) didn't exist in NTP version 1. 238275970ScyThere appear 239275970Scyto be no servers left which demand version 1. 240275970ScyWith no argument, displays the current NTP version that will be used 241275970Scywhen communicating with servers. 242275970Scy@item @code{passwd} 243275970ScyThis command prompts you to type in a password (which will not 244275970Scybe echoed) which will be used to authenticate configuration 245275970Scyrequests. 246275970ScyThe password must correspond to the key configured for 247275970Scyuse by the NTP server for this purpose if such requests are to be 248275970Scysuccessful. 249275970Scy@code{poll} 250275970Scy@kbd{n} 251275970Scy@code{verbose} 252275970Scy@item @code{quit} 253275970ScyExit 254275970Scy@code{ntpq} 255275970Scy@item @code{raw} 256275970ScyCauses all output from query commands is printed as received 257275970Scyfrom the remote server. 258275970ScyThe only formating/interpretation done on 259275970Scythe data is to transform nonascii data into a printable (but barely 260275970Scyunderstandable) form. 261275970Scy@item @code{timeout} @kbd{milliseconds} 262275970ScySpecify a timeout period for responses to server queries. 263275970ScyThe 264275970Scydefault is about 5000 milliseconds. 265275970ScyNote that since 266275970Scy@code{ntpq} 267275970Scyretries each query once after a timeout, the total waiting time for 268275970Scya timeout will be twice the timeout value set. 269275970Scy@item @code{version} 270275970ScyPrint the version of the 271275970Scy@code{ntpq} 272275970Scyprogram. 273275970Scy@end table 274275970Scy 275275970Scy@subsubsection Control Message Commands 276275970ScyAssociation IDs are used to identify system, peer and clock variables. 277275970ScySystem variables are assigned an association ID of zero and system name space, while each association is assigned a nonzero association ID and peer namespace. 278275970ScyMost control commands send a single mode-6 message to the server and expect a single response message. 279275970ScyThe exceptions are the 280275970Scy@code{peers} 281275970Scycommand, which sends a series of messages, 282275970Scyand the 283275970Scy@code{mreadlist} 284275970Scyand 285275970Scy@code{mreadvar} 286275970Scycommands, which iterate over a range of associations. 287275970Scy@table @asis 288275970Scy@item @code{associations} 289275970ScyDisplay a list of mobilized associations in the form: 290275970Scy@example 291275970Scyind assid status conf reach auth condition last_event cnt 292275970Scy@end example 293275970Scy@table @asis 294275970Scy@item Sy String Ta Sy Description 295275970Scy@item @code{ind} @code{Ta} @code{index} @code{on} @code{this} @code{list} 296275970Scy@item @code{assid} @code{Ta} @code{association} @code{ID} 297275970Scy@item @code{status} @code{Ta} @code{peer} @code{status} @code{word} 298275970Scy@item @code{conf} @code{Ta} @code{yes}: @code{persistent,} @code{no}: @code{ephemeral} 299275970Scy@item @code{reach} @code{Ta} @code{yes}: @code{reachable,} @code{no}: @code{unreachable} 300275970Scy@item @code{auth} @code{Ta} @code{ok}, @code{yes}, @code{bad} @code{and} @code{none} 301275970Scy@item @code{condition} @code{Ta} @code{selection} @code{status} @code{(see} @code{the} @code{select} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} 302275970Scy@item @code{last_event} @code{Ta} @code{event} @code{report} @code{(see} @code{the} @code{event} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} 303275970Scy@item @code{cnt} @code{Ta} @code{event} @code{count} @code{(see} @code{the} @code{count} @code{field} @code{of} @code{the} @code{peer} @code{status} @code{word)} 304275970Scy@end table 305275970Scy@item @code{authinfo} 306275970ScyDisplay the authentication statistics. 307275970Scy@item @code{clockvar} @kbd{assocID} @code{[@kbd{name}@code{[@code{=}@kbd{value}]}]} @code{[...]} 308275970Scy@item @code{cv} @kbd{assocID} @code{[@kbd{name}@code{[@code{=}@kbd{value}]}]} @code{[...]} 309275970ScyDisplay a list of clock variables for those associations supporting a reference clock. 310275970Scy@item @code{:config} @code{[...]} 311275970ScySend 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. 312275970Scy@item @code{config-from-file} @kbd{filename} 313275970ScySend the each line of 314275970Scy@kbd{filename} 315275970Scyto 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. 316275970Scy@item @code{ifstats} 317275970ScyDisplay statistics for each local network address. Authentication is required. 318275970Scy@item @code{iostats} 319275970ScyDisplay network and reference clock I/O statistics. 320275970Scy@item @code{kerninfo} 321275970ScyDisplay 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. 322275970Scy@item @code{lassociations} 323275970ScyPerform the same function as the associations command, except display mobilized and unmobilized associations. 324275970Scy@item @code{lopeers} @code{[@code{-4} | @code{-6}]} 325275970ScyObtain and print a list of all peers and clients showing 326275970Scy@kbd{dstadr} 327275970Scy(associated with any given IP version). 328275970Scy@item @code{lpeers} @code{[@code{-4} | @code{-6}]} 329275970ScyPrint a peer spreadsheet for the appropriate IP version(s). 330275970Scy@kbd{dstadr} 331275970Scy(associated with any given IP version). 332275970Scy@item @code{monstats} 333275970ScyDisplay monitor facility statistics. 334275970Scy@item @code{mrulist} @code{[@code{limited} | @code{kod} | @code{mincount}=@kbd{count} | @code{laddr}=@kbd{localaddr} | @code{sort}=@kbd{sortorder} | @code{resany}=@kbd{hexmask} | @code{resall}=@kbd{hexmask}]} 335275970ScyObtain and print traffic counts collected and maintained by the monitor facility. 336275970ScyWith the exception of 337275970Scy@code{sort}=@kbd{sortorder}, 338275970Scythe options filter the list returned by 339275970Scy@code{ntpd.} 340275970ScyThe 341275970Scy@code{limited} 342275970Scyand 343275970Scy@code{kod} 344275970Scyoptions return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response. 345275970ScyThe 346275970Scy@code{mincount}=@kbd{count} 347275970Scyoption filters entries representing less than 348275970Scy@kbd{count} 349275970Scypackets. 350275970ScyThe 351275970Scy@code{laddr}=@kbd{localaddr} 352275970Scyoption filters entries for packets received on any local address other than 353275970Scy@kbd{localaddr}. 354275970Scy@code{resany}=@kbd{hexmask} 355275970Scyand 356275970Scy@code{resall}=@kbd{hexmask} 357275970Scyfilter entries containing none or less than all, respectively, of the bits in 358275970Scy@kbd{hexmask}, 359275970Scywhich must begin with 360275970Scy@code{0x}. 361275970ScyThe 362275970Scy@kbd{sortorder} 363275970Scydefaults to 364275970Scy@code{lstint} 365275970Scyand may be any of 366275970Scy@code{addr}, 367275970Scy@code{count}, 368275970Scy@code{avgint}, 369275970Scy@code{lstint}, 370275970Scyor any of those preceded by a minus sign (hyphen) to reverse the sort order. 371275970ScyThe output columns are: 372275970Scy@table @asis 373275970Scy@item Column 374275970ScyDescription 375275970Scy@item @code{lstint} 376275970ScyInterval in s between the receipt of the most recent packet from this address and the completion of the retrieval of the MRU list by 377275970Scy@code{ntpq} 378275970Scy@item @code{avgint} 379275970ScyAverage interval in s between packets from this address. 380275970Scy@item @code{rstr} 381275970ScyRestriction flags associated with this address. 382275970ScyMost are copied unchanged from the matching 383275970Scy@code{restrict} 384275970Scycommand, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this address triggered a rate control response. 385275970Scy@item @code{r} 386275970ScyRate control indicator, either 387275970Scya period, 388275970Scy@code{L} 389275970Scyor 390275970Scy@code{K} 391275970Scyfor no rate control response, 392275970Scyrate limiting by discarding, or rate limiting with a KoD response, respectively. 393275970Scy@item @code{m} 394275970ScyPacket mode. 395275970Scy@item @code{v} 396275970ScyPacket version number. 397275970Scy@item @code{count} 398275970ScyPackets received from this address. 399275970Scy@item @code{rport} 400275970ScySource port of last packet from this address. 401275970Scy@item @code{remote} @code{address} 402275970ScyDNS name, numeric address, or address followed by 403275970Scyclaimed DNS name which could not be verified in parentheses. 404275970Scy@end table 405275970Scy@item @code{mreadvar} @code{assocID} @code{assocID} @code{[@kbd{variable_name}@code{[=@kbd{value}]} ...]} 406275970Scy@item @code{mrv} @code{assocID} @code{assocID} @code{[@kbd{variable_name}@code{[=@kbd{value}]} ...]} 407275970ScyPerform the same function as the 408275970Scy@code{readvar} 409275970Scycommand, except for a range of association IDs. 410275970ScyThis range is determined from the association list cached by the most recent 411275970Scy@code{associations} 412275970Scycommand. 413275970Scy@item @code{opeers} @code{[@code{-4} | @code{-6}]} 414275970ScyObtain and print the old-style list of all peers and clients showing 415275970Scy@kbd{dstadr} 416275970Scy(associated with any given IP version), 417275970Scyrather than the 418275970Scy@kbd{refid}. 419275970Scy@item @code{passociations} 420275970ScyPerform the same function as the 421275970Scy@code{associations} 422275970Scycommand, 423275970Scyexcept that it uses previously stored data rather than making a new query. 424275970Scy@item @code{peers} 425275970ScyDisplay a list of peers in the form: 426275970Scy@example 427275970Scy[tally]remote refid st t when pool reach delay offset jitter 428275970Scy@end example 429275970Scy@table @asis 430275970Scy@item Variable 431275970ScyDescription 432275970Scy@item @code{[tally]} 433275970Scysingle-character code indicating current value of the 434275970Scy@code{select} 435275970Scyfield of the 436275970Scy.Lk decode.html#peer "peer status word" 437275970Scy@item @code{remote} 438275970Scyhost name (or IP number) of peer. 439275970ScyThe value displayed will be truncated to 15 characters unless the 440275970Scy@code{-w} 441275970Scyflag is given, in which case the full value will be displayed 442275970Scyon the first line, 443275970Scyand the remaining data is displayed on the next line. 444275970Scy@item @code{refid} 445275970Scyassociation ID or 446275970Scy.Lk decode.html#kiss "'kiss code" 447275970Scy@item @code{st} 448275970Scystratum 449275970Scy@item @code{t} 450275970Scy@code{u}: 451275970Scyunicast or manycast client, 452275970Scy@code{b}: 453275970Scybroadcast or multicast client, 454275970Scy@code{l}: 455275970Scylocal (reference clock), 456275970Scy@code{s}: 457275970Scysymmetric (peer), 458275970Scy@code{A}: 459275970Scymanycast server, 460275970Scy@code{B}: 461275970Scybroadcast server, 462275970Scy@code{M}: 463275970Scymulticast server 464275970Scy@item @code{when} 465275970Scysec/min/hr since last received packet 466275970Scy@item @code{poll} 467275970Scypoll interval (log2 s) 468275970Scy@item @code{reach} 469275970Scyreach shift register (octal) 470275970Scy@item @code{delay} 471275970Scyroundtrip delay 472275970Scy@item @code{offset} 473275970Scyoffset of server relative to this host 474275970Scy@item @code{jitter} 475275970Scyjitter 476275970Scy@end table 477285612Sdelphij@item @code{apeers} 478285612SdelphijDisplay a list of peers in the form: 479285612Sdelphij@example 480285612Sdelphij[tally]remote refid assid st t when pool reach delay offset jitter 481285612Sdelphij@end example 482285612Sdelphijwhere the output is just like the 483285612Sdelphij@code{peers} 484285612Sdelphijcommand except that the 485285612Sdelphij@code{refid} 486285612Sdelphijis displayed in hex format and the association number is also displayed. 487275970Scy@item @code{pstats} @kbd{assocID} 488275970ScyShow the statistics for the peer with the given 489275970Scy@kbd{assocID}. 490275970Scy@item @code{readlist} @kbd{assocID} 491275970Scy@item @code{rl} @kbd{assocID} 492275970ScyRead the system or peer variables included in the variable list. 493275970Scy@item @code{readvar} @kbd{assocID} @kbd{name}@code{[=@kbd{value}]} @code{[, ...]} 494275970Scy@item @code{rv} @kbd{assocID} @kbd{name}@code{[=@kbd{value}]} @code{[, ...]} 495275970ScyDisplay the specified variables. 496275970ScyIf 497275970Scy@kbd{assocID} 498275970Scyis zero, the variables are from the 499275970Scy@ref{System Variables} 500275970Scyname space, otherwise they are from the 501275970Scy@ref{Peer Variables} 502275970Scyname space. 503275970ScyThe 504275970Scy@kbd{assocID} 505275970Scyis required, as the same name can occur in both spaces. 506275970ScyIf no 507275970Scy@kbd{name} 508275970Scyis included, all operative variables in the name space are displayed. 509275970Scy 510275970ScyIn this case only, if the 511275970Scy@kbd{assocID} 512275970Scyis omitted, it is assumed zero. 513275970ScyMultiple names are specified with comma separators and without whitespace. 514275970ScyNote that time values are represented in milliseconds 515275970Scyand frequency values in parts-per-million (PPM). 516275970ScySome NTP timestamps are represented in the format 517275970ScyYYYYMMDDTTTT , 518275970Scywhere YYYY is the year, 519275970ScyMM the month of year, 520275970ScyDD the day of month and 521275970ScyTTTT the time of day. 522275970Scy@item @code{reslist} 523275970ScyShow the access control (restrict) list for 524275970Scy@code{ntpq} 525275970Scy 526275970Scy@item @code{saveconfig} @kbd{filename} 527275970ScyWrite the current configuration, 528275970Scyincluding any runtime modifications given with 529275970Scy@code{:config} 530275970Scyor 531275970Scy@code{config-from-file}, 532275970Scyto the ntpd host's file 533275970Scy@kbd{filename}. 534275970ScyThis command will be rejected by the server unless 535275970Scy.Lk miscopt.html#saveconfigdir "saveconfigdir" 536275970Scyappears in the 537275970Scy@code{ntpd} 538275970Scyconfiguration file. 539275970Scy@kbd{filename} 540275970Scycan use 541275970Scy@code{strftime()} 542275970Scyformat specifies to substitute the current date and time, for example, 543275970Scy@code{q]saveconfig} @code{ntp-%Y%m%d-%H%M%S.confq]}. 544275970ScyThe filename used is stored in system variable 545275970Scy@code{savedconfig}. 546275970ScyAuthentication is required. 547275970Scy@item @code{timerstats} 548275970ScyDisplay interval timer counters. 549275970Scy@item @code{writelist} @kbd{assocID} 550275970ScyWrite the system or peer variables included in the variable list. 551275970Scy@item @code{writevar} @kbd{assocID} @kbd{name}=@kbd{value} @code{[, ...]} 552275970ScyWrite the specified variables. 553275970ScyIf the 554275970Scy@kbd{assocID} 555275970Scyis zero, the variables are from the 556275970Scy@ref{System Variables} 557275970Scyname space, otherwise they are from the 558275970Scy@ref{Peer Variables} 559275970Scyname space. 560275970ScyThe 561275970Scy@kbd{assocID} 562275970Scyis required, as the same name can occur in both spaces. 563275970Scy@item @code{sysinfo} 564275970ScyDisplay operational summary. 565275970Scy@item @code{sysstats} 566275970ScyPrint statistics counters maintained in the protocol module. 567275970Scy@end table 568275970Scy 569275970Scy@subsubsection Status Words and Kiss Codes 570275970Scy 571275970ScyThe current state of the operating program is shown 572275970Scyin a set of status words 573275970Scymaintained by the system. 574275970ScyStatus information is also available on a per-association basis. 575275970ScyThese words are displayed in the 576275970Scy@code{rv} 577275970Scyand 578275970Scy@code{as} 579275970Scycommands both in hexadecimal and in decoded short tip strings. 580275970ScyThe codes, tips and short explanations are documented on the 581275970Scy.Lk decode.html "Event Messages and Status Words" 582275970Scypage. 583275970ScyThe page also includes a list of system and peer messages, 584275970Scythe code for the latest of which is included in the status word. 585275970Scy 586275970ScyInformation resulting from protocol machine state transitions 587275970Scyis displayed using an informal set of ASCII strings called 588275970Scy.Lk decode.html#kiss "kiss codes" . 589275970ScyThe original purpose was for kiss-o'-death (KoD) packets 590275970Scysent by the server to advise the client of an unusual condition. 591275970ScyThey are now displayed, when appropriate, 592275970Scyin the reference identifier field in various billboards. 593275970Scy 594275970Scy@subsubsection System Variables 595275970ScyThe following system variables appear in the 596275970Scy@code{rv} 597275970Scybillboard. 598275970ScyNot all variables are displayed in some configurations. 599275970Scy@table @asis 600275970Scy@item Variable 601275970ScyDescription 602275970Scy@item @code{status} 603275970Scy.Lk decode.html#sys "system status word" 604275970Scy@item @code{version} 605275970ScyNTP software version and build time 606275970Scy@item @code{processor} 607275970Scyhardware platform and version 608275970Scy@item @code{system} 609275970Scyoperating system and version 610275970Scy@item @code{leap} 611275970Scyleap warning indicator (0-3) 612275970Scy@item @code{stratum} 613275970Scystratum (1-15) 614275970Scy@item @code{precision} 615275970Scyprecision (log2 s) 616275970Scy@item @code{rootdelay} 617275970Scytotal roundtrip delay to the primary reference clock 618275970Scy@item @code{rootdisp} 619275970Scytotal dispersion to the primary reference clock 620275970Scy@item @code{peer} 621275970Scysystem peer association ID 622275970Scy@item @code{tc} 623275970Scytime constant and poll exponent (log2 s) (3-17) 624275970Scy@item @code{mintc} 625275970Scyminimum time constant (log2 s) (3-10) 626275970Scy@item @code{clock} 627275970Scydate and time of day 628275970Scy@item @code{refid} 629275970Scyreference ID or 630275970Scy.Lk decode.html#kiss "kiss code" 631275970Scy@item @code{reftime} 632275970Scyreference time 633275970Scy@item @code{offset} 634275970Scycombined offset of server relative to this host 635275970Scy@item @code{sys_jitter} 636275970Scycombined system jitter 637275970Scy@item @code{frequency} 638275970Scyfrequency offset (PPM) relative to hardware clock 639275970Scy@item @code{clk_wander} 640275970Scyclock frequency wander (PPM) 641275970Scy@item @code{clk_jitter} 642275970Scyclock jitter 643275970Scy@item @code{tai} 644275970ScyTAI-UTC offset (s) 645275970Scy@item @code{leapsec} 646275970ScyNTP seconds when the next leap second is/was inserted 647275970Scy@item @code{expire} 648275970ScyNTP seconds when the NIST leapseconds file expires 649275970Scy@end table 650275970ScyThe jitter and wander statistics are exponentially-weighted RMS averages. 651275970ScyThe system jitter is defined in the NTPv4 specification; 652275970Scythe clock jitter statistic is computed by the clock discipline module. 653275970Scy 654275970ScyWhen the NTPv4 daemon is compiled with the OpenSSL software library, 655275970Scyadditional system variables are displayed, 656275970Scyincluding some or all of the following, 657275970Scydepending on the particular Autokey dance: 658275970Scy 659275970Scy@table @asis 660275970Scy@item Variable 661275970ScyDescription 662275970Scy@item @code{host} 663275970ScyAutokey host name for this host 664275970Scy@item @code{ident} 665275970ScyAutokey group name for this host 666275970Scy@item @code{flags} 667275970Scyhost flags (see Autokey specification) 668275970Scy@item @code{digest} 669275970ScyOpenSSL message digest algorithm 670275970Scy@item @code{signature} 671275970ScyOpenSSL digest/signature scheme 672275970Scy@item @code{update} 673275970ScyNTP seconds at last signature update 674275970Scy@item @code{cert} 675275970Scycertificate subject, issuer and certificate flags 676275970Scy@item @code{until} 677275970ScyNTP seconds when the certificate expires 678275970Scy@end table 679275970Scy@subsubsection Peer Variables 680275970ScyThe following peer variables appear in the 681275970Scy@code{rv} 682275970Scybillboard for each association. 683275970ScyNot all variables are displayed in some configurations. 684275970Scy 685275970Scy@table @asis 686275970Scy@item Variable 687275970ScyDescription 688275970Scy@item @code{associd} 689275970Scyassociation ID 690275970Scy@item @code{status} 691275970Scy.Lk decode.html#peer "peer status word" 692275970Scy@item @code{srcadr} 693275970Scysource (remote) IP address 694275970Scy@item @code{srcport} 695275970Scysource (remote) port 696275970Scy@item @code{dstadr} 697275970Scydestination (local) IP address 698275970Scy@item @code{dstport} 699275970Scydestination (local) port 700275970Scy@item @code{leap} 701275970Scyleap indicator (0-3) 702275970Scy@item @code{stratum} 703275970Scystratum (0-15) 704275970Scy@item @code{precision} 705275970Scyprecision (log2 s) 706275970Scy@item @code{rootdelay} 707275970Scytotal roundtrip delay to the primary reference clock 708275970Scy@item @code{rootdisp} 709275970Scytotal root dispersion to the primary reference clock 710275970Scy@item @code{refid} 711275970Scyreference ID or 712275970Scy.Lk decode.html#kiss "kiss code" 713275970Scy@item @code{reftime} 714275970Scyreference time 715275970Scy@item @code{reach} 716275970Scyreach register (octal) 717275970Scy@item @code{unreach} 718275970Scyunreach counter 719275970Scy@item @code{hmode} 720275970Scyhost mode (1-6) 721275970Scy@item @code{pmode} 722275970Scypeer mode (1-5) 723275970Scy@item @code{hpoll} 724275970Scyhost poll exponent (log2 s) (3-17) 725275970Scy@item @code{ppoll} 726275970Scypeer poll exponent (log2 s) (3-17) 727275970Scy@item @code{headway} 728275970Scyheadway (see 729275970Scy.Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) 730275970Scy@item @code{flash} 731275970Scy.Lk decode.html#flash "flash status word" 732275970Scy@item @code{offset} 733275970Scyfilter offset 734275970Scy@item @code{delay} 735275970Scyfilter delay 736275970Scy@item @code{dispersion} 737275970Scyfilter dispersion 738275970Scy@item @code{jitter} 739275970Scyfilter jitter 740275970Scy@item @code{ident} 741275970ScyAutokey group name for this association 742275970Scy@item @code{bias} 743275970Scyunicast/broadcast bias 744275970Scy@item @code{xleave} 745275970Scyinterleave delay (see 746275970Scy.Lk xleave.html "NTP Interleaved Modes" ) 747275970Scy@end table 748275970ScyThe 749275970Scy@code{bias} 750275970Scyvariable is calculated when the first broadcast packet is received 751275970Scyafter the calibration volley. 752275970ScyIt represents the offset of the broadcast subgraph relative to the unicast subgraph. 753275970ScyThe 754275970Scy@code{xleave} 755275970Scyvariable appears only for the interleaved symmetric and interleaved modes. 756275970ScyIt represents the internal queuing, buffering and transmission delays 757275970Scyfor the preceding packet. 758275970Scy 759275970ScyWhen the NTPv4 daemon is compiled with the OpenSSL software library, 760275970Scyadditional peer variables are displayed, including the following: 761275970Scy@table @asis 762275970Scy@item Variable 763275970ScyDescription 764275970Scy@item @code{flags} 765275970Scypeer flags (see Autokey specification) 766275970Scy@item @code{host} 767275970ScyAutokey server name 768275970Scy@item @code{flags} 769275970Scypeer flags (see Autokey specification) 770275970Scy@item @code{signature} 771275970ScyOpenSSL digest/signature scheme 772275970Scy@item @code{initsequence} 773275970Scyinitial key ID 774275970Scy@item @code{initkey} 775275970Scyinitial key index 776275970Scy@item @code{timestamp} 777275970ScyAutokey signature timestamp 778275970Scy@end table 779275970Scy 780275970Scy@subsubsection Clock Variables 781275970ScyThe following clock variables appear in the 782275970Scy@code{cv} 783275970Scybillboard for each association with a reference clock. 784275970ScyNot all variables are displayed in some configurations. 785275970Scy@table @asis 786275970Scy@item Variable 787275970ScyDescription 788275970Scy@item @code{associd} 789275970Scyassociation ID 790275970Scy@item @code{status} 791275970Scy.Lk decode.html#clock "clock status word" 792275970Scy@item @code{device} 793275970Scydevice description 794275970Scy@item @code{timecode} 795275970ScyASCII time code string (specific to device) 796275970Scy@item @code{poll} 797275970Scypoll messages sent 798275970Scy@item @code{noreply} 799275970Scyno reply 800275970Scy@item @code{badformat} 801275970Scybad format 802275970Scy@item @code{baddata} 803275970Scybad date or time 804275970Scy@item @code{fudgetime1} 805275970Scyfudge time 1 806275970Scy@item @code{fudgetime2} 807275970Scyfudge time 2 808275970Scy@item @code{stratum} 809275970Scydriver stratum 810275970Scy@item @code{refid} 811275970Scydriver reference ID 812275970Scy@item @code{flags} 813275970Scydriver flags 814275970Scy@end table 815275970Scy 816275970ScyThis section was generated by @strong{AutoGen}, 817275970Scyusing the @code{agtexi-cmd} template and the option descriptions for the @code{ntpq} program. 818275970ScyThis software is released under the NTP license, <http://ntp.org/license>. 819275970Scy 820275970Scy@menu 821275970Scy* ntpq usage:: ntpq help/usage (@option{--help}) 822275970Scy* ntpq ipv4:: ipv4 option (-4) 823275970Scy* ntpq ipv6:: ipv6 option (-6) 824275970Scy* ntpq command:: command option (-c) 825275970Scy* ntpq interactive:: interactive option (-i) 826275970Scy* ntpq numeric:: numeric option (-n) 827275970Scy* ntpq old-rv:: old-rv option 828275970Scy* ntpq peers:: peers option (-p) 829298770Sdelphij* ntpq refid:: refid option (-r) 830275970Scy* ntpq wide:: wide option (-w) 831275970Scy* ntpq config:: presetting/configuring ntpq 832275970Scy* ntpq exit status:: exit status 833275970Scy@end menu 834275970Scy 835275970Scy@node ntpq usage 836275970Scy@subsection ntpq help/usage (@option{--help}) 837275970Scy@cindex ntpq help 838275970Scy 839275970ScyThis is the automatically generated usage text for ntpq. 840275970Scy 841275970ScyThe text printed is the same whether selected with the @code{help} option 842275970Scy(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print 843275970Scythe usage text by passing it through a pager program. 844275970Scy@code{more-help} is disabled on platforms without a working 845275970Scy@code{fork(2)} function. The @code{PAGER} environment variable is 846275970Scyused to select the program, defaulting to @file{more}. Both will exit 847275970Scywith a status code of 0. 848275970Scy 849275970Scy@exampleindent 0 850275970Scy@example 851310419Sdelphijntpq - standard NTP query program - Ver. 4.2.8p9 852275970ScyUsage: ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...] 853275970Scy Flg Arg Option-Name Description 854275970Scy -4 no ipv4 Force IPv4 DNS name resolution 855275970Scy - prohibits the option 'ipv6' 856275970Scy -6 no ipv6 Force IPv6 DNS name resolution 857275970Scy - prohibits the option 'ipv4' 858275970Scy -c Str command run a command and exit 859275970Scy - may appear multiple times 860275970Scy -d no debug-level Increase debug verbosity level 861275970Scy - may appear multiple times 862275970Scy -D Num set-debug-level Set the debug verbosity level 863275970Scy - may appear multiple times 864275970Scy -i no interactive Force ntpq to operate in interactive mode 865275970Scy - prohibits these options: 866275970Scy command 867275970Scy peers 868275970Scy -n no numeric numeric host addresses 869275970Scy no old-rv Always output status line with readvar 870275970Scy -p no peers Print a list of the peers 871275970Scy - prohibits the option 'interactive' 872298770Sdelphij -r KWd refid Set default display type for S2+ refids 873275970Scy -w no wide Display the full 'remote' value 874275970Scy opt version output version information and exit 875275970Scy -? no help display extended usage information and exit 876275970Scy -! no more-help extended usage information passed thru pager 877275970Scy -> opt save-opts save the option state to a config file 878275970Scy -< Str load-opts load options from a config file 879275970Scy - disabled as '--no-load-opts' 880275970Scy - may appear multiple times 881275970Scy 882275970ScyOptions are specified by doubled hyphens and their name or by a single 883275970Scyhyphen and the flag character. 884275970Scy 885275970ScyThe following option preset mechanisms are supported: 886275970Scy - reading file $HOME/.ntprc 887275970Scy - reading file ./.ntprc 888275970Scy - examining environment variables named NTPQ_* 889275970Scy 890298770SdelphijThe valid "refid" option keywords are: 891298770Sdelphij hash ipv4 892298770Sdelphij or an integer from 0 through 1 893298770Sdelphij 894275970ScyPlease send bug reports to: <http://bugs.ntp.org, bugs@@ntp.org> 895275970Scy@end example 896275970Scy@exampleindent 4 897275970Scy 898275970Scy@node ntpq ipv4 899275970Scy@subsection ipv4 option (-4) 900275970Scy@cindex ntpq-ipv4 901275970Scy 902275970ScyThis is the ``force ipv4 dns name resolution'' option. 903275970Scy 904275970Scy@noindent 905275970ScyThis option has some usage constraints. It: 906275970Scy@itemize @bullet 907275970Scy@item 908275970Scymust not appear in combination with any of the following options: 909275970Scyipv6. 910275970Scy@end itemize 911275970Scy 912275970ScyForce DNS resolution of following host names on the command line 913275970Scyto the IPv4 namespace. 914275970Scy@node ntpq ipv6 915275970Scy@subsection ipv6 option (-6) 916275970Scy@cindex ntpq-ipv6 917275970Scy 918275970ScyThis is the ``force ipv6 dns name resolution'' option. 919275970Scy 920275970Scy@noindent 921275970ScyThis option has some usage constraints. It: 922275970Scy@itemize @bullet 923275970Scy@item 924275970Scymust not appear in combination with any of the following options: 925275970Scyipv4. 926275970Scy@end itemize 927275970Scy 928275970ScyForce DNS resolution of following host names on the command line 929275970Scyto the IPv6 namespace. 930275970Scy@node ntpq command 931275970Scy@subsection command option (-c) 932275970Scy@cindex ntpq-command 933275970Scy 934275970ScyThis is the ``run a command and exit'' option. 935275970ScyThis option takes a string argument @file{cmd}. 936275970Scy 937275970Scy@noindent 938275970ScyThis option has some usage constraints. It: 939275970Scy@itemize @bullet 940275970Scy@item 941275970Scymay appear an unlimited number of times. 942275970Scy@end itemize 943275970Scy 944275970ScyThe following argument is interpreted as an interactive format command 945275970Scyand is added to the list of commands to be executed on the specified 946275970Scyhost(s). 947275970Scy@node ntpq interactive 948275970Scy@subsection interactive option (-i) 949275970Scy@cindex ntpq-interactive 950275970Scy 951275970ScyThis is the ``force ntpq to operate in interactive mode'' option. 952275970Scy 953275970Scy@noindent 954275970ScyThis option has some usage constraints. It: 955275970Scy@itemize @bullet 956275970Scy@item 957275970Scymust not appear in combination with any of the following options: 958275970Scycommand, peers. 959275970Scy@end itemize 960275970Scy 961275970ScyForce @code{ntpq} to operate in interactive mode. 962275970ScyPrompts will be written to the standard output and 963275970Scycommands read from the standard input. 964275970Scy@node ntpq numeric 965275970Scy@subsection numeric option (-n) 966275970Scy@cindex ntpq-numeric 967275970Scy 968275970ScyThis is the ``numeric host addresses'' option. 969275970ScyOutput all host addresses in dotted-quad numeric format rather than 970275970Scyconverting to the canonical host names. 971275970Scy@node ntpq old-rv 972275970Scy@subsection old-rv option 973275970Scy@cindex ntpq-old-rv 974275970Scy 975275970ScyThis is the ``always output status line with readvar'' option. 976275970ScyBy default, @code{ntpq} now suppresses the @code{associd=...} 977275970Scyline that precedes the output of @code{readvar} 978275970Scy(alias @code{rv}) when a single variable is requested, such as 979275970Scy@code{ntpq -c "rv 0 offset"}. 980275970ScyThis option causes @code{ntpq} to include both lines of output 981275970Scyfor a single-variable @code{readvar}. 982275970ScyUsing an environment variable to 983275970Scypreset this option in a script will enable both older and 984275970Scynewer @code{ntpq} to behave identically in this regard. 985275970Scy@node ntpq peers 986275970Scy@subsection peers option (-p) 987275970Scy@cindex ntpq-peers 988275970Scy 989275970ScyThis is the ``print a list of the peers'' option. 990275970Scy 991275970Scy@noindent 992275970ScyThis option has some usage constraints. It: 993275970Scy@itemize @bullet 994275970Scy@item 995275970Scymust not appear in combination with any of the following options: 996275970Scyinteractive. 997275970Scy@end itemize 998275970Scy 999275970ScyPrint a list of the peers known to the server as well as a summary 1000275970Scyof their state. This is equivalent to the 'peers' interactive command. 1001298770Sdelphij@node ntpq refid 1002298770Sdelphij@subsection refid option (-r) 1003298770Sdelphij@cindex ntpq-refid 1004298770Sdelphij 1005298770SdelphijThis is the ``set default display type for s2+ refids'' option. 1006298770SdelphijThis option takes a keyword argument. 1007298770Sdelphij 1008298770Sdelphij@noindent 1009298770SdelphijThis option has some usage constraints. It: 1010298770Sdelphij@itemize @bullet 1011298770Sdelphij@item 1012298770SdelphijThis option takes a keyword as its argument. 1013298770SdelphijThe argument sets an enumeration value that can be tested by comparing the option value macro (OPT_VALUE_REFID). 1014298770SdelphijThe available keywords are: 1015298770Sdelphij@example 1016298770Sdelphij hash ipv4 1017298770Sdelphij@end example 1018298770Sdelphij 1019298770Sdelphijor their numeric equivalent.@end itemize 1020298770Sdelphij 1021298770SdelphijSet the default display format for S2+ refids. 1022275970Scy@node ntpq wide 1023275970Scy@subsection wide option (-w) 1024275970Scy@cindex ntpq-wide 1025275970Scy 1026275970ScyThis is the ``display the full 'remote' value'' option. 1027275970ScyDisplay the full value of the 'remote' value. If this requires 1028275970Scymore than 15 characters, display the full value, emit a newline, 1029275970Scyand continue the data display properly indented on the next line. 1030275970Scy 1031275970Scy 1032275970Scy@node ntpq config 1033275970Scy@subsection presetting/configuring ntpq 1034275970Scy 1035275970ScyAny option that is not marked as @i{not presettable} may be preset by 1036275970Scyloading values from configuration ("rc" or "ini") files, and values from environment variables named @code{NTPQ} and @code{NTPQ_<OPTION_NAME>}. @code{<OPTION_NAME>} must be one of 1037275970Scythe options listed above in upper case and segmented with underscores. 1038275970ScyThe @code{NTPQ} variable will be tokenized and parsed like 1039275970Scythe command line. The remaining variables are tested for existence and their 1040275970Scyvalues are treated like option arguments. 1041275970Scy 1042275970Scy 1043275970Scy@noindent 1044275970Scy@code{libopts} will search in 2 places for configuration files: 1045275970Scy@itemize @bullet 1046275970Scy@item 1047275970Scy$HOME 1048275970Scy@item 1049275970Scy$PWD 1050275970Scy@end itemize 1051275970ScyThe environment variables @code{HOME}, and @code{PWD} 1052275970Scyare expanded and replaced when @file{ntpq} runs. 1053275970ScyFor any of these that are plain files, they are simply processed. 1054275970ScyFor any that are directories, then a file named @file{.ntprc} is searched for 1055275970Scywithin that directory and processed. 1056275970Scy 1057275970ScyConfiguration files may be in a wide variety of formats. 1058275970ScyThe basic format is an option name followed by a value (argument) on the 1059275970Scysame line. Values may be separated from the option name with a colon, 1060275970Scyequal sign or simply white space. Values may be continued across multiple 1061275970Scylines by escaping the newline with a backslash. 1062275970Scy 1063275970ScyMultiple programs may also share the same initialization file. 1064275970ScyCommon options are collected at the top, followed by program specific 1065275970Scysegments. The segments are separated by lines like: 1066275970Scy@example 1067275970Scy[NTPQ] 1068275970Scy@end example 1069275970Scy@noindent 1070275970Scyor by 1071275970Scy@example 1072275970Scy<?program ntpq> 1073275970Scy@end example 1074275970Scy@noindent 1075275970ScyDo not mix these styles within one configuration file. 1076275970Scy 1077275970ScyCompound values and carefully constructed string values may also be 1078275970Scyspecified using XML syntax: 1079275970Scy@example 1080275970Scy<option-name> 1081275970Scy <sub-opt>...<...>...</sub-opt> 1082275970Scy</option-name> 1083275970Scy@end example 1084275970Scy@noindent 1085275970Scyyielding an @code{option-name.sub-opt} string value of 1086275970Scy@example 1087275970Scy"...<...>..." 1088275970Scy@end example 1089275970Scy@code{AutoOpts} does not track suboptions. You simply note that it is a 1090275970Scyhierarchicly valued option. @code{AutoOpts} does provide a means for searching 1091275970Scythe associated name/value pair list (see: optionFindValue). 1092275970Scy 1093275970ScyThe command line options relating to configuration and/or usage help are: 1094275970Scy 1095275970Scy@subsubheading version (-) 1096275970Scy 1097275970ScyPrint the program version to standard out, optionally with licensing 1098275970Scyinformation, then exit 0. The optional argument specifies how much licensing 1099275970Scydetail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument. 1100275970ScyOnly the first letter of the argument is examined: 1101275970Scy 1102275970Scy@table @samp 1103275970Scy@item version 1104275970ScyOnly print the version. This is the default. 1105275970Scy@item copyright 1106275970ScyName the copyright usage licensing terms. 1107275970Scy@item verbose 1108275970ScyPrint the full copyright usage licensing terms. 1109275970Scy@end table 1110275970Scy 1111275970Scy@node ntpq exit status 1112275970Scy@subsection ntpq exit status 1113275970Scy 1114275970ScyOne of the following exit values will be returned: 1115275970Scy@table @samp 1116275970Scy@item 0 (EXIT_SUCCESS) 1117275970ScySuccessful program execution. 1118275970Scy@item 1 (EXIT_FAILURE) 1119275970ScyThe operation failed or the command syntax was not valid. 1120275970Scy@item 66 (EX_NOINPUT) 1121275970ScyA specified configuration file could not be loaded. 1122275970Scy@item 70 (EX_SOFTWARE) 1123275970Scylibopts had an internal operational error. Please report 1124275970Scyit to autogen-users@@lists.sourceforge.net. Thank you. 1125275970Scy@end table 1126