DNS - Platform

Bu modül, yukarı akış DNS sunucularına yinelenen DNS sorgusu göndermek için kullanılan platform soyutlamasını içerir.

Özet

Türdefler
otPlatDnsUpstreamQuery typedef
Bu opak tür, yukarı akış DNS sorgu işlemini temsil eder.

İşlevler
otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Yukarı akış sorgusunun işlemini iptal eder.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Bir yukarı akış sorgu işlemi başlatır.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
Platform, DNS sorgusunu bitirmek için bu işlevi çağırır.

Türdefler

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Bu opak tür, yukarı akış DNS sorgu işlemini temsil eder.

İşlevler

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Yukarı akış sorgusunun işlemini iptal eder.

Kaynakları serbest bırakmak için platformun otPlatDnsUpstreamQueryDone yöntemini çağırması gerekir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örnek yapısı.
[in] aTxn
Opak DNS sorgu işlemi nesnesine işaret eden bir işaretçi.

otPlatDnsStartUpstreamQuery

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

Bir yukarı akış sorgu işlemi başlatır.

  • Başarı durumunda (ve DNS protokol mesajlarıyla temsil edilen hatalar) platformun otPlatDnsUpstreamQueryDone yöntemini çağırması beklenir.
  • OpenThread Core, otPlatDnsCancelUpstreamQuery işlevini çağırarak (muhtemelen zaman aşımı) sorgu işlemini iptal edebilir. Platform, iptal edilen bir işlemde otPlatDnsUpstreamQueryDone yöntemini çağırmamalıdır.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örnek yapısı.
[in] aTxn
Opak DNS sorgu işlemi nesnesine işaret eden bir işaretçi.
[in] aQuery
Yukarı akış DNS sunucusuna gönderilmesi gereken DNS yükünün mesaj arabelleği.

otPlatDnsUpstreamQueryDone

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

Platform, DNS sorgusunu bitirmek için bu işlevi çağırır.

İşlem iptal edileceği için platform aynı işlemi iki kez çağırmamalıdır. Bu işlev, aResponse öğesinin sahipliğini OpenThread yığınına aktarır.

Platform, yanıt olmadan bir işlemi kapatmak için bir nullptr geçirebilir.

Ayrıntılar
Parametreler
[in] aInstance
OpenThread örnek yapısı.
[in] aTxn
Opak DNS sorgu işlemi nesnesine işaret eden bir işaretçi.
[in] aResponse
DNS yanıt yükünün mesaj arabelleği veya yanıt olmadan bir işlemi kapatmak için nullptr.

Kaynaklar

OpenThread API Referans konuları, GitHub'da bulunan kaynak koddan gelir. Daha fazla bilgi edinmek veya dokümanlarımıza katkıda bulunmak için Kaynaklar bölümüne bakın.