summaryrefslogtreecommitdiff
path: root/man/qmail-qmaint.8
blob: 64694a9de065097a4e7080fcecbf7d94fa37bb16 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
.TH s/qmail: qmail-qmaint 8
.SH NAME
qmail-qmaint \- queue maintenance
.SH SYNOPSIS
.B qmail-qmaint 
[
.I -i
]
|
[
.I -d messid 
]
[
.I -D
]
.SH DESCRIPTION
.B qmail-qmaint
inspects 
.B s/qmail's
queue and validates its consistancy.
In 
.I -i 
interactive mode, individual fixes 
can be commanded.
Queue maintanence also allows to remove
particular messages from the queue referencing their
.I messid 
as given by
.B qmail-qread
(without the leading pound sign '#') by means of
.IR -d\ messid .
Here, only pre-processed and bounce messages are taken
into consideration.

Giving
.I -D
advices a bulk removal of remnat pre- or post-processed 
DKIM files in the staging area.

.B qmail-qmaint
must be run either as root or with user id 
.I qmails 
and group id 
.IR sqmail .
.SH "WARNING"
It is strongly advised to use
.B qmail-qmaint 
only in case 
.B qmail-send
was shut down before. Queue inspection on a `sane` queue
is however none-destructive.
.SH "EXIT CODES"
.B qmail-qmaint
unlike
.B qmail-queue
prints diagnostics messages.
It exits
0 if
it has successfully inspected the queue
or the message has been deleted.
It may exit 
.I 99 
in case of a warning, or
.I 100 
if an operation can not be completed, or
.I 110 
if a directory can not be accessed.
.SH "SEE ALSO"
qmail-qstat(8),
qmail-qread(8),
qmail-send(8),
qmail-queue(9)
.SH "CREDITS"
.B qmail-qmaint
is based on the program 'queue-fix' 
written be Eric Huss.