[POP3] Section

In the [POP3] section, settings for drweb-pop3 module are specified (the POP3 filter component used to intercept mail via POP3 protocol when working with mail clients ):

ServerAddress = {address}

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

Default value:

ServerAddress = inet:pop3@localhost

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 POP3S protocol to be used by the POP3 filter.

Default value:

ListenAddress = inet:5110@localhost

ServerTLSSettings = {TLS/SSL settings}

TLS/SSL settings for server communications over POP3.

Settings are separated by commas. It is possible to connect as TSL/SSL server only if a 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 POP3 filter (usually, drweb user), must have read access to the file with the certificate.

Default value:

ServerTLSSettings =

ClientTLSSettings = {TLS/SSL settings}

TLS/SSL settings for client communications over POP3.

Settings are separated by commas.

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 POP3 filter (usually, drweb user), must have read access to the file with the certificate.

Default value:

ClientTLSSettings =

IoTimeout = {time}

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

Default value:

IoTimeout = 60s

ProcessingTimeout = {time}

Timeout for drweb-maild to process messages.

Default value:

ProcessingTimeout = 60s

MinFilterToMaildConnections = {numerical value}

Minimum number of connections between the POP3 filter and drweb-maild.

Default value:

MinFilterToMaildConnections = 2

MaxFilterToMaildConnections = numerical value}

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

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

Default value:

MaxFilterToMaildConnections = 0

FilterToMaildKeepAliveTime = {time}

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

To interact with drweb-maild, POP3 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, the connections are closed. At that, total amount of opened connections cannot be less than the value specified in the MinFilterToMaildConnections parameter.

Default value:

FilterToMaildKeepAliveTime = 30s

PoolOptions = {pool options}

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.

Default value:

PoolOptions = auto

CallbackPoolOptions = {pool options}

Settings of an auxiliary thread pool.

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

Default value:

CallbackPoolOptions = auto

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.

Default value:

MaxConnections = 0

DoS_Blackhole = {logical}

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

Default value:

DoS_Blackhole = no

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.

Default value:

DisablePlainText = no

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 incoming connections is not limited.

Default value:

MaxConnectionsPerIp = 0

MaxCommandLength = {size}

Maximum size of a command for the POP3 protocol.

Each command is a string, which is sent from the 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.

Default value:

MaxCommandLength = 1000b

OnFilterErrors = {action}

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.

Default value:

OnFilterErrors = reject