12b15cb3dSCy Schubert<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> 22b15cb3dSCy Schubert<html> 32b15cb3dSCy Schubert<head> 42b15cb3dSCy Schubert<meta http-equiv="content-type" content="text/html;charset=iso-8859-1"> 52b15cb3dSCy Schubert<meta name="generator" content="HTML Tidy, see www.w3.org"> 62b15cb3dSCy Schubert<title>Event Messages and Status Words</title> 72b15cb3dSCy Schubert<link href="scripts/style.css" type="text/css" rel="stylesheet"> 82b15cb3dSCy Schubert</head> 92b15cb3dSCy Schubert<body> 102b15cb3dSCy Schubert<h3>Event Messages and Status Words</h3> 112b15cb3dSCy Schubert<img src="pic/alice47.gif" alt="gif" align="left"><a href="http://www.eecis.udel.edu/%7emills/pictures.html">from <i>Alice's Adventures in Wonderland</i>, Lewis Carroll</a> 122b15cb3dSCy Schubert<p>Caterpillar knows all the error codes, which is more than most of us do.</p> 132b15cb3dSCy Schubert<p>Last update: 14*9034852cSGleb Smirnoff <!-- #BeginDate format:En2m -->26-Jul-2015 06:26<!-- #EndDate --> 152b15cb3dSCy Schubert UTC</p> 162b15cb3dSCy Schubert</p> 172b15cb3dSCy Schubert<br clear="left"> 182b15cb3dSCy Schubert<h4>Related Links</h4> 192b15cb3dSCy Schubert<p> 202b15cb3dSCy Schubert <script type="text/javascript" language="javascript" src="scripts/install.txt"></script> 212b15cb3dSCy Schubert</p> 222b15cb3dSCy Schubert<h4>Table of Contents</h4> 232b15cb3dSCy Schubert<ul> 242b15cb3dSCy Schubert <li class="inline"><a href="#intro">Introduction</a></li> 252b15cb3dSCy Schubert <li class="inline"><a href="#sys">System Status Word</a></li> 262b15cb3dSCy Schubert <li class="inline"><a href="#peer">Peer Status Word</a></li> 272b15cb3dSCy Schubert <li class="inline"><a href="#clock">Clock Status Word</a></li> 282b15cb3dSCy Schubert <li class="inline"><a href="#flash">Flash Status Word</a></li> 292b15cb3dSCy Schubert <li class="inline"><a href="#kiss">Kiss Codes</a></li> 302b15cb3dSCy Schubert <li class="inline"><a href="#crypto">Crypto Messages</a></li> 312b15cb3dSCy Schubert</ul> 322b15cb3dSCy Schubert<hr> 332b15cb3dSCy Schubert<h4 id="intro">Introduction</h4> 342b15cb3dSCy Schubert<p>This page lists the status words, event messages and error codes used for <tt>ntpd</tt> reporting and monitoring. Status words are used to display the current status of the running program. There is one system status word and a peer status word for each association. There is a clock status word for each association that supports a reference clock. There is a flash code for each association which shows errors found in the last packet received (pkt) and during protocol processing (peer). These are commonly viewed using the <tt>ntpq</tt> program.</p> 352b15cb3dSCy Schubert<p>Significant changes in program state are reported as events. There is one 362b15cb3dSCy Schubert set of system events and a set of peer events for each association. In addition, 372b15cb3dSCy Schubert there is a set of clock events for each association that supports a reference 382b15cb3dSCy Schubert clock. Events are normally reported to the <tt>protostats</tt> monitoring file 392b15cb3dSCy Schubert and optionally to the system log. In addition, if the trap facility is configured, 402b15cb3dSCy Schubert events can be reported to a remote program that can page an administrator.</p> 412b15cb3dSCy Schubert<p>This page also includes a description of the error messages produced by the Autokey protocol. These messages are normally sent to the <tt>cryptostats</tt> monitoring file.</p> 422b15cb3dSCy Schubert<p>In the following tables the Event Field is the status or event code assigned and the Message Field a short string used for display and event reporting. The Description field contains a longer explanation of the status or event. Some messages include additional information useful for error diagnosis and performance assessment.</p> 432b15cb3dSCy Schubert<h4 id="sys">System Status Word</h4> 442b15cb3dSCy Schubert<p>The system status word consists of four fields LI (0-1), Source (2-7), Count (8-11) and Event (12-15). It is reported in the first line of the <tt>rv</tt> display produced by the <tt>ntpq</tt> program.</p> 452b15cb3dSCy Schubert<table width="50%" border="1" cellspacing="2" cellpadding="2"> 462b15cb3dSCy Schubert <tr> 472b15cb3dSCy Schubert <td><div align="center">Leap</div></td> 482b15cb3dSCy Schubert <td><div align="center">Source</div></td> 492b15cb3dSCy Schubert <td><div align="center">Count</div></td> 502b15cb3dSCy Schubert <td><div align="center">Event</div></td> 512b15cb3dSCy Schubert </tr> 522b15cb3dSCy Schubert</table> 532b15cb3dSCy Schubert<p>The Leap Field displays the system leap indicator bits coded as follows:</p> 542b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 552b15cb3dSCy Schubert <tr> 562b15cb3dSCy Schubert <td>Code</td> 572b15cb3dSCy Schubert <td>Message</td> 582b15cb3dSCy Schubert <td>Description</td> 592b15cb3dSCy Schubert </tr> 602b15cb3dSCy Schubert <tr> 612b15cb3dSCy Schubert <td><tt>0</tt></td> 622b15cb3dSCy Schubert <td><tt>leap_none</tt></td> 632b15cb3dSCy Schubert <td>normal synchronized state</td> 642b15cb3dSCy Schubert </tr> 652b15cb3dSCy Schubert <tr> 662b15cb3dSCy Schubert <td><tt>1</tt></td> 672b15cb3dSCy Schubert <td><tt>leap_add_sec</tt></td> 682b15cb3dSCy Schubert <td>insert second after 23:59:59 of the current day</td> 692b15cb3dSCy Schubert </tr> 702b15cb3dSCy Schubert <tr> 712b15cb3dSCy Schubert <td><tt>2</tt></td> 722b15cb3dSCy Schubert <td><tt>leap_del_sec</tt></td> 732b15cb3dSCy Schubert <td>delete second 23:59:59 of the current day</td> 742b15cb3dSCy Schubert </tr> 752b15cb3dSCy Schubert <tr> 762b15cb3dSCy Schubert <td><tt>3</tt></td> 772b15cb3dSCy Schubert <td><tt>leap_alarm</tt></td> 782b15cb3dSCy Schubert <td>never synchronized</td> 792b15cb3dSCy Schubert </tr> 802b15cb3dSCy Schubert</table> 812b15cb3dSCy Schubert<p>The Source Field displays the current synchronization source coded as follows:</p> 822b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 832b15cb3dSCy Schubert <tr> 842b15cb3dSCy Schubert <td>Code</td> 852b15cb3dSCy Schubert <td>Message</td> 862b15cb3dSCy Schubert <td>Description</td> 872b15cb3dSCy Schubert </tr> 882b15cb3dSCy Schubert <tr> 892b15cb3dSCy Schubert <td><tt>0</tt></td> 902b15cb3dSCy Schubert <td><tt>sync_unspec</tt></td> 912b15cb3dSCy Schubert <td>not yet synchronized</td> 922b15cb3dSCy Schubert </tr> 932b15cb3dSCy Schubert <tr> 942b15cb3dSCy Schubert <td><tt>1</tt></td> 952b15cb3dSCy Schubert <td><tt>sync_pps</tt></td> 962b15cb3dSCy Schubert <td>pulse-per-second signal (Cs, Ru, GPS, etc.)</td> 972b15cb3dSCy Schubert </tr> 982b15cb3dSCy Schubert <tr> 992b15cb3dSCy Schubert <td><tt>2</tt></td> 1002b15cb3dSCy Schubert <td><tt>sync_lf_radio</tt></td> 1012b15cb3dSCy Schubert <td>VLF/LF radio (WWVB, DCF77, etc.)</td> 1022b15cb3dSCy Schubert </tr> 1032b15cb3dSCy Schubert <tr> 1042b15cb3dSCy Schubert <td><tt>3</tt></td> 1052b15cb3dSCy Schubert <td><tt>sync_hf_radio</tt></td> 1062b15cb3dSCy Schubert <td>MF/HF radio (WWV, etc.)</td> 1072b15cb3dSCy Schubert </tr> 1082b15cb3dSCy Schubert <tr> 1092b15cb3dSCy Schubert <td><tt>4</tt></td> 1102b15cb3dSCy Schubert <td><tt>sync_uhf_radio</tt></td> 1112b15cb3dSCy Schubert <td>VHF/UHF radio/satellite (GPS, Galileo, etc.)</td> 1122b15cb3dSCy Schubert </tr> 1132b15cb3dSCy Schubert <tr> 1142b15cb3dSCy Schubert <td><tt>5</tt></td> 1152b15cb3dSCy Schubert <td><tt>sync_local</tt></td> 1162b15cb3dSCy Schubert <td>local timecode (IRIG, LOCAL driver, etc.)</td> 1172b15cb3dSCy Schubert </tr> 1182b15cb3dSCy Schubert <tr> 1192b15cb3dSCy Schubert <td><tt>6</tt></td> 1202b15cb3dSCy Schubert <td><tt>sync_ntp</tt></td> 1212b15cb3dSCy Schubert <td>NTP</td> 1222b15cb3dSCy Schubert </tr> 1232b15cb3dSCy Schubert <tr> 1242b15cb3dSCy Schubert <td><tt>7</tt></td> 1252b15cb3dSCy Schubert <td><tt>sync_other</tt></td> 1262b15cb3dSCy Schubert <td>other (IEEE 1588, openntp, crony, etc.)</td> 1272b15cb3dSCy Schubert </tr> 1282b15cb3dSCy Schubert <tr> 1292b15cb3dSCy Schubert <td><tt>8</tt></td> 1302b15cb3dSCy Schubert <td><tt>sync_wristwatch</tt></td> 1312b15cb3dSCy Schubert <td>eyeball and wristwatch</td> 1322b15cb3dSCy Schubert </tr> 1332b15cb3dSCy Schubert <tr> 1342b15cb3dSCy Schubert <td><tt>9</tt></td> 1352b15cb3dSCy Schubert <td><tt>sync_telephone</tt></td> 1362b15cb3dSCy Schubert <td>telephone modem (ACTS, PTB, etc.)</td> 1372b15cb3dSCy Schubert </tr> 1382b15cb3dSCy Schubert</table> 1392b15cb3dSCy Schubert<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored.</p> 1402b15cb3dSCy Schubert<p>The Event Field displays the most recent event message coded as follows:</p> 1412b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 1422b15cb3dSCy Schubert <tr> 1432b15cb3dSCy Schubert <td>Code</td> 1442b15cb3dSCy Schubert <td>Message</td> 1452b15cb3dSCy Schubert <td>Description</td> 1462b15cb3dSCy Schubert </tr> 1472b15cb3dSCy Schubert <tr> 1482b15cb3dSCy Schubert <td><tt>00</tt></td> 1492b15cb3dSCy Schubert <td><tt>unspecified</tt></td> 1502b15cb3dSCy Schubert <td>unspecified</td> 1512b15cb3dSCy Schubert </tr> 1522b15cb3dSCy Schubert <tr> 1532b15cb3dSCy Schubert <td><tt>01</tt></td> 1542b15cb3dSCy Schubert <td><tt>freq_not_set</tt></td> 1552b15cb3dSCy Schubert <td>frequency file not available</td> 1562b15cb3dSCy Schubert </tr> 1572b15cb3dSCy Schubert <tr> 1582b15cb3dSCy Schubert <td><tt>02</tt></td> 1592b15cb3dSCy Schubert <td><tt>freq_set</tt></td> 1602b15cb3dSCy Schubert <td>frequency set from frequency file</td> 1612b15cb3dSCy Schubert </tr> 1622b15cb3dSCy Schubert <tr> 1632b15cb3dSCy Schubert <td><tt>03</tt></td> 1642b15cb3dSCy Schubert <td><tt>spike_detect</tt></td> 1652b15cb3dSCy Schubert <td>spike detected</td> 1662b15cb3dSCy Schubert </tr> 1672b15cb3dSCy Schubert <tr> 1682b15cb3dSCy Schubert <td><tt>04</tt></td> 1692b15cb3dSCy Schubert <td><tt>freq_mode</tt></td> 1702b15cb3dSCy Schubert <td>initial frequency training mode</td> 1712b15cb3dSCy Schubert </tr> 1722b15cb3dSCy Schubert <tr> 1732b15cb3dSCy Schubert <td><tt>05</tt></td> 1742b15cb3dSCy Schubert <td><tt>clock_sync</tt></td> 1752b15cb3dSCy Schubert <td>clock synchronized</td> 1762b15cb3dSCy Schubert </tr> 1772b15cb3dSCy Schubert <tr> 1782b15cb3dSCy Schubert <td><tt>06</tt></td> 1792b15cb3dSCy Schubert <td><tt>restart</tt></td> 1802b15cb3dSCy Schubert <td>program restart</td> 1812b15cb3dSCy Schubert </tr> 1822b15cb3dSCy Schubert <tr> 1832b15cb3dSCy Schubert <td><tt>07</tt></td> 1842b15cb3dSCy Schubert <td><tt>panic_stop</tt></td> 1852b15cb3dSCy Schubert <td>clock error more than 600 s</td> 1862b15cb3dSCy Schubert </tr> 1872b15cb3dSCy Schubert <tr> 1882b15cb3dSCy Schubert <td><tt>08</tt></td> 1892b15cb3dSCy Schubert <td><tt>no_system_peer</tt></td> 1902b15cb3dSCy Schubert <td>no system peer</td> 1912b15cb3dSCy Schubert </tr> 1922b15cb3dSCy Schubert <tr> 1932b15cb3dSCy Schubert <td><tt>09</tt></td> 1942b15cb3dSCy Schubert <td><tt>leap_armed</tt></td> 1952b15cb3dSCy Schubert <td>leap second armed from file or Autokey</td> 1962b15cb3dSCy Schubert </tr> 1972b15cb3dSCy Schubert <tr> 1982b15cb3dSCy Schubert <td><tt>0a</tt></td> 1992b15cb3dSCy Schubert <td><tt>leap_disarmed</tt></td> 2002b15cb3dSCy Schubert <td>leap second disarmed</td> 2012b15cb3dSCy Schubert </tr> 2022b15cb3dSCy Schubert <tr> 2032b15cb3dSCy Schubert <td><tt>0b</tt></td> 2042b15cb3dSCy Schubert <td><tt>leap_event</tt></td> 2052b15cb3dSCy Schubert <td>leap event</td> 2062b15cb3dSCy Schubert </tr> 2072b15cb3dSCy Schubert <tr> 2082b15cb3dSCy Schubert <td><tt>0c</tt></td> 2092b15cb3dSCy Schubert <td><tt>clock_step</tt></td> 2102b15cb3dSCy Schubert <td>clock stepped</td> 2112b15cb3dSCy Schubert </tr> 2122b15cb3dSCy Schubert <tr> 2132b15cb3dSCy Schubert <td><tt>0d</tt></td> 2142b15cb3dSCy Schubert <td><tt>kern</tt></td> 2152b15cb3dSCy Schubert <td>kernel information message</td> 2162b15cb3dSCy Schubert </tr> 2172b15cb3dSCy Schubert <tr> 2182b15cb3dSCy Schubert <td><tt>0e</tt></td> 2192b15cb3dSCy Schubert <td><tt>TAI...</tt></td> 2202b15cb3dSCy Schubert <td>leapsecond values update from file</td> 2212b15cb3dSCy Schubert </tr> 2222b15cb3dSCy Schubert <tr> 2232b15cb3dSCy Schubert <td><tt>0f</tt></td> 2242b15cb3dSCy Schubert <td><tt>stale leapsecond values</tt></td> 2252b15cb3dSCy Schubert <td>new NIST leapseconds file needed</td> 2262b15cb3dSCy Schubert </tr> 2272b15cb3dSCy Schubert</table> 2282b15cb3dSCy Schubert<h4 id="peer">Peer Status Word</h4> 2292b15cb3dSCy Schubert<p>The peer status word consists of four fields: Status (0-4), Select (5-7), Count (8-11) and Code (12-15). It is reported in the first line of the <tt>rv <i>associd</i></tt> display produced by the <tt>ntpq</tt> program.</p> 2302b15cb3dSCy Schubert<table width="50%" border="1" cellspacing="2" cellpadding="2"> 2312b15cb3dSCy Schubert <tr> 2322b15cb3dSCy Schubert <td><div align="center">Status</div></td> 2332b15cb3dSCy Schubert <td><div align="center">Select</div></td> 2342b15cb3dSCy Schubert <td><div align="center">Count</div></td> 2352b15cb3dSCy Schubert <td><div align="center">Code</div></td> 2362b15cb3dSCy Schubert </tr> 2372b15cb3dSCy Schubert</table> 2382b15cb3dSCy Schubert<p>The Status Field displays the peer status code bits in hexadecimal; each bit is an independent flag. (Note this field is 5 bits wide, and combines with the the 3-bit-wide Select Field to create the first full byte of the peer status word.) The meaning of each bit in the Status Field is listed in the following table:</p> 2392b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 2402b15cb3dSCy Schubert <tr> 2412b15cb3dSCy Schubert <td>Code</td> 2422b15cb3dSCy Schubert <td>Message</td> 2432b15cb3dSCy Schubert <td>Description</td> 2442b15cb3dSCy Schubert </tr> 2452b15cb3dSCy Schubert <tr> 2462b15cb3dSCy Schubert <td><tt>08</tt></td> 2472b15cb3dSCy Schubert <td><tt>bcst</tt></td> 2482b15cb3dSCy Schubert <td>broadcast association</td> 2492b15cb3dSCy Schubert </tr> 2502b15cb3dSCy Schubert <tr> 2512b15cb3dSCy Schubert <td><tt>10</tt></td> 2522b15cb3dSCy Schubert <td><tt>reach</tt></td> 2532b15cb3dSCy Schubert <td>host reachable</td> 2542b15cb3dSCy Schubert </tr> 2552b15cb3dSCy Schubert <tr> 2562b15cb3dSCy Schubert <td><tt>20</tt></td> 2572b15cb3dSCy Schubert <td><tt>auth</tt></td> 2582b15cb3dSCy Schubert <td>authentication ok</td> 2592b15cb3dSCy Schubert </tr> 2602b15cb3dSCy Schubert <tr> 2612b15cb3dSCy Schubert <td><tt>40</tt></td> 2622b15cb3dSCy Schubert <td><tt>authenb</tt></td> 2632b15cb3dSCy Schubert <td>authentication enabled</td> 2642b15cb3dSCy Schubert </tr> 2652b15cb3dSCy Schubert <tr> 2662b15cb3dSCy Schubert <td><tt>80</tt></td> 2672b15cb3dSCy Schubert <td><tt>config</tt></td> 2682b15cb3dSCy Schubert <td>persistent association</td> 2692b15cb3dSCy Schubert </tr> 2702b15cb3dSCy Schubert</table> 2712b15cb3dSCy Schubert<p>The Select Field displays the current selection status. (The T Field in the following table gives the corresponding tally codes used in the <tt>ntpq peers</tt> display.) The values are coded as follows:</p> 2722b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 2732b15cb3dSCy Schubert <tr> 2742b15cb3dSCy Schubert <td>Code</td> 2752b15cb3dSCy Schubert <td>Message</td> 2762b15cb3dSCy Schubert <td>T</td> 2772b15cb3dSCy Schubert <td>Description</td> 2782b15cb3dSCy Schubert </tr> 2792b15cb3dSCy Schubert <tr> 2802b15cb3dSCy Schubert <td><tt>0</tt></td> 2812b15cb3dSCy Schubert <td><tt>sel_reject</tt></td> 2822b15cb3dSCy Schubert <td> </td> 2832b15cb3dSCy Schubert <td>discarded as not valid (TEST10-TEST13)</td> 2842b15cb3dSCy Schubert </tr> 2852b15cb3dSCy Schubert <tr> 2862b15cb3dSCy Schubert <td><tt>1</tt></td> 2872b15cb3dSCy Schubert <td><tt>sel_falsetick</tt></td> 2882b15cb3dSCy Schubert <td><tt>x</tt></td> 2892b15cb3dSCy Schubert <td>discarded by intersection algorithm</td> 2902b15cb3dSCy Schubert </tr> 2912b15cb3dSCy Schubert <tr> 2922b15cb3dSCy Schubert <td><tt>2</tt></td> 2932b15cb3dSCy Schubert <td><tt>sel_excess</tt></td> 2942b15cb3dSCy Schubert <td><tt>.</tt></td> 2952b15cb3dSCy Schubert <td>discarded by table overflow (not used)</td> 2962b15cb3dSCy Schubert </tr> 2972b15cb3dSCy Schubert <tr> 2982b15cb3dSCy Schubert <td><tt>3</tt></td> 299*9034852cSGleb Smirnoff <td><tt>sel_outlier</tt></td> 3002b15cb3dSCy Schubert <td><tt>-</tt></td> 3012b15cb3dSCy Schubert <td>discarded by the cluster algorithm</td> 3022b15cb3dSCy Schubert </tr> 3032b15cb3dSCy Schubert <tr> 3042b15cb3dSCy Schubert <td><tt>4</tt></td> 3052b15cb3dSCy Schubert <td><tt>sel_candidate</tt></td> 3062b15cb3dSCy Schubert <td><tt>+</tt></td> 3072b15cb3dSCy Schubert <td>included by the combine algorithm</td> 3082b15cb3dSCy Schubert </tr> 3092b15cb3dSCy Schubert <tr> 3102b15cb3dSCy Schubert <td><tt>5</tt></td> 3112b15cb3dSCy Schubert <td><tt>sel_backup</tt></td> 3122b15cb3dSCy Schubert <td><tt>#</tt></td> 3132b15cb3dSCy Schubert <td>backup (more than <tt>tos maxclock</tt> sources)</td> 3142b15cb3dSCy Schubert </tr> 3152b15cb3dSCy Schubert <tr> 3162b15cb3dSCy Schubert <td><tt>6</tt></td> 3172b15cb3dSCy Schubert <td><tt>sel_sys.peer</tt></td> 3182b15cb3dSCy Schubert <td><tt>*</tt></td> 3192b15cb3dSCy Schubert <td>system peer</td> 3202b15cb3dSCy Schubert </tr> 3212b15cb3dSCy Schubert <tr> 3222b15cb3dSCy Schubert <td><tt>7</tt></td> 3232b15cb3dSCy Schubert <td><tt>sel_pps.peer</tt></td> 3242b15cb3dSCy Schubert <td><tt>o</tt></td> 3252b15cb3dSCy Schubert <td>PPS peer (when the prefer peer is valid)</td> 3262b15cb3dSCy Schubert </tr> 3272b15cb3dSCy Schubert</table> 3282b15cb3dSCy Schubert<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored. </p> 3292b15cb3dSCy Schubert<p>The Event Field displays the most recent event message coded as follows:</p> 3302b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 3312b15cb3dSCy Schubert <tr> 3322b15cb3dSCy Schubert <td>Code</td> 3332b15cb3dSCy Schubert <td>Message</td> 3342b15cb3dSCy Schubert <td>Description</td> 3352b15cb3dSCy Schubert </tr> 3362b15cb3dSCy Schubert <tr> 3372b15cb3dSCy Schubert <td><tt>01</tt></td> 3382b15cb3dSCy Schubert <td><tt>mobilize</tt></td> 3392b15cb3dSCy Schubert <td>association mobilized</td> 3402b15cb3dSCy Schubert </tr> 3412b15cb3dSCy Schubert <tr> 3422b15cb3dSCy Schubert <td><tt>02</tt></td> 3432b15cb3dSCy Schubert <td><tt>demobilize</tt></td> 3442b15cb3dSCy Schubert <td>association demobilized</td> 3452b15cb3dSCy Schubert </tr> 3462b15cb3dSCy Schubert <tr> 3472b15cb3dSCy Schubert <td><tt>03</tt></td> 3482b15cb3dSCy Schubert <td><tt>unreachable</tt></td> 3492b15cb3dSCy Schubert <td>server unreachable</td> 3502b15cb3dSCy Schubert </tr> 3512b15cb3dSCy Schubert <tr> 3522b15cb3dSCy Schubert <td><tt>04</tt></td> 3532b15cb3dSCy Schubert <td><tt>reachable</tt></td> 3542b15cb3dSCy Schubert <td>server reachable</td> 3552b15cb3dSCy Schubert </tr> 3562b15cb3dSCy Schubert <tr> 3572b15cb3dSCy Schubert <td><tt>05</tt></td> 3582b15cb3dSCy Schubert <td><tt>restart</tt></td> 3592b15cb3dSCy Schubert <td>association restart</td> 3602b15cb3dSCy Schubert </tr> 3612b15cb3dSCy Schubert <tr> 3622b15cb3dSCy Schubert <td><tt>06</tt></td> 3632b15cb3dSCy Schubert <td><tt>no_reply</tt></td> 3642b15cb3dSCy Schubert <td>no server found (<tt>ntpdate</tt> mode)</td> 3652b15cb3dSCy Schubert </tr> 3662b15cb3dSCy Schubert <tr> 3672b15cb3dSCy Schubert <td><tt>07</tt></td> 3682b15cb3dSCy Schubert <td><tt>rate_exceeded</tt></td> 3692b15cb3dSCy Schubert <td>rate exceeded (kiss code <tt>RATE</tt>)</td> 3702b15cb3dSCy Schubert </tr> 3712b15cb3dSCy Schubert <tr> 3722b15cb3dSCy Schubert <td><tt>08</tt></td> 3732b15cb3dSCy Schubert <td><tt>access_denied</tt></td> 3742b15cb3dSCy Schubert <td>access denied (kiss code <tt>DENY</tt>)</td> 3752b15cb3dSCy Schubert </tr> 3762b15cb3dSCy Schubert <tr> 3772b15cb3dSCy Schubert <td><tt>09</tt></td> 3782b15cb3dSCy Schubert <td><tt>leap_armed</tt></td> 3792b15cb3dSCy Schubert <td>leap armed from server LI code</td> 3802b15cb3dSCy Schubert </tr> 3812b15cb3dSCy Schubert <tr> 3822b15cb3dSCy Schubert <td><tt>0a</tt></td> 3832b15cb3dSCy Schubert <td><tt>sys_peer</tt></td> 3842b15cb3dSCy Schubert <td>become system peer</td> 3852b15cb3dSCy Schubert </tr> 3862b15cb3dSCy Schubert <tr> 3872b15cb3dSCy Schubert <td><tt>0b</tt></td> 3882b15cb3dSCy Schubert <td><tt>clock_event</tt></td> 3892b15cb3dSCy Schubert <td>see clock status word</td> 3902b15cb3dSCy Schubert </tr> 3912b15cb3dSCy Schubert <tr> 3922b15cb3dSCy Schubert <td><tt>0c</tt></td> 3932b15cb3dSCy Schubert <td><tt>bad_auth</tt></td> 3942b15cb3dSCy Schubert <td>authentication failure</td> 3952b15cb3dSCy Schubert </tr> 3962b15cb3dSCy Schubert <tr> 3972b15cb3dSCy Schubert <td><tt>0d</tt></td> 3982b15cb3dSCy Schubert <td><tt>popcorn</tt></td> 3992b15cb3dSCy Schubert <td>popcorn spike suppressor</td> 4002b15cb3dSCy Schubert </tr> 4012b15cb3dSCy Schubert <tr> 4022b15cb3dSCy Schubert <td><tt>0e</tt></td> 4032b15cb3dSCy Schubert <td><tt>interleave_mode</tt></td> 4042b15cb3dSCy Schubert <td>entering interleave mode</td> 4052b15cb3dSCy Schubert </tr> 4062b15cb3dSCy Schubert <tr> 4072b15cb3dSCy Schubert <td><tt>0f</tt></td> 4082b15cb3dSCy Schubert <td><tt>interleave_error</tt></td> 4092b15cb3dSCy Schubert <td>interleave error (recovered)</td> 4102b15cb3dSCy Schubert </tr> 4112b15cb3dSCy Schubert</table> 4122b15cb3dSCy Schubert<h4 id="clock">Clock Status Word</h4> 4132b15cb3dSCy Schubert<p>The clock status word consists of four fields: Unused (0-7), Count (8-11) and Code (12-15). It is reported in the first line of the <tt>clockvar <i>associd</i></tt> display produced by the <tt>ntpq</tt> program.</p> 4142b15cb3dSCy Schubert<table width="50%" border="1" cellspacing="2" cellpadding="2"> 4152b15cb3dSCy Schubert <tr> 4162b15cb3dSCy Schubert <td><div align="center">Unused</div></td> 4172b15cb3dSCy Schubert <td><div align="center">Count</div></td> 4182b15cb3dSCy Schubert <td><div align="center">Code</div></td> 4192b15cb3dSCy Schubert </tr> 4202b15cb3dSCy Schubert</table> 4212b15cb3dSCy Schubert<p>The Count Field displays the number of events since the last <tt>lockvar</tt> command, while the Event Field displays the most recent event message coded as follows:</p> 4222b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 4232b15cb3dSCy Schubert <tr> 4242b15cb3dSCy Schubert <td>Code</td> 4252b15cb3dSCy Schubert <td>Message</td> 4262b15cb3dSCy Schubert <td>Description</td> 4272b15cb3dSCy Schubert </tr> 4282b15cb3dSCy Schubert <tr> 4292b15cb3dSCy Schubert <td><tt>00</tt></td> 4302b15cb3dSCy Schubert <td><tt>clk_unspe</tt></td> 4312b15cb3dSCy Schubert <td>nominal</td> 4322b15cb3dSCy Schubert </tr> 4332b15cb3dSCy Schubert <tr> 4342b15cb3dSCy Schubert <td><tt>01</tt></td> 4352b15cb3dSCy Schubert <td><tt>clk_noreply</tt></td> 4362b15cb3dSCy Schubert <td>no reply to poll</td> 4372b15cb3dSCy Schubert </tr> 4382b15cb3dSCy Schubert <tr> 4392b15cb3dSCy Schubert <td><tt>02</tt></td> 4402b15cb3dSCy Schubert <td><tt>clk_badformat</tt></td> 4412b15cb3dSCy Schubert <td>bad timecode format</td> 4422b15cb3dSCy Schubert </tr> 4432b15cb3dSCy Schubert <tr> 4442b15cb3dSCy Schubert <td><tt>03</tt></td> 4452b15cb3dSCy Schubert <td><tt>clk_fault</tt></td> 4462b15cb3dSCy Schubert <td>hardware or software fault</td> 4472b15cb3dSCy Schubert </tr> 4482b15cb3dSCy Schubert <tr> 4492b15cb3dSCy Schubert <td><tt>04</tt></td> 4502b15cb3dSCy Schubert <td><tt>clk_bad_signal</tt></td> 4512b15cb3dSCy Schubert <td>signal loss</td> 4522b15cb3dSCy Schubert </tr> 4532b15cb3dSCy Schubert <tr> 4542b15cb3dSCy Schubert <td><tt>05</tt></td> 4552b15cb3dSCy Schubert <td><tt>clk_bad_date</tt></td> 4562b15cb3dSCy Schubert <td>bad date format</td> 4572b15cb3dSCy Schubert </tr> 4582b15cb3dSCy Schubert <tr> 4592b15cb3dSCy Schubert <td><tt>06</tt></td> 4602b15cb3dSCy Schubert <td><tt>clk_bad_time</tt></td> 4612b15cb3dSCy Schubert <td>bad time format</td> 4622b15cb3dSCy Schubert </tr> 4632b15cb3dSCy Schubert</table> 4642b15cb3dSCy Schubert<p>When the clock driver sets the code to a new value, a <tt>clock_alarm</tt> (11) peer event is reported.</p> 4652b15cb3dSCy Schubert<h4 id="flash">Flash Status Word</h4> 4662b15cb3dSCy Schubert<p>The flash status word is displayed by the <tt>ntpq</tt> program <tt>rv</tt> command. It consists of a number of bits coded in hexadecimal as follows:</p> 4672b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 4682b15cb3dSCy Schubert <tr> 4692b15cb3dSCy Schubert <td width="10%">Code</td> 4702b15cb3dSCy Schubert <td width="15%">Tag</td> 4712b15cb3dSCy Schubert <td width="20%">Message</td> 4722b15cb3dSCy Schubert <td width="55%">Description</td> 4732b15cb3dSCy Schubert </tr> 4742b15cb3dSCy Schubert <tr> 4752b15cb3dSCy Schubert <td><tt>0001</tt></td> 4762b15cb3dSCy Schubert <td>TEST1</td> 4772b15cb3dSCy Schubert <td><tt>pkt_dup</tt></td> 4782b15cb3dSCy Schubert <td>duplicate packet</td> 4792b15cb3dSCy Schubert </tr> 4802b15cb3dSCy Schubert <tr> 4812b15cb3dSCy Schubert <td><tt>0002</tt></td> 4822b15cb3dSCy Schubert <td>TEST2</td> 4832b15cb3dSCy Schubert <td><tt>pkt_bogus</tt></td> 4842b15cb3dSCy Schubert <td>bogus packet</td> 4852b15cb3dSCy Schubert </tr> 4862b15cb3dSCy Schubert <tr> 4872b15cb3dSCy Schubert <td><tt>0004</tt></td> 4882b15cb3dSCy Schubert <td>TEST3</td> 4892b15cb3dSCy Schubert <td><tt>pkt_unsync</tt></td> 4902b15cb3dSCy Schubert <td>server not synchronized</td> 4912b15cb3dSCy Schubert </tr> 4922b15cb3dSCy Schubert <tr> 4932b15cb3dSCy Schubert <td><tt>0008</tt></td> 4942b15cb3dSCy Schubert <td>TEST4</td> 4952b15cb3dSCy Schubert <td><tt>pkt_denied</tt></td> 4962b15cb3dSCy Schubert <td>access denied</td> 4972b15cb3dSCy Schubert </tr> 4982b15cb3dSCy Schubert <tr> 4992b15cb3dSCy Schubert <td><tt>0010</tt></td> 5002b15cb3dSCy Schubert <td>TEST5</td> 5012b15cb3dSCy Schubert <td><tt>pkt_auth</tt></td> 5022b15cb3dSCy Schubert <td> authentication failure</td> 5032b15cb3dSCy Schubert </tr> 5042b15cb3dSCy Schubert <tr> 5052b15cb3dSCy Schubert <td><tt>0020</tt></td> 5062b15cb3dSCy Schubert <td>TEST6</td> 5072b15cb3dSCy Schubert <td><tt>pkt_stratum</tt></td> 5082b15cb3dSCy Schubert <td>invalid leap or stratum</td> 5092b15cb3dSCy Schubert </tr> 5102b15cb3dSCy Schubert <tr> 5112b15cb3dSCy Schubert <td><tt>0040</tt></td> 5122b15cb3dSCy Schubert <td>TEST7</td> 5132b15cb3dSCy Schubert <td><tt>pkt_header</tt></td> 5142b15cb3dSCy Schubert <td> header distance exceeded</td> 5152b15cb3dSCy Schubert </tr> 5162b15cb3dSCy Schubert <tr> 5172b15cb3dSCy Schubert <td><tt>0080</tt></td> 5182b15cb3dSCy Schubert <td>TEST8</td> 5192b15cb3dSCy Schubert <td><tt>pkt_autokey</tt></td> 5202b15cb3dSCy Schubert <td>Autokey sequence error</td> 5212b15cb3dSCy Schubert </tr> 5222b15cb3dSCy Schubert <tr> 5232b15cb3dSCy Schubert <td><tt>0100</tt></td> 5242b15cb3dSCy Schubert <td>TEST9</td> 5252b15cb3dSCy Schubert <td><tt>pkt_crypto</tt></td> 5262b15cb3dSCy Schubert <td>Autokey protocol error</td> 5272b15cb3dSCy Schubert </tr> 5282b15cb3dSCy Schubert <tr> 5292b15cb3dSCy Schubert <td><tt>0200</tt></td> 5302b15cb3dSCy Schubert <td>TEST10</td> 5312b15cb3dSCy Schubert <td><tt>peer_stratum</tt></td> 5322b15cb3dSCy Schubert <td> invalid header or stratum</td> 5332b15cb3dSCy Schubert </tr> 5342b15cb3dSCy Schubert <tr> 5352b15cb3dSCy Schubert <td><tt>0400</tt></td> 5362b15cb3dSCy Schubert <td>TEST11</td> 5372b15cb3dSCy Schubert <td><tt>peer_dist</tt></td> 5382b15cb3dSCy Schubert <td> distance threshold exceeded</td> 5392b15cb3dSCy Schubert </tr> 5402b15cb3dSCy Schubert <tr> 5412b15cb3dSCy Schubert <td><tt>0800</tt></td> 5422b15cb3dSCy Schubert <td>TEST12</td> 5432b15cb3dSCy Schubert <td><tt>peer_loop</tt></td> 5442b15cb3dSCy Schubert <td> synchronization loop</td> 5452b15cb3dSCy Schubert </tr> 5462b15cb3dSCy Schubert <tr> 5472b15cb3dSCy Schubert <td><tt>1000</tt></td> 5482b15cb3dSCy Schubert <td>TEST13</td> 5492b15cb3dSCy Schubert <td><tt>peer_unreach</tt></td> 5502b15cb3dSCy Schubert <td> unreachable or nonselect</td> 5512b15cb3dSCy Schubert </tr> 5522b15cb3dSCy Schubert</table> 5532b15cb3dSCy Schubert<h4 id="kiss">Kiss Codes</h4> 5542b15cb3dSCy Schubert<p>Kiss codes are used in kiss-o'-death (KoD) packets, billboard displays and log messages. They consist of a string of four zero-padded ASCII charactes. In practice they are informal and tend to change with time and implementation. Some of these codes can appear in the reference identifier field in <tt>ntpq</tt> billboards. Following is the current list:</p> 5552b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 5562b15cb3dSCy Schubert <tr> 5572b15cb3dSCy Schubert <td>Code</td> 5582b15cb3dSCy Schubert <td>Description</td> 5592b15cb3dSCy Schubert </tr> 5602b15cb3dSCy Schubert <tr> 5612b15cb3dSCy Schubert <td><tt>ACST</tt></td> 5622b15cb3dSCy Schubert <td>manycast server</td> 5632b15cb3dSCy Schubert </tr> 5642b15cb3dSCy Schubert <tr> 5652b15cb3dSCy Schubert <td><tt>AUTH</tt></td> 5662b15cb3dSCy Schubert <td>authentication error</td> 5672b15cb3dSCy Schubert </tr> 5682b15cb3dSCy Schubert <tr> 5692b15cb3dSCy Schubert <td><tt>AUTO</tt></td> 5702b15cb3dSCy Schubert <td>Autokey sequence error</td> 5712b15cb3dSCy Schubert </tr> 5722b15cb3dSCy Schubert <tr> 5732b15cb3dSCy Schubert <td><tt>BCST</tt></td> 5742b15cb3dSCy Schubert <td>broadcast server</td> 5752b15cb3dSCy Schubert </tr> 5762b15cb3dSCy Schubert <tr> 5772b15cb3dSCy Schubert <td><tt>CRYPT</tt></td> 5782b15cb3dSCy Schubert <td>Autokey protocol error</td> 5792b15cb3dSCy Schubert </tr> 5802b15cb3dSCy Schubert <tr> 5812b15cb3dSCy Schubert <td><tt>DENY</tt></td> 5822b15cb3dSCy Schubert <td>access denied by server</td> 5832b15cb3dSCy Schubert </tr> 5842b15cb3dSCy Schubert <tr> 5852b15cb3dSCy Schubert <td><tt>INIT</tt></td> 5862b15cb3dSCy Schubert <td>association initialized</td> 5872b15cb3dSCy Schubert </tr> 5882b15cb3dSCy Schubert <tr> 5892b15cb3dSCy Schubert <td><tt>MCST</tt></td> 5902b15cb3dSCy Schubert <td>multicast server</td> 5912b15cb3dSCy Schubert </tr> 5922b15cb3dSCy Schubert <tr> 5932b15cb3dSCy Schubert <td><tt>RATE</tt></td> 5942b15cb3dSCy Schubert <td>rate exceeded</td> 5952b15cb3dSCy Schubert </tr> 5962b15cb3dSCy Schubert <tr> 5972b15cb3dSCy Schubert <td><tt>TIME</tt></td> 5982b15cb3dSCy Schubert <td>association timeout</td> 5992b15cb3dSCy Schubert </tr> 6002b15cb3dSCy Schubert <tr> 6012b15cb3dSCy Schubert <td><tt>STEP</tt></td> 6022b15cb3dSCy Schubert <td>step time change</td> 6032b15cb3dSCy Schubert </tr> 6042b15cb3dSCy Schubert</table> 6052b15cb3dSCy Schubert<h4 id="crypto">Crypto Messages</h4> 6062b15cb3dSCy Schubert<p>These messages are sent to the <tt>cryptostats</tt> file when an error is detected in the Autokey protocol.</p> 6072b15cb3dSCy Schubert<table width="100%" border="1" cellspacing="2" cellpadding="2"> 6082b15cb3dSCy Schubert <tr> 6092b15cb3dSCy Schubert <td>Code</td> 6102b15cb3dSCy Schubert <td>Message</td> 6112b15cb3dSCy Schubert <td>Description</td> 6122b15cb3dSCy Schubert </tr> 6132b15cb3dSCy Schubert <tr> 6142b15cb3dSCy Schubert <td><tt>01</tt></td> 6152b15cb3dSCy Schubert <td><tt>bad_format</tt></td> 6162b15cb3dSCy Schubert <td>bad extension field format or length</td> 6172b15cb3dSCy Schubert </tr> 6182b15cb3dSCy Schubert <tr> 6192b15cb3dSCy Schubert <td><tt>02</tt></td> 6202b15cb3dSCy Schubert <td><tt>bad_timestamp</tt></td> 6212b15cb3dSCy Schubert <td>bad timestamp</td> 6222b15cb3dSCy Schubert </tr> 6232b15cb3dSCy Schubert <tr> 6242b15cb3dSCy Schubert <td><tt>03</tt></td> 6252b15cb3dSCy Schubert <td><tt>bad_filestamp</tt></td> 6262b15cb3dSCy Schubert <td>bad filestamp</td> 6272b15cb3dSCy Schubert </tr> 6282b15cb3dSCy Schubert <tr> 6292b15cb3dSCy Schubert <td><tt>04</tt></td> 6302b15cb3dSCy Schubert <td><tt>bad_public_key</tt></td> 6312b15cb3dSCy Schubert <td>bad or missing public key</td> 6322b15cb3dSCy Schubert </tr> 6332b15cb3dSCy Schubert <tr> 6342b15cb3dSCy Schubert <td><tt>05</tt></td> 6352b15cb3dSCy Schubert <td><tt>bad_digest</tt></td> 6362b15cb3dSCy Schubert <td>unsupported digest type</td> 6372b15cb3dSCy Schubert </tr> 6382b15cb3dSCy Schubert <tr> 6392b15cb3dSCy Schubert <td><tt>06</tt></td> 6402b15cb3dSCy Schubert <td><tt>bad_identity</tt></td> 6412b15cb3dSCy Schubert <td>unsupported identity type</td> 6422b15cb3dSCy Schubert </tr> 6432b15cb3dSCy Schubert <tr> 6442b15cb3dSCy Schubert <td><tt>07</tt></td> 6452b15cb3dSCy Schubert <td><tt>bad_siglength</tt></td> 6462b15cb3dSCy Schubert <td>bad signature length</td> 6472b15cb3dSCy Schubert </tr> 6482b15cb3dSCy Schubert <tr> 6492b15cb3dSCy Schubert <td><tt>08</tt></td> 6502b15cb3dSCy Schubert <td><tt>bad signature</tt></td> 6512b15cb3dSCy Schubert <td>extension field signature not verified</td> 6522b15cb3dSCy Schubert </tr> 6532b15cb3dSCy Schubert <tr> 6542b15cb3dSCy Schubert <td><tt>09</tt></td> 6552b15cb3dSCy Schubert <td><tt>cert_not_verified</tt></td> 6562b15cb3dSCy Schubert <td>certificate signature not verified</td> 6572b15cb3dSCy Schubert </tr> 6582b15cb3dSCy Schubert <tr> 6592b15cb3dSCy Schubert <td><tt>0a</tt></td> 6602b15cb3dSCy Schubert <td><tt>cert_expired</tt></td> 6612b15cb3dSCy Schubert <td>host certificate expired</td> 6622b15cb3dSCy Schubert </tr> 6632b15cb3dSCy Schubert <tr> 6642b15cb3dSCy Schubert <td><tt>0b</tt></td> 6652b15cb3dSCy Schubert <td><tt>bad_cookie</tt></td> 6662b15cb3dSCy Schubert <td>bad or missing cookie</td> 6672b15cb3dSCy Schubert </tr> 6682b15cb3dSCy Schubert <tr> 6692b15cb3dSCy Schubert <td><tt>0c</tt></td> 6702b15cb3dSCy Schubert <td><tt>bad_leapseconds</tt></td> 6712b15cb3dSCy Schubert <td>bad or missing leapseconds values</td> 6722b15cb3dSCy Schubert </tr> 6732b15cb3dSCy Schubert <tr> 6742b15cb3dSCy Schubert <td><tt>0d</tt></td> 6752b15cb3dSCy Schubert <td><tt>cert_missing</tt></td> 6762b15cb3dSCy Schubert <td>bad or missing certificate</td> 6772b15cb3dSCy Schubert </tr> 6782b15cb3dSCy Schubert <tr> 6792b15cb3dSCy Schubert <td><tt>0e</tt></td> 6802b15cb3dSCy Schubert <td><tt>bad_group_key</tt></td> 6812b15cb3dSCy Schubert <td>bad or missing group key</td> 6822b15cb3dSCy Schubert </tr> 6832b15cb3dSCy Schubert <tr> 6842b15cb3dSCy Schubert <td><tt>0f</tt></td> 6852b15cb3dSCy Schubert <td><tt>proto_error</tt></td> 6862b15cb3dSCy Schubert <td>protocol error</td> 6872b15cb3dSCy Schubert </tr> 6882b15cb3dSCy Schubert</table> 6892b15cb3dSCy Schubert<hr> 6902b15cb3dSCy Schubert<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script> 6912b15cb3dSCy Schubert</body> 6922b15cb3dSCy Schubert</html> 693
