Demo
Demo
База знаний PMTA›Блок <domain>›Директива§ 3.3.10.16

delivery-priority

<domain>устарела

Приоритет доставки — устаревшее имя
в конфигурации это строкаdelivery-priorityвнутри блока <domain>
Строка, у которой осталось только имя

Руководство отводит директиве раздел (§ 3.3.10.16) и пишет в нём две вещи: пометку Deprecated и замену — queue-priority.

Ни синтаксиса, ни умолчания, ни описания поведения там нет: всё это переехало в раздел замены.

Судя по именам, речь об одном и том же — очерёдности обслуживания очередей при нехватке соединений. Но это вывод из названия, а не утверждение руководства: сравнить поведение двух строк оно не даёт.

Главная ловушка — держать обе строки. Что произойдёт, если в одном блоке окажутся и устаревшая, и новая, руководство не оговаривает. Разбираться придётся опытом — а нужды в этом нет: замена названа прямо.

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

Что делает Хаб. Не пишет — ни устаревшую строку, ни её замену: приоритеты очередей у него не задаются вовсе.

Устаревшую стоит искать в конфигурациях, собранных руками до перехода на Хаб.

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

Что ставить. Ничего: строку следует заменить.

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

Перевод механический: имя меняется на новое, значение остаётся — шкала у замены та же, от нуля до ста с серединой в пятидесяти.

Пометка об устаревании и указание на замену — единственное, что руководство говорит об этой директиве, § 3.3.10.16. Шкала замены — § 3.3.10.14. Вывод о совпадении смысла наш, из названий.
Пример в конфигурации
# так было раньше — сегодня то же пишется новым именем
<domain someplace.com>
    delivery-priority 75</domain>
Значение переносится как есть: шкала у замены та же. Держать обе строки в одном блоке не стоит — что победит, руководство не говорит.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

Типичные ошибки и проблемы

что делают не так и чем это кончается2 ошибки▶

Оставляют устаревшую строку рядом с новой

§ 3.3.10.16

Чем чреватоЧто победит, руководство не оговаривает. Разбираться придётся опытом, при том что замена названа прямо и нужды в этом нет.
Как заметитьВ конфигурации встречаются обе строки.
Как правильноУбрать устаревшую, значение перенести в новую.

Считают строку рабочей, потому что она не вызывает ошибок

наш опыт

Чем чреватоУстаревшая директива не отмечается ни в журнале, ни при применении конфигурации. Она выглядит настройкой, о действии которой ничего не известно.
Как заметитьСтрока стоит годами, и никто не проверял, работает ли она.
Как правильноПеревести на замену — тогда о поведении можно будет читать описание, а не гадать.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
delivery-priority <integer>
Значения
не описано в руководстве
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<domain>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <domain> и подчиняется слиянию блоков получателей — как и её замена. Разницы в области между ними нет: замена коснулась имени, а не устройства.
⇄

Связанные директивы

1 связь

Чем заменена

queue-priority<domain>Замена, названная руководством прямо; шкала и область у неё те же. § 3.3.10.16

Как проверить на узле
Устаревшую строку стоит искать вместе с её заменой:
grep -n 'delivery-priority\|queue-priority' /etc/pmta/config /etc/pmta/virtualhost.txt
Если нашлись обе, конфигурацию надо привести к одной. Устаревшая ничем себя не выдаёт: ни ошибки применения, ни записи в журнале.
◇

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

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Жизненный цикл конфигурации
Соседние настройки блока <domain>:queue-priorityallow-priority-interruptionallow-priority-interruption-during-transferdisable-acct-recordsdkim-signВсе 135 директив блока →