Google is committed to advancing racial equity for Black communities. See how.
इस पेज का अनुवाद Cloud Translation API से किया गया है.
Switch to English

DNSv6

इस मॉड्यूल में डीएनएस संचार को नियंत्रित करने वाले कार्य शामिल हैं।

सारांश

इस मॉड्यूल में फ़ंक्शन केवल तभी उपलब्ध होते हैं जब सुविधा OPENTHREAD_CONFIG_DNS_CLIENT_ENABLE सक्षम होती है।

गणना

otDnsRecursionFlag {
OT_DNS_FLAG_UNSPECIFIED = 0,
OT_DNS_FLAG_RECURSION_DESIRED = 1,
OT_DNS_FLAG_NO_RECURSION = 2
}
एनम
यह गणन प्रकार एक otDnsQueryConfig में "रिकर्सन otDnsQueryConfig " (RD) ध्वज का otDnsQueryConfig

टंकण

otDnsAddressCallback )(otError aError, const otDnsAddressResponse *aResponse, void *aContext) टंकण
void(*
यह फ़ंक्शन पॉइंटर तब कहा जाता है जब एक एड्रेस रिज़ॉल्यूशन क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।
otDnsAddressResponse टंकण
यह प्रकार पता रिज़ॉल्यूशन DNS क्वेरी की प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।
otDnsBrowseCallback )(otError aError, const otDnsBrowseResponse *aResponse, void *aContext) टंकण
void(*
इस फ़ंक्शन पॉइंटर को उस समय कहा जाता है जब किसी ब्राउज़ (सेवा उदाहरण गणना) क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।
otDnsBrowseResponse टंकण
यह प्रकार किसी ब्राउज़ (सेवा उदाहरण गणना) DNS क्वेरी की प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।
otDnsQueryConfig टंकण
यह संरचना DNS क्वेरी कॉन्फ़िगरेशन का प्रतिनिधित्व करती है।
otDnsServiceCallback )(otError aError, const otDnsServiceResponse *aResponse, void *aContext) टंकण
void(*
इस फ़ंक्शन पॉइंटर को उस समय कहा जाता है जब एक सेवा प्रतिक्रिया रिज़ॉल्यूशन क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।
otDnsServiceInfo टंकण
यह संरचना DNS सेवा उदाहरण के लिए जानकारी प्रदान करती है।
otDnsServiceResponse टंकण
यह प्रकार सेवा उदाहरण रिज़ॉल्यूशन DNS क्वेरी के लिए एक प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।

कार्यों

otDnsAddressResponseGetAddress (const otDnsAddressResponse *aResponse, uint16_t aIndex, otIp6Address *aAddress, uint32_t *aTtl)
इस फ़ंक्शन को एड्रेस रिज़ॉल्यूशन DNS प्रतिक्रिया के साथ एक IPv6 पता मिलता है।
otDnsAddressResponseGetHostName (const otDnsAddressResponse *aResponse, char *aNameBuffer, uint16_t aNameBufferSize)
इस फ़ंक्शन को पता रिज़ॉल्यूशन DNS प्रतिक्रिया के साथ पूरा होस्ट नाम मिलता है।
otDnsBrowseResponseGetHostAddress (const otDnsBrowseResponse *aResponse, const char *aHostName, uint16_t aIndex, otIp6Address *aAddress, uint32_t *aTtl)
इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से होस्ट IPv6 पता मिलता है।
otDnsBrowseResponseGetServiceInfo (const otDnsBrowseResponse *aResponse, const char *aInstanceLabel, otDnsServiceInfo *aServiceInfo)
इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से एक सेवा उदाहरण के लिए जानकारी मिलती है।
otDnsBrowseResponseGetServiceInstance (const otDnsBrowseResponse *aResponse, uint16_t aIndex, char *aLabelBuffer, uint8_t aLabelBufferSize)
इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से जुड़ा एक सेवा उदाहरण मिलता है।
otDnsBrowseResponseGetServiceName (const otDnsBrowseResponse *aResponse, char *aNameBuffer, uint16_t aNameBufferSize)
इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणना) प्रतिक्रिया से जुड़ा सेवा नाम मिलता है।
otDnsClientBrowse ( otInstance *aInstance, const char *aServiceName, otDnsBrowseCallback aCallback, void *aContext, const otDnsQueryConfig *aConfig)
यह फ़ंक्शन किसी सेवा नाम के लिए DNS ब्राउज़ (सेवा उदाहरण गणना) क्वेरी भेजता है।
otDnsClientGetDefaultConfig ( otInstance *aInstance)
इस फ़ंक्शन को DNS क्लाइंट द्वारा उपयोग किया जाने वाला वर्तमान डिफ़ॉल्ट क्वेरी कॉन्फ़िगरेशन मिलता है।
otDnsClientResolveAddress ( otInstance *aInstance, const char *aHostName, otDnsAddressCallback aCallback, void *aContext, const otDnsQueryConfig *aConfig)
यह फ़ंक्शन दिए गए होस्ट नाम के लिए AAAA (IPv6) रिकॉर्ड (ओं) के लिए एक पता रिज़ॉल्यूशन DNS क्वेरी भेजता है।
otDnsClientResolveService ( otInstance *aInstance, const char *aInstanceLabel, const char *aServiceName, otDnsServiceCallback aCallback, void *aContext, const otDnsQueryConfig *aConfig)
यह फ़ंक्शन किसी दिए गए सेवा उदाहरण के लिए DNS सेवा उदाहरण रिज़ॉल्यूशन क्वेरी भेजता है।
otDnsClientSetDefaultConfig ( otInstance *aInstance, const otDnsQueryConfig *aConfig)
void
यह फ़ंक्शन DNS क्लाइंट पर डिफ़ॉल्ट क्वेरी कॉन्फ़िगरेशन सेट करता है।
otDnsServiceResponseGetHostAddress (const otDnsServiceResponse *aResponse, const char *aHostName, uint16_t aIndex, otIp6Address *aAddress, uint32_t *aTtl)
इस फ़ंक्शन को DNS सेवा उदाहरण रिज़ॉल्यूशन प्रतिक्रिया से होस्ट IPv6 पता मिलता है।
otDnsServiceResponseGetServiceInfo (const otDnsServiceResponse *aResponse, otDnsServiceInfo *aServiceInfo)
इस फ़ंक्शन को DNS सेवा उदाहरण रिज़ॉल्यूशन प्रतिक्रिया से सेवा आवृत्ति के लिए जानकारी मिलती है।
otDnsServiceResponseGetServiceName (const otDnsServiceResponse *aResponse, char *aLabelBuffer, uint8_t aLabelBufferSize, char *aNameBuffer, uint16_t aNameBufferSize)
इस फ़ंक्शन को DNS सेवा इंस्टेंस रिज़ॉल्यूशन प्रतिक्रिया के साथ जुड़ा सेवा उदाहरण नाम मिलता है।

संरचनाएं

otDnsQueryConfig

यह संरचना DNS क्वेरी कॉन्फ़िगरेशन का प्रतिनिधित्व करती है।

otDnsServiceInfo

यह संरचना DNS सेवा उदाहरण के लिए जानकारी प्रदान करती है।

गणना

otDnsRecursionFlag

 otDnsRecursionFlag

यह गणन प्रकार एक otDnsQueryConfig में "रिकर्सन otDnsQueryConfig " (RD) ध्वज का otDnsQueryConfig

गुण
OT_DNS_FLAG_NO_RECURSION

DNS नाम सर्वर इंगित करता है कि क्वेरी को पुनरावर्ती रूप से हल नहीं किया जा सकता।

OT_DNS_FLAG_RECURSION_DESIRED

DNS नाम सर्वर इंगित करता है क्वेरी पुनरावर्ती हल कर सकते हैं।

OT_DNS_FLAG_UNSPECIFIED

झंडे को निर्दिष्ट नहीं किया गया है।

टंकण

otDnsAddressCallback

void(* otDnsAddressCallback)(otError aError, const otDnsAddressResponse *aResponse, void *aContext)

यह फ़ंक्शन पॉइंटर तब कहा जाता है जब एक एड्रेस रिज़ॉल्यूशन क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।

इस कॉलबैक के भीतर उपयोगकर्ता प्रतिक्रिया के बारे में अधिक जानकारी प्राप्त करने के लिए aResponse पॉइंटर के साथ otDnsAddressResponseGet{Item}() फ़ंक्शन का उपयोग कर सकता है।

aResponse पॉइंटर का उपयोग केवल इस कॉलबैक के भीतर किया जा सकता है और इस फ़ंक्शन से लौटने के बाद यह मान्य नहीं रहेगा, इसलिए उपयोगकर्ता को बाद में उपयोग के लिए aResponse पॉइंटर को बनाए नहीं रखना चाहिए।

aError निम्नलिखित हो सकते हैं:

विवरण
मापदंडों
[in] aError
DNS लेनदेन का परिणाम है।
[in] aResponse
प्रतिक्रिया के लिए एक संकेतक (यह हमेशा गैर-पूर्ण है)।
[in] aContext
अनुप्रयोग-विशिष्ट संदर्भ के लिए एक सूचक।

  • OT_ERROR_NONE एक प्रतिक्रिया सफलतापूर्वक प्राप्त हुई थी।
  • OT_ERROR_ABORT DNS लेनदेन को स्टैक द्वारा निरस्त कर दिया गया था।
  • OT_ERROR_RESPONSE_TIME समय के भीतर कोई DNS प्रतिक्रिया प्राप्त नहीं हुई है।

यदि सर्वर पता रिज़ॉल्यूशन को अस्वीकार कर देता है, तो सर्वर से त्रुटि कोड का पालन निम्न प्रकार से किया जाता है:

  • (0) NOERROR सफलता (कोई त्रुटि स्थिति नहीं) -> OT_ERROR_NONE
  • (1) प्रारूप त्रुटि के कारण व्याख्या करने में असमर्थ FORMERR सर्वर -> OT_ERROR_PARSE
  • (2) SERVFAIL सर्वर को आंतरिक विफलता का सामना करना पड़ा -> OT_ERROR_FAILED
  • (3) NXDOMAIN नाम जो अस्तित्व में है, मौजूद नहीं है -> OT_ERROR_NOT_FOUND
  • (4) NOTIMP सर्वर क्वेरी प्रकार (OpCode) का समर्थन नहीं करता है -> OT_ERROR_NOT_IMPLACED
  • (5) REFUSED सर्वर ने नीति / सुरक्षा कारणों से इनकार कर दिया -> OT_ERROR_SECURITY
  • (6) YXDOMAIN कुछ नाम जो अस्तित्व में नहीं हैं, मौजूद हैं -> OT_ERROR_DUPLED
  • (7) YXRRSET कुछ RRset कि मौजूद नहीं होना चाहिए, मौजूद है -> OT_ERROR_DUPICIC
  • (8) NXRRSET कुछ RRset कि मौजूद होना चाहिए, मौजूद नहीं है -> OT_ERROR_NOT_FOUND
  • (9) NOTAUTH सेवा क्षेत्र के लिए आधिकारिक नहीं है -> OT_ERROR_SECURITY
  • (१०) NOTZONE एक नाम क्षेत्र में नहीं है -> OT_ERROR_PARSE
  • (२०) बडनेम बुरा नाम -> OT_ERROR_PARSE
  • (२१) बाडलग खराब एल्गोरिदम -> OT_ERROR_SECURITY
  • (२२) बदरुण बुरा छंटनी -> OT_ERROR_PARSE
  • अन्य प्रतिक्रिया कोड -> OT_ERROR_FAILED

otDnsAddressResponse

struct otDnsAddressResponse otDnsAddressResponse

यह प्रकार पता रिज़ॉल्यूशन DNS क्वेरी की प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।

इस प्रकार के उदाहरण के लिए कॉलबैक otDnsAddressCallback से otDnsAddressCallback

otDnsBrowseCallback

void(* otDnsBrowseCallback)(otError aError, const otDnsBrowseResponse *aResponse, void *aContext)

इस फ़ंक्शन पॉइंटर को उस समय कहा जाता है जब किसी ब्राउज़ (सेवा उदाहरण गणना) क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।

इस कॉलबैक के भीतर उपयोगकर्ता प्रतिक्रिया के बारे में अधिक जानकारी प्राप्त करने के लिए aResponse पॉइंटर के साथ otDnsBrowseResponseGet{Item}() फ़ंक्शन का उपयोग कर सकता है।

aResponse पॉइंटर का उपयोग केवल इस कॉलबैक के भीतर किया जा सकता है और इस फ़ंक्शन से लौटने के बाद यह मान्य नहीं रहेगा, इसलिए उपयोगकर्ता को बाद में उपयोग के लिए aResponse पॉइंटर को बनाए नहीं रखना चाहिए।

aError लिए संभावित मूल्यों की पूरी सूची के लिए, कृपया otDnsAddressCallback()

विवरण
मापदंडों
[in] aError
DNS लेनदेन का परिणाम है।
[in] aResponse
प्रतिक्रिया के लिए एक संकेतक (यह हमेशा गैर-पूर्ण है)।
[in] aContext
अनुप्रयोग-विशिष्ट संदर्भ के लिए एक सूचक।

otDnsBrowseResponse

struct otDnsBrowseResponse otDnsBrowseResponse

यह प्रकार किसी ब्राउज़ (सेवा उदाहरण गणना) DNS क्वेरी की प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।

इस प्रकार के उदाहरण के लिए कॉलबैक otDnsBrowseCallback से otDnsBrowseCallback

otDnsQueryConfig

struct otDnsQueryConfig otDnsQueryConfig

यह संरचना DNS क्वेरी कॉन्फ़िगरेशन का प्रतिनिधित्व करती है।

इस संरचना में कोई भी फ़ील्ड यह इंगित करने के लिए शून्य पर सेट की जा सकती है कि यह निर्दिष्ट नहीं है। कैसे अनिर्दिष्ट क्षेत्रों का इलाज किया जाता है यह उस फ़ंक्शन द्वारा निर्धारित किया जाता है जो otDnsQueryConfig के उदाहरण का उपयोग करता है।

otDnsServiceCallback

void(* otDnsServiceCallback)(otError aError, const otDnsServiceResponse *aResponse, void *aContext)

इस फ़ंक्शन पॉइंटर को उस समय कहा जाता है जब एक सेवा प्रतिक्रिया रिज़ॉल्यूशन क्वेरी के लिए DNS प्रतिक्रिया प्राप्त होती है।

इस कॉलबैक के भीतर उपयोगकर्ता प्रतिक्रिया के बारे में अधिक जानकारी प्राप्त करने के लिए aResponse पॉइंटर के साथ otDnsServiceResponseGet{Item}() फ़ंक्शन का उपयोग कर सकता है।

aResponse पॉइंटर का उपयोग केवल इस कॉलबैक के भीतर किया जा सकता है और इस फ़ंक्शन से लौटने के बाद यह मान्य नहीं रहेगा, इसलिए उपयोगकर्ता को बाद में उपयोग के लिए aResponse पॉइंटर को बनाए नहीं रखना चाहिए।

aError लिए संभावित मूल्यों की पूरी सूची के लिए, कृपया otDnsAddressCallback()

विवरण
मापदंडों
[in] aError
DNS लेनदेन का परिणाम है।
[in] aResponse
प्रतिक्रिया के लिए एक संकेतक (यह हमेशा गैर-पूर्ण है)।
[in] aContext
अनुप्रयोग-विशिष्ट संदर्भ के लिए एक सूचक।

otDnsServiceInfo

struct otDnsServiceInfo otDnsServiceInfo

यह संरचना DNS सेवा उदाहरण के लिए जानकारी प्रदान करती है।

otDnsServiceResponse

struct otDnsServiceResponse otDnsServiceResponse

यह प्रकार सेवा उदाहरण रिज़ॉल्यूशन DNS क्वेरी के लिए एक प्रतिक्रिया का एक अपारदर्शी प्रतिनिधित्व है।

इस प्रकार के उदाहरण के लिए कॉलबैक otDnsAddressCallback से otDnsAddressCallback

कार्यों

otDnsAddressResponseGetAddress

otError otDnsAddressResponseGetAddress(
  const otDnsAddressResponse *aResponse,
  uint16_t aIndex,
  otIp6Address *aAddress,
  uint32_t *aTtl
)

इस फ़ंक्शन को एक IP रिज़ॉल्यूशन DNS रिज़ॉल्यूशन DNS पते से संबद्ध IPv6 पता मिलता है।

यह फ़ंक्शन केवल otDnsAddressCallback से उपयोग किया जाना otDnsAddressCallback

प्रतिक्रिया में कई IPv6 एड्रेस रिकॉर्ड शामिल हो सकते हैं। पते की सूची के माध्यम से पुनरावृत्त करने के लिए aIndex का उपयोग किया जा सकता है। इंडेक्स शून्य को पहला पता वगैरह मिलता है। जब हम सूची के अंत में पहुँच जाते हैं, तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[in] aIndex
पता रिकॉर्ड इंडेक्स पुनः प्राप्त करने के लिए।
[out] aAddress
एड्रेस को आउटपुट करने के लिए IPv6 एड्रेस के लिए एक पॉइंटर (MUST NOT NULL होना चाहिए)।
[out] aTtl
पते के लिए TTL आउटपुट के लिए एक uint32_t लिए एक सूचक। यह पूर्ण हो सकता है यदि कॉलर टीटीएल प्राप्त नहीं करना चाहता है।
वापसी मान
OT_ERROR_NONE
पता सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NOT_FOUND
aResponse पर aIndex में कोई पता रिकॉर्ड नहीं है।
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsAddressResponseGetHostName

otError otDnsAddressResponseGetHostName(
  const otDnsAddressResponse *aResponse,
  char *aNameBuffer,
  uint16_t aNameBufferSize
)

इस फ़ंक्शन को पता रिज़ॉल्यूशन DNS प्रतिक्रिया के साथ पूरा होस्ट नाम मिलता है।

यह फ़ंक्शन केवल otDnsAddressCallback से उपयोग किया जाना otDnsAddressCallback

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[out] aNameBuffer
पूर्ण मेजबान नाम (जरूरी नहीं होना चाहिए) का उत्पादन करने के लिए चार सरणी के लिए एक बफर।
[in] aNameBufferSize
aNameBuffer का आकार।
वापसी मान
OT_ERROR_NONE
पूरा होस्ट नाम सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NO_BUFS
नाम aNameBuffer में फिट नहीं है।

otDnsBrowseResponseGetHostAddress

otError otDnsBrowseResponseGetHostAddress(
  const otDnsBrowseResponse *aResponse,
  const char *aHostName,
  uint16_t aIndex,
  otIp6Address *aAddress,
  uint32_t *aTtl
)

इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से होस्ट IPv6 पता मिलता है।

यह फ़ंक्शन केवल otDnsBrowseCallback से उपयोग किया जाना otDnsBrowseCallback

प्रतिक्रिया में शून्य या अधिक IPv6 पता रिकॉर्ड शामिल हो सकते हैं। पते की सूची के माध्यम से पुनरावृत्त करने के लिए aIndex का उपयोग किया जा सकता है। इंडेक्स शून्य को पहला पता वगैरह मिलता है। जब हम सूची के अंत में पहुँच जाते हैं, तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[in] aHostName
पता प्राप्त करने के लिए होस्ट नाम (जरूरी नहीं होना चाहिए)।
[in] aIndex
पता रिकॉर्ड इंडेक्स पुनः प्राप्त करने के लिए।
[out] aAddress
एड्रेस को आउटपुट करने के लिए IPv6 एड्रेस का एक पॉइंटर (MUST NOT NULL होना चाहिए)।
[out] aTtl
पते के लिए TTL आउटपुट के लिए एक uint32_t लिए एक सूचक। यह पूर्ण हो सकता है यदि कॉलर टीटीएल प्राप्त नहीं करना चाहता है।
वापसी मान
OT_ERROR_NONE
पता सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NOT_FOUND
कोई पते के लिए रिकॉर्ड aHostname में aResponse पर aIndex
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsBrowseResponseGetServiceInfo

otError otDnsBrowseResponseGetServiceInfo(
  const otDnsBrowseResponse *aResponse,
  const char *aInstanceLabel,
  otDnsServiceInfo *aServiceInfo
)

इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से एक सेवा उदाहरण के लिए जानकारी मिलती है।

यह फ़ंक्शन केवल otDnsBrowseCallback से उपयोग किया जाना otDnsBrowseCallback

एक ब्राउज़ डीएनएस प्रतिक्रिया में एसआरवी, TXT और AAAA रिकॉर्ड सेवा उदाहरणों के लिए शामिल होने चाहिए जो नोट किए गए हैं (ध्यान दें कि यह एक SHOULD है और जरूरी नहीं है)। यह फ़ंक्शन उपलब्ध जानकारी के लिए इस जानकारी को पुनः प्राप्त करने की कोशिश करता है जब उपलब्ध हो।

  • यदि कोई मिलान SRV रिकॉर्ड aResponse में नहीं aResponse , तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।
  • एक मिलान SRV रिकॉर्ड में मौजूद है तो aResponse , aServiceInfo अद्यतन किया जाता है और OT_ERROR_NONE दिया जाता है।
  • कोई मिलता-जुलता TXT रिकॉर्ड में मौजूद है तो aResponse , mTxtDataSize में aServiceInfo शून्य पर सेट किया जाता है।
  • यदि कोई मिलान AAAA रिकॉर्ड aResponse में नहीं aResponse , तो mHostAddress is set to all zero or unspecified address.
  • If there are multiple AAAA records for the host name in @p aResponse, mHostAddress is set to the first one. The other addresses can be retrieved using otDnsBrowseResponseGetHostAddress () ` is set to the first one. The other addresses can be retrieved using

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[in] aInstanceLabel
सेवा उदाहरण लेबल (जरूरी नहीं होना चाहिए)।
[out] aServiceInfo
सेवा उदाहरण की जानकारी (जरूरी नहीं होना चाहिए) का उत्पादन करने के लिए एक ServiceInfo
वापसी मान
OT_ERROR_NONE
सेवा उदाहरण जानकारी पढ़ी गई थी। aServiceInfo अपडेट किया गया है।
OT_ERROR_NOT_FOUND
aInstanceLabel लिए एक मिलान SRV रिकॉर्ड नहीं मिल सका।
OT_ERROR_NO_BUFS
होस्ट नाम और / या TXT डेटा दिए गए बफ़र्स में फिट नहीं हो सका।
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsBrowseResponseGetServiceInstance

otError otDnsBrowseResponseGetServiceInstance(
  const otDnsBrowseResponse *aResponse,
  uint16_t aIndex,
  char *aLabelBuffer,
  uint8_t aLabelBufferSize
)

इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणन) प्रतिक्रिया से जुड़ा एक सेवा उदाहरण मिलता है।

यह फ़ंक्शन केवल otDnsBrowseCallback से उपयोग किया जाना otDnsBrowseCallback

प्रतिक्रिया में कई सेवा उदाहरण रिकॉर्ड शामिल हो सकते हैं। सूची के माध्यम से पुनरावृत्त करने के लिए aIndex का उपयोग किया जा सकता है। सूचकांक शून्य पहला रिकॉर्ड देता है। जब हम सूची के अंत में पहुँच जाते हैं, तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।

ध्यान दें कि इस फ़ंक्शन को सर्विस इंस्टेंस लेबल मिलता है न कि पूर्ण सेवा इंस्टेंस नाम जो फॉर्म का है . . . .

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[in] aIndex
सेवा उदाहरण रिकॉर्ड इंडेक्स प्राप्त करने के लिए।
[out] aLabelBuffer
सेवा उदाहरण लेबल (जरूरी नहीं होना चाहिए) के उत्पादन के लिए चार सरणी के लिए एक बफर।
[in] aLabelBufferSize
aLabelBuffer का आकार।
वापसी मान
OT_ERROR_NONE
सेवा का उदाहरण सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NO_BUFS
नाम aNameBuffer में फिट नहीं है।
OT_ERROR_NOT_FOUND
में कोई सेवा नहीं उदाहरण रिकॉर्ड aResponse पर aIndex
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsBrowseResponseGetServiceName

otError otDnsBrowseResponseGetServiceName(
  const otDnsBrowseResponse *aResponse,
  char *aNameBuffer,
  uint16_t aNameBufferSize
)

इस फ़ंक्शन को DNS ब्राउज़ (सेवा उदाहरण गणना) प्रतिक्रिया से जुड़ा सेवा नाम मिलता है।

यह फ़ंक्शन केवल otDnsBrowseCallback से उपयोग किया जाना otDnsBrowseCallback

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[out] aNameBuffer
सेवा नाम का उत्पादन करने के लिए चार सरणी के लिए एक बफर (जरूरी नहीं होना चाहिए)।
[in] aNameBufferSize
aNameBuffer का आकार।
वापसी मान
OT_ERROR_NONE
सेवा का नाम सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NO_BUFS
नाम aNameBuffer में फिट नहीं है।

otDnsClientBrowse

otError otDnsClientBrowse(
  otInstance *aInstance,
  const char *aServiceName,
  otDnsBrowseCallback aCallback,
  void *aContext,
  const otDnsQueryConfig *aConfig
)

यह फ़ंक्शन किसी दिए गए सेवा के नाम के लिए DNS ब्राउज़ (सेवा उदाहरण गणना) क्वेरी भेजता है।

यह फ़ंक्शन उपलब्ध है जब OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE सक्षम है।

aConfig NULL हो सकता है। इस स्थिति में डिफ़ॉल्ट otDnsClientGetDefaultConfig() ) इस क्वेरी के लिए कॉन्फ़िगरेशन के रूप में उपयोग की जाएगी। एक गैर- aConfig , कुछ क्षेत्रों को अनिर्दिष्ट (मान शून्य) छोड़ा जा सकता है। अनिर्दिष्ट फ़ील्ड को तब डिफ़ॉल्ट कॉन्फ़िगरेशन से मानों द्वारा प्रतिस्थापित किया जाता है।

विवरण
मापदंडों
[in] aInstance
एक OpenThread उदाहरण के लिए एक सूचक।
[in] aServiceName
के लिए क्वेरी करने के लिए सेवा का नाम (जरूरी नहीं होना चाहिए)।
[in] aCallback
एक फ़ंक्शन पॉइंटर जिसे प्रतिक्रिया रिसेप्शन या टाइम-आउट पर बुलाया जाएगा।
[in] aContext
मनमाने ढंग से संदर्भ जानकारी के लिए एक सूचक।
[in] aConfig
इस क्वेरी के लिए उपयोग करने के लिए कॉन्फ़िगर करने के लिए एक सूचक।
वापसी मान
OT_ERROR_NONE
क्वेरी को सफलतापूर्वक भेजा गया। स्थिति की रिपोर्ट करने के लिए aCallback लागू किया जाएगा।
OT_ERROR_NO_BUFS
क्वेरी तैयार करने और भेजने के लिए अपर्याप्त बफर।

otDnsClientGetDefaultConfig

const otDnsQueryConfig * otDnsClientGetDefaultConfig(
  otInstance *aInstance
)

इस फ़ंक्शन को DNS क्लाइंट द्वारा उपयोग किया जाने वाला वर्तमान डिफ़ॉल्ट क्वेरी कॉन्फिगर मिलता है।

OpenThread ढेर शुरू होता है, डिफ़ॉल्ट DNS क्वेरी config जैसे OT config विकल्पों में से एक सेट से निर्धारित किया जाता है जब OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS , _DEFAULT_SERVER_PORT , _DEFAULT_RESPONSE_TIMEOUT , आदि (देखें config/dns_clinet.h सभी संबंधित config विकल्प के लिए)।

विवरण
मापदंडों
[in] aInstance
एक OpenThread उदाहरण के लिए एक सूचक।
रिटर्न
DNS क्लाइंट द्वारा उपयोग किए जा रहे वर्तमान डिफ़ॉल्ट कॉन्फ़िगरेशन के लिए एक सूचक।

otDnsClientResolveAddress

0d88f3cab0

यह फ़ंक्शन किसी दिए गए होस्ट नाम के लिए AAAA (IPv6) रिकॉर्ड (ओं) के लिए एक पता रिज़ॉल्यूशन DNS क्वेरी भेजता है।

aConfig NULL हो सकता है। इस स्थिति में डिफ़ॉल्ट otDnsClientGetDefaultConfig() ) इस क्वेरी के लिए कॉन्फ़िगरेशन के रूप में उपयोग की जाएगी। एक गैर- aConfig , कुछ क्षेत्रों को अनिर्दिष्ट (मूल्य शून्य) छोड़ा जा सकता है। अनिर्दिष्ट फ़ील्ड को तब डिफ़ॉल्ट कॉन्फ़िगरेशन से मानों द्वारा प्रतिस्थापित किया जाता है।

विवरण
मापदंडों
[in] aInstance
एक OpenThread उदाहरण के लिए एक सूचक।
[in] aHostName
होस्ट नाम जिसके लिए पता क्वेरी करना चाहिए (जरूरी नहीं है)।
[in] aCallback
एक फ़ंक्शन पॉइंटर जिसे प्रतिक्रिया रिसेप्शन या टाइम-आउट पर बुलाया जाएगा।
[in] aContext
मनमाने ढंग से संदर्भ जानकारी के लिए एक सूचक।
[in] aConfig
इस क्वेरी के लिए उपयोग करने के लिए कॉन्फ़िगर करने के लिए एक सूचक।
वापसी मान
OT_ERROR_NONE
क्वेरी को सफलतापूर्वक भेजा गया। स्थिति की रिपोर्ट करने के लिए aCallback लागू किया जाएगा।
OT_ERROR_NO_BUFS
क्वेरी तैयार करने और भेजने के लिए अपर्याप्त बफर।

otDnsClientResolveService

otError otDnsClientResolveService(
  otInstance *aInstance,
  const char *aInstanceLabel,
  const char *aServiceName,
  otDnsServiceCallback aCallback,
  void *aContext,
  const otDnsQueryConfig *aConfig
)

यह फ़ंक्शन किसी दिए गए सेवा उदाहरण के लिए DNS सेवा उदाहरण रिज़ॉल्यूशन क्वेरी भेजता है।

यह फ़ंक्शन उपलब्ध है जब OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE सक्षम है।

aConfig NULL हो सकता है। इस स्थिति में डिफ़ॉल्ट otDnsClientGetDefaultConfig() ) इस क्वेरी के लिए कॉन्फ़िगरेशन के रूप में उपयोग की जाएगी। एक गैर- aConfig , कुछ क्षेत्रों को अनिर्दिष्ट (मूल्य शून्य) छोड़ा जा सकता है। अनिर्दिष्ट फ़ील्ड को तब डिफ़ॉल्ट कॉन्फ़िगरेशन से मानों द्वारा प्रतिस्थापित किया जाता है।

विवरण
मापदंडों
[in] aInstance
एक OpenThread उदाहरण के लिए एक सूचक।
[in] aInstanceLabel
सेवा उदाहरण लेबल।
[in] aServiceName
सेवा का नाम (साथ में aInstanceLabel फ़ुल इंस्टेंस नाम)।
[in] aCallback
एक फ़ंक्शन पॉइंटर जिसे प्रतिक्रिया रिसेप्शन या टाइम-आउट पर बुलाया जाएगा।
[in] aContext
मनमाने ढंग से संदर्भ जानकारी के लिए एक सूचक।
[in] aConfig
इस क्वेरी के लिए उपयोग करने के लिए कॉन्फ़िगर करने के लिए एक सूचक।
वापसी मान
OT_ERROR_NONE
क्वेरी को सफलतापूर्वक भेजा गया। aCallback रिपोर्ट करने के लिए aCallback लागू किया जाएगा।
OT_ERROR_NO_BUFS
क्वेरी तैयार करने और भेजने के लिए अपर्याप्त बफर।

otDnsClientSetDefaultConfig

void otDnsClientSetDefaultConfig(
  otInstance *aInstance,
  const otDnsQueryConfig *aConfig
)

यह फ़ंक्शन DNS क्लाइंट पर डिफ़ॉल्ट क्वेरी कॉन्फ़िगरेशन सेट करता है।

नोट: किसी भी चालू क्वेरी को कॉन्फ़िगर का उपयोग तब से जारी रहेगा जब इसे शुरू किया गया था। नए डिफ़ॉल्ट कॉन्फ़िगरेशन का उपयोग भविष्य के DNS प्रश्नों के लिए किया जाएगा। aConfig NULL हो सकता है। इस स्थिति में डिफ़ॉल्ट OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} को OT OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} विकल्प OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} से डिफॉल्ट में सेट किया जाएगा। जब OpenThread स्टैक प्रारंभ होता है तो यह डिफ़ॉल्ट क्वेरी को वापस कॉन्फ़िगर करता है।

एक गैर-NULL aConfig , कॉलर कुछ क्षेत्रों को otDnsQueryConfig उदाहरण में अनिर्दिष्ट (मान शून्य) चुन सकता है। अनिर्दिष्ट फ़ील्ड्स को डिफ़ॉल्ट OT कॉन्फ़िगरेशन बनाने के लिए इसी OT config विकल्प परिभाषाओं OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} द्वारा प्रतिस्थापित किया जाता है।

विवरण
मापदंडों
[in] aInstance
एक OpenThread उदाहरण के लिए एक सूचक।
[in] aConfig
डिफ़ॉल्ट के रूप में उपयोग करने के लिए नई क्वेरी कॉन्फ़िग के लिए एक पॉइंटर।

otDnsServiceResponseGetHostAddress

otError otDnsServiceResponseGetHostAddress(
  const otDnsServiceResponse *aResponse,
  const char *aHostName,
  uint16_t aIndex,
  otIp6Address *aAddress,
  uint32_t *aTtl
)

इस फ़ंक्शन को DNS सेवा उदाहरण रिज़ॉल्यूशन प्रतिक्रिया से होस्ट IPv6 पता मिलता है।

यह फ़ंक्शन केवल otDnsServiceCallback से उपयोग किया जाना otDnsServiceCallback

प्रतिक्रिया में शून्य या अधिक IPv6 पता रिकॉर्ड शामिल हो सकते हैं। पते की सूची के माध्यम से पुनरावृत्त करने के लिए aIndex का उपयोग किया जा सकता है। इंडेक्स शून्य को पहला पता वगैरह मिलता है। जब हम सूची के अंत में पहुँच जाते हैं, तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[in] aHostName
पता प्राप्त करने के लिए होस्ट नाम (जरूरी नहीं होना चाहिए)।
[in] aIndex
पता रिकॉर्ड इंडेक्स पुनः प्राप्त करने के लिए।
[out] aAddress
एड्रेस को आउटपुट करने के लिए IPv6 एड्रेस का एक पॉइंटर (MUST NOT NULL होना चाहिए)।
[out] aTtl
पते के लिए TTL आउटपुट के लिए एक uint32_t लिए एक सूचक। यह पूर्ण हो सकता है यदि कॉलर टीटीएल प्राप्त नहीं करना चाहता है।
वापसी मान
OT_ERROR_NONE
पता सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NOT_FOUND
कोई पते के लिए रिकॉर्ड aHostname में aResponse पर aIndex
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsServiceResponseGetServiceInfo

otError otDnsServiceResponseGetServiceInfo(
  const otDnsServiceResponse *aResponse,
  otDnsServiceInfo *aServiceInfo
)

इस फ़ंक्शन को DNS सेवा उदाहरण रिज़ॉल्यूशन प्रतिक्रिया से सेवा आवृत्ति के लिए जानकारी मिलती है।

यह फ़ंक्शन केवल otDnsServiceCallback से उपयोग किया जाना otDnsServiceCallback

  • यदि कोई मिलान SRV रिकॉर्ड aResponse में नहीं aResponse , तो OT_ERROR_NOT_FOUND को वापस कर दिया जाता है।
  • यदि एक मिलान SRV रिकॉर्ड aResponse में पाया जाता है, aServiceInfo अद्यतन किया जाता है और OT_ERROR_NONE वापस कर दिया जाता है।
  • कोई मिलता-जुलता TXT रिकॉर्ड में मौजूद है तो aResponse , mTxtDataSize में aServiceInfo शून्य पर सेट किया जाता है।
  • यदि कोई मिलान AAAA रिकॉर्ड aResponse में नहीं aResponse , तो mHostAddress is set to all zero or unspecified address.
  • If there are multiple AAAA records for the host name in @p aResponse, mHostAddress is set to the first one. The other addresses can be retrieved using otDnsServiceResponseGetHostAddress () ` is set to the first one. The other addresses can be retrieved using

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[out] aServiceInfo
सेवा उदाहरण जानकारी (जरूरी नहीं होना चाहिए) का उत्पादन करने के लिए एक ServiceInfo
वापसी मान
OT_ERROR_NONE
सेवा उदाहरण जानकारी पढ़ी गई थी। aServiceInfo अपडेट किया गया है।
OT_ERROR_NOT_FOUND
aResponse में एक मिलान SRV रिकॉर्ड नहीं मिल सका।
OT_ERROR_NO_BUFS
होस्ट नाम और / या TXT डेटा दिए गए बफ़र्स में फिट नहीं हो सका।
OT_ERROR_PARSE
aResponse में अभिलेखों को पार्स नहीं किया जा सका।

otDnsServiceResponseGetServiceName

otError otDnsServiceResponseGetServiceName(
  const otDnsServiceResponse *aResponse,
  char *aLabelBuffer,
  uint8_t aLabelBufferSize,
  char *aNameBuffer,
  uint16_t aNameBufferSize
)

इस फ़ंक्शन को DNS सेवा इंस्टेंस रिज़ॉल्यूशन प्रतिक्रिया के साथ जुड़ा सेवा उदाहरण नाम मिलता है।

यह फ़ंक्शन केवल otDnsServiceCallback से उपयोग किया जाना otDnsServiceCallback

विवरण
मापदंडों
[in] aResponse
प्रतिक्रिया के लिए एक सूचक।
[out] aLabelBuffer
सेवा उदाहरण लेबल (जरूरी नहीं होना चाहिए) के उत्पादन के लिए चार सरणी के लिए एक बफर।
[in] aLabelBufferSize
aLabelBuffer का आकार।
[out] aNameBuffer
शेष सेवा नाम का उत्पादन करने के लिए चार सरणी के लिए एक बफर (यदि उपयोगकर्ता नाम प्राप्त करने में रुचि नहीं है, तो इसे पूर्ण नहीं किया जा सकता है।
[in] aNameBufferSize
aNameBuffer का आकार।
वापसी मान
OT_ERROR_NONE
सेवा का नाम सफलतापूर्वक पढ़ा गया था।
OT_ERROR_NO_BUFS
या तो लेबल या नाम दिए गए बफ़र्स में फिट नहीं है।