|
Параметры командной строки
Как и для любых UNIX-программ, для всех модулей, входящих в состав Dr.Web MailD, предусмотрены параметры командной строки. Формат командной строки для запуска модулей программного комплекса следующий:
<название модуля> [<параметры>] <сокет Агента>
где:
•<название модуля> - название модуля; •<параметры> - необязательные параметры командной строки; •<cокет Агента> - сокет, через который модуль при запуске будет получать конфигурационную информацию от компонента Dr.Web Agent. Общие параметры
Все текущей версии все модули, входящие в состав Dr.Web MailD, поддерживают следующие параметры командной строки:
Краткий вариант
|
Расширенный вариант
|
Аргументы
|
-h
|
--help
|
|
Описание: Вывод на экран консоли краткой справки по имеющимся параметрам командной строки и завершение работы модуля
|
|
-v
|
--version
|
|
Описание: Вывод на экран консоли информации о текущей версии модуля и завершение работы модуля
|
|
-l
|
--level
|
<уровень>
|
Описание: Уровень детализации ведения журнала запуска компонента (значение по умолчанию: info)
|
|
-t
|
--timeout
|
<число секунд>
|
Описание: Максимальное время ожидания получения конфигурационных данных от Dr.Web Agent
|
|
|
--log-name
|
<имя компонента>
|
Описание: Имя компонента, под которым он будет выводить сообщения в журнал (лог)
|
|
|
--component
|
<имя компонента>
|
Описание: Имя компонента, под которым модуль будет обращаться к Dr.Web Agent для получения конфигурации.
Обратите внимание, что этот параметр командной строки отсутствует у модуля drweb-zmailer!
|
|
|
--check-only
|
|
Описание: Запуск модуля в режиме проверки конфигурации. Для корректной функциональности опции предварительно должен быть запущен Dr.Web Agent. При успешной проверке конфигурации на консоль выводится сообщение "Options OK", а при неудаче выводится описание проблемы и сообщение "Options ERROR".
Обратите внимание, что этот параметр командной строки отсутствует у модуля drweb-zmailer!
|
Пример:
Введенная в командной строке консоли операционной системы команда
$ drweb-maild -t 30 local:%var_dir/ipc/.agent
Запускает модуль компонента MailD core со временем ожидания конфигурационных данных в 30 секунд и указанием на сокет Dr.Web Agent local:%var_dir/ipc/.agent.
Параметры, специфические для модулей
У различных модулей, входящих в состав Dr.Web MailD, кроме общих, имеются также дополнительные параметры командной строки, зависящие от специфики модуля. Исключение составляют модули drweb-notifier и drweb-proxy-client, которые не имеют параметров кроме тех, которые перечислены выше.
1. drweb-maild
Специфические параметры командной строки этого модуля используются для проверки корректности заданных Правил обработки почты:
Краткий вариант
|
Расширенный вариант
|
Аргументы
|
-s
|
--sender
|
<почтовый адрес>
|
Описание: Адрес отправителя письма (из конверта)
|
|
-r
|
--recipient
|
<почтовый адрес>
|
Описание: Адрес получателя письма (из конверта). Для задания нескольких получателей нужно несколько раз указать данный параметр
|
|
-b
|
--block
|
<имя объекта>
|
Описание: Имя блокирующего объекта, найденного в письме (например, название вируса). Для задания нескольких блокирующих объектов нужно несколько раз указать данный параметр
|
|
|
--client-ip
|
<IP-адрес>
|
Описание: IP-адрес клиента, от которого получено письмо
|
|
|
--server-ip
|
<IP-адрес>
|
Описание: IP-адрес интерфейса сервера, на который получено письмо
|
|
|
--client-port
|
<номер порта>
|
Описание: Порт клиента, с которого было получено письмо
|
|
|
--server-port
|
<номер порта>
|
Описание: Порт сервера, на который было получено письмо
|
|
|
--server-us
|
<UNIX-сокет>
|
Описание: Название UNIX-сокета сервера, на который получено письмо
|
|
|
--id
|
<идентификатор>
|
Описание: Уникальный идентификатор компонента Receiver, от которого получено письмо
|
|
|
--auth
|
|
Описание: Отметка, что письмо получено от авторизованного пользователя
|
|
|
--size
|
<размер>
|
Описание: Размер проверяемого письма (значение имеет тип size)
|
|
|
--score
|
<счет>
|
Описание: Счет, присвоенный письму (число)
|
|
|
--md-client
|
<имя Клиента MailDesk>
|
Описание: Уникальный идентификатор Клиента MailDesk
|
2. У остальных модулей (кроме drweb-zmailer) имеются два специфических параметра, используемых для организации работы с несколькими компонентами Sender и Receiver одновременно:
Краткий вариант
|
Расширенный вариант
|
Аргументы
|
|
--unique-id
|
<идентификатор>
|
Описание: Уникальный идентификатор компонента. Данная настройка позволяет компоненту MailD core осуществлять работу с несколькими экземплярами компонентов Receiver и Sender. Для этого каждый новый Receiver и Sender должен запускаться со своим уникальным идентификатором. Для отправки письма будет выбираться Sender с тем же идентификатором, что и у Receiver, или Sender по умолчанию, если для Receiver не был найден соответствующий Sender.
Список доступных компонентов Sender переинициализируется через сигнал SIGHUP
Ниже указан смысл идентификатора компонента для каждого из модулей с точки зрения MailD core:
•drweb-receiver - Идентификатор компонента Receiver; •drweb-sender - Идентификатор компонента Sender; •drweb-proxy-server - Общий идентификатор пары компонентов Receiver и Sender, взаимодействующих с MailD core через этот компонент (см. Проксирование) •drweb-imap - Идентификатор компонента IMAP filter (используется аналогично идентификатору компонента Receiver для поиска соответствующего Sender); •drweb-pop3 - Идентификатор компонента POP3 filter (используется аналогично идентификатору компонента Receiver для поиска соответствующего Sender); •drweb-milter - Идентификатор компонента Receiver; •drweb-cgp-receiver - Идентификатор компонента Receiver; •drweb-cgp-sender - Идентификатор компонента Sender; •drweb-courier - Идентификатор компонента Receiver; •drweb-qmail - Идентификатор компонента Receiver. |
|
|
--section
|
<имя секции>
|
Описание: Имя секции в конфигурационном файле, из которой данный модуль будет извлекать свои настройки компонента. Если данный параметр не указан, будет использована секция компонента по умолчанию.
Ниже указаны секции по умолчанию для каждого модуля:
•drweb-receiver - [Receiver] •drweb-sender - [Sender] •drweb-proxy-server - [ProxyServer] •drweb-imap - [IMAP] •drweb-pop3 - [POP3] •drweb-milter - [Milter] •drweb-cgp-receiver - [CgpReceiver] •drweb-cgp-sender - [CgpSender] •drweb-courier - [Courier] •drweb-qmail - [Qmail] |
3. drweb-zmailer
Специфические параметры командной строки этого модуля:
Краткий вариант
|
Расширенный вариант
|
Аргументы
|
-u
|
--user
|
<имя пользователя>
|
Описание: Имя учетной записи пользователя, с правами которого запущен модуль drweb-maild.
Обратите внимание, что если этот параметр не указан, то drweb-zmailer запустится с правами суперпользователя root, что может привести к проблемам взаимодействия с модулем drweb-maild, если он работает не с правами суперпользователя root
|
|
-i
|
--ipclevel
|
<уровень подробности>
|
Описание: Уровень подробности ведения журнала событий библиотеки IPC, используемый модулем drweb-zmailer.
Допустимые значения: quiet, error, alert, info, debug
|
|
-f
|
--facility
|
<метка syslog>
|
Описание: Используемая метка syslog (если журнал ведется при помощи системной службы syslog).
Допустимые значения: daemon, mail, local0, ..., local7
|
|
-b
|
--basedir
|
<путь к каталогу>
|
Описание: Путь к основному каталогу, в котором расположены модули Dr.Web MailD
|
|
|
--id
|
<идентификатор>
|
Описание: Аналогичен параметру --unique-id у других компонентов (см. выше). С точки зрения MailD core трактуется как иентификатор компонента Receiver
|
|
|
--log-filename
|
<имя файла журнала>
|
Описание: Имя используемого файла журнала или syslog, если журнал ведется при помощи системной службы syslog
|
|
|
--file
|
<путь к файлу>
|
Описание: Путь к файлу, который должен быть обработан при запуске модуля
|
|
|
--hash
|
<значение>
|
Описание: Значение параметра SecureHash из секции [Sender] основного конфигурационного файла Dr.Web MailD
|
|
|
--interface
|
<0|1>
|
Описание: Обозначение версии используемого smtpserver: 0 – для версии 2.99.55 или более ранней, 1 – для версии 2.99.56 или более поздней
|
|
-e
|
--error-action
|
<действие>
|
Описание: Действие, применяемое в случае если произойдет внутренняя ошибка в модуле при обработке письма.
Допустимые значения: pass, reject, discard, tempfail
|
|
-Z
|
|
<путь к файлу>
|
Описание: Путь к конфигурационному файлу ZMailer, который будет игнорироваться
|
Обратите внимание, что параметры командной строки утилит в данном разделе не рассматриваются. Параметры командной строки, используемые утилитами, указаны в описаниях этих утилит.
|