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