decode.html revision 302408 
197403Sobrien<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
297403Sobrien<html>
397403Sobrien<head>
497403Sobrien<meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
597403Sobrien<meta name="generator" content="HTML Tidy, see www.w3.org">
697403Sobrien<title>Event Messages and Status Words</title>
797403Sobrien<link href="scripts/style.css" type="text/css" rel="stylesheet">
897403Sobrien</head>
997403Sobrien<body>
1097403Sobrien<h3>Event Messages and Status Words</h3>
1197403Sobrien<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>
1297403Sobrien<p>Caterpillar knows all the error codes, which is more than most of us do.</p>
1397403Sobrien<p>Last update:
1497403Sobrien  <!-- #BeginDate format:En2m -->26-Jul-2015  06:26<!-- #EndDate -->
1597403Sobrien    UTC</p>
1697403Sobrien</p>
1797403Sobrien<br clear="left">
1897403Sobrien<h4>Related Links</h4>
1997403Sobrien<p>
2097403Sobrien  <script type="text/javascript" language="javascript" src="scripts/install.txt"></script>
2197403Sobrien</p>
2297403Sobrien<h4>Table of Contents</h4>
2397403Sobrien<ul>
2497403Sobrien  <li class="inline"><a href="#intro">Introduction</a></li>
2597403Sobrien  <li class="inline"><a href="#sys">System Status Word</a></li>
2697403Sobrien  <li class="inline"><a href="#peer">Peer Status Word</a></li>
2797403Sobrien  <li class="inline"><a href="#clock">Clock Status Word</a></li>
2897403Sobrien  <li class="inline"><a href="#flash">Flash Status Word</a></li>
2997403Sobrien  <li class="inline"><a href="#kiss">Kiss Codes</a></li>
3097403Sobrien  <li class="inline"><a href="#crypto">Crypto Messages</a></li>
3197403Sobrien</ul>
3297403Sobrien<hr>
3397403Sobrien<h4 id="intro">Introduction</h4>
3497403Sobrien<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>
3597403Sobrien<p>Significant changes in program state are reported as events. There is one
3697403Sobrien  set of system events and a set of peer events for each association. In addition,
3797403Sobrien  there is a set of clock events for each association that supports a reference
38117397Skan  clock. Events are normally reported to the <tt>protostats</tt> monitoring file
3997403Sobrien  and optionally to the system log. In addition, if the trap facility is configured,
4097403Sobrien  events can be reported to a remote program that can page an administrator.</p>
4197403Sobrien<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>
4297403Sobrien<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>
4397403Sobrien<h4 id="sys">System Status Word</h4>
4497403Sobrien<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>
4597403Sobrien<table width="50%" border="1" cellspacing="2" cellpadding="2">
4697403Sobrien  <tr>
4797403Sobrien    <td><div align="center">Leap</div></td>
4897403Sobrien    <td><div align="center">Source</div></td>
49103447Skan    <td><div align="center">Count</div></td>
5097403Sobrien    <td><div align="center">Event</div></td>
51102782Skan  </tr>
52102782Skan</table>
5397403Sobrien<p>The Leap Field displays the system leap indicator bits coded as follows:</p>
5497403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
55102782Skan  <tr>
5697403Sobrien    <td>Code</td>
5797403Sobrien    <td>Message</td>
5897403Sobrien    <td>Description</td>
5997403Sobrien  </tr>
6097403Sobrien  <tr>
6197403Sobrien    <td><tt>0</tt></td>
6297403Sobrien    <td><tt>leap_none</tt></td>
63107606Sobrien    <td>normal synchronized state</td>
6497403Sobrien  </tr>
6597403Sobrien  <tr>
66107606Sobrien    <td><tt>1</tt></td>
67103447Skan    <td><tt>leap_add_sec</tt></td>
6897403Sobrien    <td>insert second after 23:59:59 of the current day</td>
6997403Sobrien  </tr>
7097403Sobrien  <tr>
7197403Sobrien    <td><tt>2</tt></td>
7297403Sobrien    <td><tt>leap_del_sec</tt></td>
7397403Sobrien    <td>delete second 23:59:59 of the current day</td>
7497403Sobrien  </tr>
7597403Sobrien  <tr>
7697403Sobrien    <td><tt>3</tt></td>
7797403Sobrien    <td><tt>leap_alarm</tt></td>
7897403Sobrien    <td>never synchronized</td>
7997403Sobrien  </tr>
8097403Sobrien</table>
8197403Sobrien<p>The Source Field displays the current synchronization source coded as follows:</p>
8297403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
8397403Sobrien  <tr>
8497403Sobrien    <td>Code</td>
8597403Sobrien    <td>Message</td>
8697403Sobrien    <td>Description</td>
8797403Sobrien  </tr>
8897403Sobrien  <tr>
8997403Sobrien    <td><tt>0</tt></td>
9097403Sobrien    <td><tt>sync_unspec</tt></td>
9197403Sobrien    <td>not yet synchronized</td>
9297403Sobrien  </tr>
9397403Sobrien  <tr>
9497403Sobrien    <td><tt>1</tt></td>
9597403Sobrien    <td><tt>sync_pps</tt></td>
9697403Sobrien    <td>pulse-per-second signal (Cs, Ru, GPS, etc.)</td>
9797403Sobrien  </tr>
9897403Sobrien  <tr>
9997403Sobrien    <td><tt>2</tt></td>
10097403Sobrien    <td><tt>sync_lf_radio</tt></td>
10197403Sobrien    <td>VLF/LF radio (WWVB, DCF77, etc.)</td>
10297403Sobrien  </tr>
10397403Sobrien  <tr>
10497403Sobrien    <td><tt>3</tt></td>
10597403Sobrien    <td><tt>sync_hf_radio</tt></td>
10697403Sobrien    <td>MF/HF radio (WWV, etc.)</td>
10797403Sobrien  </tr>
10897403Sobrien  <tr>
10997403Sobrien    <td><tt>4</tt></td>
11097403Sobrien    <td><tt>sync_uhf_radio</tt></td>
11197403Sobrien    <td>VHF/UHF radio/satellite (GPS, Galileo, etc.)</td>
11297403Sobrien  </tr>
11397403Sobrien  <tr>
11497403Sobrien    <td><tt>5</tt></td>
11597403Sobrien    <td><tt>sync_local</tt></td>
11697403Sobrien    <td>local timecode (IRIG, LOCAL driver, etc.)</td>
11797403Sobrien  </tr>
11897403Sobrien  <tr>
11997403Sobrien    <td><tt>6</tt></td>
12097403Sobrien    <td><tt>sync_ntp</tt></td>
12197403Sobrien    <td>NTP</td>
12297403Sobrien  </tr>
12397403Sobrien  <tr>
12497403Sobrien    <td><tt>7</tt></td>
12597403Sobrien    <td><tt>sync_other</tt></td>
12697403Sobrien    <td>other (IEEE 1588, openntp, crony, etc.)</td>
12797403Sobrien  </tr>
12897403Sobrien  <tr>
12997403Sobrien    <td><tt>8</tt></td>
13097403Sobrien    <td><tt>sync_wristwatch</tt></td>
13197403Sobrien    <td>eyeball and wristwatch</td>
13297403Sobrien  </tr>
13397403Sobrien  <tr>
13497403Sobrien    <td><tt>9</tt></td>
13597403Sobrien    <td><tt>sync_telephone</tt></td>
13697403Sobrien    <td>telephone modem (ACTS, PTB, etc.)</td>
13797403Sobrien  </tr>
13897403Sobrien</table>
13997403Sobrien<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>
14097403Sobrien<p>The Event Field displays the most recent event message coded as follows:</p>
14197403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
14297403Sobrien  <tr>
14397403Sobrien    <td>Code</td>
14497403Sobrien    <td>Message</td>
14597403Sobrien    <td>Description</td>
14697403Sobrien  </tr>
14797403Sobrien  <tr>
14897403Sobrien    <td><tt>00</tt></td>
14997403Sobrien    <td><tt>unspecified</tt></td>
15097403Sobrien    <td>unspecified</td>
15197403Sobrien  </tr>
15297403Sobrien  <tr>
15397403Sobrien    <td><tt>01</tt></td>
15497403Sobrien    <td><tt>freq_not_set</tt></td>
15597403Sobrien    <td>frequency file not available</td>
15697403Sobrien  </tr>
15797403Sobrien  <tr>
15897403Sobrien    <td><tt>02</tt></td>
15997403Sobrien    <td><tt>freq_set</tt></td>
16097403Sobrien    <td>frequency set from frequency file</td>
16197403Sobrien  </tr>
16297403Sobrien  <tr>
16397403Sobrien    <td><tt>03</tt></td>
16497403Sobrien    <td><tt>spike_detect</tt></td>
16597403Sobrien    <td>spike detected</td>
16697403Sobrien  </tr>
16797403Sobrien  <tr>
16897403Sobrien    <td><tt>04</tt></td>
16997403Sobrien    <td><tt>freq_mode</tt></td>
17097403Sobrien    <td>initial frequency training mode</td>
17197403Sobrien  </tr>
17297403Sobrien  <tr>
17397403Sobrien    <td><tt>05</tt></td>
17497403Sobrien    <td><tt>clock_sync</tt></td>
17597403Sobrien    <td>clock synchronized</td>
17697403Sobrien  </tr>
17797403Sobrien  <tr>
17897403Sobrien    <td><tt>06</tt></td>
17997403Sobrien    <td><tt>restart</tt></td>
18097403Sobrien    <td>program restart</td>
18197403Sobrien  </tr>
18297403Sobrien  <tr>
18397403Sobrien    <td><tt>07</tt></td>
18497403Sobrien    <td><tt>panic_stop</tt></td>
18597403Sobrien    <td>clock error more than 600 s</td>
18697403Sobrien  </tr>
18797403Sobrien  <tr>
18897403Sobrien    <td><tt>08</tt></td>
18997403Sobrien    <td><tt>no_system_peer</tt></td>
19097403Sobrien    <td>no system peer</td>
19197403Sobrien  </tr>
19297403Sobrien  <tr>
19397403Sobrien    <td><tt>09</tt></td>
194103447Skan    <td><tt>leap_armed</tt></td>
19597403Sobrien    <td>leap second armed from file or Autokey</td>
196102782Skan  </tr>
197102782Skan  <tr>
19897403Sobrien    <td><tt>0a</tt></td>
19997403Sobrien    <td><tt>leap_disarmed</tt></td>
200102782Skan    <td>leap second disarmed</td>
20197403Sobrien  </tr>
20297403Sobrien  <tr>
20397403Sobrien    <td><tt>0b</tt></td>
20497403Sobrien    <td><tt>leap_event</tt></td>
20597403Sobrien    <td>leap event</td>
20697403Sobrien  </tr>
20797403Sobrien  <tr>
208107606Sobrien    <td><tt>0c</tt></td>
20997403Sobrien    <td><tt>clock_step</tt></td>
21097403Sobrien    <td>clock stepped</td>
211107606Sobrien  </tr>
212103447Skan  <tr>
21397403Sobrien    <td><tt>0d</tt></td>
21497403Sobrien    <td><tt>kern</tt></td>
21597403Sobrien    <td>kernel information message</td>
21697403Sobrien  </tr>
21797403Sobrien  <tr>
21897403Sobrien    <td><tt>0e</tt></td>
21997403Sobrien    <td><tt>TAI...</tt></td>
22097403Sobrien    <td>leapsecond values update from file</td>
22197403Sobrien  </tr>
22297403Sobrien  <tr>
22397403Sobrien    <td><tt>0f</tt></td>
22497403Sobrien    <td><tt>stale leapsecond values</tt></td>
22597403Sobrien    <td>new NIST leapseconds file needed</td>
22697403Sobrien  </tr>
22797403Sobrien</table>
22897403Sobrien<h4 id="peer">Peer Status Word</h4>
22997403Sobrien<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>
23097403Sobrien<table width="50%" border="1" cellspacing="2" cellpadding="2">
23197403Sobrien  <tr>
23297403Sobrien    <td><div align="center">Status</div></td>
23397403Sobrien    <td><div align="center">Select</div></td>
23497403Sobrien    <td><div align="center">Count</div></td>
23597403Sobrien    <td><div align="center">Code</div></td>
23697403Sobrien  </tr>
23797403Sobrien</table>
23897403Sobrien<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>
23997403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
24097403Sobrien  <tr>
24197403Sobrien    <td>Code</td>
24297403Sobrien    <td>Message</td>
24397403Sobrien    <td>Description</td>
24497403Sobrien  </tr>
24597403Sobrien  <tr>
24697403Sobrien    <td><tt>08</tt></td>
24797403Sobrien    <td><tt>bcst</tt></td>
24897403Sobrien    <td>broadcast association</td>
24997403Sobrien  </tr>
25097403Sobrien  <tr>
25197403Sobrien    <td><tt>10</tt></td>
25297403Sobrien    <td><tt>reach</tt></td>
25397403Sobrien    <td>host reachable</td>
25497403Sobrien  </tr>
25597403Sobrien  <tr>
25697403Sobrien    <td><tt>20</tt></td>
25797403Sobrien    <td><tt>auth</tt></td>
25897403Sobrien    <td>authentication ok</td>
25997403Sobrien  </tr>
26097403Sobrien  <tr>
26197403Sobrien    <td><tt>40</tt></td>
26297403Sobrien    <td><tt>authenb</tt></td>
26397403Sobrien    <td>authentication enabled</td>
26497403Sobrien  </tr>
26597403Sobrien  <tr>
26697403Sobrien    <td><tt>80</tt></td>
26797403Sobrien    <td><tt>config</tt></td>
26897403Sobrien    <td>persistent association</td>
26997403Sobrien  </tr>
27097403Sobrien</table>
27197403Sobrien<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>
27297403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
27397403Sobrien  <tr>
27497403Sobrien    <td>Code</td>
27597403Sobrien    <td>Message</td>
27697403Sobrien    <td>T</td>
27797403Sobrien    <td>Description</td>
27897403Sobrien  </tr>
27997403Sobrien  <tr>
28097403Sobrien    <td><tt>0</tt></td>
28197403Sobrien    <td><tt>sel_reject</tt></td>
28297403Sobrien    <td>&nbsp;</td>
28397403Sobrien    <td>discarded as not valid (TEST10-TEST13)</td>
28497403Sobrien  </tr>
28597403Sobrien  <tr>
28697403Sobrien    <td><tt>1</tt></td>
28797403Sobrien    <td><tt>sel_falsetick</tt></td>
28897403Sobrien    <td><tt>x</tt></td>
28997403Sobrien    <td>discarded by intersection algorithm</td>
29097403Sobrien  </tr>
29197403Sobrien  <tr>
29297403Sobrien    <td><tt>2</tt></td>
29397403Sobrien    <td><tt>sel_excess</tt></td>
29497403Sobrien    <td><tt>.</tt></td>
29597403Sobrien    <td>discarded by table overflow (not used)</td>
29697403Sobrien  </tr>
29797403Sobrien  <tr>
29897403Sobrien    <td><tt>3</tt></td>
29997403Sobrien    <td><tt>sel_outlier</tt></td>
30097403Sobrien    <td><tt>-</tt></td>
30197403Sobrien    <td>discarded by the cluster algorithm</td>
30297403Sobrien  </tr>
30397403Sobrien  <tr>
30497403Sobrien    <td><tt>4</tt></td>
30597403Sobrien    <td><tt>sel_candidate</tt></td>
30697403Sobrien    <td><tt>+</tt></td>
30797403Sobrien    <td>included by the combine algorithm</td>
30897403Sobrien  </tr>
30997403Sobrien  <tr>
31097403Sobrien    <td><tt>5</tt></td>
31197403Sobrien    <td><tt>sel_backup</tt></td>
31297403Sobrien    <td><tt>#</tt></td>
31397403Sobrien    <td>backup (more than <tt>tos maxclock</tt> sources)</td>
31497403Sobrien  </tr>
31597403Sobrien  <tr>
31697403Sobrien    <td><tt>6</tt></td>
31797403Sobrien    <td><tt>sel_sys.peer</tt></td>
31897403Sobrien    <td><tt>*</tt></td>
31997403Sobrien    <td>system peer</td>
32097403Sobrien  </tr>
32197403Sobrien  <tr>
32297403Sobrien    <td><tt>7</tt></td>
32397403Sobrien    <td><tt>sel_pps.peer</tt></td>
32497403Sobrien    <td><tt>o</tt></td>
32597403Sobrien    <td>PPS peer (when the prefer peer is valid)</td>
32697403Sobrien  </tr>
32797403Sobrien</table>
32897403Sobrien<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>
32997403Sobrien<p>The Event Field displays the most recent event message coded as follows:</p>
33097403Sobrien<table width="100%" border="1" cellspacing="2" cellpadding="2">
33197403Sobrien  <tr>
332    <td>Code</td>
333    <td>Message</td>
334    <td>Description</td>
335  </tr>
336  <tr>
337    <td><tt>01</tt></td>
338    <td><tt>mobilize</tt></td>
339    <td>association mobilized</td>
340  </tr>
341  <tr>
342    <td><tt>02</tt></td>
343    <td><tt>demobilize</tt></td>
344    <td>association demobilized</td>
345  </tr>
346  <tr>
347    <td><tt>03</tt></td>
348    <td><tt>unreachable</tt></td>
349    <td>server unreachable</td>
350  </tr>
351  <tr>
352    <td><tt>04</tt></td>
353    <td><tt>reachable</tt></td>
354    <td>server reachable</td>
355  </tr>
356  <tr>
357    <td><tt>05</tt></td>
358    <td><tt>restart</tt></td>
359    <td>association restart</td>
360  </tr>
361  <tr>
362    <td><tt>06</tt></td>
363    <td><tt>no_reply</tt></td>
364    <td>no server found (<tt>ntpdate</tt> mode)</td>
365  </tr>
366  <tr>
367    <td><tt>07</tt></td>
368    <td><tt>rate_exceeded</tt></td>
369    <td>rate exceeded (kiss code <tt>RATE</tt>)</td>
370  </tr>
371  <tr>
372    <td><tt>08</tt></td>
373    <td><tt>access_denied</tt></td>
374    <td>access denied (kiss code <tt>DENY</tt>)</td>
375  </tr>
376  <tr>
377    <td><tt>09</tt></td>
378    <td><tt>leap_armed</tt></td>
379    <td>leap armed from server LI code</td>
380  </tr>
381  <tr>
382    <td><tt>0a</tt></td>
383    <td><tt>sys_peer</tt></td>
384    <td>become system peer</td>
385  </tr>
386  <tr>
387    <td><tt>0b</tt></td>
388    <td><tt>clock_event</tt></td>
389    <td>see clock status word</td>
390  </tr>
391  <tr>
392    <td><tt>0c</tt></td>
393    <td><tt>bad_auth</tt></td>
394    <td>authentication failure</td>
395  </tr>
396  <tr>
397    <td><tt>0d</tt></td>
398    <td><tt>popcorn</tt></td>
399    <td>popcorn spike suppressor</td>
400  </tr>
401  <tr>
402    <td><tt>0e</tt></td>
403    <td><tt>interleave_mode</tt></td>
404    <td>entering interleave mode</td>
405  </tr>
406  <tr>
407    <td><tt>0f</tt></td>
408    <td><tt>interleave_error</tt></td>
409    <td>interleave error (recovered)</td>
410  </tr>
411</table>
412<h4 id="clock">Clock Status Word</h4>
413<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>
414<table width="50%" border="1" cellspacing="2" cellpadding="2">
415  <tr>
416    <td><div align="center">Unused</div></td>
417    <td><div align="center">Count</div></td>
418    <td><div align="center">Code</div></td>
419  </tr>
420</table>
421<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>
422<table width="100%" border="1" cellspacing="2" cellpadding="2">
423  <tr>
424    <td>Code</td>
425    <td>Message</td>
426    <td>Description</td>
427  </tr>
428  <tr>
429    <td><tt>00</tt></td>
430    <td><tt>clk_unspe</tt></td>
431    <td>nominal</td>
432  </tr>
433  <tr>
434    <td><tt>01</tt></td>
435    <td><tt>clk_noreply</tt></td>
436    <td>no reply to poll</td>
437  </tr>
438  <tr>
439    <td><tt>02</tt></td>
440    <td><tt>clk_badformat</tt></td>
441    <td>bad timecode format</td>
442  </tr>
443  <tr>
444    <td><tt>03</tt></td>
445    <td><tt>clk_fault</tt></td>
446    <td>hardware or software fault</td>
447  </tr>
448  <tr>
449    <td><tt>04</tt></td>
450    <td><tt>clk_bad_signal</tt></td>
451    <td>signal loss</td>
452  </tr>
453  <tr>
454    <td><tt>05</tt></td>
455    <td><tt>clk_bad_date</tt></td>
456    <td>bad date format</td>
457  </tr>
458  <tr>
459    <td><tt>06</tt></td>
460    <td><tt>clk_bad_time</tt></td>
461    <td>bad time format</td>
462  </tr>
463</table>
464<p>When the clock driver sets the code to a new value, a <tt>clock_alarm</tt> (11) peer event is reported.</p>
465<h4 id="flash">Flash Status Word</h4>
466<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>
467<table width="100%" border="1" cellspacing="2" cellpadding="2">
468  <tr>
469    <td width="10%">Code</td>
470    <td width="15%">Tag</td>
471    <td width="20%">Message</td>
472    <td width="55%">Description</td>
473  </tr>
474  <tr>
475    <td><tt>0001</tt></td>
476    <td>TEST1</td>
477    <td><tt>pkt_dup</tt></td>
478    <td>duplicate packet</td>
479  </tr>
480  <tr>
481    <td><tt>0002</tt></td>
482    <td>TEST2</td>
483    <td><tt>pkt_bogus</tt></td>
484    <td>bogus packet</td>
485  </tr>
486  <tr>
487    <td><tt>0004</tt></td>
488    <td>TEST3</td>
489    <td><tt>pkt_unsync</tt></td>
490    <td>server not synchronized</td>
491  </tr>
492  <tr>
493    <td><tt>0008</tt></td>
494    <td>TEST4</td>
495    <td><tt>pkt_denied</tt></td>
496    <td>access denied</td>
497  </tr>
498  <tr>
499    <td><tt>0010</tt></td>
500    <td>TEST5</td>
501    <td><tt>pkt_auth</tt></td>
502    <td> authentication failure</td>
503  </tr>
504  <tr>
505    <td><tt>0020</tt></td>
506    <td>TEST6</td>
507    <td><tt>pkt_stratum</tt></td>
508    <td>invalid  leap or stratum</td>
509  </tr>
510  <tr>
511    <td><tt>0040</tt></td>
512    <td>TEST7</td>
513    <td><tt>pkt_header</tt></td>
514    <td> header distance exceeded</td>
515  </tr>
516  <tr>
517    <td><tt>0080</tt></td>
518    <td>TEST8</td>
519    <td><tt>pkt_autokey</tt></td>
520    <td>Autokey sequence error</td>
521  </tr>
522  <tr>
523    <td><tt>0100</tt></td>
524    <td>TEST9</td>
525    <td><tt>pkt_crypto</tt></td>
526    <td>Autokey protocol error</td>
527  </tr>
528  <tr>
529    <td><tt>0200</tt></td>
530    <td>TEST10</td>
531    <td><tt>peer_stratum</tt></td>
532    <td> invalid header or stratum</td>
533  </tr>
534  <tr>
535    <td><tt>0400</tt></td>
536    <td>TEST11</td>
537    <td><tt>peer_dist</tt></td>
538    <td> distance threshold exceeded</td>
539  </tr>
540  <tr>
541    <td><tt>0800</tt></td>
542    <td>TEST12</td>
543    <td><tt>peer_loop</tt></td>
544    <td> synchronization loop</td>
545  </tr>
546  <tr>
547    <td><tt>1000</tt></td>
548    <td>TEST13</td>
549    <td><tt>peer_unreach</tt></td>
550    <td> unreachable or nonselect</td>
551  </tr>
552</table>
553<h4 id="kiss">Kiss Codes</h4>
554<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>
555<table width="100%" border="1" cellspacing="2" cellpadding="2">
556  <tr>
557    <td>Code</td>
558    <td>Description</td>
559  </tr>
560  <tr>
561    <td><tt>ACST</tt></td>
562    <td>manycast server</td>
563  </tr>
564  <tr>
565    <td><tt>AUTH</tt></td>
566    <td>authentication error</td>
567  </tr>
568  <tr>
569    <td><tt>AUTO</tt></td>
570    <td>Autokey sequence error</td>
571  </tr>
572  <tr>
573    <td><tt>BCST</tt></td>
574    <td>broadcast server</td>
575  </tr>
576  <tr>
577    <td><tt>CRYPT</tt></td>
578    <td>Autokey protocol error</td>
579  </tr>
580  <tr>
581    <td><tt>DENY</tt></td>
582    <td>access denied by server</td>
583  </tr>
584  <tr>
585    <td><tt>INIT</tt></td>
586    <td>association initialized</td>
587  </tr>
588  <tr>
589    <td><tt>MCST</tt></td>
590    <td>multicast server</td>
591  </tr>
592  <tr>
593    <td><tt>RATE</tt></td>
594    <td>rate exceeded</td>
595  </tr>
596  <tr>
597    <td><tt>TIME</tt></td>
598    <td>association timeout</td>
599  </tr>
600  <tr>
601    <td><tt>STEP</tt></td>
602    <td>step time change</td>
603  </tr>
604</table>
605<h4 id="crypto">Crypto Messages</h4>
606<p>These messages are sent to the <tt>cryptostats</tt> file when an error is detected in the Autokey protocol.</p>
607<table width="100%" border="1" cellspacing="2" cellpadding="2">
608  <tr>
609    <td>Code</td>
610    <td>Message</td>
611    <td>Description</td>
612  </tr>
613  <tr>
614    <td><tt>01</tt></td>
615    <td><tt>bad_format</tt></td>
616    <td>bad extension field format or length</td>
617  </tr>
618  <tr>
619    <td><tt>02</tt></td>
620    <td><tt>bad_timestamp</tt></td>
621    <td>bad timestamp</td>
622  </tr>
623  <tr>
624    <td><tt>03</tt></td>
625    <td><tt>bad_filestamp</tt></td>
626    <td>bad filestamp</td>
627  </tr>
628  <tr>
629    <td><tt>04</tt></td>
630    <td><tt>bad_public_key</tt></td>
631    <td>bad or missing public key</td>
632  </tr>
633  <tr>
634    <td><tt>05</tt></td>
635    <td><tt>bad_digest</tt></td>
636    <td>unsupported digest type</td>
637  </tr>
638  <tr>
639    <td><tt>06</tt></td>
640    <td><tt>bad_identity</tt></td>
641    <td>unsupported identity type</td>
642  </tr>
643  <tr>
644    <td><tt>07</tt></td>
645    <td><tt>bad_siglength</tt></td>
646    <td>bad signature length</td>
647  </tr>
648  <tr>
649    <td><tt>08</tt></td>
650    <td><tt>bad signature</tt></td>
651    <td>extension field signature not verified</td>
652  </tr>
653  <tr>
654    <td><tt>09</tt></td>
655    <td><tt>cert_not_verified</tt></td>
656    <td>certificate signature not verified</td>
657  </tr>
658  <tr>
659    <td><tt>0a</tt></td>
660    <td><tt>cert_expired</tt></td>
661    <td>host certificate expired</td>
662  </tr>
663  <tr>
664    <td><tt>0b</tt></td>
665    <td><tt>bad_cookie</tt></td>
666    <td>bad or missing cookie</td>
667  </tr>
668  <tr>
669    <td><tt>0c</tt></td>
670    <td><tt>bad_leapseconds</tt></td>
671    <td>bad or missing leapseconds values</td>
672  </tr>
673  <tr>
674    <td><tt>0d</tt></td>
675    <td><tt>cert_missing</tt></td>
676    <td>bad or missing certificate</td>
677  </tr>
678  <tr>
679    <td><tt>0e</tt></td>
680    <td><tt>bad_group_key</tt></td>
681    <td>bad or missing group key</td>
682  </tr>
683  <tr>
684    <td><tt>0f</tt></td>
685    <td><tt>proto_error</tt></td>
686    <td>protocol error</td>
687  </tr>
688</table>
689<hr>
690<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
691</body>
692</html>
693