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
DNS-SD sunucusunun sayaçlarını içerir.
otDnssdHostInfo typedef
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
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])
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.

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.

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.

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.

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.

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.