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
DNS-SD 서버의 카운터를 포함합니다.
otDnssdHostInfo typedef
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
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 서버가 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 서버에 알려야 합니다.

세부정보
매개변수
[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가 무엇인지 식별합니다.

세부정보
매개변수
[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 코어에 알려야 합니다.

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

otDnssdQueryHandleDiscoveredServiceInstance

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

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

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

세부정보
매개변수
[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를 호출하여 구독 취소합니다.

세부정보
매개변수
[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에서 제공되는 소스 코드에서 비롯됩니다. 자세한 내용을 알아보거나 문서에 참여하려면 리소스를 참고하세요.