Upstream qmail 1.01
[qmail] / qmail-start.9
1 .TH qmail-start 8
2 .SH NAME
3 qmail-start \- turn on mail delivery
4 .SH SYNOPSIS
5 .B qmail-start
6 [
7 .I aliasempty
8 [
9 .I logger arg ...
10 ]
11 ]
12 .SH DESCRIPTION
13 .B qmail-start
14 invokes
15 .BR qmail-send ,
16 .BR qmail-lspawn ,
17 .BR qmail-rspawn ,
18 and
19 .BR qmail-clean .
20 These four daemons cooperate to deliver messages from the queue.
21
22 .B qmail-start
23 arranges for
24 .BR qmail-send 's
25 activity record to be sent to
26 .BR qmail-start 's
27 output.
28 See
29 .B qmail-log(5)
30 for the format of the activity record.
31 Other than this,
32 .B qmail-start
33 does not print anything, even on failure.
34
35 If
36 .I aliasempty
37 is supplied,
38 .B qmail-start
39 passes it to
40 .BR qmail-lspawn .
41
42 If
43 .I logger
44 is supplied,
45 .B qmail-start
46 invokes
47 .I logger
48 with the given arguments,
49 and feeds
50 .BR qmail-send 's
51 activity record through
52 .IR logger .
53
54 Environment variables given to
55 .B qmail-start
56 will eventually be passed on to
57 .BR qmail-local ,
58 so make sure to clean up the environment if you run
59 .B qmail-start
60 manually:
61
62 .EX
63 # env - PATH="QMAILHOME/bin:$PATH"
64 .br
65 qmail-start ./Mailbox splogger qmail &
66 .br
67 (all on one line)
68 .EE
69
70 .B qmail-start
71 sets the uid and gid of each daemon properly.
72
73 Note that
74 .B qmail-send
75 normally juggles several simultaneous deliveries.
76 To reduce
77 .BR qmail-send 's
78 impact on other programs,
79 you can run
80 .B qmail-start
81 with a low priority.
82 .SH "SEE ALSO"
83 logger(1),
84 splogger(1),
85 nice(1),
86 qmail-log(5),
87 qmail-local(8),
88 qmail-clean(8),
89 qmail-lspawn(8),
90 qmail-rspawn(8),
91 qmail-send(8)