#### 3.7.1 Movemail Configuration ¶

The following configuration file statements affect the behavior of `movemail`:

Movemail Config: preserve bool ¶

  If bool is ‘`true`’, do not remove messages from the source mailbox.

Movemail Config: emacs bool ¶

  If bool is ‘`true`’, output information used by Emacs rmail interface.

Movemail Config: ignore-errors bool ¶

  Continue moving messages after errors. By default, `mailfromd` exits immediately if it cannot copy a message.

Movemail Config: program-id fmt ¶

  Set program identifier, i.e. a string which will prefix all diagnostic messages issued by the program. By default, program name is used.

  The fmt is a format string that may contain references to the following variables (see Configuration Variables):

  `progname`

    The program name.

  `source`

    URL of the source mailbox.

  `source_user`

    User part of the source mailbox URL.

  `source_host`

    Host part of the source mailbox URL.

  `source_path`

    Path part of the source mailbox URL.

  `dest`

    URL of the destination mailbox

  `dest_user`

    User part of the destination mailbox URL.

  `dest_host`

    Host part of the destination mailbox URL.

  `dest_path`

    Path part of the destination mailbox URL.

  Setting `program-id` may be necessary if several `movemail` instances are run simultaneously (e.g. invoked from a script) to discern between the instances. For example:

      program-id "${progname}: ${source} => ${dest}"

Movemail Config: sync mode ¶

  Sets the synchronization mode to use. Synchronization mode defines the algorithm `movemail` uses to decide whether the given message has already been downloaded. Used together with `--keep` it allows the user to download only recently delivered messages. See Synchronizatiom Mode, for a detailed description.

  Allowed values for mode are `all`, `uidnext`, and `uidl`.

Movemail Config: uidl bool ¶

  Same as `sync uidl`, i.e. avoid copying the message if a message with the same UIDL already exists in the destination mailbox. See Synchronizatiom Mode, for a detailed description.

Movemail Config: verbose level ¶

  Set verbosity level.

Movemail Config: mailbox-ownership method-list ¶

  Define list of methods for setting ownership of the destination mailbox. The method-list argument can contain the following elements:

  copy-id

    Copy owner UID and GID from the source mailbox. This method works only with local mailboxes, i.e.: ‘`mbox`’ (UNIX mailbox), ‘`maildir`’ and ‘`mh`’.

  copy-name

    Get owner name from the source mailbox URL and obtain UID and GID for this user using mailutils authorization methods.

  set-id=uid[:gid]

    Set supplied uid and gid. If gid is not supplied, it is read from the `/etc/passwd` record for this UID.

  set-name=user

    Make destination mailbox owned by user.

Movemail Config: max-messages count ¶

  Retrieve no more than count latest messages.

  By default, the number of messages is not limited.

Movemail Config: onerror actions ¶

  Defines what to do if an error occurs when transferring a message. actions is a list of one or more of the following keywords:

  abort

    Abort the transfer and terminate the program. This is the default action.

  skip

    Skip to the next message.

  delete

    Delete the affected message.

  count

    Count this message as processed.

  Each keyword can be prefixed with ‘`no`’ to reverse its meaning.

The following standard Mailutils statements are supported:

Statement | Reference
--- | ---
debug | See The `debug` Statement.
tls | See The `tls` Statement.
mailbox | See The `mailbox` Statement.
locking | See The `locking` Statement.
pam | See PAM Statement.
sql | See The `sql` Statement.
virtdomain | See The `virtdomain` Statement.
radius | See The `radius` Statement.
ldap | See The `ldap` Statement.
auth | See The `auth` Statement.