2.10.1 Invoking mail.local

General usage of mail.local program is:

           mail.local [option...] recipient [recipient ...]

If recipient part is present is a FQDN, mail.local will attempt to deliver to a virtual host.

The program uses following option groups: See mailbox, See auth, See logging, See sieve.

-f addr

--from addr

Specify the sender's name. This option forces mail.local to add ‘From ’ envelope to the beginning of the message. If it is not specified, mail.local first looks into the first line from the standard input. If it starts with ‘From ’, it is assumed to contain a valid envelope. If it does not, mail.local creates the envelope by using current user name and date.

-h

--help

Display usage summary and exit.

-L

--license

Display gnu General Public License and exit.

-m path

--mail-spool path

Specify path to mailspool directory.

-q

--quota-db file

Specify path to DBM mailbox quota database (see Mailbox Quotas).

--quota-query

Specify SQL query that should be used to obtain user mailbox quotas from the SQL database (see Mailbox Quotas).

-s pattern

--source pattern

Set name pattern for user-defined mail filters written in Scheme (see Scheme Filters). The metacharacters ‘%u’ and ‘%h’ in the pattern are expanded to the current recipient user name and home directory correspondingly.

This option is available only if the package has been configured to use Guile extension language.

-S pattern

--sieve pattern

Set name pattern for user-defined mail filters written is Sieve (see Sieve Filters). The metacharacters ‘%u’ and ‘%h’ in the pattern are expanded to the current recipient user name and home directory correspondingly.

-t number

--timeout number

Wait number seconds for acquiring the lockfile. If it doesn't become available after that amount of time, return failure. The timeout defaults to 5 minutes.

-x flags

--debug flags

Enable debugging. The debugging information will be output using syslog. The flags is a string consisting of the following flags: Debug flags are:

‘g’

Start with guile debugging evaluator and backtraces. This is convenient for debugging user-defined filters (see Scheme Filters).

‘T’

Enable libmailutil traces (MU_DEBUG_TRACE).

‘P’

Enable network protocol traces (MU_DEBUG_PROT)

‘t’

Enable sieve trace (MU_SIEVE_DEBUG_TRACE)

‘l’

Enable sieve action logs

The digits in the range ‘0’ – ‘9’ used in flags set mail.local debugging level.

-v

--version

Display program version and exit.

--ex-multiple-delivery-success

Don't return errors when delivering to multiple recipients.

--ex-quota-tempfail

Return temporary failure if disk or mailbox quota is exceeded. By default, 'service unavailable' is returned if the message exceeds the mailbox quota.