Server DNS-SD
Questo modulo include API per il server DNS-SD.
Riepilogo
Enumerazioni |
|
---|---|
otDnssdQueryType{
|
enum Specifica un tipo di query DNS-SD. |
Definizione di tipo |
|
---|---|
otDnssdCounters
|
typedefstruct otDnssdCounters
Contiene i contatori del server DNS-SD. |
otDnssdHostInfo
|
typedefstruct otDnssdHostInfo
Rappresenta le informazioni di un host rilevato per una query DNS-SD. |
otDnssdQuery
|
typedefvoid
Questo tipo opaco rappresenta una query DNS-SD. |
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
Viene richiamato quando una query DNS-SD sottoscrive uno dei seguenti elementi: |
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
Viene richiamato quando una query DNS-SD annulla una delle seguenti azioni: |
otDnssdServiceInstanceInfo
|
typedefstruct otDnssdServiceInstanceInfo
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
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:
- un nome di servizio.
- un nome di istanza di servizio.
- 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 |
|
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost
otDnssdQueryAnnulla iscrizionechiamata
void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
Viene richiamato quando una query DNS-SD annulla una delle seguenti azioni:
- un nome di servizio.
- un nome di istanza di servizio.
- un nome host.
L'implementazione della query DNS-SD è responsabile dell'identificazione di aFullName
.
Dettagli | |||||
---|---|---|---|---|---|
Parametri |
|
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 |
|
||
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 |
|
||||
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 |
|
||||
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 |
|
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 |
|
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 |
|
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 |
|
||||
Valori restituiti |
|
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 |
|
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.