Google is committed to advancing racial equity for Black communities. See how.
Cette page a été traduite par l'API Cloud Translation.
Switch to English

DNSv6

Ce module comprend des fonctions qui contrôlent la communication DNS.

Résumé

Typedefs

otDnsQuery typedef
struct otDnsQuery
Cette structure implémente les paramètres de requête DNS.
otDnsResponseHandler )(void *aContext, const char *aHostname, const otIp6Address *aAddress, uint32_t aTtl, otError aResult) typedef
void(*
Ce pointeur de fonction est appelé lorsqu'une réponse DNS est reçue.

Les fonctions

otDnsClientQuery ( otInstance *aInstance, const otDnsQuery *aQuery, otDnsResponseHandler aHandler, void *aContext)
Cette fonction envoie une requête DNS pour l'enregistrement AAAA (IPv6).

Structs

otDnsQuery

Cette structure implémente les paramètres de requête DNS.

Typedefs

otDnsQuery

struct otDnsQuery otDnsQuery

Cette structure implémente les paramètres de requête DNS.

otDnsResponseHandler

void(* otDnsResponseHandler)(void *aContext, const char *aHostname, const otIp6Address *aAddress, uint32_t aTtl, otError aResult)

Ce pointeur de fonction est appelé lorsqu'une réponse DNS est reçue.

Détails
Paramètres
[in] aContext
Un pointeur vers le contexte spécifique à l'application.
[in] aHostname
Identifie le nom d'hôte associé à la réponse DNS.
[in] aAddress
Un pointeur vers l'adresse IPv6 reçue dans la réponse DNS. Peut être nul.
[in] aTtl
Spécifie la durée maximale en secondes pendant laquelle l'enregistrement de ressource peut être mis en cache.
[in] aResult
Un résultat de la transaction DNS.
Valeurs de retour
OT_ERROR_NONE
Une réponse a été reçue avec succès et l'adresse IPv6 est fournie dans une aAddress .
OT_ERROR_ABORT
Une transaction DNS a été abandonnée par la pile.
OT_ERROR_RESPONSE_TIMEOUT
Aucune réponse DNS n'a été reçue dans le délai imparti.
OT_ERROR_NOT_FOUND
Une réponse a été reçue mais aucune adresse IPv6 n'a été trouvée.
OT_ERROR_FAILED
Une réponse a été reçue mais le code d'état est différent du succès.

Les fonctions

otDnsClientQuery

 otError otDnsClientQuery(
  otInstance *aInstance,
  const otDnsQuery *aQuery,
  otDnsResponseHandler aHandler,
  void *aContext
)

Cette fonction envoie une requête DNS pour l'enregistrement AAAA (IPv6).

Cette fonction n'est disponible que si la fonction OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE est activée.

Détails
Paramètres
[in] aInstance
Un pointeur vers une instance d'OpenThread.
[in] aQuery
Un pointeur pour spécifier les paramètres de requête DNS.
[in] aHandler
Pointeur de fonction qui doit être appelé à la réception de la réponse ou à l'expiration du délai.
[in] aContext
Un pointeur vers des informations contextuelles arbitraires.

Macros

OT_DNS_DEFAULT_SERVER_IP

 OT_DNS_DEFAULT_SERVER_IP "2001:4860:4860::8888"

Définit l'adresse du serveur DNS par défaut - Google DNS.

OT_DNS_DEFAULT_SERVER_PORT

 OT_DNS_DEFAULT_SERVER_PORT 53

Définit le port du serveur DNS par défaut.

OT_DNS_MAX_HOSTNAME_LENGTH

 OT_DNS_MAX_HOSTNAME_LENGTH 62

Longueur maximale autorisée du nom d'hôte (taille d'étiquette maximale - 1 pour la compression).