Mercurial > masqmail

annotate man/masqmail.8 @ 272:681863fdafbb

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
refactoring in the small
author markus schnalke <meillo@marmaro.de>
date Fri, 03 Dec 2010 19:13:25 -0300
parents f4117fd5a163
children 1abc1faeb45d
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
228
9397d10fd771 updated date and version of man pages
meillo@marmaro.de
parents: 192
diff changeset
1 .TH masqmail 8 2010-07-23 masqmail-0.3.0 "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
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
7 \fB/usr/sbin/masqmail \fR[\fB\-C \fIfile\fR] [\fB\-odq\fR] [\fB\-bd\fR] [\fB\-q\fIinterval\fR]
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
8
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
9 \fB/usr/sbin/masqmail \fR[\fB\-odq\fR] [\fB\-bs\fR]
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
10
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
11 \fB/usr/sbin/masqmail \fR[\fB\-bp\fR]
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
12
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
13 \fB/usr/sbin/masqmail \fR[\fB\-q\fR]
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
14
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
15 \fB/usr/sbin/masqmail \fR[\fB\-qo \fR[\fIname\fR]]
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
16
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
17 \fB/usr/sbin/masqmail \fR[\fB\-t\fR] [\fB\-oi\fR] [\fB\-f \fIaddress\fR] [\fB\-\-\fR] \fIaddress...
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
18
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
19 \fB/usr/sbin/mailq\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
20
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
21
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
22 .SH DESCRIPTION
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
23
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
24 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
25 e.g. a home network or a single host at home.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
26 It has special support for connections to different ISPs.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
27 It replaces sendmail or other MTAs such as qmail or exim.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
28
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
29
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
30 .SH OPTIONS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
31
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
32 Since masqmail is intended to replace sendmail, it uses the same command line options,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
33 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
34 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
35
259
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
36 When no mode had been specified by either a command line option
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
37 (e.g. \fB\-bd\fP, \fB\-bs\fP) or by calling masqmail under a special name
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
38 (e.g. ``mailq''), then the default mode is used.
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
39 This is accepting messages on stdin if any address arguments are given,
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
40 and only printing its version (\fB\-bV\fP) otherwise.
f4117fd5a163 made default mode sensible
markus schnalke <meillo@marmaro.de>
parents: 258
diff changeset
41
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
42 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
43 \fB\-\-\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
44
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
45 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
46 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
47 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
48
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
49 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
50 \fB\-bd\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
51
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
52 Run as daemon, accepting connections, usually on port 25 if not configured differently.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
53 This is usually used in the startup script at system boot and together with
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
54 the \fB\-q\fR option (see below).
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
55
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
56 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
57 \fB\-bi\fR
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
58
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
59 Old sendmail rebuilds its alias database when invoked with this option.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
60 Masqmail ignores it.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
61 Masqmail reads directly from the file given with `alias_file' in the config file.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
62
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
63 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
64 \fB\-bp\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
65
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
66 Show the messages in the queue. Same as calling masqmail as `mailq'.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
67
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
68 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
69 \fB\-bs\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
70
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
71 Accept SMTP commands from stdin.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
72 Some mailers (e.g. pine) use this option as an interface.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
73 It can also be used to call masqmail from inetd.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
74
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
75 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
76 \fB\-B \fIarg\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
77
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
78 \fIarg\fR is usually 8BITMIME.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
79 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
80 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
81 which is very painful ;-).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
82 Note though that this violates some conventions:
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
83 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
84 a mail server which does not advertise its 8BITMIME capability,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
85 masqmail does not advertise this itself.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
86 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
87
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
88 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
89 \fB\-bV \fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
90
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
91 Show version information.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
92
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
93 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
94 \fB\-C \fIfilename\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
95
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
96 Use another configuration than \fI/etc/masqmail/masqmail.conf\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
97 Useful for debugging purposes.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
98 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
99
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
100 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
101 \fB\-d \fInumber\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
102
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
103 Set the debug level.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
104 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
105 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
106 Only root may set the debug level.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
107
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
108 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
109 \fB\-f [\fIaddress\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
110
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
111 Set the return path address to \fIaddress\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
112 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
113
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
114 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
115 \fB\-F [\fIstring\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
116
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
117 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
118
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
119 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
120 \fB\-i\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
121
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
122 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
123 Kept for compatibility.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
124
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
125 .TP
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
126 \fB\-Mrm \fImsgid...\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
127
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
128 Remove given messages from the queue.
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
129 Privileged users may remove any message,
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
130 other users only their own.
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
131 The message identifiers are listed in the output of
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
132 \fImasqmail \-bp\fP (aka. \fImailq\fR).
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
133
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
134 .TP
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
135 \fB\-m\fR
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
136
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
137 ``Me too''
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
138 This switch is ignored as,
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
139 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
140
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
141 \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
142 Kept for compatibility.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
143
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
144 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
145 \fB\-odb\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
146
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
147 ``Deliver in Background''
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
148 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
149 Hence masqmail ignores this switch.
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
150
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
151 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
152 \fB\-odq\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
153
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
154 ``Do Queueing''
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
155 Do not attempt to deliver immediately.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
156 Any messages will be queued until the next queue running process picks them up and delivers them.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
157 You get the same effect by setting the do_queue option in /etc/masqmail/masqmail.conf.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
158
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
159 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
160 \fB\-oi\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
161
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
162 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
163
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
164 The same as \fB\-i\fP.
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
165
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
166 .TP
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
167 \fB\-oXXX\fR
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
168
258
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
169 Any other switch starting with `\-o' is ignored.
05fa719b7002 fixed -oem by removing it ;-)
markus schnalke <meillo@marmaro.de>
parents: 252
diff changeset
170 This especially affects \-om, \-oem, \-oee.
247
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
171
3c40f86d50e4 ignoring -m switch now
markus schnalke <meillo@marmaro.de>
parents: 228
diff changeset
172 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
173 \fB\-q [\fIinterval\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
174
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
175 If not given with an argument, run a queue process, i.e. try to deliver all messages in the queue.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
176 Masqmail sends only to those addresses that are on the local net, not to those that are outside.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
177 Use \fB\-qo\fR for those.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
178
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
179 If you have configured inetd to start masqmail,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
180 you can use this option in a cron job which starts in regular time intervals,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
181 to mimic the same effect as starting masqmail with \fB\-bd \-q30m\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
182
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
183 An argument may be a time interval i.e. a numerical value followed by one of the letters.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
184 s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
185 Example: \fB\-q30m\fR.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
186 Masqmail starts as a daemon and a queue runner process will be started automatically
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
187 once in this time interval.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
188 This is usually used together with \fB\-bd\fR (see above).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
189
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
190 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
191 \fB\-qo [\fIname\fB]\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
192
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
193 Can be followed by a connection name.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
194 Use this option in your script which starts as soon as a link to the internet
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
195 has been set up (usually ip-up).
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
196 When masqmail is called with this option, the specified route configuration
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
197 is read and the queued mail with destinations on the internet will be sent.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
198 The \fIname\fR is defined in the configuration (see \fBonline_routes.\fIname\fR).
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
199
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
200 If called without \fIname\fR the online status is determined with the configured
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
201 method (see \fBonline_detect\fR in \fBmasqmail.conf(5)\fR)
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
202
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
203 .TP
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
204 \fB\-t\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
205
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
206 Read recipients from headers.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
207 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
208 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
209 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
210 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
211
c85fbf7014b1 improved man page in respect to the -t option
meillo@marmaro.de
parents: 99
diff changeset
212 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
213 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
214 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
215 See exim(8) for further information.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
216
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
217 .TP
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
218 \fB\-v\fR
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
219
252
1b25fabdc3cb improved man/masqmail.8 in various ways but mostly for -oem
markus schnalke <meillo@marmaro.de>
parents: 247
diff changeset
220 ``Verbose''
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
221 Log also to stdout.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
222 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
223 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
224 if this option is given. It is disabled in daemon mode.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
225
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
226
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
227 .SH ENVIRONMENT FOR PIPES AND MDAS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
228
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
229 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
230 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
231
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
232 SENDER, RETURN_PATH \(en the return path.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
233
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
234 SENDER_DOMAIN \(en the domain part of the return path.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
235
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
236 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
237
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
238 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
239
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
240 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
241
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
242 MESSAGE_ID \(en the unique message id.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
243 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
244
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
245 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
246
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
247
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
248 .SH FILES
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
249
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
250 \fI/etc/masqmail/masqmail.conf\fR is the main configuration for masqmail.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
251 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
252 files in \fI/etc/masqmail/\fR.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
253
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
254 \fI/var/spool/masqmail/\fR is the spool directory where masqmail stores
192
89f951be358f REMOVED POP3 SUPPORT
meillo@marmaro.de
parents: 174
diff changeset
255 its spooled messages.
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
256
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
257 \fI/var/spool/mail/\fR is the directory where locally delivered mail will be put,
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
258 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
259
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
260 \fI/var/log/masqmail/\fR is the directory where masqmail stores its log mesages.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
261 This can also be somewhere else if configured differently by your sysadmin or the package mantainer.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
262
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
263
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
264 .SH CONFORMING TO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
265
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
266 RFC 821, 822, 1869, 1870, 2197, 2554 (SMTP)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
267
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
268 RFC 1321 (MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
269
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
270 RFC 2195 (CRAM-MD5)
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
271
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
272
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
273 .SH AUTHOR
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
274
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
275 Masqmail was written by Oliver Kurth.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
276 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
277
95
e01fed4846e4 masqmail's homepage moved prog.marmaro.de/masqmail -> marmaro.de/prog/masqmail
meillo@marmaro.de
parents: 57
diff changeset
278 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
279 There is also a mailing list, you will find information about it at masqmail's main site.
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
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
282 .SH BUGS
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
283
34
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
284 Please report them to the mailing list.
8ea86ac25658 reformating of man page sources
meillo@marmaro.de
parents: 26
diff changeset
285
0
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
286
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
287 .SH SEE ALSO
08114f7dcc23 this is masqmail-0.2.21 from oliver kurth
meillo@marmaro.de
parents:
diff changeset
288
192
89f951be358f REMOVED POP3 SUPPORT
meillo@marmaro.de
parents: 174
diff changeset
289 \fBmasqmail.conf(5)\fR, \fBmasqmail.route(5)\fR, \fBmasqmail.aliases(5)\fR