Секция [Filters]

В секции [Filters] сосредоточены общие настройки работы подключаемых модулей Dr.Web MailD:

 

LibDir = {путь к каталогу}

Каталог, в котором располагаются подключаемые модули Dr.Web MailD.

Значение по умолчанию:

LibDir = %bin_dir/maild/plugins/

 

Settings = {список настроек}

Параметры запуска подключаемых модулей.

Настройки модулей перечисляются через запятую в следующем формате:

<настройки_модуля>, <настройки_модуля>..., где

<настройки_модуля> – это строка
<название_модуля>: <параметр1>|...|<параметрN>,

<параметрN> – это пара
имя_параметра = значение_параметра.

Пример:

Settings = vaderetro: max_size = 400k|log_level=debug, drweb: max_size = 10m

Эта строка устанавливает для подключаемого модуля Vaderetro максимальный размер сообщения в 400 Кб и уровень подробности журнала в Debug, а для подключаемого модуля Drweb – максимальный размер сообщения в 10 Мб.

Полный перечень параметров, которые могут задаваться в параметре Settings, перечислен ниже.

Значения параметров (за исключением путей к файлам и имен файлов в UNIX) регистронезависимы.

Значение по умолчанию:

Settings =

 

BeforeQueueFilters = {список строк}

Список имен подключаемых модулей, обрабатывающих письмо до его помещения в хранилище сообщений (в синхронном режиме before-queue).

Значение по умолчанию:

BeforeQueueFilters =

 

MaxSizeBeforeQueueFilters = {размер}

Максимальный размер письма для обработки подключаемыми модулями, указанными в параметре BeforeQueueFilters.

Используется только для тех подключаемых модулей, для которых значение параметра max_size (см. ниже) не задано явным образом в параметре Settings или в Правилах.

При значении 0 ограничения отсутствуют.

Значение по умолчанию:

MaxSizeBeforeQueueFilters =

 

AfterQueueFilters = {список строк}

Список имен подключаемых модулей, обрабатывающих письмо после его помещения в хранилище сообщений (в асинхронном режиме after-queue).

Значение по умолчанию:

AfterQueueFilters =

 

MaxSizeAfterQueueFilters = {размер}

Максимальный размер письма для обработки подключаемыми модулями, указанными в параметре AfterQueueFilters.

Используется только для тех подключаемых модулей, для которых значение параметра max_size (см. ниже) не задано явным образом в параметре Settings или в Правилах.

При значении 0 ограничения отсутствуют.

Значение по умолчанию:

MaxSizeAfterQueueFilters = 0

 

PluginsBaseDir = {путь к каталогу}

Путь к каталогу, в котором хранятся рабочие файлы, используемые подключаемыми модулями.

Например, в этом каталоге подключаемый модуль Vaderetro ищет файл используемой им библиотеки VadeRetro.

Значение по умолчанию:

PluginsBaseDir = %var_dir/plugins/

В текущей версии Dr.Web для почтовых серверов UNIX для каждого подключаемого модуля могут быть заданы индивидуальные значения параметров, перечисленные в таблице ниже. При этом в параметре Settings имя параметра для модуля указывается в формате <название_модуля>: <параметр>, а если параметр может быть использован в Правилах обработки почты, то там используется формат <название_модуля>/<параметр>.

 

section = {текст}

Название секции в конфигурационном файле подключаемого модуля, в которой задаются настройки его работы (как правило, конфигурационный файл такого модуля состоит из одной секции).

Если имя секции не указано, то используется секция с именем модуля.

Параметр может использоваться в ПравилахПараметр поддерживает клонирование в Правилах

max_size = {размер}

Максимальный разрешенный для подключаемого модуля размер проверяемого сообщения.

При значении 0 ограничения отсутствуют.

Ограничение на размер по умолчанию зависит от того, в какой очереди (BeforeQueueFilters или AfterQueueFilters) запускается модуль, и определяется, соответственно, значением параметра MaxSizeBeforeQueueFilters или MaxSizeAfterQueueFilters.

Использование параметра в Правилахфайле конфигурации):

[Rules]

#Правило, истинное для всех писем

true cont plugin_name/max_size = {размер}

Пример:

[Rules]

...

#Для писем с адреса admin@domain.com установить max_size модуля Drweb в величину 100k

from:admin@domain.com cont drweb/max_size = 100k

Параметр может использоваться в Правилах

log_level = {уровень подробности}

Уровень подробности ведения журнала работы подключаемого модуля.

Допустимые значения:

Quiet

Error

Alert

Info

Debug

Значение параметра по умолчанию совпадает со значением параметра Level секции [Logging]

Параметр может использоваться в Правилах

log_ipc_level = {уровень подробности}

Уровень подробности ведения журнала работы библиотеки IPC.

Допустимые значения:

Quiet

Error

Alert

Info

Debug

Значение параметра по умолчанию совпадает со значением параметра IpcLevel секции [Logging]

Параметр может использоваться в Правилах

syslog_facility = {метка syslog}

Метка записи в журнал при использовании системного сервиса syslog

Значение параметра по умолчанию совпадает со значением параметра SyslogFacility секции [Logging].

 

log_filename = {syslog | путь к файлу}

Путь к файлу журнала или syslog, если журнал ведется с помощью системной службы syslog

Параметр может использоваться в Правилах

path_to_lib = {путь к файлу}

Путь к динамически загружаемой библиотеке подключаемого модуля, если имя библиотеки модуля не соответствует правилам именования lib<plugin_name>.so или если она расположена не в каталоге, заданном в параметре LibDir.

Путь может быть как абсолютным, так и относительным. Относительный путь задается от каталога, указанного в параметре LibDir.

Значение по умолчанию:

path_to_lib = LibDir/lib<plugin_name>.so

warning

Обратите внимание, что  если основное количество писем является "тяжелыми" письмами (с большими вложениями, или с большим количеством малых вложений), то их проверка подключаемыми модулями будет осуществляться долго. В этом случае перемещение подключаемых модулей в очередь BeforeQueueFilters не рекомендуется, поскольку это замедляет взаимодействие с MTA при передаче писем.

Кроме того в этом случае возможно возникновение проблем при проверке писем из-за некорректно заданной (малой) величины тайм-аута IpcTimeout (секция [General]), что может привести к их потере (недоставке получателю без соответствующего уведомления об этом отправителя).