option-tester: Add many changes
[ntpsec.git] / docs / msyslog.adoc
blobebd90168b2563dde6e8ad96aa3388c0d508a07d2
1 = ntpd System Log Messages
2 include::include-html.ad[]
4 [cols="10%,90%",frame="none",grid="none",style="verse"]
5 |==============================
6 |image:pic/flatheads.gif[]|
7 {millshome}pictures.html[from
8 'Alice's Adventures in Wonderland', Lewis Carroll]
10 The log can be shrill at times.
12 |==============================
14 == Related Links
16 include::includes/install.adoc[]
18 '''''
20 You have come here because you found a cryptic message in the system
21 log. This page by no means lists all messages that might be found, since
22 new ones come and old ones go. Generally, however, the most common ones
23 will be found here. They are listed by program module and log severity
24 code in bold: *+LOG_ERR+*, *+LOG_NOTICE+* and *+LOG_INFO+*.
26 Most of the time *+LOG_ERR+* messages are fatal, but often +ntpd+ limps
27 onward in the hopes of discovering more errors. The *+LOG_NOTICE+*
28 messages usually mean the time has changed or some other condition that
29 probably should be noticed. The *+LOG_INFO+* messages usually say
30 something about the system operations, but do not affect the time.
32 In the following a \'?' character stands for text in the message. The
33 meaning should be clear from context.
35 == Protocol Module
37 === LOG_ERR
39 +buffer overflow ?+::
40   Fatal error. An input packet is too long for processing.
42 === LOG_NOTICE
44 +no reply; clock not set+::
45   No servers have been found. The server(s) and/or
46   network may be down. Standard debugging procedures apply.
48 === LOG_INFO
50 +proto_config: illegal item ?, value ?+::
51   Program error. Bugs can be reported link:bugs.html[here].
52 +receive: server server maximum rate exceeded+::
53   A kiss-o'death packet has been received. The transmit rate is
54   automatically reduced.
55 +pps sync enabled+::
56   The PPS signal has been detected and enabled.
57 +transmit: encryption key ? not found+::
58   The encryption key is not defined or not trusted.
59 +precision = ? usec+::
60   This reports the precision measured for this machine.
61 +using 10ms tick adjustments+::
62   Gotcha for some machines with dirty rotten clock hardware.
63 +no servers reachable+::
64   The system clock is running on internal batteries. The server(s)
65   and/or network may be down.
67 == Clock Discipline Module
69 === LOG_ERR
71 +time correction of ? seconds exceeds sanity limit (?); set clock manually to the correct UTC time+. ::
72    Fatal error. Better do what it says, then restart the daemon. Be advised
73    NTP and Unix know nothing about local time zones. The clock must be set
74    to Coordinated Universal Time (UTC). Believe it; by international
75    agreement abbreviations are in French and descriptions are in English.
77 +sigaction() fails to save SIGSYS trap: ?+::
78 +sigaction() fails to restore SIGSYS trap: ?+::
79     Program error. Bugs can be reported link:bugs.html[here].::
82 === LOG_NOTICE
84 +frequency error ? exceeds tolerance 500 PPM+::
85   The hardware clock frequency error exceeds the rate the kernel can
86   correct. This could be a hardware or a kernel problem.
87 +time slew ? s+::
88   The time error exceeds the step threshold and is being slewed to the
89   correct time. You may have to wait a very long time.
90 +time reset ? s+::
91   The time error exceeds the step threshold and has been reset to the
92   correct time. Computer scientists don't like this, but they can set
93   the +ntpd -x+ option and wait forever.
94 +kernel time sync disabled ?+::
95   The kernel reports an error. See the codes in the +timex.h+ file.
96 +pps sync disabled+::
97   The PPS signal has died, probably due to a dead radio, broken wire or
98   loose connector.
100 === LOG_INFO
102 +kernel time sync status ?+::
103   For information only. See the codes in the +timex.h+ file.
106 '''''
108 include::includes/footer.adoc[]