#### 3.17.2 Configuration of `imap4d`. ¶

The behavior of `imap4d` is altered by the following configuration statements:

Statement | Reference
--- | ---
debug | See The `debug` Statement.
tls | See The `tls` Statement.
tls-file-checks | See The `tls-file-checks` Statement.
mailbox | See The `mailbox` Statement.
locking | See The `locking` Statement.
logging | See The `logging` 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.
server | See Server Settings.
acl | See The `acl` Statement.
tcp-wrappers | See The `tcp-wrappers` Statement.

Imap4d Conf: namespace name { ... } ¶

  Configures namespace. The argument is one of: ‘`personal`’, ‘`other`’, ‘`shared`’. The following statements (described below) are allowed within curly braces: `mailbox-mode` and `prefix`.

  See Namespace.

Imap4d namespace: mailbox-mode mode ¶

  Configures the file mode for the mailboxes created within that namespace. The syntax for mode is:

      g(+|=)[wr]+,o(+|=)[wr]+

  See mailbox-mode.

Imap4d namespace: prefix pfx { ... } ¶

  Configures a prefix and determines its mapping to the server’s file system. The pfx argument is the prefix which will be visible to the IMAP client. Available sub-statements are: `directory`, `delimiter`, and `mailbox-type`.

  See prefix.

Imap4d namespace.prefix: directory path ¶

  Defines the directory in the file system to which the prefix is mapped.

  See directory.

Imap4d namespace.prefix: delimiter chr ¶

  Defines the folder hierarchy delimiter for the prefix. Argument must be a single character.

  See delimiter.

Imap4d namespace.prefix: mailbox-type type ¶

  Defines the type of the mailboxes inside that prefix.

  See mailbox-type.

Imap4d Conf: login-disabled bool ¶

  Disable `LOGIN` command, if bool is ‘`true`’.

Imap4d Conf: create-home-dir bool ¶

  Create nonexistent user home directories. See also home-dir-mode, below.

Imap4d Conf: home-dir-mode mode ¶

  Set file mode for created user home directories. Mode is specified in octal.

  The default value for mode is ‘`700`’ (‘`drwx------`’ in `ls` terms).

Imap4d Conf: preauth mode ¶

  Configure PREAUTH mode. Valid arguments are:

  prog:///program-name

    `Imap4d` invokes an external program to authenticate the connection. The command line is obtained from the supplied string, by expanding the following meta-variables:

    `${client_address}`

      Remote IP address in dotted-quad notation;

    `${client_port}`

      Remote port number;

    `${server_address}`

      Local IP address;

    `${server_port}`

      Local port number.

    If the connection is authenticated, the program should print the user name, followed by a newline character, on its standard output and exit with code ‘`0`’.

    Otherwise, it should exit with a non-zero exit code.

  ident[://:port]

    The remote machine is asked about the requester identity using the identification protocol (RFC 1413). Both plaintext and DES encrypted replies are understood. Optional port specifies the port to use, if it differs from the default ‘`113`’. It can be either a decimal port number or a symbolic name of a service, listed in `/etc/services`.

  stdio

    PREAUTH mode is enabled automatically if imap4d is started from command line in interactive mode (`-i` command line option). The current login name is used as the user name.

Imap4d Conf: preauth-only bool ¶

  If bool is ‘`true`’, use only preauth mode. If unable to setup it, disconnect immediately.

Imap4d Conf: ident-keyfile file ¶

  Set DES keyfile for decoding encrypted ident responses. Used with ‘`ident://`’ preauth mode.

Imap4d Conf: ident-encrypt-only bool ¶

  Use only encrypted IDENT responses.

Imap4d Conf: id-fields list ¶

  Set list of fields to return in response to ID command.

  Valid field names are:

  name

    Package name (‘`GNU Mailutils`’).

  version

    Package version (‘`3.20`’).

  vendor

    Vendor name (‘`GNU`’).

  support-url

    The string ‘`http://www.gnu.org/software/mailutils`’

  address

    The string ‘`31 Milk Street, Boston, MA 02196 USA`’.

  os

    OS name.

  os-version

    OS version number.

  command

    Name of the `imap4d` binary.

  arguments

    Invocation command line.

  environment

    List of environment variables with their values.