DNS — Платформа

Этот модуль включает абстракцию платформы для отправки рекурсивного DNS-запроса на вышестоящие DNS-серверы.

Краткое содержание

Определения типов

otPlatDnsUpstreamQuery определение типа
Этот непрозрачный тип представляет транзакцию восходящего DNS-запроса.

Функции

otPlatDnsCancelUpstreamQuery ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Отменяет транзакцию восходящего запроса.
otPlatDnsStartUpstreamQuery ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Запускает восходящую транзакцию запроса.
otPlatDnsUpstreamQueryDone ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
Платформа вызывает эту функцию для завершения DNS-запроса.

Определения типов

отПлатДнсупстримкуери

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Этот непрозрачный тип представляет транзакцию восходящего DNS-запроса.

Функции

отПлатДнсканселапстримкуери

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Отменяет транзакцию восходящего запроса.

Платформа должна вызвать otPlatDnsUpstreamQueryDone , чтобы освободить ресурсы.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.

отПлатДнсстартупстримкуери

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

Запускает восходящую транзакцию запроса.

  • В случае успеха (и ошибок, представленных сообщениями протокола DNS) ожидается, что платформа вызовет otPlatDnsUpstreamQueryDone .
  • Ядро OpenThread может отменить транзакцию запроса (возможно, по истечении времени ожидания), вызвав otPlatDnsCancelUpstreamQuery , платформа не должна вызывать otPlatDnsUpstreamQueryDone для отмененной транзакции.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.
[in] aQuery
Буфер сообщений полезной нагрузки DNS, который должен быть отправлен на вышестоящий DNS-сервер.

отПлатДнсупстримкуеридоне

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

Платформа вызывает эту функцию для завершения DNS-запроса.

Транзакция будет освобождена, поэтому платформа не должна дважды вызывать одну и ту же транзакцию. Эта функция передает право собственности на aResponse в стек OpenThread.

Платформа может передать nullptr для закрытия транзакции без ответа.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.
[in] aResponse
Буфер сообщений полезных данных ответа DNS или nullptr для закрытия транзакции без ответа.

Ресурсы

Справочные разделы API OpenThread взяты из исходного кода, доступного на GitHub . Для получения дополнительной информации или внесения вклада в нашу документацию обратитесь к Ресурсам .

,

DNS — Платформа

Этот модуль включает абстракцию платформы для отправки рекурсивного DNS-запроса на вышестоящие DNS-серверы.

Краткое содержание

Определения типов

otPlatDnsUpstreamQuery определение типа
Этот непрозрачный тип представляет транзакцию восходящего DNS-запроса.

Функции

otPlatDnsCancelUpstreamQuery ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Отменяет транзакцию восходящего запроса.
otPlatDnsStartUpstreamQuery ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Запускает восходящую транзакцию запроса.
otPlatDnsUpstreamQueryDone ( otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
Платформа вызывает эту функцию для завершения DNS-запроса.

Определения типов

отПлатДнсупстримкуери

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Этот непрозрачный тип представляет транзакцию восходящего DNS-запроса.

Функции

отПлатДнсканселапстримкуери

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Отменяет транзакцию восходящего запроса.

Платформа должна вызвать otPlatDnsUpstreamQueryDone , чтобы освободить ресурсы.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.

отПлатДнсстартупстримкуери

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

Запускает восходящую транзакцию запроса.

  • В случае успеха (и ошибок, представленных сообщениями протокола DNS) ожидается, что платформа вызовет otPlatDnsUpstreamQueryDone .
  • Ядро OpenThread может отменить транзакцию запроса (возможно, по истечении времени ожидания), вызвав otPlatDnsCancelUpstreamQuery , платформа не должна вызывать otPlatDnsUpstreamQueryDone для отмененной транзакции.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.
[in] aQuery
Буфер сообщений полезной нагрузки DNS, который должен быть отправлен на вышестоящий DNS-сервер.

отПлатДнсупстримкуеридоне

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

Платформа вызывает эту функцию для завершения DNS-запроса.

Транзакция будет освобождена, поэтому платформа не должна дважды вызывать одну и ту же транзакцию. Эта функция передает право собственности на aResponse в стек OpenThread.

Платформа может передать nullptr для закрытия транзакции без ответа.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aTxn
Указатель на непрозрачный объект транзакции DNS-запроса.
[in] aResponse
Буфер сообщений полезных данных ответа DNS или nullptr для закрытия транзакции без ответа.

Ресурсы

Справочные разделы API OpenThread взяты из исходного кода, доступного на GitHub . Для получения дополнительной информации или внесения вклада в нашу документацию обратитесь к Ресурсам .