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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

$local_part
${domain}

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

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

  ${lc:$local_part}

  Строка начинается с первого символа после двоеточия, которое может предваряться пустым пространством. Список операторов приведен в секции 11.6. Нотация оператора использует простое раскрытие элементов, которые могут иметь один аргумент, поскольку это уменьшает число фигурных скобок и позволяет легче понимать итоговую строку.
• ${dlfunc{<file>}{<function>}{<arg>}{<arg>}...}
  Это раскрытие динамически загружается, а затем вызывает локальную функцию, написанную на C. Такая функциональность доступна лишь в случае, если exim собран со следующим аргументом:

  EXPAND_DLFUNC=yes

  заданным в Local/Makefile. Однажды загруженный exim запоминает динамически загруженный объект, так что не требуется перезагружать файлы объектов при работе того же процесса exim (но сам exim часто запускает свои новые копии при работе). У функции может быть от нуля до восьми аргументов. Собирая локальную функцию, вызываемую таким образом, необходимо включить local_scan.h. Переменные и функции exim, определённые в 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 необходимо добавить -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>" больше или равно длинне строки, раскрытие строки вернёт саму строку. Иначе, будет вычислена новая строка с длинной "< code><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 или SHA-1. Имя хэша в настоящее время должно быть либо MD5, либо SHA-1. Например:

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

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

  dd97e3ba5d1a61b5006108f8c8252953

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

  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 в обычном файле алиасов:

  ${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". Если во второй строке символов есть повторения, используется последний из символов. Если третья строка короче, чем вторая, последний символ копируется. Однако, если она пуста, замена не производиться.

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

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

• ${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>}
  Этот оператор шифрует текст согласно RFC 2047. Это кодирование используется в строках заголовков для кодирования символов не-ASCII. Предполагается, что входная строка находиться в кодировке, определённой опцией headers_charset с умолчанием ISO-8859-1. Строки, содержащие символы только в диапазоне 33-126 и не содержащие символов типа:

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

  не модифицирутся. В противном случае разультат строка, закодированная в соответствии с RFC 2047, содержащая так много закодированных букв, как нужно для кодирования строки.
• ${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-х разрядных система, для файлов больше 2 Gb размером.
• ${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>}
  Преобразует буквы в верхний регистр.

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

Следующие условия доступны для проверки конструкции "${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-адресов можно провести, используя match_ip.
• pam {<string1>:<string2>:...}
  Подключаемые Модули Аутентификации (Pluggable Authentication Modules http://www.kernel.org/pub/linux/libs/pam/) представляют собой средство, которое стало доступно в последних выпусках Solaris, некоторых реализациях GNU/Linux и во FreeBSD. 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 был единственным пользователем, имеющим доступ к каталогу, где лежит сокет демона pwcheck. У условия pwcheck один аргумент, который является именем пользователя и паролем, разделёнными двоеточием. Например, для аутентификации типа LOGIN можно сделать так:

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

• queue_running
  Это условие не имеет данных и является истинным в течение попыток доставки сообщения, инициированными процессом доставки, и ложным в другие моменты.
• radius {<authentication string>}
  Аутентификация Radius (RFC 2865) поддерживается похожим на 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 была найдена при компоновке exim. Строка, определённая в RADIUS_CONFIG_FILE, раскрывается и передаётся клиентской библиотеке Radius, которая связывается с сервером Radius. Условие истинно, если аутентификация успешна. Например:

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

• saslauthd {{<user>}{<password>} {<service>}{<realm>}}
  Это выражение поддерживает аутентификацию пользователей с использованием демона Cyrus saslauthd. Он заменяет демон pwcheck, который больше не поддерживается. Использование этого демона один из способов проверки паролей процессом работающим не от root. Поддержка saslauthd не включена в exim по умолчанию. Вы должны указать местоположение сокета демона saslauthd в Local/Makefile до сборки exim. Например:

  CYRUS_SASLAUTHD_SOCKET=/var/state/saslauthd/mux

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

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

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

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

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

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

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

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

warn !verify = sender
     set acl_m0 = $acl_verify_message

/home/r2d2/savemail

deny  hosts = net-lsearch;/some/file
message = $host_data

"abc:xyz"@test.example
abc\:xyz@test.example

abc:xyz

data = ${quote_local_part:$local_part}@new.domain.example

deny message   = Too many lines in message header
condition = ${if <{250} \
{${eval:$message_linecount - $body_linecount}}}

require recipients  = cdb*@;/some/file
deny    some further test involving $recipient_data

require senders      = cdb*@;/some/file
deny    some further test involving $sender_data

MAIL FROM:<>
MAIL FROM: <>

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