annotate docs/old-manual/options.html @ 89:a917cb178ca7

what about the `rmail' alias?
author meillo@marmaro.de
date Sat, 19 Jun 2010 19:00:04 +0200 (2010-06-19)
parents f6a6f55b7b9e
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
56
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
1
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
2
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
3
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
4
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
5
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
6
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
7
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
8
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
9 <HTML>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
10 <HEAD>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
11 <TITLE>MasqMail - Manual
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
12 </TITLE>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
13 </HEAD>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
14 <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
15
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
16 <center>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
17 <table width="80%">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
18 <tr><td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
19 <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
20 <tr>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
21 <td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
22 <a href="manual.html">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
23 <img width="20" src = "../images/u_arrow.gif" alt = "manual">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
24 </a>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
25 </td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
26 <td align=center width="100%"><font size="6" color = "#ffffff">Options</font></td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
27 <td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
28 <a href="./install.html">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
29 <img width="20" src = "../images/l_arrow.gif" alt = "Installation">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
30 </a>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
31 </td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
32 <td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
33 <a href="./alias.html">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
34 <img width="20" src = "../images/r_arrow.gif" alt = "Alias Format">
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
35 </a>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
36 </td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
37 </tr>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
38 </table>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
39
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
40
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
41 <p>Since masqmail is intended to replace sendmail, it uses the same
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
42 command line options, but not all are implemented. There are also two
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
43 additional options, which are unique to masqmail (-qo
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
44 &lt;connection&gt; and -g) </p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
45
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
46 <b>-- </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
47
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
48 <p>Not a 'real' option, it means that all following arguments are to
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
49 be understood as arguments and not as options even if they begin with a
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
50 leading dash '-'. Mutt is known to call sendmail with this option.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
51
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
52 <b>-bd </b>option (daemon):<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
53
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
54 <p>Run as daemon, accepting connections, usually on port 25 if not
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
55 configured differently. This is usually used in the startup script and
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
56 together with the -q option (see below).</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
57
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
58 <b>-bi </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
59
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
60 <p>Old sendmail rebuilds its alias database when invoked with this
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
61 option. Masqmail ignores it. Masqmail reads directly from the file
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
62 given with <b>alias_file</b> in the config file.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
63
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
64 <b>-bp </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
65
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
66 <p>Show the messages in the queue. Same as calling masqmail as
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
67 'mailq'.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
68
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
69 <b>-bs </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
70
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
71 <p>Accept SMTP commands from stdin. Some mailers (eg pine) use this
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
72 option as an interface. It can also be used to call masqmail from
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
73 inetd, according to Tomislav Filipcic this works.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
74
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
75 <b>-B&lt;arg&gt;</b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
76
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
77 <p>arg is usually 8BITMIME. Some mailers use this to indicate that the
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
78 message contains characters &gt; 127. Masqmail is 8-bit clean and
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
79 ignores this, so you do not have to recompile elm, which is very
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
80 painful ;-). Note though that this violates some conventions: masqmail
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
81 <em>does not</em> convert 8 bit messages to any MIME format if it
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
82 encounters a mail server which does not advertise its 8BITMIME capability,
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
83 masqmail does not advertise this itself. This is the same practice as
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
84 that of exim (but different to sendmail).</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
85
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
86 <p>This <em>may</em> change in the future, but do not rely on it.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
87
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
88 <b>-C&lt;filename&gt;</b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
89
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
90 <p>Use another configuration than /etc/masqmail.conf. Useful for
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
91 debugging purposes.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
92
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
93 <b>-d &lt;number&gt; </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
94
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
95 <p>Set the debug level. This takes precedence before the value of
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
96 <b>debug_level</b> in the configuration file. Read the warning in the
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
97 description of the latter.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
98
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
99 <b>-g </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
100
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
101 <p>Get mail, using the configurations given with
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
102 <b>get.&lt;name&gt;</b> in the main configuration.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
103
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
104 <b>-i </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
105
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
106 <p>Same as <b>-oi</b>, see below.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
107
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
108 <b>-oem </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
109
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
110 <p>If the <b>-oi</b> ist not also given, always return with a non zero
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
111 return code. Maybe someone tells me what this is good for... </p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
112
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
113 <b>-odb </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
114
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
115 <p>Deliver in background. Masqmail always does this.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
116
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
117 <b>-odq </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
118
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
119 <p>Do not attempt to deliver immediately. Any messages will be queued
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
120 until the next queue running process picks them up and delivers
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
121 them. You get the same effect by setting the <i>do_queue</i> option in
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
122 /etc/masqmail.conf.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
123
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
124 <b>-oi </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
125
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
126 <p>A dot as a single character in a line does <em>not</em> terminate
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
127 the message.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
128
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
129 <b>-q </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
130
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
131 <p>If not given with an argument, run a queue process, ie. try to
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
132 deliver all messages in the queue. Masqmail sends only to those
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
133 addresses that are on the <em>local</em> net, not to those that are
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
134 outside. Use -qo &lt;connection&gt; for those.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
135
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
136 <p>If you have configured inetd to start masqmail, you can use this
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
137 option in a cron job which starts in regular time intervals, to mimic
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
138 the same effect as starting masqmail with -bd -q30m.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
139
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
140 <p>An argument may be a time interval ie. a numerical value followed
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
141 by one of the letters. s,m,h,d,w which are interpreted as seconds,
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
142 minutes, hours, days or weeks respectively. Example: -q30m. Masqmail
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
143 starts as a daemon and a queue runner process will be started
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
144 automatically once in this time interval. This is usually used
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
145 together with -bd (see above).</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
146
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
147 <b>-qo&lt;name&gt; </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
148
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
149 <p>Can be followed by a connection name. Use this option in your
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
150 script which starts as soon as a link to the internet has been set up
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
151 (usually ip-up). When masqmail is called with this option, the
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
152 specified route configuration is read and the queued mail with
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
153 destinations on the internet will be sent. The <b>name</b> is defined
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
154 in the configuration (see <b>connect_route.&lt;name&gt;</b>).</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
155
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
156 <p>If called without &lt;name&gt, the online status is determined with
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
157 the configured method (see <b>online_detect</b> in <a
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
158 href="config.html">config.html</a>)</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
159
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
160 <b>-t </b>option:<br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
161
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
162 <p>Read recipients from headers. Delete 'Bcc:' headers. If any
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
163 arguments are given, these are interpreted as recipient addresses and
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
164 the message will <em>not</em> be sent to these.</p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
165 </td></tr>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
166
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
167 <tr><td>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
168 <p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
169 <hr>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
170 <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
171 Last modified: Tue May 30 15:19:56 CEST 2000
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
172 <br>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
173 This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
174 </p>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
175
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
176 </table>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
177 </center>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
178
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
179 </BODY>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
180 </HEAD>
f6a6f55b7b9e added old manual from the old website
meillo@marmaro.de
parents:
diff changeset
181