Exim 11 Раскрытие строк

Раскрытие строк

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

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

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

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

Часть строки может быть определена как не раскрываемая, при помощи помещения её между двумя символами \N. Это необходимо для защиты регулярных выражений, которые часто содержат символы “$” и “\”. Например:

deny senders = \N^\d{8}[a-z]@some\.site\.example$\N

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

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

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

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

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

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

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

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

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

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

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

$<имя переменной> или ${<имя переменной>}

Замена содержимым, переменной, например:

$local_part
${domain}

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

• ${<op>:<строка>}

Вначале раскрывается строка, а затем производится заданная <op> операция. Например:

${lc:$local_part}

Строка начинается с первого символа после двоеточия, которое может предворяться пустым пространством. Список операторов приведён в секции 11.6. Нотация оператора использует простое раскрытие элементов, которые могут иметь один аргумент, поскольку это уменьшает число фигурных скобок, и позволяет легче понимать итоговую строку.

• ${dlfunc{<file>}{<function>}{<arg>}{<arg>}...}

Это раскрытие динамически загружается, и затем вызывает локальную функцию, написанную на C. Такая функциональность доступна лишь в случае, если exim собран со следующим аргументом:

EXPAND_DLFUNC=yes

заданным в Local/Makefile. Однажды загруженный, exim запоминает динамически загруженный объект, так что не требуется перезагружать файлы объектов при работе того же процесса exim (но сам экзим, часто запускает свои новые копии, при работе).

У функции может быть от нуля до восьми аргументов. Собирая локальную функцию, вызываемую таким образом, необходимо включить local_scan.h. Переменные и функции exim`a, определённые в API также доступны для динамически загружаемых функций. Сама функция должна иметь следующий вид:

int dlfunction(uschar **yield, int argc, uschar *argv[])

Где “uschar” является “typedef” для “unsigned char” в local_scan.h. Функция должна возвратить одно из следующих значений:

OK: Успех. Строка, помещённая в переменную “yield” помещена в раскрытую строку и будет построена.

FAIL: Непринудительная неудача раскрытия, с сообщением об ошибках взятых из “yield”, если такое задано.

FAIL_FORCED: Принудительный отказ раскрытия, с сообзением об ошибках из “yield”, если такое задано.

ERROR: Тоже что и “FAIL”, за исключением, что пишутся ошибки в лог.

При использовании gcc для сборки такой функции, необходимо добавить ключ “-shared” к строке запуска gcc. Также в при сборке exim`a необходимо добавить “-export-dynamic” в EXTRALIBS.

• ${extract{<key>}{<string1>}{<string2>}{<string3>}}

Вначале раздельно раскрываются “key” и “<string1>”. Начальные и замыкающие пустые символы (пробелы, табы) удаляются из “key” (но не из строк). Ключ (“key”) не должен состоять полностью из цифр. Раскрытая строка “<string1>” должна иметь форму:

<key1> = <value1>  <key2> = <value2> ...

где знак равенства и пробел (но не оба одновременно) опциональны. Если любое из значений содержит пустые символы, они должны быть помещены в двойные кавычки, чтобы быть обработанными, как описано в разделе 6.16. Раскрытие “<string1>” - поиск значения соответствующего ключу. Поиск нечувствителен к регистру. Если ключ найден, “<string2>” раскрывается, и заменяет элемент, иначе используется “<string3>”. В процессе раскрытия “<string2>” переменная $value содержит значение, которое было извлечено. Впоследствии, оно восстанавливается до предыдущего значение, которое, возможно, было.

Если “{<string3>}” отсутствует, элемент заменяется пустой строкой, если ключ не найден. Если “{<string2>}” также отсутствует, то используется значение, которое было извлечено. Таким образом, например, эти два раскрытия идентичны и уступают (видимо, соответствуют) “2001”:

${extract{gid}{uid=1984 gid=2001}}
${extract{gid}{uid=1984 gid=2001}{$value}}

Вместо “{<string3>}” может быть слово “fail” (не в фигурных скобках), например:

${extract{Z}{A=... B=...}{$value} fail }

Это вызывает “принудительный отказ раскрытия” (смотрите секцию 11.4); “{<string2>}” должна присутствовать, чтобы “fail” был распознан.

• ${extract{<number>}{<separators>}{<string1>}{<string2>}{<string3>}}

Аргумент “number” (число, в смысле цифра) должен полностью состоять из десятичных цифр, кроме начальных и конечных пустых символов, которые игнорируются. Это то, что отличает эту форму “extract” от предыдущего вида. Она ведёт себя точно также, за тем исключением, что вместо того, чтобы извлечь названное поле, оно извлекает из “<string1>” поле, номер которого даётся как первый аргумент. Вы можете использовать “$value” в “<string2>” или “fail” вместо “<string3>” как и прежде.

Поля в строке разделены любым из символов в строке разделителя. Они могут включать пустые символы и табы. Первое поле имеет номер один. Если номер отрицательный, то поля считаются с конца строки, считая что самое правое имеет номер “-1”. Если задано номер “0”, то возвращается вся строка, целиком. Если модуль числа (видимо, всё-таки, не модуль числа, а само число) больше чем число полей в строке, то результат - раскрытие строки “<string3>” или пустая строка, если “<string1>” отсутствует. Например:

${extract{2}{:}{x:42:99:& Mailer::/bin/bash}}

вернёт “42” и

${extract{-4}{:}{x:42:99:& Mailer::/bin/bash}}

вернёт “99”. Два последовательных разделителя означают, что область между ними пуста (например пятая область, в предыдущем примере).

• ${hash{<string1>}{<string2>}{<string3>}}

Это - текстовая функция хэширования, и она была первой, осуществлённой в ранних версиях exim. В нынешних релизах добавлены другие функции работы с хэшами (числовой, MD5, и SHA-1), описанные ниже.

Первые две строки, после раскрытия, должны быть числами. Зовите их “<m>” и “<n>”. Если вы используете фиксированные значения для этих чисел, т.е. “<string1>” и “<string2>” не изменяются при раскрытии, вы можете использовать более простой синтаксис оператора, без использования некоторых фигурных скобок:

• ${hash_<n>_<m>:<string>}

Второе число является опциональным (в обоих нотациях). Если “<n>” больше или равно длине строки, раскрытие строки вернёт саму строку. Иначе, будет вычислена новая строка с длинной “<n>”, с помощью применения функции хэширования к строке. Новая строка состоит из “<m>” символов взятых от начала строки.

abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQWRSTUVWXYZ0123456789

Если “<m>” не задана, то используется значение “26”, с целью, чтобы были тока строчные буквы. Например:

$hash{3}{monty}}              результат  jmg
$hash{5}{monty}}              результат  monty
$hash{4}{62}{monty python}}   результат  fbWx

• $header_<header name>: или $h_<header name>:

Смотрите $rheader ниже.

• $bheader_<header name>: или $bh_<header name>:

Cмoтpитe $rheader ниже.

• $rheader_<header name>: или $rh_<header name>:

Замена заголовка содержанием названной строки. Например:

$header_reply-to:

Символ новой строки, который завершает строку заголовка не включен в раскрытие, но внутренние символы новой строки (разделяющие заголовок на на несколько строк) могут присутствовать.

Различие между “rheader”, “bheader”, и “header” в способе интерпретации данных в строке заголовка.

• “rheader” - выдаёт оригинальное содержимое (“raw”) заголовка, вообще без обработки, без удаления начального и конечного пустого пространства.
• “bheader” - удаляет пустые символы в начале и конце строки, затем декодирует base64 или экранированные кавычками MIME “слова” в пределах заголовка, но не производит трансляции символов. Если расшифровка MIME “слов” неудачна, возвращается “raw” строка. Если в результате расшифровки появляется символ двоичного нуля, он заменяется вопросительным знаком, это то, что делает exim с бинарными нулями, переданными в строке заголовка.
• “header” - пробует транслировать строку как “bheader”, к стандартному набору символов. Это - попытка воспроизвести ту же строку, которая была бы отображена MUA пользователю. Если трансляция неудачна, возвращается строка “bheader”. Попытки трансляции предпринимаются только на OC которые поддерживают функцию iconv(). Это указано при компиляции макросом “HAVE_ICONV”в системном Makefile или Local/Makefile.

В файле фильтра, целевой набор символов для заголовка может быть определен командой следующей формы:

headers charset "UTF-8"

Эта команда затрагивает все ссылки на расширения “$h_” (или “$header_”) в командах фильтра. В отсутствии этой команды, итоговый набор символов устанавливается из опции “headers_charset” в текущей конфигурации. Дефолтовые значения этих опий - значение “HEADERS_CHARSET” Local/Makefile. Окончательное значение по-умолчанию - ISO-8859-1.

Имена заголовков следуют синтаксису RFC 2822, в котором говориться, что они могут содержать любые символы, кроме пробелов и двоеточий. Следовательно, фигурные скобки, не заканчивают имена заголовков, и не могут использоваться для помещения в начале и конце, как в переменных. Попытка сделать такое - ошибка синтаксиса.

Только заголовки, являющиеся общими для всех копий сообщения видны этому механизму. Тут фигурируют только оригинальные заголовки, переданные с сообщением, и некоторые, добавленые правилами “warn”, или системным фильтром. Заголовки, добавленные к особой копии сообщения, роутером или транспортом - недоступны.

Для входящих SMTP сообщений, никакие заголовки не видны в ACL, в правилах до DATA ACL, поскольку структура заголовка не установлена, пока сообщение не получено. Заголовки, добавленные правилами “warn”, например в RCPT ACL, сохраняются до тех пор пока, недоступны заголовки входящего сообщения, в какой точке они добавлены. Однако, когда выполняются DATA ACL, заголовки добавленные другими ACL - видны.

В именах заголовков не имеет значения, какие используются буквы - заглавные, или строчные. Если следующий символ - пробел, то завершающее доеточие может быть пропущено, но это не рекомендуется, поскольку вы можете забыть об этом, когда оно понадобиться. Когда имя заголовка завершается пробелом, оно включается в раскрываемую строку. Если сообщение не содержит данный заголовок, раскрытие заменяется пустой строкой. (Смотрите условие определения в секции 11.7 для проверки существования заголовка.)

Если есть более чем один заголовок с одинаковым именем, то все они объединяются для формирования строки замены, максимальной длинны 64k. Символ новой сроки вставляется между каждой строкой. Для раскрытия заголовка, для тех заголовков, которые содержат список адресов, также вставляется запятая, между строками.

• ${hmac{<hashname>}{<secret>}{<string>}}

Эта функция использует криптографическое хэширование (либо “MD5” либо “SHA-1”), для конвертации пароля и текста, в код идентификации сообщения, как определено в RFC 2104. Это отличается от “${sha1:secret_text...}” или “${sha1:secret_text...}”, в этом шаге “hmac” добавляет в подпись криптографический хэш допустимый для аутентификации, что невозможно только с “MD5” or “SHA-1”. Имя хэша, в настоящее время, должно быть либо “MD5” либо “SHA-1”. Например:

${hmac{md5}{somesecret}{$primary_hostname $tod_log}}

Для имени хоста “mail.example.com” и времени “2002-10-17 11:30:59”, это будет:

dd97e3ba5d1a61b5006108f8c8252953

Как пример, где это можно использовать, вы могли бы поместить в основной части конфигурации экзима:

SPAMSCAN_SECRET=cohgheeLei2thahw

В роутере или транспорте можно было бы иметь:

headers_add = \
  X-Spam-Scanned: ${primary_hostname} ${message_exim_id} \
  ${hmac{md5}{SPAMSCAN_SECRET}\
  {${primary_hostname},${message_exim_id},$h_message-id:}}

Тогда данное сообщение, вы могли бы проверить, где оно было проверено, по заголовкам “X-Spam-Scanned:”. Если вы знаете секретную строку, то можно проверить подлинность этой строки, повторно вычислив опознавательный код из имени хоста, message ID и заголовка “Message-id:”. Это может быть сделано с использованием опции экзима “-be”, или другими средствами, например использованием функции hmac_md5_hex() в Perl.

• ${if <condition> {<string1>}{<string2>}}

Если “<condition>” - истинно, то раскрывается “<string1>” и заменяет весь элемент; иначе используется “<string2>”. Доступные кондишены описаны в секции 11.7. Например:

${if eq {$local_part}{postmaster} {yes}{no} }

Вторая строка может не присутствовать, если условие не соответствует, и условие не истинно, элемент ничем не заменяется. Аналогично, слово “fail” может быть вместо второй строки (без фигурных скобок). В этом случае происходит принудительный отказ раскрытия, если условие не истинно (смотрите секцию 11.4).

Если отсутствуют обе строки, результат - строка “true” если условие истинно, и пустая строка если условие ложно. Это облегчает написание своих ACL и условий для роутеров. Например, вместо:

condition = ${if >{$acl_m4}{3}{true}{false}}

вы можете использовать

condition = ${if >{$acl_m4}{3}}

• ${length{<string1>}{<string2>}}

Элемент “length” используется для извлечения начальной части строки. Обе строки раскрываются, и первая должна вернуть число “<n>”. Если вы используете жёстко заданное число, т.е. строка “<string1>” при раскрытиии не изменяется, вы можете использовать более простую нотацию оператора, без некоторых фигурных скобок:

${length_<n>:<string>}

Результатом будет или первые “<n>” символов, или вся строка “<string2>”, смотря что короче. Не путайте “length” со “strlen”, возвращающей длинну строки.

• ${lookup{<key>} <search type> {<file>} {<string1>} {<string2>}}

Это первый из двух различных типов поиска отдельных элементов, оба которых описаны в следующем пункте.

• ${lookup <search type> {<query>} {<string1>} {<string2>}}

Две формы поиска определяют поиск данных в БД и файлах, как обсуждается в главе 9. Первая форма использует одноключевой поиск, а вторая использует стиль запросов для поиска. Строки “<key>”, “<file>”, и “<query>” раскрываются перед использованием.

Если есть пустые символы в элементе поиска как часть команды фильтра, правила повтора или перезаписи, правила роутинга для “manualroute”, или любого другого мета, где пустое пространство существенно, то элемент поиска должен быть заключён в двойные кавычки. Использование поиска данных в файлах фильтров пользователей может быть заблокировано системным администратором.

Если поиск успешен, “<string1>” раскрывается и замещает весь элемент. В процессе его раскрытия переменная $value содержит данные, возвращённые поиском. Впоследствии оно возвращается к предыдущему своему значению (внешне оно пустое). Если поиск неудачен, раскрывается “<string2>” и замещает элемент. Если “<string2>” пропущена, то замена - пустая строка, в случае неудачного поиска. Если “<string2>” присутствует, то она может быть самостоятельным вложенным поиском, таким образом обеспечивая механизм поиска значения по-умолчанию, в случае неудачи основного поиска.

Если вложенный поиск используется как часть “<string1>”, $value содержит данные для внешнего поиска, когда параметры второго поиска раскрыты, и также когда “<string2>” второго поиска раскрыта, второй поиск будет неудачен (нихрена толком не понял этой фразы). Вместо “<string2>” можно использовать “fail”, и в этом случае, если поиск неудачен, с раскрытием происходит “принудительный отказ при раскрытии строки” (смотрите секцию 11.4). Если пропущены обе строки - “<string1>” и “<string2>” то результат - искомое значение в случае успешного поиска, и ничего в случае неудачи.

Для одноключевого поиска “неполной” строке разрешается предшествовать типу поиска, чтобы сделать частичное соответствие и * или *@ могут быть вместе со строкой поиска, для поиска по-умолчанию, если ключ не совпадает (смотрите секции 9.6 и 9.7 для деталей).

Если используется частичный поиск, переменные “$1” и “$2” содержат части ключа в процессе раскрытия текста замены. Они возвращаются к их предыдущим значениям после окончания поиска.

Вот пример поиска альяса “postmaster”`a в обычном файле альясов:

${lookup {postmaster} lsearch {/etc/aliases} {$value}}

Этот пример использует NIS+ для поиска полного имени пользователя, соответствующего локальной части адреса, с принудительным отказом раскрытия, в случае неудачи.

${lookup nisplus {[name=$local_part],passwd.org_dir:gcos} \
  {$value}fail}

• ${nhash{<string1>}{<string2>}{<string3>}}

Три строки раскрываются; первые две должны вернуть числа. Зовите их “<n>” и “<m>”. Если вы используете жёско заданные значения этих чисел, т.е. если “<string1>” и “<string2>” не изменяются при раскрытии, то вы можете использовать более простую форму этого оператора, без использования некоторых фигурных скобок:

${nhash_<n>_<m>:<string>}

Второе число является опциональным (в обоих нотациях). Если тут только одно число, результатом будет число из диапазона от нуля до <n>-1. Иначе строка, обработанная функцией хэшрования, вернёт два числа, разделённых слэшем, в диапазонах от нуля до <n>-1 и от нуля до <m>-1, соответственно. Например:

${nhash{8}{64}{supercalifragilisticexpialidocious}}

вернёт строку “6/33”.

• ${perl{<subroutine>}{<arg>}{<arg>}...}

Этот элемент доступен лишь в том случае, если exim собран с встроенным интерпретатором perl. Имя подпрограммы и параметры, вначале, раздельно раскрываются, а затем вызывается подпрограмма perl с этими параметрами. Никакие дополнительные параметры передаваться не должны; максимальное разрешённое число аргументов, включая имя подпрограммы - девять.

Значение возвращённое подпрограммой вставляется в раскрываемую строку, за тем исключением, если возвращённое значение “undef”. В этом случае, раскрытие неудачно, точно также как при “fail” в поиске. Возвращённое значение - скалярная величина. Независимо от того, что вы возвращаете, оно будет скалярной величиной. Например, если вы вернёте имя вектора perl, возвращённое значение будет размер вектора, а не содержимое.

Если подпрограмма выполняется с вызовом функции perl die(), раскрытие неудачно, с сообщенем об ошибках, которые были переданы функцией die(). Больше информации, о встроенном perl можно получить из главы 12.

Роутер “redirect” имеет опцию вызывающую “forbid_filter_perl”, которая блокирует использование этого пункта в файлах фильтра.

• ${prvs{<address>}{<secret>}{<keynumber>}}

Первый параметр - полный e-mail адрес, и второй - секретная ключевая строка. В третьем аргументе задаётся номер ключа, и он является опциональным. При его отсутствии значение по-дефолту - ноль. Результат раскрытия - prsv-подписанный адрес e-mail, типичное его использование - с опцией “return_path” транспорта “smtp” как часть проверки схемы адреса возврата (BATV). За дополнительной информацией и примерами обратитесь к секции 39.38.

• ${prvscheck{<address>}{<secret>}{<string>}}

Этот пункт - дополнение пункта “prvs”. Он используется для проверки prsv-подписанных адресов. Если раскрытие первого параметра не приводит к синтаксически правильному prsv-подписанному адресу, то всё раскрывается в пустую строку. Когда первый параметр раскрывается в синтаксически правильный prsv-подписанный адрес, второй аргумент раскрывается с prvs-расшифрованным адресом и ключевым числом, в переменных $prvscheck_address и $prvscheck_keynum соответственно.

Эти две переменные могут использоваться в раскрытии второго аргумента, для отыскания секретного слова. Тогда действительность prsv-подписанного адреса проверяется по нему. Результат сохраняется в переменную $prvscheck_result, пустую при ошибке и “1” при соответствии.

Третий параметр является дополнительным, если он отсутствует, то дефолт - пустая строка. Теперь этот параметр раскрыт. Если результат - пустая строка, то результат раскрытия - расшифрованная версия адреса. Проверяется, была ли сигнатура верной. Иначе, результат раскрытия - раскрытие третьего аргумента.

Все три переменные могут использоваться в раскрытии третьего параметра. Однако, по завершении раскрытия остаётся только $prvscheck_result. За дополнительной информацией и примерами обратитесь к секции 39.38.

• ${readfile{<file name>}{<eol string>}}

Вначале, раздельно раскрываются “имя файла” и “набор символов конца строки”. Затем читается файл, и его содержимое заменяет весь пункт. Символы новой строки в файле, заменяются строкой “<eol string>”, если они есть. Иначе, символы перевода строк оставляют на месте. Раскрытие строки не применяется к содержимому файла. Если же вы хотите этого, то необходимо поместить элемент в оператор “expand”. Если файл не может быть прочитан, раскрытие строки неудачно.

Роутер “redirect” имеет опцию “forbid_filter_readfile” которая блокирует использование этого пункта в пределах файлов фильтра.

• ${readsocket{<name>}{<request>}{<timeout>}{<eol string>}{<fail string>}}

Этот пункт вставляет данные из UNIX или Internet-сокета в раскрываемую строку. Минимальный способ использования требует только два аргумента, как в этих примерах:

${readsocket{/socket/name}{request string}}
${readsocket{inet:some.host:1234}{request string}}

Для UNIX-сокета, первая подстрока должна быть путём к сокету. Для Internet-сокета, первая подстрока должна содержать подстроку “inet:” сопровождаемую именем хоста или IP адресом, через двоеточие порт, или имя сервиса, которое должно быть в “/etc/services”. Опционально, IP-адрес может заключаться в квадратные скобки. Адреса IPv6 лучше записывать именно так. Например:

${readsocket{inet:[::1]:1234}{request string}}

Можно задать только одно имя хоста, но если поиск по нему приведёт более чем к одному IP-адресу, будут сделаны попытки соединиться с каждым из них, по очереди, пока не получиться подключиться. Для обоих видов сокетов, exim осуществляет подключение, пишет строку запроса (если она не пустая), и читает из сокета пока не наступит конец файла. Применяется таймаут в 5 секунд. Дополнительные аргументы могут продлить это время. Во-первых, можно изменить таймаут:

${readsocket{/socket/name}{request-string}{3s}}

Четвёртый аргумент позволяет изменить символ перевода строки в читаемых данных, таким же образом как и в “readfile” (смотрите выше). Этот пример превращает их в пробелы:

${readsocket{inet:127.0.0.1:3294}{request-string}{3s}{ }}

Как и во всех раскрытиях, подстроки раскрываются до начала обработки. Ошибки в под-раскрытиях приводят к ошибке самого раскрытия. Кроме того, могут встречаться такие ошибки:

• Ошибка создания дескриптора файла сокета.
• Ошибка соединения с сокетом.
• Ошибка записи строки запроса.
• Таймаут чтения из сокета.

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

${readsocket{/socket/name}{request-string}{3s}{\n}\
  {socket failure}}

Вы можете проверить существование Unix-сокета, поместив раскрытие в ${if exists, но получается проверка кто отработает быстрей - открытие сокета, или проверка его существования. Таким образом, более корректно использовать пятый параметр, чтобы быть уверенным в том что будет корректно обработана ошибка раскрытия несуществующего Unix-сокета, или ошибка соединения с интернет-сокетом.

Роутер “redirect” имеет опцию “forbid_filter_readsocket” которая блокирует использование этого пункта в пределах файлов фильтра.

• $rheader_<header name>: or $rh_<header name>:

Этот пункт вставляет необработанные (“raw”) строки заголовка. Это описано в пункте “header”, выше.

• ${run{<command> <args>}{<string1>}{<string2>}}

Вначале, отдельно, раскрываются команда и её параметры, затем команда запускается отдельным процессом, но под теми же gid и uid. Как и во всех других командах, выполняемых exim, по дефолту shell не используется. Если вы хотите его использовать, то нужно явно указать это в коде.

Если команда выполняется успешно (возвращённый код равен нулю), то “<string1>” раскрывается и замещает строку; в процессе этого раскрытия стандартный вывод команды находиться в переменной $value. Если команда неудачна, то раскрывается и используется “<string2>”. Ещё раз, стандартный вывод команды, в процессе раскрытия находиться в переменной $value. Если “<string2>” отсутствует, то результат пуст. Альтернативно, “<string2>” может быть словом “fail” (не в фигурных скобках), для принудительного отказа от раскрытия, если команда не была успешно выполнена. Если пусты обе строки, то результат содержит стандартный вывод, в случае успеха и ничего не содержит в случае неудачи.

Код возврата команды помещается в переменную $runrc, и впоследствии остаётся установленным, поэтому, в файле фильтра можно делать так:

if "${run{x y z}{}}$runrc" is 1 then ...
  elif $runrc is 2 then ...
  ...
endif

Если выполнение команды неудачно (например, команда не существет), то код возврата равен 127 - тот же самый код, который шеллы используют для несуществующих команд.

Предупреждение: В роутере или транспорте вы не можете установить порядок раскрытия опций, за 
исключением тех предварительный условий, чей порядок задокументирован. Поэтому нельзя быть 
уверенным в том что находиться в $runrc, запуская команду в одной опции и используя эту переменную 
в другой.

Роутер “redirect” имеет опцию “forbid_filter_run” которая блокирует использование этого пункта в пределах файлов фильтра.

• ${sg{<subject>}{<regex>}{<replacement>}}

Этот пункт работает как оператор замены в perl, с глобальной опцией “/g”. Однако, в отличие от perl, exim не изменяет строку, вместо этого он возвращает строку для вставки в общее раскрытие. Есть три параметра: строка объекта, регулярное выражение, строка замены. Например:

{sg{abcdefabcdef}{abc}{xyz}}

результат - “xyzdefxyzdef”. Поскольку все три параметра раскрываются перед использованием, то если в регулярном выражении необходимы символы “$” или символы содержащие обратный слэш, то они должны быть экранированы. Например:

${sg{abcdef}{^(...)(...)\$}{\$2\$1}}

вернёт “defabc”, и

${sg{1=A 4=D 3=C}{\N(\d+)=\N}{K\$1=}}

вернёт “K1=A K4=D K3=C”. Отметьте использование “\N” для защиты регулярного выражения от раскрытия.

• ${substr{<string1>}{<string2>}{<string3>}}

Три строки раскрываются, первые две должны вернуть числа. Зовите их “<m>” и “<n>”. Если вы используете фиксированные значения для этих чисел, т.е. “<string1>” и “<string2>” не изменяются при раскрытии, вы можете использовать более простой синтаксис оператора, без использования некоторых фигурных скобок:

${substr_<n>_<m>:<string>}

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

Элемент “substr” может использоваться для извлечения более коростких подстрок из более длинной. Первое число “<n>”, является смещением точки начала, второе - “<m>” - требуемая длинна. Например:

${substr{3}{2}{$local_part}}

Если стартовое смещение - больше длинны строки - то результатом будет пустая строка; если сумма старта плюс длинна смещения - результатом будет правая часть строки начинающаяся с точки старта.Первый символ строки имеет позицию ноль.

Элемент “substr” может иметь отрицательные значения смещения, чтобы рассчитать позицию с правой стороны строки. Последний символ имеет значение смещения -1, предпоследний -2 и так далее. Вот пример:

${substr{-5}{2}{1234567}}

результат - “34”. Если абсолютное значение отрицательного смещения больше, чем длинна строки, то подстрока начинается с начала строки и её длинна уменьшается на величину проскакивания. Например:

${substr{-5}{2}{12}}

вернёт пустую строку, но

${substr{-3}{2}{12}}

вернёт “1”.

Когда второй параметр “substr” опущен, то берётся остаток строки, при положительном смещении. Если же смещение отрицательно, то берутся все символы строки, предшествующие точке смещения. Например, смещение -1 и никакая (нулевая) длинна, в этих одинаковых примерах:

${substr_-1:abcde}
${substr{-1}{abcde}}

вернёт всю строку, кроме последнего символа, т.е. “abcd”.

• ${tr{<subject>}{<characters>}{<replacements>}}

Этот элемент - посимвольная замена строки объекта. Второй аргумент - список символов, которые будут заменены в строке объекта. Каждый совпадающий символ заменяется соответствующим символом из списка замены. Например:

${tr{abcdea}{ac}{13}}

вернёт “1b3de1”. Если во второй строке символов есть повторения, то используется последний из символов. Если третья строка короче чем вторая, последний символ копируется. Однако, если она пуста, то замена не производится.

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

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

• ${address:<string>}

Строка интерпретируется как адрес, согласно RFC 2822, и поскольку это может фигурировать в строках заголовков, то из неё извлекается эффективный адрес. Если строку не удаётся успешно разобрать, то результат пуст.

• ${base62:<digits>}

Строка должна полностью состоять из десятичных цифр. Число конвертируется к основанию 62 выводится как строка из шасти символов, включая ведущие нули. В некоторых окружениях, где exim использует основание 36 вместо 62 для идентификаторов сообщений (поскольку эти системы не учитывают регистр символов в имени файла), основание 36 используется этим оператором несмотря на его название. Отметьте: Чтобы было абсолютно ясно: это не кодирование base64.

• ${base62d:<base-62 digits>}

Строка должна полностью состоять из цифр с основанием 62, или, в операционных системах где exim использует основание 36 вместо 62, из цифр с основанием 36. Число преобразуется в десятичные цифры, и выводится как строка.

• ${domain:<string>}

Строка интерпретируется как адрес, в соответствии с RFC 2822, и из неё извлекается домен. Если строка не может быть корректно разобрана, то результат пуст.

• ${escape:<string>}

Если строка содержит какие-то непечатные символы (ага, слова из трёх букв, например :)), то они будут преобразованы к их escape-последовательностям, начинающимся с символа обратного слэша (“\”). Символы, с установленным битом значимости (так называемые “8-ми битные символы”) считаются “печатными” и не контролируются опцией “print_topbitchars”.

• ${eval:<string>} и ${eval10:<string>}

Эти пункты поддерживают простейшие арифметические операции в раскрываемых строках. Строка (после раскрытия) должна быть обычным арифметическим выражением, но оно ограничено пятью основными операторами (плюс, минус, умножение, деление и остаток) и круглыми скобками. Все операции выполняются с использованием арифметики целых чисел. Плюс и минус имеют меньший приоритет чем умножение, деление и остаток. Операторы с одинаковым приоритетом оцениваются слева направо.

В “eval” числа могут быть десятичными, восьмеричными (начинаются с “0”) или шестнадцатеричными (начинаются с “0x”). В “eval10” все числа считаются десятичными, даже если они начинаются с нуля. Это может оказаться полезным при обработке чисел извлечённых из дат и времени, они часто содержат ведущие нули.

Число может сопровождаться “K” или “M” для умножения его на 1024 или 1024*1024, соответственно. Поддерживаются отрицательные числа. Результат вычисления - десятичное число (без “K” или “M”). Например:

${eval:1+1}       результат 2
${eval:1+2*3}     результат 7
${eval:(1+2)*3}   результат 9
${eval:2+42%5}    результат 4

Как более реалистичный пример, в ACL можно использовать так:

deny   message = Too many bad recipients
       condition =                    \
         ${if and {                   \
           {>{$rcpt_count}{10}}       \
           {                          \
           <                          \
             {$recipients_count}      \
             {${eval:$rcpt_count/2}}  \
           }                          \
         }{yes}{no}}

Условие верно в случае, если было более 10 команд RCPT и меньше половины из них привели к правильному получателю.

• ${expand:<string>}

Оператор “expand” заставляет раскрывать строку по второму разу. Например:

${expand:${lookup{$domain}dbm{/some/file}{$value}}}

вначале ищет строку в файле, в процессе раскрытия оператора “expand”, а затем снова раскрывает то, что было найдено.

• ${from_utf8:<string>}

Мир медленно двигается в сторону Unicode, и хотя для электронной почты стандартов нет, она тоже двигается туда же. Многие другие приложения (включая некоторые БД) начинают сохранять данные в Unicode, используя кодировку UTF-8. Этот оператор конвертирует строку UTF-8 в строки ISO-8859-1. Коды символов UTF-8 более 255 преобразовываются в подчёркивания.Ввод должен быть корректной строкой UTF-8. Если это не так, то результатом будет неопределённая последовательность символов.

Точки кодов Unicode со значениями меньше 256 совместимы с ASCII и ISO-8859-1 (также известной как Latin-1). Для примера, символ 169 - символ копирайта (“©”)в обоих случаях, хотя способ которым он закодирован - различен. В режиме UTF-8, более чем один байт необходим для символов кодом более 127, тогда как в ISO-8859-1 используется однобайтное кодирование (таким образом, оно ограничено 256 символами). Это позволяет сделать прямой перевод из UTF-8 в ISO-8859-1.

• ${hash_<n>_<m>:<string>}

Оператор “hash” - это более простой интерфейс к функции хэширования, которая может использоваться, когда два её параметра - фиксированные числа (в противоположность строкам, динамически строящимся при раскрытии). Эффект, тоже самое, что и:

${hash{<n>}{<m>}{<string>}}

Для дополнительных подробностей, смотрите описание главного оператора “hash” выше. Аббревиатура “h” может использоваться, когда “hash” используется как оператор.

• ${hex2b64:<hexstring>}

Этот оператор используется для преобразования шестнадцатеричной строки в кодировку base64. Это бывает полезно при обработке вывода функций хэширования md5 и sha-1.

• ${lc:<string>}

Это переводит буквы в нижний регистр. Например:

${lc:$local_part}

• ${length_<number>:<string>}

Оператор “length” - это более простой интерфейс к функции “length”, которая может использоваться, когда её параметр - фиксированное число (в противоположность строкам, динамически строящимся при раскрытии). Эффект, тоже самое, что и:

${length{<number>}{<string>}}

Для получения дополнительной информации, смотрите примечания к к основной функции “length”. Заметьте, “length” не тоже самое что и “strlen”. Аббревиатура “l” может применяться при использовании “length” в качестве оператора.

• ${local_part:<string>}

Строка интерпретируется как адрес, в соответствии с RFC 2822, и из неё извлекается локальная часть адреса. Если строка не может быть корректно разобрана, то результат пуст.

• ${mask:<IP address>/<bit count>}

Если формат строки не соответствует адресу IP и маске через слэш (т.е. сервой адрес в CIDR-нотации), раскрытие будет неудачным. Иначе, этот оператор преобразует IP-адрес в двоичный вид, маску, от наименьших битов, и преобразует результат обратно в текстовый вид, с прилагаемой маской. Например:

${mask:10.111.131.206/28}

вернёт строку “10.111.131.192/28”. Так как предполагается, что эта операция, главным образом, будет использоваться для поиска адресов в файлах, результат для IPv6 использует точчки для разделения компонентов адреса, вместо двоеточий, поскольку двоеточия используются для разделения ключевых строк в “lsearch” файлах. Например:

${mask:3ffe:ffff:836f:0a00:000a:0800:200a:c031/99}

вернёт строку

3ffe.ffff.836f.0a00.000a.0800.2000.0000/99

Буквы, в адресах IPv6 всегда выводятся в строчном виде.

• ${md5:<string>}

Оператор “md5” вычисляет значение хэша MD5 строки, и возвращает его как шестнадцатеричное число с 32 цифрами, в котором все буквы в строчном виде.

• ${nhash_<n>_<m>:<string>}

Оператор “nhash”, это простой интерфейс к функции числового хэширования, которая может использоваться, когда оба параметра - фиксированные числа (в противоположность строкам, динамически строящимся при раскрытии). Эффект точно такой же как от:

${nhash{<n>}{<m>}{<string>}}

Для дополнительных подробностей, смотрите описание главного оператора “nhash” выше.

• ${quote:<string>}

Оператор “quote” помещает переданный ему параметр в двойные кавычки, если это пустая строка, или содержит что-либо кроме букв, цифр, символа подчёркивания, точек или дефисов. Любые вхождения двойных кавычек и обратного слэша, экранируются обратным слэшем. Символы новой строки и возврата каретки преобразуются в “\n” и “\r” соответственно. Например,

${quote:ab"*"cd}

становиться

"ab\"*\"cd"

Это полезно в местах, где аргумент - замена из переменной или заголовок сообщения.

• ${quote_local_part:<string>}

Этот оператор похож на предыдущий, “quote”, за тем исключением, что в кавычки она заключается по правилам RFC 2822 для локальных частей адреса. Например символ “+” не вызвал бы заключение в кавычки (но при использовании “quote” строка была бы помещена в кавычки). Если вы создаёте новый адрес e-mail из содержимого “$local_part” (или других неизвестных данных), то вы всегда должны использовать этот оператор.

• ${quote_<lookup-type>:<string>}

Этот оператор применяет специфические правила экранирования, помещения в кавычки и замены к строке. Каждый тип запроса имеет свои правила, описанные в главе 9. Например:

${quote_ldap:two * two}

вернёт

two%20%5C2A%20two

Для одноключевых поисков нет необходимости в кавычках, и этот оператор вернёт неизменную строку.

• ${rxquote:<string>}

Оператор “rxquote” прослэшивает все символы не являющиеся алфавитно-цифровыми. Это применяется, например, для замены значений переменных или заголовков внутри регулярных выражений.

• ${rfc2047:<string>}

Этот оператор шифрует текст согласно RFC2047. Это кодирование используется в строках заголовков, для кодирования символов не-ASCII. Предполагается, что входная строка находиться в кодировке, определённой опцией “headers_charset”, с дефолтом ISO-8859-1. Строки содержащие символы только в диапазоне 33–126, и не содержащие символов типа:

? = ( ) < > @ , ; : \ " . [ ] _

не модифицируются. В противном случае, результат - строка закодированная в соответствии с RFC2047, содержащая так много закодированных букв, сколько нужно для кодирования строки.

• ${sha1:<string>}

Оператор “shal” вычисляет хэш SHA-1 строки, и возвращает это значение как шестнадцатеричное число с 40 цифрами, в котором все буквы находятся в прописном регистре.

• ${stat:<string>}

Строка, после раскрытия, должна представлять собой путь к файлу. Для этого пути делается вызов функции stat(). Если она (stat()) вернёт ошибку, то происходит ошибка раскрытия. Если же она отрабатывает успешно, то данные от stat() заменяют элемент, в виде ряда пар “<name>=<value>” где все значения числовые, за исключением значения “smode”. Имена: “mode” (даёт режим в виде восьмеричного числа, с четырьмя цифрами), “smode” (даёт режим в символическом формате, как 10-ти символьную строку, как команда “ls”), “inode”, “device”, “links”, “uid”, “gid”, “size”, “atime”, “mtime”, и “ctime”. Вы можете извлечь отдельные поля с использованием оператора “extract”.

Использование функции “stat” в файлах фильтров пользователей может быть блокировано системным администратором. Предупреждение: размер файла может быть неправильным на 32-х разрядных системах, для файлов больше 2Gb размером.

• ${str2b64:<string>}

Этот оператор кодирует строку в кодировку base64.

• ${strlen:<string>}

Этот пункт - заменяется длинной строки, в десятичном виде. Отметьте: не путайте “strlen” с “length”.

• ${substr_<start>_<length>:<string>}

Оператор “substr” - это простой интерфейс к функции “substr”, который может использоваться, когда оба параметра функции - фиксированные числа (в отличие от раскрываемых строк). Эффект очно такой же как:

${substr{<start>}{<length>}{<string>}}

За дополнительными деталями обратитесь к описанию функции “substr”. Аббревиатура “s” может использоваться, когда “substr” используется как оператор.

• ${time_eval:<string>}

Этот элемент преобразует временные интервалы exim, типа “2d4h5m” в число секунд.

• ${time_interval:<string>}

Параметр (после раскрытия подстроки) должен представлять собой последовательность десятичных цифр, которая представляет собой временной интервал в секундах. Число преобразуется к формату времени exim, например “1w3d4h2m6s”.

• ${uc:<string>}

Преобразует буквы в верхний регистр.

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

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

• !<condition>

Восклицательный знак перед любым условием, приводит результат условия к противоположному.

• <symbolic operator> {<string1>}{<string2>}

Есть несколько символических операторов для проведения операций сравнения:

Оператор	Значение
“=”	равно
“==”	равно
“>”	больше
“>=”	больше или равно
“<”	меньше
“<=”	меньше или равно

Например:

${if >{$message_size}{10M} ...

Заметьте, что можно проверять неравенство, оператором отрицания (“!”). Обе строки должны принимать форму десятичных чисел, опционально используемо “K” или “M” (в заглавном или строчном виде), что будет означать умножение на 1024 или 1024*1024 соответственно.

• crypteq {<string1>}{<string2>}

Это сравнение включено в бинарный файл exim, если он собран с поддержкой механизмов аутентификации (смотрите главу 33). Иначе, необходимо определить “SUPPORT_CRYPTEQ” в “Local/Makefile” для включения “crypteq” в исполняемый файл exim.

Кондишен “crypteq” имеет два аргумента. Содержимого первого шифруется, и сравнивается со вторым, который уже зашифрован. Вторая строка может быть в форме хранения шифрованных строк в LDAP, которые начинаются с фигурных скобок, содержащих условие (алгоритм). Если вторая строка не начинается с “{”, то предполагается что алгоритм шифрования “crypt()” или “crypt16()” (смотрите ниже), т.к. такие строки не могут начинаться на “{”. Обычно это поле из файла паролей. Пример зашифрованной строки в формате LDAP:

{md5}CY9rzUYh03PK3k6DJie09g==

Если такая строка появляется непосредственно, в раскрытой строке, то фигурные скобки должны быть указаны, поскольку они - часть синтаксиса. Например:

${if crypteq {test}{\{md5\}CY9rzUYh03PK3k6DJie09g==}{yes}{no}}

Следующие типы шифрования (их имена не зависят от регистра) поддерживаются:

• {md5} - вычисляет MD5 сумму первой строки, и и представляет её в виде набора “печатных” символов, для сравнения с остатком от второй строки. Если длинна сравниваемой строки 24 символа, то exim предполагает что она закодирована base64 (как в примере выше). Если длинна 32 символа, exim предполагает что это шестнадцатеричное кодирование MD5. Если же длинна не 24 и не 32 то сравнение оканчивается неудачей.
• {sha1} - вычисляет SHA-1 сумму первой строки, представляет её в “печатном” виде, и сравнивает с остатком от второй строки. Если длинна сравнения 28 символов, то exim предполагает что это закодировано base64. Если длинна 40 символов, то предполагается что это шестнадцатеричное кодирование суммы SHA-1. Если же длинна не 28 и не 40 то сравнение оканчивается неудачей.
• {crypt} - вызывает функцию “crypt()”, которая традиционно, использовала только первые восемь символов пароля. Однако, во многих современных ОС это уже не так, и используется весь пароль, несмотря на его длину.
• {crypt16} - вызывает функцию “crypt16()” (также известную как “bigcrypt()”), которая, изначально, была создана для использования первых 16-ти символов пароля. Опять-таки, в современных ОС может использоваться больше символов.

Exim имеет собственную версию “crypt16()” (которая является просто двойным вызовом функции “crypt()”). Для ОС которые имеют свою версию, установка “HAVE_CRYPT16” в “Local/Makefile” при сборке exim, заставляет его использовать версию из ОС, а не его собственную. Эта опция включена, по-умолчанию, в ОС-зависимом “Makefile”, для тех операционных систем, про которые известно, что они поддерживают “crypt16()”.

Если вы не помещаете тип криптования в фигурные скобки, при “crypteq” сравнении, то значение по-умолчанию также “{crypt}” или “{crypt16}”, как определено установкой опции “DEFAULT_CRYPT” в “Local/Makefile”. Значение по-умолчанию дефолтового значения - “{crypt}”. Вне зависимости от значения по умолчанию, вы можете использовать любую функцию, явно указав её в фигурных скобках.

Заметьте, что если пароль не более восьми символов длинной, то результат его шифрования функциями “crypt()” и “crypt16()” идентичен. Это означает что “crypt16()” обратно совместим, до тех пор, пока, ему не скормят пароль длинней восьми символов.

• def:<variable name>

Условие “def” может содержать имя одной из раскрываемых переменных, заданных в секции 11.9. Условие истинно, если переменная не содержит пустую строку. Например:

${if def:sender_ident {from $sender_ident}}

Заметьте, что имя переменной даётся без начального символа “$”. Если переменная не существует, то раскрытие неудачно.

• def:header_<header name>: или def:h_<header name>:

Это условие истинно, если сообщение обрабатывается, и указанный заголовок в нём существует. Например:

${if def:header_reply-to:{$h_reply-to:}{$h_from:}}

Заметьте: Символ “$” появляется в условии до “header_” или “h_”, и имя заголовка должно оканчиваться заголовком, если за ним не идёт пустое место (пробелы и прочее).

• eq {<string1>}{<string2>}

Вначале раскрываются подстроки. Условие истинно, если получившиеся подстроки идентичны, в том числе и в регистре букв.

• eqi {<string1>}{<string2>}

Вначале раскрываются подстроки. Условие истинно, если получившиеся подстроки идентичны, сравнение проводиться без учёта регистра букв.

• exists {<file name>}

Подстрока раскрывается, затем интерпретируется как абсолютный путь. Условие истинно, если существует указанный файл, или директория. Проверка существования осуществляется вызовом функции “stat()”. Использование проверки “exists” в пользовательских фильтрах может быть отключено системным администратором.

• first_delivery

Это условие, не имеющее никаких данных, является истинным в течение первой попытки доставки сообщения. Во время любых последующих попыток доставки оно будет ложным.

• ge {<string1>}{<string2>}

Смотрите “gei”.

• gei {<string1>}{<string2>}

Вначале раскрываются обе подстроки. Условие истинно, если первая строка лексически больше второй, или равна ей. Для “ge” сравнение производиться с учётом регистра, а для “gei” сравнение не зависит от регистра букв.

• gt {<string1>}{<string2>}

Смотрите “gti”.

• gti {<string1>}{<string2>}

Вначале раскрываются обе подстроки. Условие истинно, если первая строка лексически больше второй. Для “gt” сравнение производиться с учётом регистра, а для “gti” сравнение не зависит от регистра букв.

• isip {<string>}

Смотрите “isip6”.

• isip4 {<string>}

Смотрите “isip6”.

• isip6 {<string>}

Вначале подстрока раскрывается, затем проверяется, имеет ли она форму адреса IP. Оба адреса, IPv4 и IPv6 действительны для “isip”, тогда как “isip4” и “isip6” проверяют лишь адреса IPv4 и IPv6 соответственно. Например, можно использовать:

${if isip4{$sender_host_address}...

для проверки версии протокола IP хоста, с которого осуществляется входящее SMTP подключение.

• ldapauth {<ldap query>}

Это условие поддерживает пользовательскую аутентификацию, с использованием LDAP. Смотрите секцию 9.13 для получения дополнительных деталей как использовать LDAP в поисках, и каков синтаксис запросов. Для этого использования, запрос должен содержать имя пользователя и пароль. Сам запрос не используется, он может быть пустым. Условие истинно, если пароль не пуст, и имя пользователя и пароль приняты сервером LDAP. Пустой пароль отбрасывается, без вызова LDAP, поскольку LDAP считает соединения с пустым паролем анонимными, вне зависимости от имени пользователя, согласно настройкам в большинстве конфигураций. Смотрите главу 33 для получения дополнительных деталей о SMTP аутентификации, и главу 34 для примеров использования.

• le {<string1>}{<string2>}

Смотрите “lei”.

• lei {<string1>}{<string2>}

Вначале раскрываются обе подстроки. Условие истинно, если первая строка лексически меньше или равна второй. Для “le” сравнение производиться с учётом регистра, а для “lei” сравнение не зависит от регистра букв.

• lt {<string1>}{<string2>}

Смотрите “lti”.

• lti {<string1>}{<string2>}

Вначале раскрываются обе подстроки. Условие истинно, если первая строка лексически меньше второй. Для “lt” сравнение производиться с учётом регистра, а для “lti” сравнение не зависит от регистра букв.

• match {<string1>}{<string2>}

Вначале раскрываются обе подстроки. Вначале, вторая обрабатывается как регулярное выражение. Из-за предварительного раскрытия, если регулярное выражение содержит символ “$”, или символы начинающиеся с обратного слэша, они должны быть экранированы. Также следует проявить внимание, если регулярное выражение содержит фигурные скобки. Закрывающая скобка должна стоять так, чтобы не вызывать преждевременного завершения “<string2>”. Самый лёгкий подход заключается в использовании “\N”, для отключения раскрытия регулярного выражения. Например:

${if match {$local_part}{\N^\d{3}\N} ...

Если вся раскрываемая строка находиться в двойных кавычках, то требуется дальнейшее экранирование обратных слэшей.

Условие истинно, если регулярное выражение срабатывает. Регулярное выражение не обязано начинаться с метасимвола крышки (“^”), но если его нет, то выражение не поставлено на якорь и может соответствовать не только вначале строки, но и где-то в другом месте. Если вы хотите добиться соответствия паттерна в конце объекта, то необходимо включить метасимвол “$” в соответствующем месте.

Вначале раскрытия “if” запоминаются значения числовых переменных (“$1”). Удовлетворение условия “match” сбрасывает их к подстрокам этого условия, и они будут иметь эти значения в процессе раскрытия успешной подстроки. В конце “if” предыдущие значения будут восстановлены. После проверки комбинации использования условий “or”, последующие значения числовых переменных - таковые из условия, которое было успешным.

• match_address {<string1>}{<string2>}

Смотрите “match_local_part”.

• match_domain {<string1>}{<string2>}

Смотрите “match_local_part”.

• match_ip {<string1>}{<string2>}

Это условие проверяет IP-адрес на соответствие списку шаблонов IP-адресов. Оно должно содержать два параметра. Первый параметр, после раскрытия, должен быть IP-адресом или пустой строкой. Второй (после раскрытия) ограниченным списком хостов, который может соответствовать только IP-АДРЕСУ, но не имени хоста. Например:

${if match_ip{$sender_host_address}{1.2.3.4:5.6.7.8}{...}{...}}

В списке разрешаются определённые типы элементов, согласно списку:

• Адрес IP, опционально с маской CIDR.
• Отдельная звёздочка, соответствующая любому IP-адресу.
• Пустой пункт, который совпадает с только в случае если IP-адрес пуст. Это может быть полезным, для проверки локально отправленных сообщений, или одного из специфических хостов, в одной проверке, типа:

${if match_ip{$sender_host_address}{:4.3.2.1:...}{...}{...}}

где первый элемент в списке - пустая строка.

• Элемент “@[]” совпадает с любым из адресов, на интерфейсах локальной машины.
• Поиск предполагает стиль поиска “net-”, даже если “net-” не задан. Таким образом, следующие два примера эквивалентны:

${if match_ip{$sender_host_address}{lsearch;/some/file}...
${if match_ip{$sender_host_address}{net-lsearch;/some/file}...

Вам нужно использовать приставку “net-” в случае если нужно задать определённую маску, например, при использовании “net24-”

Просмотрите раздел 10.11 для получения дополнительных деталей по этим паттернам.

• match_local_part {<string1>}{<string2>}

Это условие, вместе с “match_address” и “match_domain”, позволяет проверить домен, адрес, и локальную часть. Каждое условие требует двух аргументов: элемент и список соответствия. Тривиальный пример:

${if match_domain{a.b.c}{x.y.z:a.b.c:p.q.r}{yes}{no}}

В каждом случае, второй аргумент может содержать любой из допустимых пунктов для списка соответсвующего типа. Кроме того, поскольку второй параметр (после раскрытия) представляет собой список стандартной формы, то можно обратиться к именованному списку. Таким образом, можно использовать такие условия:

${if match_domain{$domain}{+local_domains}{...

Для списка адресов, совпадения не зависят от регистра, но может использоваться элемент “+caseful” как во всех списках, если захотите чтобы локальная часть совпадала регистрозависимо. Имя домена всегда сравнивается регистронезависмо.

Отметьте: Списки хостов (видимо, имеется ввиду - IP-адресов хостов) тут не поддерживаются. Причина в том, что хост имеет два идентификатора: имя и IP-адрес, и не ясно какой из них бы тут использовался для проверки. Тем не менее, проверку IP-адресов

• pam {<string1>:<string2>:...}

Подключаемые Модули Аутентификации (Pluggable Authentication Modules - http://www.kernel.org/pub/linux/libs/pam/) - это средство, которое стало доступно в последних выпусках Solaris, и в некоторых реализациях GNU/Linux (почему-то неоправданно забыта FreeBSD. Непорядок - ибо во FreeBSD PAM также доступен). Exim поддерживает PAM, для использования с командой “SMTP AUTH”, только в случае, если он собран с

SUPPORT_PAM=yes

в “Local/Makefile”. Вероятно, будет необходимо добавить “-lpam” к “EXTRALIBS”, а в некоторых реализациях GNU/Linux, также будет необходим “-ldl”.

Вначале раскрываются аргументы строки, и результатом должен быть список, разделённый двоеточиями. Начальное и конечное пустое пространство игнорируется. Модуль PAM инициализируется с сервисным именем “exim” и именем пользователя взятым из первого элемента списка в строке разделённой двоеточиями (“<string1>”). Остающиеся в строке пункты передаются в ответ на запросы функции опознавания. В простом случае будет лишь один запрос, для пароля, и таким образом данные будут содержать лишь две строки.

Могут быть проблемы, если в любой из строк разрешено содержаться двоеточию. Обычно, они должны быть удвоены, чтобы избежать возможности быть разделителями. Если данные вставляются из переменной, может использоваться функция “sg”, для удвоения любых существующих двоеточий. Например, конфигурация аутентификатора “LOGIN” может содержать эти настройки:

server_condition = ${if pam{$1:${sg{$2}{:}{::}}}{yes}{no}}

Для “PLAIN”-аутентификатора можно использовать:

server_condition = ${if pam{$2:${sg{$3}{:}{::}}}{yes}{no}}

В некоторых операционных системах PAM-аутентификация может быть сделана только от процесса работающего от пользователя root. Так как exim выполняется от пользователя “exim”, при приёме сообщений, то это означает что PAM не может непосредственно использоваться в таких системах. Пропатченная версия модуля “pam_unix”, который идёт с пакетом Linux PAM, доступна на http://www.e-admin.de/pam_exim/. Пропатченный модуль разрешает одной специальной комбинации uid/gid, дополнительно root, аутентифицироваться. Если вы собираете пропатченный модуль для того, чтобы разрешить пользователя и группу exim, PAM сможет использоваться в аутентификаторе exim.

• pwcheck {<string1>:<string2>}

Этот кондишен поддерживает аутентификацию пользователей с использованием даемона аутентификации Cyrus pwcheck. Это один из способов проверить пароли процессу не запущенному от root. Заметьте: сейчас, использование pwcheck не рекомендуется. Его замена - saslauthd (смотрите ниже).

Поддержка “pwcheck” не включена в exim по-умолчанию. Вы должны задать местоположение сокета даемона “pwcheck” в “Local/Makefile” до сборки exim. Например:

CYRUS_PWCHECK_SOCKET=/var/pwcheck/pwcheck

Нет необходимости устанавливать всё программное обеспечение Cyrus для использования даемона “pwcheck”. Вы можете собрать и установить только даемона из библиотеки Cyrus SASL. Обеспечьте, чтобы пользователь exim`a был единственным пользователем, имеющим доступ к директории где лежит сокет даемона “pwcheck”.

У условия “pwcheck” один аргумент, которое является и именем пользователя, и паролем, разделёнными двоеточием. Например, для аутентификации типа “LOGIN”, можно сделать так:

server_condition = ${if pwcheck{$1:$2}{1}{0}}

• queue_running

Это условие не имеет данных, и является истинным в течение попыток доставки сообщения инициированными процессом доставки, и ложным в другие моменты.

• radius {<authentication string>}

Аутентификация Radius (RFC2865) поддерживается похожим на PAM способом. Вы должны определить опцию “RADIUS_CONFIG_FILE” в “Local/Makefile” для задания местоположения конфигурационного файла Radius, при сборке exim.

При установке только этой опции, exim ожидает что будет слинкован с библиотекой “radiusclient”, с использованием оригинального API. Если же используется релиз этой библиотеки 0.4.0 или более поздний, то нужно установить опцию:

RADIUS_LIB_TYPE=RADIUSCLIENTNEW

в “Local/Makefile” при сборке exim. Также можно слинковать exim с библиотекой “libradius”, идущей в составе FreeBSD. Для использования этого, установите:

RADIUS_LIB_TYPE=RADLIB

в “Local/Makefile”, в дополнение к установленной опции “RADIUS_CONFIG_FILE”. Также, вероятно, надо будет настроить “EXTRALIBS” чтобы библиотека Radius`a была найдена при линковке exim.

Строка, определённая в “RADIUS_CONFIG_FILE” раскрывается, и передаётся клиентской библиотеке Radius`a, которая связывается с сервером Radius. Условие истинно, если аутентификация успешна. Например:

server_condition = ${if radius{<arguments>}{yes}{no}}

• saslauthd {{<user>}{<password>}{<service>}{<realm>}}

Этот кондишен поддерживает аутентификацию пользователей с использованием даемона Cyrus saslauthd. Он заменяет даемона pwcheck, который больше не поддерживается. Использование этого даемона - один из способов проверки паролей процессом работающим не от рута.

Поддержка “saslauthd” не включена в exim по-умолчанию. Вы должны указать местоположение сокета даемона “saslauthd” в “Local/Makefile”, до сборки exim`a. Например:

CYRUS_SASLAUTHD_SOCKET=/var/state/saslauthd/mux

Нет необходимости устанавливать всё программное обеспечение Cyrus для использования даемона “saslauthd”. Вы можете собрать и установить только даемона из библиотеки Cyrus SASL.

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

server_condition = ${if saslauthd{{$1}{$2}}{1}{0}}

Сервис и окружение(?) являются опциональными параметрами (поэтому их параметры находятся в собственной паре фигурных скобок). Для деталей по этой службе, и как запустить даемона, обратитесь к документации по Cyrus.

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

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

• or {{<cond1>}{<cond2>}...}

Подусловия оцениваются слева направо. Условие истинно, если одно из подусловий истинно. Например:

${if or {{eq{$local_part}{spqr}}{eq{$domain}{testing.com}}}...

Когда находиться истинное подусловие, то остальные парсятся, но не оцениваются. Если тут несколько подусловий “match”, то значения числовых переменных берутся от того, которое первым будет успешно.

• and {{<cond1>}{<cond2>}...}

Подусловия оцениваются слева направо. Условие истинно, если все подусловия верны. Если тут несколько подусловий “match”, то значения числовых переменных берутся от последнего. Если найдено ложное подусловие, то остальные парсятся, но не оцениваются.

Переменные раскрытия

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

• $0, $1, и т.д.

Когда успешно условие “match”, эти переменные содержат фиксированные подстроки идентифицированные по регулярному выражению в течение последующего процесса успешной строки содержащей элемент “if”. Также, они могут быть установлены внешне, некоторыми другими процессами, предшествующими раскрытию строки. Например, команды доступные в файлах фильтрa exim`a включают команду “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,35,36,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”, включая (к примеру) попытку использовать неизвестный/неопределённый аутентификационный механизм.

• $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 собран с поддержкой content-scanning и вышедшим из употребления условием “demime”. Детали смотрите в секции 40.6.

• $demime_reason

Эта переменная доступна когда exim собран с поддержкой content-scanning и вышедшим из употребления условием “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” также используется при некоторых других обстоятельствах:

• Когда выполняется ACL для команды RCPT, переменная “$domain” содержит домен адреса получателя. Домен адреса отправителя находиться в “$sender_address_domain” во время команд MAIL и RCPT. Переменная “$domain”, обычно не устанавливается во время работы MAIL ACL. Однако, если адрес отправителя проверен при помощи callout в процессе MAIL ACL, домен отправителя помещается в “$domain” в процессе раскрытия “hosts”, “interface”, and “port” и в “smtp” транспорте.
• Во время обработки перезаписи (смотрите раздел 31), переменная “$domain” содержит доменную часть адреса, который перезаписывается. Это может быть использовано в в раскрытии адреса замены, например, для замены домена поиском по файлу.
• Каждый раз когда просматривается список доменов, за одним исключением, “$domain” содержит обрабатываемый домен. Исключение: Когда список доменов в условии “sender_domains” обрабатывается в ACL, обрабатываемый домен содержится в “$sender_address_domain”, а не в “$domain”. Так сделано для того, чтобы в RCPT ACL список доменов отправителя мог зависеть от домена получателя (который в это время содержится в “$domain”).
• Когда раскрывается опция “smtp_etrn_command”, переменная “$domain” содержит полный параметр команды ERTN (смотрите раздел 44.8)

• $domain_data

Когда опция “domains” на маршрутизаторе совпадает с доменом найденным поиском, данные прочитанные поиском, доступны в течение работы роутера как “$domain_data”. Кроме того, если драйвер направляет адрес в транспорт, то значение доступно и в транспорте. Если транспорт обрабатывает много адресов, используется значение из первого адреса.

Переменная “$domain_data” также устанавливается когда кондишен “domains”в ACL совпадает с доменом найденным поиском. Данные прочитанные поиском доступны в течение остальной части условия ACL. Во всех других случаях, эта переменная ничего не содержит.

• $exim_gid

Эта переменная содержит числовое значение gid группы от которой работает exim.

• $exim_path

Эта переменная содержит путь к бинарному файлу exim.

• $exim_uid

Эта переменная содержит числовое значение uid пользователя от которого работает exim.

• $found_extension

Эта переменная доступна, когда exim собран с поддержкой content-scanning (сканирования содержимого, на вирусы, например), и устаревшим условием - “demime”. За дополнительными деталями, обратитесь к разделу 40.6.

• $header_<name>

Это не строгая переменная раскрытия. Это - синтаксис раскрытия для вставки строки заголовка сообщения с указанным именем. Заметьте, что имя может оканчиваться двоеточием или пробелом, поскольку оно может содержать разнообразные символы. Также заметьте, что фигурные скобки не должны использоваться.

• $home

Когда в роутере установлена опция “check_local_user”, в случае успешной проверки, домашняя директория пользователя помещается в переменную “$home”. В частности, это означает, что она установлена в процессе выполнения фалов фильтров пользователей. Роутер, также может явно установить основную домашнюю директорию для использования транспортом. Это может быть отменено непосредственной установкой транспорта.

Когда работает тест фильтра, через опцию “-bf”, в “$home” устанавливается значение переменной окружения 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_deferred” устанавливается в “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

Как только сервер начинает обрабатывать TCP/IP соединение, эта переменная принимает значение IP-адреса локального интерфейса, а в переменную “$interface_port” устанавливается номер порта. Поэтому эти значения доступны для использования в “connect” ACL. Также смотрите опцию командной строки “-oMi”. Как присутствующая в ACL, эта переменная может использоваться, например, для создания имени файла, для сертификата TLS, зависящего от того какой порт/интерфейс используется.

• $interface_port

Смотрите “$interface_address”.

• $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`a. Это значение пересчитывается каждый раз, когда ссылаются на эту переменную. Если файловая система не знает, что такое inode, то значение переменной равно “-1”. Также смотрите опцию “check_log_inodes”.

• $log_space

Размер свободного места (в килобайтах) на дисковом разделе, в который пишутся логи exim`a. Это значение пересчитывается каждый раз, когда ссылаются на эту переменную. Если операционная система не способна вычислять размер свободного пространства (истинно только для экспериментальных систем), то значение переменной равно “-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).

• $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_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_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, когда проверка получателя неудачна, эта переменная содержит информацию о ошибке. Это может быть одно из следующих слов:

• “qualify”: Адрес был неполный (нет домена), и сообщение не являлось ни локальным, ни прибывшим от неучтённого хоста.
• “route”: Неудачная маршрутизация.
• “mail”: Маршрутизация была удачной, и был предпринят обратный вызов; отклонение произошло до команды MAIL (n/t при начальном подключении, HELO, или MAIL)
• “recipient”: Команда RCPT в обратном вызове была отклонена.
• “postmaster”: Была отклонена проверка postmaster`а в обратном вызове.

Ожидаемое главное использование этой переменной, для различения реджектов MAIL и реджектов RCPT.

• $recipients

Эта переменная содержит список получателей сообщения. Адреса разделяются запятыми и пробелами в тексте замены. Однако, переменная не является общедоступной, для предотвращения просмотра “Bcc” получателей в непривилегированных пользовательских фильтрах. Вы можете использовать “$recipients” только в этих двух случаях:
1. В файле системного фильтра.
2. В ACL ассоциированных с командой DATA, т.е. ACL определённые как “acl_smtp_predata” и “acl_smtp_data”.

• $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`a, но он пробует ещё раз, если “$host_lookup_deferred” установлена в “1”.

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

• Строка содержащая “$sender_host_name” раскрыта.
• Хост с которого идёт запрос, совпадает со списком “host_lookup”. В дефолтовой конфигурации, эта опция установлена в *, для устранения поиска надо этот пункт изменить (закомментить - в самом коде эта опция по дефолту не включена).
• Экзим нуждается в имени хоста, для проверки элемента в списке хостов. Пункты, которые требуют этого, описаны в разделе 10.13 and 10.15.
• Хост запроса соответствует “helo_try_verify_hosts” или “helo_verify_hosts”. В этом случае, имя хоста требует сравнения с именем, указанным в командах EHLO или HELO, отданных клиентом.
• Удалённый хост даёт команду EHLO или HELO, которая содержит один из доменов в “helo_lookup_domains”. Значение по-умолчанию этой опции:

helo_lookup_domains = @ : @[]

и она вызывает поиск лишь в случае, если удалённый хост некорректно отдал имя сервера или IP-адрес в команде EHLO или HELO.

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

• $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-перезаписи.

• $sn0 - $sn9

Эти переменные - копии значений “$n0”-“$n9”, сумматоры бывшие в конце файла системного фильтра. Это позволяет системному фильтру устанавливать значения, которые могут быть проверены в файлах фильтров пользователей. Например, системный фильтр мог установить значение, указывающее, что это сообщение, вероятно, является спамом.

• $spam_xxx

Множество переменных с именами начинающимися с “$spam” доступны, если exim скомпилен с расширением контентного сканирования. Для дополнительных деталей, смотрите секцию 40.2.

• $spool_directory

Имя директории спула для exim`a.

• $spool_inodes

Число свободных inоde в дисковом разделе, где exim держит свои spool-файлы. Значение пересчитывается каждый раз, когда к нему обращаются. Если файловая система не имеет понятия inode, то значение будет -1. Также смотрите опцию “check_spool_inodes”.

• $spool_space

Количество свободного места (как число килобайт) в дисковом разделе, где пишутся spool-файлы exim`a. Значение пересчитывается каждый раз, когда на переменную ссылаются. Если операционная система не может подсчитать количество свободного места (истинно для экспериментальных систем), то значение будет -1. Например, чтобы проверит в ACL, что есть хотябы 50 мегабайт свободного места в спуле, можно написать:

condition = ${if > {$spool_space}{50000}}

Также смотрите опцию “check_spool_space”.

• $thisaddress

Эта переменная установлена только в процессе обработки команды “foranyaddress” в файле фильтра. Её использование объясняется в описании той команды, которая может быть найдена в документации на интерфейс фильтрации почты exim`a.

• $tls_certificate_verified

Эта переменная установлена в “1”, если при приёме сообщения сертификат TLS проверен, и “0” в обратном случае.

• $tls_cipher

Когда сообщение получено с удалённого хоста по шифрованному SMTP-подключению, эта переменная содержит использовавшийся тип шифрования, например DES-CBC3-SHA. При других обстоятельствах, в частности, для сообщения полученного по незашифрованным подключениям, переменная пуста. Смотрите главу 38 для подробностей о поддержке TLS.

• $tls_peerdn

Когда сообщение получено с удалённого хоста по шифрованному SMTP-подключению, и exim сконфигурирован для запроса сертификата с клиента, значение переменной - имя сертификата, доступное в ней в процессе последующей обработки.

• $tod_bsdinbox

Время и дата в формате BSD-майлбокса, например: Thu Oct 17 17:14:09 1995.

• $tod_epoch

Время и дата в виде числа секунд с начала эпохи 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”, как задано в ISO8601, например: 20030221154023Z.

• $value

Эта переменная содержит результат раскрытия поиска, операции извлечения, или внешней команды, как описано выше.

• $version_number

Номер версии exim.

• $warn_message_delay

Эта переменная установлена только в течение создания предупредительного сообщения о задержке доставки. Детали по её использованию раскрыты в разделе 45.2.

• $warn_message_recipients

Эта переменная установлена только в течение создания предупредительного сообщения о задержке доставки. Детали по её использованию раскрыты в разделе 45.2.

translated by lissyara