DNS – Nền tảng

Mô-đun này bao gồm tính năng trừu tượng nền tảng để gửi truy vấn DNS đệ quy đến các máy chủ DNS cấp trên.

Tóm tắt

Typedef
otPlatDnsUpstreamQuery typedef
Loại không rõ ràng này đại diện cho một giao dịch truy vấn DNS ngược dòng.

Hàm
otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Huỷ giao dịch của truy vấn ngược dòng.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Bắt đầu một giao dịch truy vấn ngược dòng.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
Nền tảng gọi hàm này để hoàn tất truy vấn DNS.

Typedef

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Loại không rõ ràng này đại diện cho một giao dịch truy vấn DNS ngược dòng.

Hàm

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Huỷ giao dịch của truy vấn ngược dòng.

Nền tảng phải gọi otPlatDnsUpstreamQueryDone để giải phóng các tài nguyên.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aTxn
Con trỏ đến đối tượng giao dịch truy vấn DNS mờ.

otPlatDnsStartUpstreamQuery

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

Bắt đầu một giao dịch truy vấn ngược dòng.

  • Trong trường hợp thành công (và lỗi được biểu thị trong thông báo giao thức DNS), nền tảng dự kiến sẽ gọi otPlatDnsUpstreamQueryDone.
  • Lõi OpenThread có thể huỷ một giao dịch truy vấn (có thể hết thời gian chờ) bằng cách gọi otPlatDnsCancelUpstreamQuery. Nền tảng không được gọi otPlatDnsUpstreamQueryDone trên giao dịch đã huỷ.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aTxn
Con trỏ đến đối tượng giao dịch truy vấn DNS mờ.
[in] aQuery
Vùng đệm thông báo của tải trọng DNS sẽ được gửi đến máy chủ DNS thượng nguồn.

otPlatDnsUpstreamQueryDone

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

Nền tảng gọi hàm này để hoàn tất truy vấn DNS.

Giao dịch này sẽ được phát hành, vì vậy, nền tảng không được gọi hai lần cho cùng một giao dịch. Hàm này chuyển quyền sở hữu của aResponse sang ngăn xếp OpenThread.

Nền tảng có thể truyền một giá trị nullptr để đóng giao dịch mà không cần phản hồi.

Thông tin chi tiết
Thông số
[in] aInstance
Cấu trúc thực thể OpenThread.
[in] aTxn
Con trỏ đến đối tượng giao dịch truy vấn DNS mờ.
[in] aResponse
Vùng đệm thông báo của tải trọng phản hồi DNS hoặc nullptr để đóng giao dịch mà không có phản hồi.

Tài nguyên

Các chủ đề tham khảo API OpenThread bắt nguồn từ mã nguồn, có trên GitHub. Để biết thêm thông tin hoặc để đóng góp cho tài liệu của chúng tôi, hãy tham khảo Tài nguyên.