Mercurial > masqmail
annotate man/masqmail.8 @ 284:4869321aa7bf
recognize the program name `newaliases' too
We still simply exit in this mode, but now we can create a link
called `newaliases' to masqmail instead of needing a script to
call `masqmail -bi'. `ln /bin/true /usr/bin/newaliases' would be
a fancy way too, but letting the MTA handle it is probably the
safer approach.
author | markus schnalke <meillo@marmaro.de> |
---|---|
date | Tue, 07 Dec 2010 17:09:07 -0300 |
parents | 853b85616c98 |
children | bdcc2b42eb0f |
rev | line source |
---|---|
228 | 1 .TH masqmail 8 2010-07-23 masqmail-0.3.0 "Maintenance Commands" |
34 | 2 |
0 | 3 .SH NAME |
4 masqmail \- An offline Mail Transfer Agent | |
34 | 5 |
0 | 6 .SH SYNOPSIS |
34 | 7 \fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR] |
0 | 8 |
34 | 9 \fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR] |
0 | 10 |
34 | 11 \fB/usr/sbin/masqmail \fR[\fB\-bp\fR] |
0 | 12 |
34 | 13 \fB/usr/sbin/masqmail \fR[\fB\-q\fR] |
0 | 14 |
34 | 15 \fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]] |
0 | 16 |
34 | 17 \fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress... |
0 | 18 |
34 | 19 \fB/usr/sbin/mailq\fR |
0 | 20 |
34 | 21 |
0 | 22 .SH DESCRIPTION |
23 | |
34 | 24 Masqmail is a mail server designed for hosts that do not have a permanent internet connection |
25 e.g. a home network or a single host at home. | |
26 It has special support for connections to different ISPs. | |
27 It replaces sendmail or other MTAs such as qmail or exim. | |
28 | |
0 | 29 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
30 .SH OPERATION MODES |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
31 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
32 Masqmail operates in one of several exclusive modes. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
33 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
34 The daemon mode has two flavors that may be, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
35 and usually are, combined: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
36 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
37 .B \-bd |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
38 listen daemon; listens for incoming SMTP connections. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
39 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
40 .B \-q\fRINTERVAL |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
41 queue daemon; processes the queue in a regular interval. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
42 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
43 .P |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
44 The queue processing mode has two flavors that may be combined: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
45 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
46 .BR \-q |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
47 (without argument) |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
48 do a single queue run. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
49 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
50 .B \-qo |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
51 do a single queue run and deliver only using a specific online route. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
52 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
53 .P |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
54 The other modes are simple ones: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
55 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
56 .B \-bi |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
57 a no-op for masqmail, just exit. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
58 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
59 .B \-bm |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
60 accept messages on stdin. (The default) |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
61 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
62 .B \-bp |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
63 print the contents of the queue. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
64 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
65 .B \-bs |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
66 accept messages by speaking SMTP on stdin. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
67 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
68 .B \-bV |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
69 print version information. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
70 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
71 .B \-Mrm |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
72 remove messages from the queue. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
73 .P |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
74 Some of the modes are also available by calling masqmail |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
75 under a special name. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
76 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
77 When no mode had been specified by either one of the above command line |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
78 options or by calling masqmail under a special name, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
79 then the default mode \fB\-bm\fR |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
80 (i.e. accept messages on stdin) is entered. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
81 However, if neither address arguments are specified nor |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
82 \fB\-t\fR is given, then no recipients are available and thus mail can not |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
83 be sent, hence something more useful is done: \fB\-bV\fP is assumed. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
84 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
85 |
0 | 86 .SH OPTIONS |
87 | |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
88 Since masqmail is intended to replace sendmail, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
89 it uses the same command line options, |
34 | 90 but not all are implemented. |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
91 The \fB\-qo\fP option is additional, and unique to masqmail. |
0 | 92 |
34 | 93 .TP |
94 \fB\-\-\fR | |
0 | 95 |
34 | 96 Not a `real' option, it means that all following arguments are to be understood |
97 as arguments and not as options even if they begin with a leading dash `\-'. | |
98 Mutt is known to call sendmail with this option. | |
0 | 99 |
100 .TP | |
34 | 101 \fB\-bd\fR |
0 | 102 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
103 Run as daemon, accepting connections, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
104 usually on port 25 if not configured differently. |
34 | 105 This is usually used in the startup script at system boot and together with |
106 the \fB\-q\fR option (see below). | |
0 | 107 |
34 | 108 .TP |
109 \fB\-bi\fR | |
110 | |
111 Old sendmail rebuilds its alias database when invoked with this option. | |
112 Masqmail reads directly from the file given with `alias_file' in the config file. | |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
113 Hence masqmail simply exits in this mode. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
114 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
115 .TP |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
116 .B \-bm |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
117 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
118 Accept a text message on stdin. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
119 This is the default mode of operation. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
120 One will hardly use this switch as it is the default. |
34 | 121 |
0 | 122 .TP |
34 | 123 \fB\-bp\fR |
0 | 124 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
125 Show the messages in the queue. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
126 Same as calling masqmail as `mailq'. |
0 | 127 |
128 .TP | |
34 | 129 \fB\-bs\fR |
0 | 130 |
34 | 131 Accept SMTP commands from stdin. |
132 Some mailers (e.g. pine) use this option as an interface. | |
133 It can also be used to call masqmail from inetd. | |
0 | 134 |
135 .TP | |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
136 \fB\-bV \fR |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
137 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
138 Show version information, then exit. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
139 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
140 .TP |
34 | 141 \fB\-B \fIarg\fR |
0 | 142 |
34 | 143 \fIarg\fR is usually 8BITMIME. |
144 Some mailers use this to indicate that the message contains characters > 127. | |
145 Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, | |
146 which is very painful ;-). | |
147 Note though that this violates some conventions: | |
148 masqmail does not convert 8 bit messages to any MIME format if it encounters | |
149 a mail server which does not advertise its 8BITMIME capability, | |
150 masqmail does not advertise this itself. | |
151 This is the same practice as that of exim (but different to sendmail). | |
152 | |
0 | 153 .TP |
34 | 154 \fB\-C \fIfilename\fR |
0 | 155 |
34 | 156 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR. |
157 Useful for debugging purposes. | |
158 If not invoked by a privileged user, masqmail will drop all privileges. | |
0 | 159 |
34 | 160 .TP |
161 \fB\-d \fInumber\fR | |
0 | 162 |
34 | 163 Set the debug level. |
164 This takes precedence before the value of `debug_level' in the configuration file. | |
165 Read the warning in the description of the latter. | |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
166 Only root may set the debug level. |
34 | 167 |
0 | 168 .TP |
34 | 169 \fB\-f [\fIaddress\fB]\fR |
0 | 170 |
34 | 171 Set the return path address to \fIaddress\fR. |
172 Only root, the user mail and anyone in group mail is allowed to do that. | |
0 | 173 |
34 | 174 .TP |
175 \fB\-F [\fIstring\fB]\fR | |
0 | 176 |
34 | 177 Set the full sender name (in the From: header) to \fIstring\fR. |
0 | 178 |
179 .TP | |
34 | 180 \fB\-i\fR |
0 | 181 |
34 | 182 Same as \fB\-oi\fR, see below. |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
183 Kept for compatibility. |
34 | 184 |
0 | 185 .TP |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
186 \fB\-Mrm \fImsgid...\fR |
0 | 187 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
188 ``Queue manipulation mode'' |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
189 |
34 | 190 Remove given messages from the queue. |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
191 Privileged users may remove any message, other users only their own. |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
192 The message identifiers are listed in the output of |
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
193 \fImasqmail \-bp\fP (aka. \fImailq\fR). |
34 | 194 |
195 .TP | |
247 | 196 \fB\-m\fR |
197 | |
258
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
198 ``Me too'' |
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
199 This switch is ignored as, |
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
200 masqmail never excludes the sender from any alias expansions. |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
201 |
258
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
202 \fB\-m\fP is an ancient alias for \fB\-om\fP. |
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
203 Kept for compatibility. |
34 | 204 |
0 | 205 .TP |
34 | 206 \fB\-odb\fR |
0 | 207 |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
208 ``Deliver in Background'' |
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
209 Masqmail always does this. |
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
210 Hence masqmail ignores this switch. |
34 | 211 |
0 | 212 .TP |
34 | 213 \fB\-odq\fR |
0 | 214 |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
215 ``Do Queueing'' |
34 | 216 Do not attempt to deliver immediately. |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
217 Any messages will be queued until the next queue running process picks them |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
218 up and delivers them. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
219 You get the same effect by setting the do_queue option in |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
220 /etc/masqmail/masqmail.conf. |
34 | 221 |
0 | 222 .TP |
34 | 223 \fB\-oi\fR |
0 | 224 |
225 A dot as a single character in a line does not terminate the message. | |
34 | 226 |
258
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
227 The same as \fB\-i\fP. |
247 | 228 |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
229 .TP |
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
230 \fB\-oXXX\fR |
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
231 |
258
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
232 Any other switch starting with `\-o' is ignored. |
05fa719b7002
fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents:
252
diff
changeset
|
233 This especially affects \-om, \-oem, \-oee. |
247 | 234 |
235 .TP | |
34 | 236 \fB\-q [\fIinterval\fB]\fR |
0 | 237 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
238 Without argument: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
239 Do a single queue run, i.e. try to deliver all messages in the queue. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
240 Masqmail sends to addresses on the local host, on the local net, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
241 and if it detects an online connection, to remote ones too. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
242 That means, that masqmail sends any queued mail it can. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
243 .B \-q |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
244 includes |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
245 .B \-qo |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
246 (without argument). |
0 | 247 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
248 With an argument: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
249 Start as a daemon and do a queue run automatically once in the specified |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
250 time interval. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
251 This is usually used together with \fB\-bd\fR (see above). |
0 | 252 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
253 An argument may be a time interval i.e. a numerical value followed by one |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
254 of the letters s,m,h,d,w which are interpreted as |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
255 seconds, minutes, hours, days or weeks respectively. |
34 | 256 Example: \fB\-q30m\fR. |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
257 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
258 Running masqmail from inetd and starting single queue runs from cron |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
259 mimics the same effect as starting masqmail with something like |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
260 \fB\-bd \-q30m\fR. |
34 | 261 |
0 | 262 .TP |
34 | 263 \fB\-qo [\fIname\fB]\fR |
0 | 264 |
283
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
265 Online queue runs. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
266 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
267 Without a connection name: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
268 Determine the online status with the configured method |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
269 (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR) |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
270 and, if a connection is available, send remote mail over it. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
271 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
272 With a connection name: |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
273 Send remote mail over the specified connection, |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
274 no online detection is made. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
275 |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
276 The specified route configuration is read and queued mail to remote |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
277 recipients will be sent. |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
278 The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR). |
853b85616c98
improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents:
276
diff
changeset
|
279 |
34 | 280 Use this option in your script which starts as soon as a link to the internet |
281 has been set up (usually ip-up). | |
282 | |
0 | 283 .TP |
34 | 284 \fB\-t\fR |
0 | 285 |
276
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
286 Read recipients from mail headers and add them to the ones specified on the |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
287 command line. |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
288 (Only To:, Cc:, and Bcc: headers are regarded.) |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
289 |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
290 .B WARNING: The behavior changed with version 0.3.1! |
103
c85fbf7014b1
improved man page in respect to the -t option
meillo@marmaro.de
parents:
99
diff
changeset
|
291 |
276
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
292 In earlier versions command line argument addresses were ``substracted'' |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
293 from header addresses. |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
294 |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
295 The old behavior was similar to exim's and smail's |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
296 (which are anchesters of masqmail). |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
297 The new behavior is similar to the one of current postfix versions, |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
298 which add the arguments to the set of header recipients. |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
299 (Earlier postfix failed in case of address arguments with \-t.) |
103
c85fbf7014b1
improved man page in respect to the -t option
meillo@marmaro.de
parents:
99
diff
changeset
|
300 Sendmail seems to behave differently, depending on the version. |
c85fbf7014b1
improved man page in respect to the -t option
meillo@marmaro.de
parents:
99
diff
changeset
|
301 See exim(8) for further information. |
0 | 302 |
276
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
303 For masqmail the most simple approach had been taken. |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
304 |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
305 As the behavior of \-t together with command line address arguments |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
306 differs among MTAs, one better not steps into this corner case. |
1abc1faeb45d
for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents:
259
diff
changeset
|
307 |
34 | 308 .TP |
309 \fB\-v\fR | |
0 | 310 |
252
1b25fabdc3cb
improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents:
247
diff
changeset
|
311 ``Verbose'' |
34 | 312 Log also to stdout. |
313 Currently, some log messages are marked as `write to stdout' and additionally, | |
314 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout | |
315 if this option is given. It is disabled in daemon mode. | |
316 | |
317 | |
0 | 318 .SH ENVIRONMENT FOR PIPES AND MDAS |
319 | |
34 | 320 For security reasons, before any pipe command from an alias expansion or an mda is called, |
321 the environment variables will be completely discarded and newly set up. These are: | |
0 | 322 |
34 | 323 SENDER, RETURN_PATH \(en the return path. |
0 | 324 |
34 | 325 SENDER_DOMAIN \(en the domain part of the return path. |
326 | |
327 SENDER_LOCAL \(en the local part of the return path. | |
0 | 328 |
34 | 329 RECEIVED_HOST \(en the host the message was received from (unless local). |
0 | 330 |
34 | 331 LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient. |
0 | 332 |
34 | 333 MESSAGE_ID \(en the unique message id. |
334 This is not necessarily identical with the Message ID as given in the Message ID: header. | |
0 | 335 |
34 | 336 QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses. |
337 | |
0 | 338 |
339 .SH FILES | |
340 | |
34 | 341 \fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail. |
342 Depending on the settings in this file, you will also have other configuration | |
343 files in \fI/etc/masqmail/\fR. | |
0 | 344 |
34 | 345 \fI/var/spool/masqmail/\fR is the spool directory where masqmail stores |
192 | 346 its spooled messages. |
0 | 347 |
34 | 348 \fI/var/spool/mail/\fR is the directory where locally delivered mail will be put, |
349 if not configured differently in \fImasqmail.conf\fR. | |
0 | 350 |
34 | 351 \fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages. |
352 This can also be somewhere else if configured differently by your sysadmin or the package mantainer. | |
353 | |
0 | 354 |
355 .SH CONFORMING TO | |
356 | |
357 RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP) | |
358 | |
359 RFC 1321 (MD5) | |
360 | |
361 RFC 2195 (CRAM-MD5) | |
362 | |
34 | 363 |
0 | 364 .SH AUTHOR |
365 | |
34 | 366 Masqmail was written by Oliver Kurth. |
367 It is now maintained by Markus Schnalke <meillo@marmaro.de>. | |
0 | 368 |
95
e01fed4846e4
masqmail's homepage moved prog.marmaro.de/masqmail -> marmaro.de/prog/masqmail
meillo@marmaro.de
parents:
57
diff
changeset
|
369 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR. |
26
607221b0dac1
added myself as maintainer; updated URL of the website
meillo@marmaro.de
parents:
16
diff
changeset
|
370 There is also a mailing list, you will find information about it at masqmail's main site. |
0 | 371 |
34 | 372 |
0 | 373 .SH BUGS |
374 | |
34 | 375 Please report them to the mailing list. |
376 | |
0 | 377 |
378 .SH SEE ALSO | |
379 | |
192 | 380 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.aliases(5)\fR |