50.1 Поиск, что делают процессы exim'a (exiwhat)

   На операционных системах, которые могут перезапускать системные вызовы после получения сигнала (большинство современных OS), процесс exim'a отвечает на сигнал SIGUSR1, путём записи строки описывающей, что он делает в файл “exim-process.info” в директории спула exim'a. Скрипт “exiwhat” посылает сигнал всем процессам exim'a, которые он находит, вначале очистив файл. После чего он ждёт секунду, чтобы позволить процессам exim'a отреагировать, до отображения результатов. Для успешного управления “exiwhat”, вы должны обладать достаточными привилегиями для посылки сигнала процессам exim'a, таким образом, обычно, он запускается от рута.
   Предупреждение: Это неэффективный процесс. Он предназначен для случайного использования администраторами системы. Неразумно, например, настраивать скрипт, который через короткие периоды посылает процессам exim'a сигнал SIGUSR1.
   К сожалению, команда “ps” которую “exiwhat” использует для нахождения процессов exim'a, различна в разных операционных системах. Мало того, что используются различные опции, но и формат вывода - различен. Для этого, есть некоторые систменые конфигурационные опции, которые конфигурируют, как работает “exiwhat”. Если вам кажется, что он не работает, проверьте следующие компиляционные опции:


164 daemon: -q1h, listening on port 25
10483 running queue: waiting for 0tAycK-0002ij-00 (10492)
10492 delivering 0tAycK-0002ij-00 to mail.ref.example
  [10.19.42.42] (editor@ref.example)
10592 handling incoming call from [192.168.243.242]
10628 accepting a local non-SMTP message

   Превое число в строке вывода - номер процесса. Третья строка была разделена, чтоб уместиться в странице.



50.2 Селективный просмотр очереди (exiqgrep)

   Эта утилита - скрипт на Perl, предоставленный Matt Hubbard. Он запускает


exim -bpu

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


50.3 Подведение итогов очереди (exiqsumm)

   Утилита “exiqsumm” - скрипт на perl, который читает вывод “exim -bp” и сложение сообщений в очереди. Таким образом, вы можете использовать его путём запуска команды типа такой:


exim -bp | exiqsumm

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


3 2322 74m 66m msn.com.example

   Каждая строка перечисляет висящие доставки для домена, их полный объём, и отрезки времени, которые ожидают самое старое и самое новое сообщения. Отметтьте, что число зависших доставок больше чем число сообщений, когда сообщения имеют более одного получателя.
   Итоговая строка выводится в конце. По умолчанию, вывод сортируется по доменному имени, но “exiqsumm” обладает опциями “-a” и “-c”, вызывающих сортировку вывода по наиболее старым сообщениям, и по счётчику сообщений, соотвественно. Также есть три опции, которые делят сообщения для каждого домена в два или более подсчётчика: “-b” - отделяет рикошеты, “-f” - отделяет замороженные сообщения, и, “-s” - разделяет сообщения по их отправителю.
   Вывод “exim -bp” содержит оригинальные адреса в сообщении, таким образом, он также применяется к выводу “exiqsumm”. Домены сренерированные из адресов в результате альясинга или форвардинга - не включаются (если не использовалась опция “one_time” роутера “redirect” для конвертации из в адреса “верхнего уровня”).



50.4 Извлечение специфической информации из лога (exigrep)

   Утилита “exigrep” - скрипт на perl, который ищет по одному или нескольким главным логам элементы совпадающие с заданным шаблоном. Когда он находит совпадение, он извлекает все записи логов для уместного сообщения, а не только совпавшие с шаблоном. Таким образом, “exigrep” может извлекать полный лог для заданного сообщения, или всю почту для заданного пользователя, или для заданного хоста, например. Входные файлы должны быть в формате логов exim'a или syslog. Если совпадающие строки логов не ассоциируются с определённым сообщением, то они включаются в вывод “exigrep” без каких-либо дополнительных строк. Использование:


exigrep [-t<n>] [-I] [-l] [-v] <pattern> [<log file>] ...

   Если имя лог-файла не дано в командной строке, читается стандартный ввод.
   Аргумент “-t” определяет число секунд. Он добавляет дополнительное условие для выбора сообщения. Сообщения которые являются полными, показываются лишь если они провели в очереди более чем “<n>” секунд.
   По умолчанию, “exigrep” ищщет регистронезависимо. Опция “-I” делает его регистрозависимым. Это может повысить производительность при поиске по большим файлам журналов. Без “-I”, шаблон perl'a проверяется с использованием опции “/i”; c “-I” - без неё. В обоих случаях, возможно изменить регистрозависимость внутри шаблона, используя “(?i)” или “(?-i)”
   Опция “-l” - буквальная, для обработки всех символов шаблона как они есть. Иначе паттерн должен быть регулярным выражением perl.  Сравнение шаблона нечувствительно к регистру. Если в командной строке не задано имя файла, читается стандартный ввод.
   Опция “-v” - инвертирует совпадение. Таким образом, выбираются строки не совпадающеи с шаблоном.
   Если местоположение команды “zcat” известно из определения ZCAT_COMMAND в “Local/Makefile”, “exigrep” автоматически передаёт файлы, чьи имена заканчиваются на COMPRESS_SUFFIX, через “zcat” и затем ищет.



50.5 Отбор сообщений по различным критериям (exipick)

   Утилита John Jetmore - “exipick”, включена в дистрибутив exim'a. Она выводит список сообщений из очереди согласно разнообразным критериям. Для детальной информации “exipick” посетите страницу http://www.exim.org/eximwiki/ToolExipickManPage, или запустите “exipick” с опцией “--help”.



50.6 Ротация лог-файлов (exicyclog)

   Скрипт “exicyclog” может быть использован для ротации логов “mainlog” и “rejectlog”. В этом нет необходимости лишь если используется syslog, или если вы используете файлы логов со штампом даты в их именах (смотрите раздел 49.3). Некоторые операционные системы имеют собственные стандартные механизмы для ротации логов, и, если предпочитаете, они могут использоваться вместо “exicyclog”. Есть два варианта опций командной строки для “exicyclog”:


1 0 * * * su exim -c /usr/exim/bin/exicyclog

предполагая, что вы используете для пользователя exim'a имя “exim”. Вы можете запускать “exicyclog” от root`a, если вы этого желаете, но в этом нет необходимости.



50.7 Почтовая статистика (eximstats)

   Скрипт на perl с именем “eximstats” предоставлен для извлечения статистической информации из лог-файлов. Вывод - является простым текстом, или HTML. Логи exim'a также поддерживаются системой “Lire”, сделанной LogReport Foundation http://www.logreport.org/.
   Скрипт был нерабочим а течение долгого времени. Последняя версия - результат довольно большой переработки Steve Campbell. По умолчанию, даётся много информации, но есть опции для подавления некоторых её частей. После любых опций, аргументами должны быть файлы главного лога. Например:


eximstats -nr /var/spool/exim/log/mainlog.01

   По умолчанию, “eximstats” извлекает информацию о числе и объёме соощений полученных или доставленных на различные хосты. Информация сортирована по обоим, счётчику сообщений и по объёму, и высшие 50 хостов, в каждой категории, перечислены в стандартном выводе. Подобная информация, основанная на почтовых адресах или доменах, может быть запрошена при помощи различных опций. Для сообщений, доставляемых и передаваемых локально, подобная статистика делается на основании пользователей.
   Вывод, также включает общий счётчик и статистику о ошибках доставки, и гистограммы, показывающие число сообщений переданных и доставленных на каждый час дня. Доставки с более чем одним адресом в конверте (например, SMTP транзакция с более чем одной командой RCPT) подсчитывается как одна доставка.
   Хотя, обычно, уведомляется о большем числе доставок чем приёмов (поскольку сообщения могут иметь более одного получателя), “eximstats” может сообщить сообщить о большем числе отправленных сообщений, чем было получено, даже если очередь пуста в начале и в конце рассматриваемого периода. Если входящее сообщение не содержит допустимых получателей, для него доставки не записываются. Рикошеты обрабатываются как полностью независмые сообщения.
   Скрипт “eximstats” всегда выводит полное резюме, дающее объём и число переданных и доставленных сообщений, и число хостов вовлечённых в каждый случай. Также он выводит число задержанных сообщений (т.е. которые не были полностью доставлены в первую попытку), и число тех, у которых хотя бы один ардет был неудачен.
   Оставшийся вывод находится в секциях, которые могут быть независимо отключены, или модифицированы различными опциями.  Он состоит из изложения доставко по транспортам, гистограмм сообщений переданных и доставленных по интервалу времени (по умолчанию - по часу), информации р времени сообщений проведённом в очереди, списке релееных сообщений, списке высшиих 50 хостов по отправке, локальных отправителей, хостов назначения, и назначении локальных пользователей по счётчику и объёму, и списку происходивших ошибок доставки.
   Информация о релеинге перечисляет список сообщений которые были реально отрелеены, т.е. которые прибыли с удалённого хоста и были непосредственно доставлены на некоторый другой удалённый хост, без локальной обработки (например, без альясинга или форвардинга).
   Есть довольно много вариантов управления опциями “eximstats”, для точного управления его выводом. Они непосредственно задокументированы в перл-скрипте, и могут быть извлечены путём запуска команды “perldoc” для скрипта. Например:


perldoc /usr/exim/bin/eximstats

50.8 Проверка политики доступа (exim_checkaccess)

   Аргумент командной строки “-bh” позволяет вам запускать поддельную SMTP сессию с отладочным выводом, для проверки, что делает exim когда применяет управление политиками ко входящей SMTP-почте. Однако, не все достаточно знакомы с протоколом SMTP, чтобы быть в состоянии полностью использовать “-bh”, и иногда вы лишь хотите ответа на вопрос - имеет ли какой-то адрес доступ? - без получения дополнительных деталей.
   Утилита “exim_checkaccess” - “упакованная” (“packaged”) версия “-bh”. Она понимает два аргумента, IP-адрес и адрес электронной почты:


exim_checkaccess 10.9.8.7 A.User@a.domain.example

   Утилита управляет вызовом exim с опцией “-bh”, для тестирования, будет ли принят данный почтовый адрес в команде RCPT в соединении TCP/IP от хоста с заданным IP адресом. Вывод утилиты - или слово “accepted”, или ошибочный ответ SMTP, например:


Rejected: 550 Relay not permitted

   При работе этого теста, утилита использует “<>” как отправителя конверта в команде MAIL, но вы можете это изменить, предоставляя дополнительные опции. Их передают непосредственно команде exim'a. Например, для задания, что тест запускается с адресом отправителя “himself@there.example”, вы можете использовать:


exim_checkaccess 10.9.8.7 A.User@a.domain.example \ -f himself@there.example

   Отметтьте, что эти дополнительные элементы командной строки exim'a нужно давать после двух обязательных элементов.
   Поскольку “exim_checkaccess” использует “-bh”, он не выполянет обратный вызов при проведении проверки. Вы можете запустить проверку с включением обратного вызова используя “-bhc”, но это недоступно в “упакованной” (“packaged”) форме.



50.9 Создание файлов DBM (exim_dbmbuild)

   Программа “exim_dbmbuild” читает входной файл, содержащий ключи и данные в формате используемом поиском “lsearch” (смотрите раздел 9.3). Она пишет файлы DBM используя имена альясов в нижнем регистре как ключи, и оставшуюся информацию - как данные. Приведение к нижнему регистру может быть предотвращено путём вызова программы с опцией “-nolc”.
   Завершающий ноль включается как часть ключевой строки Это ожидается типом поиска “dbm”. Однако, если задана опция “-nozero”, “exim_dbmbuild” создаёт файлы без завершающих нулей в строках ключей, или строках данных. Тип поиска “dbmnz” может быть использован с такими файлами.
   Программа требует двух аргументов: имя входного файла (который может быть одним дефисом, для индикации стандартного ввода), и именем выходного файла. Она создаёт вывод с временным именем, и, затем, переименовывает его, если всё успешно.
   Если используется родной интерфейс DB (USE_DB установлена в компиляционном конфигурационном файле - это часто бывает в свободных версиях UNIX) два имени файлов должны быть различными, поскольку в этом режиме, функции Berkeley DB создают один выходной файл, используя точно заданное имя. Например:


exim_dbmbuild /etc/aliases /etc/aliases.db

читает файл системных альясов, и создаёт его DBM версию в “/etc/aliases.db”.
   В системах, которые используют шаблоны “ndbm” (большинство проприетарных версий UNIX), используются два файла, с суффиксами “.dir” и “.pag”. В этом окружении, суффиксы добавляются ко второму аргументу “exim_dbmbuild”, таким образом он может быть как и первый. Это также имеет место, когда функции Berkeley используются в совместимом режиме (хотя это не рекомендуется), поскольку в этом случае к имени файла добавляется суффикс “.db”.
   Если происходит столкновение с двойным ключом (повторяющимся - прим. lissyara), программа выводит предупреждение, и после завершения, она возвращает код 1, а не ноль, если не задана опция “-noduperr”. По умолчанию, используется лишь первый дубликат - это делает её совместимой с поисками “lsearch”. Также, есть опция “-lastdup”, вызывающая использование последнего дубликата вместо первого. Ещё есть опция “-nowarn”, которая останавливает перечисление двойных ключей на “stderr”. Для других ошибок, при которых новый файл, фактически, не создаётся, код возврата - 2.



50.10 Нахождение индивидуальных времён повторов (exinext)

   Утилита, называемая “exinext” (по большей части - скрипт perl), предоставляет возможность выбрать специфическую информацию из БД повторов. Данный почтовый домен (или полный адрес) ищется в хостах для этого домена, и выводит любую информацию повторов для хоста или домена. В настоящее время, информация повторов получается путём запуска “exim_dumpdb” (смотрите ниже), и последующей обработки её вывода. Например:


$ exinext piglet@milne.fict.example kanga.milne.example:192.168.8.1 error 146: Connection refused first failed: 21-Feb-1996 14:57:34 last tried: 21-Feb-1996 14:57:34 next try at: 21-Feb-1996 15:02:34 roo.milne.example:192.168.8.3 error 146: Connection refused first failed: 20-Jan-1996 13:12:08 last tried: 21-Feb-1996 11:42:03 next try at: 21-Feb-1996 19:42:03 past final cutoff time

   Также, вы можете дать “exinext” локальную часть, без домена, и он выдаст любую информацию повторов для этой локальной части, в вашем дефолтовом домене. Идентификатор сообщения может использоваться для получения информации повторов относящейся к специфическому сообщению. Она существует лишь когда попытка доставки сообщения на удалённый зост привела к специфической для сообщения ошибки (смотрите раздел 45.2). “exinext” - не очень эффективен, но, как ожидается, он не будет часто запускаться.
   Утилита “exinext” вызывает exim для нахождения информации, типа расположения spool-директории. Утилита имеет опции “-C” и “-D”, передаваемые командам “exim”. Первая определяет альтернативный конфигурационный файл exim'a, и вторая устанавливает макрос для использования в конфигурационном файле. Эти особенности должны помочь в тестировании, но они, также, могли бы быть полезны в окружении, где используется более одного конфигурационного файла.



50.11 Обслуживание БД подсказок

   Три утилиты предоставляются для обслуживания файлов DBM, которые exim использует для хранения его информации подсказок о доставках. Каждая программа требует двух аргументов. Первый определяет имя директории спула exim'a, и второй - имя БД с которой она работает. Они, таковы:


50.12 exim_dumpdb

   Всё содержимое БД пишется на стандартный вывод, при помощи программы “exim_dumpdb”, которая не имеет опций или аргументов кроме как имена спула и БД. Например, для дампа БД повторов:


exim_dumpdb /var/spool/exim retry

   На каждое вхождение производится две строки вывода:


T:mail.ref.example:192.168.242.242 146 77 Connection refused 31-Oct-1995 12:00:12 02-Nov-1995 12:21:39 02-Nov-1995 20:21:39 *

   Первый элемент в первой строке - ключ записи. Он начинается с одной из букв - “R” или “T”, в зависимоти от того, ссылается ли она на повтор роутинга, или транспорта. Для локальной доставки, следующая часть - локальный адрес; для удалённой доставки - это имя удалённого хоста, сопровождаемое его неудачным IP-адресом (за исключением случая когда “retry_include_ip_address” установлена в “false” в транспорте “smtp”). Если удалённый порт не стандартный (порт 25), он добавляется к IP-адресу. Затем следует код ошибки, дополнительный код ошибки, и текстовое описание ошибки.
   Три времени во второй строке - время первой ошибки, время последней попытки доставки, и вычисленное время для следующей попытки. Строка завершается звёздочкой, если время убывания для последнего повтора было превышено.
   Каждая строка вывода “exim_dumpdb” для БД “wait-xxx” содержит имя хоста, сопровождаемое списком идентификаторов для сообщений, которые есть, или ждут доставки на этот хост. Если для какого-то хоста очень много (идентификаторов, наверное - прим. lissyara), могут быть замечены повторяющиеся записи, с номерами последовательности добавленным к имени хоста. Данные в этих записях, часто являются устаревшими, поскольку сообщение может быть сроучено к нескольким альтернативным хостам, и exim не предпринимает усилий для ведения перекрёстных ссылок.



50.13 exim_tidydb

   Утилита “exim_tidydb” используется для упорядочивания содержимого БД подсказок. Если она запускается без опций, она удаляет все записи, которые старше 30 дней. Возраст вычисляется из даты и времени, когда запись была последний раз обновлена. Отметтьте, что в случае БД повторов, это не время с момента первого отказа. Информация о хосте, который лежал более 30 дней останется в БД, при условии, что записи обновляются достаточно часто.
   Дата сокращения может быть изменена путём опции “-t”? которая должна сопровождаться временем. Например, для удаления всех записей которые старше недели из БД повторов:


exim_tidydb -t 7d /var/spool/exim retry

   Обе БД - “wait-xxx” и “retry”, содержат элементы, которые вовлекают идентификаторы сообщений. Они фигурируют в форме данных в записях, где ключи - хосты, они были сообщениями ожидавшими этих хостов - и в последующем они - ключи для информации о сообщениях, перенёсших определённые типы ошибок. Когда “exim_tidydb” работает, производится проверка? что идентификаторы сообщений записанные в БД - это сообщения, которые всё ещё в очереди. Идентификаторы для сообщений, которые больше не существуют, удаляются из записей “wait-xxx”, и если остаются пустые записи, они удаляются. Для БД “retry”, удаляются записи чьи ключи - идентификаторы несуществующих сообщений. Утилита “exim_tidydb” выводит комментарии на стандартный вывод каждый раз, когда она удаляет информацию из БД.
   Определённые записи автоматически удаляются exim'ом когда они больше не нужны., но иные не удаляются. Например, если все MX хосты домена лежат, записи повторов создаются для каждого из них. Если первичный MX подымется первым, его запись удалится, когда exim успешно доставит на него, но записи для других - останутся, поскольку exim не пробовал эти хосты.
   Это важно, поэтому, периодически запускайте “exim_tidydb” для всех БД подсказок. Вы должны делать это в спокойное время суток, поскольку она требует, чтобы БД была заблокирована (и, поэтому, недоступна exim'y) когда она работает. Удаление записей из файлов DBM, обычно, не делает файл меньше, но все обычные библиотеки DBM умеют заново использовать освобождённое место. После начальной фазы увеличения в размере, БД, обычно, достигают точки, в которой они не становятся намного больше, пока они регулярно обслуживаются.
   Предупреждение: Если вы никогда не будете запускать “exim_tidydb”, то вероятно, используемое БД подсказок место будет продолжать увеличиваться.



50.14 exim_fixdb

   Программа “exim_fixdb” - утилита для интерактивной можификации БД. Главное её использование - для тестирования exim'a, но, также, иногда она может быть полезна для обхода проблемы на живой системе. Она не имеет опций, и её интерфейс несколько грубоват. На входе, она выводит подсказку в виде правой угловой скобки. В это время может быть введён ключ записи, и будут отображены данные для этой записи.
   Если в следующеи приглашении будет введено “d”, запись будет удалена. Для всех кроме БД “retry”, это - единственная возможная операция. Для БД “retry”, каждое поле предшествуется номером, и данные для индивидуальных полей могут быть изменены путём ввода номера поля, сопровождаемого новыми данными, напрмер:


> 4 951102:1000

сбросит время следующей попытки доставки. Значение времени даётся как последовательность цифровых пар для года, месяца, дня, часа, и минут. Двоеточия могут использоваться как опциональные разделители.



50.15 Обслуживание почтового ящика (exim_lock)

   Утилита “exim_lock” блокирует файл почтового ящика, используя тот же самый алгоритм что и exim. Для обсуждения проблем блокировки, смотрите раздел 26.3. “exim_lock” может быть использована для предотвращения какой-либо модификации почтового ящика exim'ом или пользовательским агентом, при исследовании проблемы. Утилита требует имя файла как её первый аргумент. Если блокировка успешна, второй аргумент запускает команду (используя функцию “system()” С); если второй аргумент не задан, используется значение переменной окружения SHELL; если она не задана или пуста, запускается “/bin/sh”. Когда команда завершается, почтовый ящик разблокируется, и утилита завершается. Доступны следующие опции:


exim_lock /var/spool/mail/spqr

запускает интерактивный шелл, когда файл заблокирован, тогда как:


exim_lock -q /var/spool/mail/spqr <<End <some commands> End

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


exim_lock -q /var/spool/mail/spqr \ "cp /var/spool/mail/spqr /some/where"

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


=============
translated by lissyara
verifying by Gerk