DNSv6

Questo tipo di enumerazione rappresenta la modalità NAT64 in un otDnsQueryConfig.

La modalità NAT64 indica se consentire o meno la traduzione degli indirizzi NAT64 durante la risoluzione degli indirizzi del client DNS. Questa modalità viene utilizzata soltanto quando la funzionalità OPENTHREAD_CONFIG_DNS_CLIENT_NAT64_ENABLE è attiva.

Questo tipo di enumerazione rappresenta il flag "Recursion Desired" (RD) in un elemento otDnsQueryConfig.

Questo puntatore di funzione viene chiamato quando si riceve una risposta DNS per una query di risoluzione dell'indirizzo.

In questo callback l'utente può usare le funzioni otDnsAddressResponseGet{Item}() insieme al puntatore aResponse per ottenere ulteriori informazioni sulla risposta.

Il puntatore aResponse può essere utilizzato solo all'interno di questo callback e, dopo il ripristino da questa funzione, non rimarrà valido, quindi l'utente NON DEVE conservare il puntatore aResponse per l'utilizzo successivo.

aError può avere quanto segue:

• OT_ERROR_NONE È stata ricevuta una risposta.
• OT_ERROR_ABORT Una transazione DNS è stata interrotta per stack.
• OT_ERROR_ANSWER_TIMEOUT Nessuna risposta DNS ricevuta entro il timeout.

Se il server rifiuta la richiesta di risoluzione dell'indirizzo, il codice di errore del server è mappato nel seguente modo:

• (0) NOERROR riuscito (nessuna condizione di errore) -> OT_ERROR_NONE
• (1) Il server FORMERR non è in grado di interpretare a causa di un errore di formato -> OT_ERROR_PARSE
• (2) Il server SERVFAIL ha riscontrato un errore interno -> OT_ERROR_FAILED
• (3) Nome NXDOMAIN che deve esistere, non esiste -> OT_ERROR_NOT_FOUND
• (4) Il server NOTIMP non supporta il tipo di query (OpCode) -> OT_ERROR_NOT_IMPLEENTED
• (5) Server REFUSED rifiutato per motivi di sicurezza/criterio -> OT_ERROR_Sicurezza.
• (6) YXDOMAIN Nome che non doveva esistere, esiste -> OT_ERROR_DUPLICATED
• (7) YXRRSET Alcune RRset che non dovrebbero esistere, esistono -> OT_ERROR_DUPLICATED
• (8) NXRRSET Alcune RRset che dovrebbero esistere, non esistono -> OT_ERROR_NOT_FOUND
• (9) Il servizio NOTAUTH non è autorevole per la zona -> OT_ERROR_Safety
• (10) NOTZONE Un nome non è presente nella zona -> OT_ERROR_PARSE
• (20) BADNAME Nome errato -> OT_ERROR_PARSE
• (21) Algoritmo BADALG non valido -> OT_ERROR_security
• (22) BADTRUN Troncamento non valido -> OT_ERROR_PARSE
• Altri codici di risposta -> OT_ERROR_FAILED

Questo tipo è una rappresentazione opaca di una risposta a una query DNS di risoluzione degli indirizzi.

Gli utenti che puntano a un'istanza di questo tipo vengono forniti dal callback otDnsAddressCallback.

Questo puntatore a funzione viene chiamato quando viene ricevuta una risposta DNS per una query di esplorazione (enumerazione di istanza di servizio).

In questo callback l'utente può usare le funzioni otDnsBrowseResponseGet{Item}() insieme al puntatore aResponse per ottenere ulteriori informazioni sulla risposta.

Il puntatore aResponse può essere utilizzato solo all'interno di questo callback e, dopo il ripristino da questa funzione, non rimarrà valido, quindi l'utente NON DEVE conservare il puntatore aResponse per l'utilizzo successivo.

Per l'elenco completo dei valori possibili per aError, consulta otDnsAddressCallback().

Questo tipo è una rappresentazione opaca di una risposta a una query DNS di consultazione (enumerazione di istanze di servizio).

Gli utenti che puntano a un'istanza di questo tipo vengono forniti dal callback otDnsBrowseCallback.

Questa struttura rappresenta una configurazione di query DNS.

I campi in questa struttura possono essere impostati su zero per indicare che non è specificato. Il modo in cui vengono trattati i campi non specificati è determinato dalla funzione che utilizza l'istanza di otDnsQueryConfig.

Questo puntatore di funzione viene chiamato quando viene ricevuta una risposta DNS per una query di risoluzione dell'istanza di servizio.

In questo callback l'utente può usare le funzioni otDnsServiceResponseGet{Item}() insieme al puntatore aResponse per ottenere ulteriori informazioni sulla risposta.

Il puntatore aResponse può essere utilizzato solo all'interno di questo callback e, dopo il ripristino da questa funzione, non rimarrà valido, quindi l'utente NON DEVE conservare il puntatore aResponse per l'utilizzo successivo.

Per l'elenco completo dei valori possibili per aError, consulta otDnsAddressCallback().

Questa struttura fornisce informazioni per un'istanza di servizio DNS.

Questo tipo è una rappresentazione opaca di una risposta a una query DNS di risoluzione delle istanze di servizio.

Gli utenti che puntano a un'istanza di questo tipo vengono forniti dal callback otDnsAddressCallback.

Questa struttura rappresenta una voce di record TXT che rappresenta una coppia chiave/valore (RFC 6763 - sezione 6.3).

I buffer di stringa a cui puntano mKey e mValue DEVONO rimanere invariati e rimanere invariati dopo un'istanza di tale struttura a OpenThread (come parte dell'istanza otSrpClientService).

In otSrpClientService viene utilizzato un array di voci otDnsTxtEntry per specificare il record TXT completo (un elenco di voci).

Questa struttura rappresenta un iteratore per interi record TXT (coppie chiave/valore).

I campi di dati in questa struttura sono destinati a essere utilizzati dal core di OpenThread e il chiamante non deve leggerli o modificarli.

Questa funzione riceve un indirizzo IPv6 associato a una risposta DNS di risoluzione dell'indirizzo.

Questa funzione DEVE essere utilizzata solo da otDnsAddressCallback.

La risposta può includere più record di indirizzi IPv6. aIndex può essere utilizzato per eseguire l'iterazione nell'elenco degli indirizzi. L'indice zero ottiene il primo indirizzo e così via. Quando raggiungiamo la fine dell'elenco, OT_ERROR_NOT_FOUND viene restituito.

Questa funzione consente di ottenere il nome host completo associato a una risposta DNS di risoluzione dell'indirizzo.

Questa funzione DEVE essere utilizzata solo da otDnsAddressCallback.

Questa funzione recupera l'indirizzo IPv6 dell'host da una risposta di navigazione DNS (enumerazione di istanze di servizio).

Questa funzione DEVE essere utilizzata solo da otDnsBrowseCallback.

La risposta può includere zero o più record di indirizzi IPv6. aIndex può essere utilizzato per eseguire l'iterazione nell'elenco degli indirizzi. L'indice zero ottiene il primo indirizzo e così via. Quando raggiungiamo la fine dell'elenco, OT_ERROR_NOT_FOUND viene restituito.

Questa funzione riceve informazioni per un'istanza di servizio da una risposta DNS Sfoglia (enumerazione di istanze di servizio).

Questa funzione DEVE essere utilizzata solo da otDnsBrowseCallback.

Una risposta DNS di navigazione deve includere i record SRV, TXT e AAAA per le istanze di servizio enumerate (tieni presente che si tratta di un requisito DEVE e non DEVE). Questa funzione tenta di recuperare queste informazioni per una determinata istanza di servizio, quando disponibile.

• Se in aResponse non viene trovato alcun record SRV corrispondente, viene restituito OT_ERROR_NOT_FOUND.
• Se in aResponse viene rilevato un record SRV corrispondente, il valore aServiceInfo viene aggiornato e viene restituito OT_ERROR_NONE.
• Se non viene trovato alcun record TXT corrispondente in aResponse, il criterio mTxtDataSize in aServiceInfo è impostato su zero.
• Se non viene trovato alcun record AAAA corrispondente a aResponse, mHostAddress is set to all zero or unspecified address.
• If there are multiple AAAA records for the host name in @p aResponse,mHostAddressis set to the first one. The other addresses can be retrieved usingotDnsBrowseResponseGetHostAddress()`

Questa funzione ottiene un'istanza di servizio associata a una risposta DNS di navigazione (enumerazione di istanze di servizio).

Questa funzione DEVE essere utilizzata solo da otDnsBrowseCallback.

La risposta potrebbe includere più record di istanza di servizio. aIndex può essere utilizzato per eseguire iterazioni nell'elenco. L'indice zero fornisce il primo record. Quando raggiungiamo la fine dell'elenco, OT_ERROR_NOT_FOUND viene restituito.

Tieni presente che questa funzione recupera l'etichetta dell'istanza di servizio e non il nome completo dell'istanza di servizio, che è nel formato ...

Questa funzione consente di ottenere il nome del servizio associato a una risposta di navigazione DNS (enumerazione di istanze di servizio).

Questa funzione DEVE essere utilizzata solo da otDnsBrowseCallback.

Questa funzione invia una query DNS browse (enumerazione istanza di servizio) per un determinato nome di servizio.

Questa funzione è disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE è abilitato.

aConfig può essere NULL. In questo caso, per questa query verrà utilizzata la configurazione predefinita (da otDnsClientGetDefaultConfig()). In un aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

Questa funzione ottiene la configurazione di query predefinita corrente utilizzata dal client DNS.

Quando inizia lo stack OpenThread, la configurazione della query DNS predefinita viene determinata da un set di opzioni di configurazione OT come OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS, _DEFAULT_SERVER_PORT, _DEFAULT_RESPONSE_TIMEOUT e così via (vedi config/dns_client.h per tutte le opzioni di configurazione correlate) ,

Questa funzione invia una query DNS di risoluzione degli indirizzi per i record AAAA (IPv6) per un determinato nome host.

aConfig può essere NULL. In questo caso, per questa query verrà utilizzata la configurazione predefinita (da otDnsClientGetDefaultConfig()). In un aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

Questa funzione invia una query DNS di risoluzione degli indirizzi per i record A (IPv4) per un determinato nome host.

Questa funzione richiede ed è disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_NAT64_ENABLE è abilitato.

Quando si riceve una risposta corretta, gli indirizzi vengono restituiti da aCallback come versioni IPv6 tradotte degli indirizzi IPv6 della risposta alla query.

aConfig può essere NULL. In questo caso, per questa query verrà utilizzata la configurazione predefinita (da otDnsClientGetDefaultConfig()). In un aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

Questa funzione invia una query di risoluzione dell'istanza di servizio DNS per una determinata istanza di servizio.

Questa funzione è disponibile quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE è abilitato.

aConfig può essere NULL. In questo caso, per questa query verrà utilizzata la configurazione predefinita (da otDnsClientGetDefaultConfig()). In un aConfig non NULL, alcuni campi possono essere lasciati non specificati (valore zero). I campi non specificati vengono quindi sostituiti dai valori della configurazione predefinita.

Questa funzione imposta la configurazione della query predefinita sul client DNS.

Nota: per qualsiasi query in corso continuerà a essere utilizzata la configurazione dall'avvio. La nuova configurazione predefinita verrà utilizzata per le query DNS future. aConfig può essere NULL. In questo caso, la configurazione predefinita sarà impostata sui valori predefiniti delle opzioni di configurazione OT OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{}. Questa operazione reimposta la configurazione di query predefinita sulla configurazione precedente all'avvio dello stack OpenThread.

In un aConfig non NULL, il chiamante può scegliere di lasciare alcuni dei campi dell'istanza otDnsQueryConfig non specificati (valore zero). I campi non specificati vengono sostituiti dalle definizioni delle opzioni di configurazione OT corrispondenti OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} per formare la configurazione della query predefinita.

Quando la funzionalità OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE è attiva, l'indirizzo IPv6 del server nella configurazione predefinita viene impostato e aggiornato automaticamente dal client DNS. Questo viene eseguito solo quando l'utente non lo imposta o non lo specifica esplicitamente. Questo comportamento richiede l'attivazione del client SRP e della relativa funzionalità di avvio automatico. Il client SRP monitorerà quindi i dati di rete di Thread per le voci di servizio DNS/SRP per selezionare un server SRP. L'indirizzo del server SRP selezionato è impostato anche come indirizzo del server DNS nella configurazione predefinita.

Questa funzione analizza i dati TXT di un iteratore e recupera la successiva voce del record TXT (coppia chiave/valore).

aIterator deve essere inizializzato utilizzando otDnsInitTxtEntryIterator() prima di chiamare questa funzione e il buffer di dati TXT utilizzato per inizializzare l'iteratore DEVE essere mantenuto e rimanere invariato. In caso contrario, il comportamento di questa funzione non è definito.

Se la lunghezza della stringa di chiave analizzata è inferiore o uguale a OT_DNS_TXT_KEY_MAX_LENGTH (lunghezza massima consigliata per la chiave), la stringa di chiavi viene restituita in mKey in aEntry. Tuttavia, se la chiave è più lunga, mKey è impostato su NULL e l'intera stringa di voce TXT codificata viene restituita in mValue e mValueLength.

Questa funzione inizializza un iteratore dei record TXT.

Il puntatore del buffer aTxtData e i suoi contenuti DEVONO rimanere e rimanere invariati durante l'utilizzo dell'oggetto aIterator.

Questa funzione indica se la modalità "Compressione dei nomi DNS" è attiva o meno.

Questa funzionalità è destinata esclusivamente ai test e disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Questa funzione recupera l'indirizzo IPv6 dell'host da una risposta di risoluzione dell'istanza del servizio DNS.

Questa funzione DEVE essere utilizzata solo da otDnsServiceCallback.

La risposta può includere zero o più record di indirizzi IPv6. aIndex può essere utilizzato per eseguire l'iterazione nell'elenco degli indirizzi. L'indice zero ottiene il primo indirizzo e così via. Quando raggiungiamo la fine dell'elenco, OT_ERROR_NOT_FOUND viene restituito.

Questa funzione riceve informazioni per un'istanza di servizio da una risposta di risoluzione dell'istanza di servizio DNS.

Questa funzione DEVE essere utilizzata solo da otDnsServiceCallback.

• Se in aResponse non viene trovato alcun record SRV corrispondente, viene restituito OT_ERROR_NOT_FOUND.
• Se in aResponse viene rilevato un record SRV corrispondente, il valore aServiceInfo viene aggiornato e viene restituito OT_ERROR_NONE.
• Se non viene trovato alcun record TXT corrispondente in aResponse, il criterio mTxtDataSize in aServiceInfo è impostato su zero.
• Se non viene trovato alcun record AAAA corrispondente a aResponse, mHostAddress is set to all zero or unspecified address.
• If there are multiple AAAA records for the host name in @p aResponse,mHostAddressis set to the first one. The other addresses can be retrieved usingotDnsServiceResponseGetHostAddress()`.

Questa funzione consente di ottenere il nome dell'istanza di servizio associato a una risposta di risoluzione dell'istanza di servizio DNS.

Questa funzione DEVE essere utilizzata solo da otDnsServiceCallback.

Questa funzione attiva/disattiva la modalità "Compressione dei nomi DNS".

Per impostazione predefinita, la compressione del nome DNS è abilitata. Quando è disattivata, i nomi DNS vengono aggiunti come completi e non vengono mai compressi. Questo vale per i moduli DNS/SRP client/server di OpenThread.

Questa funzionalità è destinata esclusivamente ai test e disponibile quando è abilitata la configurazione di OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE.

Tieni presente che nel caso in cui venga utilizzato OPENTHREAD_CONFIG_MULTIPLE_INSTANCE_ENABLE, questa modalità si applica a tutte le istanze OpenThread, ovvero la chiamata a questa funzione attiva/disattiva la modalità di compressione su tutte le istanze OpenThread.

Dimensione massima della stringa dell'etichetta (includi il carattere null alla fine della stringa).

Dimensione massima della stringa del nome (include caratteri null alla fine della stringa).

Lunghezza massima consigliata della stringa di chiavi record TXT (RFC 6763 - sezione 6.4).

Lunghezza minima della stringa di chiavi del record TXT (RFC 6763 - sezione 6.4).