Commit | Line | Data |
---|---|---|
2117e02e MW |
1 | .TH qmail-start 8 |
2 | .SH NAME | |
3 | qmail-start \- turn on mail delivery | |
4 | .SH SYNOPSIS | |
5 | .B qmail-start | |
6 | [ | |
212b6f5d | 7 | .I defaultdelivery |
2117e02e MW |
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 | |
212b6f5d MW |
19 | .BR qmail-clean , |
20 | under the proper uids and gids. | |
2117e02e MW |
21 | These four daemons cooperate to deliver messages from the queue. |
22 | ||
23 | .B qmail-start | |
24 | arranges for | |
25 | .BR qmail-send 's | |
26 | activity record to be sent to | |
27 | .BR qmail-start 's | |
28 | output. | |
29 | See | |
30 | .B qmail-log(5) | |
31 | for the format of the activity record. | |
32 | Other than this, | |
33 | .B qmail-start | |
34 | does not print anything, even on failure. | |
35 | ||
36 | If | |
212b6f5d | 37 | .I defaultdelivery |
2117e02e MW |
38 | is supplied, |
39 | .B qmail-start | |
40 | passes it to | |
41 | .BR qmail-lspawn . | |
42 | ||
43 | If | |
44 | .I logger | |
45 | is supplied, | |
46 | .B qmail-start | |
47 | invokes | |
48 | .I logger | |
49 | with the given arguments, | |
50 | and feeds | |
51 | .BR qmail-send 's | |
52 | activity record through | |
53 | .IR logger . | |
54 | ||
55 | Environment variables given to | |
56 | .B qmail-start | |
57 | will eventually be passed on to | |
58 | .BR qmail-local , | |
59 | so make sure to clean up the environment if you run | |
60 | .B qmail-start | |
61 | manually: | |
62 | ||
63 | .EX | |
64 | # env - PATH="QMAILHOME/bin:$PATH" | |
65 | .br | |
66 | qmail-start ./Mailbox splogger qmail & | |
67 | .br | |
68 | (all on one line) | |
69 | .EE | |
70 | ||
212b6f5d | 71 | Resource limits, controlling ttys, et al. are also passed from |
2117e02e | 72 | .B qmail-start |
212b6f5d MW |
73 | to |
74 | .BR qmail-local . | |
2117e02e MW |
75 | |
76 | Note that | |
77 | .B qmail-send | |
78 | normally juggles several simultaneous deliveries. | |
79 | To reduce | |
80 | .BR qmail-send 's | |
81 | impact on other programs, | |
82 | you can run | |
83 | .B qmail-start | |
84 | with a low priority. | |
85 | .SH "SEE ALSO" | |
86 | logger(1), | |
87 | splogger(1), | |
88 | nice(1), | |
89 | qmail-log(5), | |
90 | qmail-local(8), | |
91 | qmail-clean(8), | |
92 | qmail-lspawn(8), | |
93 | qmail-rspawn(8), | |
94 | qmail-send(8) |