O Google tem o compromisso de promover a igualdade racial para as comunidades negras. Saiba como.

Servidor DNS-SD

Este módulo inclui APIs para o servidor DNS-SD.

Resumo

Enumerações
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
} 		tipo enumerado
Esta enumeração especifica um tipo de consulta DNS-SD.

Typedefs
otDnssdCounters typedef
Essa estrutura contém os contadores do servidor DNS-SD.
otDnssdHostInfo typedef
Essa estrutura representa as informações de um host descoberto para uma consulta DNS-SD.
otDnssdQuery typedef
void
Esse tipo opaco representa uma consulta DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Essa função é chamada quando uma consulta DNS-SD assina uma destas consultas:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Essa função é chamada quando uma consulta DNS-SD cancela a inscrição em uma das seguintes consultas:
otDnssdServiceInstanceInfo typedef
Essa estrutura representa as informações de uma instância de serviço descoberta para uma consulta DNS-SD.

Functions
otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Essa função retorna os contadores do servidor DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Essa função adquire a próxima consulta no servidor DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Essa função adquire o tipo e o nome da consulta DNS-SD para uma consulta específica.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Essa função notifica um host descoberto.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Essa função notifica uma instância de serviço descoberta.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Essa função define callbacks de consulta do servidor DNS-SD.

Estruturas
otDnssdCounters (link em inglês)

Essa estrutura contém os contadores do servidor DNS-SD.

otDnssdHostInfo (em inglês)

Essa estrutura representa as informações de um host descoberto para uma consulta DNS-SD.

otDnssdServiceInstanceInfo (em inglês)

Essa estrutura representa as informações de uma instância de serviço descoberta para uma consulta DNS-SD.

Enumerações

OtDnssdQueryType

 otDnssdQueryType

Esta enumeração especifica um tipo de consulta DNS-SD.

Propriedades
OT_DNSSD_QUERY_TYPE_BROWSE

Serviço de navegação de tipo de serviço.

OT_DNSSD_QUERY_TYPE_NONE

Tipo de serviço não especificado.

OT_DNSSD_QUERY_TYPE_RESOLVE

O tipo de serviço resolve a instância de serviço.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

O tipo de serviço resolve o nome do host.

Typedefs

OtDnssdCounters

struct otDnssdCounters otDnssdCounters

Essa estrutura contém os contadores do servidor DNS-SD.

OtDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Essa estrutura representa as informações de um host descoberto para uma consulta DNS-SD.

OtDnssdQuery

void otDnssdQuery

Esse tipo opaco representa uma consulta DNS-SD.

OtDnssdQuerySubscribeCallback

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

Essa função é chamada quando uma consulta DNS-SD assina uma destas consultas:

  1. um nome de serviço.
  2. Um nome de instância de serviço
  3. um nome de host.

A implementação da consulta DNS-SD é responsável por identificar o que aFullName é. Se aFullName for um nome de serviço ou nome de instância de serviço, a implementação de consulta DNS-SD precisará descobrir as informações correspondentes da instância de serviço e notificar o servidor DNS-SD usando otDnssdQueryHandleDiscoveredServiceInstance. Se aFullName for um nome de host, a implementação da consulta DNS-SD descobrirá as informações do host e notificará o servidor DNS-SD usando otDnssdQueryHandleDiscoveredHost.

Detalhes
Parâmetros
[in] aContext
Um ponteiro para o contexto específico do aplicativo.
[in] aFullName
O nome completo do serviço com terminação nula (por exemplo, "_ipps._tcp.default.service.arpa.") ou nome completo da instância de serviço (por exemplo, "OpenThread._ipps._tcp.default.service.arpa.") ou nome completo do host (por exemplo, "ot-host.default.ar.arpaservice.arpa.
Veja também:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

OtDnssdQueryCancelCallback

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

Essa função é chamada quando uma consulta DNS-SD cancela a inscrição em uma das seguintes consultas:

  1. um nome de serviço.
  2. Um nome de instância de serviço
  3. um nome de host.

A implementação da consulta DNS-SD é responsável por identificar o que é aFullName.

Detalhes
Parâmetros
[in] aContext
Um ponteiro para o contexto específico do aplicativo.
[in] aFullName
O nome completo do serviço com terminação nula (por exemplo, "_ipps._tcp.default.service.arpa.") ou o nome completo da instância de serviço (por exemplo, "OpenThread._ipps._tcp.default.service.arpa.").

OtDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Essa estrutura representa as informações de uma instância de serviço descoberta para uma consulta DNS-SD.

Functions

OtDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Essa função retorna os contadores do servidor DNS-SD.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread
Retorna
Um ponteiro para os contadores do servidor DNS-SD.

OtDnssdGetNextQuery

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

Essa função adquire a próxima consulta no servidor DNS-SD.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread
[in] aQuery
O ponteiro de consulta. Transmita NULL para conseguir a primeira consulta.
Retorna
Um ponteiro para a consulta ou NULL caso não haja mais consultas.

otDnssdGetQueryTypeAndName

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

Essa função adquire o tipo e o nome da consulta DNS-SD para uma consulta específica.

Detalhes
Parâmetros
[in] aQuery
O ponteiro de consulta adquirido de otDnssdGetNextQuery.
[out] aNameOutput
O buffer de saída do nome, que precisa ter OT_DNS_MAX_NAME_SIZE bytes.
Retorna
Tipo de consulta DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Essa função notifica um host descoberto.

O resolvedor de consultas externa (por exemplo, o Proxy Discovery) precisa chamar essa função para notificar o núcleo OpenThread dos hosts inscritos.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread
[in] aHostFullName
O nome completo do host com terminação nula.
[in] aHostInfo
Um ponteiro para as informações descobertas da instância de serviço.

otDnssdQueryHandleDiscoveredServiceInstance

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

Essa função notifica uma instância de serviço descoberta.

O resolvedor de consultas externo (por exemplo, o Proxy Proxy) precisa chamar essa função para notificar o núcleo OpenThread dos serviços assinados ou instâncias de serviço.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread
[in] aServiceFullName
O nome completo do serviço com terminação nula.
[in] aInstanceInfo
Um ponteiro para as informações descobertas da instância de serviço.

otDnssdQuerySetCallbacks

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

Essa função define callbacks de consulta do servidor DNS-SD.

O servidor DNS-SD chama aSubscribe para se inscrever em um serviço ou instância de serviço e resolver uma consulta DNS-SD, e aUnsubscribe para cancelar a inscrição quando a consulta é resolvida ou atinge o tempo limite.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread
[in] aSubscribe
Um ponteiro para a função de callback para assinar um serviço ou uma instância de serviço.
[in] aUnsubscribe
Um ponteiro para a função de callback para cancelar a inscrição de um serviço ou uma instância de serviço.
[in] aContext
Um ponteiro para o contexto específico do aplicativo.

Recursos

Os tópicos de referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para saber mais ou contribuir com nossa documentação, consulte Recursos.