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

retain-x-schedule

<source>

Оставлять ли заголовок x-schedule в письме при доставке
в конфигурации это строкаretain-x-schedule falseвнутри блока <source>
Показывать ли получателю, когда вы собирались отправить

Умолчание — false: заголовок снимается перед доставкой. С true он остаётся в письме.

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

Главная ловушка — про случай «обе выключены» руководство говорит двумя голосами. Этот раздел утверждает: при обеих директивах false MTA заголовок игнорирует, но всё равно снимает перед доставкой. Соседние разделы про чтение — трижды, для трёх разных заголовков — утверждают обратное: непрочитанный заголовок остаётся в письме.

Формулировка «всё равно снимает» стоит здесь и у пары про ключ подписи, и написаны обе под копирку. Перевес доказательств на стороне «остаётся». Разрешить вопрос можно только письмом в свой ящик.

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

Что ставить. Умолчание верно почти всегда:

Значение Когда
no (умолчание) обычный случай: получателю незачем знать, когда вы планировали отправить
yes письмо идёт в свой контрольный ящик, и расписание нужно видеть глазами

Второй случай — временный, на время разбора. Оставленный включённым, он показывает получателям устройство вашего планирования.

Умолчание false и независимость от разрешения читать заголовок — из руководства, § 3.3.7.59. Противоречие с разделами про чтение — наша находка. Разбивка случаев наша.
Пример в конфигурации
# заголовок остаётся в письме — только для собственных ящиков
<source 10.0.0.5>
    process-x-schedule true
    retain-x-schedule true</source>
Пара имеет смысл на отдельном источнике для засеивания: письмо приходит в свой ящик вместе с окнами, по которым его пытались доставить.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
▲

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

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

Считают вопрос решённым по руководству

§ 3.3.7.59

Чем чреватоПро случай «обе директивы выключены» в руководстве две взаимоисключающие фразы. Выбрать между ними по авторитету текста нельзя, и любое решение, принятое чтением, может оказаться неверным для вашей версии MTA.
Как заметитьЗаголовок ведёт себя не так, как ожидалось по прочитанному.
Как правильноОтправить письмо со служебными заголовками на свой ящик и посмотреть, что дошло. Одна проверка закрывает вопрос для всей семьи заголовков сразу.

Оставляют включённым после разбирательства

наш опыт

Чем чреватоПолучатели видят, в какие промежутки вы собирались отправлять. Из этого читается устройство вашего планирования: размер пачек, время суток, длина окон.
Как заметитьЗаголовок с расписанием встречается в письмах, полученных в чужих ящиках.
Как правильноВозвращать умолчание сразу после разбора и держать сохранение только на источнике для собственных ящиков.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
Справочные данные
Синтаксис
retain-x-schedule <boolean>
Значения
yes | no | true | false
Умолчание
false § 3.3.7.59
Применение
reload, перезапуск не нужен
Очередь
уже поставленное в очередь не затронет
Где писать
<source>
Сколько раз
один раз в блоке
Всё здесь — из руководства, с разделом.
Наследование
Директива живёт в <source> и подчиняется слиянию источников: соединение попадает под все адресные блоки, которые его накрывают, и узкий перекрывает широкий. Для подачи под логином действует именованный блок, и строку в нём приходится повторять — наследования из адресных блоков в именованный мы на своей установке не увидели.
⇄

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

2 связи

Без чего не работает

process-x-schedule<source>Первая половина пары; руководство называет их независимыми, и это тот случай, когда независимость создаёт вопрос, а не удобство. § 3.3.7.59

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

Заголовки, которыми отправитель управляет доставкойПоловина «оставить или снять» у одного из шести служебных заголовков. § 3.3.7.59

Как проверить на узле
Настройка видна в конфигурации, следствие — в доставленном письме:
grep -n 'retain-x-schedule' /etc/pmta/config /etc/pmta/virtualhost.txt
Пустой вывод означает вендорское умолчание. Что реально доехало до получателя, показывает только письмо в контрольном ящике — и это же единственный способ разрешить противоречие руководства о случае «обе выключены».
◇

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

3 статьи

◇Как письмо попадает в MTAШесть описанных способов подачи: расширенный SMTP, четыре языковые обвязки и каталог, за которым узел следит на диске.◇Кому разрешено сдавать почту и для кого её приниматьИз коробки узел принимает подачу только с самой машины; два разных вопроса — «кто может слать через нас» и «на чьи адреса мы принимаем» — решаются разными директивами.◇Заголовки, которыми отправитель управляет доставкойШесть служебных заголовков позволяют подающей стороне выбрать поток, пометить письмо заданием, задать настройки и ключ подписи, идентификатор конверта и расписание; каждый разрешается отдельно и по источникам.

В Хабе
Цена ошибки
обратимо: вредит, пока стоит
Сценарии
Подключить платформу отправки
Соседние настройки блока <source>:process-x-scheduleretain-x-dkim-keyprocess-x-dkim-keydefault-virtual-mtasmtp-serviceВсе 74 директив блока →