5.3 Опции командной строки

   Командные опции описаны в алфавитном порядке, ниже.


exim -bF /system/filter -bf /user/filter </test/message

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


# Exim filter # Sieve filter

то он берётся как нормальный файл “.forward”, и проверяется на валидность в этой интерпретации. Смотрите секции 22.4 и 22.6 для описания возможного содержимого нефильтровых списков перенаправления.
   Результаты команды exim, использующей “-bf”, если не обнаружены ошибки, является списком действий которые exim попробовал бы предпринять, если бы это было реальное сообщение. Более подробное рассмотрение тестирования фильтров дано в отдельном документе, озаглавленном “Exim’s interfaces to mail filtering”.
   Когда тестируется файл фильтра, отправитель конверта может быть задан при помощи опции “-f”, или при помощи строки “From ” в начале тестового сообщения. Различные параметры, которые бы обычно брались из адреса получателя конверта сообщения, могут быть установлены посредством дополнительных опций командной строки (смотрите последующий четыре опции).


exim -bh 10.9.8.7.1234
exim -bh fe80::a00:20ff:fe86:a061.5678

   Когда задан адрес IPv6, он конвертируется в каноническую формую В случае второго примера, выше, значение “$sender_host_address” после преобразования будет “fe80:0000:0000:0a00:20ff:fe86:a061.5678”.
   Комментарии, относительно происходящего, пишутся в стандартный файл ошибок. Они включают строки начинающиеся с “LOG”, для того, что должно быть залоггировано. Это средство предоставлено для того, чтобы тестировать конфигурационные опции входящих сообщений, для удостоверения, что они реализуют необходимую политику. Например, вы можете тестировать элементы управления релеем, используя “-bh”.
   Предупреждение 1: Вы не можете тестировать конфигурационные возможности которые зависят от обратных вызовов ident (RFC1413). Их нельзя произвести в тестировании, с использованием опции “-bh”, поскольку отсутствует входящее SMTP-соединение.
   Предупреждение 2: Обратные вызовы проверки адреса (смотрите раздел 39.32) также пропускаются, при тестировании, с использованием опции “-bh”. Если вы хотите, чтобы эти обратные вызовы произошли, используйте опцию “-bhc” вместо “-bh”.
   Сообщения доставленные в течение сессии тестирования отбрасываются, и никакие данные не записываются ни в один из реальных логов. Могут быть паузы, когда происходит поиск в DNS (или другой), и они могут исчерпать лимит времени (вывалиться по таймауту - прим. lissyara). Опция “-oMi” может использоваться для определения специфического IP-адреса и порта, если есть такая необходимость.
   Утилита “exim_checkaccess” -  “упакованная” (“packaged”) версия “-bh”, чей вывод только лишь говорит - допустим ли данный адрес получателя для данного хоста, или нет. Смотрите раздел 49.8.


From sender Fri Jan  5 12:55 GMT 1997
From sender Fri, 5 Jan 97 12:55:01

(опционально, с днём недели, и возможно, дополнительным тексом после даты) может присутствовать в начале сообщения. Тут форматом спецификации на описывается эта строка. Exim распознаёт её по совпадению с регулярным выражением, заданным опцией “uucp_from_pattern”, которая может быть изменена, в случае необходимости.
   Указанный отправитель обрабатывается, как если бы он давался как параметр опции “-f”, но, если опция “-f” присутствует, её параметр используется вместо адреса взятого из сообщения. Вызывающая exim программа должна работать от доверенного пользователя, для установки отправителя сообщения.


exim -bP qualify_domain hold_domains

   Однако, любой параметр настройки, которому в конфигурационном файле предшествует слово “hide” не показывается полностью никому, кроме административного пользователя. Для других пользователей, вывод - как в этом примере:


mysql_servers = <value not displayable>

   Если “configure_file” дан как аргумент, выводится имя конфигурационного файла работающей конфигурации. Если список конфигурационных файлов был задан, выводимое значение - имя реально использующегося файла.
   Если дан “log_file_path” или “pid_file_path”, выводятся имена директорий, где пишутся логи и pid даемона, соответственно. Если эти значения не установлены, логи пишутся в субдиректории спула, с именем “log”, и pid-файл пишется непосредственно в каталог спула.
   Если опция “-bP” сопровождается именем с предшествующим ему “+”, например,


exim -bP +local_domains

ищется соответствие именованного списка любого типа (доменов, хостов, адресов или локальных частей) и выводится найденное.
   Если дано одно из слов - “router”, “transport” или “authenticator”, сопровождаемое именем соответствующего драйвера, выводятся параметры настройки этого драйвера. Например:


exim -bP transport local_delivery

   Вначале выводятся общие опции драйверов, сопровождаемые частными опциями драйвера. Список имён драйверов специфического типа может быть получен использованием слов “router_list”, “transport_list” или “authenticator_list”, и полный список всех драйверов с их параметрами настройки можно получить используя “routers”, “transports” или “authenticators”.


25m  2.9K 0t5C6f-0000c8-00 <alice@wonderland.fict.example>
          red.king@looking-glass.fict.example
          <other addresses>

   Первая строка содержит временной отрезок, который сообщение находится в очереди (в данном случае - 25 минут), размер сообщения (2.9kb), уникальный локальный идентификатор сообщения, и отправителя сообщения, как содержится в конверте. Для рикошетов, адрес отправителя пуст, и появляется как “<>”. Если сообщение послано локально, недоверенным пользователем, который изменил дефолтовый адрес отправителя, имя логина пользователя показывается в круглых скобках, перед адресом отправителя.
   Если сообщение заморожено (приостановлена попытка его доставки), тогда в конце этой строки показывается текст “*** frozen ***”.
   Получатели сообщения (взятые из конверта, не из заголовков) показаны в последующих строках. Адреса по которым сообщение уже доставлено отмечены символом “D”. Если оригинальный адрес раскрывается в несколько адресов через файл альясов или форвардов, оригинальный показывается с “D” только когда  завершены доставки для всех дочерних адресов.


exim -brt bach.comp.mus.example
Retry rule: *.comp.mus.example  F,2h,15m; F,4d,30m;

   Смотрите раздел 32 для информации о правилах повторов exim`a. Первый аргумент, являющийся обязательным, может быть полным адресом в форме “local_part@domain”, или может быть только именем домена. Если второй аргумент содержит точку, он интерпретируется как опциональный второе имя домена; если не найдено правил повтора для первого аргумента, используется второй. Это связано с поведением exim`a, когда ищется правило повтора для удалённого хоста - если правило не найдено, используется общее совпадение с почтовым доменом. В конце можно дать, для использования в правилах повторов, параметр являющийся именем для специфической ошибки доставки. Например:


exim -brt haydn.comp.mus.example quota_3d Retry rule: *@haydn.comp.mus.example quota_3d F,1h,15m

exim -DABC  ...
exim -DABC= ...

   Для включения пробелов в макроопределения, могут использоваться кавычки. Если вы используете кавычки, пробелы разрешены вокруг имён макрокоманд и символа равно. Например:


exim '-D ABC = something' ...

   Опция “-D” может быть повторена до 10 раз, в одной командной строке.


acl             ACL interpretation
auth            authenticators
deliver         general delivery logic
dns             DNS lookups (see also resolver)
dnsbl           DNS black list (aka RBL) code
exec            arguments for execv() calls
expand          detailed debugging for string expansions
filter          filter handling
hints_lookup    hints data lookups
host_lookup     all types of name-to-IP address handling
ident           ident lookup
interface       lists of local interfaces
lists           matching things in lists
load            system load checks
local_scan      can be used by local_scan() (see chapter 41)
lookup          general lookup code and all lookups
memory          memory handling
pid             add pid to debug output lines
process_info    setting info for the process log
queue_run       queue runs
receive         general message reception logic
resolver        turn on the DNS resolver’s debugging output
retry           retry handling
rewrite         address rewriting
route           address routing
timestamp       add timestamp to debug output lines
tls             TLS logic
transport       transports
uid             changes of uid/gid and looking up uid/gid
verify          address verification logic
all             almost all of the above (see below), and also -v

   Опция “all” исключает “memory”, когда используется как “+all”, но включает её (в смысле, тоже убирает эту отладку - прим. lissyara), когда используется как “-all”. Причина этого в том, что “+all” - то, что люди чаще всего используют для генерации отладки для разработчиков exim`a. Если включено “+memory”, вывод будет огромен, и он редко представляет интерес, таким образом, теперь его нужно явно затребовать. Однако, “-all” действительно отключает всё.
   Опция “resolver” создаёт вывод лишь в случае, если DNS-резольвер был скомпилен с включенным DEBUG. Это не так, на некоторых операционных системах. Также, к сожалению, отладочный вывод DNS-резольвера пишется на стандартный вывод, а не стандартный вывод ошибок.
   По дефолту (“-d” без аргументов) не включает “expand”, “filter”, “interface”, “load”, “memory”, “pid”, “resolver” и “timestamp”. Однако выбор “pid” принудителен, когда отладка  включена для даемона, который передаёт её другому, перезапускаясь. Exim, также, автоматически добавляет pid к строкам отладки, когда параллельно выполняются несколько удалённых доставок.
   Опция “timestamp” - причина появления текущего времени в начале всех выводимых строк отладки. Она может быть полезной при попытках найти задержки в обработке.
   Если опция “debug_print” установлена в любом драйвере, он создаёт вывод каждый раз когда выбрана отладка, даже если опция “-v” не используется.


exim -f '<>' user@domain
exim -f "" user@domain

   Кроме того, использование “-f” не ограничено тестированием файлов фильтра с “-bf”, тестированием или проверкой адресов с использованием опций “-bt” или “-bv”.
   Разрешение недоверенным пользователям изменять адрес отправителя создаёт возможность отправлять анонимную почту. Exim всё равно проверяет, ссылается ли на локального пользователя, заголовок “From:”, и если это не так, он добавляет заголовок “Sender:”, хотя и это может быть отменено установкой опции “no_local_from_check”.
   Пробелы между “-f” и “<address>” - опциональны (т.е. можно давать как два параметра, так и один, объединённый). Отправитель, созданного локально сообщения, также может быть установлен (когда разрешено) инициалом “From ” - строкой в сообщении, смотрите выше примечание к “-bm”, но если присутствует “-f”, оно перезаписывает “From ”.


exim -bs -oMa 10.9.8.7.1234

   Альтернативный синтаксис должен включать IP-адрес в квадратных скобках, сопровождаемый двоеточием и номером порта:


exim -bs -oMa [10.9.8.7]:1234

   IP-адрес помещается в переменную “$sender_host_address”, и порт, если он есть, в “$sender_host_port”.


-oMr <rval> -oMs <sval>

   Она устанавливает входящий протокол и имя хоста (для вызывающих доверенных пользователей). Имя хоста и его двоеточие могут быть опущены, лишь когда протокол не задан. Отметьте, что exim уже имеет две закрытые опции “-pd” и “-ps”, ссылающиеся на встроенный perl. Поэтому невозможно установить значение протокола “p” или “s” используя эту опцию (но это не кажется реальным ограничением).


exim -q 0t5C6f-0000c8-00

   Сообщения, полученные ранее чем 0t5C6f-0000c8-00 не просматриваются. Если дан второй идентификатор сообщения, сообщения, идентификатор которых лексически больше него, также пропускаются. Если один и тотже идентификатор задан дважды, например:


exim -q 0t5C6f-0000c8-00 0t5C6f-0000c8-00

то процесс доставки запускается только для него. Это отличается от “-M”, в том, что учитываются данные повторов, и также отличается от “-Mc” в том, что в обработчике очереди, это засчитывается как доставка. Обратите внимание, что механизм выбора не затрагивает порядок, к котором сообщения сканируются. Есть и другие способы выбрать специфичные наборы для доставки в обработчике очереди - смотрите опции “-R” и “-S”.


/usr/exim/bin/exim -bd -q30m

   Такой даемон слушает входящие SMTP вызовы, а также запускает процесс обработчика очереди каждые 30 минут.
   Когда даемон запускается с “-q” и с параметром времени, но без “-bd”, pid-файл не записывается, если явно не указана опция “-oP”.