Upstream qmail 1.01
[qmail] / qmail-log.5
CommitLineData
2117e02e
MW
1.TH qmail-log 5
2.SH NAME
3qmail-log \- the qmail activity record
4.SH DESCRIPTION
5.B qmail-send
6prints a series of lines describing its activities.
7Each possible line is described below.
8.SH "STARTING AND STOPPING"
9.TP
10.B running
11.B qmail-send
12is ready to deliver messages.
13.TP
14.B local deliveries will be put on hold
15The local concurrency limit is 0, so
16.B qmail-send
17will not perform any local deliveries.
18.TP
19.B remote deliveries will be put on hold
20The remote concurrency limit is 0, so
21.B qmail-send
22will not perform any remote deliveries.
23.TP
24.B number of deliveries left before exiting: ...
25.B qmail-send
26wants to exit as soon as possible,
27usually because it was sent a
28TERM signal,
29but it has to wait for some deliveries to finish.
30It will not start any new deliveries.
31.TP
32.B exiting
33.B qmail-send
34is done.
35.SH "FATAL PROBLEMS"
36.TP
37.B alert: cannot start: ...
38.B qmail-send
39is unable to prepare itself for delivering messages;
40it is giving up.
41This normally indicates a serious configuration error,
42but it can be caused by a temporary lack of resources.
43.TP
44.B alert: oh no! lost ...
45One of the other daemons has died.
46.B qmail-send
47will exit as soon as possible.
48.SH "SERIOUS PROBLEMS"
49.TP
50.B alert: unable to append to bounce message...
51.B qmail-send
52is unable to record a permanent failure,
53usually because the disk is full.
54This is a very serious problem;
55.B qmail-send
56cannot proceed without recording the results.
57It will try again in ten seconds.
58.TP
59.B alert: out of memory...
60.B qmail-send
61tried to allocate more memory and failed.
62It will try again in ten seconds.
63.TP
64.B alert: unable to opendir...
65.B qmail-send
66is having trouble reading a file list from disk,
67usually because the system's file descriptor table is full,
68but possibly because permissions are set incorrectly.
69It will try again in ten seconds.
70.TP
71.B alert: unable to switch back...
72.B qmail-send
73was sent SIGHUP,
74and it is unable to reenter the queue directory.
75This is a very serious problem;
76.B qmail-send
77cannot proceed outside the queue directory.
78It will try again in ten seconds.
79.TP
80.B alert: unable to reread...
81.B qmail-send
82was sent SIGHUP,
83but it is unable to read the new controls.
84It will continue operating with the original controls.
85.SH "MESSAGES"
86.TP
87.B new msg \fIm\fB
88.B qmail-send
89is going to preprocess a queued message.
90The message number,
91.IR m ,
92is its disk inode number.
93After a message is removed from the queue,
94its number can be reused immediately.
95.TP
96.B info msg \fIm\fB: bytes \fIb\fB from <\fIs\fB> qp \fIq\fB uid \fIu\fB
97Message
98.I m
99contains
100.I b
101bytes;
102its envelope sender is
103.IR s ;
104it was queued by a user with user ID
105.IR u .
106.I q
107is a long-term queue identifier,
108the process ID of the
109.B qmail-queue
110that queued the message.
111.TP
112.B bounce msg \fIm\fB qp \fIq\fB
113Message
114.I m
115had some delivery failures.
116The long-term queue identifier of the bounce (or double-bounce) message
117is
118.IR q .
119.TP
120.B triple bounce: discarding ...
121Message
122.I m
123had some delivery failures,
124but it is already a double-bounce message,
125so it must be thrown away.
126Triple-bounce messages do not exist.
127.TP
128.B end msg \fIm\fB
129.B qmail-send
130is about to remove
131message
132.I m
133from the queue.
134.SH "DELIVERIES"
135.TP
136.B starting delivery \fId\fB: msg \fIm\fB to ...
137.B qmail-send
138is telling
139.B qmail-lspawn
140or
141.B qmail-rspawn
142to deliver message
143.I m
144to one recipient.
145The delivery number,
146.IR d ,
147starts at 1 and increases by 1 for each new delivery.
148.TP
149.B delivery \fId\fB: success: ...
150Delivery
151.I d
152was successful.
153.TP
154.B delivery \fId\fB: failure: ...
155Delivery
156.I d
157failed permanently.
158The message will bounce.
159.TP
160.B delivery \fId\fB: deferral: ...
161Delivery
162.I d
163failed temporarily.
164This recipient will be retried later.
165.TP
166.B delivery \fId\fB: report mangled, will defer
167There is a serious bug in
168.B qmail-lspawn
169or
170.BR qmail-rspawn .
171This recipient will be retried later.
172.SH "WARNINGS"
173.TP
174.B internal error: delivery report out of range
175.B qmail-lspawn
176or
177.B qmail-rspawn
178has supplied a report on a nonexistent delivery.
179This is a serious bug.
180.TP
181.B qmail-clean unable to clean up ...
182For some reason
183.B qmail-clean
184is unable to remove the indicated file.
185It will try again later.
186.TP
187.B trouble fsyncing ...
188.B qmail-send
189was unable to write to disk the results of preprocessing a queued message.
190It will try again later.
191.TP
192.B trouble in select
193There is an operating system bug.
194.TP
195.B trouble injecting bounce message...
196.B qmail-send
197was unable to queue a bounce message,
198usually because the disk is full.
199It will try again later.
200.TP
201.B trouble marking ...
202.B qmail-send
203was unable to record the result of a successful or permanently
204unsuccessful delivery.
205This means that the delivery will be tried again later.
206.TP
207.B trouble opening ...
208.B qmail-send
209was unable to open the list of local or remote recipients
210for a message.
211It will try again later.
212.TP
213.B trouble reading ...
214Either
215.B qmail-send
216is unable to read a recipient list,
217or it is unable to read the envelope of a queued
218message, or it is out of memory.
219Whatever it was doing, it will try again later.
220.TP
221.B trouble writing to ...
222.B qmail-send
223was unable to preprocess a queued message,
224usually because the disk is full.
225It will try again later.
226.TP
227.B unable to create ...
228.B qmail-send
229was unable to preprocess a queued message,
230usually because the disk is out of inodes.
231It will try again later.
232.TP
233.B unable to open ...
234.B qmail-send
235is unable to read the envelope of a queued message
236for preprocessing.
237It will try again later.
238.TP
239.B unable to start qmail-queue...
240.B qmail-send
241is unable to queue a bounce message,
242usually because the machine is almost out of memory.
243It will try again later.
244.TP
245.B unable to stat ...
246.B qmail-send
247is unable to obtain information about a file that should exist.
248It will try again later.
249.TP
250.B unable to unlink ...
251.B qmail-send
252is unable to remove a file.
253It will try again later.
254.TP
255.B unable to utime ...
256.B qmail-send
257is about to exit,
258and it is unable to record on disk
259the next scheduled delivery time for a message.
260The message will be retried as soon as
261.B qmail-send
262is restarted.
263.TP
264.B unknown record type in ...
265There is a serious bug in either
266.B qmail-queue
267or
268.BR qmail-send .
269.SH "SEE ALSO"
270qmail-send(8)