---
name: "mail.local"
section: "8mailutils"
platform: "linux"
package: "mailutils"
version: "1:1.2+dfsg1-4"
release: "Debian 5.0 (Lenny)"
platforms: ["linux"]
url: "https://new.carta.tech/mail.local/8mailutils"
---

# mail.local(8mailutils)

the local MDA

## NAME

mail.local - the local MDA

## SYNOPSIS

**mail.local** \[*OPTION*...\] *recipient* \[*recipient* ...\]

## DESCRIPTION

GNU mail.local **--** the local MDA

- **--ex-multiple-delivery-success**

  Do not return errors when delivering to multiple recipients

- **--ex-quota-tempfail**

  Return temporary failure if disk or mailbox quota is exceeded

- **-f**, **-r**, **--from**=*EMAIL*

  Specify the sender's name

- **--message-id-header**=*STRING*

  Identify messages by the value of this header when logging Sieve actions

- **-q**, **--quota-db**=*FILE*

  Specify path to quota DBM database

- **--quota-query**=*STRING*

  SQL query to retrieve mailbox quota

- **-s**, **--source**=*PATTERN*

  Set name pattern for user-defined Scheme mail filters

- **-S**, **--sieve**=*PATTERN*

  Set name pattern for user-defined Sieve mail filters

- **-x**, **--debug**=*FLAGS*

  Enable debugging

-

  Authentication options

- **--authentication**=*MODLIST*

  Set the list of modules to be used for authentication

- **--authorization**=*MODLIST*

  Set list of modules to be used for authorization

- **--pam-service**=*STRING*

  Use STRING as PAM service name

- **--sql-db**=*STRING*

  Name of the database to connect to

- **--sql-field-map**=*MAP*

  Declare a name translation map for SQL fields in results of sql-getpwnam and sql-getpwuid queries

- **--sql-getpass**=*QUERY*

  SQL query to retrieve a password from the database

- **--sql-getpwnam**=*QUERY*

  SQL query to retrieve a passwd entry based on username

- **--sql-getpwuid**=*QUERY*

  SQL query to retrieve a passwd entry based on UID

- **--sql-host**=*HOSTNAME*

  Name or IP of MySQL server to connect to

- **--sql-interface**=*NAME*

  Type of SQL interface to use

- **--sql-passwd**=*STRING*

  SQL connection password

- **--sql-password-type**=*STRING*

  Type of password returned by **--sql-getpass** query. STRING is one of: plain, hash, scrambled

- **--sql-port**=*NUMBER*

  Port to use

- **--sql-user**=*NAME*

  SQL user name

- **--virtual-passwd-dir**=*DIR*

  Search for virtual passwd file in DIR

-

  Common options

- **--license**

  Print license and exit

- **--log-facility**=*FACILITY*

  Output logs to syslog FACILITY

**--external-locker**=*PATH* Set full path to the external locker program

- **--lock-expire-timeout**=*SECONDS*

  Number of seconds after which the lock expires

- **--lock-flags**=*FLAGS*

  Default locker flags (E=external, R=retry, T=time, P=pid)

- **--lock-retry-count**=*NUMBER*

  Set the maximum number of times to retry acquiring the lockfile

- **--lock-retry-timeout**=*SECONDS*

  Set timeout for acquiring the lockfile

- **-m**, **--mail-spool**=*URL*

  Use specified URL as a mailspool directory

- **--mailbox-type**=*PROTO*

  Default mailbox type to use

- **-M**, **--mailer**=*MAILER*

  Use specified URL as the default mailer

-

  Sieve options

- **--clearpath**

  Clear Sieve load path

- **-I**, **--includedir**=*DIR*

  Append directory DIR to the list of directories searched for include files

- **-L**, **--libdir**=*DIR*

  Append directory DIR to the list of directories searched for library files

- \-?, **--help**

  give this help list

- **--usage**

  give a short usage message

- **-V**, **--version**

  print program version

Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options.

### Debug flags are:

-

  g - guimb stack traces T - mailutils traces (MU\_DEBUG\_TRACE) P - network protocols (MU\_DEBUG\_PROT) t - sieve trace (MU\_SIEVE\_DEBUG\_TRACE) i - sieve instructions trace (MU\_SIEVE\_DEBUG\_INSTR) l - sieve action logs 0-9 - Set mail.local debugging level

## REPORTING BUGS

Report bugs to \<bug-mailutils@gnu.org\>.

## SEE ALSO

The complete GNU mailutils manual is not available in Debian systems due to licensing reasons. You can find this manual online in the GNU mailutils webpage:\
 http://www.gnu.org/software/mailutils/manual/index.html.