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

   Опции коммандной строки exim'a описаны ниже, в алфавитном порядке. Если отсутствуют опции, которые определяют конкретное действие (например, запуск даемона, или обработчика очереди, или тестирования адреса, или получения сообщения в специческом формате, или вывода списка сообщений в очереди), и есть, по крайней мере, один аргумент командной строки, предполагается, что задана опция “-bm” (приём сообщения на стандартном вводе, аргументы указывают получателя). Иначе, exim выведет короткое сообщение о самом себе и завершит работу.


exim -bem /tmp/testmessage

   Файл читается как сообщение (как переданное локально не-SMTP сообщение), до завершения каких либо тестовых раскрытий. Таким образом, доступны зависимые от сообщения переменные, типа “$message_size” и “$header_from:”. Однако, к сообщению добавляется заголовок “Received:”. Если задана опция “-t” получатели читаются из заголовков обычным способом, и отображаются в переменной “$recipients”. Заметьте, что получатели не могут быть заданы в командной строке, поскольку последующие аргументы воспринимаются как строки для раскрытия (просто как “-be”).


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), используя опцию “-oMt”. Однако, при использовании опции “-bh”, exim не может выполнить обратный вызов ident, поскольку входящие SMTP соединения запрещены.
   Предупреждение 2: Обратные вызовы проверки адреса (смотрите раздел 40.41) также пропускаются, при тестировании, с использованием опции “-bh”. Если вы хотите, чтобы эти обратные вызовы произошли, используйте опцию “-bhc” вместо “-bh”.
   Сообщения доставленные в течение сессии тестирования отбрасываются, и никакие данные не записываются ни в один из реальных логов. Могут быть паузы, когда происходит поиск в DNS (или другой), и они могут исчерпать лимит времени (вывалиться по таймауту - прим. lissyara). Опция “-oMi” может использоваться для определения специфического IP-адреса и порта, если есть такая необходимость. Также, для установки параметров могут быть использованы опции “-oMaa” и “-oMai”, если SMTP сессия была аутентифицирована.
   Утилита “exim_checkaccess” -  “упакованная” (“packaged”) версия “-bh”, чей вывод только лишь говорит - допустим ли данный адрес получателя для данного хоста, или нет. Смотрите раздел 50.8.
   Такие особенности, как аутентификация и шифрование, когда ввод клиента не является простым текстом, не могут быть легко оттестированы с опцией “-bh”. Вместо этого, вы должны использовать специализированную программу для тестирования SMTP, типа swaks.


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”.
   Если опция вызывается пользователем c правами администратора, то так же доступны слова “macro”, “macro_list” и “macros”, из-за того что макросы иногода используются для хранения паролей. Используется построчный формат вывода значений.


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 42)
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”. Если в командной строке присутствуют обе опции - “-oMa” и “-bh”, хост отправителя берётся из последней заданной опции.


-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”.


exim -q25m -R @special.domain.example

   Этот пример запускает обработчик очереди с получателями в заданном домене каждые 25 минут. Любые дополнительные флаги, которые заданы вместе с “q”, также применяются к каждому обработчику очереди.
   Когда сообщение выбрано для доставки по этому механизму, обрабатываются все его адреса. Для первого выбранного сообщения, exim перезадаёт любую информацию повторов и вызывает попытку доставки для каждого недоставленного адреса. Это означает, что если доставка какого-либо адреса в первом сообщении успешна, любая существующая информация повторов удаляется, и таким образом попытки доставки для этого адреса во впоследствии выбранных сообщениях (которые обрабатываются без форсирования), будут запущены. Однако, если доставка любого адреса неуспешна, информация повторов обновляется, и во впоследствии выбранных сообщениях неудачные адреса будут пропущены.
   Если “<rsflags>” содержит “f” или “ff”, принудительная доставка применяется ко всем выбранным сообщениям, не только к первому; замороженные сообщения включаются, когда присутствует “ff”.
   Опция “-R”, напрямую создаёт инициализацию доставки всех сообщений для данного домена, после того как хост был недоступен некоторое время. Когда SMTP команда ERTN принимается её ACL (смотрите раздел 40), её дефолтовый эффект - запуск exim`a с опцией “-R”, но это может быть изменено для запуска произвольной команды вместо неё.