Demo
Demo
База знаний PMTA›Команда§ 6.3.40

test config

критично

Проверка разбора конфигурации
Узнать об ошибке до применения, а не после

Проверяет синтаксис файла конфигурации, не перечитывая работающую конфигурацию.

Место этой команды — перед каждым применением. Она ловит нарушения грамматики — Error in line 11 of /etc/pmta/config: argument missing, — но не ловит строку, написанную не в тот блок: та разберётся верно и применится молча.

Главная ловушка — считать «ошибок нет» проверкой смысла. Команда проверяет только синтаксис: директива в чужом блоке или опечатка в имени домена пройдут её без единого слова.
Что делает Хаб. Вызывает по SSH перед каждым перечитыванием: записывает файлы, проверяет конфигурацию этой командой и при ошибке возвращает прежние файлы, не перечитывая. Успехом Хаб считает нулевой код возврата без слова error в выводе.
Рекомендуемые значения

Когда звать:

Вопрос Эта ли команда
нет ли синтаксической ошибки да
что действует после применения нет — show settings
применить конфигурацию нет — reload
Назначение и пример ошибки — из руководства (§ 6.3.40). Разбор про смысловые ошибки — наш.
Пример в конфигурации
# проверить и только потом применить
pmta test configpmta reload
Если первая строка печатает ошибку с номером строки файла, вторую не запускают.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

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

2 связи

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

Применить изменённую конфигурацию, не останавливаясьСначала проверить, потом применить — порядок именно такой. § 6.3.40Куда узел пишет, почему не запустилсяТо, чего эта проверка не ловит, и попадает потом в файл отказов запуска. § 4.2.1

Сюда ссылаются

Действующие настройки очередиГрамматика — до применения, действующие значения — после. inferenceЗаменить файл конфигурации по сетиТа же выдача из командной строки. § 8.2.2

Как проверить на узле
Проверить код возврата:
pmta test config; echo "exit=$?"
Хаб судит по коду и по отсутствию слова «error» в выводе — так надёжнее, чем читать текст.
◇

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

3 статьи

◇Принять, направить, доставитьПуть письма внутри узла: принять, решить куда, доставить — и между этими тремя шагами живут все настройки.◇Четыре типа значений, на которых написан весь конфигЛогическое, образец домена, регулярное выражение и промежуток времени — определены один раз в § 3.2 и дальше используются всеми директивами.◇Перезагрузка настроек против перезапуска службыКонфигурация читается при старте, дальше правки подхватываются командой перезагрузки — кроме тех директив, которые руководство помечает как требующие перезапуска.

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Жизненный цикл конфигурации
Важность
критично