19c2daa00SOllivier Robert<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 29c2daa00SOllivier Robert<html> 39c2daa00SOllivier Robert<head> 4ea906c41SOllivier Robert<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> 59c2daa00SOllivier Robert<meta name="generator" content="HTML Tidy, see www.w3.org"> 69c2daa00SOllivier Robert<title>ntpq - standard NTP query program</title> 79c2daa00SOllivier Robert<link href="scripts/style.css" type="text/css" rel="stylesheet"> 89c2daa00SOllivier Robert</head> 99c2daa00SOllivier Robert<body> 109c2daa00SOllivier Robert<h3><tt>ntpq</tt> - standard NTP query program</h3> 119c2daa00SOllivier Robert<img src="pic/bustardfly.gif" alt="gif" align="left"><a href="http://www.eecis.udel.edu/~mills/pictures.html">from <i>Pogo</i>, Walt Kelly</a> 129c2daa00SOllivier Robert<p>A typical NTP monitoring packet</p> 132b15cb3dSCy Schubert<p>Last update: 1409100258SXin LI <!-- #BeginDate format:En2m -->24-Jan-2018 08:35<!-- #EndDate --> 152b15cb3dSCy Schubert UTC</p> 169c2daa00SOllivier Robert<br clear="left"> 179c2daa00SOllivier Robert<h4>More Help</h4> 182b15cb3dSCy Schubert<script type="text/javascript" language="javascript" src="scripts/manual.txt"></script> 199c2daa00SOllivier Robert<hr> 209c2daa00SOllivier Robert<h4>Synopsis</h4> 212b15cb3dSCy Schubert<tt>ntpq [-46dinp] [-c <i>command</i>] [<i>host</i>] [...]</tt> 229c2daa00SOllivier Robert<h4>Description</h4> 232b15cb3dSCy Schubert<p>The <tt>ntpq</tt> utility program is used to monitor NTP daemon <tt>ntpd</tt> operations 242b15cb3dSCy Schubert and determine performance. It uses the standard NTP mode 6 control 252b15cb3dSCy Schubert message formats defined in Appendix B of the NTPv3 specification 262b15cb3dSCy Schubert RFC1305. The same formats are used in NTPv4, although some of the 272b15cb3dSCy Schubert variable names have changed and new ones added. The description 282b15cb3dSCy Schubert on this page is for the NTPv4 variables.</p> 299c2daa00SOllivier Robert<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 <tt>ntpq</tt> can also obtain and print a list of peers in a common format by sending multiple queries to the server.</p> 309c2daa00SOllivier Robert<p>If one or more request options is included on the command line when <tt>ntpq</tt> 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, <tt>ntpq</tt> 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. <tt>ntpq</tt> will prompt for commands if the standard input is a terminal device.</p> 319c2daa00SOllivier Robert<p><tt>ntpq</tt> 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. <tt>ntpq</tt> makes one attempt to retransmit requests, and will time requests out if the remote host is not heard from within a suitable timeout time.</p> 329c2daa00SOllivier Robert<p>Note that in contexts where a host name is expected, a <tt>-4</tt> qualifier preceding the host name forces DNS resolution to the IPv4 namespace, while a <tt>-6</tt> qualifier forces DNS resolution to the IPv6 namespace.</p> 339c2daa00SOllivier Robert<p>For examples and usage, see the <a href="debug.html">NTP Debugging Techniques</a> page.</p> 349c2daa00SOllivier Robert<p>Command line options are described following. Specifying a command line option other than <tt>-i</tt> or <tt>-n</tt> will cause the specified query (queries) to be sent to the indicated host(s) immediately. Otherwise, <tt>ntpq</tt> will attempt to read interactive format commands from the standard input.</p> 359c2daa00SOllivier Robert<dl> 362b15cb3dSCy Schubert <dt><tt>-4</tt></dt> 372b15cb3dSCy Schubert <dd>Force DNS resolution of following host names on the command line to the IPv4 namespace.</dd> 382b15cb3dSCy Schubert <dt><tt>-6</tt></dt> 392b15cb3dSCy Schubert <dd>Force DNS resolution of following host names on the command line to the IPv6 namespace.</dd> 402b15cb3dSCy Schubert <dt><tt>-c</tt></dt> 412b15cb3dSCy Schubert <dd>The following argument is interpreted as an interactive format command and is added to the list of commands to be executed on the specified host(s). Multiple <tt>-c</tt> options may be given.</dd> 422b15cb3dSCy Schubert <dt><tt>-d</tt></dt> 432b15cb3dSCy Schubert <dd>Turn on debugging mode.</dd> 442b15cb3dSCy Schubert <dt><tt>-i</tt></dt> 452b15cb3dSCy Schubert <dd>Force <tt>ntpq</tt> to operate in interactive mode. Prompts will be written to the standard output and commands read from the standard input.</dd> 462b15cb3dSCy Schubert <dt><tt>-n</tt></dt> 472b15cb3dSCy Schubert <dd>Output all host addresses in dotted-quad numeric format rather than converting to the canonical host names.</dd> 482b15cb3dSCy Schubert <dt><tt>-p</tt></dt> 492b15cb3dSCy Schubert <dd>Print a list of the peers known to the server as well as a summary of their state. This is equivalent to the <tt>peers</tt> interactive command.</dd> 509c2daa00SOllivier Robert</dl> 519c2daa00SOllivier Robert<h4>Internal Commands</h4> 522b15cb3dSCy Schubert<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 <tt>></tt>, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the <tt>ntpq</tt> program itself and do not result in NTP mode-6 requests being sent to a server. These are described following.</p> 539c2daa00SOllivier Robert<dl> 542b15cb3dSCy Schubert <dt id="help"><tt>? [<i>command_keyword</i>]</tt><br> 552b15cb3dSCy Schubert <tt>help [<i>command_keyword</i>]</tt></dt> 562b15cb3dSCy Schubert <dd>A <tt>?</tt> by itself will print a list of all the command keywords known to <tt>ntpq</tt>. A <tt>?</tt> followed by a command keyword will print function and usage information about the command.</dd> 572b15cb3dSCy Schubert <dt id="addvars"><tt>addvars <i>name</i> [ = <i>value</i>] [...]</tt><br> 582b15cb3dSCy Schubert <tt>rmvars <i>name</i> [...]</tt><br> 592b15cb3dSCy Schubert <tt>clearvars</tt></dt> 602b15cb3dSCy Schubert <dd>The arguments to this command consist of a list of items of the form <tt><i>name</i> = <i>value</i></tt>, where the <tt>= <i>value</i></tt> is ignored, and can be omitted in read requests. <tt>ntpq</tt> maintains an internal list in which data to be included in control messages can be assembled, and sent using the <tt>readlist</tt> and <tt>writelist</tt> commands described below. The <tt>addvars</tt> command allows variables and optional values to be added to the list. If more than one variable is to be added, the list should be comma-separated and not contain white space. The <tt>rmvars</tt> command can be used to remove individual variables from the list, while the <tt>clearlist</tt> command removes all variables from the list.</dd> 612b15cb3dSCy Schubert <dt id="cooked"><tt>cooked</tt></dt> 622b15cb3dSCy Schubert <dd>Display server messages in prettyprint format.</dd> 632b15cb3dSCy Schubert <dt id="debug"><tt>debug more | less | off</tt></dt> 642b15cb3dSCy Schubert <dd>Turns internal query program debugging on and off.</dd> 652b15cb3dSCy Schubert <dt id="delay"><tt>delay <i>milliseconds</i></tt></dt> 662b15cb3dSCy Schubert <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.</dd> 672b15cb3dSCy Schubert <dt id="host"><tt>host <i>name</i></tt></dt> 682b15cb3dSCy Schubert <dd>Set the host to which future queries will be sent. The name may be either a DNS name or a numeric address.</dd> 692b15cb3dSCy Schubert <dt id="hostnames"><tt>hostnames [yes | no]</tt></dt> 702b15cb3dSCy Schubert <dd>If <tt>yes</tt> is specified, host names are printed in information displays. If <tt>no</tt> is specified, numeric addresses are printed instead. The default is <tt>yes</tt>, unless modified using the command line <tt>-n</tt> switch.</dd> 712b15cb3dSCy Schubert <dt id="keyid"><tt>keyid <i>keyid</i></tt></dt> 722b15cb3dSCy Schubert <dd>This command specifies the key number to be used to authenticate configuration requests. This must correspond to a key ID configured in <tt>ntp.conf</tt> for this purpose.</dd> 732b15cb3dSCy Schubert <dt id="keytype"><tt>keytype</tt></dt> 7409100258SXin LI <dd>Specify the digest algorithm to use for authenticated requests, with default <tt>MD5</tt>. If the OpenSSL library is installed, digest can be be any message digest algorithm supported by the library. The current selections are: <tt>MD2</tt>, <tt>MD4</tt>, <tt>MD5</tt>, <tt>MDC2</tt>, <tt>RIPEMD160</tt>, <tt>SHA</tt>, <tt>SHA1</tt>, and <tt>AES128CMAC</tt>.</dd> 752b15cb3dSCy Schubert <dt id="ntpversion"><tt>ntpversion 1 | 2 | 3 | 4</tt></dt> 762b15cb3dSCy Schubert <dd>Sets the NTP version number which <tt>ntpq</tt> claims in packets. Defaults to 2, Note that mode-6 control messages (and modes, for that matter) didn't exist in NTP version 1.</dd> 772b15cb3dSCy Schubert <dt id="passwd"><tt>passwd</tt></dt> 78*a466cc55SCy Schubert <dd>This command prompts for a password to authenticate requests. The password must correspond to the key ID configured in <tt>ntp.conf</tt> for this purpose. 79*a466cc55SCy Schubert It follows the same rules as a password entry in the keys file of <tt>ntpd</tt>.</dd> 802b15cb3dSCy Schubert <dt id="quit"><tt>quit</tt></dt> 812b15cb3dSCy Schubert <dd>Exit <tt>ntpq</tt>.</dd> 822b15cb3dSCy Schubert <dt id="raw"><tt>raw</tt></dt> 832b15cb3dSCy Schubert <dd>Display server messages as received and without reformatting.</dd> 842b15cb3dSCy Schubert <dt id="timeout"><tt>timeout <i>millseconds</i></tt></dt> 852b15cb3dSCy Schubert <dd>Specify a timeout period for responses to server queries. The default is about 5000 milliseconds. Note that since <tt>ntpq</tt> retries each query once after a timeout, the total waiting time for a timeout will be twice the timeout value set.</dd> 869c2daa00SOllivier Robert</dl> 879c2daa00SOllivier Robert<h4>Control Message Commands</h4> 882b15cb3dSCy Schubert<p>Association IDs are used to identify system, peer and clock variables. 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. Most control commands send a single mode-6 message to the server and expect a single response message. The exceptions are the <tt>peers</tt> command, which sends a series of messages, and the <tt>mreadlist</tt> and <tt>mreadvar</tt> commands, which iterate over a range of associations.</p> 899c2daa00SOllivier Robert<dl> 902b15cb3dSCy Schubert <dt id="as"><tt>associations</tt></dt> 912b15cb3dSCy Schubert <dd>Display a list of mobilized associations in the form</dd> 922b15cb3dSCy Schubert <dd><tt>ind assid status conf reach auth condition last_event cnt</tt></dd> 939c2daa00SOllivier Robert <dd> 942b15cb3dSCy Schubert <table width="100%" border="1" cellspacing="2" cellpadding="2"> 952b15cb3dSCy Schubert <tr> 962b15cb3dSCy Schubert <td>Variable</td> 972b15cb3dSCy Schubert <td>Description</td> 982b15cb3dSCy Schubert </tr> 992b15cb3dSCy Schubert <tr> 1002b15cb3dSCy Schubert <td><tt>ind</tt></td> 1012b15cb3dSCy Schubert <td>index on this list</td> 1022b15cb3dSCy Schubert </tr> 1032b15cb3dSCy Schubert <tr> 1042b15cb3dSCy Schubert <td><tt>assid</tt></td> 1052b15cb3dSCy Schubert <td>association ID</td> 1062b15cb3dSCy Schubert </tr> 1072b15cb3dSCy Schubert <tr> 1082b15cb3dSCy Schubert <td><tt>status</tt></td> 1092b15cb3dSCy Schubert <td><a href="decode.html#peer">peer status word</a></td> 1102b15cb3dSCy Schubert </tr> 1112b15cb3dSCy Schubert <tr> 1122b15cb3dSCy Schubert <td><tt>conf</tt></td> 1132b15cb3dSCy Schubert <td><tt>yes</tt>: persistent, <tt>no</tt>: ephemeral</td> 1142b15cb3dSCy Schubert </tr> 1152b15cb3dSCy Schubert <tr> 1162b15cb3dSCy Schubert <td><tt>reach</tt></td> 1172b15cb3dSCy Schubert <td><tt>yes</tt>: reachable, <tt>no</tt>: unreachable</td> 1182b15cb3dSCy Schubert </tr> 1192b15cb3dSCy Schubert <tr> 1202b15cb3dSCy Schubert <td><tt>auth</tt></td> 1212b15cb3dSCy Schubert <td><tt>ok</tt>, <tt>yes</tt>, <tt>bad</tt> and <tt>none</tt></td> 1222b15cb3dSCy Schubert </tr> 1232b15cb3dSCy Schubert <tr> 1242b15cb3dSCy Schubert <td><tt>condition</tt></td> 1252b15cb3dSCy Schubert <td>selection status (see the <tt>select</tt> field of the <a href="decode.html#peer">peer status word</a>)</td> 1262b15cb3dSCy Schubert </tr> 1272b15cb3dSCy Schubert <tr> 1282b15cb3dSCy Schubert <td><tt>last_event</tt></td> 1292b15cb3dSCy Schubert <td>event report (see the <tt>event</tt> field of the <a href="decode.html#peer">peer status word</a>)</td> 1302b15cb3dSCy Schubert </tr> 1312b15cb3dSCy Schubert <tr> 1322b15cb3dSCy Schubert <td><tt>cnt</tt></td> 1332b15cb3dSCy Schubert <td>event count (see the <tt>count</tt> field of the <a href="decode.html#peer">peer status word</a>)</td> 1342b15cb3dSCy Schubert </tr> 1352b15cb3dSCy Schubert </table> 1362b15cb3dSCy Schubert </dd> 1372b15cb3dSCy Schubert <dt id="cv"><tt>clockvar <i>assocID</i> [<i>name</i> [ = <i>value</i> [...]] [...]</tt><br> 1382b15cb3dSCy Schubert <tt>cv <i>assocID</i> [<i>name</i> [ = <i>value</i> [...] ][...]</tt></dt> 1392b15cb3dSCy Schubert <dd>Display a list of <a href="#clock">clock variables</a> for those associations supporting a reference clock.</dd> 1402b15cb3dSCy Schubert <dt id=":config"><tt>:config [...]</tt></dt> 1412b15cb3dSCy Schubert <dd>Send the remainder of the command line, including whitespace, to the server as a run-time configuration command in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is of course required.</dd> 1422b15cb3dSCy Schubert <dt id="config-from-file"><tt>config-from-file <i>filename</i></tt></dt> 1432b15cb3dSCy Schubert <dd>Send the each line of <i>filename</i> to the server as run-time configuration commands in the same format as the configuration file. This command is experimental until further notice and clarification. Authentication is required.</dd> 1442b15cb3dSCy Schubert <dt id="ifstats"><tt>ifstats</tt></dt> 1452b15cb3dSCy Schubert <dd>Display statistics for each local network address. Authentication is required.</dd> 1462b15cb3dSCy Schubert <dt id="iostats"><tt>iostats</tt></dt> 1472b15cb3dSCy Schubert <dd>Display network and reference clock I/O statistics.</dd> 1482b15cb3dSCy Schubert <dt id="kerninfo"><tt>kerninfo</tt></dt> 1492b15cb3dSCy Schubert <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.</dd> 1502b15cb3dSCy Schubert <dt id="lassoc"><tt>lassociations</tt></dt> 1512b15cb3dSCy Schubert <dd>Perform the same function as the associations command, except display mobilized and unmobilized associations.</dd> 1522b15cb3dSCy Schubert <dt id="monstats"><tt>monstats</tt></dt> 1532b15cb3dSCy Schubert <dd>Display monitor facility statistics.</dd> 1542b15cb3dSCy Schubert <dt id="mrulist"><tt>mrulist [limited | kod | mincount=<i>count</i> | laddr=<i>localaddr</i> | sort=<i>sortorder</i> | resany=<i>hexmask</i> | resall=<i>hexmask</i>]</tt></dt> 1552b15cb3dSCy Schubert <dd>Obtain and print traffic counts collected and maintained by the monitor facility. With the exception of <tt>sort=<i>sortorder</i></tt>, the options filter the list returned by <tt>ntpd</tt>. The <tt>limited</tt> and <tt>kod</tt> options return only entries representing client addresses from which the last packet received triggered either discarding or a KoD response. The <tt>mincount=<i>count</i></tt> option filters entries representing less than <tt><i>count</i></tt> packets. The <tt>laddr=<i>localaddr</i></tt> option filters entries for packets received on any local address other than <tt><i>localaddr</i></tt>. <tt>resany=<i>hexmask</i></tt> and <tt>resall=<i>hexmask</i></tt> filter entries containing none or less than all, respectively, of the bits in <tt><i>hexmask</i></tt>, which must begin with <tt>0x</tt>.</dd> 1562b15cb3dSCy Schubert <dd>The <tt><i>sortorder</i></tt> defaults to <tt>lstint</tt> and may be any of <tt>addr</tt>, <tt>count</tt>, <tt>avgint</tt>, <tt>lstint</tt>, or any of those preceded by a minus sign (hyphen) to reverse the sort order. The output columns are: 1572b15cb3dSCy Schubert <table width="100%" border="1" cellspacing="2" cellpadding="2"> 1582b15cb3dSCy Schubert <tr> 1592b15cb3dSCy Schubert <td>Column</td> 1602b15cb3dSCy Schubert <td>Description</td> 1612b15cb3dSCy Schubert </tr> 1622b15cb3dSCy Schubert <tr> 1632b15cb3dSCy Schubert <td><tt>lstint</tt></td> 1642b15cb3dSCy Schubert <td>Interval in s between the receipt of the most recent packet from this address and the completion of the 1652b15cb3dSCy Schubert retrieval of the MRU list by <tt>ntpq</tt>.</td> 1662b15cb3dSCy Schubert </tr> 1672b15cb3dSCy Schubert <tr> 1682b15cb3dSCy Schubert <td><tt>avgint</tt></td> 1692b15cb3dSCy Schubert <td>Average interval in s between packets from this address.</td> 1702b15cb3dSCy Schubert </tr> 1712b15cb3dSCy Schubert <tr> 1722b15cb3dSCy Schubert <td><tt>rstr</tt></td> 1732b15cb3dSCy Schubert <td>Restriction flags associated with this address. Most are copied unchanged from the matching <tt>restrict</tt> command, however 0x400 (kod) and 0x20 (limited) flags are cleared unless the last packet from this 1742b15cb3dSCy Schubert address triggered a rate control response.</td> 1752b15cb3dSCy Schubert </tr> 1762b15cb3dSCy Schubert <tr> 1772b15cb3dSCy Schubert <td><tt>r</tt></td> 1782b15cb3dSCy Schubert <td>Rate control indicator, either a period, <tt>L</tt> or <tt>K</tt> for no rate control response, 1792b15cb3dSCy Schubert rate limiting by discarding, or rate limiting with a KoD response, respectively.</td> 1802b15cb3dSCy Schubert </tr> 1812b15cb3dSCy Schubert <tr> 1822b15cb3dSCy Schubert <td><tt>m</tt></td> 1832b15cb3dSCy Schubert <td>Packet mode.</td> 1842b15cb3dSCy Schubert </tr> 1852b15cb3dSCy Schubert <tr> 1862b15cb3dSCy Schubert <td><tt>v</tt></td> 1872b15cb3dSCy Schubert <td>Packet version number.</td> 1882b15cb3dSCy Schubert </tr> 1892b15cb3dSCy Schubert <tr> 1902b15cb3dSCy Schubert <td><tt>count</tt></td> 1912b15cb3dSCy Schubert <td>Packets received from this address.</td> 1922b15cb3dSCy Schubert </tr> 1932b15cb3dSCy Schubert <tr> 1942b15cb3dSCy Schubert <td><tt>rport</tt></td> 1952b15cb3dSCy Schubert <td>Source port of last packet from this address.</td> 1962b15cb3dSCy Schubert </tr> 1972b15cb3dSCy Schubert <tr> 1982b15cb3dSCy Schubert <td><tt>remote address</tt></td> 1992b15cb3dSCy Schubert <td>DNS name, numeric address, or address followed by claimed DNS name which 2002b15cb3dSCy Schubert could not be verified in parentheses.</td> 2012b15cb3dSCy Schubert </tr> 2022b15cb3dSCy Schubert </table> 2032b15cb3dSCy Schubert </dd> 2042b15cb3dSCy Schubert <dt id="mreadvar"><tt>mreadvar <i>assocID</i> <i>assocID</i> [ <i>variable_name</i> [ = <i>value</i>[ ... ]</tt></dt> 2052b15cb3dSCy Schubert <dt id="mrv"><tt>mrv <i>assocID</i> <i>assocID</i> [ <i>variable_name</i> [ = <i>value</i>[ ... ]</tt></dt> 2062b15cb3dSCy Schubert <dd>Perform the same function as the <tt>readvar</tt> command, except for a range of association IDs. This range is determined from the association list cached by the most recent <tt>associations</tt> command.</dd> 2072b15cb3dSCy Schubert <dt id="passoc"><tt>passociations</tt></dt> 2082b15cb3dSCy Schubert <dd>Perform the same function as the <tt>associations command</tt>, except that it uses previously stored data rather than making a new query.</dd> 2092b15cb3dSCy Schubert <dt id="pe"><tt>peers</tt></dt> 2102b15cb3dSCy Schubert <dd>Display a list of peers in the form</dd> 2112b15cb3dSCy Schubert <dd><tt>[tally]remote refid st t when pool reach delay offset jitter</tt></dd> 2129c2daa00SOllivier Robert <dd> 2132b15cb3dSCy Schubert <table width="100%" border="1" cellspacing="2" cellpadding="2"> 2142b15cb3dSCy Schubert <tr> 2152b15cb3dSCy Schubert <td>Variable</td> 2162b15cb3dSCy Schubert <td>Description</td> 2172b15cb3dSCy Schubert </tr> 2182b15cb3dSCy Schubert <tr> 2192b15cb3dSCy Schubert <td><tt>[tally]</tt></td> 2202b15cb3dSCy Schubert <td>single-character code indicating current value of the <tt>select</tt> field of the <a href="decode.html#peer">peer status word</a></td> 2212b15cb3dSCy Schubert </tr> 2222b15cb3dSCy Schubert <tr> 2232b15cb3dSCy Schubert <td><tt>remote</tt></td> 2242b15cb3dSCy Schubert <td>host name (or IP number) of peer</td> 2252b15cb3dSCy Schubert </tr> 2262b15cb3dSCy Schubert <tr> 2272b15cb3dSCy Schubert <td><tt>refid</tt></td> 2282b15cb3dSCy Schubert <td>association ID or <a href="decode.html#kiss">kiss code</a></td> 2292b15cb3dSCy Schubert </tr> 2302b15cb3dSCy Schubert <tr> 2312b15cb3dSCy Schubert <td><tt>st</tt></td> 2322b15cb3dSCy Schubert <td>stratum</td> 2332b15cb3dSCy Schubert </tr> 2342b15cb3dSCy Schubert <tr> 2352b15cb3dSCy Schubert <td><tt>t</tt></td> 23609100258SXin LI <td> 23709100258SXin LI <tt>u</tt>: unicast or manycast client, 23809100258SXin LI <tt>b</tt>: broadcast or multicast client, 23909100258SXin LI <tt>p</tt>: pool source, 24009100258SXin LI <tt>l</tt>: local (reference clock), 24109100258SXin LI <tt>s</tt>: symmetric (peer), 24209100258SXin LI <tt>A</tt>: manycast server, 24309100258SXin LI <tt>B</tt>: broadcast server, 24409100258SXin LI <tt>M</tt>: multicast server 24509100258SXin LI </td> 2462b15cb3dSCy Schubert </tr> 2472b15cb3dSCy Schubert <tr> 2482b15cb3dSCy Schubert <td><tt>when</tt></td> 2492b15cb3dSCy Schubert <td>sec/min/hr since last received packet</td> 2502b15cb3dSCy Schubert </tr> 2512b15cb3dSCy Schubert <tr> 2522b15cb3dSCy Schubert <td><tt>poll</tt></td> 2532b15cb3dSCy Schubert <td>poll interval (log<sub>2</sub> s)</td> 2542b15cb3dSCy Schubert </tr> 2552b15cb3dSCy Schubert <tr> 2562b15cb3dSCy Schubert <td><tt>reach</tt></td> 2572b15cb3dSCy Schubert <td>reach shift register (octal)</td> 2582b15cb3dSCy Schubert </tr> 2592b15cb3dSCy Schubert <tr> 2602b15cb3dSCy Schubert <td><tt>delay</tt></td> 2612b15cb3dSCy Schubert <td>roundtrip delay</td> 2622b15cb3dSCy Schubert </tr> 2632b15cb3dSCy Schubert <tr> 2642b15cb3dSCy Schubert <td><tt>offset</tt></td> 2652b15cb3dSCy Schubert <td>offset of server relative to this host</td> 2662b15cb3dSCy Schubert </tr> 2672b15cb3dSCy Schubert <tr> 2682b15cb3dSCy Schubert <td><tt>jitter</tt></td> 2692b15cb3dSCy Schubert <td>jitter</td> 2702b15cb3dSCy Schubert </tr> 2712b15cb3dSCy Schubert </table> 2722b15cb3dSCy Schubert </dd> 2732b15cb3dSCy Schubert <dt id="rv"><tt>readvar <i>assocID</i> <i>name</i> [ = <i>value</i> ] [,...]</tt><br> 2742b15cb3dSCy Schubert <tt>rv <i>assocID</i> [ <i>name</i> ] [,...]</tt></dt> 2752b15cb3dSCy Schubert <dd>Display the specified variables. If <tt><i>assocID</i></tt> is zero, the 2762b15cb3dSCy Schubert variables are from the <a href="#system">system variables</a> name space, 2772b15cb3dSCy Schubert otherwise they are from the <a href="#peer">peer variables</a> name space. 2782b15cb3dSCy Schubert The <tt><i>assocID</i></tt> is required, as the same name can occur in both spaces. If no <tt><i>name</i></tt> is 2792b15cb3dSCy Schubert included, all operative variables in the name space are displayed. 2802b15cb3dSCy Schubert In this case only, if the <tt><i>assocID</i></tt> is omitted, it is assumed zero. Multiple 2812b15cb3dSCy Schubert names are specified with comma separators and without whitespace. 2822b15cb3dSCy Schubert Note that time values are represented in milliseconds and frequency 2832b15cb3dSCy Schubert values in parts-per-million (PPM). Some NTP timestamps are represented 2842b15cb3dSCy Schubert in the format YYYYMMDDTTTT, where YYYY is the year, MM the month 2852b15cb3dSCy Schubert of year, DD the day of month and TTTT the time of day.</dd> 2862b15cb3dSCy Schubert <dt id="saveconfig"><tt>saveconfig <i>filename</i></tt></dt> 2872b15cb3dSCy Schubert <dd>Write the current configuration, including any runtime modifications given with <tt>:config</tt> or <tt>config-from-file</tt>, to the ntpd host's file <i>filename</i>. This command will be rejected by the server unless <a href="miscopt.html#saveconfigdir">saveconfigdir</a> appears in the <tt>ntpd</tt> configuration file. <i>filename</i> can use strftime() format specifies to substitute the current date and time, for example, <tt>saveconfig ntp-%Y%m%d-%H%M%S.conf</tt>. The filename used is stored in system variable <tt>savedconfig</tt>. Authentication is required.</dd> 2882b15cb3dSCy Schubert <dt id="writevar"><tt>writevar <i>assocID</i> <i>name</i> = <i>value</i> [,...]</tt></dt> 2892b15cb3dSCy Schubert <dd>Write the specified variables. If the <tt><i>assocID</i></tt> is zero, the variables are from the <a href="#system">system variables</a> name space, otherwise they are from the <a href="#peer">peer variables</a> name space. The <tt><i>assocID</i></tt> is required, as the same name can occur in both spaces.</dd> 2902b15cb3dSCy Schubert <dt id="sysinfo"><tt>sysinfo</tt></dt> 2912b15cb3dSCy Schubert <dd>Display operational summary.</dd> 2922b15cb3dSCy Schubert <dt id="sysstats"><tt>sysstats</tt></dt> 2932b15cb3dSCy Schubert <dd>Print statistics counters maintained in the protocol module.</dd> 2942b15cb3dSCy Schubert</dl> 2952b15cb3dSCy Schubert<h4 id="status">Status Words and Kiss Codes</h4> 2962b15cb3dSCy Schubert<p>The current state of the operating program is shown in a set of status words maintained by the system and each association separately. These words are displayed in the <tt>rv</tt> and <tt>as</tt> commands both in hexadecimal and decoded short tip strings. The codes, tips and short explanations are on the <a href="decode.html">Event Messages and Status Words</a> page. The page also includes a list of system and peer messages, the code for the latest of which is included in the status word.</p> 2972b15cb3dSCy Schubert<p>Information resulting from protocol machine state transitions is displayed using an informal set of ASCII strings called <a href="decode.html#kiss">kiss codes</a>. The original purpose was for kiss-o'-death (KoD) packets sent by the server to advise the client of an unusual condition. They are now displayed, when appropriate, in the reference identifier field in various billboards.</p> 2982b15cb3dSCy Schubert<h4 id="system">System Variables</h4> 2992b15cb3dSCy Schubert<p>The following system variables appear in the <tt>rv</tt> billboard. Not all variables are displayed in some configurations.</p> 3002b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 3012b15cb3dSCy Schubert <tr> 3022b15cb3dSCy Schubert <td>Variable</td> 3032b15cb3dSCy Schubert <td>Description</td> 3042b15cb3dSCy Schubert </tr> 3052b15cb3dSCy Schubert <tr> 3062b15cb3dSCy Schubert <td><tt>status</tt></td> 3072b15cb3dSCy Schubert <td><a href="decode.html#sys">system status word</a></td> 3082b15cb3dSCy Schubert </tr> 3092b15cb3dSCy Schubert <tr> 3102b15cb3dSCy Schubert <td><tt>version</tt></td> 3112b15cb3dSCy Schubert <td>NTP software version and build time</td> 3122b15cb3dSCy Schubert </tr> 3132b15cb3dSCy Schubert <tr> 3142b15cb3dSCy Schubert <td><tt>processor</tt></td> 3152b15cb3dSCy Schubert <td>hardware platform and version</td> 3162b15cb3dSCy Schubert </tr> 3172b15cb3dSCy Schubert <tr> 3182b15cb3dSCy Schubert <td><tt>system</tt></td> 3192b15cb3dSCy Schubert <td>operating system and version</td> 3202b15cb3dSCy Schubert </tr> 3212b15cb3dSCy Schubert <tr> 3222b15cb3dSCy Schubert <td><tt>leap</tt></td> 3232b15cb3dSCy Schubert <td>leap warning indicator (0-3)</td> 3242b15cb3dSCy Schubert </tr> 3252b15cb3dSCy Schubert <tr> 3262b15cb3dSCy Schubert <td><tt>stratum</tt></td> 3272b15cb3dSCy Schubert <td>stratum (1-15)</td> 3282b15cb3dSCy Schubert </tr> 3292b15cb3dSCy Schubert <tr> 3302b15cb3dSCy Schubert <td><tt>precision</tt></td> 3312b15cb3dSCy Schubert <td>precision (log<sub>2</sub> s)</td> 3322b15cb3dSCy Schubert </tr> 3332b15cb3dSCy Schubert <tr> 3342b15cb3dSCy Schubert <td><tt>rootdelay</tt></td> 3352b15cb3dSCy Schubert <td>total roundtrip delay to the primary reference clock</td> 3362b15cb3dSCy Schubert </tr> 3372b15cb3dSCy Schubert <tr> 3382b15cb3dSCy Schubert <td><tt>rootdisp</tt></td> 3392b15cb3dSCy Schubert <td>total dispersion to the primary reference clock</td> 3402b15cb3dSCy Schubert </tr> 3412b15cb3dSCy Schubert <tr> 3422b15cb3dSCy Schubert <td><tt>peer</tt></td> 3432b15cb3dSCy Schubert <td>system peer association ID</td> 3442b15cb3dSCy Schubert </tr> 3452b15cb3dSCy Schubert <tr> 3462b15cb3dSCy Schubert <td><tt>tc</tt></td> 3472b15cb3dSCy Schubert <td>time constant and poll exponent (log<sub>2</sub> s) (3-17)</td> 3482b15cb3dSCy Schubert </tr> 3492b15cb3dSCy Schubert <tr> 3502b15cb3dSCy Schubert <td><tt>mintc</tt></td> 3512b15cb3dSCy Schubert <td>minimum time constant (log<sub>2</sub> s) (3-10)</td> 3522b15cb3dSCy Schubert </tr> 3532b15cb3dSCy Schubert <tr> 3542b15cb3dSCy Schubert <td><tt>clock</tt></td> 3552b15cb3dSCy Schubert <td>date and time of day</td> 3562b15cb3dSCy Schubert </tr> 3572b15cb3dSCy Schubert <tr> 3582b15cb3dSCy Schubert <td><tt>refid</tt></td> 3592b15cb3dSCy Schubert <td>reference ID or <a href="decode.html#kiss">kiss code</a></td> 3602b15cb3dSCy Schubert </tr> 3612b15cb3dSCy Schubert <tr> 3622b15cb3dSCy Schubert <td><tt>reftime</tt></td> 3632b15cb3dSCy Schubert <td>reference time</td> 3642b15cb3dSCy Schubert </tr> 3652b15cb3dSCy Schubert <tr> 3662b15cb3dSCy Schubert <td><tt>offset</tt></td> 3672b15cb3dSCy Schubert <td>combined offset of server relative to this host</td> 3682b15cb3dSCy Schubert </tr> 3692b15cb3dSCy Schubert <tr> 3702b15cb3dSCy Schubert <td><tt>sys_jitter</tt></td> 3712b15cb3dSCy Schubert <td>combined system jitter</td> 3722b15cb3dSCy Schubert </tr> 3732b15cb3dSCy Schubert <tr> 3742b15cb3dSCy Schubert <td><tt>frequency</tt></td> 3752b15cb3dSCy Schubert <td> frequency offset (PPM) relative to hardware clock</td> 3762b15cb3dSCy Schubert </tr> 3772b15cb3dSCy Schubert <tr> 3782b15cb3dSCy Schubert <td><tt>clk_wander</tt></td> 3792b15cb3dSCy Schubert <td>clock frequency wander (PPM)</td> 3802b15cb3dSCy Schubert </tr> 3812b15cb3dSCy Schubert <tr> 3822b15cb3dSCy Schubert <td><tt>clk_jitter</tt></td> 3832b15cb3dSCy Schubert <td>clock jitter</td> 3842b15cb3dSCy Schubert </tr> 3852b15cb3dSCy Schubert <tr> 3862b15cb3dSCy Schubert <td><tt>tai</tt></td> 3872b15cb3dSCy Schubert <td>TAI-UTC offset (s)</td> 3882b15cb3dSCy Schubert </tr> 3892b15cb3dSCy Schubert <tr> 3902b15cb3dSCy Schubert <td><tt>leapsec</tt></td> 3912b15cb3dSCy Schubert <td>NTP seconds when the next leap second is/was inserted</td> 3922b15cb3dSCy Schubert </tr> 3932b15cb3dSCy Schubert <tr> 3942b15cb3dSCy Schubert <td><tt>expire</tt></td> 3952b15cb3dSCy Schubert <td>NTP seconds when the NIST leapseconds file expires</td> 3962b15cb3dSCy Schubert </tr> 3972b15cb3dSCy Schubert</table> 3989c2daa00SOllivier Robert<dl> 3992b15cb3dSCy Schubert <dt>The jitter and wander statistics are exponentially-weighted RMS averages. 4002b15cb3dSCy Schubert The system jitter is defined in the NTPv4 specification; the 4012b15cb3dSCy Schubert clock jitter statistic is computed by the clock discipline module.</dt> 4022b15cb3dSCy Schubert <dt>When the NTPv4 daemon is compiled with the OpenSSL software library, additional 4032b15cb3dSCy Schubert system variables are displayed, including some or all of the following, depending 4042b15cb3dSCy Schubert on the particular Autokey dance:</dt> 4059c2daa00SOllivier Robert</dl> 4062b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 4072b15cb3dSCy Schubert <tr> 4082b15cb3dSCy Schubert <td>Variable</td> 4092b15cb3dSCy Schubert <td>Description</td> 4102b15cb3dSCy Schubert </tr> 4112b15cb3dSCy Schubert <tr> 4122b15cb3dSCy Schubert <td><tt>host</tt></td> 4132b15cb3dSCy Schubert <td>Autokey host name for this host</td> 4142b15cb3dSCy Schubert </tr> 4152b15cb3dSCy Schubert <tr> 4162b15cb3dSCy Schubert <td><tt>ident</tt></td> 4172b15cb3dSCy Schubert <td>Autokey group name for this host</td> 4182b15cb3dSCy Schubert </tr> 4192b15cb3dSCy Schubert <tr> 4202b15cb3dSCy Schubert <td><tt>flags</tt></td> 4212b15cb3dSCy Schubert <td>host flags (see Autokey specification)</td> 4222b15cb3dSCy Schubert </tr> 4232b15cb3dSCy Schubert <tr> 4242b15cb3dSCy Schubert <td><tt>digest</tt></td> 4252b15cb3dSCy Schubert <td>OpenSSL message digest algorithm</td> 4262b15cb3dSCy Schubert </tr> 4272b15cb3dSCy Schubert <tr> 4282b15cb3dSCy Schubert <td><tt>signature</tt></td> 4292b15cb3dSCy Schubert <td>OpenSSL digest/signature scheme</td> 4302b15cb3dSCy Schubert </tr> 4312b15cb3dSCy Schubert <tr> 4322b15cb3dSCy Schubert <td><tt>update</tt></td> 4332b15cb3dSCy Schubert <td>NTP seconds at last signature update</td> 4342b15cb3dSCy Schubert </tr> 4352b15cb3dSCy Schubert <tr> 4362b15cb3dSCy Schubert <td><tt>cert</tt></td> 4372b15cb3dSCy Schubert <td>certificate subject, issuer and certificate flags</td> 4382b15cb3dSCy Schubert </tr> 4392b15cb3dSCy Schubert <tr> 4402b15cb3dSCy Schubert <td><tt>until</tt></td> 4412b15cb3dSCy Schubert <td>NTP seconds when the certificate expires</td> 4422b15cb3dSCy Schubert </tr> 4432b15cb3dSCy Schubert</table> 4442b15cb3dSCy Schubert<h4 id="peer">Peer Variables</h4> 4452b15cb3dSCy Schubert<p>The following peer variables appear in the <tt>rv</tt> billboard for each association. Not all variables are displayed in some configurations.</p> 4462b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 4472b15cb3dSCy Schubert <tr> 4482b15cb3dSCy Schubert <td>Variable</td> 4492b15cb3dSCy Schubert <td>Description</td> 4502b15cb3dSCy Schubert </tr> 4512b15cb3dSCy Schubert <tr> 4522b15cb3dSCy Schubert <td><tt>associd</tt></td> 4532b15cb3dSCy Schubert <td>association ID</td> 4542b15cb3dSCy Schubert </tr> 4552b15cb3dSCy Schubert <tr> 4562b15cb3dSCy Schubert <td><tt>status</tt></td> 4572b15cb3dSCy Schubert <td><a href="decode.html#peer">peer status word</a></td> 4582b15cb3dSCy Schubert </tr> 4592b15cb3dSCy Schubert <tr> 4602b15cb3dSCy Schubert <td><tt>srcadr<br> 4612b15cb3dSCy Schubert srcport</tt></td> 4622b15cb3dSCy Schubert <td>source (remote) IP address and port</td> 4632b15cb3dSCy Schubert </tr> 4642b15cb3dSCy Schubert <tr> 4652b15cb3dSCy Schubert <td><tt>dstadr<br> 4662b15cb3dSCy Schubert dstport</tt></td> 4672b15cb3dSCy Schubert <td>destination (local) IP address and port</td> 4682b15cb3dSCy Schubert </tr> 4692b15cb3dSCy Schubert <tr> 4702b15cb3dSCy Schubert <td><tt>leap</tt></td> 4712b15cb3dSCy Schubert <td>leap indicator (0-3)</td> 4722b15cb3dSCy Schubert </tr> 4732b15cb3dSCy Schubert <tr> 4742b15cb3dSCy Schubert <td><tt>stratum</tt></td> 4752b15cb3dSCy Schubert <td>stratum (0-15)</td> 4762b15cb3dSCy Schubert </tr> 4772b15cb3dSCy Schubert <tr> 4782b15cb3dSCy Schubert <td><tt>precision</tt></td> 4792b15cb3dSCy Schubert <td>precision (log<sub>2</sub> s)</td> 4802b15cb3dSCy Schubert </tr> 4812b15cb3dSCy Schubert <tr> 4822b15cb3dSCy Schubert <td><tt>rootdelay</tt></td> 4832b15cb3dSCy Schubert <td>total roundtrip delay to the primary reference clock</td> 4842b15cb3dSCy Schubert </tr> 4852b15cb3dSCy Schubert <tr> 4862b15cb3dSCy Schubert <td><tt>rootdisp</tt></td> 4872b15cb3dSCy Schubert <td>total root dispersion to the primary reference clock</td> 4882b15cb3dSCy Schubert </tr> 4892b15cb3dSCy Schubert <tr> 4902b15cb3dSCy Schubert <td><tt>refid</tt></td> 4912b15cb3dSCy Schubert <td>reference ID or <a href="decode.html#kiss">kiss code</a></td> 4922b15cb3dSCy Schubert </tr> 4932b15cb3dSCy Schubert <tr> 4942b15cb3dSCy Schubert <td><tt>reftime</tt></td> 4952b15cb3dSCy Schubert <td>reference time</td> 4962b15cb3dSCy Schubert </tr> 4972b15cb3dSCy Schubert <tr> 4982b15cb3dSCy Schubert <td><tt>reach</tt></td> 4992b15cb3dSCy Schubert <td>reach register (octal)</td> 5002b15cb3dSCy Schubert </tr> 5012b15cb3dSCy Schubert <tr> 5022b15cb3dSCy Schubert <td><tt>unreach</tt></td> 5032b15cb3dSCy Schubert <td>unreach counter</td> 5042b15cb3dSCy Schubert </tr> 5052b15cb3dSCy Schubert <tr> 5062b15cb3dSCy Schubert <td><tt>hmode</tt></td> 5072b15cb3dSCy Schubert <td>host mode (1-6)</td> 5082b15cb3dSCy Schubert </tr> 5092b15cb3dSCy Schubert <tr> 5102b15cb3dSCy Schubert <td><tt>pmode</tt></td> 5112b15cb3dSCy Schubert <td>peer mode (1-5)</td> 5122b15cb3dSCy Schubert </tr> 5132b15cb3dSCy Schubert <tr> 5142b15cb3dSCy Schubert <td><tt>hpoll</tt></td> 5152b15cb3dSCy Schubert <td>host poll exponent (log<sub>2</sub> s) (3-17)</td> 5162b15cb3dSCy Schubert </tr> 5172b15cb3dSCy Schubert <tr> 5182b15cb3dSCy Schubert <td><tt>ppoll</tt></td> 5192b15cb3dSCy Schubert <td>peer poll exponent (log<sub>2</sub> s) (3-17)</td> 5202b15cb3dSCy Schubert </tr> 5212b15cb3dSCy Schubert <tr> 5222b15cb3dSCy Schubert <td><tt>headway</tt></td> 5232b15cb3dSCy Schubert <td>headway (see <a href="rate.html">Rate Management and the Kiss-o'-Death Packet)</a></td> 5242b15cb3dSCy Schubert </tr> 5252b15cb3dSCy Schubert <tr> 5262b15cb3dSCy Schubert <td><tt>flash</tt></td> 5272b15cb3dSCy Schubert <td><a href="decode.html#flash">flash status word</a></td> 5282b15cb3dSCy Schubert </tr> 5292b15cb3dSCy Schubert <tr> 5302b15cb3dSCy Schubert <td><tt>offset</tt></td> 5312b15cb3dSCy Schubert <td>filter offset</td> 5322b15cb3dSCy Schubert </tr> 5332b15cb3dSCy Schubert <tr> 5342b15cb3dSCy Schubert <td><tt>delay</tt></td> 5352b15cb3dSCy Schubert <td>filter delay</td> 5362b15cb3dSCy Schubert </tr> 5372b15cb3dSCy Schubert <tr> 5382b15cb3dSCy Schubert <td><tt>dispersion</tt></td> 5392b15cb3dSCy Schubert <td>filter dispersion</td> 5402b15cb3dSCy Schubert </tr> 5412b15cb3dSCy Schubert <tr> 5422b15cb3dSCy Schubert <td><tt>jitter</tt></td> 5432b15cb3dSCy Schubert <td>filter jitter</td> 5442b15cb3dSCy Schubert </tr> 5452b15cb3dSCy Schubert <tr> 5462b15cb3dSCy Schubert <td><tt>ident</tt></td> 5472b15cb3dSCy Schubert <td>Autokey group name for this association</td> 5482b15cb3dSCy Schubert </tr> 5492b15cb3dSCy Schubert <tr> 5502b15cb3dSCy Schubert <td><tt>bias</tt></td> 5512b15cb3dSCy Schubert <td>unicast/broadcast bias</td> 5522b15cb3dSCy Schubert </tr> 5532b15cb3dSCy Schubert <tr> 5542b15cb3dSCy Schubert <td><tt>xleave</tt></td> 5552b15cb3dSCy Schubert <td>interleave delay (see <a href="xleave.html">NTP Interleaved Modes</a>)</td> 5562b15cb3dSCy Schubert </tr> 5572b15cb3dSCy Schubert</table> 5582b15cb3dSCy Schubert<p>The bias variable is calculated when the first broadcast packet is received 5592b15cb3dSCy Schubert after the calibration volley. It represents the offset of the broadcast 5602b15cb3dSCy Schubert subgraph relative to the unicast subgraph. The xleave variable appears 5612b15cb3dSCy Schubert only the interleaved symmetric and interleaved modes. It represents 5622b15cb3dSCy Schubert the internal queuing, buffering and transmission delays for the preceding 5632b15cb3dSCy Schubert packet.</p> 5649c2daa00SOllivier Robert<p>When the NTPv4 daemon is compiled with the OpenSSL software library, additional peer variables are displayed, including the following:</p> 5652b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 5662b15cb3dSCy Schubert <tr> 5672b15cb3dSCy Schubert <td>Variable</td> 5682b15cb3dSCy Schubert <td>Description</td> 5692b15cb3dSCy Schubert </tr> 5702b15cb3dSCy Schubert <tr> 5712b15cb3dSCy Schubert <td><tt>flags</tt></td> 5722b15cb3dSCy Schubert <td>peer flags (see Autokey specification)</td> 5732b15cb3dSCy Schubert </tr> 5742b15cb3dSCy Schubert <tr> 5752b15cb3dSCy Schubert <td><tt>host</tt></td> 5762b15cb3dSCy Schubert <td>Autokey server name</td> 5772b15cb3dSCy Schubert </tr> 5782b15cb3dSCy Schubert <tr> 5792b15cb3dSCy Schubert <td><tt>flags</tt></td> 5802b15cb3dSCy Schubert <td>peer flags (see Autokey specification)</td> 5812b15cb3dSCy Schubert </tr> 5822b15cb3dSCy Schubert <tr> 5832b15cb3dSCy Schubert <td><tt>signature</tt></td> 5842b15cb3dSCy Schubert <td>OpenSSL digest/signature scheme</td> 5852b15cb3dSCy Schubert </tr> 5862b15cb3dSCy Schubert <tr> 5872b15cb3dSCy Schubert <td><tt>initsequence</tt></td> 5882b15cb3dSCy Schubert <td>initial key ID</td> 5892b15cb3dSCy Schubert </tr> 5902b15cb3dSCy Schubert <tr> 5912b15cb3dSCy Schubert <td><tt>initkey</tt></td> 5922b15cb3dSCy Schubert <td>initial key index</td> 5932b15cb3dSCy Schubert </tr> 5942b15cb3dSCy Schubert <tr> 5952b15cb3dSCy Schubert <td><tt>timestamp</tt></td> 5962b15cb3dSCy Schubert <td>Autokey signature timestamp</td> 5972b15cb3dSCy Schubert </tr> 5982b15cb3dSCy Schubert</table> 5992b15cb3dSCy Schubert<h4 id="clock">Clock Variables</h4> 6002b15cb3dSCy Schubert<p>The following clock variables appear in the <tt>cv</tt> billboard for each association with a reference clock. Not all variables are displayed in some configurations.</p> 6012b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 6022b15cb3dSCy Schubert <tr> 6032b15cb3dSCy Schubert <td>Variable</td> 6042b15cb3dSCy Schubert <td>Description</td> 6052b15cb3dSCy Schubert </tr> 6062b15cb3dSCy Schubert <tr> 6072b15cb3dSCy Schubert <td><tt>associd</tt></td> 6082b15cb3dSCy Schubert <td>association ID</td> 6092b15cb3dSCy Schubert </tr> 6102b15cb3dSCy Schubert <tr> 6112b15cb3dSCy Schubert <td><tt>status</tt></td> 6122b15cb3dSCy Schubert <td><a href="decode.html#clock">clock status word</a></td> 6132b15cb3dSCy Schubert </tr> 6142b15cb3dSCy Schubert <tr> 6152b15cb3dSCy Schubert <td><tt>device</tt></td> 6162b15cb3dSCy Schubert <td>device description</td> 6172b15cb3dSCy Schubert </tr> 6182b15cb3dSCy Schubert <tr> 6192b15cb3dSCy Schubert <td><tt>timecode</tt></td> 6202b15cb3dSCy Schubert <td>ASCII time code string (specific to device)</td> 6212b15cb3dSCy Schubert </tr> 6222b15cb3dSCy Schubert <tr> 6232b15cb3dSCy Schubert <td><tt>poll</tt></td> 6242b15cb3dSCy Schubert <td>poll messages sent</td> 6252b15cb3dSCy Schubert </tr> 6262b15cb3dSCy Schubert <tr> 6272b15cb3dSCy Schubert <td><tt>noreply</tt></td> 6282b15cb3dSCy Schubert <td>no reply</td> 6292b15cb3dSCy Schubert </tr> 6302b15cb3dSCy Schubert <tr> 6312b15cb3dSCy Schubert <td><tt>badformat</tt></td> 6322b15cb3dSCy Schubert <td>bad format</td> 6332b15cb3dSCy Schubert </tr> 6342b15cb3dSCy Schubert <tr> 6352b15cb3dSCy Schubert <td><tt>baddata</tt></td> 6362b15cb3dSCy Schubert <td>bad date or time</td> 6372b15cb3dSCy Schubert </tr> 6382b15cb3dSCy Schubert <tr> 6392b15cb3dSCy Schubert <td><tt>fudgetime1</tt></td> 6402b15cb3dSCy Schubert <td>fudge time 1</td> 6412b15cb3dSCy Schubert </tr> 6422b15cb3dSCy Schubert <tr> 6432b15cb3dSCy Schubert <td><tt>fudgetime2</tt></td> 6442b15cb3dSCy Schubert <td>fudge time 2</td> 6452b15cb3dSCy Schubert </tr> 6462b15cb3dSCy Schubert <tr> 6472b15cb3dSCy Schubert <td><tt>stratum</tt></td> 6482b15cb3dSCy Schubert <td>driver stratum</td> 6492b15cb3dSCy Schubert </tr> 6502b15cb3dSCy Schubert <tr> 6512b15cb3dSCy Schubert <td><tt>refid</tt></td> 6522b15cb3dSCy Schubert <td>driver reference ID</td> 6532b15cb3dSCy Schubert </tr> 6542b15cb3dSCy Schubert <tr> 6552b15cb3dSCy Schubert <td><tt>flags</tt></td> 6562b15cb3dSCy Schubert <td>driver flags</td> 6572b15cb3dSCy Schubert </tr> 6582b15cb3dSCy Schubert</table> 6599c2daa00SOllivier Robert<hr> 6609c2daa00SOllivier Robert<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> 6619c2daa00SOllivier Robert</body> 6629c2daa00SOllivier Robert</html> 663
