DNS-SD сервер

Этот модуль включает API для DNS-SD сервера.

Резюме

Перечисления

otDnssdQueryType {
OT_DNSSD_QUERY_TYPE_NONE = 0,
OT_DNSSD_QUERY_TYPE_BROWSE = 1,
OT_DNSSD_QUERY_TYPE_RESOLVE = 2,
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3
}
перечислить
Это перечисление указывает тип запроса DNS-SD.

Typedefs

otDnssdHostInfo typedef
Эта структура представляет информацию об обнаруженном хосте для запроса DNS-SD.
otDnssdQuery typedef
void
Этот непрозрачный тип представляет запрос DNS-SD.
otDnssdQuerySubscribeCallback )(void *aContext, const char *aFullName) typedef
void(*
Эта функция вызывается, когда запрос DNS-SD подписывается на одно из:
otDnssdQueryUnsubscribeCallback )(void *aContext, const char *aFullName) typedef
void(*
Эта функция вызывается, когда запрос DNS-SD отменяет подписку на одно из:
otDnssdServiceInstanceInfo typedef
Эта структура представляет информацию об обнаруженном экземпляре службы для запроса DNS-SD.

Функции

otDnssdGetNextQuery ( otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Эта функция получает следующий запрос на сервере DNS-SD.
otDnssdGetQueryTypeAndName (const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Эта функция получает тип и имя запроса DNS-SD для конкретного запроса.
otDnssdQueryHandleDiscoveredHost ( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Эта функция уведомляет обнаруженный хост.
otDnssdQueryHandleDiscoveredServiceInstance ( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Эта функция уведомляет обнаруженный экземпляр службы.
otDnssdQuerySetCallbacks ( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Эта функция устанавливает обратные вызовы запросов к серверу DNS-SD.

Структуры

otDnssdHostInfo

Эта структура представляет информацию об обнаруженном хосте для запроса DNS-SD.

otDnssdServiceInstanceInfo

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

Перечисления

otDnssdQueryType

 otDnssdQueryType

Это перечисление указывает тип запроса DNS-SD.

Характеристики
OT_DNSSD_QUERY_TYPE_BROWSE

Тип услуги просмотр услуги.

OT_DNSSD_QUERY_TYPE_NONE

Тип услуги не указан.

OT_DNSSD_QUERY_TYPE_RESOLVE

Тип службы разрешает экземпляр службы.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Тип службы разрешает имя хоста.

Typedefs

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Эта структура представляет информацию об обнаруженном хосте для запроса DNS-SD.

otDnssdQuery

void otDnssdQuery

Этот непрозрачный тип представляет запрос DNS-SD.

otDnssdQuerySubscribeCallback

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

Эта функция вызывается, когда запрос DNS-SD подписывается на одно из:

  1. имя службы.
  2. имя экземпляра службы.
  3. имя хоста.

Реализация запроса DNS-SD отвечает за определение того, что aFullName есть. Если aFullName этого имени службы или имя службы экземпляра, реализация запросов DNS-SD должна обнаружить соответствующую информацию экземпляра службы и уведомляет сервер DNS-SD с помощью otDnssdQueryHandleDiscoveredServiceInstance . Если aFullName этого имя хоста, реализация запросов DNS-SD должна обнаружить информацию хоста и уведомляет сервер DNS-SD с помощью otDnssdQueryHandleDiscoveredHost .

Подробности
Параметры
[in] aContext
Указатель на контекст приложения.
[in] aFullName
Полное имя службы с завершающим нулем (например, "_ipps._tcp.default.service.arpa.") Или полное имя экземпляра службы (например, "OpenThread._ipps._tcp.default.service.arpa.") Или полное имя хоста (например, "ot-host.default.service.arpa.").
Смотрите также:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

Эта функция вызывается, когда запрос DNS-SD отменяет подписку на одно из:

  1. имя службы.
  2. имя экземпляра службы.
  3. имя хоста.

Реализация запроса DNS-SD отвечает за определение того, что aFullName есть.

Подробности
Параметры
[in] aContext
Указатель на контекст приложения.
[in] aFullName
Полное имя службы с завершающим нулем (например, «_ipps._tcp.default.service.arpa.») Или полное имя экземпляра службы (например, «OpenThread._ipps._tcp.default.service.arpa.»).

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

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

Функции

otDnssdGetNextQuery

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

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

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aQuery
Указатель запроса. Передайте NULL, чтобы получить первый запрос.
Возврат
Указатель на запрос или NULL, если запросов больше нет.

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

Эта функция получает тип и имя запроса DNS-SD для конкретного запроса.

Подробности
Параметры
[in] aQuery
Указатель запроса получил от otDnssdGetNextQuery .
[out] aNameOutput
Выходное имя буфер, который должен быть OT_DNS_MAX_NAME_SIZE байт.
Возврат
Тип запроса DNS-SD.

otDnssdQueryHandleDiscoveredHost

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

Эта функция уведомляет обнаруженный хост.

Внешний преобразователь запросов (например, прокси-сервер обнаружения) должен вызвать эту функцию, чтобы уведомить ядро ​​OpenThread о подписанных узлах.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aHostFullName
Полное имя хоста с завершающим нулем.
[in] aHostInfo
Указатель на информацию об обнаруженном экземпляре службы.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

Эта функция уведомляет обнаруженный экземпляр службы.

Внешний преобразователь запросов (например, прокси-сервер обнаружения) должен вызвать эту функцию, чтобы уведомить ядро ​​OpenThread о подписанных службах или экземплярах служб.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aServiceFullName
Полное имя службы с завершающим нулем.
[in] aInstanceInfo
Указатель на информацию об обнаруженном экземпляре службы.

otDnssdQuerySetCallbacks

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

Эта функция устанавливает обратные вызовы запросов к серверу DNS-SD.

Сервер DNS-SD называет aSubscribe подписаться на экземпляр службы или службы , чтобы разрешить запрос DNS-SD и aUnsubscribe для отписки , когда запрос разрешен или тайм - аут.

Подробности
Параметры
[in] aInstance
Структура экземпляра OpenThread.
[in] aSubscribe
Указатель на функцию обратного вызова для подписки на службу или экземпляр службы.
[in] aUnsubscribe
Указатель на функцию обратного вызова для отмены подписки на службу или экземпляр службы.
[in] aContext
Указатель на контекст приложения.