DNS - Platform

Modul ini mencakup abstraksi platform untuk mengirim kueri DNS rekursif ke server DNS upstream.

Ringkasan

Typedef

otPlatDnsUpstreamQuery typedef
Jenis buram ini mewakili transaksi kueri DNS upstream.

Fungsi

otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Membatalkan transaksi kueri upstream.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Memulai transaksi kueri upstream.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
Platform memanggil fungsi ini untuk menyelesaikan kueri DNS.

Typedef

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Jenis buram ini mewakili transaksi kueri DNS upstream.

Fungsi

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Membatalkan transaksi kueri upstream.

Platform harus memanggil otPlatDnsUpstreamQueryDone untuk melepaskan resource.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aTxn
Pointer ke objek transaksi kueri DNS buram.

otPlatDnsStartUpstreamQuery

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

Memulai transaksi kueri upstream.

  • Dalam kasus berhasil (dan error yang ditunjukkan oleh pesan protokol DNS), platform diharapkan memanggil otPlatDnsUpstreamQueryDone.
  • Inti OpenThread dapat membatalkan transaksi kueri (mungkin waktu tunggu) dengan memanggil otPlatDnsCancelUpstreamQuery, platform tidak boleh memanggil otPlatDnsUpstreamQueryDone pada transaksi yang dibatalkan.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aTxn
Pointer ke objek transaksi kueri DNS buram.
[in] aQuery
Buffer pesan payload DNS yang harus dikirim ke server DNS upstream.

otPlatDnsUpstreamQueryDone

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

Platform memanggil fungsi ini untuk menyelesaikan kueri DNS.

Transaksi akan dilepaskan, sehingga platform tidak boleh memanggil transaksi yang sama dua kali. Fungsi ini meneruskan kepemilikan aResponse ke stack OpenThread.

Platform dapat meneruskan nullptr untuk menutup transaksi tanpa respons.

Detail
Parameter
[in] aInstance
Struktur instance OpenThread.
[in] aTxn
Pointer ke objek transaksi kueri DNS buram.
[in] aResponse
Buffer pesan payload respons DNS atau nullptr untuk menutup transaksi tanpa respons.

Referensi

Topik Referensi OpenThread API berasal dari kode sumber yang tersedia di GitHub. Untuk informasi selengkapnya, atau untuk berkontribusi pada dokumentasi kami, lihat Referensi.