| rev |
line source |
|
meillo@142
|
1 .TH masqmail 8 2010-07-06 masqmail-0.2.25 "Maintenance Commands"
|
|
meillo@34
|
2
|
|
meillo@0
|
3 .SH NAME
|
|
meillo@0
|
4 masqmail \- An offline Mail Transfer Agent
|
|
meillo@34
|
5
|
|
meillo@0
|
6 .SH SYNOPSIS
|
|
meillo@34
|
7 \fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR]
|
|
meillo@0
|
8
|
|
meillo@34
|
9 \fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR]
|
|
meillo@0
|
10
|
|
meillo@34
|
11 \fB/usr/sbin/masqmail \fR[\fB\-bp\fR]
|
|
meillo@0
|
12
|
|
meillo@34
|
13 \fB/usr/sbin/masqmail \fR[\fB\-q\fR]
|
|
meillo@0
|
14
|
|
meillo@34
|
15 \fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]]
|
|
meillo@0
|
16
|
|
meillo@34
|
17 \fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-g \fR[\fIname\fR]]
|
|
meillo@0
|
18
|
|
meillo@34
|
19 \fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-go \fR[\fIname\fR]]
|
|
meillo@0
|
20
|
|
meillo@34
|
21 \fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress...
|
|
meillo@0
|
22
|
|
meillo@34
|
23 \fB/usr/sbin/mailq\fR
|
|
meillo@0
|
24
|
|
meillo@34
|
25
|
|
meillo@0
|
26 .SH DESCRIPTION
|
|
meillo@0
|
27
|
|
meillo@34
|
28 Masqmail is a mail server designed for hosts that do not have a permanent internet connection
|
|
meillo@34
|
29 e.g. a home network or a single host at home.
|
|
meillo@34
|
30 It has special support for connections to different ISPs.
|
|
meillo@34
|
31 It replaces sendmail or other MTAs such as qmail or exim.
|
|
meillo@174
|
32 It can also act as a POP3 client (if this functionality has not been disabled at
|
|
meillo@174
|
33 build configuration time).
|
|
meillo@34
|
34
|
|
meillo@0
|
35
|
|
meillo@0
|
36 .SH OPTIONS
|
|
meillo@0
|
37
|
|
meillo@34
|
38 Since masqmail is intended to replace sendmail, it uses the same command line options,
|
|
meillo@34
|
39 but not all are implemented.
|
|
meillo@34
|
40 There are also two additional options, which are unique to masqmail
|
|
meillo@34
|
41 (\fB\-qo \fIconnection\fR and \fB\-g\fR)
|
|
meillo@34
|
42
|
|
meillo@0
|
43 .TP
|
|
meillo@34
|
44 \fB\-\-\fR
|
|
meillo@0
|
45
|
|
meillo@34
|
46 Not a `real' option, it means that all following arguments are to be understood
|
|
meillo@34
|
47 as arguments and not as options even if they begin with a leading dash `\-'.
|
|
meillo@34
|
48 Mutt is known to call sendmail with this option.
|
|
meillo@0
|
49
|
|
meillo@0
|
50 .TP
|
|
meillo@34
|
51 \fB\-bd\fR
|
|
meillo@0
|
52
|
|
meillo@34
|
53 Run as daemon, accepting connections, usually on port 25 if not configured differently.
|
|
meillo@34
|
54 This is usually used in the startup script at system boot and together with
|
|
meillo@34
|
55 the \fB\-q\fR option (see below).
|
|
meillo@0
|
56
|
|
meillo@0
|
57 .TP
|
|
meillo@34
|
58 \fB\-bi\fR
|
|
meillo@0
|
59
|
|
meillo@34
|
60 Old sendmail rebuilds its alias database when invoked with this option.
|
|
meillo@34
|
61 Masqmail ignores it.
|
|
meillo@34
|
62 Masqmail reads directly from the file given with `alias_file' in the config file.
|
|
meillo@0
|
63
|
|
meillo@0
|
64 .TP
|
|
meillo@34
|
65 \fB\-bp\fR
|
|
meillo@0
|
66
|
|
meillo@34
|
67 Show the messages in the queue. Same as calling masqmail as `mailq'.
|
|
meillo@0
|
68
|
|
meillo@0
|
69 .TP
|
|
meillo@34
|
70 \fB\-bs\fR
|
|
meillo@0
|
71
|
|
meillo@34
|
72 Accept SMTP commands from stdin.
|
|
meillo@34
|
73 Some mailers (e.g. pine) use this option as an interface.
|
|
meillo@34
|
74 It can also be used to call masqmail from inetd.
|
|
meillo@0
|
75
|
|
meillo@0
|
76 .TP
|
|
meillo@34
|
77 \fB\-B \fIarg\fR
|
|
meillo@0
|
78
|
|
meillo@34
|
79 \fIarg\fR is usually 8BITMIME.
|
|
meillo@34
|
80 Some mailers use this to indicate that the message contains characters > 127.
|
|
meillo@34
|
81 Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm,
|
|
meillo@34
|
82 which is very painful ;-).
|
|
meillo@34
|
83 Note though that this violates some conventions:
|
|
meillo@34
|
84 masqmail does not convert 8 bit messages to any MIME format if it encounters
|
|
meillo@34
|
85 a mail server which does not advertise its 8BITMIME capability,
|
|
meillo@34
|
86 masqmail does not advertise this itself.
|
|
meillo@34
|
87 This is the same practice as that of exim (but different to sendmail).
|
|
meillo@0
|
88
|
|
meillo@0
|
89 .TP
|
|
meillo@34
|
90 \fB\-bV \fR
|
|
meillo@0
|
91
|
|
meillo@0
|
92 Show version information.
|
|
meillo@34
|
93
|
|
meillo@0
|
94 .TP
|
|
meillo@34
|
95 \fB\-C \fIfilename\fR
|
|
meillo@0
|
96
|
|
meillo@34
|
97 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
|
|
meillo@34
|
98 Useful for debugging purposes.
|
|
meillo@34
|
99 If not invoked by a privileged user, masqmail will drop all privileges.
|
|
meillo@0
|
100
|
|
meillo@0
|
101 .TP
|
|
meillo@34
|
102 \fB\-d \fInumber\fR
|
|
meillo@0
|
103
|
|
meillo@34
|
104 Set the debug level.
|
|
meillo@34
|
105 This takes precedence before the value of `debug_level' in the configuration file.
|
|
meillo@34
|
106 Read the warning in the description of the latter.
|
|
meillo@0
|
107
|
|
meillo@0
|
108 .TP
|
|
meillo@34
|
109 \fB\-f [\fIaddress\fB]\fR
|
|
meillo@0
|
110
|
|
meillo@34
|
111 Set the return path address to \fIaddress\fR.
|
|
meillo@34
|
112 Only root, the user mail and anyone in group mail is allowed to do that.
|
|
meillo@0
|
113
|
|
meillo@0
|
114 .TP
|
|
meillo@34
|
115 \fB\-F [\fIstring\fB]\fR
|
|
meillo@0
|
116
|
|
meillo@34
|
117 Set the full sender name (in the From: header) to \fIstring\fR.
|
|
meillo@0
|
118
|
|
meillo@0
|
119 .TP
|
|
meillo@34
|
120 \fB\-g [\fIname\fB]\fR
|
|
meillo@0
|
121
|
|
meillo@34
|
122 Get mail (using pop3 or apop),
|
|
meillo@34
|
123 using the configurations given with get.\fIname\fR in the main configuration.
|
|
meillo@34
|
124 Without \fIname\fR, all get configurations will be used.
|
|
meillo@34
|
125 See also \fBmasqmail.get(5)\fR
|
|
meillo@0
|
126
|
|
meillo@0
|
127 .TP
|
|
meillo@34
|
128 \fB\-go [\fIinterval\fB] [\fIname\fB]\fR
|
|
meillo@0
|
129
|
|
meillo@34
|
130 Can be followed by a connection name.
|
|
meillo@34
|
131 Use this option in your script which starts as soon as a link to the internet
|
|
meillo@34
|
132 has been set up (usually ip-up).
|
|
meillo@34
|
133 When masqmail is called with this option, the specified get configuration(s)
|
|
meillo@34
|
134 is(are) read and mail will be retrieved from servers on the internet.
|
|
meillo@34
|
135 The \fIname\fR is defined in the configuration (see \fBonline_gets.\fIname\fR).
|
|
meillo@0
|
136
|
|
meillo@34
|
137 If called with an interval option (recognized by a digit as the first characater),
|
|
meillo@34
|
138 masqmail starts as a daemon and tries to get mail in these intervals.
|
|
meillo@34
|
139 It checks for the online status first.
|
|
meillo@34
|
140 Example: `masqmail \-go 5m' will retrieve mail every five minutes.
|
|
meillo@0
|
141
|
|
meillo@174
|
142 If called without \fIname\fR, the online status is determined with the configured method
|
|
meillo@34
|
143 (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR).
|
|
meillo@0
|
144
|
|
meillo@0
|
145 .TP
|
|
meillo@34
|
146 \fB\-i\fR
|
|
meillo@0
|
147
|
|
meillo@34
|
148 Same as \fB\-oi\fR, see below.
|
|
meillo@0
|
149
|
|
meillo@0
|
150 .TP
|
|
meillo@34
|
151 \fB\-Mrm \fIlist\fR
|
|
meillo@0
|
152
|
|
meillo@34
|
153 Remove given messages from the queue.
|
|
meillo@34
|
154 Only allowed for privileged users.
|
|
meillo@45
|
155 The identifiers of messages are listed in the output of
|
|
meillo@99
|
156 \fImasqmail \-bp\fP (\fImailq\fR).
|
|
meillo@0
|
157
|
|
meillo@0
|
158 .TP
|
|
meillo@34
|
159 \fB\-oem\fR
|
|
meillo@0
|
160
|
|
meillo@34
|
161 If the \fB\-oi\fR ist not also given, always return with a non zero return code.
|
|
meillo@34
|
162 Maybe someone tells me what this is good for...
|
|
meillo@0
|
163
|
|
meillo@0
|
164 .TP
|
|
meillo@34
|
165 \fB\-odb\fR
|
|
meillo@0
|
166
|
|
meillo@34
|
167 Deliver in background.
|
|
meillo@34
|
168 Masqmail always does this, which makes this option pretty much useless.
|
|
meillo@0
|
169
|
|
meillo@0
|
170 .TP
|
|
meillo@34
|
171 \fB\-odq\fR
|
|
meillo@0
|
172
|
|
meillo@34
|
173 Do not attempt to deliver immediately.
|
|
meillo@34
|
174 Any messages will be queued until the next queue running process picks them up and delivers them.
|
|
meillo@34
|
175 You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf.
|
|
meillo@0
|
176
|
|
meillo@0
|
177 .TP
|
|
meillo@34
|
178 \fB\-oi\fR
|
|
meillo@0
|
179
|
|
meillo@0
|
180 A dot as a single character in a line does not terminate the message.
|
|
meillo@34
|
181
|
|
meillo@0
|
182 .TP
|
|
meillo@34
|
183 \fB\-q [\fIinterval\fB]\fR
|
|
meillo@0
|
184
|
|
meillo@34
|
185 If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue.
|
|
meillo@34
|
186 Masqmail sends only to those addresses that are on the local net, not to those that are outside.
|
|
meillo@34
|
187 Use \fB\-qo\fR for those.
|
|
meillo@0
|
188
|
|
meillo@34
|
189 If you have configured inetd to start masqmail,
|
|
meillo@34
|
190 you can use this option in a cron job which starts in regular time intervals,
|
|
meillo@34
|
191 to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR.
|
|
meillo@0
|
192
|
|
meillo@34
|
193 An argument may be a time interval i.e. a numerical value followed by one of the letters.
|
|
meillo@34
|
194 s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively.
|
|
meillo@34
|
195 Example: \fB\-q30m\fR.
|
|
meillo@34
|
196 Masqmail starts as a daemon and a queue runner process will be started automatically
|
|
meillo@34
|
197 once in this time interval.
|
|
meillo@34
|
198 This is usually used together with \fB\-bd\fR (see above).
|
|
meillo@0
|
199
|
|
meillo@0
|
200 .TP
|
|
meillo@34
|
201 \fB\-qo [\fIname\fB]\fR
|
|
meillo@0
|
202
|
|
meillo@34
|
203 Can be followed by a connection name.
|
|
meillo@34
|
204 Use this option in your script which starts as soon as a link to the internet
|
|
meillo@34
|
205 has been set up (usually ip-up).
|
|
meillo@34
|
206 When masqmail is called with this option, the specified route configuration
|
|
meillo@34
|
207 is read and the queued mail with destinations on the internet will be sent.
|
|
meillo@34
|
208 The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR).
|
|
meillo@0
|
209
|
|
meillo@34
|
210 If called without \fIname\fR the online status is determined with the configured
|
|
meillo@34
|
211 method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR)
|
|
meillo@0
|
212
|
|
meillo@0
|
213 .TP
|
|
meillo@34
|
214 \fB\-t\fR
|
|
meillo@0
|
215
|
|
meillo@34
|
216 Read recipients from headers.
|
|
meillo@34
|
217 Delete `Bcc:' headers.
|
|
meillo@106
|
218 (Since 0.2.25, masqmail deletes Bcc: headers in all cases.)
|
|
meillo@34
|
219 If any arguments are given, these are interpreted as recipient addresses
|
|
meillo@103
|
220 and the message will not be sent to these,
|
|
meillo@103
|
221 although they might appear in To:, Cc:, or Bcc: headers.
|
|
meillo@103
|
222 I.e. the set of argument recipients is ``substracted'' from the set of header recipients.
|
|
meillo@103
|
223
|
|
meillo@103
|
224 This behavior is similar to exim's and smail's.
|
|
meillo@103
|
225 Postfix, in contrast, adds the arguments to the set of header recipients.
|
|
meillo@103
|
226 Sendmail seems to behave differently, depending on the version.
|
|
meillo@103
|
227 See exim(8) for further information.
|
|
meillo@0
|
228
|
|
meillo@0
|
229 .TP
|
|
meillo@34
|
230 \fB\-v\fR
|
|
meillo@0
|
231
|
|
meillo@34
|
232 Log also to stdout.
|
|
meillo@34
|
233 Currently, some log messages are marked as `write to stdout' and additionally,
|
|
meillo@34
|
234 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
|
|
meillo@34
|
235 if this option is given. It is disabled in daemon mode.
|
|
meillo@0
|
236
|
|
meillo@34
|
237
|
|
meillo@0
|
238 .SH ENVIRONMENT FOR PIPES AND MDAS
|
|
meillo@0
|
239
|
|
meillo@34
|
240 For security reasons, before any pipe command from an alias expansion or an mda is called,
|
|
meillo@34
|
241 the environment variables will be completely discarded and newly set up. These are:
|
|
meillo@0
|
242
|
|
meillo@34
|
243 SENDER, RETURN_PATH \(en the return path.
|
|
meillo@0
|
244
|
|
meillo@34
|
245 SENDER_DOMAIN \(en the domain part of the return path.
|
|
meillo@0
|
246
|
|
meillo@34
|
247 SENDER_LOCAL \(en the local part of the return path.
|
|
meillo@0
|
248
|
|
meillo@34
|
249 RECEIVED_HOST \(en the host the message was received from (unless local).
|
|
meillo@0
|
250
|
|
meillo@34
|
251 LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient.
|
|
meillo@0
|
252
|
|
meillo@34
|
253 MESSAGE_ID \(en the unique message id.
|
|
meillo@34
|
254 This is not necessarily identical with the Message ID as given in the Message ID: header.
|
|
meillo@0
|
255
|
|
meillo@34
|
256 QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses.
|
|
meillo@34
|
257
|
|
meillo@0
|
258
|
|
meillo@0
|
259 .SH FILES
|
|
meillo@0
|
260
|
|
meillo@34
|
261 \fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail.
|
|
meillo@34
|
262 Depending on the settings in this file, you will also have other configuration
|
|
meillo@34
|
263 files in \fI/etc/masqmail/\fR.
|
|
meillo@0
|
264
|
|
meillo@34
|
265 \fI/var/spool/masqmail/\fR is the spool directory where masqmail stores
|
|
meillo@34
|
266 its spooled messages and the uniq pop ids.
|
|
meillo@0
|
267
|
|
meillo@34
|
268 \fI/var/spool/mail/\fR is the directory where locally delivered mail will be put,
|
|
meillo@34
|
269 if not configured differently in \fImasqmail.conf\fR.
|
|
meillo@0
|
270
|
|
meillo@34
|
271 \fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages.
|
|
meillo@34
|
272 This can also be somewhere else if configured differently by your sysadmin or the package mantainer.
|
|
meillo@34
|
273
|
|
meillo@0
|
274
|
|
meillo@0
|
275 .SH CONFORMING TO
|
|
meillo@0
|
276
|
|
meillo@0
|
277 RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
|
|
meillo@0
|
278
|
|
meillo@0
|
279 RFC 1725, 1939 (POP3)
|
|
meillo@0
|
280
|
|
meillo@0
|
281 RFC 1321 (MD5)
|
|
meillo@0
|
282
|
|
meillo@0
|
283 RFC 2195 (CRAM-MD5)
|
|
meillo@0
|
284
|
|
meillo@34
|
285
|
|
meillo@0
|
286 .SH AUTHOR
|
|
meillo@0
|
287
|
|
meillo@34
|
288 Masqmail was written by Oliver Kurth.
|
|
meillo@34
|
289 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
|
|
meillo@0
|
290
|
|
meillo@95
|
291 You will find the newest version of masqmail at \fBhttp://marmaro.de/prog/masqmail/\fR.
|
|
meillo@26
|
292 There is also a mailing list, you will find information about it at masqmail's main site.
|
|
meillo@0
|
293
|
|
meillo@34
|
294
|
|
meillo@0
|
295 .SH BUGS
|
|
meillo@0
|
296
|
|
meillo@34
|
297 Please report them to the mailing list.
|
|
meillo@34
|
298
|
|
meillo@0
|
299
|
|
meillo@0
|
300 .SH SEE ALSO
|
|
meillo@0
|
301
|
|
meillo@34
|
302 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.get(5)\fR, \fBmasqmail.aliases(5)\fR
|
