meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: 
meillo@56: <HTML>
meillo@56: <HEAD>
meillo@56: <TITLE>MasqMail - Manual
meillo@56: </TITLE>
meillo@56: </HEAD>
meillo@56:   <BODY TEXT="#000000" LINK="#0000ff" BGCOLOR="#ffffff">
meillo@56:     
meillo@56:     <center>
meillo@56:       <table width="80%">
meillo@56: 	<tr><td>
meillo@56: 	    <table width="100%" bgcolor="#0000aa" cellspacing=0 cellpadding=0>
meillo@56: <tr>
meillo@56:   <td>
meillo@56:   <a href="manual.html">
meillo@56:     <img width="20" src = "../images/u_arrow.gif" alt = "manual">
meillo@56:   </a>
meillo@56:   </td>
meillo@56: <td align=center width="100%"><font size="6" color = "#ffffff">Options</font></td>
meillo@56: <td>
meillo@56:   <a href="./install.html">
meillo@56:     <img width="20" src = "../images/l_arrow.gif" alt = "Installation">
meillo@56:   </a>
meillo@56: </td>
meillo@56: <td>
meillo@56:   <a href="./alias.html">
meillo@56:     <img width="20" src = "../images/r_arrow.gif" alt = "Alias Format">
meillo@56:   </a>
meillo@56: </td>
meillo@56: </tr>
meillo@56: </table>
meillo@56: 
meillo@56: 
meillo@56: <p>Since masqmail is intended to replace sendmail, it uses the same
meillo@56: command line options, but not all are implemented. There are also two
meillo@56: additional options, which are unique to masqmail (-qo
meillo@56: &lt;connection&gt; and -g) </p>
meillo@56: 
meillo@56: <b>-- </b>option:<br>
meillo@56: 
meillo@56: <p>Not a 'real' option, it means that all following arguments are to
meillo@56: be understood as arguments and not as options even if they begin with a
meillo@56: leading dash '-'. Mutt is known to call sendmail with this option.</p>
meillo@56: 
meillo@56: <b>-bd </b>option (daemon):<br>
meillo@56: 
meillo@56: <p>Run as daemon, accepting connections, usually on port 25 if not
meillo@56: configured differently. This is usually used in the startup script and
meillo@56: together with the -q option (see below).</p>
meillo@56: 
meillo@56: <b>-bi </b>option:<br>
meillo@56: 
meillo@56: <p>Old sendmail rebuilds its alias database when invoked with this
meillo@56: option. Masqmail ignores it. Masqmail reads directly from the file
meillo@56: given with <b>alias_file</b> in the config file.</p>
meillo@56: 
meillo@56: <b>-bp </b>option:<br>
meillo@56: 
meillo@56: <p>Show the messages in the queue. Same as calling masqmail as
meillo@56: 'mailq'.</p>
meillo@56: 
meillo@56: <b>-bs </b>option:<br>
meillo@56: 
meillo@56: <p>Accept SMTP commands from stdin. Some mailers (eg pine) use this
meillo@56: option as an interface. It can also be used to call masqmail from
meillo@56: inetd, according to Tomislav Filipcic this works.</p>
meillo@56: 
meillo@56: <b>-B&lt;arg&gt;</b>option:<br>
meillo@56: 
meillo@56: <p>arg is usually 8BITMIME. Some mailers use this to indicate that the
meillo@56: message contains characters &gt; 127. Masqmail is 8-bit clean and
meillo@56: ignores this, so you do not have to recompile elm, which is very
meillo@56: painful ;-). Note though that this violates some conventions: masqmail
meillo@56: <em>does not</em> convert 8 bit messages to any MIME format if it
meillo@56: encounters a mail server which does not advertise its 8BITMIME capability,
meillo@56: masqmail does not advertise this itself. This is the same practice as
meillo@56: that of exim (but different to sendmail).</p>
meillo@56: 
meillo@56: <p>This <em>may</em> change in the future, but do not rely on it.</p>
meillo@56: 
meillo@56: <b>-C&lt;filename&gt;</b>option:<br>
meillo@56: 
meillo@56: <p>Use another configuration than /etc/masqmail.conf. Useful for
meillo@56: debugging purposes.</p>
meillo@56: 
meillo@56: <b>-d &lt;number&gt; </b>option:<br>
meillo@56: 
meillo@56: <p>Set the debug level. This takes precedence before the value of
meillo@56: <b>debug_level</b> in the configuration file. Read the warning in the
meillo@56: description of the latter.</p>
meillo@56: 
meillo@56: <b>-g </b>option:<br>
meillo@56: 
meillo@56: <p>Get mail, using the configurations given with
meillo@56: <b>get.&lt;name&gt;</b> in the main configuration.</p>
meillo@56: 
meillo@56: <b>-i </b>option:<br>
meillo@56: 
meillo@56: <p>Same as <b>-oi</b>, see below.</p>
meillo@56: 
meillo@56: <b>-oem </b>option:<br>
meillo@56: 
meillo@56: <p>If the <b>-oi</b> ist not also given, always return with a non zero
meillo@56: return code. Maybe someone tells me what this is good for... </p>
meillo@56: 
meillo@56: <b>-odb </b>option:<br>
meillo@56: 
meillo@56: <p>Deliver in background. Masqmail always does this.</p>
meillo@56: 
meillo@56: <b>-odq </b>option:<br>
meillo@56: 
meillo@56: <p>Do not attempt to deliver immediately. Any messages will be queued
meillo@56: until the next queue running process picks them up and delivers
meillo@56: them. You get the same effect by setting the <i>do_queue</i> option in
meillo@56: /etc/masqmail.conf.</p>
meillo@56: 
meillo@56: <b>-oi </b>option:<br>
meillo@56: 
meillo@56: <p>A dot as a single character in a line does <em>not</em> terminate
meillo@56: the message.</p>
meillo@56: 
meillo@56: <b>-q </b>option:<br>
meillo@56: 
meillo@56: <p>If not given with an argument, run a queue process, ie. try to
meillo@56: deliver all messages in the queue. Masqmail sends only to those
meillo@56: addresses that are on the <em>local</em> net, not to those that are
meillo@56: outside. Use -qo &lt;connection&gt; for those.</p>
meillo@56: 
meillo@56: <p>If you have configured inetd to start masqmail, you can use this
meillo@56: option in a cron job which starts in regular time intervals, to mimic
meillo@56: the same effect as starting masqmail with -bd -q30m.</p>
meillo@56: 
meillo@56: <p>An argument may be a time interval ie. a numerical value followed
meillo@56: by one of the letters. s,m,h,d,w which are interpreted as seconds,
meillo@56: minutes, hours, days or weeks respectively. Example: -q30m. Masqmail
meillo@56: starts as a daemon and a queue runner process will be started
meillo@56: automatically once in this time interval. This is usually used
meillo@56: together with -bd (see above).</p>
meillo@56: 
meillo@56: <b>-qo&lt;name&gt; </b>option:<br>
meillo@56: 
meillo@56: <p>Can be followed by a connection name. Use this option in your
meillo@56: script which starts as soon as a link to the internet has been set up
meillo@56: (usually ip-up). When masqmail is called with this option, the
meillo@56: specified route configuration is read and the queued mail with
meillo@56: destinations on the internet will be sent. The <b>name</b> is defined
meillo@56: in the configuration (see <b>connect_route.&lt;name&gt;</b>).</p>
meillo@56: 
meillo@56: <p>If called without &lt;name&gt, the online status is determined with
meillo@56: the configured method (see <b>online_detect</b> in <a
meillo@56: href="config.html">config.html</a>)</p>
meillo@56: 
meillo@56: <b>-t </b>option:<br>
meillo@56: 
meillo@56: <p>Read recipients from headers. Delete 'Bcc:' headers. If any
meillo@56: arguments are given, these are interpreted as recipient addresses and
meillo@56: the message will <em>not</em> be sent to these.</p>
meillo@56: 	  </td></tr>
meillo@56:     
meillo@56: 	<tr><td>
meillo@56: 	    <p>
meillo@56: 	    <hr>
meillo@56: 	    <address><a href = "mailto:kurth@innominate.de">Oliver Kurth</a></address>
meillo@56: 	    Last modified: Tue May 30 15:19:56 CEST 2000
meillo@56: 	    <br>
meillo@56: 	    This page was created using <a href="http://www.freddyfrog.com/hacks/genpage/">Genpage</a> - Version: 1.0.6
meillo@56: 	  </p>
meillo@56:     
meillo@56:       </table>
meillo@56:     </center>
meillo@56: 
meillo@56:   </BODY>
meillo@56: </HEAD>
meillo@56: