1ntp_decode(5) File Formats Manual ntp_decode(5)
2
6 ntp_decode - ntpd Event Messages and Status Words
7
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 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 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 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
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 ┌───────────────┬───────────────────┬──────────────────┬───────────────┐
45 │ Leap │ Source │ Count │ Code │
46 └───────────────┴───────────────────┴──────────────────┴───────────────┘
47 The Leap Field displays the system leap indicator bits coded as fol‐
48 lows:
49 ┌──────┬──────────────┬────────────────────────────────────────────────┬┐
52 │Code │Message │Description ││
53 ├──────┼──────────────┼────────────────────────────────────────────────┼┤
54 │0 │leap_none │normal synchronized state ││
55 ├──────┼──────────────┼────────────────────────────────────────────────┼┤
56 │1 │leap_add_sec │insert second after 23:59:59 of the current day ││
57 ├──────┼──────────────┼────────────────────────────────────────────────┼┤
58 │2 │leap_del_sec │delete second 23:59:59 of the current day ││
59 ├──────┼──────────────┼────────────────────────────────────────────────┼┤
60 │3 │leap_alarm │never synchronized ││
61 └──────┴──────────────┴────────────────────────────────────────────────┴┘
62 The Source Field displays the current synchronization source coded as
63 follows:.
64 ┌──────┬─────────────────┬─────────────────────────────────────────────┬┐
67 │Code │Message │Description ││
68 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
69 │0 │sync_unspec │not yet synchronized ││
70 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
71 │1 │sync_pps │pulse-per-second signal (Cs, Ru, GPS, etc.) ││
72 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
73 │2 │sync_lf_radio │VLF/LF radio (WWVB, DCF77, etc.) ││
74 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
75 │3 │sync_hf_radio │MF/HF radio (WWV, etc.) ││
76 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
77 │4 │sync_uhf_radio │VHF/UHF radio/satellite (GPS, Galileo, etc.) ││
78 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
79 │5 │sync_local │local timecode (IRIG, LOCAL driver, etc.) ││
80 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
81 │6 │sync_ntp │NTP ││
82 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
83 │7 │sync_other │other (IEEE 1588, openntp, crony, etc.) ││
84 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
85 │8 │sync_wristwatch │eyeball and wristwatch ││
86 ├──────┼─────────────────┼─────────────────────────────────────────────┼┤
87 │9 │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 The Event Field displays the most recent event message coded as fol‐
94 lows:
95 ┌──────┬─────────────────────────┬───────────────────────────────────────┬┐
98 │Code │Message │Description ││
99 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
100 │00 │unspecified │unspecified ││
101 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
102 │01 │freq_not_set │frequency file not available ││
103 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
104 │02 │freq_set │frequency set from frequency file ││
105 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
106 │03 │spike_detect │spike detected ││
107 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
108 │04 │freq_mode │initial frequency training mode ││
109 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
110 │05 │clock_sync │clock synchronized ││
111 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
112 │06 │restart │program restart ││
113 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
114 │07 │panic_stop │clock error more than 600 s ││
115 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
116 │08 │no_system_peer │no system peer ││
117 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
118 │09 │leap_armed │leap second armed from file or Autokey ││
119 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
120 │0a │leap_disarmed │leap second disarmed ││
121 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
122 │0b │leap_event │leap event ││
123 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
124 │0c │clock_step │clock stepped ││
125 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
126 │0d │kern │kernel information message ││
127 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
128 │0e │TAI... │leapsecond values update from file ││
129 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
130 │0f │stale leapsecond values │new NIST leapseconds file needed ││
131 ├──────┼─────────────────────────┼───────────────────────────────────────┼┤
132 │ 10 │clockhop │spurious clock hop suppressed ││
133 └──────┴─────────────────────────┴───────────────────────────────────────┴┘
134
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 ┌─────────────────┬──────────────────┬──────────────────┬──────────────┐
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 ┌─────────────┬────────────────┬───────────────────────────────┬───────┐
152 │ Code │ Message │ Description │ │
153 ├─────────────┼────────────────┼───────────────────────────────┼───────┤
154 │ 08 │ bcst │ broadcast association │ │
155 ├─────────────┼────────────────┼───────────────────────────────┼───────┤
156 │ 10 │ reach │ host reachable │ │
157 ├─────────────┼────────────────┼───────────────────────────────┼───────┤
158 │ 20 │ authenb │ authentication enabled │ │
159 ├─────────────┼────────────────┼───────────────────────────────┼───────┤
160 │ 40 │ auth │ authentication ok │ │
161 ├─────────────┼────────────────┼───────────────────────────────┼───────┤
162 │ 80 │ 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 ┌──────┬────────────────┬───┬──────────────────────────────────────────┐
170 │Code │ Message │T │ Description │
171 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
172 │0 │ sel_reject │ │ discarded as not valid (TEST10-TEST13) │
173 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
174 │1 │ sel_falsetick │x │ discarded by intersection algorithm │
175 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
176 │2 │ sel_excess │. │ discarded by table overflow (not used) │
177 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
178 │3 │ sel_outlyer │- │ discarded by the cluster algorithm │
179 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
180 │4 │ sel_candidate │+ │ included by the combine algorithm │
181 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
182 │5 │ sel_backup │# │ backup (more than tos maxclock sources) │
183 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
184 │6 │ sel_sys.peer │* │ system peer │
185 ├──────┼────────────────┼───┼──────────────────────────────────────────┤
186 │7 │ 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 The Event Field displays the most recent event message coded as fol‐
193 lows:
194 ┌───────┬────────────────────┬───────────────────────────────────────┬─┐
197 │ Code │ Message │ Description │ │
198 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
199 │ 01 │ mobilize │ association mobilized │ │
200 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
201 │ 02 │ demobilize │ association demobilized │ │
202 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
203 │ 03 │ unreachable │ server unreachable │ │
204 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
205 │ 04 │ reachable │ server reachable │ │
206 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
207 │ 05 │ restart │ association restart │ │
208 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
209 │ 06 │ no_reply │ no server found (ntpdate mode) │ │
210 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
211 │ 07 │ rate_exceeded │ rate exceeded (kiss code RATE) │ │
212 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
213 │ 08 │ access_denied │ access denied (kiss code DENY) │ │
214 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
215 │ 09 │ leap_armed │ leap armed from server LI code │ │
216 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
217 │ 0a │ sys_peer │ become system peer │ │
218 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
219 │ 0b │ clock_event │ see clock status word │ │
220 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
221 │ 0c │ bad_auth │ authentication failure │ │
222 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
223 │ 0d │ popcorn │ popcorn spike suppressor │ │
224 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
225 │ 0e │ interleave_mode │ entering interleave mode │ │
226 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
227 │ 0f │ interleave_error │ interleave error (recovered) │ │
228 ├───────┼────────────────────┼───────────────────────────────────────┼─┤
229 │ 10 │ TAI... │ leapsecond values update from server │ │
230 └───────┴────────────────────┴───────────────────────────────────────┴─┘
231
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 ┌───────────────────┬───────────────────┬──────────────────┬───────────┐
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 ┌──────────┬─────────────────────┬────────────────────────────────┬────┐
247 │ Code │ Message │ Description │ │
248 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
249 │ 00 │ clk_unspe │ nominal │ │
250 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
251 │ 01 │ clk_noreply │ no reply to poll │ │
252 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
253 │ 02 │ clk_badformat │ bad timecode format │ │
254 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
255 │ 03 │ clk_fault │ hardware or software fault │ │
256 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
257 │ 04 │ clk_bad_signal │ signal loss │ │
258 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
259 │ 05 │ clk_bad_date │ bad date format │ │
260 ├──────────┼─────────────────────┼────────────────────────────────┼────┤
261 │ 06 │ clk_bad_time │ bad time format │ │
262 └──────────┴─────────────────────┴────────────────────────────────┴────┘
263 When the clock driver sets the code to a new value, a clock_alarm [22m(11)
264 peer event is reported.
265
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 ┌─────────┬───────────┬──────────────────┬─────────────────────────────┐
273 │ Code │ Tag │ Message │ Description │
274 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
275 │ 0001 │ TEST1 │ pkt_dup │ duplicate packet │
276 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
277 │ 0002 │ TEST2 │ pkt_bogus │ bogus packet │
278 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
279 │ 0004 │ TEST3 │ pkt_unsync │ protocol unsynchronized │
280 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
281 │ 0008 │ TEST4 │ pkt_denied │ access denied │
282 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
283 │ 0010 │ TEST5 │ pkt_auth │ bad authentication │
284 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
285 │ 0020 │ TEST6 │ pkt_stratum │ bad synch or stratum │
286 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
287 │ 0040 │ TEST7 │ pkt_header │ bad header │
288 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
289 │ 0080 │ TEST8 │ pkt_autokey │ bad autokey │
290 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
291 │ 0100 │ TEST9 │ pkt_crypto │ bad crypto │
292 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
293 │ 0200 │ TEST10 │ peer_stratum │ peer bad synch or stratum │
294 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
295 │ 0400 │ TEST11 │ peer_dist │ peer distance exceeded │
296 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
297 │ 0800 │ TEST12 │ peer_loop │ peer synchronization loop │
298 ├─────────┼───────────┼──────────────────┼─────────────────────────────┤
299 │ 1000 │ TEST13 │ peer_unreach │ peer unreachable │
300 └─────────┴───────────┴──────────────────┴─────────────────────────────┘
301
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 ┌───────────────┬──────────────────────────────────┬──────────┬────────┐
311 │ Code │ Description │ │ │
312 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
313 │ ACST │ manycast server │ │ │
314 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
315 │ AUTH │ authentication error │ │ │
316 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
317 │ AUTO │ Autokey sequence error │ │ │
318 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
319 │ BCST │ broadcast server │ │ │
320 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
321 │ CRYPT │ Autokey protocol error │ │ │
322 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
323 │ DENY │ access denied by server │ │ │
324 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
325 │ INIT │ association initialized │ │ │
326 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
327 │ MCST │ multicast server │ │ │
328 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
329 │ RATE │ rate exceeded │ │ │
330 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
331 │ TIME │ association timeout │ │ │
332 ├───────────────┼──────────────────────────────────┼──────────┼────────┤
333 │ STEP │ step time change │ │ │
334 └───────────────┴──────────────────────────────────┴──────────┴────────┘
335
337 These messages are sent to the cryptostats file when an error is
338 detected in the Autokey protocol.
339 ┌───────┬───────────────────┬────────────────────────────────────────┬─┐
342 │Code │Message │ Description │ │
343 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
344 │01 │bad_format │ bad extension field format or length │ │
345 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
346 │02 │bad_timestamp │ bad timestamp │ │
347 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
348 │03 │bad_filestamp │ bad filestamp │ │
349 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
350 │04 │bad_public_key │ bad or missing public key │ │
351 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
352 │05 │bad_digest │ unsupported digest type │ │
353 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
354 │06 │bad_identity │ unsupported identity type │ │
355 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
356 │07 │bad_siglength │ bad signature length │ │
357 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
358 │08 │bad signature │ extension field signature not verified │ │
359 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
360 │09 │cert_not_verified │ certificate signature not verified │ │
361 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
362 │0a │cert_expired │ host certificate expired │ │
363 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
364 │0b │bad_cookie │ bad or missing cookie │ │
365 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
366 │0c │bad_leapseconds │ bad or missing leapseconds values │ │
367 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
368 │0d │cert_missing │ bad or missing certificate │ │
369 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
370 │0e │bad_group_key │ bad or missing group key │ │
371 ├───────┼───────────────────┼────────────────────────────────────────┼─┤
372 │0f │proto_error │ protocol error │ │
373 └───────┴───────────────────┴────────────────────────────────────────┴─┘
374
376 ntpq(8), ntp_mon(5)
377 The official HTML documentation.
379 This file was automatically generated from HTML source.
381 ntp_decode(5)