masqmail-0.2

annotate man/masqmail.8 @ 134:43a9447c3583

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