save folder23

или команды фильтра Sieve в форме:


require "fileinto"; fileinto "folder23";

   В этой ситуации, раскрытие “file” или “directory” в транспорте должно преобразовать относительный путь в соответствующее абсолютное имя файла. В случае фильтров Sieve, должно быть обработано имя “inbox”. Это имя, используемое в качестве результата действия “keep” (“сохранить”), в фильтре. Этот пример показывает один способ обработать это требование:


file = ${if eq{$address_file}{inbox} \ {/var/mail/$local_part} \ {${if eq{${substr_0_1:$address_file}}{/} \ {$address_file} \ {$home/mail/$address_file} \ }} \ }

   С этой установкой опции “file”, “inbox” ссылается на стандартное расположение почтового ящика, абсолютные пути используются без изменения, и другие папки находятся в директории “mail”, внутри домашней директории.
   Замечание 1: При обработке в фильтре exim`a, относительный путь, типа “folder23” превращается в абсолютный, если роутеру известна домашняя директория. В частности, так обстоят дела, если установлена опция “check_local_user”. Если вы хотите предотвратить это во время маршрутизации, вы должны установить “router_home_directory” в пустое значение. Это вынуждает маршрутизатор передавать транспорту относительный путь.
   Замечание 2: Абсолютный путь в “$address_file” не обрабатывается как-то особенно; продолжает использоваться опция “file” или “directory”, если она установлена.



26.2 Частные опции для “appendfile”

Имя Использование Тип Дефолтовое значение allow_fifo appendfile boolean ложь

   Установка этой опции позволяет доставлять в именованные каналы (трубы, или FIFO) точно также как и в обычные файлы. Если, во время доставки, отстутсвует процесс читающий трубу, доставка задерживается.



Имя Использование Тип Дефолтовое значение allow_symlink appendfile boolean ложь

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



Имя Использование Тип Дефолтовое значение batch_id appendfile string† незадана

   Смотрите описание пакетной локальной доставки в разделе 25. Однако, пакетная доставка автоматически отключается для доставок “appendfile”, происходящих как результат форвардинга, альясинга, или других переназначений прямо в файл.



Имя Использование Тип Дефолтовое значение batch_max appendfile integer 1

   Смотрите описание пакетной локальной доставки в разделе 25.



Имя Использование Тип Дефолтовое значение check_group appendfile boolean ложь

   Когда эта опция установлена, проверяется группа владельца файла, заданного опцией “file”, для удостверения, что это та же самая группа, под которой выполняется процесс доставки. Дефолтовая настройка - ложна, поскольку дефолтовый режим - 0600, что означает, что группа не имеет значения.



Имя Использование Тип Дефолтовое значение check_owner appendfile boolean истина

   Когда эта опция установлена, проверяется владелец файла, заданного опцией “file”, для удостверения, что он тот же самый, под которым выполняется процесс доставки.



Имя Использование Тип Дефолтовое значение check_string appendfile string смотрите ниже

   Поскольку “appendfile” записывает сообщение, начало каждой строки проверяется на совпадение с “check_string”, и если оно происходит, совпавшие начальные символы заменяются на содержимое “escape_string”. Значение “check_string” - литеральная строка, а не регулярное выражение, и регистр содержащихся букв имеет значение.
   Если установлена “use_bsmtp”, значение “check_string” и “escape_string” принудительно устанавливаются в “.” и “..”, соответственно, и любые конфигурационные настройки игнорируются. Иначе, - у них значения по умолчанию “From ” и “>From ” когда задана опция “file”, и незаданы, когда установлена любая из опций “directory”, “maildir” или “mailstore”.
   Дефолтовые настройки, наряду с “message_prefix” и “message_suffix”, являются подходящими для традиционных “BSD”-майлбоксов, где строка, начинающаяся с “From ” индицирует начало нового сообщения. Все четыре опции нуждаются в изменении, если используется иной формат. Например, для доставки в почтовые ящики в формате MMDF:


check_string = "\1\1\1\1\n" escape_string = "\1\1\1\1 \n" message_prefix = "\1\1\1\1\n" message_suffix = "\1\1\1\1\n"

Имя Использование Тип Дефолтовое значение create_directory appendfile boolean истина

   Когда эта опция истинна, exim пытается создать любые недостающие вышестоящие директории, для файла в который собирается производить запись. Режим созданного каталога, задаётся опцией “directory_mode”.
   Владелец группы созданной директории сильно зависит от используемой операционной системы (и, возможно, файловой системы). Например, в Solaris, если родительский каталог имеет установленный бит “setgid”, его группа передаётся дочернему каталогу; если нет, используется текущая установленная группа. Однако, в FreeBSD, всегда используется родительская группа.



Имя Использование Тип Дефолтовое значение create_file appendfile string anywhere

   Эта опция ограничивает местоположение файлов и директорий создаваемых этим транспортом. Это применяется к файлам, заданным опцией “file”, и директориям, заданным опцией “directory”. В случае доставки maildir, это применяется к директориям верхнего уровня, а не к нижележащим директориям maildir.
   Опция должна быть установлена в одно из слов “anywhere”, “inhome”, или “belowhome”. Во втором и третьем случае, для транспорта должна быть установлена домашняя директория. Эта опция бесполезна, когда задаётся явное имя файла для обычной доставки в почтовые ящики. Она предназначена для случая, когда имя файла генерится из пользовательских файлов “.forward”. Обычно, они обрабатываются транспортом “appendfile”, вызыванным “address_file”. Также, смотрите опцию “file_must_exist”.



Имя Использование Тип Дефолтовое значение directory appendfile string† незадана

   Эта опция взаимоисключающая с опцией “file”, но одна из опций “file” или “directory” должжна быть задана, исключая случай доставки как результата перенаправления (смотрите раздел 26.1).
   Когда задана опция “directory”, строка раскрывается, и сообщение доставляется в новый файл или файлы, или в подкаталог данного каталога, вместо добавления к единственному файлу почтового ящика. Поддерживается несколько различных форматов (смотрите “maildir_format” и “mailstore_format”), и смотрите раздел 26.4, для дальнейших деталей о этой форме доставки.



Имя Использование Тип Дефолтовое значение directory_file appendfile string† q${base62:$tod_epoch}-$inode

   Когда установлена опция “directory”, но не установлены ни “maildir_format” ни “mailstore_format”, “appendfile” доставляет каждое сообщение в файл, имя которого получается в результате раскрытия строки этой опции. Значение по умолчанию генерит уникальное имя из текущего времени, в форме base 62, и иноды файла. Переменная “$inode” доступна лишь при раскрытии этой опции.



Имя Использование Тип Дефолтовое значение directory_mode appendfile octal integer 0700

   Если “appendfile” создаёт какие-либо директории как результат опции “create_directory”, их режим задаётся этой опцией.



Имя Использование Тип Дефолтовое значение escape_string appendfile string смотрите описание

   Смотрите выше, опцию “check_string”.



Имя Использование Тип Дефолтовое значение file appendfile string† незадана

   Эта опция взаимоисключающая с опцией “directory”, но одна из опций “file” или “directory” должжна быть задана, исключая случай доставки как результата перенаправления (смотрите раздел 26.1). Опция “file” определяет единичный файл, к которому добавляется сообщение. Одна и более из опций “use_fcntl_lock”, “use_flock_lock” или “use_lockfile” должны быть заданы с опцией “file”.
   Если вы используете более одного хоста для достаки через NFS в одни и те же почтовые ящики, вы всегда должны файлы блокировки
   Значение строки раскрывается для каждой доставки, и должно привести к абсолютному пути. Самые общие установки этой опции - вариации одного из этих примеров:


file = /var/spool/mail/$local_part file = /home/$local_part/inbox file = $home/inbox

   В первом примере, все доставки осуществляются в один и тот же каталог. Если exim сконфигурирован использовать файлы блокировки (смотрите ниже, опцию “use_lockfile”), он должен быть в состояниии создать файл в директории, таким образом, “липкий” (“sticky”) бит должен быть включен для возможности доставки, или, альтернативно, может использоваться опция “group” для выполнения доставки под групповым идентификатором, имеющим доступ к директории.



Имя Использование Тип Дефолтовое значение file_format appendfile string незадана

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


file_format = "From : local_delivery :\ \1\1\1\1\n : local_mmdf_delivery"

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



Имя Использование Тип Дефолтовое значение file_must_exist appendfile boolean ложь

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



Имя Использование Тип Дефолтовое значение lock_fcntl_timeout appendfile time 0s

   По умолчанию, транспорт “appendfile” использует неблокирующие вызовы “fcntl()”, при блокировке открытого файла почтового ящика. Если вызов неудачен, процесс доставки засыпает на “lock_interval”, и пробует снова, до времени “lock_retries”. Неблокирующие вызовы используются так, чтобы файл не оставлялся открытым в ожидании блокировки; причина этого заключается в желании сделать это безопасным насколько возможно, для доставок через NFS, в случае, когда процессы могли бы обращаться к почтовому ящику NFS без использования файла блокировки. Этого не должно быть, но недоразумения, и, следовательно, просчёты конфигурации неизвестны.
   На загруженных системах, однако, производительность неблокирующей блокировки не столь хороша, как использование блокирующей блокировки с таймаутом. В этом случае, ожидание делается в системном вызове, и процесс доставки exim`a овладевает блокировкой и может обработать, как только предыдущий держатель блокировки снимет её.
   Если “lock_fcntl_timeout” установлена в ненулевое время, блокирование болкируется, с использованием этого таймаута. Всё ещё может быть некоторое повторение: максимальное число повторений


(lock_retries * lock_interval) / lock_fcntl_timeout

округляется к следующему целому числу. Другими словами, полное время в течение которого “appendfile” пробует получить блокировку - примерно тоже самое, если “lock_fcntl_timeout” не установлена слишком большой.
   Вы должны рассмотреть установку этой опции, если вы получаете много отсроченных локальных доставок из-за ошибок вида


failed to lock mailbox /some/file (fcntl)

Имя Использование Тип Дефолтовое значение lock_flock_timeout appendfile time 0s

   Этот таймаут применяется к блокировке файла, когда используется “flock()” (смотрите “use_flock”); таймаут работает в манере, похожей на “lock_fcntl_timeout”.



Имя Использование Тип Дефолтовое значение lock_interval appendfile time 3s

   Эта опция определяет время ожидания между попытками блокировки файла. Смотрите ниже, для дополнительных деталей о блокировке.



Имя Использование Тип Дефолтовое значение lock_retries appendfile integer 10

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



Имя Использование Тип Дефолтовое значение lockfile_mode appendfile octal integer 0600

   Эта опция определяет режим создаваемого файла блокировки, когда используется файл блокировки (смотрите опции “use_lockfile” и “use_mbx_lock”)



Имя Использование Тип Дефолтовое значение lockfile_timeout appendfile time 30m

   Когда используется файл блокировки (смотрите опцию “use_lockfile”), если файл блокировки уже существует, и он старше этого значения, предполагается, что он был случайно оставлен, и exim пытается его удалить.



Имя Использование Тип Дефолтовое значение mailbox_filecount appendfile string† незадана

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



Имя Использование Тип Дефолтовое значение mailbox_size appendfile string† незадана

   Если эта опция задана, она раскрывается, и результат берётся как текущий размер почтового ящика. то должно быть десятичное число, опционально сопровождаемое K или M. Этим предоставлятся способ получить информацию из внешнего источника, обслуживающего данные. Это, вероятно, будет полезным для доставок “maildir”, где, в вычислительном отношении, дорого вычислить размер почтового ящика.



Имя Использование Тип Дефолтовое значение maildir_format appendfile boolean ложь

   Если эта опция задана с опцией “directory”, доставка в новый файл, в формате “maildir” используемом другими почтовыми программами. Когда транспорт активизирован непосредственно от роутера “redirect” (например, транспорт “address_file” в дефолтовой конфигурации), установка “maildir_format” вызывает обработку пути переданного из роутера как каталога, вне зависмости, завершается, или нет, он на “/”. Эта опция доступна лишь если в “Local/Makefile” присутствует SUPPORT_MAILDIR. Для получения дополнительных деталей, смотрите раздел 26.5.



Имя Использование Тип Дефолтовое значение maildir_quota_directory_regex appendfile string смотрите ниже

   Эта опция уместна лишь если установлена “maildir_use_size_file”. Она определяет регулярное выражение, для определения директорий, относительно директории квоты (смотрите “quota_directory”), которая должна быть включена в подсчёт квоты. Значение по умолчанию:


maildir_quota_directory_regex = ^(?:cur|new|\..*)$

   Этим включаются директории “cur” и “new”, и любые директории “maildir++” (директории, чьи имена начинаются с точки). Если вы хотите исключить из подсчёта директорию “Trash” (как делают некоторые сайты), вы должны изменить эту установку на


maildir_quota_directory_regex = ^(?:cur|new|\.(?!Trash).*)$

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



Имя Использование Тип Дефолтовое значение maildir_retries appendfile integer 10

   Эта опция определяет число повторов при записи файла в формате “maildir”. Смотрите ниже, раздел 26.5.



Имя Использование Тип Дефолтовое значение maildir_tag appendfile string† незадана

   Эта опция применяется лишь к доставкам в формате “maildir”, и она описана ниже, в разделе 26.5.



Имя Использование Тип Дефолтовое значение maildir_use_size_file appendfile boolean ложь

   Установка этой опции в истину включает поддержку файлов “maildirsize”. Exim создаёт файлы “maildirsize” в “maildir”, если они не существуют, беря квоту из опции “quota” транспорта. Если квота не задана - значение равно нулю. Смотрите “maildir_quota_directory_regex”, выше и раздел 26.5 для получения дополнительных деталей.



Имя Использование Тип Дефолтовое значение maildirfolder_create_regex appendfile string незадана

   Значение этой опции - регулярное выражение. Если оно не задано, опция не имеет никакого эффекта. Иначе, до доставки “maildir”, выражение сравнивается с именем директрии “maildir”, т.е. директории содержащей субдиректории “new” и “tmp”, которые будут использоваться для доставки. Если есть соответствие, exim проверяет существование файла с именем “maildirfolder” в директории, и создаёт его, если он не существует. Для получения дополнительных деталей, смотрите раздел 26.5.



Имя Использование Тип Дефолтовое значение mailstore_format appendfile boolean ложь

    Если эта опция установлена вместе с опцией “directory”, доставка осуществляется в два новых файла, в формате “mailstore”. Эта опция доступна лишь в случае, если при сборке exim`a в “Local/Makefile” была опция SUPPORT_MAILSTORE. Для получения дополнительных деталей, смотрите раздел 26.4.



Имя Использование Тип Дефолтовое значение mailstore_prefix appendfile string† незадана

    Эта опция применяется только к доставкам в формате “mailstore”, и она описана ниже, в разделе 26.4.



Имя Использование Тип Дефолтовое значение mailstore_suffix appendfile string† незадана

    Эта опция применяется только к доставкам в формате “mailstore”, и она описана ниже, в разделе 26.4.



Имя Использование Тип Дефолтовое значение mbx_format appendfile boolean ложь

   Эта опция доступна лишь в случае, если при сборке exim`a в “Local/Makefile” была опция SUPPORT_MBX. Если опция “mbx_format” установлена с опцией “file”, сообщение добавляется к почтовому ящику в формате MBX, вместо формата традиционного UNIX. Этот формат поддерживается Pine4, и связан с его POP3 и IMAP даемонами путём используемой всеми ими “c-client” библиотеки.
   Отметтьте: Опции “message_prefix” и “message_suffix” не меняются автоматически, при использовании “mbx_format”. Обычно, при использовании формата MBX, они должны устанавливаться пустыми? таким образом, эта опция почти всегда появляется в такой комбинации:


mbx_format = true message_prefix = message_suffix =

   Если в конфигурации не упомянута ни одна из опций блокировки, предполагается “use_mbx_lock”, и другие опции блокировки, по дефолту, ложны. С “mbx_format” возможно определить другие виды блокировок, но “use_fcntl_lock” и “use_mbx_lock” являются взаимоисключающими. Блокировка MBX взаимодействует с “c-client”, предоставляя общий (может быть - распределённый - прим. lissyara) доступ к почтовому ящику. Она не должна использоваться, если любая иная программа, не использующая эту форму блокировки, собирается обращаться к этому почтовому ящику, или если почтовый ящик находится на файловой системе смонтированной по NFS, поскольку она работает лишь когда к почтовому ящику обращаются с одного хоста.
   Если вы устанавливаете “use_fcntl_lock” с почтовыми ящиками в формате MBX, вы не можете использовать станадартную версию “c-client”, поскольку пока есть открытый ящик (это бывает при сессии Pine или IMAP), exim не в состоянии добавить к нему сообщение.



Имя Использование Тип Дефолтовое значение message_prefix appendfile string† смотрите ниже

   Строка заданная в этом пункте раскрывается и выводится в начале каждого сообщения. По умолчанию, она незадана, если не определена опция “file”, и не установлена “use_bsmtp”, когда она:


message_prefix = "From ${if def:return_path{$return_path}\ {MAILER-DAEMON}} $tod_bsdinbox\n"

Имя Использование Тип Дефолтовое значение message_suffix appendfile string† смотрите ниже

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


message_suffix =

Имя Использование Тип Дефолтовое значение mode appendfile octal integer 0600

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



Имя Использование Тип Дефолтовое значение mode_fail_narrower appendfile boolean истина

   Эта опция применяется в случае, когда существующий файл почтового ящика имеет более строгие ограничения чем заданные опцией “mode”. Если опция “mode_fail_narrower” истинна - доставка задерживается (“mailbox has the wrong mode”); иначе - exim продолжает попытки достаки, используя существующий режим файла.



Имя Использование Тип Дефолтовое значение notify_comsat appendfile boolean ложь

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



Имя Использование Тип Дефолтовое значение quota appendfile string† незадана

   Эта опция налагает ограничения на размер файла, к которому exim добавляет сообщение, или на полный размер используемый деревом директорий, когда установлена опция “directory”. В последнем случае, вычисление используемого места дорого стоит, поскольку должны быть индивидуально осмотрены и просуммированы все файлы в директории (и любых субдиректориях). (Смотрите “quota_size_regex” и “maildir_use_size_file” для способов избежать этого в окружении где пользователи не имеют shell-доступа к своим почтовым ящикам.)
   Нет блокировки от двух одновременных доставок в многофайловый почтовый ящик, и в этом случае возможно превышение квоты. Для однофайловых почтовых ящиков, разумеется, блокировка - необходимость.
   Размер файла берётся как его используемое значение. Из-за эффектов блокировки, оно может быть намного меньше дискового пространства, фактически используемого файлом. Если складываются размеры большого числа файлов, эффект округления может стать весьма заметным, особенно на системах использующих большой размер блока. Однако, кажется лучше придерживаться используемого числа, поскольку оно - очевидное значение, наиболее легко понимаемое пользователями.
   Значение опции раскрывается, и должно быть числовым значением (разрешена десятичная точка), опционально сопровождаемая одной из букв K, M, или G - для килобайт, мегабайт, или гигабайт. Если exim работает на системе с поддержкой больших файлов (FreeBSD и Linux имеют такую поддержку), могут быть обработаны ящики более 2G размером.
   Отметтьте: Значение нуля интерпретируется как “нет квоты”.
   Раскрытие происходит когда exim работает как root, до того, как он для доставки меняет uid. Это означает, что для содержания квоты, которая ищется в раскрытии можно использовать файлы, которые недоступны конечному пользователю. При неудаче доставки по причине превышения квоты, ошибка обрабатывается как ошибка системной квоты.
   По умолчанию, проверка квоты exim`ом подражает системным квотам, и ограничивает почтовый ящик заданным максимальным размером, хотя значение не является точным до последнего байта, из-за строк разделителей, и дополнительных заголовков, которые могут добавляться при доставке сообщения. Когда почтовый ящик почти полный, большие сообщения могут быть отклонены, а маленькие приняты, поскольку размер текущего сообщения добавляется к квоте, при проверке. Это поведение может быть изменено путём установки “quota_is_inclusive” в ложь. Когда это сделано, проверка на превышение квоты не включает текущее сообщение. Таким образом, доставки продолжаются до превышения квоты; после этого никакие последующие сообщения не доставляются. Также смотрите опцию “quota_warn_threshold”.



Имя Использование Тип Дефолтовое значение quota_directory appendfile string† незадана

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



Имя Использование Тип Дефолтовое значение quota_filecount appendfile string† 0

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



Имя Использование Тип Дефолтовое значение quota_is_inclusive appendfile boolean истина

   Смотрите выше, опцию “quota”.



Имя Использование Тип Дефолтовое значение quota_size_regex appendfile string незадана

   Эта опция применяется когда используется один из режимов доставки, записывающий отдельный файл для каждого сообщения. Когда exim хочет найти размер одного из этих файлов, для проверки квоты, он вначале проверяет “quota_size_regex”. Если она установлена в регулярное выражение, которое совпадает с именем файла, и является одной строкой, строка интерепретируется как представление размера файла. Значение “quota_size_regex” не раскрывается.
   Эта особенность полезна лишь когда пользователи не имеют shell-доступа к своим почтовым ящикам - иначе они могли бы обойти квоту простым переименованием файлов. Это средство может использоваться для “maildir” доставок, путём установки “maildir_tag” для добавления длинны файла к имени файла. Например:


maildir_tag = ,S=$message_size quota_size_regex = ,S=(\d+)

   Альтернативой “$message_size” является “$message_linecount”, которая содержит число линий в сообщений.
   Регулярное выражение не должно предполагать что размер сообщения - в конце имени файла (даже при том, что её там помещает “maildir_tag”), поскольку MUA обрабатывающие “maildir” иногда добавляют иную информацию в конец имени сообщения.



Имя Использование Тип Дефолтовое значение quota_warn_message appendfile string† смотрите ниже

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


quota_warn_message = "\ To: $local_part@$domain\n\ Subject: Your mailbox\n\n\ This message is automatically created \ by mail delivery software.\n\n\ The size of your mailbox has exceeded \ a warning threshold that is\n\ set by the system administrator.\n"

Имя Использование Тип Дефолтовое значение quota_warn_threshold appendfile string† 0

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


quota = 10M quota_warn_threshold = 75%

   Если “quota” не задана, установка “quota_warn_threshold” заканчивающаяся символом процента - игнорируется.
   Само предупреждающее сообщение определяется путём опции “quota_warn_message”, и оно должно начинаться со строки заголовка “To:”, содержащей получателя (получателей) предупреждающего сообщения. Они не обязательно должны включать отправителей оригинального сообщения. Также, обычно, должна предоставляться строка “Subject:”. Вы можете включить любые другие строки заголовков, которые вам необходимы. Если вы не включите строку “From:”, то значение по умолчанию будет:


From: Mail Delivery System <mailer-daemon@$qualify_domain_sender>

   Если вы предоставляете строку “Reply-To:”, она перезадаёт глобальную опцию “errors_reply_to”.
   Опция “quota” не нуждается в приведении в порядок, для использования этой опции; они независимы друг от друга, кроме случаев, когда порог определён как процент.



Имя Использование Тип Дефолтовое значение use_bsmtp appendfile boolean ложь

   Если эта опция установлена в истину, “appendfile” пишет сообщения в формате “пакетного SMTP”, с отправителем конверта и получателем(получателями) включёнными в SMTP-команды. Если вы хотите включить начальную команду HELO в эти сообщения, вы можете это сделать путём установки опции “message_prefix”. Для получения дополнительных деталей о пакетном SMTP, смотрите раздел 44.10.



Имя Использование Тип Дефолтовое значение use_crlf appendfile boolean ложь

   Эта опция заставляет строки заканчиваться двухсимвольной CRLF последовательностью (возврат каретки, перевод строки), вместо одного символа перевода строки. В случае пакетного SMTP, записанная в файл последовательность байт, - точное изображение того, что произвело бы отключение реального SMTP-соединения.
   Содержимое опций “message_prefix” и “message_suffix” пишется дословно, таким образом, они должны содержать свои символы возврата каретки, если они необходимы. В случаях, когда эти опции имеют непустые значения по умолчанию, значение завершается единственным переводом строки, таким образом, они должны быть изменены, чтобы заканчиваться на “\r\n”, если установлена опция “use_crlf”.



Имя Использование Тип Дефолтовое значение use_fcntl_lock appendfile boolean смотрите ниже

   Эта опция контролирует использование функции “fcntl()”, для блокировки файла в целях исключительного использования, при добавлении сообщения. По умолчанию, она установлена, когда не установлена “use_flock_lock”. Иначе, она должна быть выключена, лишь если вы знаете что все ваши MUA используют блокировку путём файла блокировки. Когда не установлены обе опции, “use_fcntl_lock” и “use_flock_lock”, опция “use_lockfile” должна быть задана.



Имя Использование Тип Дефолтовое значение use_flock_lock appendfile boolean ложь

   Эта опция предоставлена для поддержки блокировки файлов с использованием “flock()”, в тех немногих ситуациях, когда это необходимо. Самые современные операционные системы поддерживают блокировки “fcntl()” и “lockf()”, и эти две функции взаимодействуют друг с другом. По умолчанию, exim использует блокировку “fcntl()”.
   Эта опция требуется лишь если вы используете операционную систему где “lockf()” используется программами обращающимися к почтовым ящикам (обычно - MUA), и где “flock()” некорректно взаимодействует с “fcntl()”. Если вы хотите, то можете одновременно использовать обе блокировки “fcntl()” и “flock()”.
   Не все операционные системы предоставляют “flock()”. Некоторые версии Solaris не имеют её (и некоторые, я думаю, предоставляют не совсем правильные версии, собранные на верху “lockf()”). Если операционная система не имеет “flock()”, exim будет собран без способности её использовать, и любые попытки сделать это приведут к конфигурационной ошибке.
   Предупреждение: Блокировка “flock()” не работает на NFS файлах (только если “flock()” не отображается (mapped) на “fcntl()” с помощью операционной системы).



Имя Использование Тип Дефолтовое значение use_lockfile appendfile boolean смотрите ниже

   Если эта опция выключена, exim не пытается создать файл блокировки при добавлении к файлу почтового ящика. В этой ситуации, единственная блокировка - “fcntl()”. Вы должны отключать “use_lockfile” лишь в случае, если вы абсолютно уверены, что любые MUA, которые когда-либо будут просматривать почтовые ящики пользователей, используют “fcntl()” вместо блокировочного файла и тогда, когда вы не передаёт через NFS более чем от одного хоста.
   Для безопасного добавления к файлам NFS более чем от одного хоста, необходимо снять блокировку до открытия файла, и блокировочный файл достигает этого. Иначе, даже с блокировкой “fcntl()”, есть риск повреждения файла.
   Опция “use_lockfile” установлена по умолчанию, если не задана “use_mbx_lock”. Не возможно выключить обе опции - “use_lockfile” и “use_fcntl_lock”, кроме случаев, когда установлена “mbx_format”.



Имя Использование Тип Дефолтовое значение use_mbx_lock appendfile boolean смотрите ниже

   Эта опция доступна лишь когда exim скомпилирован с установленной SUPPORT_MBX в “Local/Makefile”. Установка опции определяет, что используются специальные правила блокировки MBX. По умолчанию, она установлена, если установлена “mbx_format”, и ни одной опции блокировки нет в конфигурации. Правила блокировки - такие же, как используются библиотекой “c-client”, лежащей в основе даемонов Pine, IMAP4 и POP, которые идут вместе с ней (ниже, смотрите обсуждение). Правила разрешают общий доступ к почтовому ящику. Однако, этот вид блокироки не работает, когда почтовый ящик примонтирован по NFS.
   Вы можете установить “use_mbx_lock” с одной или обеими опциями “use_fcntl_lock” “use_flock_lock” для контроля, какая блокировка используется в осуществлении правил блокировки MBX. Значение по умолчанию использует “fcntl()” если “use_mbx_lock” установлена без “use_fcntl_lock” или “use_flock_lock”.



26.3 Операционные детали для добавления

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


/tmp/.<device-number>.<inode-number>

используя устройство и номер иноды открытого файла почтовго ящика, в соответствии с правилами блокировки MBX. Этот файл создаётся с режимом, определённым путём опции “lockfile_mode”.
   Если exim не в состоянии заблокировать файл, есть два возможных действия, в зависимости от значения таймаута блокировки. Оно получается из “lock_fcntl_timeout” и “lock_flock_timeout”, соответственно.
   Если значение таймаута - ноль, файл закрывается, exim ждёт “lock_interval”, и, затем, возвращается и повторно открывает файл, как описано выше, и снова пробует ео заблокировать. Это случается до времени “lock_retries”, после которого доставка задерживается.
   Если значение таймаута более нуля, блокировка вызывает “fcntl()” или “flock()”, которая используются (с данным таймаутом), таким образом, уже будет некоторое значение таймаута, путём ошибок блокировки. Однако, exim не прекращает немедленно. Он повторяет до времени (округлённого)


(lock_retries * lock_interval) / <timeout>

   В конце доставки, exim закрывает файл (освобождая блокировки “fcntl()” и/или “flock()”), и после этого удаляет, если он существует, файл блокировки.



26.4 Операционные детали для доставки в новый файл

   Когда опция “directory” установлена вместо “file”, каждое сообщение доставялется в недавно созданный файл, или установленные файлы. Когда “appendfile” активирован непосредственно из роутера “redirect”, то обычно ни “file”, ни “directory” не устанавливаются, поскольку путь для доставки предоставялется роутером. (Смотрите, например, транспорт “address_file”, в дефолтовой конфигурации.) В этом случае, доставка осуществляется в новый файл, если имя пути завершается на “/”, или установлена опция “maildir_format” или “mailstore_format”.
   При записи сообщения в новый файл блокировка не требуется, следовательно, различные опции блокировки транспорта - игнорируются. Строка “From”, которая по умолчанию, разделяет сообщения в одном файле, обычно не требуется, ни экранирование строк сообщения начинающихся с “From”, и нет необходимости обеспечивать новую строку в конце каждого сообщения. Следовательно, значения по умолчанию “check_string”, “message_prefix” и “message_suffix” - все незаданы, когда установлена любая из опций “directory”, “maildir_format” или “mailstore_format”.
   Если exim должен проверять установку “quota”, он скоадывает размеры всех файлов в дефолтовой директории для доставки. Однако, вы можете задать иную диреткорию, путём установки “quota_directory”. Также, для доставок “maildir” (смотрите ниже), соблюдается соглашение “maildirfolder”.
   Есть три различных пути, которыми может быть сделана доставка в индивидуальные файлы,контролируемые параметрами настройки опций “maildir_format” и “mailstore_format”. Отметтьте, что код для поддержки форматов “maildir” или “mailstore” не включен в бинарник, если SUPPORT_MAILDIR, или, соответственно, SUPPORT_MAILSTORE не установлены в “Local/Makefile”.
   Во всех трёх случаях, делается попытка создать директорию и все необходимые субдиреткории, если они не существуют, при условии что установлена опция “create_directory” (по дефолту - установлена). Расположение созданного каталога может быть ограничено установкой “create_file”. Режим созданной директории даётся опцией “directory_mode”. Если создание неудачно, или если опция “create_directory” не установлена, когда требуется создание, доставка задерживается.



26.5 Доставка “maildir”

   Если истинна опция “maildir_format”, exim доставляет каждое сообщение путём записи его в файл, чьё имя - “tmp/<stime>.H<mtime>P<pid>.<host>”, в директории, определённой опцией “directory” (“директория доставки”). Если доставка успешна, файл переименовывается внутрь субдиректории “new”.
   В имени файла, “<stime>” - текущее время дня, в секундах, и “<mtime>” - часть микросекунд времени. После “maildir” доставки, exim проверяет, что часы дневного времени ушли дальше по крайней мере на микросекунду, перед завершением процесса доставки. Это гарантирует уникальность имени файла. Однако, предусмотрительно, exim вызывает “stat()” для файла, до его открытия. Если даётся какой угодно ответ кроме ENOENT (не существует), exim ждёт две секунды, и пробует снова, вплоть до времени “maildir_retries”.
   До того, как exim выполнит “maildir”-доставку, он обеспечивает что директории с именами “new”, “cur” и “tmp” существуют в директории доставки. Если они не существуют, exim пробует создать их, и другие предстоящие директории в пути, подчиняясь опциям “create_directory” и “create_file”. Если задана опция “maildirfolder_create_regex”, и её регулярное выражение содержит  совпадение с директорией доставки, exim, также, гарантирует, что в директории доставки существует файл “maildirfolder”. Если отсутствующая директория, или файл “maildirfolder” не могут быть созданы, доставка задерживается.
   Эти особенности позволяют использовать exim для создания всех необходимых файлов и каталогов в почтовом ящике, включая субдиректории для папок “maildir++”. Рассмотрите этот пример:


maildir_format = true directory = /var/mail/$local_part\ ${if eq{$local_part_suffix}{}{}\ {/.${substr_1:$local_part_suffix}}} maildirfolder_create_regex = /\.[^/]+$

   Если пуста “$local_part_suffix” (нет суффикса для локальной части), доставка происходит в вышележащую “maildir”, с именем типа “/var/mail/pimbo” (для юзера с именем “pimbo”). Регулярное выражение в “maildirfolder_create_regex” не совпадает с этим именем, таким образом, exim не будет искать или создавать “/var/mail/pimbo/maildirfolder”, хотя он, в случае необходимости, создаст “/var/mail/pimbo/{cur,new,tmp}”.
   Однако, если “$local_part_suffix” содержит, например, “-eximusers”, доставка присходит в папку “maildir++” “/var/mail/pimbo/.eximusers”, которая не совпадает с “maildirfolder_create_regex”. В этом случае, exim создаст “/var/mail/pimbo/.eximusers/maildirfolder”, также как и три директории “maildir” - “/var/mail/pimbo/.eximusers/{cur,new,tmp}”.
   Предупреждение: При установке “maildirfolder_create_regex” позаботьтесь о том, чтобы она, по неосторожности, не совпадала с вышестоящей директорией “maildir”, поскольку файл “maildirfolder” на вышестоящем уровне полностью нарушил бы подсчёт квоты.
   Если exim обязан проверять установку “quota” до “maildir” доставки, и “quota_directory” не установлена, он ищет файл с именем “maildirfolder” в “maildir”-директории (рядом “new”, “cur”, “tmp”). Если он существует, exim предполагает, что директория - директория папок “maildir++”, которая одним уровнем ниже верхнего уровня пользовательской директории почтового ящика. Это заставляет его начать подсчёт используемого места с родительского каталога, вместо текущей директории.
   Проблема, при доставке в многофайловый почтовый ящик, состоит в том, что в вычислительном отношении дорого подсчитать размер почтового ящика, для проверки квоты. Были предприянты различные подходы для уменьшения необходимой работы. Следующие два раздела описывают два из них. Третья альтернатива заключается в использовании какого-то внешнего процесса для обслуживания данных о размере, и использовании раскрытия опции “mailbox_size” как способа импортировать эти данные в exim.



26.6 Использование тэгов для записи размера сообщений

   Если установлена “maildir_tag”, строка раскрывается для каждой доставки. Когда “maildir”-файл переименовывается в субдиректорию “new”, к его имени добавляется тэг. Однако, если добавялемый тэг берёт длинну имени с которой проверочный вызов “stat()” неудачен по причине ENAMETOOLONG, тег удаляется, и “maildir”-файл создаётся без тега.
   Теги могут использоваться для кодирования размеров файлов в их именах; для примера, смотрите выше, опцию “quota_size_regex”. Раскрытие “maildir_tag” происходит после записи сообщения. Значение переменной “$message_size” устанавливается в число фактически записанных байт. Если раскрытие принудительно неудачно, тэг игнорируется, но непринудительная неудача раскрытия приводит к задержке доставки. Раскрытый тэг может содержать любые печатные символы, кроме “/”. Непечатные символы в строке - игнорируются; если результирующая строка пустая - она игнорируется. Если она начинается с алфавитно-цифрового символа - вставляется начальное двоеточие.



26.7 Использование файла “maildirsize”

   Если истинна опция “maildir_use_size_file”, exim осуществляет правила “maildir++”, для хранения квоты и информации о размере файла в файле с именем “maildirsize”, в директории “maildir” верхнего уровня. Если этот файл не существует, exim создаст его, устанавливая квоту из транспортной опции “quota”. Если не существует сам каталог “maildir”, он его создаст до любых попыток записать файл “maildirsize”.
   Файл “maildirsize” используется для хранения информации о размерах сообщений в “maildir”, ускоряя подсчёт квоты. Значение квоты в файле - всего лишь кэш; если квота изменяется в транспорте, новое значение перезаписывает кэшированное при доставке следующего сообщения. Кэш поддерживается для других программ, которые обращаются к “maildir” и должны знать квоту.
   Если опция “quota” в транспорте незадана, или равна нулю, файл “maildirsize” поддерживается (с нулевой установкой квоты), но никакой квоты не накладывается.
   Для контроля, какие каталоги используются в вычислении квоты при использовании файла “maildirsize”, доступно регулярное выражение. Для дополнительных деталей, смотрите “maildir_quota_directory_regex”, выше.



26.8 Доставка “mailstore”

   Если истинна опция “mailstore_format”, каждое сообщение записывается как два файла в данной директории. Уникальное базовое имя создаётся из идентификатора сообщения, и текущего процесса доставки, и файлы записываются с использованием этого базового имени, плюс суффиксов “.env” и “.msg”. Файл “.env” содержит конверт сообщения, и файл “.msg” - непосредственно сообщение. Базовое имя помещается в переменную “$mailstore_basename”.
   В процессе доставки, конверт, вначале, записывается в файл суффикс.tmp. Затем пишется файл “.msg”, и по завершении записи, файл “.tmp” переименовывается в файл “.env”. Программы, обращающиеся к сообщениям, должны ожидать появления обоих файлов - “.env” и “.msg”, до доступа к любому из них. Альтернативный подход заключается в ожидании исчезновения файла “.tmp”.
   Файл конверта начинается с любого текста, заданного опцией “mailstore_prefix”, раскрытой и завершённой символом новой строки, если таковой отсутствует. Затем следует адрес отправителя в одной строке, затем все адреса получателей - по одному на строке.Может быть более одного получателя лишь в случае, если значение опции “batch_max” более одного. В конце, раскрывается “mailstore_suffix” и результат добавляется в файл, сопровождаемый символом новой строки, если он им не заканчивается.
   Если раскрытие “mailstore_prefix” или “mailstore_suffix” завершается принудительной неудачей - они игнорируются. Другие ошибки раскрытия рассматриваются как конфигурационные ошибки, и доставка задерживается. Переменная “$mailstore_basename” доступна для использования в процессе этих раскрытий.



26.9 Неспециальная доставка в новый файл

   Если не установлены ни “maildir_format” ни “mailstore_format”, непосредственно в названном каталоге создаётся единичный новый файл. Например, при доставке сообщений в файлы в пакетном формате SMTP, для позднейшей доставки на другой хост (смотрите раздел 44.10), могут использоваться установки типа таких:


directory = /var/bsmtp/$host

   Сообщение записывается в файл с временным именем, которое переименовывается, когда доставка завершена. Финальное имя файла получается путём раскрытия опции “directory_file”.


=============
translated by lissyara