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

Обвязка подачи на C

C Submission API
Самая подробная из пяти

Обвязка подачи на C — четвёртая из пяти в главе: те же операции, что у C++, но функциями с общими приставками PmtaConn, PmtaMsg и PmtaRcpt в заголовках submitter/PmtaConn.h, PmtaMsg.h и PmtaRcpt.h.

Разница — в жизни объекта и ошибках: объект выделяют функцией …Alloc, инициализируют, а по окончании освобождают …Free; функции возвращают признак успеха, а причину отдают …GetLastError.

Подключение — двумя функциями: PmtaConnConnectRemote без входа и PmtaConnConnectRemoteAuth с логином и паролем; прежняя PmtaConnConnect устарела.

Главная ловушка — не проверять возвращаемое значение. Функции не бросают исключений: ошибка видна только по возврату FALSE, и объект после неё негоден — его освобождают и создают заново.
Что делает Хаб. Не используется: письма прогрева Хаб подаёт по SMTP.
Рекомендуемые значения

Порядок работы с объектом:

Шаг Соединение Письмо
выделить PmtaConnAlloc PmtaMsgAlloc
инициализировать PmtaConnConnectRemote PmtaMsgInit
узнать причину ошибки PmtaConnGetLastError PmtaMsgGetLastError
освободить PmtaConnFree PmtaMsgFree
Приставки, заголовки, разделение выделения и инициализации, освобождение и запрос ошибки — из руководства (§ 7.5). Таблица — наша.
Пример в конфигурации
# подключиться к узлу с логином и паролем
PmtaConn conn = PmtaConnAlloc();
PmtaConnConnectRemoteAuth(conn, "10.0.0.5", 25, "user", "secret");
Возврат FALSE — ошибка: причину даёт PmtaConnGetLastError(conn), после чего соединение освобождают PmtaConnFree.
жёлтым — — имена директив, голубым — блоки. Так же они подсвечены и в тексте карточки.
Совместимость
PowerMTA 6.0
описана в руководстве этой версии · платформа: любая
С какой версии директива доступна, вендор указывает не для всех — здесь пометки нет. Имя встречается и в издании руководства 5.0.
⇄

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

3 связи

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

Жизнь объекта в обвязке CСмежный механизм: они работают вместе. § 7.5.1

То же имя в других блоках

Обвязка подачи на C++Та же настройка на другом уровне. § 7.5

Где это видно

Подача — сетевая служба, и в неё можно войтиСмежный механизм: они работают вместе. § 7.5.4

Как проверить на узле
Проверить, что заголовки обвязки на месте:
ls /opt/pmta/api/include/submitter/
Файлы PmtaConn.h, PmtaMsg.h и PmtaRcpt.h — обвязка C установлена.
◇

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

3 статьи

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

В Хабе
Цена ошибки
безопасно: неверное значение ничего не ломает
Сценарии
Подключить платформу отправки