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