خادم DNS-SD
تتضمّن هذه الوحدة واجهات برمجة تطبيقات لخادم DNS-SD.
ملخّص
التعدادات |
|
---|---|
otDnssdQueryType{
|
تعداد يحدّد هذا الإعداد نوع طلب بحث DNS-SD. |
أنواع المحددات |
|
---|---|
otDnssdCounters
|
typedefstruct otDnssdCounters
يحتوي على عدّادات خادم DNS-SD. |
otDnssdHostInfo
|
typedefstruct otDnssdHostInfo
تمثل معلومات مضيف تم اكتشافه لطلب بحث DNS-SD. |
otDnssdQuery
|
typedefvoid
يمثل هذا النوع المبهم طلب بحث لنظام أسماء النطاقات (DNS). |
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
يتم طلبه عند اشتراك طلب بحث DNS-SD في أي مما يلي: |
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
|
typedefvoid(*
يتم طلبه عند إلغاء اشتراك طلب بحث نظام أسماء النطاقات (DNS) من أحد الخيارات التالية: |
otDnssdServiceInstanceInfo
|
typedefstruct otDnssdServiceInstanceInfo
تمثل معلومات مثيل الخدمة الذي تم اكتشافه لطلب بحث DNS-SD. |
الدوال |
|
---|---|
otDnssdGetCounters(otInstance *aInstance)
|
const otDnssdCounters *
يعرض العدادات لخادم DNS-SD.
|
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)
|
const otDnssdQuery *
الحصول على طلب البحث التالي في خادم DNS-SD.
|
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])
|
الحصول على نوع طلب البحث لنظام أسماء النطاقات (DNS-SD) واسمه لطلب بحث معيّن
|
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
عرض ما إذا كان خادم نظام أسماء النطاقات (DNSSD) سيعيد توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة تطبيقات النظام الأساسي للبث المباشر لنظام أسماء النطاقات
|
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)
|
void
تفعيل أو إيقاف إعادة توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة التطبيقات أسماء نطاقات النظام الأساسي لنظام أسماء النطاقات.
|
هياكل |
|
---|---|
otDnssdCounters |
يحتوي على عدّادات خادم DNS-SD. |
otDnssdHostInfo |
تمثل معلومات مضيف تم اكتشافه لطلب بحث DNS-SD. |
otDnssdServiceInstanceInfo |
تمثل معلومات مثيل الخدمة الذي تم اكتشافه لطلب بحث DNS-SD. |
التعدادات
otDnssdQueryType
otDnssdQueryType
يحدّد هذا الإعداد نوع طلب بحث DNS-SD.
أماكن إقامة | |
---|---|
OT_DNSSD_QUERY_TYPE_BROWSE
|
خدمة تصفّح نوع الخدمة |
OT_DNSSD_QUERY_TYPE_NONE
|
نوع الخدمة غير محدَّد |
OT_DNSSD_QUERY_TYPE_RESOLVE
|
نوع الخدمة يحلّ مثيل الخدمة |
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST
|
يحلّ نوع الخدمة اسم المضيف. |
أنواع المحددات
otDnssdHostInfo
struct otDnssdHostInfo otDnssdHostInfo
تمثل معلومات مضيف تم اكتشافه لطلب بحث DNS-SD.
otDnssdQuery
void otDnssdQuery
يمثل هذا النوع المبهم طلب بحث لنظام أسماء النطاقات (DNS).
otDnssdQueryCallCallback
void(* otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)
يتم طلبه عند اشتراك طلب بحث DNS-SD في أي مما يلي:
- اسم خدمة
- اسم مثيل خدمة
- اسم مضيف
يكون تنفيذ طلب بحث DNS-SD مسؤولًا عن تحديد المقصود بـ aFullName
. وإذا كان aFullName
اسم خدمة أو اسم مثيل خدمة، يجب أن يكتشف تنفيذ طلب البحث DNS-SD معلومات الخدمات المقابلة وإعلام خادم DNS-SD باستخدام otDnssdQueryHandleDiscoveredServiceInstance
. إذا كان aFullName
اسم مضيف، من المفترَض أن يؤدي تنفيذ طلب البحث لنظام أسماء النطاقات (DNS) إلى نظام أسماء النطاقات باكتشاف معلومات المضيف وإعلام خادم نظام أسماء النطاقات SD-SD باستخدام otDnssdQueryHandleDiscoveredHost
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost
otDnssdQueryCallCallback
void(* otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)
يتم طلبه عند إلغاء اشتراك طلب بحث نظام أسماء النطاقات (DNS) من أحد الخيارات التالية:
- اسم خدمة
- اسم مثيل خدمة
- اسم مضيف
يكون تنفيذ طلب البحث لنظام أسماء النطاقات (DNS) وصفًا مسؤولاً عن تحديد aFullName
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otDnssdServiceInstanceInfo
struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo
تمثل معلومات مثيل الخدمة الذي تم اكتشافه لطلب بحث DNS-SD.
الدوال
otDnssdGetCounters
const otDnssdCounters * otDnssdGetCounters( otInstance *aInstance )
يعرض العدادات لخادم DNS-SD.
التفاصيل | |||
---|---|---|---|
المَعلمات |
|
||
المرتجعات |
مؤشر إلى عدّادات خادم DNS-SD.
|
otDnssdGetNextQuery
const otDnssdQuery * otDnssdGetNextQuery( otInstance *aInstance, const otDnssdQuery *aQuery )
الحصول على طلب البحث التالي في خادم DNS-SD.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
مؤشر إلى طلب البحث أو إلى قيمة فارغة إذا لم يكن هناك المزيد من طلبات البحث.
|
otDnssdGetQueryTypeAndName
otDnssdQueryType otDnssdGetQueryTypeAndName( const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE] )
الحصول على نوع طلب البحث لنظام أسماء النطاقات (DNS-SD) واسمه لطلب بحث معيّن
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
المرتجعات |
نوع طلب البحث لنظام أسماء النطاقات (DNS):
|
otDnssdQueryHandleDiscoveredHost
void otDnssdQueryHandleDiscoveredHost( otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo )
يرسل إشعارًا إلى المضيف الذي تم اكتشافه.
يجب أن يستدعي برنامج تعيين طلب البحث الخارجي (على سبيل المثال، الخادم الوكيل أثناء التصفّح) هذه الدالة لإبلاغ واجهة OpenThread الأساسية للمضيفين المشتركين.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otDnssdQueryHandleDiscoveredServiceInstance
void otDnssdQueryHandleDiscoveredServiceInstance( otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo )
إبلاغ مثيل خدمة تم اكتشافه.
يجب أن يستدعي برنامج تعيين طلب البحث الخارجي (على سبيل المثال، الخادم الوكيل أثناء التصفّح) هذه الدالة لإبلاغ واجهة OpenThread الأساسية للخدمات أو مثيلات الخدمة التي اشتركت فيها.
التفاصيل | |||||||
---|---|---|---|---|---|---|---|
المَعلمات |
|
otDnssdQuerySetCallbacks
void otDnssdQuerySetCallbacks( otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext )
لضبط استدعاءات طلبات بحث خادم DNS-SD.
يتصل خادم نظام أسماء النطاقات (DNS) بـ aSubscribe
للاشتراك في خدمة أو مثيل خدمة لحل طلب DNS-SD وaUnsubscribe
لإلغاء الاشتراك عند حل طلب البحث أو انتهاء مهلته.
التفاصيل | |||||||||
---|---|---|---|---|---|---|---|---|---|
المَعلمات |
|
otDnssdUpstreamQueryIsEnabled
bool otDnssdUpstreamQueryIsEnabled( otInstance *aInstance )
عرض ما إذا كان خادم نظام أسماء النطاقات (DNSSD) سيعيد توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة تطبيقات النظام الأساسي للبث المباشر لنظام أسماء النطاقات
متاحة عند تفعيل OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
||||
قيم الإرجاع |
|
otDnssdUpstreamQuerySetEnabled
otDnssdUpstreamQuerySetEnabled.
void otDnssdUpstreamQuerySetEnabled( otInstance *aInstance, bool aEnabled )
تفعيل أو إيقاف إعادة توجيه طلبات بحث نظام أسماء النطاقات إلى واجهة برمجة التطبيقات أسماء نطاقات النظام الأساسي لنظام أسماء النطاقات.
متاحة عند تفعيل OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE
.
التفاصيل | |||||
---|---|---|---|---|---|
المَعلمات |
|
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone
الموارد
تبدأ مواضيع مراجع واجهة برمجة تطبيقات OpenThread من رمز المصدر، وهو متاح على GitHub. للحصول على مزيد من المعلومات أو للمساهمة في المستندات، يمكنك الاطّلاع على المراجع.