DNS-SD सर्वर

इस मॉड्यूल में DNS-SD सर्वर के लिए API शामिल हैं.

खास जानकारी

गिनती
otDnssdQueryType{
  OT_DNSSD_QUERY_TYPE_NONE = 0,
  OT_DNSSD_QUERY_TYPE_BROWSE = 1,
  OT_DNSSD_QUERY_TYPE_RESOLVE = 2,
  OT_DNSSD_QUERY_TYPE_RESOLVE_HOST = 3
} 		enum
इससे पता चलता है कि डीएनएस-एसडी क्वेरी का टाइप किस तरह का है.

टाइपडीफ़
otDnssdCounters typedef
इसमें DNS-SD सर्वर के काउंटर शामिल होते हैं.
otDnssdHostInfo typedef
डीएनएस-एसडी क्वेरी के लिए खोजे गए होस्ट की जानकारी दिखाता है.
otDnssdQuery typedef
void
यह ओपेक टाइप, डीएनएस-एसडी क्वेरी के बारे में बताता है.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
इसे तब कॉल किया जाता है, जब DNS-SD क्वेरी इनमें से किसी एक की सदस्यता लेती है:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName) typedef
void(*
इसे तब कॉल किया जाता है, जब DNS-SD क्वेरी इनमें से किसी एक की सदस्यता छोड़ती है:
otDnssdServiceInstanceInfo typedef
यह डीएनएस-एसडी क्वेरी के लिए खोजे गए सर्विस इंस्टेंस की जानकारी दिखाता है.

फ़ंक्शन
otDnssdGetCounters(otInstance *aInstance)
const otDnssdCounters *
डीएनएस-एसडी सर्वर के काउंटर दिखाता है.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
const otDnssdQuery *
अगली क्वेरी को डीएनएस-एसडी सर्वर में हासिल करता है.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
किसी खास क्वेरी के लिए, डीएनएस-एसडी क्वेरी का टाइप और नाम हासिल करता है.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)
void
खोजे गए होस्ट की सूचना देता है.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)
void
खोजे गए सेवा इंस्टेंस की सूचना देता है.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)
void
DNS-SD सर्वर क्वेरी कॉलबैक सेट करता है.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)
bool
यह दिखाता है कि क्या डीएनएसएसईसी सर्वर, डीएनएस क्वेरी को प्लैटफ़ॉर्म डीएनएस अपस्ट्रीम एपीआई पर भेजेगा.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)
void
डीएनएस क्वेरी को प्लैटफ़ॉर्म डीएनएस अपस्ट्रीम एपीआई पर फ़ॉरवर्ड करने की सुविधा को चालू या बंद करें.

संरचना
otDnssdCounters

इसमें DNS-SD सर्वर के काउंटर शामिल होते हैं.

otDnssdHostInfo

डीएनएस-एसडी क्वेरी के लिए खोजे गए होस्ट की जानकारी दिखाता है.

otDnssdServiceInstanceInfo

यह डीएनएस-एसडी क्वेरी के लिए खोजे गए सर्विस इंस्टेंस की जानकारी दिखाता है.

गिनती

otDnssdQueryType

 otDnssdQueryType

इससे पता चलता है कि डीएनएस-एसडी क्वेरी का टाइप किस तरह का है.

प्रॉपर्टी
OT_DNSSD_QUERY_TYPE_BROWSE

सेवा का टाइप ब्राउज़ करने की सेवा.

OT_DNSSD_QUERY_TYPE_NONE

सेवा के टाइप की जानकारी नहीं है.

OT_DNSSD_QUERY_TYPE_RESOLVE

सेवा प्रकार रिज़ॉल्व सेवा इंस्टेंस.

OT_DNSSD_QUERY_TYPE_RESOLVE_HOST

सेवा प्रकार होस्टनेम को हल करता है.

टाइपडीफ़

otDnssdCounters

struct otDnssdCounters otDnssdCounters

इसमें DNS-SD सर्वर के काउंटर शामिल होते हैं.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

डीएनएस-एसडी क्वेरी के लिए खोजे गए होस्ट की जानकारी दिखाता है.

otDnssdQuery

void otDnssdQuery

यह ओपेक टाइप, डीएनएस-एसडी क्वेरी के बारे में बताता है.

otDnssdQuerySubscribeCallback

void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)

इसे तब कॉल किया जाता है, जब DNS-SD क्वेरी इनमें से किसी एक की सदस्यता लेती है:

  1. सेवा का नाम.
  2. सेवा इंस्टेंस का नाम.
  3. होस्ट नाम.

aFullName की पहचान करने के लिए, डीएनएस-एसडी क्वेरी को लागू करने की ज़िम्मेदारी होती है. अगर aFullName किसी सेवा का नाम या किसी सेवा इंस्टेंस का नाम है, तो डीएनएस-एसडी क्वेरी को लागू करने से जुड़ी सेवा के इंस्टेंस की जानकारी का पता चलना चाहिए. साथ ही, otDnssdQueryHandleDiscoveredServiceInstance का इस्तेमाल करके डीएनएस-एसडी सर्वर को सूचना भी देनी चाहिए. अगर aFullName एक होस्ट नेम है, तो डीएनएस-एसडी क्वेरी लागू करने की प्रोसेस को होस्ट की जानकारी का पता लगाना चाहिए. साथ ही, otDnssdQueryHandleDiscoveredHost का इस्तेमाल करके डीएनएस-एसडी सर्वर को सूचना देनी चाहिए.

ब्यौरा
पैरामीटर
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ की जानकारी देने वाला पॉइंटर.
[in] aFullName
शून्य से खत्म किया गया पूरा सेवा नाम (उदाहरण के लिए, "_ipps._tcp.default.service.arpa."), या सेवा इंस्टेंस का पूरा नाम (उदाहरण के लिए, "OpenThread._ipps._tcp.default.service.arpa.") या पूरा होस्ट नाम (उदाहरण के लिए "ot-host.default.service.arpa.").
यह भी देखें:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)

इसे तब कॉल किया जाता है, जब DNS-SD क्वेरी इनमें से किसी एक की सदस्यता छोड़ती है:

  1. सेवा का नाम.
  2. सेवा इंस्टेंस का नाम.
  3. होस्ट नाम.

aFullName की पहचान करने के लिए, डीएनएस-एसडी क्वेरी को लागू करने की ज़िम्मेदारी होती है.

ब्यौरा
पैरामीटर
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ की जानकारी देने वाला पॉइंटर.
[in] aFullName
शून्य से खत्म किया गया पूरा सेवा नाम (उदाहरण के लिए, "_ipps._tcp.default.service.arpa."), या सेवा इंस्टेंस का पूरा नाम (उदाहरण के लिए, "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

यह डीएनएस-एसडी क्वेरी के लिए खोजे गए सर्विस इंस्टेंस की जानकारी दिखाता है.

फ़ंक्शन

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

डीएनएस-एसडी सर्वर के काउंटर दिखाता है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
लौटाए गए सामान
DNS-SD सर्वर के काउंटर के लिए पॉइंटर.

otDnssdGetNextQuery

const otDnssdQuery * otDnssdGetNextQuery(
  otInstance *aInstance,
  const otDnssdQuery *aQuery
)

अगली क्वेरी को डीएनएस-एसडी सर्वर में हासिल करता है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
[in] aQuery
क्वेरी पॉइंटर. पहली क्वेरी पाने के लिए NULL पास करें.
लौटाए गए सामान
क्वेरी के लिए पॉइंटर या कोई और क्वेरी न होने पर NULL.

otDnssdGetQueryTypeAndName

otDnssdQueryType otDnssdGetQueryTypeAndName(
  const otDnssdQuery *aQuery,
  char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE]
)

किसी खास क्वेरी के लिए, डीएनएस-एसडी क्वेरी का टाइप और नाम हासिल करता है.

जानकारी
पैरामीटर
[in] aQuery
otDnssdGetNextQuery से क्वेरी पॉइंटर मिला.
[out] aNameOutput
नाम आउटपुट बफ़र, जो OT_DNS_MAX_NAME_SIZE बाइट का होना चाहिए.
लौटाए गए सामान
डीएनएस-एसडी क्वेरी का टाइप.

otDnssdQueryHandleDiscoveredHost

void otDnssdQueryHandleDiscoveredHost(
  otInstance *aInstance,
  const char *aHostFullName,
  otDnssdHostInfo *aHostInfo
)

खोजे गए होस्ट की सूचना देता है.

एक्सटर्नल क्वेरी रिज़ॉल्वर (जैसे डिस्कवरी प्रॉक्सी) को इस फ़ंक्शन को कॉल करना चाहिए, ताकि सदस्यता लिए गए होस्ट के OpenThread कोर को सूचना दी जा सके.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
[in] aHostFullName
शून्य से खत्म किया गया पूरा होस्ट नाम.
[in] aHostInfo
खोजी गई सेवा इंस्टेंस की जानकारी के लिए पॉइंटर.

otDnssdQueryHandleDiscoveredServiceInstance

void otDnssdQueryHandleDiscoveredServiceInstance(
  otInstance *aInstance,
  const char *aServiceFullName,
  otDnssdServiceInstanceInfo *aInstanceInfo
)

खोजे गए सेवा इंस्टेंस की सूचना देता है.

एक्सटर्नल क्वेरी रिज़ॉल्वर (जैसे डिस्कवरी प्रॉक्सी) को इस फ़ंक्शन को कॉल करना चाहिए, ताकि OpenThread कोर को सदस्यता वाली सेवाओं या सेवा इंस्टेंस के बारे में सूचना दी जा सके.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
[in] aServiceFullName
शून्य से खत्म किया गया पूरा सेवा नाम.
[in] aInstanceInfo
खोजी गई सेवा इंस्टेंस की जानकारी के लिए पॉइंटर.

otDnssdQuerySetCallbacks

void otDnssdQuerySetCallbacks(
  otInstance *aInstance,
  otDnssdQuerySubscribeCallback aSubscribe,
  otDnssdQueryUnsubscribeCallback aUnsubscribe,
  void *aContext
)

DNS-SD सर्वर क्वेरी कॉलबैक सेट करता है.

DNS-SD सर्वर, DNS-SD क्वेरी का समाधान करने के लिए किसी सेवा या सेवा इंस्टेंस की सदस्यता लेने के लिए aSubscribe को और क्वेरी का समाधान हो जाने या टाइम आउट होने पर सदस्यता छोड़ने के लिए aUnsubscribe को कॉल करता है.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस स्ट्रक्चर.
[in] aSubscribe
किसी सेवा या सेवा इंस्टेंस की सदस्यता लेने के लिए कॉलबैक फ़ंक्शन का पॉइंटर.
[in] aUnsubscribe
किसी सेवा या सेवा इंस्टेंस की सदस्यता छोड़ने के लिए, कॉलबैक फ़ंक्शन का पॉइंटर.
[in] aContext
ऐप्लिकेशन के हिसाब से संदर्भ की जानकारी देने वाला पॉइंटर.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

यह दिखाता है कि क्या डीएनएसएसईसी सर्वर, डीएनएस क्वेरी को प्लैटफ़ॉर्म डीएनएस अपस्ट्रीम एपीआई पर भेजेगा.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE चालू होने पर उपलब्ध होगा.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
रिटर्न वैल्यू
TRUE
अगर डीएनएसएसईसी सर्वर, डीएनएस क्वेरी को फ़ॉरवर्ड करेगा.
FALSE
अगर डीएनएसएसईसी का सर्वर डीएनएस क्वेरी को फ़ॉरवर्ड नहीं करता है.
यह भी देखें:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

डीएनएस क्वेरी को प्लैटफ़ॉर्म डीएनएस अपस्ट्रीम एपीआई पर फ़ॉरवर्ड करने की सुविधा को चालू या बंद करें.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE चालू होने पर उपलब्ध होगा.

जानकारी
पैरामीटर
[in] aInstance
OpenThread इंस्टेंस के लिए पॉइंटर.
[in] aEnabled
अपस्ट्रीम में, फ़ॉरवर्ड करने वाली डीएनएस क्वेरी को चालू/बंद करने का बूलियन.
यह भी देखें:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

संसाधन

OpenThread API के रेफ़रंस के विषय, सोर्स कोड से मिलते हैं. यह सोर्स GitHub पर उपलब्ध है. ज़्यादा जानकारी या हमारे दस्तावेज़ में योगदान देने के लिए, संसाधन देखें.