ntpq.html revision 1.1.1.2.2.5
1 1.1.1.2.2.2 snj <html lang="en"> 2 1.1.1.2.2.2 snj <head> 3 1.1.1.2.2.2 snj <title>ntpq: Network Time Protocol Query User's Manual</title> 4 1.1.1.2.2.2 snj <meta http-equiv="Content-Type" content="text/html"> 5 1.1.1.2.2.2 snj <meta name="description" content="ntpq: Network Time Protocol Query User's Manual"> 6 1.1.1.2.2.2 snj <meta name="generator" content="makeinfo 4.7"> 7 1.1.1.2.2.2 snj <link title="Top" rel="top" href="#Top"> 8 1.1.1.2.2.2 snj <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 9 1.1.1.2.2.2 snj <meta http-equiv="Content-Style-Type" content="text/css"> 10 1.1.1.2.2.2 snj <style type="text/css"><!-- 11 1.1.1.2.2.2 snj pre.display { font-family:inherit } 12 1.1.1.2.2.2 snj pre.format { font-family:inherit } 13 1.1.1.2.2.2 snj pre.smalldisplay { font-family:inherit; font-size:smaller } 14 1.1.1.2.2.2 snj pre.smallformat { font-family:inherit; font-size:smaller } 15 1.1.1.2.2.2 snj pre.smallexample { font-size:smaller } 16 1.1.1.2.2.2 snj pre.smalllisp { font-size:smaller } 17 1.1.1.2.2.2 snj span.sc { font-variant:small-caps } 18 1.1.1.2.2.2 snj span.roman { font-family: serif; font-weight: normal; } 19 1.1.1.2.2.2 snj --></style> 20 1.1.1.2.2.2 snj </head> 21 1.1.1.2.2.2 snj <body> 22 1.1.1.2.2.2 snj <h1 class="settitle">ntpq: Network Time Protocol Query User's Manual</h1> 23 1.1.1.2.2.2 snj <div class="shortcontents"> 24 1.1.1.2.2.2 snj <h2>Short Contents</h2> 25 1.1.1.2.2.2 snj <ul> 26 1.1.1.2.2.2 snj <a href="#Top">ntpq: Network Time Protocol Query User Manual</a> 27 1.1.1.2.2.2 snj </ul> 28 1.1.1.2.2.2 snj </div> 29 1.1.1.2.2.2 snj 30 1.1.1.2.2.2 snj 31 1.1.1.2.2.2 snj 32 1.1.1.2.2.2 snj <div class="node"> 33 1.1.1.2.2.2 snj <p><hr> 34 1.1.1.2.2.2 snj <a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpq-Description">ntpq Description</a>, 35 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, 36 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#dir">(dir)</a> 37 1.1.1.2.2.2 snj <br> 38 1.1.1.2.2.2 snj </div> 39 1.1.1.2.2.2 snj 40 1.1.1.2.2.2 snj <h2 class="unnumbered">ntpq: Network Time Protocol Query User Manual</h2> 41 1.1.1.2.2.2 snj 42 1.1.1.2.2.2 snj <p>The <code>ntpq</code> utility program is used to 43 1.1.1.2.2.2 snj monitor the operational status 44 1.1.1.2.2.2 snj and determine the performance of 45 1.1.1.2.2.2 snj <code>ntpd</code>, the NTP daemon. 46 1.1.1.2.2.2 snj 47 1.1.1.2.2.5 snj <p>This document applies to version 4.2.8p10 of <code>ntpq</code>. 48 1.1.1.2.2.2 snj 49 1.1.1.2.2.2 snj <ul class="menu"> 50 1.1.1.2.2.2 snj <li><a accesskey="1" href="#ntpq-Description">ntpq Description</a> 51 1.1.1.2.2.2 snj <li><a accesskey="2" href="#ntpq-Invocation">ntpq Invocation</a>: Invoking ntpq 52 1.1.1.2.2.2 snj <li><a accesskey="3" href="#Usage">Usage</a> 53 1.1.1.2.2.2 snj <li><a accesskey="4" href="#Internal-Commands">Internal Commands</a> 54 1.1.1.2.2.2 snj <li><a accesskey="5" href="#Control-Message-Commands">Control Message Commands</a> 55 1.1.1.2.2.2 snj <li><a accesskey="6" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a> 56 1.1.1.2.2.2 snj <li><a accesskey="7" href="#System-Variables">System Variables</a> 57 1.1.1.2.2.2 snj <li><a accesskey="8" href="#Peer-Variables">Peer Variables</a> 58 1.1.1.2.2.2 snj <li><a accesskey="9" href="#Clock-Variables">Clock Variables</a> 59 1.1.1.2.2.2 snj </ul> 60 1.1.1.2.2.2 snj 61 1.1.1.2.2.2 snj <div class="node"> 62 1.1.1.2.2.2 snj <p><hr> 63 1.1.1.2.2.2 snj <a name="ntpq-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>, 64 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>, 65 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 66 1.1.1.2.2.2 snj <br> 67 1.1.1.2.2.2 snj </div> 68 1.1.1.2.2.2 snj 69 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 70 1.1.1.2.2.2 snj <h3 class="section">Description</h3> 71 1.1.1.2.2.2 snj 72 1.1.1.2.2.2 snj <p>The <code>ntpq</code> utility program is used to monitor NTP daemon <code>ntpd</code> operations and determine performance. 73 1.1.1.2.2.2 snj It uses the standard NTP mode 6 control message formats defined in 74 1.1.1.2.2.2 snj Appendix B of the NTPv3 specification RFC1305. 75 1.1.1.2.2.2 snj The same formats are used in NTPv4, although some of the variable names have changed and new ones added. 76 1.1.1.2.2.2 snj The description on this page is for the NTPv4 variables. 77 1.1.1.2.2.2 snj 78 1.1.1.2.2.2 snj <p>The program can be run either in interactive mode or controlled using command line arguments. Requests to read and write arbitrary variables can be assembled, with raw and pretty-printed output options being available. The <code>ntpq</code> can also obtain and print a list of peers in a common format by sending multiple queries to the server. 79 1.1.1.2.2.2 snj 80 1.1.1.2.2.2 snj <p>If one or more request options is included on the command line when <code>ntpq</code> is executed, each of the requests will be sent to the NTP servers running on each of the hosts given as command line arguments, or on localhost by default. If no request options are given, <code>ntpq</code> will attempt to read commands from the standard input and execute these on the NTP server running on the first host given on the command line, again defaulting to localhost when no other host is specified. <code>ntpq</code> will prompt for commands if the standard input is a terminal device. 81 1.1.1.2.2.2 snj 82 1.1.1.2.2.2 snj <p><code>ntpq</code> uses NTP mode 6 packets to communicate with the NTP server, and hence can be used to query any compatible server on the network which permits it. Note that since NTP is a UDP protocol this communication will be somewhat unreliable, especially over large distances in terms of network topology. <code>ntpq</code> makes one attempt to retransmit requests, and will time requests out if the remote host is not heard from within a suitable timeout time. 83 1.1.1.2.2.2 snj 84 1.1.1.2.2.2 snj <p>Note that in contexts where a host name is expected, a <code>-4</code> qualifier preceding the host name forces DNS resolution to the IPv4 namespace, while a <code>-6</code> qualifier forces DNS resolution to the IPv6 namespace. 85 1.1.1.2.2.2 snj 86 1.1.1.2.2.2 snj <p>For examples and usage, see the <a href="debug.html">NTP Debugging Techniques</a> page. 87 1.1.1.2.2.2 snj 88 1.1.1.2.2.2 snj <div class="node"> 89 1.1.1.2.2.2 snj <p><hr> 90 1.1.1.2.2.2 snj <a name="ntpq-Invocation"></a> 91 1.1.1.2.2.2 snj <br> 92 1.1.1.2.2.2 snj </div> 93 1.1.1.2.2.2 snj 94 1.1.1.2.2.2 snj <h3 class="section">Invoking ntpq</h3> 95 1.1.1.2.2.2 snj 96 1.1.1.2.2.2 snj <p><a name="index-ntpq-1"></a><a name="index-standard-NTP-query-program-2"></a> 97 1.1.1.2.2.2 snj 98 1.1.1.2.2.2 snj <p>The 99 1.1.1.2.2.2 snj <code>ntpq</code> 100 1.1.1.2.2.2 snj utility program is used to query NTP servers which 101 1.1.1.2.2.2 snj implement the standard NTP mode 6 control message formats defined 102 1.1.1.2.2.2 snj in Appendix B of the NTPv3 specification RFC1305, requesting 103 1.1.1.2.2.2 snj information about current state and/or changes in that state. 104 1.1.1.2.2.2 snj The same formats are used in NTPv4, although some of the 105 1.1.1.2.2.2 snj variables have changed and new ones added. The description on this 106 1.1.1.2.2.2 snj page is for the NTPv4 variables. 107 1.1.1.2.2.2 snj The program may be run either in interactive mode or controlled using 108 1.1.1.2.2.2 snj command line arguments. 109 1.1.1.2.2.2 snj Requests to read and write arbitrary 110 1.1.1.2.2.2 snj variables can be assembled, with raw and pretty-printed output 111 1.1.1.2.2.2 snj options being available. 112 1.1.1.2.2.2 snj The 113 1.1.1.2.2.2 snj <code>ntpq</code> 114 1.1.1.2.2.2 snj utility can also obtain and print a 115 1.1.1.2.2.2 snj list of peers in a common format by sending multiple queries to the 116 1.1.1.2.2.2 snj server. 117 1.1.1.2.2.2 snj 118 1.1.1.2.2.2 snj <p>If one or more request options is included on the command line 119 1.1.1.2.2.2 snj when 120 1.1.1.2.2.2 snj <code>ntpq</code> 121 1.1.1.2.2.2 snj is executed, each of the requests will be sent 122 1.1.1.2.2.2 snj to the NTP servers running on each of the hosts given as command 123 1.1.1.2.2.2 snj line arguments, or on localhost by default. 124 1.1.1.2.2.2 snj If no request options 125 1.1.1.2.2.2 snj are given, 126 1.1.1.2.2.2 snj <code>ntpq</code> 127 1.1.1.2.2.2 snj will attempt to read commands from the 128 1.1.1.2.2.2 snj standard input and execute these on the NTP server running on the 129 1.1.1.2.2.2 snj first host given on the command line, again defaulting to localhost 130 1.1.1.2.2.2 snj when no other host is specified. 131 1.1.1.2.2.2 snj The 132 1.1.1.2.2.2 snj <code>ntpq</code> 133 1.1.1.2.2.2 snj utility will prompt for 134 1.1.1.2.2.2 snj commands if the standard input is a terminal device. 135 1.1.1.2.2.2 snj 136 1.1.1.2.2.2 snj <p><code>ntpq</code> 137 1.1.1.2.2.2 snj uses NTP mode 6 packets to communicate with the 138 1.1.1.2.2.2 snj NTP server, and hence can be used to query any compatible server on 139 1.1.1.2.2.2 snj the network which permits it. 140 1.1.1.2.2.2 snj Note that since NTP is a UDP protocol 141 1.1.1.2.2.2 snj this communication will be somewhat unreliable, especially over 142 1.1.1.2.2.2 snj large distances in terms of network topology. 143 1.1.1.2.2.2 snj The 144 1.1.1.2.2.2 snj <code>ntpq</code> 145 1.1.1.2.2.2 snj utility makes 146 1.1.1.2.2.2 snj one attempt to retransmit requests, and will time requests out if 147 1.1.1.2.2.2 snj the remote host is not heard from within a suitable timeout 148 1.1.1.2.2.2 snj time. 149 1.1.1.2.2.2 snj 150 1.1.1.2.2.2 snj <p>Specifying a 151 1.1.1.2.2.2 snj command line option other than 152 1.1.1.2.2.2 snj <code>-i</code> 153 1.1.1.2.2.2 snj or 154 1.1.1.2.2.2 snj <code>-n</code> 155 1.1.1.2.2.2 snj will 156 1.1.1.2.2.2 snj cause the specified query (queries) to be sent to the indicated 157 1.1.1.2.2.2 snj host(s) immediately. 158 1.1.1.2.2.2 snj Otherwise, 159 1.1.1.2.2.2 snj <code>ntpq</code> 160 1.1.1.2.2.2 snj will attempt to read 161 1.1.1.2.2.2 snj interactive format commands from the standard input. 162 1.1.1.2.2.2 snj 163 1.1.1.2.2.2 snj <h5 class="subsubsection">Internal Commands</h5> 164 1.1.1.2.2.2 snj 165 1.1.1.2.2.2 snj <p>Interactive format commands consist of a keyword followed by zero 166 1.1.1.2.2.2 snj to four arguments. 167 1.1.1.2.2.2 snj Only enough characters of the full keyword to 168 1.1.1.2.2.2 snj uniquely identify the command need be typed. 169 1.1.1.2.2.2 snj 170 1.1.1.2.2.2 snj <p>A 171 1.1.1.2.2.2 snj number of interactive format commands are executed entirely within 172 1.1.1.2.2.2 snj the 173 1.1.1.2.2.2 snj <code>ntpq</code> 174 1.1.1.2.2.2 snj utility itself and do not result in NTP mode 6 175 1.1.1.2.2.2 snj requests being sent to a server. 176 1.1.1.2.2.2 snj These are described following. 177 1.1.1.2.2.2 snj <dl> 178 1.1.1.2.2.2 snj <dt><code>?</code> <code>[</code><kbd>command_keyword</kbd><code>]</code><br><dt><code>help</code> <code>[</code><kbd>command_keyword</kbd><code>]</code><dd>A 179 1.1.1.2.2.2 snj ? 180 1.1.1.2.2.2 snj by itself will print a list of all the command 181 1.1.1.2.2.2 snj keywords known to this incarnation of 182 1.1.1.2.2.2 snj <code>ntpq</code> 183 1.1.1.2.2.2 snj A 184 1.1.1.2.2.2 snj ? 185 1.1.1.2.2.2 snj followed by a command keyword will print function and usage 186 1.1.1.2.2.2 snj information about the command. 187 1.1.1.2.2.2 snj This command is probably a better 188 1.1.1.2.2.2 snj source of information about 189 1.1.1.2.2.2 snj <code>ntpq</code> 190 1.1.1.2.2.2 snj than this manual 191 1.1.1.2.2.2 snj page. 192 1.1.1.2.2.2 snj <br><dt><code>addvars</code> <kbd>variable_name</kbd><code>[=value]</code> <code>...</code><br><dt><code>rmvars</code> <kbd>variable_name</kbd> <code>...</code><br><dt><code>clearvars</code><br><dt><code>showvars</code><dd>The data carried by NTP mode 6 messages consists of a list of 193 1.1.1.2.2.2 snj items of the form 194 1.1.1.2.2.2 snj variable_name=value, 195 1.1.1.2.2.2 snj where the 196 1.1.1.2.2.2 snj =value 197 1.1.1.2.2.2 snj is ignored, and can be omitted, 198 1.1.1.2.2.2 snj in requests to the server to read variables. 199 1.1.1.2.2.2 snj The 200 1.1.1.2.2.2 snj <code>ntpq</code> 201 1.1.1.2.2.2 snj utility maintains an internal list in which data to be included in control 202 1.1.1.2.2.2 snj messages can be assembled, and sent using the 203 1.1.1.2.2.2 snj <code>readlist</code> 204 1.1.1.2.2.2 snj and 205 1.1.1.2.2.2 snj <code>writelist</code> 206 1.1.1.2.2.2 snj commands described below. 207 1.1.1.2.2.2 snj The 208 1.1.1.2.2.2 snj <code>addvars</code> 209 1.1.1.2.2.2 snj command allows variables and their optional values to be added to 210 1.1.1.2.2.2 snj the list. 211 1.1.1.2.2.2 snj If more than one variable is to be added, the list should 212 1.1.1.2.2.2 snj be comma-separated and not contain white space. 213 1.1.1.2.2.2 snj The 214 1.1.1.2.2.2 snj <code>rmvars</code> 215 1.1.1.2.2.2 snj command can be used to remove individual variables from the list, 216 1.1.1.2.2.2 snj while the 217 1.1.1.2.2.2 snj <code>clearlist</code> 218 1.1.1.2.2.2 snj command removes all variables from the 219 1.1.1.2.2.2 snj list. 220 1.1.1.2.2.2 snj The 221 1.1.1.2.2.2 snj <code>showvars</code> 222 1.1.1.2.2.2 snj command displays the current list of optional variables. 223 1.1.1.2.2.2 snj <br><dt><code>authenticate</code> <code>[yes | no]</code><dd>Normally 224 1.1.1.2.2.2 snj <code>ntpq</code> 225 1.1.1.2.2.2 snj does not authenticate requests unless 226 1.1.1.2.2.2 snj they are write requests. 227 1.1.1.2.2.2 snj The command 228 1.1.1.2.2.2 snj authenticate yes 229 1.1.1.2.2.2 snj causes 230 1.1.1.2.2.2 snj <code>ntpq</code> 231 1.1.1.2.2.2 snj to send authentication with all requests it 232 1.1.1.2.2.2 snj makes. 233 1.1.1.2.2.2 snj Authenticated requests causes some servers to handle 234 1.1.1.2.2.2 snj requests slightly differently, and can occasionally melt the CPU in 235 1.1.1.2.2.2 snj fuzzballs if you turn authentication on before doing a 236 1.1.1.2.2.2 snj <code>peer</code> 237 1.1.1.2.2.2 snj display. 238 1.1.1.2.2.2 snj The command 239 1.1.1.2.2.2 snj authenticate 240 1.1.1.2.2.2 snj causes 241 1.1.1.2.2.2 snj <code>ntpq</code> 242 1.1.1.2.2.2 snj to display whether or not 243 1.1.1.2.2.2 snj <code>ntpq</code> 244 1.1.1.2.2.2 snj is currently autheinticating requests. 245 1.1.1.2.2.2 snj <br><dt><code>cooked</code><dd>Causes output from query commands to be "cooked", so that 246 1.1.1.2.2.2 snj variables which are recognized by 247 1.1.1.2.2.2 snj <code>ntpq</code> 248 1.1.1.2.2.2 snj will have their 249 1.1.1.2.2.2 snj values reformatted for human consumption. 250 1.1.1.2.2.2 snj Variables which 251 1.1.1.2.2.2 snj <code>ntpq</code> 252 1.1.1.2.2.2 snj thinks should have a decodable value but didn't are 253 1.1.1.2.2.2 snj marked with a trailing 254 1.1.1.2.2.2 snj ?. 255 1.1.1.2.2.2 snj <br><dt><code>debug</code> <code>[more | less | off]</code><dd>With no argument, displays the current debug level. 256 1.1.1.2.2.2 snj Otherwise, the debug level is changed to the indicated level. 257 1.1.1.2.2.2 snj <br><dt><code>delay</code> <kbd>milliseconds</kbd><dd>Specify a time interval to be added to timestamps included in 258 1.1.1.2.2.2 snj requests which require authentication. 259 1.1.1.2.2.2 snj This is used to enable 260 1.1.1.2.2.2 snj (unreliable) server reconfiguration over long delay network paths 261 1.1.1.2.2.2 snj or between machines whose clocks are unsynchronized. 262 1.1.1.2.2.2 snj Actually the 263 1.1.1.2.2.2 snj server does not now require timestamps in authenticated requests, 264 1.1.1.2.2.2 snj so this command may be obsolete. 265 1.1.1.2.2.2 snj <br><dt><code>exit</code><dd>Exit 266 1.1.1.2.2.2 snj <code>ntpq</code> 267 1.1.1.2.2.2 snj <br><dt><code>host</code> <kbd>hostname</kbd><dd>Set the host to which future queries will be sent. 268 1.1.1.2.2.2 snj <kbd>hostname</kbd> 269 1.1.1.2.2.2 snj may be either a host name or a numeric address. 270 1.1.1.2.2.2 snj <br><dt><code>hostnames</code> <code>[yes | no]</code><dd>If 271 1.1.1.2.2.2 snj <code>yes</code> 272 1.1.1.2.2.2 snj is specified, host names are printed in 273 1.1.1.2.2.2 snj information displays. 274 1.1.1.2.2.2 snj If 275 1.1.1.2.2.2 snj <code>no</code> 276 1.1.1.2.2.2 snj is specified, numeric 277 1.1.1.2.2.2 snj addresses are printed instead. 278 1.1.1.2.2.2 snj The default is 279 1.1.1.2.2.2 snj <code>yes</code>, 280 1.1.1.2.2.2 snj unless 281 1.1.1.2.2.2 snj modified using the command line 282 1.1.1.2.2.2 snj <code>-n</code> 283 1.1.1.2.2.2 snj switch. 284 1.1.1.2.2.2 snj <br><dt><code>keyid</code> <kbd>keyid</kbd><dd>This command allows the specification of a key number to be 285 1.1.1.2.2.2 snj used to authenticate configuration requests. 286 1.1.1.2.2.2 snj This must correspond 287 1.1.1.2.2.3 snj to the 288 1.1.1.2.2.3 snj <code>controlkey</code> 289 1.1.1.2.2.3 snj key number the server has been configured to use for this 290 1.1.1.2.2.2 snj purpose. 291 1.1.1.2.2.2 snj <br><dt><code>keytype</code> <code>[md5 | OpenSSLDigestType]</code><dd>Specify the type of key to use for authenticating requests. 292 1.1.1.2.2.2 snj <code>md5</code> 293 1.1.1.2.2.2 snj is alway supported. 294 1.1.1.2.2.2 snj If 295 1.1.1.2.2.2 snj <code>ntpq</code> 296 1.1.1.2.2.2 snj was built with OpenSSL support, 297 1.1.1.2.2.2 snj any digest type supported by OpenSSL can also be provided. 298 1.1.1.2.2.2 snj If no argument is given, the current 299 1.1.1.2.2.2 snj <code>keytype</code> 300 1.1.1.2.2.2 snj is displayed. 301 1.1.1.2.2.2 snj <br><dt><code>ntpversion</code> <code>[1 | 2 | 3 | 4]</code><dd>Sets the NTP version number which 302 1.1.1.2.2.2 snj <code>ntpq</code> 303 1.1.1.2.2.2 snj claims in 304 1.1.1.2.2.2 snj packets. 305 1.1.1.2.2.2 snj Defaults to 3, and note that mode 6 control messages (and 306 1.1.1.2.2.2 snj modes, for that matter) didn't exist in NTP version 1. 307 1.1.1.2.2.2 snj There appear 308 1.1.1.2.2.2 snj to be no servers left which demand version 1. 309 1.1.1.2.2.2 snj With no argument, displays the current NTP version that will be used 310 1.1.1.2.2.2 snj when communicating with servers. 311 1.1.1.2.2.2 snj <br><dt><code>passwd</code><dd>This command prompts you to type in a password (which will not 312 1.1.1.2.2.2 snj be echoed) which will be used to authenticate configuration 313 1.1.1.2.2.2 snj requests. 314 1.1.1.2.2.2 snj The password must correspond to the key configured for 315 1.1.1.2.2.2 snj use by the NTP server for this purpose if such requests are to be 316 1.1.1.2.2.2 snj successful. 317 1.1.1.2.2.2 snj <code>poll</code> 318 1.1.1.2.2.2 snj <kbd>n</kbd> 319 1.1.1.2.2.2 snj <code>verbose</code> 320 1.1.1.2.2.2 snj <br><dt><code>quit</code><dd>Exit 321 1.1.1.2.2.2 snj <code>ntpq</code> 322 1.1.1.2.2.2 snj <br><dt><code>raw</code><dd>Causes all output from query commands is printed as received 323 1.1.1.2.2.2 snj from the remote server. 324 1.1.1.2.2.2 snj The only formating/interpretation done on 325 1.1.1.2.2.2 snj the data is to transform nonascii data into a printable (but barely 326 1.1.1.2.2.2 snj understandable) form. 327 1.1.1.2.2.2 snj <br><dt><code>timeout</code> <kbd>milliseconds</kbd><dd>Specify a timeout period for responses to server queries. 328 1.1.1.2.2.2 snj The 329 1.1.1.2.2.2 snj default is about 5000 milliseconds. 330 1.1.1.2.2.2 snj Note that since 331 1.1.1.2.2.2 snj <code>ntpq</code> 332 1.1.1.2.2.2 snj retries each query once after a timeout, the total waiting time for 333 1.1.1.2.2.2 snj a timeout will be twice the timeout value set. 334 1.1.1.2.2.2 snj <br><dt><code>version</code><dd>Print the version of the 335 1.1.1.2.2.2 snj <code>ntpq</code> 336 1.1.1.2.2.2 snj program. 337 1.1.1.2.2.2 snj </dl> 338 1.1.1.2.2.2 snj 339 1.1.1.2.2.2 snj <h5 class="subsubsection">Control Message Commands</h5> 340 1.1.1.2.2.2 snj 341 1.1.1.2.2.2 snj <p>Association IDs are used to identify system, peer and clock variables. 342 1.1.1.2.2.2 snj System variables are assigned an association ID of zero and system name space, while each association is assigned a nonzero association ID and peer namespace. 343 1.1.1.2.2.2 snj Most control commands send a single mode-6 message to the server and expect a single response message. 344 1.1.1.2.2.2 snj The exceptions are the 345 1.1.1.2.2.2 snj <code>peers</code> 346 1.1.1.2.2.2 snj command, which sends a series of messages, 347 1.1.1.2.2.2 snj and the 348 1.1.1.2.2.2 snj <code>mreadlist</code> 349 1.1.1.2.2.2 snj and 350 1.1.1.2.2.2 snj <code>mreadvar</code> 351 1.1.1.2.2.2 snj commands, which iterate over a range of associations. 352 1.1.1.2.2.2 snj <dl> 353 1.1.1.2.2.2 snj <dt><code>associations</code><dd>Display a list of mobilized associations in the form: 354 1.1.1.2.2.2 snj <pre class="example"> ind assid status conf reach auth condition last_event cnt 355 1.1.1.2.2.2 snj </pre> 356 1.1.1.2.2.2 snj <dl> 357 1.1.1.2.2.2 snj <dt>Sy String Ta Sy Description<br><dt><code>ind</code> <code>Ta</code> <code>index</code> <code>on</code> <code>this</code> <code>list</code><br><dt><code>assid</code> <code>Ta</code> <code>association</code> <code>ID</code><br><dt><code>status</code> <code>Ta</code> <code>peer</code> <code>status</code> <code>word</code><br><dt><code>conf</code> <code>Ta</code> <code>yes</code>: <code>persistent,</code> <code>no</code>: <code>ephemeral</code><br><dt><code>reach</code> <code>Ta</code> <code>yes</code>: <code>reachable,</code> <code>no</code>: <code>unreachable</code><br><dt><code>auth</code> <code>Ta</code> <code>ok</code>, <code>yes</code>, <code>bad</code> <code>and</code> <code>none</code><br><dt><code>condition</code> <code>Ta</code> <code>selection</code> <code>status</code> <code>(see</code> <code>the</code> <code>select</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><br><dt><code>last_event</code> <code>Ta</code> <code>event</code> <code>report</code> <code>(see</code> <code>the</code> <code>event</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><br><dt><code>cnt</code> <code>Ta</code> <code>event</code> <code>count</code> <code>(see</code> <code>the</code> <code>count</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><dd></dl> 358 1.1.1.2.2.2 snj <br><dt><code>authinfo</code><dd>Display the authentication statistics. 359 1.1.1.2.2.2 snj <br><dt><code>clockvar</code> <kbd>assocID</kbd> <code>[</code><kbd>name</kbd><code>[=</code><kbd>value</kbd><code>]]</code> <code>[...]</code><br><dt><code>cv</code> <kbd>assocID</kbd> <code>[</code><kbd>name</kbd><code>[=</code><kbd>value</kbd><code>]]</code> <code>[...]</code><dd>Display a list of clock variables for those associations supporting a reference clock. 360 1.1.1.2.2.2 snj <br><dt><code>:config</code> <code>[...]</code><dd>Send 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. 361 1.1.1.2.2.2 snj <br><dt><code>config-from-file</code> <kbd>filename</kbd><dd>Send the each line of 362 1.1.1.2.2.2 snj <kbd>filename</kbd> 363 1.1.1.2.2.2 snj to 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. 364 1.1.1.2.2.2 snj <br><dt><code>ifstats</code><dd>Display statistics for each local network address. Authentication is required. 365 1.1.1.2.2.2 snj <br><dt><code>iostats</code><dd>Display network and reference clock I/O statistics. 366 1.1.1.2.2.2 snj <br><dt><code>kerninfo</code><dd>Display 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. 367 1.1.1.2.2.2 snj <br><dt><code>lassociations</code><dd>Perform the same function as the associations command, except display mobilized and unmobilized associations. 368 1.1.1.2.2.2 snj <br><dt><code>lopeers</code> <code>[-4 | -6]</code><dd>Obtain and print a list of all peers and clients showing 369 1.1.1.2.2.2 snj <kbd>dstadr</kbd> 370 1.1.1.2.2.2 snj (associated with any given IP version). 371 1.1.1.2.2.2 snj <br><dt><code>lpeers</code> <code>[-4 | -6]</code><dd>Print a peer spreadsheet for the appropriate IP version(s). 372 1.1.1.2.2.2 snj <kbd>dstadr</kbd> 373 1.1.1.2.2.2 snj (associated with any given IP version). 374 1.1.1.2.2.2 snj <br><dt><code>monstats</code><dd>Display monitor facility statistics. 375 1.1.1.2.2.2 snj <br><dt><code>mrulist</code> <code>[limited | kod | mincount=</code><kbd>count</kbd><code> | laddr=</code><kbd>localaddr</kbd><code> | sort=</code><kbd>sortorder</kbd><code> | resany=</code><kbd>hexmask</kbd><code> | resall=</code><kbd>hexmask</kbd><code>]</code><dd>Obtain and print traffic counts collected and maintained by the monitor facility. 376 1.1.1.2.2.2 snj With the exception of 377 1.1.1.2.2.2 snj <code>sort</code>=<kbd>sortorder</kbd>, 378 1.1.1.2.2.2 snj the options filter the list returned by 379 1.1.1.2.2.2 snj <code>ntpd.</code> 380 1.1.1.2.2.2 snj The 381 1.1.1.2.2.2 snj <code>limited</code> 382 1.1.1.2.2.2 snj and 383 1.1.1.2.2.2 snj <code>kod</code> 384 1.1.1.2.2.2 snj options return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response. 385 1.1.1.2.2.2 snj The 386 1.1.1.2.2.2 snj <code>mincount</code>=<kbd>count</kbd> 387 1.1.1.2.2.2 snj option filters entries representing less than 388 1.1.1.2.2.2 snj <kbd>count</kbd> 389 1.1.1.2.2.2 snj packets. 390 1.1.1.2.2.2 snj The 391 1.1.1.2.2.2 snj <code>laddr</code>=<kbd>localaddr</kbd> 392 1.1.1.2.2.2 snj option filters entries for packets received on any local address other than 393 1.1.1.2.2.2 snj <kbd>localaddr</kbd>. 394 1.1.1.2.2.2 snj <code>resany</code>=<kbd>hexmask</kbd> 395 1.1.1.2.2.2 snj and 396 1.1.1.2.2.2 snj <code>resall</code>=<kbd>hexmask</kbd> 397 1.1.1.2.2.2 snj filter entries containing none or less than all, respectively, of the bits in 398 1.1.1.2.2.2 snj <kbd>hexmask</kbd>, 399 1.1.1.2.2.2 snj which must begin with 400 1.1.1.2.2.2 snj <code>0x</code>. 401 1.1.1.2.2.2 snj The 402 1.1.1.2.2.2 snj <kbd>sortorder</kbd> 403 1.1.1.2.2.2 snj defaults to 404 1.1.1.2.2.2 snj <code>lstint</code> 405 1.1.1.2.2.2 snj and may be any of 406 1.1.1.2.2.2 snj <code>addr</code>, 407 1.1.1.2.2.2 snj <code>count</code>, 408 1.1.1.2.2.2 snj <code>avgint</code>, 409 1.1.1.2.2.2 snj <code>lstint</code>, 410 1.1.1.2.2.2 snj or any of those preceded by a minus sign (hyphen) to reverse the sort order. 411 1.1.1.2.2.2 snj The output columns are: 412 1.1.1.2.2.2 snj <dl> 413 1.1.1.2.2.2 snj <dt>Column<dd>Description 414 1.1.1.2.2.2 snj <br><dt><code>lstint</code><dd>Interval in s between the receipt of the most recent packet from this address and the completion of the retrieval of the MRU list by 415 1.1.1.2.2.2 snj <code>ntpq</code> 416 1.1.1.2.2.2 snj <br><dt><code>avgint</code><dd>Average interval in s between packets from this address. 417 1.1.1.2.2.2 snj <br><dt><code>rstr</code><dd>Restriction flags associated with this address. 418 1.1.1.2.2.2 snj Most are copied unchanged from the matching 419 1.1.1.2.2.2 snj <code>restrict</code> 420 1.1.1.2.2.2 snj command, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this address triggered a rate control response. 421 1.1.1.2.2.2 snj <br><dt><code>r</code><dd>Rate control indicator, either 422 1.1.1.2.2.2 snj a period, 423 1.1.1.2.2.2 snj <code>L</code> 424 1.1.1.2.2.2 snj or 425 1.1.1.2.2.2 snj <code>K</code> 426 1.1.1.2.2.2 snj for no rate control response, 427 1.1.1.2.2.2 snj rate limiting by discarding, or rate limiting with a KoD response, respectively. 428 1.1.1.2.2.2 snj <br><dt><code>m</code><dd>Packet mode. 429 1.1.1.2.2.2 snj <br><dt><code>v</code><dd>Packet version number. 430 1.1.1.2.2.2 snj <br><dt><code>count</code><dd>Packets received from this address. 431 1.1.1.2.2.2 snj <br><dt><code>rport</code><dd>Source port of last packet from this address. 432 1.1.1.2.2.2 snj <br><dt><code>remote</code> <code>address</code><dd>DNS name, numeric address, or address followed by 433 1.1.1.2.2.2 snj claimed DNS name which could not be verified in parentheses. 434 1.1.1.2.2.2 snj </dl> 435 1.1.1.2.2.2 snj <br><dt><code>mreadvar</code> <code>assocID</code> <code>assocID</code> <code>[</code><kbd>variable_name</kbd><code>[=</code><kbd>value</kbd><code>] ...]</code><br><dt><code>mrv</code> <code>assocID</code> <code>assocID</code> <code>[</code><kbd>variable_name</kbd><code>[=</code><kbd>value</kbd><code>] ...]</code><dd>Perform the same function as the 436 1.1.1.2.2.2 snj <code>readvar</code> 437 1.1.1.2.2.2 snj command, except for a range of association IDs. 438 1.1.1.2.2.2 snj This range is determined from the association list cached by the most recent 439 1.1.1.2.2.2 snj <code>associations</code> 440 1.1.1.2.2.2 snj command. 441 1.1.1.2.2.2 snj <br><dt><code>opeers</code> <code>[-4 | -6]</code><dd>Obtain and print the old-style list of all peers and clients showing 442 1.1.1.2.2.2 snj <kbd>dstadr</kbd> 443 1.1.1.2.2.2 snj (associated with any given IP version), 444 1.1.1.2.2.2 snj rather than the 445 1.1.1.2.2.2 snj <kbd>refid</kbd>. 446 1.1.1.2.2.2 snj <br><dt><code>passociations</code><dd>Perform the same function as the 447 1.1.1.2.2.2 snj <code>associations</code> 448 1.1.1.2.2.2 snj command, 449 1.1.1.2.2.2 snj except that it uses previously stored data rather than making a new query. 450 1.1.1.2.2.2 snj <br><dt><code>peers</code><dd>Display a list of peers in the form: 451 1.1.1.2.2.2 snj <pre class="example"> [tally]remote refid st t when pool reach delay offset jitter 452 1.1.1.2.2.2 snj </pre> 453 1.1.1.2.2.2 snj <dl> 454 1.1.1.2.2.2 snj <dt>Variable<dd>Description 455 1.1.1.2.2.2 snj <br><dt><code>[tally]</code><dd>single-character code indicating current value of the 456 1.1.1.2.2.2 snj <code>select</code> 457 1.1.1.2.2.2 snj field of the 458 1.1.1.2.2.2 snj .Lk decode.html#peer "peer status word" 459 1.1.1.2.2.2 snj <br><dt><code>remote</code><dd>host name (or IP number) of peer. 460 1.1.1.2.2.2 snj The value displayed will be truncated to 15 characters unless the 461 1.1.1.2.2.2 snj <code>-w</code> 462 1.1.1.2.2.2 snj flag is given, in which case the full value will be displayed 463 1.1.1.2.2.2 snj on the first line, 464 1.1.1.2.2.2 snj and the remaining data is displayed on the next line. 465 1.1.1.2.2.2 snj <br><dt><code>refid</code><dd>association ID or 466 1.1.1.2.2.2 snj .Lk decode.html#kiss "'kiss code" 467 1.1.1.2.2.2 snj <br><dt><code>st</code><dd>stratum 468 1.1.1.2.2.2 snj <br><dt><code>t</code><dd><code>u</code>: 469 1.1.1.2.2.2 snj unicast or manycast client, 470 1.1.1.2.2.2 snj <code>b</code>: 471 1.1.1.2.2.2 snj broadcast or multicast client, 472 1.1.1.2.2.2 snj <code>l</code>: 473 1.1.1.2.2.2 snj local (reference clock), 474 1.1.1.2.2.2 snj <code>s</code>: 475 1.1.1.2.2.2 snj symmetric (peer), 476 1.1.1.2.2.2 snj <code>A</code>: 477 1.1.1.2.2.2 snj manycast server, 478 1.1.1.2.2.2 snj <code>B</code>: 479 1.1.1.2.2.2 snj broadcast server, 480 1.1.1.2.2.2 snj <code>M</code>: 481 1.1.1.2.2.2 snj multicast server 482 1.1.1.2.2.2 snj <br><dt><code>when</code><dd>sec/min/hr since last received packet 483 1.1.1.2.2.2 snj <br><dt><code>poll</code><dd>poll interval (log2 s) 484 1.1.1.2.2.2 snj <br><dt><code>reach</code><dd>reach shift register (octal) 485 1.1.1.2.2.2 snj <br><dt><code>delay</code><dd>roundtrip delay 486 1.1.1.2.2.2 snj <br><dt><code>offset</code><dd>offset of server relative to this host 487 1.1.1.2.2.2 snj <br><dt><code>jitter</code><dd>jitter 488 1.1.1.2.2.2 snj </dl> 489 1.1.1.2.2.3 snj <br><dt><code>apeers</code><dd>Display a list of peers in the form: 490 1.1.1.2.2.3 snj <pre class="example"> [tally]remote refid assid st t when pool reach delay offset jitter 491 1.1.1.2.2.3 snj </pre> 492 1.1.1.2.2.3 snj <p>where the output is just like the 493 1.1.1.2.2.3 snj <code>peers</code> 494 1.1.1.2.2.3 snj command except that the 495 1.1.1.2.2.3 snj <code>refid</code> 496 1.1.1.2.2.3 snj is displayed in hex format and the association number is also displayed. 497 1.1.1.2.2.3 snj <br><dt><code>pstats</code> <kbd>assocID</kbd><dd>Show the statistics for the peer with the given 498 1.1.1.2.2.2 snj <kbd>assocID</kbd>. 499 1.1.1.2.2.2 snj <br><dt><code>readlist</code> <kbd>assocID</kbd><br><dt><code>rl</code> <kbd>assocID</kbd><dd>Read the system or peer variables included in the variable list. 500 1.1.1.2.2.2 snj <br><dt><code>readvar</code> <kbd>assocID</kbd> <kbd>name</kbd><code>[=</code><kbd>value</kbd><code>]</code> <code>[, ...]</code><br><dt><code>rv</code> <kbd>assocID</kbd> <kbd>name</kbd><code>[=</code><kbd>value</kbd><code>]</code> <code>[, ...]</code><dd>Display the specified variables. 501 1.1.1.2.2.2 snj If 502 1.1.1.2.2.2 snj <kbd>assocID</kbd> 503 1.1.1.2.2.2 snj is zero, the variables are from the 504 1.1.1.2.2.2 snj <a href="#System-Variables">System Variables</a> 505 1.1.1.2.2.2 snj name space, otherwise they are from the 506 1.1.1.2.2.2 snj <a href="#Peer-Variables">Peer Variables</a> 507 1.1.1.2.2.2 snj name space. 508 1.1.1.2.2.2 snj The 509 1.1.1.2.2.2 snj <kbd>assocID</kbd> 510 1.1.1.2.2.2 snj is required, as the same name can occur in both spaces. 511 1.1.1.2.2.2 snj If no 512 1.1.1.2.2.2 snj <kbd>name</kbd> 513 1.1.1.2.2.2 snj is included, all operative variables in the name space are displayed. 514 1.1.1.2.2.2 snj 515 1.1.1.2.2.2 snj <p>In this case only, if the 516 1.1.1.2.2.2 snj <kbd>assocID</kbd> 517 1.1.1.2.2.2 snj is omitted, it is assumed zero. 518 1.1.1.2.2.2 snj Multiple names are specified with comma separators and without whitespace. 519 1.1.1.2.2.2 snj Note that time values are represented in milliseconds 520 1.1.1.2.2.2 snj and frequency values in parts-per-million (PPM). 521 1.1.1.2.2.2 snj Some NTP timestamps are represented in the format 522 1.1.1.2.2.2 snj YYYYMMDDTTTT , 523 1.1.1.2.2.2 snj where YYYY is the year, 524 1.1.1.2.2.2 snj MM the month of year, 525 1.1.1.2.2.2 snj DD the day of month and 526 1.1.1.2.2.2 snj TTTT the time of day. 527 1.1.1.2.2.2 snj <br><dt><code>reslist</code><dd>Show the access control (restrict) list for 528 1.1.1.2.2.2 snj <code>ntpq</code> 529 1.1.1.2.2.2 snj 530 1.1.1.2.2.2 snj <br><dt><code>saveconfig</code> <kbd>filename</kbd><dd>Write the current configuration, 531 1.1.1.2.2.2 snj including any runtime modifications given with 532 1.1.1.2.2.2 snj <code>:config</code> 533 1.1.1.2.2.2 snj or 534 1.1.1.2.2.2 snj <code>config-from-file</code>, 535 1.1.1.2.2.2 snj to the ntpd host's file 536 1.1.1.2.2.2 snj <kbd>filename</kbd>. 537 1.1.1.2.2.2 snj This command will be rejected by the server unless 538 1.1.1.2.2.2 snj .Lk miscopt.html#saveconfigdir "saveconfigdir" 539 1.1.1.2.2.2 snj appears in the 540 1.1.1.2.2.2 snj <code>ntpd</code> 541 1.1.1.2.2.2 snj configuration file. 542 1.1.1.2.2.2 snj <kbd>filename</kbd> 543 1.1.1.2.2.2 snj can use 544 1.1.1.2.2.2 snj <code>strftime()</code> 545 1.1.1.2.2.2 snj format specifies to substitute the current date and time, for example, 546 1.1.1.2.2.2 snj <code>q]saveconfig</code> <code>ntp-%Y%m%d-%H%M%S.confq]</code>. 547 1.1.1.2.2.2 snj The filename used is stored in system variable 548 1.1.1.2.2.2 snj <code>savedconfig</code>. 549 1.1.1.2.2.2 snj Authentication is required. 550 1.1.1.2.2.2 snj <br><dt><code>timerstats</code><dd>Display interval timer counters. 551 1.1.1.2.2.2 snj <br><dt><code>writelist</code> <kbd>assocID</kbd><dd>Write the system or peer variables included in the variable list. 552 1.1.1.2.2.2 snj <br><dt><code>writevar</code> <kbd>assocID</kbd> <kbd>name</kbd>=<kbd>value</kbd> <code>[, ...]</code><dd>Write the specified variables. 553 1.1.1.2.2.2 snj If the 554 1.1.1.2.2.2 snj <kbd>assocID</kbd> 555 1.1.1.2.2.2 snj is zero, the variables are from the 556 1.1.1.2.2.2 snj <a href="#System-Variables">System Variables</a> 557 1.1.1.2.2.2 snj name space, otherwise they are from the 558 1.1.1.2.2.2 snj <a href="#Peer-Variables">Peer Variables</a> 559 1.1.1.2.2.2 snj name space. 560 1.1.1.2.2.2 snj The 561 1.1.1.2.2.2 snj <kbd>assocID</kbd> 562 1.1.1.2.2.2 snj is required, as the same name can occur in both spaces. 563 1.1.1.2.2.2 snj <br><dt><code>sysinfo</code><dd>Display operational summary. 564 1.1.1.2.2.2 snj <br><dt><code>sysstats</code><dd>Print statistics counters maintained in the protocol module. 565 1.1.1.2.2.2 snj </dl> 566 1.1.1.2.2.2 snj 567 1.1.1.2.2.2 snj <h5 class="subsubsection">Status Words and Kiss Codes</h5> 568 1.1.1.2.2.2 snj 569 1.1.1.2.2.2 snj <p>The current state of the operating program is shown 570 1.1.1.2.2.2 snj in a set of status words 571 1.1.1.2.2.2 snj maintained by the system. 572 1.1.1.2.2.2 snj Status information is also available on a per-association basis. 573 1.1.1.2.2.2 snj These words are displayed in the 574 1.1.1.2.2.2 snj <code>rv</code> 575 1.1.1.2.2.2 snj and 576 1.1.1.2.2.2 snj <code>as</code> 577 1.1.1.2.2.2 snj commands both in hexadecimal and in decoded short tip strings. 578 1.1.1.2.2.2 snj The codes, tips and short explanations are documented on the 579 1.1.1.2.2.2 snj .Lk decode.html "Event Messages and Status Words" 580 1.1.1.2.2.2 snj page. 581 1.1.1.2.2.2 snj The page also includes a list of system and peer messages, 582 1.1.1.2.2.2 snj the code for the latest of which is included in the status word. 583 1.1.1.2.2.2 snj 584 1.1.1.2.2.2 snj <p>Information resulting from protocol machine state transitions 585 1.1.1.2.2.2 snj is displayed using an informal set of ASCII strings called 586 1.1.1.2.2.2 snj .Lk decode.html#kiss "kiss codes" . 587 1.1.1.2.2.2 snj The original purpose was for kiss-o'-death (KoD) packets 588 1.1.1.2.2.2 snj sent by the server to advise the client of an unusual condition. 589 1.1.1.2.2.2 snj They are now displayed, when appropriate, 590 1.1.1.2.2.2 snj in the reference identifier field in various billboards. 591 1.1.1.2.2.2 snj 592 1.1.1.2.2.2 snj <h5 class="subsubsection">System Variables</h5> 593 1.1.1.2.2.2 snj 594 1.1.1.2.2.2 snj <p>The following system variables appear in the 595 1.1.1.2.2.2 snj <code>rv</code> 596 1.1.1.2.2.2 snj billboard. 597 1.1.1.2.2.2 snj Not all variables are displayed in some configurations. 598 1.1.1.2.2.2 snj <dl> 599 1.1.1.2.2.2 snj <dt>Variable<dd>Description 600 1.1.1.2.2.2 snj <br><dt><code>status</code><dd>.Lk decode.html#sys "system status word" 601 1.1.1.2.2.2 snj <br><dt><code>version</code><dd>NTP software version and build time 602 1.1.1.2.2.2 snj <br><dt><code>processor</code><dd>hardware platform and version 603 1.1.1.2.2.2 snj <br><dt><code>system</code><dd>operating system and version 604 1.1.1.2.2.2 snj <br><dt><code>leap</code><dd>leap warning indicator (0-3) 605 1.1.1.2.2.2 snj <br><dt><code>stratum</code><dd>stratum (1-15) 606 1.1.1.2.2.2 snj <br><dt><code>precision</code><dd>precision (log2 s) 607 1.1.1.2.2.2 snj <br><dt><code>rootdelay</code><dd>total roundtrip delay to the primary reference clock 608 1.1.1.2.2.2 snj <br><dt><code>rootdisp</code><dd>total dispersion to the primary reference clock 609 1.1.1.2.2.2 snj <br><dt><code>peer</code><dd>system peer association ID 610 1.1.1.2.2.2 snj <br><dt><code>tc</code><dd>time constant and poll exponent (log2 s) (3-17) 611 1.1.1.2.2.2 snj <br><dt><code>mintc</code><dd>minimum time constant (log2 s) (3-10) 612 1.1.1.2.2.2 snj <br><dt><code>clock</code><dd>date and time of day 613 1.1.1.2.2.2 snj <br><dt><code>refid</code><dd>reference ID or 614 1.1.1.2.2.2 snj .Lk decode.html#kiss "kiss code" 615 1.1.1.2.2.2 snj <br><dt><code>reftime</code><dd>reference time 616 1.1.1.2.2.2 snj <br><dt><code>offset</code><dd>combined offset of server relative to this host 617 1.1.1.2.2.2 snj <br><dt><code>sys_jitter</code><dd>combined system jitter 618 1.1.1.2.2.2 snj <br><dt><code>frequency</code><dd>frequency offset (PPM) relative to hardware clock 619 1.1.1.2.2.2 snj <br><dt><code>clk_wander</code><dd>clock frequency wander (PPM) 620 1.1.1.2.2.2 snj <br><dt><code>clk_jitter</code><dd>clock jitter 621 1.1.1.2.2.2 snj <br><dt><code>tai</code><dd>TAI-UTC offset (s) 622 1.1.1.2.2.2 snj <br><dt><code>leapsec</code><dd>NTP seconds when the next leap second is/was inserted 623 1.1.1.2.2.2 snj <br><dt><code>expire</code><dd>NTP seconds when the NIST leapseconds file expires 624 1.1.1.2.2.2 snj </dl> 625 1.1.1.2.2.2 snj The jitter and wander statistics are exponentially-weighted RMS averages. 626 1.1.1.2.2.2 snj The system jitter is defined in the NTPv4 specification; 627 1.1.1.2.2.2 snj the clock jitter statistic is computed by the clock discipline module. 628 1.1.1.2.2.2 snj 629 1.1.1.2.2.2 snj <p>When the NTPv4 daemon is compiled with the OpenSSL software library, 630 1.1.1.2.2.2 snj additional system variables are displayed, 631 1.1.1.2.2.2 snj including some or all of the following, 632 1.1.1.2.2.2 snj depending on the particular Autokey dance: 633 1.1.1.2.2.2 snj 634 1.1.1.2.2.2 snj <dl> 635 1.1.1.2.2.2 snj <dt>Variable<dd>Description 636 1.1.1.2.2.2 snj <br><dt><code>host</code><dd>Autokey host name for this host 637 1.1.1.2.2.2 snj <br><dt><code>ident</code><dd>Autokey group name for this host 638 1.1.1.2.2.2 snj <br><dt><code>flags</code><dd>host flags (see Autokey specification) 639 1.1.1.2.2.2 snj <br><dt><code>digest</code><dd>OpenSSL message digest algorithm 640 1.1.1.2.2.2 snj <br><dt><code>signature</code><dd>OpenSSL digest/signature scheme 641 1.1.1.2.2.2 snj <br><dt><code>update</code><dd>NTP seconds at last signature update 642 1.1.1.2.2.2 snj <br><dt><code>cert</code><dd>certificate subject, issuer and certificate flags 643 1.1.1.2.2.2 snj <br><dt><code>until</code><dd>NTP seconds when the certificate expires 644 1.1.1.2.2.2 snj </dl> 645 1.1.1.2.2.2 snj 646 1.1.1.2.2.2 snj <h5 class="subsubsection">Peer Variables</h5> 647 1.1.1.2.2.2 snj 648 1.1.1.2.2.2 snj <p>The following peer variables appear in the 649 1.1.1.2.2.2 snj <code>rv</code> 650 1.1.1.2.2.2 snj billboard for each association. 651 1.1.1.2.2.2 snj Not all variables are displayed in some configurations. 652 1.1.1.2.2.2 snj 653 1.1.1.2.2.2 snj <dl> 654 1.1.1.2.2.2 snj <dt>Variable<dd>Description 655 1.1.1.2.2.2 snj <br><dt><code>associd</code><dd>association ID 656 1.1.1.2.2.2 snj <br><dt><code>status</code><dd>.Lk decode.html#peer "peer status word" 657 1.1.1.2.2.2 snj <br><dt><code>srcadr</code><dd>source (remote) IP address 658 1.1.1.2.2.2 snj <br><dt><code>srcport</code><dd>source (remote) port 659 1.1.1.2.2.2 snj <br><dt><code>dstadr</code><dd>destination (local) IP address 660 1.1.1.2.2.2 snj <br><dt><code>dstport</code><dd>destination (local) port 661 1.1.1.2.2.2 snj <br><dt><code>leap</code><dd>leap indicator (0-3) 662 1.1.1.2.2.2 snj <br><dt><code>stratum</code><dd>stratum (0-15) 663 1.1.1.2.2.2 snj <br><dt><code>precision</code><dd>precision (log2 s) 664 1.1.1.2.2.2 snj <br><dt><code>rootdelay</code><dd>total roundtrip delay to the primary reference clock 665 1.1.1.2.2.2 snj <br><dt><code>rootdisp</code><dd>total root dispersion to the primary reference clock 666 1.1.1.2.2.2 snj <br><dt><code>refid</code><dd>reference ID or 667 1.1.1.2.2.2 snj .Lk decode.html#kiss "kiss code" 668 1.1.1.2.2.2 snj <br><dt><code>reftime</code><dd>reference time 669 1.1.1.2.2.2 snj <br><dt><code>reach</code><dd>reach register (octal) 670 1.1.1.2.2.2 snj <br><dt><code>unreach</code><dd>unreach counter 671 1.1.1.2.2.2 snj <br><dt><code>hmode</code><dd>host mode (1-6) 672 1.1.1.2.2.2 snj <br><dt><code>pmode</code><dd>peer mode (1-5) 673 1.1.1.2.2.2 snj <br><dt><code>hpoll</code><dd>host poll exponent (log2 s) (3-17) 674 1.1.1.2.2.2 snj <br><dt><code>ppoll</code><dd>peer poll exponent (log2 s) (3-17) 675 1.1.1.2.2.2 snj <br><dt><code>headway</code><dd>headway (see 676 1.1.1.2.2.2 snj .Lk rate.html "Rate Management and the Kiss-o'-Death Packet" ) 677 1.1.1.2.2.2 snj <br><dt><code>flash</code><dd>.Lk decode.html#flash "flash status word" 678 1.1.1.2.2.2 snj <br><dt><code>offset</code><dd>filter offset 679 1.1.1.2.2.2 snj <br><dt><code>delay</code><dd>filter delay 680 1.1.1.2.2.2 snj <br><dt><code>dispersion</code><dd>filter dispersion 681 1.1.1.2.2.2 snj <br><dt><code>jitter</code><dd>filter jitter 682 1.1.1.2.2.2 snj <br><dt><code>ident</code><dd>Autokey group name for this association 683 1.1.1.2.2.2 snj <br><dt><code>bias</code><dd>unicast/broadcast bias 684 1.1.1.2.2.2 snj <br><dt><code>xleave</code><dd>interleave delay (see 685 1.1.1.2.2.2 snj .Lk xleave.html "NTP Interleaved Modes" ) 686 1.1.1.2.2.2 snj </dl> 687 1.1.1.2.2.2 snj The 688 1.1.1.2.2.2 snj <code>bias</code> 689 1.1.1.2.2.2 snj variable is calculated when the first broadcast packet is received 690 1.1.1.2.2.2 snj after the calibration volley. 691 1.1.1.2.2.2 snj It represents the offset of the broadcast subgraph relative to the unicast subgraph. 692 1.1.1.2.2.2 snj The 693 1.1.1.2.2.2 snj <code>xleave</code> 694 1.1.1.2.2.2 snj variable appears only for the interleaved symmetric and interleaved modes. 695 1.1.1.2.2.2 snj It represents the internal queuing, buffering and transmission delays 696 1.1.1.2.2.2 snj for the preceding packet. 697 1.1.1.2.2.2 snj 698 1.1.1.2.2.2 snj <p>When the NTPv4 daemon is compiled with the OpenSSL software library, 699 1.1.1.2.2.2 snj additional peer variables are displayed, including the following: 700 1.1.1.2.2.2 snj <dl> 701 1.1.1.2.2.2 snj <dt>Variable<dd>Description 702 1.1.1.2.2.2 snj <br><dt><code>flags</code><dd>peer flags (see Autokey specification) 703 1.1.1.2.2.2 snj <br><dt><code>host</code><dd>Autokey server name 704 1.1.1.2.2.2 snj <br><dt><code>flags</code><dd>peer flags (see Autokey specification) 705 1.1.1.2.2.2 snj <br><dt><code>signature</code><dd>OpenSSL digest/signature scheme 706 1.1.1.2.2.2 snj <br><dt><code>initsequence</code><dd>initial key ID 707 1.1.1.2.2.2 snj <br><dt><code>initkey</code><dd>initial key index 708 1.1.1.2.2.2 snj <br><dt><code>timestamp</code><dd>Autokey signature timestamp 709 1.1.1.2.2.2 snj </dl> 710 1.1.1.2.2.2 snj 711 1.1.1.2.2.2 snj <h5 class="subsubsection">Clock Variables</h5> 712 1.1.1.2.2.2 snj 713 1.1.1.2.2.2 snj <p>The following clock variables appear in the 714 1.1.1.2.2.2 snj <code>cv</code> 715 1.1.1.2.2.2 snj billboard for each association with a reference clock. 716 1.1.1.2.2.2 snj Not all variables are displayed in some configurations. 717 1.1.1.2.2.2 snj <dl> 718 1.1.1.2.2.2 snj <dt>Variable<dd>Description 719 1.1.1.2.2.2 snj <br><dt><code>associd</code><dd>association ID 720 1.1.1.2.2.2 snj <br><dt><code>status</code><dd>.Lk decode.html#clock "clock status word" 721 1.1.1.2.2.2 snj <br><dt><code>device</code><dd>device description 722 1.1.1.2.2.2 snj <br><dt><code>timecode</code><dd>ASCII time code string (specific to device) 723 1.1.1.2.2.2 snj <br><dt><code>poll</code><dd>poll messages sent 724 1.1.1.2.2.2 snj <br><dt><code>noreply</code><dd>no reply 725 1.1.1.2.2.2 snj <br><dt><code>badformat</code><dd>bad format 726 1.1.1.2.2.2 snj <br><dt><code>baddata</code><dd>bad date or time 727 1.1.1.2.2.2 snj <br><dt><code>fudgetime1</code><dd>fudge time 1 728 1.1.1.2.2.2 snj <br><dt><code>fudgetime2</code><dd>fudge time 2 729 1.1.1.2.2.2 snj <br><dt><code>stratum</code><dd>driver stratum 730 1.1.1.2.2.2 snj <br><dt><code>refid</code><dd>driver reference ID 731 1.1.1.2.2.2 snj <br><dt><code>flags</code><dd>driver flags 732 1.1.1.2.2.2 snj </dl> 733 1.1.1.2.2.2 snj 734 1.1.1.2.2.2 snj <p>This section was generated by <strong>AutoGen</strong>, 735 1.1.1.2.2.2 snj using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpq</code> program. 736 1.1.1.2.2.2 snj This software is released under the NTP license, <http://ntp.org/license>;. 737 1.1.1.2.2.2 snj 738 1.1.1.2.2.2 snj <ul class="menu"> 739 1.1.1.2.2.2 snj <li><a accesskey="1" href="#ntpq-usage">ntpq usage</a>: ntpq help/usage (<span class="option">--help</span>) 740 1.1.1.2.2.2 snj <li><a accesskey="2" href="#ntpq-ipv4">ntpq ipv4</a>: ipv4 option (-4) 741 1.1.1.2.2.2 snj <li><a accesskey="3" href="#ntpq-ipv6">ntpq ipv6</a>: ipv6 option (-6) 742 1.1.1.2.2.2 snj <li><a accesskey="4" href="#ntpq-command">ntpq command</a>: command option (-c) 743 1.1.1.2.2.2 snj <li><a accesskey="5" href="#ntpq-interactive">ntpq interactive</a>: interactive option (-i) 744 1.1.1.2.2.2 snj <li><a accesskey="6" href="#ntpq-numeric">ntpq numeric</a>: numeric option (-n) 745 1.1.1.2.2.2 snj <li><a accesskey="7" href="#ntpq-old_002drv">ntpq old-rv</a>: old-rv option 746 1.1.1.2.2.2 snj <li><a accesskey="8" href="#ntpq-peers">ntpq peers</a>: peers option (-p) 747 1.1.1.2.2.4 snj <li><a accesskey="9" href="#ntpq-refid">ntpq refid</a>: refid option (-r) 748 1.1.1.2.2.4 snj <li><a href="#ntpq-wide">ntpq wide</a>: wide option (-w) 749 1.1.1.2.2.2 snj <li><a href="#ntpq-config">ntpq config</a>: presetting/configuring ntpq 750 1.1.1.2.2.2 snj <li><a href="#ntpq-exit-status">ntpq exit status</a>: exit status 751 1.1.1.2.2.2 snj </ul> 752 1.1.1.2.2.2 snj 753 1.1.1.2.2.2 snj <div class="node"> 754 1.1.1.2.2.2 snj <p><hr> 755 1.1.1.2.2.2 snj <a name="ntpq-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpq-ipv4">ntpq ipv4</a>, 756 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 757 1.1.1.2.2.2 snj <br> 758 1.1.1.2.2.2 snj </div> 759 1.1.1.2.2.2 snj 760 1.1.1.2.2.2 snj <h4 class="subsection">ntpq help/usage (<span class="option">--help</span>)</h4> 761 1.1.1.2.2.2 snj 762 1.1.1.2.2.2 snj <p><a name="index-ntpq-help-3"></a> 763 1.1.1.2.2.2 snj This is the automatically generated usage text for ntpq. 764 1.1.1.2.2.2 snj 765 1.1.1.2.2.2 snj <p>The text printed is the same whether selected with the <code>help</code> option 766 1.1.1.2.2.2 snj (<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print 767 1.1.1.2.2.2 snj the usage text by passing it through a pager program. 768 1.1.1.2.2.2 snj <code>more-help</code> is disabled on platforms without a working 769 1.1.1.2.2.2 snj <code>fork(2)</code> function. The <code>PAGER</code> environment variable is 770 1.1.1.2.2.2 snj used to select the program, defaulting to <span class="file">more</span>. Both will exit 771 1.1.1.2.2.2 snj with a status code of 0. 772 1.1.1.2.2.2 snj 773 1.1.1.2.2.5 snj <pre class="example">ntpq - standard NTP query program - Ver. 4.2.8p10-beta 774 1.1.1.2.2.2 snj Usage: ntpq [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...] 775 1.1.1.2.2.2 snj Flg Arg Option-Name Description 776 1.1.1.2.2.2 snj -4 no ipv4 Force IPv4 DNS name resolution 777 1.1.1.2.2.2 snj - prohibits the option 'ipv6' 778 1.1.1.2.2.2 snj -6 no ipv6 Force IPv6 DNS name resolution 779 1.1.1.2.2.2 snj - prohibits the option 'ipv4' 780 1.1.1.2.2.2 snj -c Str command run a command and exit 781 1.1.1.2.2.2 snj - may appear multiple times 782 1.1.1.2.2.2 snj -d no debug-level Increase debug verbosity level 783 1.1.1.2.2.2 snj - may appear multiple times 784 1.1.1.2.2.2 snj -D Num set-debug-level Set the debug verbosity level 785 1.1.1.2.2.2 snj - may appear multiple times 786 1.1.1.2.2.2 snj -i no interactive Force ntpq to operate in interactive mode 787 1.1.1.2.2.2 snj - prohibits these options: 788 1.1.1.2.2.2 snj command 789 1.1.1.2.2.2 snj peers 790 1.1.1.2.2.2 snj -n no numeric numeric host addresses 791 1.1.1.2.2.2 snj no old-rv Always output status line with readvar 792 1.1.1.2.2.2 snj -p no peers Print a list of the peers 793 1.1.1.2.2.2 snj - prohibits the option 'interactive' 794 1.1.1.2.2.4 snj -r KWd refid Set default display type for S2+ refids 795 1.1.1.2.2.2 snj -w no wide Display the full 'remote' value 796 1.1.1.2.2.2 snj opt version output version information and exit 797 1.1.1.2.2.2 snj -? no help display extended usage information and exit 798 1.1.1.2.2.2 snj -! no more-help extended usage information passed thru pager 799 1.1.1.2.2.2 snj -> opt save-opts save the option state to a config file 800 1.1.1.2.2.2 snj -< Str load-opts load options from a config file 801 1.1.1.2.2.2 snj - disabled as '--no-load-opts' 802 1.1.1.2.2.2 snj - may appear multiple times 803 1.1.1.2.2.2 snj 804 1.1.1.2.2.2 snj Options are specified by doubled hyphens and their name or by a single 805 1.1.1.2.2.2 snj hyphen and the flag character. 806 1.1.1.2.2.2 snj 807 1.1.1.2.2.2 snj The following option preset mechanisms are supported: 808 1.1.1.2.2.2 snj - reading file $HOME/.ntprc 809 1.1.1.2.2.2 snj - reading file ./.ntprc 810 1.1.1.2.2.2 snj - examining environment variables named NTPQ_* 811 1.1.1.2.2.2 snj 812 1.1.1.2.2.4 snj The valid "refid" option keywords are: 813 1.1.1.2.2.4 snj hash ipv4 814 1.1.1.2.2.4 snj or an integer from 0 through 1 815 1.1.1.2.2.4 snj 816 1.1.1.2.2.2 snj Please send bug reports to: <http://bugs.ntp.org, bugs (a] ntp.org> 817 1.1.1.2.2.2 snj </pre> 818 1.1.1.2.2.2 snj <div class="node"> 819 1.1.1.2.2.2 snj <p><hr> 820 1.1.1.2.2.2 snj <a name="ntpq-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpq-ipv6">ntpq ipv6</a>, 821 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-usage">ntpq usage</a>, 822 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 823 1.1.1.2.2.2 snj <br> 824 1.1.1.2.2.2 snj </div> 825 1.1.1.2.2.2 snj 826 1.1.1.2.2.2 snj <h4 class="subsection">ipv4 option (-4)</h4> 827 1.1.1.2.2.2 snj 828 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dipv4-4"></a> 829 1.1.1.2.2.2 snj This is the “force ipv4 dns name resolution” option. 830 1.1.1.2.2.2 snj 831 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 832 1.1.1.2.2.2 snj <ul> 833 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 834 1.1.1.2.2.2 snj ipv6. 835 1.1.1.2.2.2 snj </ul> 836 1.1.1.2.2.2 snj 837 1.1.1.2.2.2 snj <p>Force DNS resolution of following host names on the command line 838 1.1.1.2.2.2 snj to the IPv4 namespace. 839 1.1.1.2.2.2 snj <div class="node"> 840 1.1.1.2.2.2 snj <p><hr> 841 1.1.1.2.2.2 snj <a name="ntpq-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpq-command">ntpq command</a>, 842 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-ipv4">ntpq ipv4</a>, 843 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 844 1.1.1.2.2.2 snj <br> 845 1.1.1.2.2.2 snj </div> 846 1.1.1.2.2.2 snj 847 1.1.1.2.2.2 snj <h4 class="subsection">ipv6 option (-6)</h4> 848 1.1.1.2.2.2 snj 849 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dipv6-5"></a> 850 1.1.1.2.2.2 snj This is the “force ipv6 dns name resolution” option. 851 1.1.1.2.2.2 snj 852 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 853 1.1.1.2.2.2 snj <ul> 854 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 855 1.1.1.2.2.2 snj ipv4. 856 1.1.1.2.2.2 snj </ul> 857 1.1.1.2.2.2 snj 858 1.1.1.2.2.2 snj <p>Force DNS resolution of following host names on the command line 859 1.1.1.2.2.2 snj to the IPv6 namespace. 860 1.1.1.2.2.2 snj <div class="node"> 861 1.1.1.2.2.2 snj <p><hr> 862 1.1.1.2.2.2 snj <a name="ntpq-command"></a>Next: <a rel="next" accesskey="n" href="#ntpq-interactive">ntpq interactive</a>, 863 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-ipv6">ntpq ipv6</a>, 864 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 865 1.1.1.2.2.2 snj <br> 866 1.1.1.2.2.2 snj </div> 867 1.1.1.2.2.2 snj 868 1.1.1.2.2.2 snj <h4 class="subsection">command option (-c)</h4> 869 1.1.1.2.2.2 snj 870 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dcommand-6"></a> 871 1.1.1.2.2.2 snj This is the “run a command and exit” option. 872 1.1.1.2.2.2 snj This option takes a string argument <span class="file">cmd</span>. 873 1.1.1.2.2.2 snj 874 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 875 1.1.1.2.2.2 snj <ul> 876 1.1.1.2.2.2 snj <li>may appear an unlimited number of times. 877 1.1.1.2.2.2 snj </ul> 878 1.1.1.2.2.2 snj 879 1.1.1.2.2.2 snj <p>The following argument is interpreted as an interactive format command 880 1.1.1.2.2.2 snj and is added to the list of commands to be executed on the specified 881 1.1.1.2.2.2 snj host(s). 882 1.1.1.2.2.2 snj <div class="node"> 883 1.1.1.2.2.2 snj <p><hr> 884 1.1.1.2.2.2 snj <a name="ntpq-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpq-numeric">ntpq numeric</a>, 885 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-command">ntpq command</a>, 886 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 887 1.1.1.2.2.2 snj <br> 888 1.1.1.2.2.2 snj </div> 889 1.1.1.2.2.2 snj 890 1.1.1.2.2.2 snj <h4 class="subsection">interactive option (-i)</h4> 891 1.1.1.2.2.2 snj 892 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dinteractive-7"></a> 893 1.1.1.2.2.2 snj This is the “force ntpq to operate in interactive mode” option. 894 1.1.1.2.2.2 snj 895 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 896 1.1.1.2.2.2 snj <ul> 897 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 898 1.1.1.2.2.2 snj command, peers. 899 1.1.1.2.2.2 snj </ul> 900 1.1.1.2.2.2 snj 901 1.1.1.2.2.2 snj <p>Force <code>ntpq</code> to operate in interactive mode. 902 1.1.1.2.2.2 snj Prompts will be written to the standard output and 903 1.1.1.2.2.2 snj commands read from the standard input. 904 1.1.1.2.2.2 snj <div class="node"> 905 1.1.1.2.2.2 snj <p><hr> 906 1.1.1.2.2.2 snj <a name="ntpq-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpq-old_002drv">ntpq old-rv</a>, 907 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-interactive">ntpq interactive</a>, 908 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 909 1.1.1.2.2.2 snj <br> 910 1.1.1.2.2.2 snj </div> 911 1.1.1.2.2.2 snj 912 1.1.1.2.2.2 snj <h4 class="subsection">numeric option (-n)</h4> 913 1.1.1.2.2.2 snj 914 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dnumeric-8"></a> 915 1.1.1.2.2.2 snj This is the “numeric host addresses” option. 916 1.1.1.2.2.2 snj Output all host addresses in dotted-quad numeric format rather than 917 1.1.1.2.2.2 snj converting to the canonical host names. 918 1.1.1.2.2.2 snj <div class="node"> 919 1.1.1.2.2.2 snj <p><hr> 920 1.1.1.2.2.2 snj <a name="ntpq-old_002drv"></a>Next: <a rel="next" accesskey="n" href="#ntpq-peers">ntpq peers</a>, 921 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-numeric">ntpq numeric</a>, 922 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 923 1.1.1.2.2.2 snj <br> 924 1.1.1.2.2.2 snj </div> 925 1.1.1.2.2.2 snj 926 1.1.1.2.2.2 snj <h4 class="subsection">old-rv option</h4> 927 1.1.1.2.2.2 snj 928 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dold_002drv-9"></a> 929 1.1.1.2.2.2 snj This is the “always output status line with readvar” option. 930 1.1.1.2.2.2 snj By default, <code>ntpq</code> now suppresses the <code>associd=...</code> 931 1.1.1.2.2.2 snj line that precedes the output of <code>readvar</code> 932 1.1.1.2.2.2 snj (alias <code>rv</code>) when a single variable is requested, such as 933 1.1.1.2.2.2 snj <code>ntpq -c "rv 0 offset"</code>. 934 1.1.1.2.2.2 snj This option causes <code>ntpq</code> to include both lines of output 935 1.1.1.2.2.2 snj for a single-variable <code>readvar</code>. 936 1.1.1.2.2.2 snj Using an environment variable to 937 1.1.1.2.2.2 snj preset this option in a script will enable both older and 938 1.1.1.2.2.2 snj newer <code>ntpq</code> to behave identically in this regard. 939 1.1.1.2.2.2 snj <div class="node"> 940 1.1.1.2.2.2 snj <p><hr> 941 1.1.1.2.2.4 snj <a name="ntpq-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpq-refid">ntpq refid</a>, 942 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-old_002drv">ntpq old-rv</a>, 943 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 944 1.1.1.2.2.2 snj <br> 945 1.1.1.2.2.2 snj </div> 946 1.1.1.2.2.2 snj 947 1.1.1.2.2.2 snj <h4 class="subsection">peers option (-p)</h4> 948 1.1.1.2.2.2 snj 949 1.1.1.2.2.2 snj <p><a name="index-ntpq_002dpeers-10"></a> 950 1.1.1.2.2.2 snj This is the “print a list of the peers” option. 951 1.1.1.2.2.2 snj 952 1.1.1.2.2.2 snj <p class="noindent">This option has some usage constraints. It: 953 1.1.1.2.2.2 snj <ul> 954 1.1.1.2.2.2 snj <li>must not appear in combination with any of the following options: 955 1.1.1.2.2.2 snj interactive. 956 1.1.1.2.2.2 snj </ul> 957 1.1.1.2.2.2 snj 958 1.1.1.2.2.2 snj <p>Print a list of the peers known to the server as well as a summary 959 1.1.1.2.2.2 snj of their state. This is equivalent to the 'peers' interactive command. 960 1.1.1.2.2.2 snj <div class="node"> 961 1.1.1.2.2.2 snj <p><hr> 962 1.1.1.2.2.4 snj <a name="ntpq-refid"></a>Next: <a rel="next" accesskey="n" href="#ntpq-wide">ntpq wide</a>, 963 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-peers">ntpq peers</a>, 964 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 965 1.1.1.2.2.2 snj <br> 966 1.1.1.2.2.2 snj </div> 967 1.1.1.2.2.2 snj 968 1.1.1.2.2.4 snj <h4 class="subsection">refid option (-r)</h4> 969 1.1.1.2.2.4 snj 970 1.1.1.2.2.4 snj <p><a name="index-ntpq_002drefid-11"></a> 971 1.1.1.2.2.4 snj This is the “set default display type for s2+ refids” option. 972 1.1.1.2.2.4 snj This option takes a keyword argument. 973 1.1.1.2.2.4 snj 974 1.1.1.2.2.4 snj <p class="noindent">This option has some usage constraints. It: 975 1.1.1.2.2.4 snj <ul> 976 1.1.1.2.2.4 snj <li>This option takes a keyword as its argument. 977 1.1.1.2.2.4 snj The argument sets an enumeration value that can be tested by comparing the option value macro (OPT_VALUE_REFID). 978 1.1.1.2.2.4 snj The available keywords are: 979 1.1.1.2.2.4 snj <pre class="example"> hash ipv4 980 1.1.1.2.2.4 snj </pre> 981 1.1.1.2.2.4 snj <p>or their numeric equivalent.</ul> 982 1.1.1.2.2.4 snj 983 1.1.1.2.2.4 snj <p>Set the default display format for S2+ refids. 984 1.1.1.2.2.4 snj <div class="node"> 985 1.1.1.2.2.4 snj <p><hr> 986 1.1.1.2.2.4 snj <a name="ntpq-wide"></a>Next: <a rel="next" accesskey="n" href="#ntpq-config">ntpq config</a>, 987 1.1.1.2.2.4 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-refid">ntpq refid</a>, 988 1.1.1.2.2.4 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 989 1.1.1.2.2.4 snj <br> 990 1.1.1.2.2.4 snj </div> 991 1.1.1.2.2.4 snj 992 1.1.1.2.2.2 snj <h4 class="subsection">wide option (-w)</h4> 993 1.1.1.2.2.2 snj 994 1.1.1.2.2.4 snj <p><a name="index-ntpq_002dwide-12"></a> 995 1.1.1.2.2.2 snj This is the “display the full 'remote' value” option. 996 1.1.1.2.2.2 snj Display the full value of the 'remote' value. If this requires 997 1.1.1.2.2.2 snj more than 15 characters, display the full value, emit a newline, 998 1.1.1.2.2.2 snj and continue the data display properly indented on the next line. 999 1.1.1.2.2.2 snj 1000 1.1.1.2.2.2 snj <div class="node"> 1001 1.1.1.2.2.2 snj <p><hr> 1002 1.1.1.2.2.2 snj <a name="ntpq-config"></a>Next: <a rel="next" accesskey="n" href="#ntpq-exit-status">ntpq exit status</a>, 1003 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-wide">ntpq wide</a>, 1004 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 1005 1.1.1.2.2.2 snj <br> 1006 1.1.1.2.2.2 snj </div> 1007 1.1.1.2.2.2 snj 1008 1.1.1.2.2.2 snj <h4 class="subsection">presetting/configuring ntpq</h4> 1009 1.1.1.2.2.2 snj 1010 1.1.1.2.2.2 snj <p>Any option that is not marked as <i>not presettable</i> may be preset by 1011 1.1.1.2.2.2 snj loading values from configuration ("rc" or "ini") files, and values from environment variables named <code>NTPQ</code> and <code>NTPQ_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of 1012 1.1.1.2.2.2 snj the options listed above in upper case and segmented with underscores. 1013 1.1.1.2.2.2 snj The <code>NTPQ</code> variable will be tokenized and parsed like 1014 1.1.1.2.2.2 snj the command line. The remaining variables are tested for existence and their 1015 1.1.1.2.2.2 snj values are treated like option arguments. 1016 1.1.1.2.2.2 snj 1017 1.1.1.2.2.2 snj <p class="noindent"><code>libopts</code> will search in 2 places for configuration files: 1018 1.1.1.2.2.2 snj <ul> 1019 1.1.1.2.2.2 snj <li>$HOME 1020 1.1.1.2.2.2 snj <li>$PWD 1021 1.1.1.2.2.2 snj </ul> 1022 1.1.1.2.2.2 snj The environment variables <code>HOME</code>, and <code>PWD</code> 1023 1.1.1.2.2.2 snj are expanded and replaced when <span class="file">ntpq</span> runs. 1024 1.1.1.2.2.2 snj For any of these that are plain files, they are simply processed. 1025 1.1.1.2.2.2 snj For any that are directories, then a file named <span class="file">.ntprc</span> is searched for 1026 1.1.1.2.2.2 snj within that directory and processed. 1027 1.1.1.2.2.2 snj 1028 1.1.1.2.2.2 snj <p>Configuration files may be in a wide variety of formats. 1029 1.1.1.2.2.2 snj The basic format is an option name followed by a value (argument) on the 1030 1.1.1.2.2.2 snj same line. Values may be separated from the option name with a colon, 1031 1.1.1.2.2.2 snj equal sign or simply white space. Values may be continued across multiple 1032 1.1.1.2.2.2 snj lines by escaping the newline with a backslash. 1033 1.1.1.2.2.2 snj 1034 1.1.1.2.2.2 snj <p>Multiple programs may also share the same initialization file. 1035 1.1.1.2.2.2 snj Common options are collected at the top, followed by program specific 1036 1.1.1.2.2.2 snj segments. The segments are separated by lines like: 1037 1.1.1.2.2.2 snj <pre class="example"> [NTPQ] 1038 1.1.1.2.2.2 snj </pre> 1039 1.1.1.2.2.2 snj <p class="noindent">or by 1040 1.1.1.2.2.2 snj <pre class="example"> <?program ntpq> 1041 1.1.1.2.2.2 snj </pre> 1042 1.1.1.2.2.2 snj <p class="noindent">Do not mix these styles within one configuration file. 1043 1.1.1.2.2.2 snj 1044 1.1.1.2.2.2 snj <p>Compound values and carefully constructed string values may also be 1045 1.1.1.2.2.2 snj specified using XML syntax: 1046 1.1.1.2.2.2 snj <pre class="example"> <option-name> 1047 1.1.1.2.2.2 snj <sub-opt>...&lt;...&gt;...</sub-opt> 1048 1.1.1.2.2.2 snj </option-name> 1049 1.1.1.2.2.2 snj </pre> 1050 1.1.1.2.2.2 snj <p class="noindent">yielding an <code>option-name.sub-opt</code> string value of 1051 1.1.1.2.2.2 snj <pre class="example"> "...<...>..." 1052 1.1.1.2.2.2 snj </pre> 1053 1.1.1.2.2.2 snj <p><code>AutoOpts</code> does not track suboptions. You simply note that it is a 1054 1.1.1.2.2.2 snj hierarchicly valued option. <code>AutoOpts</code> does provide a means for searching 1055 1.1.1.2.2.2 snj the associated name/value pair list (see: optionFindValue). 1056 1.1.1.2.2.2 snj 1057 1.1.1.2.2.2 snj <p>The command line options relating to configuration and/or usage help are: 1058 1.1.1.2.2.2 snj 1059 1.1.1.2.2.2 snj <h5 class="subsubheading">version (-)</h5> 1060 1.1.1.2.2.2 snj 1061 1.1.1.2.2.2 snj <p>Print the program version to standard out, optionally with licensing 1062 1.1.1.2.2.2 snj information, then exit 0. The optional argument specifies how much licensing 1063 1.1.1.2.2.2 snj detail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument. 1064 1.1.1.2.2.2 snj Only the first letter of the argument is examined: 1065 1.1.1.2.2.2 snj 1066 1.1.1.2.2.2 snj <dl> 1067 1.1.1.2.2.2 snj <dt><span class="samp">version</span><dd>Only print the version. This is the default. 1068 1.1.1.2.2.2 snj <br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms. 1069 1.1.1.2.2.2 snj <br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms. 1070 1.1.1.2.2.2 snj </dl> 1071 1.1.1.2.2.2 snj 1072 1.1.1.2.2.2 snj <div class="node"> 1073 1.1.1.2.2.2 snj <p><hr> 1074 1.1.1.2.2.2 snj <a name="ntpq-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntpq-config">ntpq config</a>, 1075 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a> 1076 1.1.1.2.2.2 snj <br> 1077 1.1.1.2.2.2 snj </div> 1078 1.1.1.2.2.2 snj 1079 1.1.1.2.2.2 snj <h4 class="subsection">ntpq exit status</h4> 1080 1.1.1.2.2.2 snj 1081 1.1.1.2.2.2 snj <p>One of the following exit values will be returned: 1082 1.1.1.2.2.2 snj <dl> 1083 1.1.1.2.2.2 snj <dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. 1084 1.1.1.2.2.2 snj <br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. 1085 1.1.1.2.2.2 snj <br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded. 1086 1.1.1.2.2.2 snj <br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report 1087 1.1.1.2.2.2 snj it to autogen-users (a] lists.sourceforge.net. Thank you. 1088 1.1.1.2.2.2 snj </dl> 1089 1.1.1.2.2.2 snj 1090 1.1.1.2.2.2 snj <div class="node"> 1091 1.1.1.2.2.2 snj <p><hr> 1092 1.1.1.2.2.2 snj <a name="Usage"></a>Next: <a rel="next" accesskey="n" href="#Internal-Commands">Internal Commands</a>, 1093 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#ntpq-Description">ntpq Description</a>, 1094 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1095 1.1.1.2.2.2 snj <br> 1096 1.1.1.2.2.2 snj </div> 1097 1.1.1.2.2.2 snj 1098 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1099 1.1.1.2.2.2 snj <h3 class="section">Usage</h3> 1100 1.1.1.2.2.2 snj 1101 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="23%">What </th><th valign="top" width="23%">Default </th><th valign="top" width="5%">Flag </th><th valign="top" width="15%">Option 1102 1.1.1.2.2.2 snj <br></th></tr><tr align="left"><td valign="top" width="23%">configuration file 1103 1.1.1.2.2.2 snj </td><td valign="top" width="23%"><code>/etc/ntp.conf</code> 1104 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-c</code> 1105 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>conffile</code> 1106 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">frequency file 1107 1.1.1.2.2.2 snj </td><td valign="top" width="23%">none 1108 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-f</code> 1109 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>driftfile</code> 1110 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">leapseconds file 1111 1.1.1.2.2.2 snj </td><td valign="top" width="23%">none 1112 1.1.1.2.2.2 snj </td><td valign="top" width="5%"> 1113 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>leapfile</code> 1114 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">process ID file 1115 1.1.1.2.2.2 snj </td><td valign="top" width="23%">none 1116 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-p</code> 1117 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>pidfile</code> 1118 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">log file 1119 1.1.1.2.2.2 snj </td><td valign="top" width="23%">system log 1120 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-l</code> 1121 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>logfile</code> 1122 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">include file 1123 1.1.1.2.2.2 snj </td><td valign="top" width="23%">none 1124 1.1.1.2.2.2 snj </td><td valign="top" width="5%">none 1125 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>includefile</code> 1126 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">statistics path 1127 1.1.1.2.2.2 snj </td><td valign="top" width="23%"><code>/var/NTP</code> 1128 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-s</code> 1129 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>statsdir</code> 1130 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="23%">keys path 1131 1.1.1.2.2.2 snj </td><td valign="top" width="23%"><code>/usr/local/etc</code> 1132 1.1.1.2.2.2 snj </td><td valign="top" width="5%"><code>-k</code> 1133 1.1.1.2.2.2 snj </td><td valign="top" width="15%"><code>keysdir</code> 1134 1.1.1.2.2.2 snj <br></td></tr></table> 1135 1.1.1.2.2.2 snj 1136 1.1.1.2.2.2 snj <div class="node"> 1137 1.1.1.2.2.2 snj <p><hr> 1138 1.1.1.2.2.2 snj <a name="Internal-Commands"></a>Next: <a rel="next" accesskey="n" href="#Control-Message-Commands">Control Message Commands</a>, 1139 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#Usage">Usage</a>, 1140 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1141 1.1.1.2.2.2 snj <br> 1142 1.1.1.2.2.2 snj </div> 1143 1.1.1.2.2.2 snj 1144 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1145 1.1.1.2.2.2 snj <h3 class="section">Internal Commands</h3> 1146 1.1.1.2.2.2 snj 1147 1.1.1.2.2.2 snj <p>Interactive format commands consist of a keyword followed by zero to four arguments. Only enough characters of the full keyword to uniquely identify the command need be typed. The output of a command is normally sent to the standard output, but optionally the output of individual commands may be sent to a file by appending a <code>></code>, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the <code>ntpq</code> program itself and do not result in NTP mode-6 requests being sent to a server. These are described following. 1148 1.1.1.2.2.2 snj 1149 1.1.1.2.2.2 snj <dl> 1150 1.1.1.2.2.2 snj <dt><code><a name="help"></a> ? [</code><kbd>command_keyword</kbd><code>]</code><dt><code>help [</code><kbd>command_keyword</kbd><code>]</code><dd>A <code>?</code> by itself will print a list of all the command keywords known to <code>ntpq</code>. A <code>?</code> followed by a command keyword will print function and usage information about the command. 1151 1.1.1.2.2.2 snj 1152 1.1.1.2.2.2 snj <br><dt><code><a name="addvars"></a> >addvars </code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code>] [...]</code><dt><code>rmvars </code><kbd>name</kbd><code> [...]</code><dt><code>clearvars</dt></code><dd>The arguments to these commands consist of a list of items of the form 1153 1.1.1.2.2.2 snj <kbd>name</kbd><code> = </code><kbd>value</kbd>, where the <code>= </code><kbd>value</kbd> is ignored, 1154 1.1.1.2.2.2 snj and can be omitted in read requests. 1155 1.1.1.2.2.2 snj <code>ntpq</code> maintains an internal list in which data to be included 1156 1.1.1.2.2.2 snj in control messages can be assembled, and sent using the <code>readlist</code> 1157 1.1.1.2.2.2 snj and <code>writelist</code> commands described below. 1158 1.1.1.2.2.2 snj The <code>addvars</code> command allows variables and optional values 1159 1.1.1.2.2.2 snj to be added to the list. 1160 1.1.1.2.2.2 snj If more than one variable is to be added 1161 1.1.1.2.2.2 snj the list should be comma-separated and not contain white space. 1162 1.1.1.2.2.2 snj The <code>rmvars</code> command can be used to remove individual variables 1163 1.1.1.2.2.2 snj from the list, 1164 1.1.1.2.2.2 snj while the <code>clearlist</code> command removes all variables from the list. 1165 1.1.1.2.2.2 snj 1166 1.1.1.2.2.2 snj <br><dt><code><a name="cooked"></a> cooked</code><dd>Display server messages in prettyprint format. 1167 1.1.1.2.2.2 snj 1168 1.1.1.2.2.2 snj <br><dt><code><a name="debug"></a> debug more | less | off</code><dd>Turns internal query program debugging on and off. 1169 1.1.1.2.2.2 snj 1170 1.1.1.2.2.2 snj <br><dt><code><a name="delay"></a> delay </code><kbd>milliseconds</kbd><dd>Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete. 1171 1.1.1.2.2.2 snj 1172 1.1.1.2.2.2 snj <br><dt><code><a name="host"></a> host </code><kbd>name</kbd><dd>Set the host to which future queries will be sent. 1173 1.1.1.2.2.2 snj The name may be either a DNS name or a numeric address. 1174 1.1.1.2.2.2 snj 1175 1.1.1.2.2.2 snj <br><dt><code><a name="hostnames"></a> hostnames [yes | no]</code><dd>If <code>yes</code> is specified, host names are printed in information displays. 1176 1.1.1.2.2.2 snj If <code>no</code> is specified, numeric addresses are printed instead. 1177 1.1.1.2.2.2 snj The default is <code>yes</code>, 1178 1.1.1.2.2.2 snj unless modified using the command line <code>-n</code> switch. 1179 1.1.1.2.2.2 snj 1180 1.1.1.2.2.2 snj <br><dt><code><a name="keyid"></a> keyid </code><kbd>keyid</kbd><dd>This command specifies the key number to be used 1181 1.1.1.2.2.2 snj to authenticate configuration requests. 1182 1.1.1.2.2.2 snj This must correspond to a key ID configured in <code>ntp.conf</code> for this purpose. 1183 1.1.1.2.2.2 snj 1184 1.1.1.2.2.2 snj <br><dt><code><a name="keytype"></a> keytype</code><dd>Specify the digest algorithm to use for authenticated requests, 1185 1.1.1.2.2.2 snj with default <code>MD5</code>. 1186 1.1.1.2.2.2 snj If the OpenSSL library is installed, 1187 1.1.1.2.2.2 snj digest can be be any message digest algorithm supported by the library. 1188 1.1.1.2.2.2 snj The current selections are: <code>MD2</code>, <code>MD4</code>, <code>MD5</code>, <code>MDC2</code>, <code>RIPEMD160</code>, <code>SHA</code> and <code>SHA1</code>. 1189 1.1.1.2.2.2 snj 1190 1.1.1.2.2.2 snj <br><dt><code><a name="ntpversion"></a> ntpversion 1 | 2 | 3 | 4</code><dd>Sets the NTP version number which <code>ntpq</code> claims in packets. 1191 1.1.1.2.2.2 snj Defaults to 2. 1192 1.1.1.2.2.2 snj Note that mode-6 control messages (and modes, for that matter) 1193 1.1.1.2.2.2 snj didn't exist in NTP version 1. 1194 1.1.1.2.2.2 snj 1195 1.1.1.2.2.2 snj <br><dt><code><a name="passwd"></a> passwd</code><dd>This command prompts for a password to authenticate requests. 1196 1.1.1.2.2.2 snj The password must correspond to the key ID configured in <code>ntp.conf</code> for this purpose. 1197 1.1.1.2.2.2 snj 1198 1.1.1.2.2.2 snj <br><dt><code><a name="quit"></a> quit</code><dd>Exit <code>ntpq</code>. 1199 1.1.1.2.2.2 snj 1200 1.1.1.2.2.2 snj <br><dt><code><a name="raw"></a> raw</code><dd>Display server messages as received and without reformatting. 1201 1.1.1.2.2.2 snj 1202 1.1.1.2.2.2 snj <br><dt><code><a name="timeout"></a> timeout </code><kbd>millseconds</kbd><dd>Specify a timeout period for responses to server queries. 1203 1.1.1.2.2.2 snj The default is about 5000 milliseconds. 1204 1.1.1.2.2.2 snj Note that since <code>ntpq</code> retries each query once after a timeout 1205 1.1.1.2.2.2 snj the total waiting time for a timeout will be twice the timeout value set. 1206 1.1.1.2.2.2 snj 1207 1.1.1.2.2.2 snj </dl> 1208 1.1.1.2.2.2 snj 1209 1.1.1.2.2.2 snj <div class="node"> 1210 1.1.1.2.2.2 snj <p><hr> 1211 1.1.1.2.2.2 snj <a name="Control-Message-Commands"></a>Next: <a rel="next" accesskey="n" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>, 1212 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#Internal-Commands">Internal Commands</a>, 1213 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1214 1.1.1.2.2.2 snj <br> 1215 1.1.1.2.2.2 snj </div> 1216 1.1.1.2.2.2 snj 1217 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1218 1.1.1.2.2.2 snj <h3 class="section">Control Message Commands</h3> 1219 1.1.1.2.2.2 snj 1220 1.1.1.2.2.2 snj <p>Association IDs are used to identify system, peer and clock variables. 1221 1.1.1.2.2.2 snj System variables are assigned an association ID of zero and system name space, 1222 1.1.1.2.2.2 snj while each association is assigned a nonzero association ID and peer namespace. 1223 1.1.1.2.2.2 snj Most control commands send a single mode-6 message to the server 1224 1.1.1.2.2.2 snj and expect a single response message. 1225 1.1.1.2.2.2 snj The exceptions are the <code>peers</code> command, 1226 1.1.1.2.2.2 snj which sends a series of messages, 1227 1.1.1.2.2.2 snj and the <code>mreadlist</code> and <code>mreadvar</code> commands, 1228 1.1.1.2.2.2 snj which iterate over a range of associations. 1229 1.1.1.2.2.2 snj 1230 1.1.1.2.2.2 snj <p><a name="as"></a> 1231 1.1.1.2.2.2 snj <dl> 1232 1.1.1.2.2.2 snj <dt><code>associations</code><dd>Display a list of mobilized associations in the form: 1233 1.1.1.2.2.2 snj <br> 1234 1.1.1.2.2.2 snj <code>ind assid status conf reach auth condition last_event cnt</code> 1235 1.1.1.2.2.2 snj 1236 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="40%">Description 1237 1.1.1.2.2.2 snj 1238 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>ind</code> 1239 1.1.1.2.2.2 snj </td><td valign="top" width="40%">index on this list 1240 1.1.1.2.2.2 snj 1241 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>assid</code> 1242 1.1.1.2.2.2 snj </td><td valign="top" width="40%">association ID 1243 1.1.1.2.2.2 snj 1244 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code> 1245 1.1.1.2.2.2 snj </td><td valign="top" width="40%"><a href="decode.html#peer">peer status word</a> 1246 1.1.1.2.2.2 snj 1247 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>conf</code> 1248 1.1.1.2.2.2 snj </td><td valign="top" width="40%"><code>yes</code>: persistent, <code>no</code>: ephemeral 1249 1.1.1.2.2.2 snj 1250 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code> 1251 1.1.1.2.2.2 snj </td><td valign="top" width="40%"><code>yes</code>: reachable, <code>no</code>: unreachable 1252 1.1.1.2.2.2 snj 1253 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>auth</code> 1254 1.1.1.2.2.2 snj </td><td valign="top" width="40%"><code>ok</code>, <code>yes</code>, <code>bad</code> and <code>none</code> 1255 1.1.1.2.2.2 snj 1256 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>condition</code> 1257 1.1.1.2.2.2 snj </td><td valign="top" width="40%">selection status (see the <code>select</code> field of the <a href="decode.html#peer">peer status word</a>) 1258 1.1.1.2.2.2 snj 1259 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>last_event</code> 1260 1.1.1.2.2.2 snj </td><td valign="top" width="40%">event report (see the <code>event</code> field of the <a href="decode.html#peer">peer status word</a>) 1261 1.1.1.2.2.2 snj 1262 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>cnt</code> 1263 1.1.1.2.2.2 snj event count (see the <code>count</code> field of the <a href="decode.html#peer">peer status word</a>) 1264 1.1.1.2.2.2 snj 1265 1.1.1.2.2.2 snj <br></td></tr></table> 1266 1.1.1.2.2.2 snj 1267 1.1.1.2.2.2 snj <br><dt><code><a name="cv"></a> clockvar </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...]] [...]]</code><dt><code>cv </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...] ][...]]</code><dd>Display a list of <a href="#clock">clock variables</a> for those associations supporting a reference clock. 1268 1.1.1.2.2.2 snj 1269 1.1.1.2.2.2 snj <br><dt><code><a name="_003aconfig"></a> :config [...]</code><dd>Send the remainder of the command line, including whitespace, to the server 1270 1.1.1.2.2.2 snj as a run-time configuration command in the same format 1271 1.1.1.2.2.2 snj as the configuration file. 1272 1.1.1.2.2.2 snj This command is experimental until further notice and clarification. 1273 1.1.1.2.2.2 snj Authentication is of course required. 1274 1.1.1.2.2.2 snj 1275 1.1.1.2.2.2 snj <br><dt><code><a name="config_002dfrom_002dfile"></a> config-from-file </code><kbd>filename</kbd><dd>Send the each line of <kbd>filename</kbd> to the server as 1276 1.1.1.2.2.2 snj run-time configuration commands in the same format as the configuration file. 1277 1.1.1.2.2.2 snj This command is experimental until further notice and clarification. 1278 1.1.1.2.2.2 snj Authentication is required. 1279 1.1.1.2.2.2 snj 1280 1.1.1.2.2.2 snj <br><dt><code><a name="ifstats"></a> ifstats</code><dd>Display statistics for each local network address. 1281 1.1.1.2.2.2 snj Authentication is required. 1282 1.1.1.2.2.2 snj 1283 1.1.1.2.2.2 snj <br><dt><code><a name="iostats"></a> iostats</code><dd>Display network and reference clock I/O statistics. 1284 1.1.1.2.2.2 snj 1285 1.1.1.2.2.2 snj <br><dt><code><a name="kerninfo"></a> kerninfo</code><dd>Display kernel loop and PPS statistics. 1286 1.1.1.2.2.2 snj As with other ntpq output, times are in milliseconds. 1287 1.1.1.2.2.2 snj The precision value displayed is in milliseconds as well, 1288 1.1.1.2.2.2 snj unlike the precision system variable. 1289 1.1.1.2.2.2 snj 1290 1.1.1.2.2.2 snj <br><dt><code><a name="lassoc"></a> lassociations</code><dd>Perform the same function as the associations command, 1291 1.1.1.2.2.2 snj except display mobilized and unmobilized associations. 1292 1.1.1.2.2.2 snj 1293 1.1.1.2.2.2 snj <br><dt><code><a name="monstats"></a> monstats</code><dd>Display monitor facility statistics. 1294 1.1.1.2.2.2 snj 1295 1.1.1.2.2.2 snj <br><dt><code><a name="mrulist"></a> mrulist [limited | kod | mincount=</code><kbd>count</kbd><code> | laddr=</code><kbd>localaddr</kbd><code> | sort=</code><kbd>sortorder</kbd><code> | resany=</code><kbd>hexmask</kbd><code> | resall=</code><kbd>hexmask</kbd><code>]</code><dd>Obtain and print traffic counts collected and maintained by 1296 1.1.1.2.2.2 snj the monitor facility. 1297 1.1.1.2.2.2 snj With the exception of <code>sort=</code><kbd>sortorder</kbd>, 1298 1.1.1.2.2.2 snj the options filter the list returned by <code>ntpd</code>. 1299 1.1.1.2.2.2 snj The <code>limited</code> and <code>kod</code> options return only entries 1300 1.1.1.2.2.2 snj representing client addresses from which the last packet received 1301 1.1.1.2.2.2 snj triggered either discarding or a KoD response. 1302 1.1.1.2.2.2 snj The <code>mincount=</code><kbd>count</kbd> option filters entries representing 1303 1.1.1.2.2.2 snj less than <kbd>count</kbd> packets. 1304 1.1.1.2.2.2 snj The <code>laddr=</code><kbd>localaddr</kbd> option filters entries for packets 1305 1.1.1.2.2.2 snj received on any local address other than <kbd>localaddr</kbd>. 1306 1.1.1.2.2.2 snj <code>resany=</code><kbd>hexmask</kbd> and <code>resall=</code><kbd>hexmask</kbd> 1307 1.1.1.2.2.2 snj filter entries containing none or less than all, respectively, 1308 1.1.1.2.2.2 snj of the bits in <kbd>hexmask</kbd>, which must begin with <code>0x</code>. 1309 1.1.1.2.2.2 snj <br> 1310 1.1.1.2.2.2 snj The <kbd>sortorder</kbd> defaults to <code>lstint</code> and may be any of 1311 1.1.1.2.2.2 snj <code>addr</code>, <code>count</code>, <code>avgint</code>, <code>lstint</code>, or 1312 1.1.1.2.2.2 snj any of those preceded by a minus sign (hyphen) to reverse the sort order. 1313 1.1.1.2.2.2 snj The output columns are: 1314 1.1.1.2.2.2 snj 1315 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Column </th><th valign="top" width="40%">Description 1316 1.1.1.2.2.2 snj 1317 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>lstint</code> 1318 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1319 1.1.1.2.2.2 snj Interval in s between the receipt of the most recent packet from this 1320 1.1.1.2.2.2 snj address and the completion of the retrieval of the MRU list by <code>ntpq</code> 1321 1.1.1.2.2.2 snj 1322 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>avgint</code> 1323 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1324 1.1.1.2.2.2 snj Average interval in s between packets from this address. 1325 1.1.1.2.2.2 snj 1326 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rstr</code> 1327 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1328 1.1.1.2.2.2 snj Restriction flags associated with this address. 1329 1.1.1.2.2.2 snj Most are copied unchanged from the matching <code>restrict</code> command, 1330 1.1.1.2.2.2 snj however 0x400 (kod) and 0x20 (limited) flags are cleared unless 1331 1.1.1.2.2.2 snj the last packet from this address triggered a rate control response. 1332 1.1.1.2.2.2 snj 1333 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>r</code> 1334 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1335 1.1.1.2.2.2 snj Rate control indicator, either a period, <code>L</code> or <code>K</code> for 1336 1.1.1.2.2.2 snj no rate control response, rate limiting by discarding, or 1337 1.1.1.2.2.2 snj rate limiting with a KoD response, respectively. 1338 1.1.1.2.2.2 snj 1339 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>m</code> 1340 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1341 1.1.1.2.2.2 snj Packet mode. 1342 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>v</code> 1343 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1344 1.1.1.2.2.2 snj Packet version number. 1345 1.1.1.2.2.2 snj 1346 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>count</code> 1347 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1348 1.1.1.2.2.2 snj Packets received from this address. 1349 1.1.1.2.2.2 snj 1350 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rport</code> 1351 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1352 1.1.1.2.2.2 snj Source port of last packet from this address. 1353 1.1.1.2.2.2 snj 1354 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>remote address</code> 1355 1.1.1.2.2.2 snj </td><td valign="top" width="40%"> 1356 1.1.1.2.2.2 snj DNS name, numeric address, or address followed by claimed DNS name which 1357 1.1.1.2.2.2 snj could not be verified in parentheses. 1358 1.1.1.2.2.2 snj 1359 1.1.1.2.2.2 snj <br></td></tr></table> 1360 1.1.1.2.2.2 snj 1361 1.1.1.2.2.2 snj <br><dt><code><a name="mreadvar"></a> mreadvar </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dt><code><a name="mrv"></a> mrv </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dd>Perform the same function as the <code>readvar</code> command, 1362 1.1.1.2.2.2 snj except for a range of association IDs. 1363 1.1.1.2.2.2 snj This range is determined from the association list cached by 1364 1.1.1.2.2.2 snj the most recent <code>associations</code> command. 1365 1.1.1.2.2.2 snj 1366 1.1.1.2.2.2 snj <br><dt><code><a name="passoc"></a> passociations</code><dd>Perform the same function as the <code>associations command</code>, except that 1367 1.1.1.2.2.2 snj it uses previously stored data rather than making a new query. 1368 1.1.1.2.2.2 snj 1369 1.1.1.2.2.2 snj <br><dt><code><a name="pe"></a> peers</code><dd>Display a list of peers in the form: 1370 1.1.1.2.2.2 snj <br> 1371 1.1.1.2.2.2 snj <code>[tally]remote refid st t when pool reach delay offset jitter</code> 1372 1.1.1.2.2.2 snj 1373 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1374 1.1.1.2.2.2 snj <br></th></tr><tr align="left"><td valign="top" width="10%"><code>[tally]</code> 1375 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1376 1.1.1.2.2.2 snj single-character code indicating current value of the <code>select</code> field 1377 1.1.1.2.2.2 snj of the <a href="decode.html#peer">peer status word</a>. 1378 1.1.1.2.2.2 snj 1379 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>remote</code> 1380 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1381 1.1.1.2.2.2 snj host name (or IP number) of peer 1382 1.1.1.2.2.2 snj 1383 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code> 1384 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1385 1.1.1.2.2.2 snj association ID or <a href="decode.html#kiss">kiss code</a>. 1386 1.1.1.2.2.2 snj 1387 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>st</code> 1388 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1389 1.1.1.2.2.2 snj stratum 1390 1.1.1.2.2.2 snj 1391 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>t</code> 1392 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1393 1.1.1.2.2.2 snj <code>u</code>: unicast or manycast client, 1394 1.1.1.2.2.2 snj <code>b</code>: broadcast or multicast client, 1395 1.1.1.2.2.2 snj <code>l</code>: local (reference clock), 1396 1.1.1.2.2.2 snj <code>s</code>: symmetric (peer), 1397 1.1.1.2.2.2 snj <code>A</code>: manycast server, 1398 1.1.1.2.2.2 snj <code>B</code>: broadcast server, 1399 1.1.1.2.2.2 snj <code>M</code>: multicast server. 1400 1.1.1.2.2.2 snj 1401 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>when</code> 1402 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1403 1.1.1.2.2.2 snj sec/min/hr since last received packet 1404 1.1.1.2.2.2 snj 1405 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>poll</code> 1406 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1407 1.1.1.2.2.2 snj poll interval (log(2) s) 1408 1.1.1.2.2.2 snj 1409 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code> 1410 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1411 1.1.1.2.2.2 snj reach shift register (octal) 1412 1.1.1.2.2.2 snj 1413 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>delay</code> 1414 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1415 1.1.1.2.2.2 snj roundtrip delay 1416 1.1.1.2.2.2 snj 1417 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code> 1418 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1419 1.1.1.2.2.2 snj offset of server relative to this host 1420 1.1.1.2.2.2 snj 1421 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>jitter</code> 1422 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1423 1.1.1.2.2.2 snj jitter 1424 1.1.1.2.2.2 snj 1425 1.1.1.2.2.2 snj <br></td></tr></table> 1426 1.1.1.2.2.2 snj 1427 1.1.1.2.2.2 snj <br><dt><code><a name="rv"></a> readvar </code><kbd>assocID</kbd> <kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> ] [,...]</code><dt><code>rv </code><kbd>assocID</kbd><code> [ </code><kbd>name</kbd><code> ] [,...]</code><dd>Display the specified variables. 1428 1.1.1.2.2.2 snj If <kbd>assocID</kbd> is zero, 1429 1.1.1.2.2.2 snj the variables are from the <a href="#system">system variables</a> name space, 1430 1.1.1.2.2.2 snj otherwise they are from the <a href="#peer">peer variables</a> name space. 1431 1.1.1.2.2.2 snj The <kbd>assocID</kbd> is required, as the same name can occur in both spaces. 1432 1.1.1.2.2.2 snj If no <kbd>name</kbd> is included, 1433 1.1.1.2.2.2 snj all operative variables in the name space are displayed. 1434 1.1.1.2.2.2 snj In this case only, if the <kbd>assocID</kbd> is omitted, it is assumed zero. 1435 1.1.1.2.2.2 snj Multiple names are specified with comma separators and without whitespace. 1436 1.1.1.2.2.2 snj Note that time values are represented in milliseconds and 1437 1.1.1.2.2.2 snj frequency values in parts-per-million (PPM). 1438 1.1.1.2.2.2 snj Some NTP timestamps are represented in the format YYYYMMDDTTTT, 1439 1.1.1.2.2.2 snj where YYYY is the year, MM the month of year, DD the day of month and 1440 1.1.1.2.2.2 snj TTTT the time of day. 1441 1.1.1.2.2.2 snj 1442 1.1.1.2.2.2 snj <br><dt><code><a name="saveconfig"></a> saveconfig </code><kbd>filename</kbd><dd>Write the current configuration, including any runtime modifications 1443 1.1.1.2.2.2 snj given with <code>:config</code> or <code>config-from-file</code>, 1444 1.1.1.2.2.2 snj to the ntpd host's file <kbd>filename</kbd>. 1445 1.1.1.2.2.2 snj This command will be rejected by the server unless 1446 1.1.1.2.2.2 snj <a href="miscopt.html#saveconfigdir">saveconfigdir</a> 1447 1.1.1.2.2.2 snj appears in the <code>ntpd</code> configuration file. 1448 1.1.1.2.2.2 snj <kbd>filename</kbd> can use <code>strftime()</code> format specifiers 1449 1.1.1.2.2.2 snj to substitute the current date and time, for example, 1450 1.1.1.2.2.2 snj <code>saveconfig ntp-%Y%m%d-%H%M%S.conf</code>. 1451 1.1.1.2.2.2 snj The filename used is stored in system variable <code>savedconfig</code>. 1452 1.1.1.2.2.2 snj Authentication is required. 1453 1.1.1.2.2.2 snj 1454 1.1.1.2.2.2 snj <br><dt><code><a name="writevar"></a> writevar </code><kbd>assocID</kbd> <kbd>name</kbd><code> = </code><kbd>value</kbd><code> [,...]</code><dd>Write the specified variables. 1455 1.1.1.2.2.2 snj If the <kbd>assocID</kbd> is zero, the variables are from the 1456 1.1.1.2.2.2 snj <a href="#system">system variables</a> name space, otherwise they are from the 1457 1.1.1.2.2.2 snj <a href="#peer">peer variables</a> name space. 1458 1.1.1.2.2.2 snj The <kbd>assocID</kbd> is required, 1459 1.1.1.2.2.2 snj as the same name can occur in both spaces. 1460 1.1.1.2.2.2 snj 1461 1.1.1.2.2.2 snj <br><dt><code><a name="sysinfo"></a> sysinfo</code><dd>Display operational summary. 1462 1.1.1.2.2.2 snj 1463 1.1.1.2.2.2 snj <br><dt><code><a name="sysstats"></a> sysstats</code><dd>Print statistics counters maintained in the protocol module. 1464 1.1.1.2.2.2 snj 1465 1.1.1.2.2.2 snj </dl> 1466 1.1.1.2.2.2 snj 1467 1.1.1.2.2.2 snj <div class="node"> 1468 1.1.1.2.2.2 snj <p><hr> 1469 1.1.1.2.2.2 snj <a name="Status-Words-and-Kiss-Codes"></a>Next: <a rel="next" accesskey="n" href="#System-Variables">System Variables</a>, 1470 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#Control-Message-Commands">Control Message Commands</a>, 1471 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1472 1.1.1.2.2.2 snj <br> 1473 1.1.1.2.2.2 snj </div> 1474 1.1.1.2.2.2 snj 1475 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1476 1.1.1.2.2.2 snj <h3 class="section">Status Words and Kiss Codes</h3> 1477 1.1.1.2.2.2 snj 1478 1.1.1.2.2.2 snj <p>The current state of the operating program is shown 1479 1.1.1.2.2.2 snj in a set of status words maintained by the system 1480 1.1.1.2.2.2 snj and each association separately. 1481 1.1.1.2.2.2 snj These words are displayed in the <code>rv</code> and <code>as</code> commands 1482 1.1.1.2.2.2 snj both in hexadecimal and decoded short tip strings. 1483 1.1.1.2.2.2 snj The codes, tips and short explanations are on the 1484 1.1.1.2.2.2 snj <a href="decode.html">Event Messages and Status Words</a> page. 1485 1.1.1.2.2.2 snj The page also includes a list of system and peer messages, 1486 1.1.1.2.2.2 snj the code for the latest of which is included in the status word. 1487 1.1.1.2.2.2 snj 1488 1.1.1.2.2.2 snj <p>Information resulting from protocol machine state transitions 1489 1.1.1.2.2.2 snj is displayed using an informal set of ASCII strings called 1490 1.1.1.2.2.2 snj <a href="decode.html#kiss">kiss codes</a>. 1491 1.1.1.2.2.2 snj The original purpose was for kiss-o'-death (KoD) packets sent 1492 1.1.1.2.2.2 snj by the server to advise the client of an unusual condition. 1493 1.1.1.2.2.2 snj They are now displayed, when appropriate, 1494 1.1.1.2.2.2 snj in the reference identifier field in various billboards. 1495 1.1.1.2.2.2 snj 1496 1.1.1.2.2.2 snj <div class="node"> 1497 1.1.1.2.2.2 snj <p><hr> 1498 1.1.1.2.2.2 snj <a name="System-Variables"></a>Next: <a rel="next" accesskey="n" href="#Peer-Variables">Peer Variables</a>, 1499 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>, 1500 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1501 1.1.1.2.2.2 snj <br> 1502 1.1.1.2.2.2 snj </div> 1503 1.1.1.2.2.2 snj 1504 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1505 1.1.1.2.2.2 snj <h3 class="section">System Variables</h3> 1506 1.1.1.2.2.2 snj 1507 1.1.1.2.2.2 snj <p>The following system variables appear in the <code>rv</code> billboard. 1508 1.1.1.2.2.2 snj Not all variables are displayed in some configurations. 1509 1.1.1.2.2.2 snj 1510 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1511 1.1.1.2.2.2 snj 1512 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>status</code> 1513 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1514 1.1.1.2.2.2 snj <a href="decode.html#sys">system status word</a> 1515 1.1.1.2.2.2 snj 1516 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>version</code> 1517 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1518 1.1.1.2.2.2 snj NTP software version and build time 1519 1.1.1.2.2.2 snj 1520 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>processor</code> 1521 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1522 1.1.1.2.2.2 snj hardware platform and version 1523 1.1.1.2.2.2 snj 1524 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>system</code> 1525 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1526 1.1.1.2.2.2 snj operating system and version 1527 1.1.1.2.2.2 snj 1528 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code> 1529 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1530 1.1.1.2.2.2 snj leap warning indicator (0-3) 1531 1.1.1.2.2.2 snj 1532 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code> 1533 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1534 1.1.1.2.2.2 snj stratum (1-15) 1535 1.1.1.2.2.2 snj 1536 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code> 1537 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1538 1.1.1.2.2.2 snj precision (log(2) s) 1539 1.1.1.2.2.2 snj 1540 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code> 1541 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1542 1.1.1.2.2.2 snj total roundtrip delay to the primary reference clock 1543 1.1.1.2.2.2 snj 1544 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code> 1545 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1546 1.1.1.2.2.2 snj total dispersion to the primary reference clock 1547 1.1.1.2.2.2 snj 1548 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>peer</code> 1549 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1550 1.1.1.2.2.2 snj system peer association ID 1551 1.1.1.2.2.2 snj 1552 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tc</code> 1553 1.1.1.2.2.2 snj time constant and poll exponent (log(2) s) (3-17) 1554 1.1.1.2.2.2 snj 1555 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>mintc</code> 1556 1.1.1.2.2.2 snj minimum time constant (log(2) s) (3-10) 1557 1.1.1.2.2.2 snj 1558 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clock</code> 1559 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1560 1.1.1.2.2.2 snj date and time of day 1561 1.1.1.2.2.2 snj 1562 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code> 1563 1.1.1.2.2.2 snj reference ID or <a href="decode.html#kiss">kiss code</a> 1564 1.1.1.2.2.2 snj 1565 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code> 1566 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1567 1.1.1.2.2.2 snj reference time 1568 1.1.1.2.2.2 snj 1569 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code> 1570 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1571 1.1.1.2.2.2 snj combined offset of server relative to this host 1572 1.1.1.2.2.2 snj 1573 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>sys_jitter</code> 1574 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1575 1.1.1.2.2.2 snj combined system jitter 1576 1.1.1.2.2.2 snj 1577 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>frequency</code> 1578 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1579 1.1.1.2.2.2 snj frequency offset (PPM) relative to hardware clock 1580 1.1.1.2.2.2 snj 1581 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_wander</code> 1582 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1583 1.1.1.2.2.2 snj clock frequency wander (PPM) 1584 1.1.1.2.2.2 snj 1585 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>clk_jitter</code> 1586 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1587 1.1.1.2.2.2 snj clock jitter 1588 1.1.1.2.2.2 snj 1589 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>tai</code> 1590 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1591 1.1.1.2.2.2 snj TAI-UTC offset (s) 1592 1.1.1.2.2.2 snj 1593 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leapsec</code> 1594 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1595 1.1.1.2.2.2 snj NTP seconds when the next leap second is/was inserted 1596 1.1.1.2.2.2 snj 1597 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>expire</code> 1598 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1599 1.1.1.2.2.2 snj NTP seconds when the NIST leapseconds file expires 1600 1.1.1.2.2.2 snj 1601 1.1.1.2.2.2 snj <br></td></tr></table> 1602 1.1.1.2.2.2 snj 1603 1.1.1.2.2.2 snj <p>The jitter and wander statistics are exponentially-weighted RMS averages. 1604 1.1.1.2.2.2 snj The system jitter is defined in the NTPv4 specification; 1605 1.1.1.2.2.2 snj the clock jitter statistic is computed by the clock discipline module. 1606 1.1.1.2.2.2 snj 1607 1.1.1.2.2.2 snj <p>When the NTPv4 daemon is compiled with the OpenSSL software library, 1608 1.1.1.2.2.2 snj additional system variables are displayed, including some or all of the 1609 1.1.1.2.2.2 snj following, depending on the particular Autokey dance: 1610 1.1.1.2.2.2 snj 1611 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1612 1.1.1.2.2.2 snj 1613 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>host</code> 1614 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1615 1.1.1.2.2.2 snj Autokey host name for this host 1616 1.1.1.2.2.2 snj 1617 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code> 1618 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1619 1.1.1.2.2.2 snj Autokey group name for this host 1620 1.1.1.2.2.2 snj 1621 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code> 1622 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1623 1.1.1.2.2.2 snj host flags (see Autokey specification) 1624 1.1.1.2.2.2 snj 1625 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>digest</code> 1626 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1627 1.1.1.2.2.2 snj OpenSSL message digest algorithm 1628 1.1.1.2.2.2 snj 1629 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code> 1630 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1631 1.1.1.2.2.2 snj OpenSSL digest/signature scheme 1632 1.1.1.2.2.2 snj 1633 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>update</code> 1634 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1635 1.1.1.2.2.2 snj NTP seconds at last signature update 1636 1.1.1.2.2.2 snj 1637 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>cert</code> 1638 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1639 1.1.1.2.2.2 snj certificate subject, issuer and certificate flags 1640 1.1.1.2.2.2 snj 1641 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>until</code> 1642 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1643 1.1.1.2.2.2 snj NTP seconds when the certificate expires 1644 1.1.1.2.2.2 snj 1645 1.1.1.2.2.2 snj <br></td></tr></table> 1646 1.1.1.2.2.2 snj 1647 1.1.1.2.2.2 snj <div class="node"> 1648 1.1.1.2.2.2 snj <p><hr> 1649 1.1.1.2.2.2 snj <a name="Peer-Variables"></a>Next: <a rel="next" accesskey="n" href="#Clock-Variables">Clock Variables</a>, 1650 1.1.1.2.2.2 snj Previous: <a rel="previous" accesskey="p" href="#System-Variables">System Variables</a>, 1651 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1652 1.1.1.2.2.2 snj <br> 1653 1.1.1.2.2.2 snj </div> 1654 1.1.1.2.2.2 snj 1655 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1656 1.1.1.2.2.2 snj <h3 class="section">Peer Variables</h3> 1657 1.1.1.2.2.2 snj 1658 1.1.1.2.2.2 snj <p>The following peer variables appear in the <code>rv</code> billboard 1659 1.1.1.2.2.2 snj for each association. 1660 1.1.1.2.2.2 snj Not all variables are displayed in some configurations. 1661 1.1.1.2.2.2 snj 1662 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1663 1.1.1.2.2.2 snj 1664 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>associd</code> 1665 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1666 1.1.1.2.2.2 snj association ID 1667 1.1.1.2.2.2 snj 1668 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code> 1669 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1670 1.1.1.2.2.2 snj <a href="decode.html#peer">peer status word</a> 1671 1.1.1.2.2.2 snj 1672 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>srcadr</code> 1673 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>srcport</code> 1674 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1675 1.1.1.2.2.2 snj source (remote) IP address and port 1676 1.1.1.2.2.2 snj 1677 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dstadr</code> 1678 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>dstport</code> 1679 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1680 1.1.1.2.2.2 snj destination (local) IP address and port 1681 1.1.1.2.2.2 snj 1682 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>leap</code> 1683 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1684 1.1.1.2.2.2 snj leap indicator (0-3) 1685 1.1.1.2.2.2 snj 1686 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code> 1687 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1688 1.1.1.2.2.2 snj stratum (0-15) 1689 1.1.1.2.2.2 snj 1690 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>precision</code> 1691 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1692 1.1.1.2.2.2 snj precision (log(2) s) 1693 1.1.1.2.2.2 snj 1694 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdelay</code> 1695 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1696 1.1.1.2.2.2 snj total roundtrip delay to the primary reference clock 1697 1.1.1.2.2.2 snj 1698 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>rootdisp</code> 1699 1.1.1.2.2.2 snj </td><td valign="top" width="20%">total root dispersion to the primary reference clock 1700 1.1.1.2.2.2 snj 1701 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code> 1702 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1703 1.1.1.2.2.2 snj reference ID or <a href="decode.html#kiss">kiss code</a> 1704 1.1.1.2.2.2 snj 1705 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reftime</code> 1706 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1707 1.1.1.2.2.2 snj reference time 1708 1.1.1.2.2.2 snj 1709 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>reach</code> 1710 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1711 1.1.1.2.2.2 snj reach register (octal) 1712 1.1.1.2.2.2 snj 1713 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>unreach</code> 1714 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1715 1.1.1.2.2.2 snj unreach counter 1716 1.1.1.2.2.2 snj 1717 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hmode</code> 1718 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1719 1.1.1.2.2.2 snj host mode (1-6) 1720 1.1.1.2.2.2 snj 1721 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>pmode</code> 1722 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1723 1.1.1.2.2.2 snj peer mode (1-5) 1724 1.1.1.2.2.2 snj 1725 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>hpoll</code> 1726 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1727 1.1.1.2.2.2 snj host poll exponent (log(2) s) (3-17) 1728 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>ppoll</code> 1729 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1730 1.1.1.2.2.2 snj peer poll exponent (log(2) s) (3-17) 1731 1.1.1.2.2.2 snj 1732 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>headway</code> 1733 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1734 1.1.1.2.2.2 snj headway (see <a href="rate.html">Rate Management and the Kiss-o'-Death Packet</a>) 1735 1.1.1.2.2.2 snj 1736 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flash</code> 1737 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1738 1.1.1.2.2.2 snj <a href="decode.html#flash">flash status word</a> 1739 1.1.1.2.2.2 snj 1740 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>offset</code> 1741 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1742 1.1.1.2.2.2 snj filter offset 1743 1.1.1.2.2.2 snj 1744 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>delay</code> 1745 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1746 1.1.1.2.2.2 snj filter delay 1747 1.1.1.2.2.2 snj 1748 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>dispersion</code> 1749 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1750 1.1.1.2.2.2 snj filter dispersion 1751 1.1.1.2.2.2 snj 1752 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>jitter</code> 1753 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1754 1.1.1.2.2.2 snj filter jitter 1755 1.1.1.2.2.2 snj 1756 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>ident</code> 1757 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1758 1.1.1.2.2.2 snj Autokey group name for this association 1759 1.1.1.2.2.2 snj 1760 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>bias</code> 1761 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1762 1.1.1.2.2.2 snj unicast/broadcast bias 1763 1.1.1.2.2.2 snj 1764 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>xleave</code> 1765 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1766 1.1.1.2.2.2 snj interleave delay (see <a href="xleave.html">NTP Interleaved Modes</a>) 1767 1.1.1.2.2.2 snj 1768 1.1.1.2.2.2 snj <br></td></tr></table> 1769 1.1.1.2.2.2 snj 1770 1.1.1.2.2.2 snj <p>The bias variable is calculated when the first broadcast packet is received 1771 1.1.1.2.2.2 snj after the calibration volley. It represents the offset of the broadcast 1772 1.1.1.2.2.2 snj subgraph relative to the unicast subgraph. The xleave variable appears 1773 1.1.1.2.2.2 snj only the interleaved symmetric and interleaved modes. It represents 1774 1.1.1.2.2.2 snj the internal queuing, buffering and transmission delays for the preceding 1775 1.1.1.2.2.2 snj packet. 1776 1.1.1.2.2.2 snj 1777 1.1.1.2.2.2 snj <p>When the NTPv4 daemon is compiled with the OpenSSL software library, 1778 1.1.1.2.2.2 snj additional peer variables are displayed, including the following: 1779 1.1.1.2.2.2 snj 1780 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1781 1.1.1.2.2.2 snj 1782 1.1.1.2.2.2 snj <p><br></th></tr><tr align="left"><td valign="top" width="10%"><code>flags</code> 1783 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1784 1.1.1.2.2.2 snj peer flags (see Autokey specification) 1785 1.1.1.2.2.2 snj 1786 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>host</code> 1787 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1788 1.1.1.2.2.2 snj Autokey server name 1789 1.1.1.2.2.2 snj 1790 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code> 1791 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1792 1.1.1.2.2.2 snj peer flags (see Autokey specification) 1793 1.1.1.2.2.2 snj 1794 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>signature</code> 1795 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1796 1.1.1.2.2.2 snj OpenSSL digest/signature scheme 1797 1.1.1.2.2.2 snj 1798 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initsequence</code> 1799 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1800 1.1.1.2.2.2 snj initial key ID 1801 1.1.1.2.2.2 snj 1802 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>initkey</code> 1803 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1804 1.1.1.2.2.2 snj initial key index 1805 1.1.1.2.2.2 snj 1806 1.1.1.2.2.2 snj <p><br></td></tr><tr align="left"><td valign="top" width="10%"><code>timestamp</code> 1807 1.1.1.2.2.2 snj </td><td valign="top" width="20%"> 1808 1.1.1.2.2.2 snj Autokey signature timestamp 1809 1.1.1.2.2.2 snj 1810 1.1.1.2.2.2 snj <br></td></tr></table> 1811 1.1.1.2.2.2 snj 1812 1.1.1.2.2.2 snj <div class="node"> 1813 1.1.1.2.2.2 snj <p><hr> 1814 1.1.1.2.2.2 snj <a name="Clock-Variables"></a>Previous: <a rel="previous" accesskey="p" href="#Peer-Variables">Peer Variables</a>, 1815 1.1.1.2.2.2 snj Up: <a rel="up" accesskey="u" href="#Top">Top</a> 1816 1.1.1.2.2.2 snj <br> 1817 1.1.1.2.2.2 snj </div> 1818 1.1.1.2.2.2 snj 1819 1.1.1.2.2.2 snj <!-- node-name, next, previous, up --> 1820 1.1.1.2.2.2 snj <h3 class="section">Clock Variables</h3> 1821 1.1.1.2.2.2 snj 1822 1.1.1.2.2.2 snj <p>The following clock variables appear in the <code>cv</code> billboard for each association with a reference clock. Not all variables are displayed in some configurations. 1823 1.1.1.2.2.2 snj 1824 1.1.1.2.2.2 snj <p><table summary=""><tr align="left"><th valign="top" width="10%">Variable </th><th valign="top" width="20%">Description 1825 1.1.1.2.2.2 snj <br></th></tr><tr align="left"><td valign="top" width="10%"><code>associd</code> 1826 1.1.1.2.2.2 snj </td><td valign="top" width="20%">association ID 1827 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>status</code> 1828 1.1.1.2.2.2 snj </td><td valign="top" width="20%"><a href="decode.html#clock">clock status word</a> 1829 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>device</code> 1830 1.1.1.2.2.2 snj </td><td valign="top" width="20%">device description 1831 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>timecode</code> 1832 1.1.1.2.2.2 snj </td><td valign="top" width="20%">ASCII time code string (specific to device) 1833 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>poll</code> 1834 1.1.1.2.2.2 snj </td><td valign="top" width="20%">poll messages sent 1835 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>noreply</code> 1836 1.1.1.2.2.2 snj </td><td valign="top" width="20%">no reply 1837 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>badformat</code> 1838 1.1.1.2.2.2 snj </td><td valign="top" width="20%">bad format 1839 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>baddata</code> 1840 1.1.1.2.2.2 snj </td><td valign="top" width="20%">bad date or time 1841 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>fudgetime1</code> 1842 1.1.1.2.2.2 snj </td><td valign="top" width="20%">fudge time 1 1843 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>fudgetime2</code> 1844 1.1.1.2.2.2 snj </td><td valign="top" width="20%">fudge time 2 1845 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>stratum</code> 1846 1.1.1.2.2.2 snj </td><td valign="top" width="20%">driver stratum 1847 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>refid</code> 1848 1.1.1.2.2.2 snj </td><td valign="top" width="20%">driver reference ID 1849 1.1.1.2.2.2 snj <br></td></tr><tr align="left"><td valign="top" width="10%"><code>flags</code> 1850 1.1.1.2.2.2 snj </td><td valign="top" width="20%">driver flags 1851 1.1.1.2.2.2 snj <br></td></tr></table> 1852 1.1.1.2.2.2 snj 1853 1.1.1.2.2.2 snj </body></html> 1854 1.1.1.2.2.2 snj 1855
Indexes created Tue Jul 14 00:26:25 UTC 2026