1ntp_decode(5)                 File Formats Manual                ntp_decode(5)
2
3
4

NAME

6       ntp_decode - ntpd Event Messages and Status Words
7
8

INTRODUCTION

10       This  page  lists the status words, event messages and error codes used
11       for ntpd reporting and monitoring. Status words are used to display the
12       current  status of the running program. There is one system status word
13       and a peer status word for each association. There is  a  clock  status
14       word  for  each association that supports a reference clock. There is a
15       flash code for each association which shows errors found  in  the  last
16       packet  received (pkt) and during protocol processing (peer). These are
17       commonly viewed using the ntpq program.
18
19       Significant changes in program state are reported as events.  There  is
20       one set of system events and a set of peer events for each association.
21       In addition, there is a set of clock events for each  association  that
22       supports  a reference clock. Events are normally reported to the proto‐
23       stats monitoring file and optionally to the system log. In addition, if
24       the  trap  facility  is  configured, events can be reported to a remote
25       program that can page an administrator.
26
27       This page also includes a description of the error messages produced by
28       the  Autokey  protocol.  These  messages are normally sent to the cryp‐
29       tostats monitoring file.
30
31       In the following tables the Code Field is  the  status  or  event  code
32       assigned  and  the  Message  Field  a short string used for display and
33       event reporting. The Description field contains a longer explanation of
34       the  status or event. Some messages include additional information use‐
35       ful for error diagnosis and performance assessment.
36
37

SYSTEM STATUS WORD

39       The system status word consists of four fields LI (0-1), Source  (2-7),
40       Count  (8-11) and Code (12-15). It is reported in the first line of the
41       rv display produced by the ntpq program.
42
43
44       ┌───────────────┬───────────────────┬──────────────────┬───────────────┐
45       │    Leap       │      Source       │      Count       │      Code     │
46       └───────────────┴───────────────────┴──────────────────┴───────────────┘
47       The Leap Field displays the system leap indicator bits  coded  as  fol‐
48       lows:
49
50
51       ┌──────┬──────────────┬────────────────────────────────────────────────┬┐
52       │Code  │Message       │Description                                     ││
53       ├──────┼──────────────┼────────────────────────────────────────────────┼┤
540     leap_none     │normal synchronized state                       ││
55       ├──────┼──────────────┼────────────────────────────────────────────────┼┤
561     leap_add_sec  │insert second after 23:59:59 of the current day ││
57       ├──────┼──────────────┼────────────────────────────────────────────────┼┤
582     leap_del_sec  │delete second 23:59:59 of the current day       ││
59       ├──────┼──────────────┼────────────────────────────────────────────────┼┤
603     leap_alarm    │never synchronized                              ││
61       └──────┴──────────────┴────────────────────────────────────────────────┴┘
62       The  Source  Field displays the current synchronization source coded as
63       follows:.
64
65
66       ┌──────┬─────────────────┬─────────────────────────────────────────────┬┐
67       │Code  │Message          │Description                                  ││
68       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
690     sync_unspec      │not yet synchronized                         ││
70       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
711     sync_pps         │pulse-per-second signal (Cs, Ru, GPS, etc.)  ││
72       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
732     sync_lf_radio    │VLF/LF radio (WWVB, DCF77, etc.)             ││
74       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
753     sync_hf_radio    │MF/HF radio (WWV, etc.)                      ││
76       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
774     sync_uhf_radio   │VHF/UHF radio/satellite (GPS, Galileo, etc.) ││
78       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
795     sync_local       │local timecode (IRIG, LOCAL driver, etc.)    ││
80       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
816     sync_ntp         │NTP                                          ││
82       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
837     sync_other       │other (IEEE 1588, openntp, crony, etc.)      ││
84       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
858     sync_wristwatch  │eyeball and wristwatch                       ││
86       ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
879     sync_telephone   │telephone modem (ACTS, PTB, etc.)            ││
88       └──────┴─────────────────┴─────────────────────────────────────────────┴┘
89       The Count Field displays the number of events since the last  time  the
90       code  changed.  Upon  reaching 15, subsequent events with the same code
91       are ignored.
92
93       The Event Field displays the most recent event message  coded  as  fol‐
94       lows:
95
96
97       ┌──────┬─────────────────────────┬───────────────────────────────────────┬┐
98       │Code  │Message                  │Description                            ││
99       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
10000    unspecified              │unspecified                            ││
101       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
10201    freq_not_set             │frequency file not available           ││
103       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
10402    freq_set                 │frequency set from frequency file      ││
105       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
10603    spike_detect             │spike detected                         ││
107       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
10804    freq_mode                │initial frequency training mode        ││
109       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
11005    clock_sync               │clock synchronized                     ││
111       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
11206    restart                  │program restart                        ││
113       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
11407    panic_stop               │clock error more than 600 s            ││
115       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
11608    no_system_peer           │no system peer                         ││
117       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
11809    leap_armed               │leap second armed from file or Autokey ││
119       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1200a    leap_disarmed            │leap second disarmed                   ││
121       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1220b    leap_event               │leap event                             ││
123       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1240c    clock_step               │clock stepped                          ││
125       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1260d    kern                     │kernel information message             ││
127       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1280e    TAI...                   │leapsecond values update from file     ││
129       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
1300f    stale leapsecond values  │new NIST leapseconds file needed       ││
131       ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
13210   clockhop                 │spurious clock hop suppressed          ││
133       └──────┴─────────────────────────┴───────────────────────────────────────┴┘
134

PEER STATUS WORD

136       The  peer  status  word  consists  of four fields: Status (0-4), Select
137       (5-7), Count (8-11) and Code (12-15). It is reported in the first  line
138       of the rv associd display produced by the ntpq program.
139
140
141       ┌─────────────────┬──────────────────┬──────────────────┬──────────────┐
142       │    Status       │     Select       │      Count       │     Code     │
143       └─────────────────┴──────────────────┴──────────────────┴──────────────┘
144       The  Status  Field  displays  the peer status code bits in hexadecimal;
145       each bit is an independent flag. (Note this field is 5 bits  wide,  and
146       combines  with the the 3-bit-wide Select Field to create the first full
147       byte of the peer status word.) The meaning of each bit  in  the  Status
148       Field is listed in the following table:
149
150
151       ┌─────────────┬────────────────┬───────────────────────────────┬───────┐
152       │   Code      │   Message      │    Description                │       │
153       ├─────────────┼────────────────┼───────────────────────────────┼───────┤
15408        bcst         │    broadcast association      │       │
155       ├─────────────┼────────────────┼───────────────────────────────┼───────┤
15610        reach        │    host reachable             │       │
157       ├─────────────┼────────────────┼───────────────────────────────┼───────┤
15820        authenb      │    authentication enabled     │       │
159       ├─────────────┼────────────────┼───────────────────────────────┼───────┤
16040        auth         │    authentication ok          │       │
161       ├─────────────┼────────────────┼───────────────────────────────┼───────┤
16280        config       │    persistent association     │       │
163       └─────────────┴────────────────┴───────────────────────────────┴───────┘
164       The Select Field displays the current selection status. (The T Field in
165       the following table gives the corresponding tally  codes  used  in  the
166       ntpq peers display.) The values are coded as follows:
167
168
169       ┌──────┬────────────────┬───┬──────────────────────────────────────────┐
170       │Code  │ Message        │T  │ Description                              │
171       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1720     sel_reject     │   │ discarded as not valid (TEST10-TEST13)   │
173       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1741     sel_falsetick  x  │ discarded by intersection algorithm      │
175       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1762     sel_excess     .  │ discarded by table overflow (not used)   │
177       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1783     sel_outlyer    -  │ discarded by the cluster algorithm       │
179       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1804     sel_candidate  +  │ included by the combine algorithm        │
181       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1825     sel_backup     #  │ backup (more than tos maxclock sources)  │
183       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1846     sel_sys.peer   *  │ system peer                              │
185       ├──────┼────────────────┼───┼──────────────────────────────────────────┤
1867     sel_pps.peer   o  │ PPS peer (when the prefer peer is valid) │
187       └──────┴────────────────┴───┴──────────────────────────────────────────┘
188       The  Count  Field displays the number of events since the last time the
189       code changed. Upon reaching 15, subsequent events with  the  same  code
190       are ignored.
191
192       The  Event  Field  displays the most recent event message coded as fol‐
193       lows:
194
195
196       ┌───────┬────────────────────┬───────────────────────────────────────┬─┐
197       │ Code  │ Message            │ Description                           │ │
198       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
19901    mobilize           │ association mobilized                 │ │
200       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
20102    demobilize         │ association demobilized               │ │
202       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
20303    unreachable        │ server unreachable                    │ │
204       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
20504    reachable          │ server reachable                      │ │
206       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
20705    restart            │ association restart                   │ │
208       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
20906    no_reply           │ no server found (ntpdate mode)        │ │
210       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
21107    rate_exceeded      │ rate exceeded (kiss code RATE)        │ │
212       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
21308    access_denied      │ access denied (kiss code DENY)        │ │
214       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
21509    leap_armed         │ leap armed from server LI code        │ │
216       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2170a    sys_peer           │ become system peer                    │ │
218       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2190b    clock_event        │ see clock status word                 │ │
220       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2210c    bad_auth           │ authentication failure                │ │
222       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2230d    popcorn            │ popcorn spike suppressor              │ │
224       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2250e    interleave_mode    │ entering interleave mode              │ │
226       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
2270f    interleave_error   │ interleave error (recovered)          │ │
228       ├───────┼────────────────────┼───────────────────────────────────────┼─┤
22910    TAI...             │ leapsecond values update from server  │ │
230       └───────┴────────────────────┴───────────────────────────────────────┴─┘
231

CLOCK STATUS WORD

233       The clock status word consists of  four  fields:  Unused  (0-7),  Count
234       (8-11) and Code (12-15). It is reported in the first line of the clock‐
235       var associd display produced by the ntpq program.
236
237
238       ┌───────────────────┬───────────────────┬──────────────────┬───────────┐
239       │    Unused         │      Count        │       Code       │           │
240       └───────────────────┴───────────────────┴──────────────────┴───────────┘
241       The Count Field displays the number of events since  the  last  lockvar
242       command,  while  the Event Field displays the most recent event message
243       coded as follows:
244
245
246       ┌──────────┬─────────────────────┬────────────────────────────────┬────┐
247       │  Code    │  Message            │  Description                   │    │
248       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
24900      clk_unspe          │  nominal                       │    │
250       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
25101      clk_noreply        │  no reply to poll              │    │
252       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
25302      clk_badformat      │  bad timecode format           │    │
254       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
25503      clk_fault          │  hardware or software fault    │    │
256       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
25704      clk_bad_signal     │  signal loss                   │    │
258       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
25905      clk_bad_date       │  bad date format               │    │
260       ├──────────┼─────────────────────┼────────────────────────────────┼────┤
26106      clk_bad_time       │  bad time format               │    │
262       └──────────┴─────────────────────┴────────────────────────────────┴────┘
263       When the clock driver sets the code to a new value, a clock_alarm  (11)
264       peer event is reported.
265
266

FLASH STATUS WORD

268       The  flash  status word is displayed by the ntpq program rv command. It
269       consists of a number of bits coded in hexadecimal as follows:
270
271
272       ┌─────────┬───────────┬──────────────────┬─────────────────────────────┐
273       │ Code    │  Tag      │  Message         │  Description                │
274       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2750001    │  TEST1    │  pkt_dup         │  duplicate packet           │
276       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2770002    │  TEST2    │  pkt_bogus       │  bogus packet               │
278       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2790004    │  TEST3    │  pkt_unsync      │  protocol unsynchronized    │
280       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2810008    │  TEST4    │  pkt_denied      │  access denied              │
282       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2830010    │  TEST5    │  pkt_auth        │  bad authentication         │
284       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2850020    │  TEST6    │  pkt_stratum     │  bad synch or stratum       │
286       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2870040    │  TEST7    │  pkt_header      │  bad header                 │
288       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2890080    │  TEST8    │  pkt_autokey     │  bad autokey                │
290       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2910100    │  TEST9    │  pkt_crypto      │  bad crypto                 │
292       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2930200    │  TEST10   │  peer_stratum    │  peer bad synch or stratum  │
294       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2950400    │  TEST11   │  peer_dist       │  peer distance exceeded     │
296       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2970800    │  TEST12   │  peer_loop       │  peer synchronization loop  │
298       ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
2991000    │  TEST13   │  peer_unreach    │  peer unreachable           │
300       └─────────┴───────────┴──────────────────┴─────────────────────────────┘
301

KISS CODES

303       Kiss codes are used in kiss-o'-death (koD) packets, billboard  displays
304       and  log  messages.  They consist of a string of four zero-padded ASCII
305       charactes. In practice they are informal and tend to change  with  time
306       and  implementation.  Some  of  these codes can appear in the reference
307       identifier field in ntpq billboards. Following is the current list:
308
309
310       ┌───────────────┬──────────────────────────────────┬──────────┬────────┐
311       │   Code        │     Description                  │          │        │
312       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
313ACST        │     manycast server              │          │        │
314       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
315AUTH        │     authentication error         │          │        │
316       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
317AUTO        │     Autokey sequence error       │          │        │
318       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
319BCST        │     broadcast server             │          │        │
320       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
321CRYPT       │     Autokey protocol error       │          │        │
322       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
323DENY        │     access denied by server      │          │        │
324       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
325INIT        │     association initialized      │          │        │
326       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
327MCST        │     multicast server             │          │        │
328       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
329RATE        │     rate exceeded                │          │        │
330       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
331TIME        │     association timeout          │          │        │
332       ├───────────────┼──────────────────────────────────┼──────────┼────────┤
333STEP        │     step time change             │          │        │
334       └───────────────┴──────────────────────────────────┴──────────┴────────┘
335

CRYPTO MESSAGES

337       These messages are sent to  the  cryptostats  file  when  an  error  is
338       detected in the Autokey protocol.
339
340
341       ┌───────┬───────────────────┬────────────────────────────────────────┬─┐
342       │Code   │Message            │ Description                            │ │
343       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
34401     bad_format         │ bad extension field format or length   │ │
345       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
34602     bad_timestamp      │ bad timestamp                          │ │
347       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
34803     bad_filestamp      │ bad filestamp                          │ │
349       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
35004     bad_public_key     │ bad or missing public key              │ │
351       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
35205     bad_digest         │ unsupported digest type                │ │
353       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
35406     bad_identity       │ unsupported identity type              │ │
355       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
35607     bad_siglength      │ bad signature length                   │ │
357       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
35808     bad signature      │ extension field signature not verified │ │
359       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
36009     cert_not_verified  │ certificate signature not verified     │ │
361       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3620a     cert_expired       │ host certificate expired               │ │
363       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3640b     bad_cookie         │ bad or missing cookie                  │ │
365       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3660c     bad_leapseconds    │ bad or missing leapseconds values      │ │
367       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3680d     cert_missing       │ bad or missing certificate             │ │
369       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3700e     bad_group_key      │ bad or missing group key               │ │
371       ├───────┼───────────────────┼────────────────────────────────────────┼─┤
3720f     proto_error        │ protocol error                         │ │
373       └───────┴───────────────────┴────────────────────────────────────────┴─┘
374

SEE ALSO

376       ntpq(8), ntp_mon(5)
377
378       HTML documentation in ntp-doc package.
379
380       This file was automatically generated from HTML source.
381
382
383
384
385                                                                 ntp_decode(5)
Impressum