masqmail

annotate docs/old-manual/options.html @ 65:66d47cc69611

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