База знаний PMTA›Механизм§ 15

Указатель директив

directive index

Опись мест описания, а не настроек

Указатель директив — перечень из 475 строк, называющих 477 мест описания: у каждой строки имя, метка в скобках и ссылка на раздел.

Метка — не всегда блок: иногда это тематическая группа, например SSL/TLS там, где блок — <domain>. Надёжна ссылка: все 475 ведут ровно на один заголовок. Две строки называют сразу пару директив под одним заголовком.

Указатель — опись мест описания, а не настроек: имя может быть описано в одном месте, а работать в нескольких блоках. 48 имён описаны больше чем в одном месте — include в пяти, — и потому записи каталога несут в идентификаторе блок, в котором директива описана.

Главная ловушка — искать настройку по имени. Одно имя в разных блоках — разные места описания с разными умолчаниями: поиск по указателю без блока находит не ту строку.

Что делает Хаб. На узле указатель никто не читает; по нему сверялся весь разбор каталога — полнота 477 мест проверена механически. Одно место, где руководство показывает директиву, а указатель её не знает, нашлось при сверке шаблонов Хаба: rewrite-list внутри <source>.

Рекомендуемые значения

Что указатель гарантирует, а что нет:

Гарантирует	Не гарантирует
имя существует	в каких блоках его можно писать
где оно описано	что одноимённые директивы — одна настройка

Число строк и мест, метки, ссылки и 48 имён в нескольких местах — из указателя руководства (§ 15) и сверки разбора. Разграничение — наше.

Пример в конфигурации

# одно имя — два места в выводе настроек очереди
pmta show settings gmail.com/vmta1 | grep '^max-smtp-out '

Строка встретится дважды — в разделе «Virtual MTA Settings» и в «Queue Settings»: одно имя, два места.

жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.

Совместимость

PowerMTA 6.0

описана в руководстве этой версии · платформа: любая

С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.

⇄

Связанные записи

2 связи

Работают в паре

Четыре типа значений, на которых написан весь конфигСмежный механизм: они работают вместе. § 15

Где применяется

Главный файл конфигурации узлаФайл, которого механизм и касается. § 15

Как проверить на узле

Увидеть одно имя в двух местах на своём узле:

pmta show settings gmail.com/vmta1 | grep '^max-smtp-out '

Первое значение — предел адреса отправки, второе — очереди; это разные настройки.

◇

Что ещё почитать

3 статьи

◇Чужие составляющие MTAPowerMTA работает на пяти сторонних библиотеках — PCRE, OpenSSL, ICU, gumbo-parser и prometheus-cpp; их поведение задаёт сборка MTA.◇Принять, направить, доставитьПуть письма внутри узла: принять, решить куда, доставить — и между этими тремя шагами живут все настройки.◇Что узел рассказывает о себе и по каким каналамСемь поверхностей наблюдения: веб-монитор, консоль в четырёх форматах, журнал, учёт, поиск по учёту, метрики и выгрузка во внешнюю аналитику.

В Хабе

Цена ошибки: безопасно: неверное значение ничего не ломает
Сценарии: Жизненный цикл конфигурации · Разобраться с доставляемостью