Mercurial > masqmail

comparison man/masqmail.8 @ 252:1b25fabdc3cb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
improved man/masqmail.8 in various ways but mostly for -oem The man page documents the changes in cmdline argument processing, done just recently. The problem of -oem is not solved yet but documented.
author markus schnalke <meillo@marmaro.de>
date Thu, 04 Nov 2010 13:43:44 -0300
parents 3c40f86d50e4
children 05fa719b7002
comparison
equal deleted inserted replaced
251:2babd21e7c75 252:1b25fabdc3cb
29 29
30 .SH OPTIONS 30 .SH OPTIONS
31 31
32 Since masqmail is intended to replace sendmail, it uses the same command line options, 32 Since masqmail is intended to replace sendmail, it uses the same command line options,
33 but not all are implemented. 33 but not all are implemented.
34 There are also two additional options, which are unique to masqmail 34 The \fB\-qo\fP option is additional, and unique to masqmail.
35 (\fB\-qo \fIconnection\fR and \fB\-g\fR)
36 35
37 .TP 36 .TP
38 \fB\-\-\fR 37 \fB\-\-\fR
39 38
40 Not a `real' option, it means that all following arguments are to be understood 39 Not a `real' option, it means that all following arguments are to be understood
96 \fB\-d \fInumber\fR 95 \fB\-d \fInumber\fR
97 96
98 Set the debug level. 97 Set the debug level.
99 This takes precedence before the value of `debug_level' in the configuration file. 98 This takes precedence before the value of `debug_level' in the configuration file.
100 Read the warning in the description of the latter. 99 Read the warning in the description of the latter.
100 Only root may set the debug level.
101 101
102 .TP 102 .TP
103 \fB\-f [\fIaddress\fB]\fR 103 \fB\-f [\fIaddress\fB]\fR
104 104
105 Set the return path address to \fIaddress\fR. 105 Set the return path address to \fIaddress\fR.
112 112
113 .TP 113 .TP
114 \fB\-i\fR 114 \fB\-i\fR
115 115
116 Same as \fB\-oi\fR, see below. 116 Same as \fB\-oi\fR, see below.
117 117 Kept for compatibility.
118 .TP 118
119 \fB\-Mrm \fIlist\fR 119 .TP
120 \fB\-Mrm \fImsgid...\fR
120 121
121 Remove given messages from the queue. 122 Remove given messages from the queue.
122 Only allowed for privileged users. 123 Privileged users may remove any message,
123 The identifiers of messages are listed in the output of 124 other users only their own.
124 \fImasqmail \-bp\fP (\fImailq\fR). 125 The message identifiers are listed in the output of
126 \fImasqmail \-bp\fP (aka. \fImailq\fR).
125 127
126 .TP 128 .TP
127 \fB\-m\fR 129 \fB\-m\fR
128 130
129 Same as \fB\-om\fR, see below. 131 Same as \fB\-om\fR, see below.
132 Kept for compatibility.
130 133
131 .TP 134 .TP
132 \fB\-oem\fR 135 \fB\-oem\fR
133 136
137 Currently this option makes masqmail behave such:
138
134 If the \fB\-oi\fR ist not also given, always return with a non zero return code. 139 If the \fB\-oi\fR ist not also given, always return with a non zero return code.
135 Maybe someone tells me what this is good for... 140
141 It seems as if this current behavior is not like it should be.
142
143 In exim this option makes it behave such:
144
145 .in +4
146 .ll -4
147 If an error is detected while a non-SMTP message is being received
148 (for example, a malformed address),
149 the error is reported to the sender in a mail message.
150 Exim exits with a non-zero return code then,
151 no matter if the error message was successful or not.
152 (In exim, -oee is similar but exim returns successful
153 if the error message had been sent successful.)
154 .ll
155 .in
156
157 The mutt wiki writes about ``sendmail -oi -oem'':
158
159 .in +4
160 .ll -4
161 The mail server (in this case sendmail) will receive the message in input,
162 and will parse it. In case of a malformed message, it will send an error
163 message to the user to whom belongs the MUA trasmitting the message
164 (e.g. user@localhost.localdomain), and it will exit with a non zero exit code:
165 the -oem flag forces the returning of a non zero exit code even in
166 the case the error message has been successfully sent to the local server.
167 .ll
168 .in
169
170 Masqmail's behavior is different in that:
171 First, it does not send such error messages.
172 Second, return non-zero whenever -oem is set (but -oi not).
173 Third, -oi overrules -oem, though as it seems the two options
174 should not affect each other.
175 (Their relationship is just that -oem does only affect non-SMTP
176 messages on stdin, which is the typical use of -oi.)
136 177
137 .TP 178 .TP
138 \fB\-odb\fR 179 \fB\-odb\fR
139 180
140 Deliver in background. 181 ``Deliver in Background''
141 Masqmail always does this, which makes this option pretty much useless. 182 Masqmail always does this.
183 Hence masqmail ignores this switch.
142 184
143 .TP 185 .TP
144 \fB\-odq\fR 186 \fB\-odq\fR
145 187
188 ``Do Queueing''
146 Do not attempt to deliver immediately. 189 Do not attempt to deliver immediately.
147 Any messages will be queued until the next queue running process picks them up and delivers them. 190 Any messages will be queued until the next queue running process picks them up and delivers them.
148 You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf. 191 You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf.
149 192
150 .TP 193 .TP
153 A dot as a single character in a line does not terminate the message. 196 A dot as a single character in a line does not terminate the message.
154 197
155 .TP 198 .TP
156 \fB\-om\fR 199 \fB\-om\fR
157 200
158 From exim(8)'s man page: In Sendmail, this option means ``me too'', 201 ``Me too''
159 indicating that the sender of a message should receive a copy of the 202 Masqmail never excludes the sender from any alias expansions,
160 message if the sender appears in an alias expansion. 203 like if this switch is always set.
161 204 Specifying this switch changes nothing.
162 Masqmail always does this, hence the option does nothing. 205
206 .TP
207 \fB\-oXXX\fR
208
209 Any other switch starting with `-o' is ignored.
163 210
164 .TP 211 .TP
165 \fB\-q [\fIinterval\fB]\fR 212 \fB\-q [\fIinterval\fB]\fR
166 213
167 If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue. 214 If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue.
194 241
195 .TP 242 .TP
196 \fB\-t\fR 243 \fB\-t\fR
197 244
198 Read recipients from headers. 245 Read recipients from headers.
199 Delete `Bcc:' headers.
200 (Since 0.2.25, masqmail deletes Bcc: headers in all cases.)
201 If any arguments are given, these are interpreted as recipient addresses 246 If any arguments are given, these are interpreted as recipient addresses
202 and the message will not be sent to these, 247 and the message will not be sent to these,
203 although they might appear in To:, Cc:, or Bcc: headers. 248 although they might appear in To:, Cc:, or Bcc: headers.
204 I.e. the set of argument recipients is ``substracted'' from the set of header recipients. 249 I.e. the set of argument recipients is ``substracted'' from the set of header recipients.
205 250
209 See exim(8) for further information. 254 See exim(8) for further information.
210 255
211 .TP 256 .TP
212 \fB\-v\fR 257 \fB\-v\fR
213 258
259 ``Verbose''
214 Log also to stdout. 260 Log also to stdout.
215 Currently, some log messages are marked as `write to stdout' and additionally, 261 Currently, some log messages are marked as `write to stdout' and additionally,
216 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout 262 all messages with priority `LOG_ALERT' and `LOG_WARNING' will be written to stdout
217 if this option is given. It is disabled in daemon mode. 263 if this option is given. It is disabled in daemon mode.
218 264