DNS – Plattform

Dieses Modul enthält die Plattformabstraktion zum Senden rekursiver DNS-Abfragen an vorgelagerte DNS-Server.

Zusammenfassung

Typedefs
`otPlatDnsUpstreamQuery`	typedef `struct otPlatDnsUpstreamQuery` Dieser intransparente Typ steht für eine vorgelagerte DNS-Abfragetransaktion.

Funktionen
`otPlatDnsCancelUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn)`	`void` Bricht eine Transaktion einer vorgelagerten Abfrage ab.
`otPlatDnsStartUpstreamQuery(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, const otMessage *aQuery)`	`void` Startet eine Upstream-Abfragetransaktion.
`otPlatDnsUpstreamQueryDone(otInstance aInstance, otPlatDnsUpstreamQuery aTxn, otMessage *aResponse)`	`void` Die Plattform ruft diese Funktion auf, um die DNS-Abfrage abzuschließen.

Typedefs

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Dieser intransparente Typ steht für eine vorgelagerte DNS-Abfragetransaktion.

Funktionen

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Bricht eine Transaktion einer vorgelagerten Abfrage ab.

Die Plattform muss otPlatDnsUpstreamQueryDone aufrufen, um die Ressourcen freizugeben.

Details

Parameter

`[in] aInstance`	Die OpenThread-Instanzstruktur.
`[in] aTxn`	Ein Zeiger auf das intransparente DNS-Abfragetransaktionsobjekt.

otPlatDnsStartUpstreamQuery

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

Startet eine Upstream-Abfragetransaktion.

Im Erfolgsfall (und bei Fehlern, die durch DNS-Protokollnachrichten dargestellt werden), wird erwartet, dass die Plattform otPlatDnsUpstreamQueryDone aufruft.
Der OpenThread-Kern kann eine Abfragetransaktion (möglicherweise Zeitüberschreitung) durch Aufrufen von otPlatDnsCancelUpstreamQuery abbrechen. Die Plattform darf otPlatDnsUpstreamQueryDone bei einer abgebrochenen Transaktion nicht aufrufen.

Details

Parameter

`[in] aInstance`	Die OpenThread-Instanzstruktur.
`[in] aTxn`	Ein Zeiger auf das intransparente DNS-Abfragetransaktionsobjekt.
`[in] aQuery`	Ein Nachrichtenpuffer der DNS-Nutzlast, die an den Upstream-DNS-Server gesendet werden soll.

otPlatDnsUpstreamQueryDone

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

Die Plattform ruft diese Funktion auf, um die DNS-Abfrage abzuschließen.

Die Transaktion wird freigegeben, sodass die Plattform dieselbe Transaktion nicht zweimal aufrufen darf. Diese Funktion übergibt die Eigentümerschaft von aResponse an den OpenThread-Stack.

Die Plattform kann einen Nullptr-Wert übergeben, um eine Transaktion ohne Antwort zu schließen.

Details

Parameter

`[in] aInstance`	Die OpenThread-Instanzstruktur.
`[in] aTxn`	Ein Zeiger auf das intransparente DNS-Abfragetransaktionsobjekt.
`[in] aResponse`	Ein Nachrichtenpuffer der DNS-Antwortnutzlast oder `nullptr` zum Schließen einer Transaktion ohne Antwort.

Ressourcen

OpenThread API-Referenzthemen stammen aus dem Quellcode, der auf GitHub verfügbar ist. Weitere Informationen finden Sie unter Ressourcen. Dort können Sie auch einen Beitrag zu unserer Dokumentation leisten.