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