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.