DNS – Plate-forme

Ce module inclut l'abstraction de la plate-forme permettant d'envoyer une requête DNS récursive aux serveurs DNS en amont.

Résumé

Typedefs
otPlatDnsUpstreamQuery typedef
Ce type opaque représente une transaction de requête DNS en amont.

distantes
otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Annule une transaction d'une requête en amont.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Démarre une transaction de requête en amont.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
La plate-forme appelle cette fonction pour terminer la requête DNS.

Typedefs

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Ce type opaque représente une transaction de requête DNS en amont.

distantes

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Annule une transaction d'une requête en amont.

La plate-forme doit appeler otPlatDnsUpstreamQueryDone pour libérer les ressources.

Détails
Paramètres
[in] aInstance
Structure de l'instance OpenThread.
[in] aTxn
Pointeur vers l'objet de transaction de requête DNS opaque.

otPlatDnsStartUpstreamQuery

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

Démarre une transaction de requête en amont.

  • En cas de réussite (et si les erreurs sont représentées par des messages de protocole DNS), la plate-forme doit appeler otPlatDnsUpstreamQueryDone.
  • Le cœur OpenThread peut annuler une transaction de requête (éventuellement expirée) en appelant otPlatDnsCancelUpstreamQuery. La plate-forme ne doit pas appeler otPlatDnsUpstreamQueryDone sur une transaction annulée.

Détails
Paramètres
[in] aInstance
Structure de l'instance OpenThread.
[in] aTxn
Pointeur vers l'objet de transaction de requête DNS opaque.
[in] aQuery
Tampon de messages de la charge utile DNS à envoyer au serveur DNS en amont.

otPlatDnsUpstreamQueryDone

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

La plate-forme appelle cette fonction pour terminer la requête DNS.

La transaction est libérée. La plate-forme ne doit donc pas appeler deux fois la même transaction. Cette fonction transmet la propriété de aResponse à la pile OpenThread.

La plate-forme peut transmettre un nullptr pour fermer une transaction sans réponse.

Détails
Paramètres
[in] aInstance
Structure de l'instance OpenThread.
[in] aTxn
Pointeur vers l'objet de transaction de requête DNS opaque.
[in] aResponse
Un tampon de message de la charge utile de réponse DNS ou nullptr pour fermer une transaction sans réponse.

Ressources

Les sujets de référence de l'API OpenThread proviennent du code source, disponible sur GitHub. Pour en savoir plus ou pour contribuer à notre documentation, consultez la section Ressources.