DNS-SD Sunucusu

Bu modül DNS-SD sunucusu için API'ler içerir.

Özet

Sıralamalar
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 DNS-SD sorgu türünü belirtir.

Türdefler
otDnssdCounters	typedef struct otDnssdCounters DNS-SD sunucusunun sayaçlarını içerir.
otDnssdHostInfo	typedef struct otDnssdHostInfo DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini gösterir.
otDnssdQuery	typedef void Bu opak tür, bir DNS-SD sorgusunu temsil eder.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* DNS-SD sorgusu aşağıdakilerden birine abone olduğunda çağrılır:
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* DNS-SD sorgusu, aşağıdakilerden birinin aboneliğinden çıktığında çağrılır:
otDnssdServiceInstanceInfo	typedef struct otDnssdServiceInstanceInfo DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

İşlevler
otDnssdGetCounters(otInstance *aInstance)	const otDnssdCounters * DNS-SD sunucusunun sayaçlarını döndürür.
otDnssdGetNextQuery(otInstance *aInstance, const otDnssdQuery *aQuery)	const otDnssdQuery * DNS-SD sunucusunda sonraki sorguyu alır.
otDnssdGetQueryTypeAndName(const otDnssdQuery *aQuery, char(*) aNameOutput[OT_DNS_MAX_NAME_SIZE])	otDnssdQueryType Belirli bir sorgu için DNS-SD sorgu türünü ve adını alır.
otDnssdQueryHandleDiscoveredHost(otInstance *aInstance, const char *aHostFullName, otDnssdHostInfo *aHostInfo)	void Keşfedilen bir ana makineyi bilgilendirir.
otDnssdQueryHandleDiscoveredServiceInstance(otInstance *aInstance, const char *aServiceFullName, otDnssdServiceInstanceInfo *aInstanceInfo)	void Keşfedilen bir hizmet örneğini bilgilendirir.
otDnssdQuerySetCallbacks(otInstance *aInstance, otDnssdQuerySubscribeCallback aSubscribe, otDnssdQueryUnsubscribeCallback aUnsubscribe, void *aContext)	void DNS-SD sunucu sorgusu geri çağırmalarını ayarlar.
otDnssdUpstreamQueryIsEnabled(otInstance *aInstance)	bool DNSSD sunucusunun, DNS sorgularını platform DNS upstream API'sine yönlendirip yönlendirmeyeceğini döndürür.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)	void DNS sorgularının DNS upstream API platformuna yönlendirilmesini etkinleştirin veya devre dışı bırakın.

Yapılar
otDnssdCounters	DNS-SD sunucusunun sayaçlarını içerir.
otDnssdHostInfo	DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini gösterir.
otDnssdServiceInstanceInfo	DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

Sıralamalar

otDnssdQueryType

 otDnssdQueryType

DNS-SD sorgu türünü belirtir.

Özellikler
OT_DNSSD_QUERY_TYPE_BROWSE	Hizmet türüne göz atma hizmeti.
OT_DNSSD_QUERY_TYPE_NONE	Hizmet türü belirtilmedi.
OT_DNSSD_QUERY_TYPE_RESOLVE	Hizmet türü çözümleme hizmet örneği.
OT_DNSSD_QUERY_TYPE_RESOLVE_HOST	Hizmet türü çözümleme ana makine adı.

Türdefler

otDnssdCounters

struct otDnssdCounters otDnssdCounters

DNS-SD sunucusunun sayaçlarını içerir.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

DNS-SD sorgusu için keşfedilen bir ana makinenin bilgilerini gösterir.

otDnssdQuery

void otDnssdQuery

Bu opak tür, bir DNS-SD sorgusunu temsil eder.

otDnssdQuerySubscribeCallback

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

DNS-SD sorgusu aşağıdakilerden birine abone olduğunda çağrılır:

1. bir hizmet adı.
2. bir hizmet örneği adı girin.
3. bir ana makine adı.

aFullName bir hizmet adı ya da hizmet örneği adıysa DNS-SD sorgusunun uygulanması, aFullName bir hizmet adı veya hizmet örneği adıysa ilgili hizmet örneği bilgilerini bulmalı ve otDnssdQueryHandleDiscoveredServiceInstance kullanarak DNS-SD sunucusuna bildirim göndermelidir. aFullName bir ana makine adı ise DNS-SD sorgusu uygulaması, ana makine bilgilerini bulmalı ve otDnssdQueryHandleDiscoveredHost kodunu kullanarak DNS-SD sunucusuna bildirim göndermelidir.

Not: Aynı ada birden fazla abonelik olabilir. DNS-SD sorgu uygulaması, etkin aboneliklerin sayısını kaydetmeli ve aFullName için etkin abonelik olmadığında bildirim vermeyi durdurmalıdır.

Ayrıntılar
Parametreler	[in] aContext Uygulamaya özel bağlama işaret eden bir işaretçi. [in] aFullName Boş sonlandırılmış tam hizmet adı (ör. "_ipps._tcp.default.service.arpa."), tam hizmet örneği adı (ör. "OpenThread._ipps._tcp.default.service.arpa.") ya da tam ana makine adı (ör. "ot-host.default.service.arpa.").

Şu makaleyi de inceleyebilirsiniz:
otDnssdQueryHandleDiscoveredServiceInstance
otDnssdQueryHandleDiscoveredHost

otDnssdQueryUnsubscribeCallback

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

DNS-SD sorgusu, aşağıdakilerden birinin aboneliğinden çıktığında çağrılır:

1. bir hizmet adı.
2. bir hizmet örneği adı girin.
3. bir ana makine adı.

DNS-SD sorgusunun uygulanması, aFullName hizmetinin ne olduğunun tanımlanmasından sorumludur.

Not: Aynı ada birden fazla abonelik olabilir. DNS-SD sorgu uygulaması, etkin aboneliklerin sayısını kaydetmeli ve aFullName için etkin abonelik olmadığında bildirim vermeyi durdurmalıdır.

Ayrıntılar
Parametreler	[in] aContext Uygulamaya özel bağlama işaret eden bir işaretçi. [in] aFullName Boş sonlandırılmış tam hizmet adı (ör. "_ipps._tcp.default.service.arpa.") veya tam hizmet örneği adı (ör. "OpenThread._ipps._tcp.default.service.arpa.").

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

DNS-SD sorgusu için keşfedilen bir hizmet örneğinin bilgilerini temsil eder.

İşlevler

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

DNS-SD sunucusunun sayaçlarını döndürür.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örnek yapısı.
İadeler	DNS-SD sunucusunun sayaçlarını gösteren işaretçi.

otDnssdGetNextQuery

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

DNS-SD sunucusunda sonraki sorguyu alır.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örnek yapısı. [in] aQuery Sorgu işaretçisi. İlk sorguyu almak için NULL değerini iletin.
İadeler	Sorgunun işaretçisi veya başka sorgu yoksa NULL.

otDnssdGetQueryTypeAndName

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

Belirli bir sorgu için DNS-SD sorgu türünü ve adını alır.

Ayrıntılar
Parametreler	[in] aQuery otDnssdGetNextQuery öğesinden alınan sorgu işaretçisi. [out] aNameOutput OT_DNS_MAX_NAME_SIZE bayt uzunluğunda olması gereken ad çıkış arabelleği.
İadeler	DNS-SD sorgu türü.

otDnssdQueryHandleDiscoveredHost

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

Keşfedilen bir ana makineyi bilgilendirir.

Harici sorgu çözümleyici (ör. Discovery Proxy), abone olunan ana makinelerin OpenThread çekirdeğine bilgi vermek için bu işlevi çağırır.

Not: aHostInfo; belirtilmemiş veya yerel bağlantı, geri dönüş ya da çoklu yayın IP adresleri içermemelidir.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örnek yapısı. [in] aHostFullName Boş sonlandırılmış tam ana makine adı. [in] aHostInfo Keşfedilen hizmet örneği bilgilerine işaretçi.

otDnssdQueryHandleDiscoveredServiceInstance

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

Keşfedilen bir hizmet örneğini bilgilendirir.

Harici sorgu çözümleyici (ör. Keşif Proxy'si), abone olunan hizmetlerin veya hizmet örneklerinin OpenThread çekirdeğine bilgi vermek için bu işlevi çağırmalıdır.

Not: aInstanceInfo; belirtilmemiş veya yerel bağlantı, geri dönüş ya da çoklu yayın IP adresleri içermemelidir.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örnek yapısı. [in] aServiceFullName Boş sonlandırılmış tam hizmet adı. [in] aInstanceInfo Keşfedilen hizmet örneği bilgilerine işaretçi.

otDnssdQuerySetCallbacks

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

DNS-SD sunucu sorgusu geri çağırmalarını ayarlar.

DNS-SD sunucusu, DNS-SD sorgusunu çözümlemek için bir hizmet veya hizmet örneğine abone olmak üzere aSubscribe ve sorgu çözümlendiğinde ya da zaman aşımına uğradığında aboneliğin iptal edilmesi için aUnsubscribe çağrısı yapar.

Not: aSubscribe ve aUnsubscribe ayarlanmalıdır.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örnek yapısı. [in] aSubscribe Bir hizmet veya hizmet örneğine abone olmak için geri çağırma işlevinin işaretçisi. [in] aUnsubscribe Bir hizmet veya hizmet örneğinin aboneliğinden çıkmak için geri çağırma işlevine yönelik işaretçi. [in] aContext Uygulamaya özel bağlama işaret eden bir işaretçi.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

DNSSD sunucusunun, DNS sorgularını platform DNS upstream API'sine yönlendirip yönlendirmeyeceğini döndürür.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE etkinleştirildiğinde kullanılabilir.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örneğinin işaretçisi.
Döndürülen Değerler	TRUE DNSSD sunucusunun DNS sorgularını yönlendirip yönlendirmediği. FALSE DNSSD sunucusu, DNS sorgularını yönlendirmeyecekse.

Şu makaleyi de inceleyebilirsiniz:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

DNS sorgularının DNS upstream API platformuna yönlendirilmesini etkinleştirin veya devre dışı bırakın.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE etkinleştirildiğinde kullanılabilir.

Ayrıntılar
Parametreler	[in] aInstance OpenThread örneğinin işaretçisi. [in] aEnabled DNS sorgularını yukarı akışa yönlendirmeyi etkinleştirmek/devre dışı bırakmak için kullanılan boole değeri.

Şu makaleyi de inceleyebilirsiniz:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

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.