Mercurial > masqmail

annotate man/masqmail.8 @ 304:d5ce2ba71e7b

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
manual formating of Received: hdrs; changed hdr for local receival Now the Received: headers are much friendlier to read. About folding: We must fold any line at 998 chars before transfer. We should fold the lines we produce at 78 chars. That is what RFC 2821 requests. We should think about it, somewhen. The header for locally (i.e. non-SMTP) received mail is changed to the format postfix uses. This matches RFC 2821 better. The `from' clause should contain a domain or IP, not a user name. Also, the `with' clause should contain a registered standard protocol name, which ``local'' is not.
author markus schnalke <meillo@marmaro.de>
date Thu, 09 Dec 2010 18:28:11 -0300
parents 95d536599fd7
children f10a56dc7481
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
291
95d536599fd7 updated ChangeLog, NEWS and date/version in the man pages
markus schnalke <meillo@marmaro.de>
parents: 290
diff changeset
1 .TH masqmail 8 2010-12-08 masqmail-0.3.1 "Maintenance Commands"
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
2
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
3 .SH NAME
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
4 masqmail \- An offline Mail Transfer Agent
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
5
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
6 .SH SYNOPSIS
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
7
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
8 .BR masqmail\ [ \-t ] \ [ \-oi ] \ [ \-f\ \fIADDRESS ]\ \fIRECIPIENT...
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
9
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
10 .B mailq
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
11 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
12 .B masqmail \-bp
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
13
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
14 .B runq
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
15 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
16 .B masqmail \-q
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
17
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
18 .BR masqmail\ \-qo\ \fINAME
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
19
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
20 .BI mailrm\ MSGID...
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
21 .br
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
22 .BI masqmail\ -Mrm\ MSGID...
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
23
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
24 .BR masqmail\ [ \-C\ \fIFILE ] \ [ \-odq ]\ \-bs
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
25
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
26 .BR masqmail\ [ \-C\ \fIFILE ] \ [ \-odq ]\ \-bd\ \-q\fIINTERVAL
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
27
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
28 (This list is a selection.)
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
29
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
30
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
31 .SH DESCRIPTION
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
32
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
33 Masqmail is a mail server designed for hosts that do not have a permanent internet connection
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
34 e.g. a home network or a single host at home.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
35 It has special support for connections to different ISPs.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
36 It replaces sendmail or other MTAs such as qmail or exim.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
37
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
38
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
39 .SH OPERATION MODES
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
40
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
41 Masqmail operates in one of several exclusive modes.
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 The daemon mode has two flavors that may be,
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
44 and usually are, used in combination:
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
45 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
46 .B Daemon (listen)
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
47 .B \-bd
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
48 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
49 .B smtpd
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
50
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
51 Run as daemon.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
52 Act as SMTP server and accept SMTP connections,
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
53 on port 25 if not configured differently.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
54
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
55 This is normally used in the startup script at system boot
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
56 and together with \fB\-q\fIINTERVAL\fR (see below).
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
57
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
58 Alternatively masqmail can be run with the \fB\-bs\fR option
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
59 from inetd.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
60
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
61 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
62 .B Daemon (queue)
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
63 .B \-q\fIINTERVAL
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
64
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
65 Run as daemon.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
66 Do regular queue runs at the specified time interval.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
67 This is normally used together with \fB\-bd\fR (see above).
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
68
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
69 An argument may be a time interval i.e. a numerical value followed by one
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
70 of the letters s,m,h,d,w which are interpreted as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
71 seconds, minutes, hours, days or weeks respectively.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
72 Example: \fB\-q30m\fR.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
73 Combinations like \fB\-q1h30m\fR, which sendmail accepts, are not possible.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
74
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
75 Alternatively single queue runs (\fB\-q\fR) can be started from cron.
283
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 .P
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
78 The queue processing mode has two flavors that may be
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
79 used in combination:
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
80
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
81 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
82 .B Single queue run (normal)
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
83 .B \-q
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
84 (without argument)
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
85 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
86 .B runq
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
87
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
88 Do a single queue run.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
89 Try to deliver all messages in the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
90 Masqmail sends to addresses on the local host, on the local net,
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
91 and to remote ones, if available online routes permit.
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
92 That means, masqmail sends all queued mail it can.
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
93 Online detection is done with the configured
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
94 method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR).
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
95
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
96 .TP
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
97 .B Single queue run (only named route)
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
98 .BI \-qo\ NAME
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
99
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
100 Do a single queue run and deliver only using the specified online route.
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
101
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
102 The route configuration for \fINAME\fP is read and queued mail
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
103 to matching remote recipients is sent.
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
104 (See \fBonline_routes.\fINAME\fR in the main config file.)
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
105
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
106 You may want to use this option in scripts that run as soon as a link
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
107 to the internet has been set up (e.g. ip-up).
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
108
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
109 .B Obsolete behavior:
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
110 Up to now: If
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
111 .B \-qo
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
112 has no argument, the online connection is determinded
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
113 by online detect and, if available, mail is sent through it.
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
114 If none is available no mail is delivered.
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
115
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
116 This behavior is likely to change in future versions
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
117 because it is included in \-q.
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
118 We could do something more useful instead.
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
119
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
120 .P
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
121 The other modes are simple ones:
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
122
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
123 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
124 .B Rebuild alias database
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
125 .B \-bi
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
126 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
127 .B newaliases
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
128
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
129 A no-op for masqmail, just exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
130 Old sendmail rebuilds its alias database when invoked with this option.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
131 Masqmail reads directly from its alias file
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
132 (see config option `alias_file'),
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
133 thus no database needs to be updated.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
134
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
135 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
136 .B Accept messages
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
137 .BR \-bm ,
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
138 also the default mode
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
139
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
140 Accept a text message on stdin.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
141 This is the default mode of operation.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
142 One will hardly use this switch as it is the default.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
143
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
144 The command line options
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
145 .BR \-f , \-F , \-i / \-oi , \-t
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
146 are only used in this mode.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
147
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
148 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
149 .B Print queue
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
150 .B \-bp
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
151 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
152 .B mailq
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
153
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
154 Show the messages in the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
155
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
156 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
157 .B Stand-alone SMTP server
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
158 .B \-bs
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
159
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
160 Act as SMTP server by reading commands from stdin
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
161 and writing to stdout.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
162 Some mailers (e.g. pine) use this option as an interface.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
163 It can also be used to call masqmail from inetd.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
164
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
165 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
166 .B Print version
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
167 .B \-bV
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
168 or if called without arguments
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
169
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
170 Print version information, then exit.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
171
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
172 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
173 .B Queue manipulation mode
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
174 .B \-Mrm
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
175 or invoked as
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
176 .B mailrm
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
177
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
178 Remove given messages from the queue.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
179 Privileged users may remove any message, other users only their own.
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
180 The message identifiers are listed when printing the queue
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
181 (see \fB\-bp\fR).
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
182
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
183 .P
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
184 The default mode:
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
185 .P
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
186 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
187 options or by calling masqmail under a special name,
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
188 then the default mode \fB\-bm\fR
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
189 (i.e. accept messages on stdin) is entered.
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
190 However, if neither address arguments are specified nor
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
191 \fB\-t\fR is given, then mail can not be sent,
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
192 hence something more useful is done: \fB\-bV\fP is assumed.
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
193
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
194
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
195 .SH OPTIONS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
196
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
197 Since masqmail is intended to replace sendmail,
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
198 it uses the same command line options,
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
199 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
200 The \fB\-qo\fP option is additional, and unique to masqmail.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
201
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
202 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
203 \fB\-\-\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
204
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
205 Not a `real' option, it means that all following arguments are to be understood
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
206 as arguments and not as options even if they begin with a leading dash `\-'.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
207 Mutt is known to call sendmail with this option.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
208
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
209 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
210 \fB\-bd\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
211
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
212 ``Daemon (listen)'' mode. See above.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
213
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
214 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
215 \fB\-bi\fR
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
216
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
217 ``Rebuild alias database'' mode. See above.
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
218
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
219 .TP
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
220 .B \-bm
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
221
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
222 ``Accept message'' mode. See above.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
223
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
224 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
225 \fB\-bp\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
226
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
227 ``Print queue'' mode. See above.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
228
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
229 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
230 \fB\-bs\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
231
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
232 ``Stand-alone SMTP server'' mode. See above.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
233
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
234 .TP
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
235 \fB\-bV \fR
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
236
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
237 ``Print version'' mode. See above.
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
238
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
239 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
240 \fB\-B \fIarg\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
241
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
242 \fIarg\fR is usually 8BITMIME.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
243 Some mailers use this to indicate that the message contains characters > 127.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
244 Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
245 which is very painful ;-).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
246 Note though that this violates some conventions:
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
247 masqmail does not convert 8 bit messages to any MIME format if it encounters
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
248 a mail server which does not advertise its 8BITMIME capability,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
249 masqmail does not advertise this itself.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
250 This is the same practice as that of exim (but different to sendmail).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
251
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
252 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
253 \fB\-C \fIfilename\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
254
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
255 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
256 Useful for debugging purposes.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
257 If not invoked by a privileged user, masqmail will drop all privileges.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
258
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
259 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
260 \fB\-d \fInumber\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
261
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
262 Set the debug level.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
263 This takes precedence before the value of `debug_level' in the configuration file.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
264 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
265 Only root may set the debug level.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
266
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
267 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
268 \fB\-f [\fIaddress\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
269
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
270 Set the return path address to \fIaddress\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
271 Only root, the user mail and anyone in group mail is allowed to do that.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
272
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
273 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
274 \fB\-F [\fIstring\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
275
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
276 Set the full sender name (in the From: header) to \fIstring\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
277
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
278 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
279 \fB\-i\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
280
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
281 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
282 Kept for compatibility.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
283
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
284 .TP
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
285 \fB\-Mrm \fImsgid...\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
286
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
287 ``Queue manipulation'' mode. See above.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
288
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
289 .TP
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
290 \fB\-m\fR
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
291
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
292 ``Me too''
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
293 This switch is ignored as,
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
294 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
295
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
296 \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
297 Kept for compatibility.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
298
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
299 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
300 \fB\-odb\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
301
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
302 ``Deliver in Background''
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
303 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
304 Hence masqmail ignores this switch.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
305
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
306 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
307 \fB\-odq\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
308
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
309 ``Do Queueing''
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
310 Do not attempt to deliver immediately.
283
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
311 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
312 up and delivers them.
853b85616c98 improved man/masqmail.8 heavily
markus schnalke <meillo@marmaro.de>
parents: 276
diff changeset
313 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
314 /etc/masqmail/masqmail.conf.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
315
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
316 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
317 \fB\-oi\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
318
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
319 A dot as a single character in a line does not terminate the message.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
320
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
321 The same as \fB\-i\fP.
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
322
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
323 .TP
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
324 \fB\-oXXX\fR
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
325
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
326 Any other switch starting with `\-o' is ignored.
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
327 This especially affects \-om, \-oem, \-oee.
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
328
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
329 .TP
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
330 \fB\-q
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
331
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
332 ``Single queue run (normal)'' mode. See above.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
333
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
334 .TP
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
335 \fB\-q\fIINTERVAL
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
336
285
bdcc2b42eb0f Heavily reworked man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 283
diff changeset
337 ``Daemon (queue)'' mode. See above.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
338
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
339 .TP
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
340 \fB\-qo \fIname
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
341
290
792e0201c1b3 mark -qo (without argument) obsolete
markus schnalke <meillo@marmaro.de>
parents: 286
diff changeset
342 ``Single queue run (only named route)'' mode. See above.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
343
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
344 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
345 \fB\-t\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
346
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
347 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
348 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
349 (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
350
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents: 259
diff changeset
351 .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
352
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
353 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
354 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
355
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents: 259
diff changeset
356 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
357 (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
358 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
359 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
360 (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
361 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
362 See exim(8) for further information.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
363
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
364 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
365
1abc1faeb45d for -t cmdline args are now added to the rcpt list instead of substracted
markus schnalke <meillo@marmaro.de>
parents: 259
diff changeset
366 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
367 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
368
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
369 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
370 \fB\-v\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
371
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
372 ``Verbose''
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
373 Log also to stdout.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
374 Currently, some log messages are marked as `write to stdout' and additionally,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
375 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
376 if this option is given. It is disabled in daemon mode.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
377
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
378
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
379 .SH ENVIRONMENT FOR PIPES AND MDAS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
380
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
381 For security reasons, before any pipe command from an alias expansion or an mda is called,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
382 the environment variables will be completely discarded and newly set up. These are:
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
383
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
384 SENDER, RETURN_PATH \(en the return path.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
385
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
386 SENDER_DOMAIN \(en the domain part of the return path.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
387
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
388 SENDER_LOCAL \(en the local part of the return path.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
389
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
390 RECEIVED_HOST \(en the host the message was received from (unless local).
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
391
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
392 LOCAL_PART, USER, LOGNAME \(en the local part of the (original) recipient.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
393
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
394 MESSAGE_ID \(en the unique message id.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
395 This is not necessarily identical with the Message ID as given in the Message ID: header.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
396
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
397 QUALIFY_DOMAIN \(en the domain which will be appended to unqualified addresses.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
398
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
399
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
400 .SH FILES
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
401
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
402 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
403 .I /etc/masqmail/masqmail.conf
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
404 The main configuration for masqmail.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
405 Depending on the settings in this file, you will also have other configuration
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
406 files in \fI/etc/masqmail/\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
407
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
408 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
409 .I /var/spool/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
410 The spool directory where masqmail stores its queued mails.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
411
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
412 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
413 .I /var/spool/mail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
414 The directory where locally delivered mail will be put,
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
415 if not configured differently in \fImasqmail.conf\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
416
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
417 .TP
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
418 .I /var/log/masqmail/
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
419 The directory where masqmail stores its log messages.
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
420
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
421 .P
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
422 Any of the paths can be configured at compile time,
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
423 and (except the main config file) also in the main config file.
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
424 The typical paths are different, depending on the Unix system you use.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
425
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
426
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
427 .SH CONFORMING TO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
428
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
429 RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
430
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
431 RFC 1321 (MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
432
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
433 RFC 2195 (CRAM-MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
434
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
435
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
436 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
437
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
438 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
439 It is now maintained by Markus Schnalke <meillo@marmaro.de>.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
440
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
441 You will find the newest version of masqmail on its website:
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
442 .BR http://marmaro.de/prog/masqmail/ .
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
443 There is also a mailing list;
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
444 you will find information about it on the website.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
445
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
446
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
447 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
448
286
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
449 Bug reports of any kind are very welcome.
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
450 They help masqmail to become better.
e2f6eefbd573 further, minor, improvements to man/masqmail.8
markus schnalke <meillo@marmaro.de>
parents: 285
diff changeset
451 Please report bugs to the mailing list (anyone can post).
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
452
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
453
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
454 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
455
192
89f951be358f REMOVED POP3 SUPPORT
meillo@marmaro.de
parents: 174
diff changeset
456 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.aliases(5)\fR