|
Команды для управления Карантином |
|
Для управления Карантином используются следующие команды: •quarantine-search [range:START/NUMBER] [sort:SORT_TYPE] [sender:EMAIL_SUBSTR] [rcpt:EMAIL_SUBSTR]* [period:DATE1[/DATE2]] [size:SIZE] [subject:'SUBJECT_SUBSTR'] [id:id-like] [order:ascent|descent] - поиск сообщений в Карантине по заданным критериям. Выводит письма, начиная со START (нумерация начинается с 0), и в количестве NUMBER элементов. Если START и NUMBER не указаны, то выводятся все найденные письма, удовлетворяющие остальным критериям. Значение NUMBER 0 означает вывод всех элементов. Используемые параметры: oSORT_TYPE - тип сортировки. Возможные значения: ▪date (по умолчанию) - сортировка по дате поступления писем в Карантин; ▪size - сортировка по размеру письма; ▪sender - сортировка по адресу отправителя; ▪subject - сортировка по теме письма. oEMAIL_SUBSTR - подстрока для поиска в полях rcpt или sender. operiod - период, за который будут выводиться письма. Если он не указан, то выводятся письма за весь период. oDATE1 - выводятся письма, которые попали в Карантин только после этого времени (включительно). oDATE2 - верхняя граница времени попадания письма в Карантин (включительно). Формат DATE соответствует ISO формату - YYYYMMDDTHHMMSS, где T – разделитель между временем и датой. Время задается и выводится как локальное время для хоста, на котором работает Dr.Web MailD. oSIZE - задает максимальный размер в байтах и возвращает только письма, размер которых превышает указанное значение. При значении 0 размер не ограничен. oSUBJECT_SUBSTR - заключенная в кавычки подстрока в оригинальной теме письма (т.е. до модификации письма компонентами программного комплекса). Если в подстроке нет пробелов, то окружающие кавычки можно опустить. Если кавычки присутствуют, то когда в имени встречается ', то перед ним должен ставиться повторный символ '. oorder - порядок, в котором возвращаются результаты (ascent - возрастающий, descent - убывающий). Значение по умолчанию: descent. Если в каком-либо из параметров допущена ошибка, то команда поиска не будет исполнена. Если задано несколько шаблонов получателей, то выдаются только письма, в которых содержатся все шаблоны (аналогично действию логического оператора AND). Для всех параметров, кроме rcpt, будет использоваться последнее заданное в командной строке значение, а для rcpt набор получателей будет увеличиваться с каждым новым введенным значением. Формат вывода: N. id SENDER RCTPS где: oN - порядковый номер найденного сообщения; oSENDER - отправитель письма из конверта; oRCPTS - получатели письма из конверта; oSUBJECT - тема письма. Выводится в кодировке UTF8; oSIZE - размер письма в байтах; oDATE - дата помещения письма в Карантин; oBLOCK_OBJECTN - блокирующий объект для этого письма. Примеры: # quarantine-search Возвращает список всех писем в Карантине, начиная с самых новых. # quarantine-search range:45/15 id:def/drweb/% Возвращает 15 самых новых сообщений в Карантине, пропустив первые 45 для подключаемого модуля Drweb. # quarantine-search rcpt:vasya@pupkin.com Возвращает все письма в Карантине, начиная с самых новых, среди получателей которых есть vasya@pupkin.com. # quarantine-search sort:size sender: period:20090101T100001/20090102T100000 size:5242880 id:def/vaderetro/% Выводятся в порядке уменьшения размера все сообщения, полученные для подключаемого модуля Vaderetro 1 января 2009 года с 10 утра до 10 утра следующего дня, и размер которых больше 5 мегабайт. Пример вывода: # quarantine-search •quarantine-count [range:START/NUMBER] [sort:SORT_TYPE] [sender:EMAIL_SUBSTR] [rcpt:EMAIL_SUBSTR]* [period:DATE1[/DATE2]] [size:SIZE] [subject:'SUBJECT_SUBSTR'] [id:id-like] [order:ascent|descent] - данная команда работает аналогично команде quarantine-search, только вместо самих сообщений выводится общее число найденных сообщений. Пример вывода: # quarantine-count •quarantine-remove id-like [part-of-email1, part-of-email2, ..] - удаляет заданных получателей (ищутся как подстрока) part-of-email1, part-of-email2, ... из конвертов писем, идентификатор которых совпадает с id-like (в конверте должны присутствовать все заданные получатели). Если у письма получателей не осталось или их список для удаления не указан, то письмо целиком удаляется из Карантина. Примеры: # quarantine-remove %/backup/% drweb.com> Из Карантина и бэкапа удаляются письма всех получателей, адреса которых заканчиваются на drweb.com. # quarantine-remove % <foo@dwreb.com> <foo2@dwreb.com> Из Карантина и бэкапа удаляются все письма, в получателях которых присутствуют одновременно foo@dwreb.com и foo2@dwreb.com. •quarantine-limits - вывод текущих ограничений, установленных для Карантина. Формат вывода: client-id: NUMBER/MAX-NUMBER SIZE/MAX-SIZE где: oNUMBER/MAX-NUMBER - текущее/максимальное число сообщений. Если максимальное значение не установлено, то выводится 0. oSIZE/MAX-SIZE - текущий/максимальный размер сообщений в Карантине (в байтах). Если максимальное значение не установлено, то выводится 0. oclient-id - строка "def". ototal - информация по всей базе данных. •quarantine-send id-like [email1 email2 ...] - отправляет сообщения из Карантина заданным получателям (email1 email2 ...). Если получатели не заданы, то письма отправляются оригинальным получателям из конверта. Результат отправки письма выводится в следующем формате: RES in sending (to RCPTS_LIST): id где: oRCPTS_LIST - фактический список получателей письма. oRES - OK или ERROR, в зависимости от результата отправки. oid - путь к файлу с телом письма. Пример вывода: OK in sending (to <ai@drweb.com> <as@sd>): def/backup/6/00004DD6.maild.VQ80Ro •quarantine-add id from rcpt1 rcpt2... - добавляет заданный файл в Карантин. Здесь from – отправитель письма, rcptN – получатели. Адреса могут быть заключены в угловые скобки <>. Если файла с указанным id не существует, то выводится ошибка. |