manual Options Installation Alias Format

Since masqmail is intended to replace sendmail, it uses the same command line options, but not all are implemented. There are also two additional options, which are unique to masqmail (-qo <connection> and -g)

-- option:

Not a 'real' option, it means that all following arguments are to be understood as arguments and not as options even if they begin with a leading dash '-'. Mutt is known to call sendmail with this option.

-bd option (daemon):

Run as daemon, accepting connections, usually on port 25 if not configured differently. This is usually used in the startup script and together with the -q option (see below).

-bi option:

Old sendmail rebuilds its alias database when invoked with this option. Masqmail ignores it. Masqmail reads directly from the file given with alias_file in the config file.

-bp option:

Show the messages in the queue. Same as calling masqmail as 'mailq'.

-bs option:

Accept SMTP commands from stdin. Some mailers (eg pine) use this option as an interface. It can also be used to call masqmail from inetd, according to Tomislav Filipcic this works.

-B<arg>option:

arg is usually 8BITMIME. Some mailers use this to indicate that the message contains characters > 127. Masqmail is 8-bit clean and ignores this, so you do not have to recompile elm, which is very painful ;-). Note though that this violates some conventions: masqmail does not convert 8 bit messages to any MIME format if it encounters a mail server which does not advertise its 8BITMIME capability, masqmail does not advertise this itself. This is the same practice as that of exim (but different to sendmail).

This may change in the future, but do not rely on it.

-C<filename>option:

Use another configuration than /etc/masqmail.conf. Useful for debugging purposes.

-d <number> option:

Set the debug level. This takes precedence before the value of debug_level in the configuration file. Read the warning in the description of the latter.

-g option:

Get mail, using the configurations given with get.<name> in the main configuration.

-i option:

Same as -oi, see below.

-oem option:

If the -oi ist not also given, always return with a non zero return code. Maybe someone tells me what this is good for...

-odb option:

Deliver in background. Masqmail always does this.

-odq option:

Do not attempt to deliver immediately. Any messages will be queued until the next queue running process picks them up and delivers them. You get the same effect by setting the do_queue option in /etc/masqmail.conf.

-oi option:

A dot as a single character in a line does not terminate the message.

-q option:

If not given with an argument, run a queue process, ie. try to deliver all messages in the queue. Masqmail sends only to those addresses that are on the local net, not to those that are outside. Use -qo <connection> for those.

If you have configured inetd to start masqmail, you can use this option in a cron job which starts in regular time intervals, to mimic the same effect as starting masqmail with -bd -q30m.

An argument may be a time interval ie. a numerical value followed by one of the letters. s,m,h,d,w which are interpreted as seconds, minutes, hours, days or weeks respectively. Example: -q30m. Masqmail starts as a daemon and a queue runner process will be started automatically once in this time interval. This is usually used together with -bd (see above).

-qo<name> option:

Can be followed by a connection name. Use this option in your script which starts as soon as a link to the internet has been set up (usually ip-up). When masqmail is called with this option, the specified route configuration is read and the queued mail with destinations on the internet will be sent. The name is defined in the configuration (see connect_route.<name>).

If called without <name>, the online status is determined with the configured method (see online_detect in config.html)

-t option:

Read recipients from headers. Delete 'Bcc:' headers. If any arguments are given, these are interpreted as recipient addresses and the message will not be sent to these.


Oliver Kurth
Last modified: Tue May 30 15:19:56 CEST 2000
This page was created using Genpage - Version: 1.0.6