Google se compromete a impulsar la igualdad racial para las comunidades afrodescendientes. Obtén información al respecto.

Servidor DNS-SD

Este módulo incluye API para servidores DNS-SD.

Summary

Enumeraciones
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
} 		enum
En esta enumeración, se especifica un tipo de consulta de DNS-SD.

Typedefs
otDnssdCounters typedef
Esta estructura contiene los contadores del servidor DNS-SD.
otDnssdHostInfo typedef
Esta estructura representa información de un host detectado para una consulta de DNS-SD.
otDnssdQuery typedef
void
Este tipo opaco representa una consulta de DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Se llama a esta función cuando una consulta de DNS-SD se suscribe a una de las siguientes opciones:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Se llama a esta función cuando una búsqueda de DNS-SD anula una de las siguientes opciones:
otDnssdServiceInstanceInfo typedef
Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD.

Funciones
otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Esta función muestra los contadores del servidor DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Esta función adquiere la siguiente consulta en el servidor DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Esta función adquiere el tipo de consulta DNS-SD y el nombre de una consulta específica.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Esta función notifica a un host detectado.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Esta función notifica a una instancia de servicio descubierta.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Esta función establece devoluciones de llamada de consulta del servidor DNS-SD.

Structs
otDnssdCounters

Esta estructura contiene los contadores del servidor DNS-SD.

otDnssdHostInfo

Esta estructura representa información de un host detectado para una consulta de DNS-SD.

otDnssdServiceInstanceInfo

Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD.

Enumeraciones

Tipo de consulta otDssd

 otDnssdQueryType

En esta enumeración, se especifica un tipo de consulta de DNS-SD.

Properties
OT_DNSSD_QUERY_TYPE_BROWSE

Servicio de navegación por tipos de servicios.

OT_DNSSD_QUERY_TYPE_NONE

Tipo de servicio sin especificar.

OT_DNSSD_QUERY_TYPE_RESOLVE

El tipo de servicio resuelve la instancia de servicio.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

El tipo de servicio resuelve el nombre de host.

Typedefs

otDnssdCounters

struct otDnssdCounters otDnssdCounters

Esta estructura contiene los contadores del servidor DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Esta estructura representa información de un host detectado para una consulta de DNS-SD.

otDnssdQuery

void otDnssdQuery

Este tipo opaco representa una consulta de DNS-SD.

otDnssdQuerySubscribeCallback

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

Se llama a esta función cuando una consulta de DNS-SD se suscribe a una de las siguientes opciones:

  1. un nombre de servicio.
  2. el nombre de una instancia de servicio.
  3. un nombre de host

La implementación de la consulta DNS-SD es responsable de identificar qué es aFullName. Si aFullName es un nombre de servicio o nombre de instancia de servicio, la implementación de una consulta DNS-SD debería detectar la información de la instancia de servicio correspondiente y notificar al servidor DNS-SD con otDnssdQueryHandleDiscoveredServiceInstance. Si aFullName es un nombre de host, la implementación de la consulta DNS-SD debe detectar la información del host y notificar al servidor DNS-SD con otDnssdQueryHandleDiscoveredHost.

Detalles
Parámetros
[in] aContext
Un puntero al contexto específico de la aplicación.
[in] aFullName
El nombre completo del servicio anulado (p. ej., "_ipps._tcp,default.service.arpa.") o el nombre completo de la instancia del servicio (p. ej. "OpenThread._ipps._tcp.default.service.arpa.") o el nombre completo del host (p. ej., "ot-host.quot.service.arpa.
Consulta también:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryunsubscribeCallback

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

Se llama a esta función cuando una búsqueda de DNS-SD anula una de las siguientes opciones:

  1. un nombre de servicio.
  2. el nombre de una instancia de servicio.
  3. un nombre de host

La implementación de la consulta de DNS-SD es responsable de identificar qué es aFullName.

Detalles
Parámetros
[in] aContext
Un puntero al contexto específico de la aplicación.
[in] aFullName
El nombre completo del servicio anulado (p. ej., "_ipps._tcp,default.service.arpa.") o el nombre completo de la instancia de servicio (p. ej., "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Esta estructura representa información de una instancia de servicio descubierta para una consulta de DNS-SD.

Funciones

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Esta función muestra los contadores del servidor DNS-SD.

Detalles
Parámetros
[in] aInstance
Estructura de la instancia de OpenThread
Qué muestra
Un puntero para los contadores del servidor DNS-SD.

otDnssdGetNextQuery

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

Esta función adquiere la siguiente consulta en el servidor DNS-SD.

Detalles
Parámetros
[in] aInstance
Estructura de la instancia de OpenThread
[in] aQuery
El puntero de consulta Pasa NULL para obtener la primera consulta.
Qué muestra
Un puntero para la consulta o NULL si no hay más consultas.

otDnssdGetQueryTypeAndName

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

Esta función adquiere el tipo de consulta DNS-SD y el nombre de una consulta específica.

Detalles
Parámetros
[in] aQuery
El puntero de consulta adquirido de otDnssdGetNextQuery.
[out] aNameOutput
El búfer de salida del nombre, que debe tener OT_DNS_MAX_NAME_SIZE bytes.
Qué muestra
Es el tipo de consulta de DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Esta función notifica a un host detectado.

El agente de resolución de consultas externas (p.ej., el proxy de descubrimiento) debe llamar a esta función para notificar a OpenThread Core sobre los hosts a los que se suscribió.

Detalles
Parámetros
[in] aInstance
Estructura de la instancia de OpenThread
[in] aHostFullName
El nombre completo de host nulo.
[in] aHostInfo
Un puntero para la información de instancia de servicio descubierta.

otDnssdQueryHandleDiscoveredServiceInstance

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

Esta función notifica a una instancia de servicio descubierta.

El agente de resolución de consultas externas (p.ej., proxy de descubrimiento) debe llamar a esta función para notificar a OpenThread principal de los servicios a los que se suscribió o las instancias de servicio.

Detalles
Parámetros
[in] aInstance
Estructura de la instancia de OpenThread
[in] aServiceFullName
El nombre completo del servicio finalizado de forma nula.
[in] aInstanceInfo
Un puntero para la información de instancia de servicio descubierta.

otDnssdQuerySetCallbacks

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

Esta función establece devoluciones de llamada de consulta del servidor DNS-SD.

El servidor DNS-SD llama a aSubscribe a fin de suscribirse a un servicio o instancia de servicio para resolver una consulta de DNS-SD y a aUnsubscribe para anular la suscripción cuando se resuelve la consulta o se agota el tiempo de espera.

Detalles
Parámetros
[in] aInstance
Estructura de la instancia de OpenThread
[in] aSubscribe
Un puntero para la función de devolución de llamada para suscribir un servicio o una instancia de servicio
[in] aUnsubscribe
Un puntero para la función de devolución de llamada para anular la suscripción de un servicio o una instancia de servicio.
[in] aContext
Un puntero al contexto específico de la aplicación.

Recursos

Los temas de referencia de la API de OpenThread se originan en el código fuente, disponible en GitHub. Para obtener más información o colaborar con nuestra documentación, consulta Recursos.