Server DNS-SD

Questo modulo include API per il 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.

Definizione di tipo

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 richiamato quando una query DNS-SD sottoscrive uno dei seguenti elementi:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
Viene richiamato quando una query DNS-SD annulla una delle seguenti azioni:
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 nome e il tipo di query DNS-SD per una query specifica.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
Informa un host rilevato.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
Indica un'istanza di servizio rilevata.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
Imposta callback query server DNS-SD.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)
bool
Indica se il server DNSSD inoltrerà le query DNS all'API DNS upstream della piattaforma.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)
void
Abilita o disabilita l'inoltro delle query DNS all'API DNS upstream 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

Tipo query otDnssd

 otDnssdQueryType

Specifica un tipo di query DNS-SD.

Proprietà
OT_DNSSD_QUERY_TYPE_BROWSE

Tipo di servizio: servizio di consultazione.

OT_DNSSD_QUERY_TYPE_NONE

Tipo di servizio non specificato.

OT_DNSSD_QUERY_TYPE_RESOLVE

Tipo di servizio per risolvere l'istanza di servizio.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

Il tipo di servizio risolve il nome host.

Definizione di tipo

Contatori otDnssd

struct otDnssdCounters otDnssdCounters

Contiene i contatori del server DNS-SD.

Informazioni otDnssdHost

struct otDnssdHostInfo otDnssdHostInfo

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

Query otDnssd

void otDnssdQuery

Questo tipo opaco rappresenta una query DNS-SD.

otDnssdQueryIscrivitiChiamataback

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

Viene richiamato quando una query DNS-SD sottoscrive uno dei seguenti elementi:

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

L'implementazione della query DNS-SD è responsabile di identificare cos'è aFullName. Se aFullName è il nome di un servizio o di un'istanza di servizio, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'istanza di servizio corrispondente e notificare il server DNS-SD utilizzando otDnssdQueryHandleDiscoveredServiceInstance. Se aFullName è un nome host, l'implementazione della query DNS-SD dovrebbe scoprire le informazioni sull'host e notificare al server DNS-SD utilizzando otDnssdQueryHandleDiscoveredHost.

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

otDnssdQueryAnnulla iscrizionechiamata

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

Viene richiamato quando una query DNS-SD annulla una delle seguenti azioni:

  1. un nome di 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 terminato dal valore null (ad es. "_ipps._tcp.default.service.arpa.") o il nome completo dell'istanza di servizio (ad es. "OpenThread._ipps._tcp.default.service.arpa").

Informazioni su otDnssdServiceInstance

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
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
Struttura dell'istanza OpenThread.
[in] aQuery
Il puntatore della query Supera NULL per ricevere la prima query.
Restituisce
Un puntatore alla query o NULL se non ci sono più query.

Nome OtDnssdGetQueryTypeAndName

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

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

Dettagli
Parametri
[in] aQuery
Il puntatore della query è stato acquisito da otDnssdGetNextQuery.
[out] aNameOutput
Il buffer di output del nome, che deve contenere OT_DNS_MAX_NAME_SIZE byte.
Restituisce
Il tipo di query DNS-SD.

otDnssdQueryHandleDiscoveredHost

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

Informa un host rilevato.

Il resolver query esterna (ad es. il proxy Discovery) deve chiamare questa funzione per inviare una notifica al core OpenThread degli host a cui è stato sottoscritto l'abbonamento.

Dettagli
Parametri
[in] aInstance
Struttura dell'istanza OpenThread.
[in] aHostFullName
Il nome host completo con null.
[in] aHostInfo
Un puntatore sulle informazioni dell'istanza di servizio rilevate.

OtDnssdQueryHandleDiscoveredServiceInstance

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

Indica un'istanza di servizio rilevata.

Il resolver query esterna (ad esempio Discovery Proxy) deve chiamare questa funzione per inviare una notifica ai core OpenThread dei servizi o delle istanze di servizio a cui è stato sottoscritto l'abbonamento.

Dettagli
Parametri
[in] aInstance
Struttura dell'istanza OpenThread.
[in] aServiceFullName
Il nome completo del servizio con terminazione null.
[in] aInstanceInfo
Un puntatore sulle informazioni dell'istanza di servizio rilevate.

OtDnssdQuerySetCallbacks

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

Imposta callback query server DNS-SD.

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

Dettagli
Parametri
[in] aInstance
Struttura dell'istanza OpenThread.
[in] aSubscribe
Un puntatore sulla funzione di callback per iscrivere un servizio o un'istanza di servizio.
[in] aUnsubscribe
Un cursore sulla funzione di callback per annullare l'iscrizione a 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 DNS upstream della piattaforma.

Disponibile quando viene attivata l'opzione OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE.

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

OtDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

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

Disponibile quando viene attivata l'opzione OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE.

Dettagli
Parametri
[in] aInstance
Un puntatore su 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 per l'API OpenThread provengono dal codice sorgente, disponibile su GitHub. Per maggiori informazioni o per contribuire alla nostra documentazione, consulta Risorse.