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 DNS-SD 쿼리 유형을 지정합니다.

Typedef
otDnssdCounters	typedef struct otDnssdCounters DNS-SD 서버의 카운터를 포함합니다.
otDnssdHostInfo	typedef struct otDnssdHostInfo DNS-SD 쿼리를 위해 검색된 호스트 정보를 나타냅니다.
otDnssdQuery	typedef void 이 불투명 유형은 DNS-SD 쿼리를 나타냅니다.
otDnssdQuerySubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* DNS-SD 쿼리가 다음 중 하나를 구독하면 호출됩니다.
otDnssdQueryUnsubscribeCallback)(void *aContext, const char *aFullName)	typedef void(* DNS-SD 쿼리가 다음 중 하나를 구독 취소하면 호출됩니다.
otDnssdServiceInstanceInfo	typedef struct 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])	otDnssdQueryType 특정 쿼리의 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 서버가 DNS 쿼리를 플랫폼 DNS 업스트림 API에 전달할지 여부를 반환합니다.
otDnssdUpstreamQuerySetEnabled(otInstance *aInstance, bool aEnabled)	void 플랫폼 DNS 업스트림 API로 DNS 쿼리 전달을 사용 설정 또는 중지합니다.

구조체
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	서비스 유형은 호스트 이름을 확인합니다.

Typedef

otDnssdCounters

struct otDnssdCounters otDnssdCounters

DNS-SD 서버의 카운터를 포함합니다.

otDnssdHostInfo

struct otDnssdHostInfo otDnssdHostInfo

DNS-SD 쿼리를 위해 검색된 호스트 정보를 나타냅니다.

otDnssdQuery

void otDnssdQuery

이 불투명 유형은 DNS-SD 쿼리를 나타냅니다.

otDnssdQuerySubscribeCallback

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

DNS-SD 쿼리가 다음 중 하나를 구독하면 호출됩니다.

1. 지정할 수 있습니다
2. 서비스 인스턴스 이름을 지정할 수 있습니다
3. 호스트 이름입니다.

DNS-SD 쿼리 구현은 aFullName가 무엇인지 식별해야 합니다. aFullName이 서비스 이름 또는 서비스 인스턴스 이름인 경우 DNS-SD 쿼리 구현은 해당 서비스 인스턴스 정보를 찾아 otDnssdQueryHandleDiscoveredServiceInstance를 사용하여 DNS-SD 서버에 알려야 합니다. aFullName가 호스트 이름인 경우 DNS-SD 쿼리 구현은 호스트 정보를 검색하고 otDnssdQueryHandleDiscoveredHost를 사용하여 DNS-SD 서버에 알려야 합니다.

참고: 이름이 동일한 구독이 여러 개 있을 수 있습니다. DNS-SD 쿼리 구현 시 활성 구독 수를 기록해야 하며 aFullName에 활성 구독이 없으면 알림을 중지해야 합니다.

세부정보
매개변수	[in] aContext 애플리케이션별 컨텍스트를 가리키는 포인터입니다. [in] aFullName null로 끝나는 전체 서비스 이름 (예: '_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. 호스트 이름입니다.

DNS-SD 쿼리 구현은 aFullName가 무엇인지 식별합니다.

참고: 이름이 동일한 구독이 여러 개 있을 수 있습니다. DNS-SD 쿼리 구현 시 활성 구독 수를 기록해야 하며 aFullName에 활성 구독이 없으면 알림을 중지해야 합니다.

세부정보
매개변수	[in] aContext 애플리케이션별 컨텍스트를 가리키는 포인터입니다. [in] aFullName null로 끝나는 전체 서비스 이름 (예: '_ipps._tcp.default.service.arpa.') 또는 전체 서비스 인스턴스 이름 (예: 'OpenThread._ipps._tcp.default.service.arpa.')입니다.

otDnssdServiceInstanceInfo

struct otDnssdServiceInstanceInfo otDnssdServiceInstanceInfo

DNS-SD 쿼리에 대해 검색된 서비스 인스턴스 정보를 나타냅니다.

함수

otDnssdGetCounters

const otDnssdCounters * otDnssdGetCounters(
  otInstance *aInstance
)

DNS-SD 서버의 카운터를 반환합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스 구조
반환	DNS-SD 서버의 카운터에 대한 포인터입니다.

otDnssdGetNextQuery

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

DNS-SD 서버에서 다음 쿼리를 가져옵니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스 구조 [in] aQuery 쿼리 포인터 NULL을 전달하여 첫 번째 쿼리를 가져옵니다.
반환	쿼리에 대한 포인터이거나 더 이상 쿼리가 없는 경우 NULL입니다.

otDnssdGetQueryTypeAndName

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

특정 쿼리의 DNS-SD 쿼리 유형 및 이름을 가져옵니다.

세부정보
매개변수	[in] aQuery otDnssdGetNextQuery에서 획득한 쿼리 포인터입니다. [out] aNameOutput 이름 출력 버퍼로, OT_DNS_MAX_NAME_SIZE바이트여야 합니다.
반환	DNS-SD 쿼리 유형입니다.

otDnssdQueryHandleDiscoveredHost

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

검색된 호스트에 알립니다.

외부 쿼리 리졸버 (예: 탐색 프록시)는 이 함수를 호출하여 구독된 호스트의 OpenThread 코어에 알려야 합니다.

참고: aHostInfo에는 지정되지 않았거나 링크-로컬, 루프백 또는 멀티캐스트 IP 주소가 포함되어서는 안 됩니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스 구조 [in] aHostFullName null로 끝나는 전체 호스트 이름입니다. [in] aHostInfo 검색된 서비스 인스턴스 정보에 대한 포인터입니다.

otDnssdQueryHandleDiscoveredServiceInstance

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

검색된 서비스 인스턴스를 알립니다.

외부 쿼리 리졸버 (예: 탐색 프록시)는 이 함수를 호출하여 구독된 서비스 또는 서비스 인스턴스의 OpenThread 코어에 알려야 합니다.

참고: aInstanceInfo에는 지정되지 않았거나 링크-로컬, 루프백 또는 멀티캐스트 IP 주소가 포함되어서는 안 됩니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스 구조 [in] aServiceFullName null로 종료된 전체 서비스 이름입니다. [in] aInstanceInfo 검색된 서비스 인스턴스 정보에 대한 포인터입니다.

otDnssdQuerySetCallbacks

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

DNS-SD 서버 쿼리 콜백을 설정합니다.

DNS-SD 서버는 aSubscribe를 호출하여 DNS-SD 쿼리를 확인하기 위해 서비스나 서비스 인스턴스를 구독하고, 쿼리가 확인되거나 시간 초과되면 aUnsubscribe를 호출하여 구독 취소합니다.

참고: aSubscribe 및 aUnsubscribe를 모두 설정하거나 설정하지 않아야 합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스 구조 [in] aSubscribe 서비스 또는 서비스 인스턴스를 구독하는 콜백 함수를 가리키는 포인터입니다. [in] aUnsubscribe 서비스 또는 서비스 인스턴스를 구독 취소하는 콜백 함수에 대한 포인터입니다. [in] aContext 애플리케이션별 컨텍스트를 가리키는 포인터입니다.

otDnssdUpstreamQueryIsEnabled

bool otDnssdUpstreamQueryIsEnabled(
  otInstance *aInstance
)

DNSSD 서버가 DNS 쿼리를 플랫폼 DNS 업스트림 API에 전달할지 여부를 반환합니다.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE가 사용 설정된 경우 사용 가능합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스를 가리키는 포인터입니다.
반환 값	TRUE DNSSD 서버가 DNS 쿼리를 전달하는지 여부 FALSE DNSSD 서버가 DNS 쿼리를 전달하지 않는 경우

참고 항목:
otDnssdUpstreamQuerySetEnabled

otDnssdUpstreamQuerySetEnabled

void otDnssdUpstreamQuerySetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

플랫폼 DNS 업스트림 API로 DNS 쿼리 전달을 사용 설정 또는 중지합니다.

OPENTHREAD_CONFIG_DNS_UPSTREAM_QUERY_ENABLE가 사용 설정된 경우 사용 가능합니다.

세부정보
매개변수	[in] aInstance OpenThread 인스턴스를 가리키는 포인터입니다. [in] aEnabled DNS 쿼리를 업스트림으로 전달하는 것을 사용 설정/사용 중지하는 불리언입니다.

참고 항목:
otPlatDnsStartUpstreamQuery
otPlatDnsCancelUpstreamQuery
otPlatDnsUpstreamQueryDone

자료

OpenThread API 참조 주제는 GitHub에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.