ServerAddress = {address}

Address used by the filter to connect to the IMAP server.

ListenAddress = {address list}

A list of socket addresses used to receive requests from clients.

The following types of addresses can be specified: inet:.. or inet-ssl:.. (if you use TLS/SSL encryption). The latter address type requires IMAPS protocol to be used by the IMAP filter.

ServerTLSSettings = {TLS/SSL settings}

TLS/SSL settings for server communications over IMAP.

It is possible to connect as TSL/SSL server only if a certificate (certificate) and private key (private_key_file) are specified and inet-ssl socket is used.

Example:

ServerTLSSettings = use_sslv2 no, private_key_file /path/to/pkey, certificate  /path/to/certificate

Please note that the user whose privileges are used by the IMAP filter (usually, drweb user), must have read access to the file with the certificate.

In the current program version caching of SSL sessions is not supported.

ClientTLSSettings = {TLS/SSL settings}

TLS/SSL settings used for client communications over IMAP.

Example:

ClientTLSSettings = use_sslv2 no, private_key_file /path/to/pkey, certificate /path/to/certificate

Please note that the user whose privileges are used by the IMAP filter (usually, drweb user), must have read access to the file with the certificate.

In the current program version caching of SSL sessions is not supported.

IoTimeout = {time}

Timeout for all input-output operations with the client's socket, when operation is in progress.

ProcessingTimeout = {time}

Timeout for drweb-maild to process messages.

MinFilterToMaildConnections ={numerical value}

Minimum number of connections between IMAP filter and drweb-maild.

MaxFilterToMaildConnections ={numerical value}

Maximum number of connections between IMAP filter and drweb-maild module.

When the value is set to 0, number of connections is not limited.

FilterToMaildKeepAliveTime = {time}

Maximum period for retention of inactive connections between IMAP filter and drweb-maild if number of connections exceeds the specified minimum.

To interact with drweb-maild, IMAP filter maintains several connections with it, and each connection can handle one operation. If no more connections are available, new connections are created until their amount reaches the maximum allowed (specified in the MaxFilterToMaildConnection parameter value).

If connections are inactive during a time period specified in the FilterToMaildKeepAliveTime parameter, they are closed. Total amount of opened connections cannot be less than the value specified in the MinFilterToMaildConnections parameter.

CallbackPoolOptions = {pool options}

Settings of an auxiliary thread pool.

Threads handle end of message processing signals from the drweb-maild.

PoolOptions = {pool seoptions}

Settings of the main thread pool.

These threads handle connections from clients. Each connection requires a new thread, otherwise some clients are disconnected while waiting for a free thread.

MaxConnections = {numerical value}

Maximum number of incoming connections.

If 0 is specified as a value of this parameter, the number of incoming connections is not limited.

MaxConnectionsPerIp = {numerical value}

Maximum number of simultaneous connections from one IP address.

If 0 is specified as a value of this parameter the number of connections is not limited.

DisablePlainText = {logical}

Do not allow the client to send login and password as plain text (in an unencrypted format).

It requires OpenSSL to be configured in advance.

DoS_Blackhole = {logical}

Enables to drop connection without sending an error message to a client if there are too many simultaneous connections from one IP address.

MaxCommandLength = {size}

Maximum size of a command for the IMAP protocol.

Each command is a string sent from a client to the server. Maximum possible size of this command is about 1000 bytes according to the current RFC.

Please note that if this parameter value is small (less than 10 bytes), clients' commands are not processed.

MaxCachedHeadersPerMail = {size}

Maximum amount of memory to be allocated to store frequently used headers.

IMAP filter caches main message headers in random access memory to speed up access to them.

If 0 is specified as a value of this parameter, amount of allocated memory is not controlled (memory size is restricted only to the size of available memory).

MaxLettersPerUser = {numerical value}

Maximum number of messages to be cached during one session.

IMAP filter maintains cache of checked messages because IMAP protocol allows the client to perform lots of partial requests to one message.

In most cases requests are performed sequentially, but if a user accesses several records, it is necessary to cache more than one message.

If the value of this parameter is set to 0 (which is strongly NOT recommended), number of cached messages is unlimited.

MaxDiskPerUSer = {size}

Maximum amount of disk space to be occupied by cached messages.

OnFilterErrors = {actions}

Action to be applied to the message, when an error occurs before the message is transmitted to the drweb-maild module.

Possible values are reject or pass.