Server DNS-SD

Questo modulo include API per server DNS-SD.

Riepilogo

Enumerazioni
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
Specifica un tipo di query DNS-SD.

Typedef
otDnssdCounters typedef
Contiene i contatori del server DNS-SD.
otDnssdHostInfo typedef
Rappresenta le informazioni di un host rilevato per una query DNS-SD.
otDnssdQuery typedef
void
Questo tipo opaco rappresenta una query DNS-SD.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Viene chiamato quando una query DNS-SD sottoscrive una delle seguenti informazioni:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Viene chiamato quando una query DNS-SD annulla l'iscrizione a uno dei seguenti elementi:
otDnssdServiceInstanceInfo typedef
Rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Funzioni
otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
Restituisce i contatori del server DNS-SD.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
Acquisisce la query successiva nel server DNS-SD.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
Acquisisce il tipo di query DNS-SD e il nome per una query specifica.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Invia una notifica a un host rilevato.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Invia una notifica a un'istanza di servizio rilevata.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Imposta i callback delle query del server DNS-SD.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)
bool
Indica se il server DNSSD inoltrerà le query DNS all'API upstream DNS della piattaforma.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)
void
Abilita o disabilita l'inoltro delle query DNS all'API upstream DNS della piattaforma.

Strutture
otDnssdCounters

Contiene i contatori del server DNS-SD.

otDnssdHostInfo

Rappresenta le informazioni di un host rilevato per una query DNS-SD.

otDnssdServiceInstanceInfo

Rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Enumerazioni

otDnssdQueryType

 otDnssdQueryType

Specifica un tipo di query DNS-SD.

Proprietà
OT_DNSSD_QUERY_TYPE_BROWSE

Servizio di consultazione dei tipi di servizio.

OT_DNSSD_QUERY_TYPE_NONE

Tipo di servizio non specificato.

OT_DNSSD_QUERY_TYPE_RESOLVE

Il tipo di servizio risolve l'istanza di servizio.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Nome host del tipo di servizio per la risoluzione.

Typedef

otDnssdCounters

struct otDnssdCounters otDnssdCounters

Contiene i contatori del server DNS-SD.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

Rappresenta le informazioni di un host rilevato per una query DNS-SD.

otDnssdQuery

void otDnssdQuery

Questo tipo opaco rappresenta una query DNS-SD.

otDnssdQuerySubscribeCallback

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

Viene chiamato quando una query DNS-SD sottoscrive una delle seguenti informazioni:

  1. il nome di un servizio.
  2. un nome di istanza di servizio.
  3. un nome host.

L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName. Se aFullName è un nome di servizio o un nome di istanza di servizio, l'implementazione della query DNS-SD deve rilevare le informazioni sull'istanza di servizio corrispondenti e inviare una notifica al server DNS-SD utilizzando otDnssdQueryHandleDiscoveredServiceInstance. Se aFullName è un nome host, l'implementazione della query DNS-SD deve rilevare le informazioni sull'host e inviare una notifica al server DNS-SD utilizzando otDnssdQueryHandleDiscoveredHost.

Dettagli
Parametri
[in] aContext
Un puntatore al contesto specifico dell'applicazione.
[in] aFullName
Il nome completo del servizio con terminazione null (ad es. "_ipps._tcp.default.service.arpa."), il nome completo dell'istanza del servizio (ad es. "OpenThread._ipps._tcp.default.service.arpa.") o il nome host completo (ad es. "ot-host.default.service.arpa.").
Vedi anche:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

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

Viene chiamato quando una query DNS-SD annulla l'iscrizione a uno dei seguenti elementi:

  1. il nome di un servizio.
  2. un nome di istanza di servizio.
  3. un nome host.

L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName.

Dettagli
Parametri
[in] aContext
Un puntatore al contesto specifico dell'applicazione.
[in] aFullName
Il nome completo del servizio con terminazione null (ad es. "_ipps._tcp.default.service.arpa.") o il nome completo dell'istanza di servizio (ad es. "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

Rappresenta le informazioni di un'istanza di servizio rilevata per una query DNS-SD.

Funzioni

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

Restituisce i contatori del server DNS-SD.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
Restituisce
Un puntatore ai contatori del server DNS-SD.

otDnssdGetNextQuery

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

Acquisisce la query successiva nel server DNS-SD.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aQuery
Il puntatore della query. Passa NULL per ottenere la prima query.
Restituisce
Un puntatore alla query o NULL se non ci sono altre query.

otDnssdGetQueryTypeAndName

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

Acquisisce il tipo di query DNS-SD e il nome per una query specifica.

Dettagli
Parametri
[in] aQuery
Il puntatore alla query acquisito da otDnssdGetNextQuery.
[out] aNameOutput
Il buffer di output del nome, che dovrebbe essere di OT_DNS_MAX_NAME_SIZE byte.
Restituisce
Il tipo di query DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Invia una notifica a un host rilevato.

Il resolver di query esterno (ad es. Discovery Proxy) deve chiamare questa funzione per notificare al core OpenThread gli host sottoscritti.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aHostFullName
Il nome host completo con terminazione null.
[in] aHostInfo
Un puntatore alle informazioni sull'istanza di servizio rilevata.

otDnssdQueryHandleDiscoveredServiceInstance

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

Invia una notifica a un'istanza di servizio rilevata.

Il resolver di query esterno (ad esempio Discovery Proxy) deve chiamare questa funzione per notificare a OpenThread core i servizi o le istanze di servizio in abbonamento.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aServiceFullName
Il nome completo del servizio con terminazione null.
[in] aInstanceInfo
Un puntatore alle informazioni sull'istanza di servizio rilevata.

otDnssdQuerySetCallbacks

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

Imposta i callback delle query del server DNS-SD.

Il server DNS-SD chiama aSubscribe per iscriversi a un servizio o un'istanza di servizio per risolvere una query DNS-SD e aUnsubscribe per annullare l'iscrizione quando la query viene risolta o timeout.

Dettagli
Parametri
[in] aInstance
La struttura dell'istanza OpenThread.
[in] aSubscribe
Un puntatore alla funzione di callback per sottoscrivere un abbonamento a un servizio o a un'istanza di servizio.
[in] aUnsubscribe
Un puntatore alla funzione di callback per annullare l'iscrizione di un servizio o un'istanza di servizio.
[in] aContext
Un puntatore al contesto specifico dell'applicazione.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

Indica se il server DNSSD inoltrerà le query DNS all'API upstream DNS della piattaforma.

Disponibile quando OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE è abilitato.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
Valori restituiti
TRUE
Se il server DNSSD inoltrerà le query DNS.
FALSE
Se il server DNSSD non inoltra query DNS.
Vedi anche:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

Abilita o disabilita l'inoltro delle query DNS all'API upstream DNS della piattaforma.

Disponibile quando OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE è abilitato.

Dettagli
Parametri
[in] aInstance
Un puntatore a un'istanza OpenThread.
[in] aEnabled
Un valore booleano per abilitare/disabilitare l'inoltro delle query DNS all'upstream.
Vedi anche:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

Risorse

Gli argomenti di riferimento dell'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per saperne di più o per contribuire alla nostra documentazione, consulta la sezione Risorse.