Перевод выполнен Алексеем Паутовым в рамках некоммерческого проекта RussianLDP (http://www.rldp.ru/). Именно на этом сайте и надлежит искать новые версии, если таковые будут.

11. Раскрываемые строки

Mногие строки конфигурации exim раскрываются перед использованием. Одни раскрываются каждый раз при использовании, другие же раскрываются лишь один раз.

Раскрытием строки является дословное копирование её слева направо, исключая символы доллара ($) и обратного слэша. Символ $ задаёт начало части строки, которая интерпретируется и заменяется, как описано ниже в разделе 11.5. Обратный слэш используется как экранирующий символ, как описано в следующем разделе.

11.1. Дословный текст в раскрываемых строках

Неинтерпретируемый $ может быть включен в раскрываемую строку путём помещения перед ним обратного слэша. Обратные слэш может быть использован для экранировки любого специального символа, который может быть развёрнут, включая экранирование самого себя, обратного слша. Если используется строка в кавычках, должны использоваться два обратных слэша, поскольку кавычки сами вызывают интерпретацию обратного слэша при чтении строки (смотрите секцию 6.16).

Часть строки может быть определена как нераскрываемая при помощи помещения её между двумя символами \N. Это необходимо для защиты регулярных выражений, которые часто содержат символы "$" и "\". Например:
deny senders = \N^\d{8}[a-z]@some\.site\.example$\N

При достижении первого символа \N преобразователь копирует последующие символы без интерпретации, пока не достигнет следующего символа \N или новой строки.

11.2. Последовательности с обратным слэшем в расширенных строках

Обратный слэш с последующим за ним символом "n", "r" или "t" это специальная последовательность, означающая новую строку, возврат каретки и табуляцию, соответственно. Если за обратным слэшем следует три восьмеричных цифры, то это расшифровывается как восьмеричная запись символа, а если за обратным слэшем следует символ "x" и до двух шестнадцатеричных цифр, это шестнадцатеричная запись символа.

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

11.3. Тестирование раскрываемых строк

Очень многие раскрываемые строки могут быть проверены путём вызова exim с опцией -be. В этом случае принимаются параметры команды или строки со стандартного ввода, если аргументов нет, выполняет их через код раскрытия строк и пишет результат на стандартный вывод. Переменные, основанные на конфигурации, установлены, но так как не обрабатывается никакое сообщение, переменные типа $local_part не имеют никакого значения. Однако, опцию -be можно применять для проверки файлов и обращений к БД, а также для проверки раскрытия операторов раскрытия, типа sg, substr и nhash.

Exim управляет root-привилегиями при вызове его с опцией -be и выполняется под uid и gid пользователя, вызвавшего его для того, чтобы пользователь, использующий опцию -be не смог получить доступ к файлам, которые ему не принадлежат.

11.4. Принудительный отказ от раскрытия строки

Множество раскрытий, описанных в следующем разделе, имеют подстроки true и false, помещённые в символах фигурных скобок. То, какая из двух строк используется, зависит от условия, которое тоже раскрывается. Если вместо false используется слово fail (не в фигурных скобках), раскрытие строки происходит неудачно и может быть обнаружено кодом, который запрашивал раскрытие. Это называют принудительным отказом раскрытия, его последствия зависят от обстоятельств. В одних случаях это неотличимо от любой другой ошибки раскрытия, но в отдельных случаях может быть предпринято иное действие. Такие варианты упомянуты в документации раскрываемой опции.

11.5. Элементы раскрытия

Следующие элементы распознаются в раскрываемых строках. Пустое пространство может использоваться между подпунктами, которые являются ключевыми словами или подстроками снаружи фигурных скобок, для улучшения читабельности.
$local_part
${domain}

Вторая форма записи может быть использована для отделения от имени переменной последующих алфавитно-цифровых символов. Эта форма (с использованием фигурных скобок) доступна только для переменных: её нельзя применять для заголовков сообщений. Имена переменных приведены в главе 11.9. Если используется имя несуществующей переменной, то раскрытие терпит неудачу.

11.6. Операторы раскрытия

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

11.7. Условия раскрытия

Следующие условия доступны для проверки конструкции ${if при раскрытиии строк:

11.8. Комбинирование условий раскрытия

Несколько условий могут быть проверены за один раз, объединив их условиями and и or. Заметьте, что условия and и or представляют собой самостоятельные полноценные условия и предшествуют своим спискам шаблонов. Каждое подусловие должно находится внутри фигурных скобок вместе с общими фигурными скобками, в которых находится список. Не должно быть повторений, если используется условие if.

  • or {{cond1}{cond2}...}
    Подусловия оцениваются слева направо. Условие истинно, если одно из подусловий истинно. Например:
    ${if or {{eq{$local_part}{spqr}}{eq{$domain}{testing.com}}}...
    
    Когда находится истинное подусловие, то остальные парсятся, но не оцениваются. Если имеется несколько подусловий match, значения числовых переменных берутся от того, которое первым будет успешно.
  • and {{cond1}{cond2}...}
    Подусловия оцениваются слева направо. Условие истинно, если все подусловия верны. Если есть несколько подусловий match, значения числовых переменных берутся от последнего. Если найдено ложное подусловие, остальные парсятся, но не оцениваются.
  • 11.9. Переменные раскрытия

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

  • $0, $1, и т.д.
    Когда успешно условие match, эти переменные содержат фиксированные подстроки, идентифицированные по регулярному выражению в ходе последующего анализа успешной строки, содержащей элемент if. Также они могут быть установлены внешне некоторыми другими процессами, предшествующими раскрытию строки. Например, команды доступные в файлах фильтрa exim, включают команду if с её собственным регулярным выражением, соответствующим условию.
  • $acl_c0 - $acl_c19
    Значения могут быть помещены в эти переменные при помощи модификатора set в ACL. Значения сохраняются на протяжении всей жизни SMTP-подключения. Они могут использоваться для передачи информации между ACL и различными запросами того же самого ACL. После получения сообщения, значения переменных сохраняются вместе с сообщением и могут использоваться в фильтрах, роутерах и транспортах в течение последующей доставки.
  • $acl_m0 - $acl_m19
    Значения могут быть помещены в эти переменные при помощи модификатора set в ACL. Они сохраняют их значения, пока сообщение в процессе получения, но сбрасываются после получения. Они также сбрасываются командами MAIL, RSET, EHLO, HELO и после начала сессии TLS. После получения сообщения значения переменных сохраняются вместе с сообщением и могут использоваться в фильтрах, роутерах и транспортах в течение последующей доставки.
  • $acl_verify_message
    После неудачной проверки адреса эта переменная содержит сообщение об отказе. Она сохраняет своё значение для использования в последующих модификаторах. Сообщение может быть использовано в коде, типа такого:
    warn !verify = sender
         set acl_m0 = $acl_verify_message
    
    Вы можете использовать $acl_verify_message в процессе раскрытия модификаторов message или log_message для включения информации о причине отказа.
  • $address_data
    Эта переменная устанавливается посредством опции address_data в роутере. В процессе обработки последующими маршрутизаторами и транспортами значение остаётся с адресом. Если транспорт обрабатывает много адресов, используется значение первого адреса. Смотрите главу 15 для получения дополнительных деталей. Отметьте: содержимое переменной $address_data доступно в файлах пользовательских фильтров. Если $address_data установлена, когда роутер вызывает ACL для проверки адреса получателя, конечное значение всё ещё находится в переменной для последующих условий и модификаторов ACL. Если роутинг сделал переадресацию только к одному адресу, дочерний адрес также роутится как часть проверки, и в этом случае окончательное содержимое $address_data получено из дочернего процесса. Если $address_data установлена, когда роутер вызывает ACL для проверки адреса отправителя, окончательное значение также сохраняется, но на этот раз в переменной $sender_address_data, чтобы можно было отличить от данных адреса получателя. В обоих случаях (проверки получателя и отправителя), значение не сохраняется после конца текущей проверки ACL. Если необходимо сохранить их дальше, то можно сохранить их в переменных ACL.
  • $address_file
    Когда в результате алиасинга, форвардинга или фильтрации сообщение направлено в специфический файл, эта переменная содержит имя файла, пока выполняется транспортировка. В другое время переменная пуста. Например, используя конфигурацию по умолчанию, у пользователя r2d2 в файле .forward содержится:
    /home/r2d2/savemail
    
    То, когда работает транспорт address_file, переменная $address_file содержит /home/r2d2/savemail. Для фильтров Sieve значение может быть inbox или относительным именем каталога. Так продолжается до запуска транспорта, который построит абсолютный путь к необходимому файлу.
  • $address_pipe
    Когда в результате алиасинга или форвардинга сообщение направляется в канал (pipe), переменная содержит команду канала, пока работает транспорт.
  • $auth1 - $auth3
    Эти переменные используются в SMTP-аутентификаторах (смотрите разделы 34-37). В других местах они пусты.
  • $authenticated_id
    Когда сервер полностью аутентифицирует клиента, то это может быть сконфигурировано для сохранения части аутентификационной информации в переменной $authenticated_id (смотрите раздел 33). Например, конфигурация аутентификатора user/password могла бы сохранить имя пользователя для использования в роутерах. Отметьте, что это не та же самая информация, которая сохраняется в $sender_host_authenticated. Когда сообщение посылается локально, а не через TCP-соединение, переменная $authenticated_id содержит имя пользователя, вызвавшего процесс.
  • $authenticated_sender
    Когда exim работает как сервер, он берёт во внимание параметр AUTH= для поступающей SMTP-команды MAIL, если отправителю можно доверять, как описано в 33.2. Если данные не являются строкой, устанавливается, что сообщение шлёт аутентифицированный отправитель, а значение доступно в процессе доставки в переменной $authenticated_sender. Если отправитель не доверенный, exim принимает синтаксис AUTH=, но игнорирует данные. Когда сообщение отправляется локально (не через TCP-соединение), значение переменной $authenticated_sender является адресом, сконструированным из имени пользователя и значения переменной $qualify_domain.
  • $authentication_failed
    Эта переменная устанавливается в 1 в сервере exim, если клиент использует команду AUTH, которая не успешна. Иначе она устанавливается в 0. Это позволяет различить "did not try to authenticate" (не пробовал провести аутентификацию: $sender_host_authenticated пуста, $authentication_failed равна нулю) и "tried to authenticate but failed" (пробовал провести аутентификацию, но безуспешно: $sender_host_authenticated пуста, а $authentication_failed равна единице). Отказ включает любой отрицательный ответ на команду AUTH, включая (к примеру) попытку использовать неизвестный/неопределённый аутентификационный механизм.
  • $av_failed
    Эта переменная доступна, когда Exim собран с расширением контентного сканирования. Это установлено в 0 по умолчанию, но будет установлено в 1, если какая-либо проблема происходит с вирусным сканером (определенным av_scanner) во время ACL malware.
  • $body_linecount
    Когда сообщение передаётся или принимается, эта переменная содержит число строк тела сообщения. Смотрите также $message_linecount.
  • $body_zerocount
    Когда сообщение передаётся или принимается, эта переменная содержит число нулевых байт в теле сообщения.
  • $bounce_recipient
    В этой переменной устанавливатеся адрес получателя рикошета, когда exim его создаёт. Полезно, если используется настраиваемый текстовый файл (смотрите раздел 45).
  • $bounce_return_size_limit
    Эта переменная содержит значение опции bounce_return_size_limit, округлённой к числу, кратному 1000. Полезно, если используется настраиваемый текстовый файл ошибок сообщений (смотрите раздел 45 ).
  • $caller_gid
    Содержится реальный id той группы, под которой выполнялся процесс exim. Это не тоже самое, что и gid создателя сообщения (смотрите $originator_gid). Если exim перезапускает себя, эта переменная в нормальном состоянии содержит gid exim.
  • $caller_uid
    Реальный uid пользователя, под которым выполняется процесс exim. Это не тоже самое, что и uid создателя сообщения (смотрите $originator_uid). Если exim перезапускает себя, эта переменная в нормальнос состоянии содержит uid exim.
  • $compile_date
    Дата, когда был скомпилирован двоичный файл exim.
  • $compile_number
    Процесс сборки exim сохраняет число раз, сколько он был скомпилирован. Это позволяет отличить другие компиляции одной и той же версии программы.
  • $demime_errorlevel
    Эта переменная доступна, когда exim собран с поддержкой контентного сканирования и вышедшим из употребления условием demime. Детали смотрите в 40.6.
  • $demime_reason
    Эта переменная доступна, когда exim собран с поддержкой контентного сканирования и вышедшим из употребления условием demime. Детали смотрите в 40.6.
  • $dnslist_domain
    Когда для клиентского хоста найдена запись в списке DNS, имя домена помещается в эту переменную, чтобы можно было включить эту информацию в сообщение об ошибке.
  • $dnslist_text
    Когда для клиентского хоста найдена запись в списке DNS, содержание любой ассоциированной TXT-записи помещается в эту переменную.
  • $dnslist_value
    Когда для клиентского хоста найдена запись в списке DNS, IP-запись для ресурса помещается в эту переменную. Если запесей много, то все адреса включаются, разделённые запятыми с пробелами.
  • $domain
    Когда адрес маршрутизируется или самостоятельно доставляется, эта переменная содержит имя домена. Глобальная перезапись адреса происходит когда сообщение получено, таким образом значение $domain в течение марщрутизации и доставки задает значение после перезаписи. Переменная $domain установлена во время пользовательской фильтрации, но не во время системной фильтрации, поскольку сообщение может иметь много получателей, а системный фильтр вызывают только один раз. Когда доставляется больше одного адреса за раз (например, несколько команд RCPT в одном SMTP-соединении), $domain установлена лишь в случае, если все они имеют один и тот же домен. Транспорты могут быть ограничены обработкой только одного домена за раз, если значение $domain требуется во время работы транспорта: это значение по умолчанию для локальных транспортов. Для дополнительных деталей о переменных окружения во время выполнения транспортировки смотрите главу 23. В конце доставки, если все отсроченные адреса имеют один домен, он помещается в $domain в процессе раскрытия delay_warning_condition. Переменная $domain также используется при некоторых других обстоятельствах:
  • $domain_data
    Когда опция domains на маршрутизаторе совпадает с доменом, найденным поиском, данные, прочитанные поиском, доступны во время работы роутера как $domain_data. Кроме того, если драйвер направляет адрес в транспорт, то значение доступно и в транспорте. Если транспорт обрабатывает много адресов, используется значение из первого адреса. Переменная $domain_data также устанавливается, когда выражение domains в ACL совпадает с доменом, найденным поиском. Данные, прочитанные поиском, доступны в остальной части условия ACL. Во всех других случаях эта переменная ничего не содержит.
  • $exim_gid
    Эта переменная содержит числовое значение gid группы от имени которой работает exim.
  • $exim_path
    Эта переменная содержит путь к двоичному файлу exim.
  • $exim_uid
    Эта переменная содержит числовое значение uid пользователя от имени которого работает exim.
  • $found_extension
    Эта переменная доступна, когда exim собран с поддержкой контентного сканирования и устаревшим условием demime. За дополнительными деталями обратитесь к разделу 40.6.
  • $header_ name
    Это не строгая переменная раскрытия. Это синтаксис раскрытия для вставки строки заголовка сообщения с указанным именем. Заметьте, что имя может оканчиватся двоеточием или пробелом, поскольку оно может содержать разнообразные символы. Также заметьте, что фигурные скобки не должны использоваться.
  • $home
    Когда в роутере установлена опция check_local_user, в случае успешной проверки домашний каталог пользователя помещается в переменную $home. В частности, это означает, что она установлена в процессе выполнения фалов фильтров пользователей. Роутер также может явно установить основной домашний каталог для использования транспортом. Это может быть отменено непосредственной установкой транспорта. Когда работает тест фильтра, через опцию -bf в $home устанавливается значение перемeнной окружения HOME.
  • $host
    Когда транспорт smtp раскрывает опции для шифрования с использованием TLS, $host содержит имя приконнектившегося хоста. Аналогично, когда используется клиентская часть конфигурации аутентификации (смотрите раздел 33), переменная $host содержит имя сервера, к которому подключился клиент. Когда используется транспортный фильтр (смотрите раздел 24), $host содержит участвующий в текущем соединении. Когда локальный транспорт запущен как результат роутера, который устанавливает список хостов, $host содержит имя первого хоста.
  • $host_address
    Эта переменная содержит IP-адрес удалённого хоста каждый раз, когда устанавливается $host для удалённого соединения. Также в неё устанавливается IP-адрес, проверяемый в опции ignore_target_hosts.
  • $host_data
    Если выражение $hosts в ACL удовлетворяется посредством поиска, результат поиска становится доступен в переменной $host_data. Это позволяет делать, например, такие вещи:
    deny hosts = net-lsearch;/some/file
    message = $host_data
    
  • $host_lookup_deferred
    В нормальном состоянии эта переменная содержит 0, что делает $host_lookup_failed. Когда сообщение приходит с удалённого хоста и производится попытка поиска имени хоста по его IP-адресу, и если попытка безуспешна, эта переменная устанавливается в 1. Если поиск получает какой-то отрицательный ответ (например, поиск в DNS успешен, но записей не найдено), $host_lookup_failed устанавливается в 1. Если во время поиска происходят какие-то проблемы, такие, что в итоге exim не может утверждать, задано ли имя хоста (например, таймаут поиска в DNS), $host_lookup_failed устанавливается в 1. Поиск имени хоста по его IP-адресу содержит больше, чем просто один обратный поиск. Exim проверяет полученное имя в обратную сторону: приведёт ли оно к оригинальному IP-адресу. Если это не так, exim не принимает найденное имя, а переменная $host_lookup_failed устанавливается в 1. Таким образом, возможность находить имя по IP-адресу (например, PTR-запись в DNS) не является достаточным условием для успешного поиска имени хоста. Если обратный поиск успешен, но есть проблемы с прямым поиском, например, таймаут, то имя не принимается, и $host_lookup_deferred устанавливается в 1. Смотрите также $sender_host_name.
  • $host_lookup_failed
    Смотрите $host_lookup_deferred.
  • $inode
    Единственный момент времени, когда эта переменная установлена: раскрытие опции directory_file в транспорте appendfile. Переменная содержит номер индекса временного файла, который должен быть переименован. Это может использоваться для создания уникального имени файла.
  • $interface_address
    Ныне эта опция устарела и оставлена только для совместимости. Вместо нее надлежит использовать $received_ip_address.
  • $interface_port
    Ныне эта опция устарела и оставлена только для совместимости. Вместо нее надлежит использовать $received_port.
  • $ldap_dn
    Эта переменная доступна, лишь если exim собран с поддержкой LDAP и содержит DN для последнего успешного поиска в LDAP.
  • $load_average
    Эта переменная содержит среднюю загрузку системы, умноженную на 1000, и является целым числом. Например, если загрузка 0.21, то значение переменной 210. Значение пересчитывается каждый раз, когда ссылаются на эту переменную.
  • $local_part
    Когда адрес маршрутизируется или доставляется владельцу, эта переменная содержит локальную часть адреса. Когда идёт одновременная доставка нескольких адресов (например, несколько команд RCPT в SMTP-сессии), переменная $local_part не задана. Глобальная перезапись адресов происходит при получении сообщения, таким образом, значение $local_part в ходе маршрутизации и доставки представляет собой значение после перезаписи. $local_part устанавливается во время работы пользовательского фильтра, но не во время работы системного, потому что сообщение может иметь много получателей, а системный фильтр вызывается лишь один раз. Если локальная часть префикса или суффикса была успешно разобрана, то это не включается в значение $local_part в процессе маршрутизации и последующей доставки. Значения любой приставки или суффикса находятся в $local_part_prefix и $local_part_suffix соответственно. Когда сообщение доставляется в файл, канал или транспорт автоответа в результате алиасинга или форвардинга, $local_part устанавливается в локальную часть родительского адреса, а не в имя файла или команды (смотрите $address_file и $address_pipe). Когда ACl запускается для команды RCPT, $local_part содержит локальную часть адреса получателя. Когда срабатывает перезапись (смотрите раздел 31), $local_part содержит локальную часть адреса, который перезаписывается, это может быть использовано, например, в раскрытиях замены адреса. Во всех регистрах все кавычки удаляются из локальной части. Например, оба адреса
    "abc:xyz"@test.example
    abc\:xyz@test.example
    
    дадут значение $local_part.
    abc:xyz
    
    Если Вы используете $local_part для создания других адресов, Вы всегда должны обрабатывать его в операторе quote. Например, в переадресовывающем роутере можно сделать так:
    data = ${quote_local_part:$local_part}@new.domain.example
    
    Отметьте: обычно значение $local_part в нижнем регисте, если Вы хотите обрабатывать локальные части в роутере в регистрозависимой манере, Вы должны установить опцию caseful_local_part (смотрите раздел 15).
  • $local_part_data
    Когда опция local_part на роутере совпадает с локальной частью, найденной поиском, данные, прочитанные поиском, доступны в ходе выполнения роутара как $local_part_data. Кроме того, если драйвер маршрутизирует адрес в транспорт, значение доступно и в транспорте. Если транспорт обрабатывает много адресов, используется значение первого адреса. Переменная $local_part_data также устанавливается, когда local_part в ACL совпадает с локальной частью, найденной поиском. Данные, прочитанные поиском, доступны в остальной части ACL. Во всех других ситуациях значение переменной пустое.
  • $local_part_prefix
    Когда адрес маршрутизируется или доставляется владельцу, и распознан специфический префикс для локальной части, он доступен в этой переменной, удалённой из $local_part.
  • $local_part_suffix
    Когда адрес роутится или доставляется владельцу и распознан специфический суффикс для локальной части, он доступен в этой переменной, удалённой из $local_part.
  • $local_scan_data
    Эта переменная содержит текст, возвращённый функцией local_scan() при получении сообщения. За дополнительными деталями обратитесь к разделу 41.
  • $local_user_gid
    Смотрите $local_user_uid.
  • $local_user_uid
    В эту переменную и $local_user_gid устанавливаются значения uid и gid после успешного предварительного условия check_local_user в роутере. Это означает, что их значения доступны для остальных, неотработавших, предварительных условий (senders, require_files и condition) для раскрытия address_data и других, специфичных для роутера условий. В любой другой момент времени значения в этих переменных (uid_t)(-1) и (gid_t)(-1), соответственно.
  • $localhost_number
    Тут содержится раскрытое значение опции localhost_number. Это раскрытие происходит после прочтения основных опций.
  • $log_inodes
    Число свободных inode в дисковом разделе, куда пишутся протоколы exim. Это значение пересчитывается каждый раз, когда ссылаются на эту переменную. Если файловая система не знает, что такое inode, значение переменной равно -1. Также смотрите опцию check_log_inodes.
  • $log_space
    Размер свободного места (в килобайтах) на дисковом разделе, в который пишутся протоколы exim. Это значение пересчитывается каждый раз, когда ссылаются на эту переменную. Если операционная система не имеет понятия "размер свободного пространства" (истинно для экспериментальных систем), значение переменной равно -1. Также смотрите опцию check_log_space.
  • $mailstore_basename
    Эта переменная устанавливается только при работе доставки в формате mailstore в транспорт appendfile. В процессе раскрытия опций mailstore_prefix, mailstore_suffix, message_prefix и message_suffix она содержит имена записываемых файлов, то есть имя без суффикса .tmp, .env или .msg. В любое другое время переменная пуста.
  • $malware_name
    Эта переменная доступна, когда exim скомпилирован с поддержкой контентного сканирования. Она устанавливается в имя вируса, который был найден, когда условие malware ACL истинно (глава 40.1).
  • $max_received_linelength
    Эта переменная содержит число байт в самой длинной строке, которая была получена как часть сообщения, не считая символы завершения строки.
  • $message_age
    Эта переменная устанавливается в начале попытки доставки сообщения в число секунд с тех пор, как сообщение было получено. Оно не изменяется в течение одной попытки доставки.
  • $message_body
    Во время доставки эта переменная содержит начальную часть сообщения и предназначена, главным образом, для файлов фильтра пользователей. Максимальное число символов тела сообщения, помещаемое в переменную, устанавливается конфигурационной опцией message_body_visible, по умолчанию это 500. Символы новой строки преобразуются в пробелы для облегчения поиска фраз, которые были разбиты по переводу строки. Двоичные нули также преобразовываются в пробелы.
  • $message_body_end
    Во время доставки эта переменная содержит конец тела сообщения. Формат и максимальный размер такой же, как и у $message_body.
  • $message_body_size
    Во время доставки эта переменная содержит размер тела сообщения в байтах. Счёт начинается с символа после пустой строки, отделяющей заголовки от сообщения. Смотрите также $message_size, $body_linecount и $body_zerocount.
  • $message_exim_id
    Когда сообщение получается или доставляется, эта переменная содержит уникальный идентификатор сообщения, генерируемый и используемый exim для идентификации сообщения. Идентификатор не создаётся для сообщения до тех пор, пока его заголовок не получен. Заметьте: это не содержимое строки заголовка Message-ID:, а локальный идентификатор, назначаемый exim сообщению, например, 1BXTIK-0001yO-VA.
  • $message_headers
    Эта переменная содержит все строки заголовка во время обработки сообщения, за исключением строк, добавленных роутерами и транспортами. Строки заголовка разделены символами новой строки.
  • $message_headers_raw
    Эта переменная содержит все строки заголовка во время обработки сообщения, за исключением строк, добавленных роутерами и транспортами. Строки заголовка разделены символами новой строки. Отличие от $message_headers в том, что там выполняется декодирование контента, согласно RFC2047. Здесь никакого декодирования не выполняется.
  • $message_id
    Это старое название $message_exim_id, которое теперь не используется.
  • $message_linecount
    Эта переменная содержит общее количество строк в заголовке и теле сообщения. Сравните с $body_linecount, содержащей лишь число строк в теле сообщения. В процессе DATA и ACL занимающихся контентным сканированием $message_linecount содержит число полученных строк. До доставки (перед фильтрами, маршрутизаторами, роутерами и транспортами) счётчик увеличен, чтобы включить строку заголовка Received: стандартно добавляемую exim, и любые другие заголовки, добавляемые ACL. Пустая строка, отделяющая заголовки от тела сообщения, не подсчитывается. Вот пример использования этой переменной в DATA ACL:
    deny message = Too many lines in message header
    condition = ${if <{250} \
                {${eval:$message_linecount - $body_linecount}}}
    
    В MAIL и RCPT ACL значение этой переменной ноль, поскольку на этих стадиях сообщение ещё не получено.
  • $message_size
    Когда сообщение находится в процессе обработки, эта переменная содержит число байт. В большинстве случаев размер включает те заголовки, которые были получены с сообщением, но не те (типа Envelope-to:), которые были добавлены индивидуальными доставкми. Однако, есть один специальный случай: в процессе раскрытия опции maildir_tag в транспорте appendfile, когда доставка происходит в формате maildir, значение $message_size задает точный размер файла, который был записан на диск. Смотрите также $message_body_size, $body_linecount и $body_zerocount. При выполнении ACL во время команды SMTP RCPT $message_size содержит размер, предоставленный командой MAIL, или -1, если он не был предоставлен. Разумеется, значение может быть неверным или заведомо ложным.
  • $mime_xxx
    Множество переменных с именами, начинающимися на $mime, доступны в случае, если exim собран с поддержкой контентного сканирования. Для дополнительных делалей смотрите раздел 40.4.
  • $n0 - $n9
    Эти переменные пердставляют собой счётчики, которые могут быть увеличены при помощи команды add в файлах фильтров.
  • $original_domain
    Когда адрес верхнего уровня обрабатывается для доставки, эта переменная содержит то же самое значение, что и $domain. Однако, если "дочерний" адрес (например, сгенерированный алиасом, форвардом или файлом фильтра) обрабатывается, эта переменная содержит доменную часть оригинального адреса. Это отличается от $parent_domain только когда здесь больше одного уровня алиасинга или форвардинга. Когда происходит доставка более чем по одному адресу в одном транспорте, переменная $original_domain не установлена. Если новый адрес создан с помощью команды deliver в системном фильтре, то эта переменная установлена с искусственным "родительским" адресом. В таком случае локальная часть system-filter, а доменная является доменом по умолчанию из настроек.
  • $original_local_part
    Когда адрес верхнего уровня обрабатывается для доставки, эта переменная содержит то же самое значение, что и $local_part за исключением ситуации, если суффикс или префикс были удалены из локальной части, поскольку $original_local_part всегда содержит полную локальную часть. Когда дочерний адрес (например, сгенерированный алиасом, форвардом или файлом фильтра) обрабатывается, эта переменная содержит полную локальную часть оригинального адреса. Если роутер (процесс переназначения) нечувствителен к регистру локальной части адреса, значение $original_local_part в нижнем регистре букв. Эта переменная отличается от $parent_local_part только в случае, если больше одного уровня алиасинга или форвардинга. Когда происходит доставка более чем по одному адресу в одном транспорте, переменная $original_local_part не установлена. Если новый адрес создан с помощью команды deliver в системном фильтре, эта переменная установлена с искусственным родительским адресом. В таком случае локальная часть system-filter, а доменная является доменом по умолчанию из настроек.
  • $originator_gid
    Эта переменная содержит значение переменной $caller_uid, установленной при получении сообщения. Для сообщений, полученных через командную строку, это gid пославшего его пользователя. Для сообщений, полученных через TCP/IP, это обычно gid пользователя от которого работает exim.
  • $parent_domain
    Эта переменная подобна $original_domain (смотрите выше) за исключением того, что относится непосредственно к предыдущему родительскому адресу.
  • $parent_local_part
    Эта переменная подобна $original_local_part (смотрите выше) за исключением того, что относится непосредственно к предыдущему родительскому адресу.
  • $pid
    Эта переменная содержит идентификатор процесса текущего процесса.
  • $pipe_addresses
    Это не раскрываемая переменная, но она упомянута тут, поскольку строка $pipe_addresses обрабатывается специально в командной спецификации для транспорта pipe (раздел 29) и в транспортных фильтрах (описанных как transport_filter в разделе 24 ). Она не может использоваться в основных строках раскрытия и вызывает ошибку "неизвестная переменная", если с ней там сталкиваются.
  • $primary_hostname
    Эта переменная содержит значение, установленное пунктом primary_hostname в конфигурационном файле или прочитанное функцией uname(). Если uname() возвращает однокомпонентное имя, то exim вызывает функцию gethostbyname() (или getipnodebyname(), какая доступна) в попытке получить полное имя хоста. Смотрите также $smtp_active_hostname.
  • $prvscheck_address
    Эта переменная используется вместе с элементом раскрытия "prvscheck", который описан в разделах 11.5 и 39.38.
  • $prvscheck_keynum
    Эта переменная используется вместе с элементом раскрытия prvscheck, который описан в разделах 11.5 и 39.38.
  • $prvscheck_result
    Эта переменная используется вместе с элементом раскрытия prvscheck, который описан в разделах 11.5 и 39.38.
  • $qualify_domain
    Значение этой переменной устанавливается опцией qualify_domain из конфигурационного файла.
  • $qualify_recipient
    Значение этой переменной устанавливается опцией qualify_recipient из конфигурационного файла или, если там не задано, значением $qualify_domain.
  • $rcpt_count
    Когда сообщение получается по SMTP, эта переменная содержит число команд RCPT, переданных для текущего сообшения. Если эта переменная используется в RCPT ACL, то её значение включает текущую команду.
  • $rcpt_defer_count
    Когда сообщение получается по SMTP, эта переменная содержит число команд RCPT в текущем сообщении, которые были ранее отклонены с временным (4xx) ответом.
  • $rcpt_fail_count
    Когда сообщение получается по SMTP, эта переменная содержит число команд RCPT в текущем сообщении, которые были ранее отклонены с постоянным (4xx) ответом.
  • $received_count
    Эта переменная содержит число заголовков Received: в сообщении, включая один, добавленный exim (таким образом, это значение всегда больше нуля). Оно доступно в DATA ACL, в не-SMTP ACL и во время роутинга и доставки.
  • $received_for
    Если во входящем сообщении только один адрес получателя, то эта переменная содержит адрес из строки заголовка Received: после её получения. Значение копируется после перезаписи адреса получателя, но до запуска функции local_scan().
  • $received_ip_address
    Как только сервер начинает обрабатывать TCP/IP соединение, эта переменная принимает значение IP-адреса локального интерфейса, а в переменную $received_port пишется номер порта. Поэтому эти значения доступны для использования в connect ACL. Также смотрите опцию командной строки -oMi. Как присутствующая в ACL, эта переменная может использоваться, например, для создания имени файла для сертификата TLS, зависящего от того, какой порт/интерфейс используется.
  • $received_port
    См. подробности в описании опции $received_ip_address.
  • $received_protocol
    При обработке сообщения эта переменная содержит имя протокола по которому получено сообщение. Большинство имён, используемых exim, определено RFC 821, RFC 2821 и RFC 3848. Они начинаются с smtp (клиент использовал HELO) или esmtp (клиент использовал EHLO). Они могут содержать s, если было безопасное (шифрованное) соединение и/или a для аутентифицированных. Таким образом, если получается протокол esmtpsa, то сообщение было передано по шифрованному SMTP-соединению, а клиент был успешно аутентифицирован. Exim использует имя протокола smtps для случая, когда шифрование автоматически включается при соединении без использования STARTTLS (смотрите tls_on_connect_ports, а клиент использует HELO для начала шифрованного сеанса SMTP. Имя smtps также используется для редкой ситуации, когда клиент первоначально использует EHLO, устанавливает шифрованное соединение, используя STARTTLS, а затем использует HELO. Опция -oMr обеспечивает возможность определить имя протокола для сообщений, которые отправлены локально от доверенных отправителей. Обычно это используется для идентификации сообщений, которые повторно иньектятся после сканирования.
  • $received_time
    Эта переменная содержит дату и время, когда текущее сообщение было получено, в виде секунд с начала эпохи Unix.
  • $recipient_data
    Эта переменная устанавливается после успешного индексного поиска в выражении ACL recipients. Она содержит данные из поиска, значение остаётся установленным до следующей проверки recipients. Таким образом, можно делать такие вещи:
    require recipients = cdb*@;/some/file
    deny some further test involving $recipient_data
    
    Внимание; Эта переменная установлена только в случае, если поиск как метод индексации в списке адресов с использованием синткаксиса точки с запятой, как в примере. Переменная не установлена для поиска, который используется как часть раскрытия строки, которому все такие списки подвергаются до интерпретации.
  • $recipient_verify_failure
    В ACL, когда проверка получателя неудачна, эта переменная содержит информацию об ошибке. Это может быть одно из следующих слов: Ожидаемое главное использование этой переменной: для различения режектов MAIL и режектов RCPT.
  • $recipients
    Эта переменная содержит список получателей сообщения. Адреса разделяются запятыми и пробелами в тексте замены. Однако, переменная не является общедоступной для предотвращения просмотра Bcc-получателей в непривелигированных пользовательских фильтрах. Вы можете использовать $recipients только в этих двух случаях:
  • $recipients_count
    В процессе обработки сообщения эта переменная содержит число получателей сообщения, которые шли с сообщением (имеется в виду, что тут не учтены получатели, добавленные в процессе обработки). Дубликаты не исключаются из подсчёта. Во время приёма сообщения по SMTP число увеличивается для каждого принятого получателя.
  • $reply_address
    В процессе обработки сообщения в этой переменной находится содержимое строки заголовка Reply-To:, если она существует и не пуста, иначе она содержит значение из строки заголовка From:. Кроме удаления начального пустого пространства, эта переменная никак не обрабатывается. В частности, не производится расшифровка по RFC 2047 или символьная замена кода.
  • $return_path
    Во время доставки сообщения, эта переменная содержит обратный путь (поле отправителя), посылаемый как часть конверта. Оно не заключено в символы "<>". В начале маршрутизации адреса $return_path установлена в то же значение, что и $sender_address, но если, например, входящее сообщение листа рассылки раскрыто роутером, определяющим другой адрес для возврата, то впоследствии $return_path содержит другой адрес возврата, тогда как $sender_address всегда содержит оригинальный адрес отправителя, полученный с сообщением. Если сказать по-другому, $sender_address содержит адрес отправителя входящего конверта, а $return_path содержит адрес исходящего конверта.
  • $return_size_limit
    Это устаревшее название $bounce_return_size_limit.
  • $runrc
    Эта переменная содержит код возврата команды, выполненой в элементе раскрытия "${run...}". Предупреждение: В роутере или транспорте Вы не можете предположить порядок раскрытия опций за исключением тех предварительных условий, чей порядок тестирования задокументирован. Поэтому невозможно ожидать установки $runrc в раскрытии одной опции и использовать её в другой.
  • $self_hostname
    Когда адрес направлен к возможному удалённому хосту, тут устанавливается локальный хост, этот случай контролируется общей опцией self роутера. Одно из его значений заставляет передать адрес другому роутеру. Когда такое происходит, значение $self_hostname будет именем локального хоста, с которым столкнулся роутер. При других обстоятельствах оно будет пустым (null).
  • $sender_address
    При обработке сообщения эта переменная содержит адрес отправителя, полученный в конверте сообщения. Для возвращаемых сообщений значение будет пустой строкой. Смотрите также $return_path.
  • $sender_address_data
    Если переменная $address_data установлена, когда роутеры вызываются из ACL для проверки адреса отправителя, то окончательное значение сохраняется в $sender_address_data для возможности отличить его от адреса получателя. Значение не сохраняется после окончания текущей ACL. Если необходимо сохранять его дольше, то Вы можете сохранить его в переменных ACL.
  • $sender_address_domain
    Доменная часть $sender_address.
  • $sender_address_local_part
    Локальная часть $sender_address.
  • $sender_data
    Эта переменная устанавливается после успешного поиска в условии ACL senders или в опции senders роутера. Оно содержит данные поиска, и значение остаётся установленным до следующей проверки senders. Таким образом, можно делать такие вещи:
    require senders = cdb*@;/some/file
    deny some further test involving $sender_data
    
    Внимание: Эта переменная установлена только в случае, если поиск используется как метод индексации в списке адресов, используя синтаксис точки с запятой, как в примере выше. Переменная не установлена для поиска, который использует часть строки раскрытия, которому подвергаются все списки, до интерпретации.
  • $sender_fullhost
    Когда сообщение получено от удалённого хоста, эта переменная содержит имя хоста и адрес IP в одной строке. Она заканчиватся IP-адресом в квадратных скобках с номером порта через двоеточие, если включено логирование портов. Формат остальной части строки зависит от того, какая была SMTP-команда хоста: HELO или EHLO, и было ли подверждено имя хоста поиском по его IP-адресу. Поиск IP-адреса модет быть вызыван опцией host_lookup, независимой от проверки. Простое имя хоста в начале строки задает проверенное имя хоста: если оно отсутствует, проверка не проводилась или не требовалась. Имя хоста в круглых скобках задает параметр команды HELO или EHLO. Оно пропущено, если оно идентично проверенному имени хоста или IP-адресу в квадратных скобках.
  • $sender_helo_name
    Когда сообщение получено с удалённого хоста, давшего команду HELO или EHLO, аргумент этой команды помещается в эту переменную. Также оно устанавливается, если HELO или EHLO использовалось при локальном SMTP с опциями -bs или -bS.
  • $sender_host_address
    Когда сообщение получено от удалённого хоста, эта переменная содержит IP-адрес удалённого хоста. Для локальных сообщений значение пустое.
  • $sender_host_authenticated
    Эта переменная содержит имя (не публичное имя) драйвера аутентификации, который успешно подтвердил подлинность клиента, от которого получено сообщение. Оно пустое, если аутентификации не было. Смотрите также $authenticated_id.
  • $sender_host_name
    Когда сообщение передаётся с удалённого хоста, эта переменная содержит имя хоста, полученное поиском по его IP-адресу. Для сообщений, полученных другими способами, эта переменная пуста. Если имя хоста предварительно не искалось, ссылка на $sender_host_name вызывает поиск (для сообщений с удалённых хостов). Найденное имя принимается только если оно, при прямом поиске по нему, возвращает оригинальный IP. Если прямой или обратный поиск не могут найти какие-то данные, или если прямой поиск не приводит к первоначальному IP, то $sender_host_name остаётся пустым, а $host_lookup_failed устанавливается в 1. Однако, если любой из поисков не может быть завершён (например, произошёл таймаут DNS), $host_lookup_deferred устанавливается в 1, а $host_lookup_failed остаётся установленным в 0. Когда $host_lookup_failed установлена в 1, exim не пробует снова найти имя хоста при наличии информации о $sender_host_name в другом процессе exim, но он пробует ещё раз, если $host_lookup_deferred установлена в 1. Exim не ищет автоматически каждое имя хоста. Если Вы хотите максимальной эффективности, Вы должны упорядочить Вашу конфигурацию так, чтобы вообще избежать этого поиска. Поиск происходит лишь в случае, если одно или больше условий истинны:
  • $sender_host_port
    Когда сообщение получено с удалённого хоста, эта переменная содержит номер порта, использовавшегося удалённым хостом.
  • $sender_ident
    Когда сообщение получено с удалённого хоста, эта переменная содержит идентификацию переданную в ответ на запрос по RFC 1413. Когда сообщение получено локально, эта переменная содержит имя пользователя вызвавшего exim.
  • $sender_rate_xxx
    Множество переменных, имена которых начинаются с $sender_rate_, установленных как часть условия ACL ratelimit. Детали смотрите в главе 39.30.
  • $sender_rcvhost
    Это необходимо для использования в заголовках Received:. Она начинается с любого проверенного имени хоста (полученного обратным поиском в DNS) или, если нет проверенного имени, IP-адресом в квадратных скобках. После этого в круглых скобках может быть текст. Когда первый пункт задает проверенное имя хоста, первый элемент в круглых скобках явно IP-адрес в квадратных скобках с номером порта через двоеточие, если разрешено логирование портов. Когда первый элемент IP-адрес, то порт записывается внутри круглых скобок, в виде "port=xxxx". Также могут быть пункты вида "helo=xxxx", если использовались HELO или EHLO, и их параметр не был идентичен реальному имени хоста или IP, или "ident=xxxx", если доступна строка ident из RFC 1413. Если все три элемента присутствуют в круглых скобках, в строку вставляется символ новой строки и символ табуляции для улучшения читабельности заголовка Received:.
  • $sender_verify_failure
    В ACL, когда проверка отправителя неудачна, эта переменная содержит информацию об ошибке. Детали такие же, как и у $recipient_verify_failure.
  • $sending_ip_address
    Эта переменная установлена всякий раз, когда было установлено исходящее SMTP-соединение с другим узлом. Это содержит IP-адрес локального интерфейса, который для этого используется. Это полезно, если узел, у которого есть больше одного IP-адреса, хочет использовать разную логику для интерфейсов. Для входящих соединений см. $received_ip_address.
  • $sending_port
    Эта переменная установлена всякий раз, когда было установлено исходящее SMTP-соединение с другим узлом. Это содержит локальный порт соединения. Для входящих соединений см. $received_port.
  • $smtp_active_hostname
    Во время сеанса SMTP эта переменная содержит значение имени активного хоста, определённого опцией smtp_active_hostname. Значение $smtp_active_hostname сохраняется с любым переданным сообщением и его значение можно использовать во время роутинга и доставки.
  • $smtp_command
    В процессе обработки входящей SMTP команды эта переменная содержит всю команду. Это позволяет различать HELO и EHLO в ACL, а иакже различать команды, типа:
    MAIL FROM:<>
    MAIL FROM: <>
    
    Для команды MAIL могут быть просмотрены дополнительный параметры, типа SIZE. Для команды RCPT адрес в $smtp_command задает оригинальный адрес до любой перезаписи, тогда как значения в $local_part и $domain взяты из адреса после SMTP-перезаписи.
  • $smtp_count_at_connection_start
    Эта переменная установлена более, чем в 0 только в процессах, порожденных демоном Exim для того, чтобы обработать поступающие соединения SMTP. Имя сознательно длинное, чтобы подчеркнуть содержание. Когда демон принимает новое соединение, он увеличивает эту переменную. Копию переменной передают дочернему процессу, который обрабатывает соединение, но его значение никогда не меняется. Это только приближение того, сколько фактически было поступающих соединения, потому что много соединений могут прийти и уйти в то время, как единственное соединение обрабатывается. Когда дочерний процесс заканчивается, демон уменьшает значение своей копии переменной.
  • $sn0 - $sn9
    Эти переменные представляют собой копии значений $n0-$n9, сумматоры, бывшие в конце файла системного фильтра. Это позволяет системному фильтру устанавливать значения, которые могут быть проверены в файлах фильтров пользователей. Например, системный фильтр мог установить значение, указывающее, что это сообщение, вероятно, является спамом.
  • $spam_xxx
    Множество переменных с именами, начинающимися с $spam, доступны, если exim скомпилирован с расширением контентного сканирования. Для дополнительных деталей смотрите секцию 40.2.
  • $spool_directory
    Имя каталога спула для exim.
  • $spool_inodes
    Число свободных inоde в дисковом разделе, где exim держит свои spool-файлы. Значение пересчитывается каждый раз, когда к нему обращаются. Если файловая система не имеет понятия inode, то значение будет -1. Также смотрите опцию check_spool_inodes.
  • $spool_space
    Количество свободного места (как число килобайт) в дисковом разделе, где пишутся spool-файлы exim. Значение пересчитывается каждый раз, когда на переменную ссылаются. Если операционная система не может подсчитать количество свободного места (истинно для экспериментальных систем), то значение будет -1. Например, чтобы проверить в ACL, что есть хотя бы 50 мегабайт свободного места в спуле можно написать:
    condition = ${if > {$spool_space}{50000}}
    
    Также смотрите опцию "check_spool_space".
  • $thisaddress
    Эта переменная установлена только в процессе обработки команды foranyaddress в файле фильтра. Её использование объясняется в описании той команды, которая может быть найдена в документации на интерфейс фильтрации почты exim.
  • $tls_bits
    Содержит приближение разрядности шифра TLS, значение этого зависит от используемой реализации TLS. Если о TLS не договорились, значение будет 0. Значение этого автоматически берется из аутентификатора Cyrus SASL, работающего как сервер, чтобы определить "внешний SSF" (термин SASL).

  • $tls_certificate_verified
    Эта переменная установлена в 1, если при приёме сообщения сертификат TLS проверен и 0 в обратном случае.
  • $tls_cipher
    Когда сообщение получено с удалённого хоста по шифрованному SMTP-подключению, эта переменная содержит использовавшийся тип шифрования, например, DES-CBC3-SHA. При других обстоятельствах, в частности, для сообщения, полученного по незашифрованным подключениям, переменная пуста. Смотрите главу 38 для подробностей о поддержке TLS.
  • $tls_peerdn
    Когда сообщение получено с удалённого хоста по шифрованному SMTP-подключению, и exim сконфигурирован для запроса сертификата с клиента, значение переменной определяет имя сертификата, доступное в ней в процессе последующей обработки.
  • $tls_sni
    Когда сеанс TLS устанавливается, если клиент пошлет расширение Server Name Indication, то значение будет помещено в эту переменную. Если переменная появится в tls_certificate, то эта опция и некоторые другие, будут повторно раскрыты в сеансе TLS, чтобы разрешить использовать другой сертификат (и опционально будет использован другой ключ) клиенту, основанному на значении расширения SNI. Значение будет сохранено для всей жизни сообщения. Во время поставки SMTP это отражает значение опции tls_sni на транспорте.

  • $tod_bsdinbox
    Время и дата в формате почтового ящика BSD, например: Thu Oct 17 17:14:09 1995.
  • $tod_epoch
    Время и дата в виде числа секунд с начала эпохи Unix.
  • $tod_epoch_l
    Время и дата в виде числа микросекунд с начала эпохи Unix.

  • $tod_full
    Полная версия времени и даты, например: Wed, 16 Oct 1995 09:51:40 +0100. Временной пояс всегда даётся как часовое смещение от UTC с положительными значениями для поясов, которые впереди (к востоку), и отрицательных значений для тех, которые позади (на западе).
  • $tod_log
    Время и дата в формате используемом exim в его протоколах, например: 1995-10-12 15:32:29, но без временной зоны.
  • $tod_logfile
    Эта переменная содержит дату в формате yyyymmdd. Этот формат используется для штампа даты в файлах протоколов, когда log_file_path содержит флаг %D.
  • $tod_zone
    Эта переменная содержит числовое значение локальной временной зоны, например: -0500.
  • $tod_zulu
    Эта переменная содержит дату и время в формате Zulu, как задано в ISO 8601, например: 20030221154023Z.
  • $value
    Эта переменная содержит результат раскрытия поиска, операции извлечения или внешней команды, как описано выше.
  • $version_number
    Номер версии exim.
  • $warn_message_delay
    Эта переменная установлена только в течение создания предупредительного сообщения о задержке доставки. Детали по её использованию раскрыты в разделе 45.2.
  • $warn_message_recipients
    Эта переменная установлена только в течение создания предупредительного сообщения о задержке доставки. Детали по её использованию раскрыты в разделе 45.2.