Google은 흑인 공동체를 위한 인종적 평등을 추구하기 위해 노력하고 있습니다. 자세히 알아보기

SRP

이 모듈에는 SRP 클라이언트 동작을 제어하는 ​​기능이 포함되어 있습니다.

요약

이 모듈은 서비스 등록 프로토콜의 기능을 포함합니다.

이 모듈에는 SRP 클라이언트 버퍼 및 서비스 풀에 대한 기능이 포함되어 있습니다.

이 모듈의 기능은 OPENTHREAD_CONFIG_SRP_CLIENT_BUFFERS_ENABLE 기능이 활성화된 경우에만 사용할 수 있습니다.

열거

anonymous enum {
OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE = 1 << 0,
OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE = 1 << 1,
OT_SRP_SERVER_SERVICE_FLAG_ACTIVE = 1 << 2,
OT_SRP_SERVER_SERVICE_FLAG_DELETED = 1 << 3
}
열거
anonymous enum {
OT_SRP_SERVER_FLAGS_ANY_SERVICE = (OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE | OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE | OT_SRP_SERVER_SERVICE_FLAG_ACTIVE | OT_SRP_SERVER_SERVICE_FLAG_DELETED),
OT_SRP_SERVER_FLAGS_BASE_TYPE_SERVICE_ONLY = (OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE | OT_SRP_SERVER_SERVICE_FLAG_ACTIVE | OT_SRP_SERVER_SERVICE_FLAG_DELETED),
OT_SRP_SERVER_FLAGS_SUB_TYPE_SERVICE_ONLY = (OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE | OT_SRP_SERVER_SERVICE_FLAG_ACTIVE | OT_SRP_SERVER_SERVICE_FLAG_DELETED),
OT_SRP_SERVER_FLAGS_ANY_TYPE_ACTIVE_SERVICE = (OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE | OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE | OT_SRP_SERVER_SERVICE_FLAG_ACTIVE),
OT_SRP_SERVER_FLAGS_ANY_TYPE_DELETED_SERVICE = (OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE | OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE | OT_SRP_SERVER_SERVICE_FLAG_ACTIVE)
}
열거
otSrpClientItemState {
OT_SRP_CLIENT_ITEM_STATE_TO_ADD ,
OT_SRP_CLIENT_ITEM_STATE_ADDING ,
OT_SRP_CLIENT_ITEM_STATE_TO_REFRESH ,
OT_SRP_CLIENT_ITEM_STATE_REFRESHING ,
OT_SRP_CLIENT_ITEM_STATE_TO_REMOVE ,
OT_SRP_CLIENT_ITEM_STATE_REMOVING ,
OT_SRP_CLIENT_ITEM_STATE_REGISTERED ,
OT_SRP_CLIENT_ITEM_STATE_REMOVED
}
열거
이 열거는 SRP 클라이언트 항목(서비스 또는 호스트 정보) 상태를 지정합니다.
otSrpServerAddressMode {
OT_SRP_SERVER_ADDRESS_MODE_UNICAST = 0,
OT_SRP_SERVER_ADDRESS_MODE_ANYCAST = 1
}
열거
이 열거는 SRP 서버에서 사용하는 주소 모드를 나타냅니다.
otSrpServerState {
OT_SRP_SERVER_STATE_DISABLED = 0,
OT_SRP_SERVER_STATE_RUNNING = 1,
OT_SRP_SERVER_STATE_STOPPED = 2
}
열거
SRP 서버의 상태를 나타냅니다.

형식 정의

otSrpClientAutoStartCallback )(const otSockAddr *aServerSockAddr, void *aContext) 형식 정의
void(*
이 함수 포인터 유형은 SRP 클라이언트가 자동 시작 또는 중지될 때 사용자에게 알리기 위해 사용하는 콜백을 정의합니다.
otSrpClientBuffersServiceEntry 형식 정의
이 구조체는 SRP 클라이언트 서비스 풀 항목을 나타냅니다.
otSrpClientCallback )(otError aError, const otSrpClientHostInfo *aHostInfo, const otSrpClientService *aServices, const otSrpClientService *aRemovedServices, void *aContext) 형식 정의
void(*
이 함수 포인터 유형은 사용자에게 변경/이벤트/오류를 알리기 위해 SRP 클라이언트에서 사용하는 콜백을 정의합니다.
otSrpClientHostInfo 형식 정의
이 구조는 SRP 클라이언트 호스트 정보를 나타냅니다.
otSrpClientService 형식 정의
이 구조는 SRP 클라이언트 서비스를 나타냅니다.
otSrpServerAddressMode 형식 정의
이 열거는 SRP 서버에서 사용하는 주소 모드를 나타냅니다.
otSrpServerHost 형식 정의
이 불투명한 유형은 SRP 서비스 호스트를 나타냅니다.
otSrpServerLeaseConfig 형식 정의
이 구조에는 SRP 서버 LEASE 및 KEY-LEASE 구성이 포함됩니다.
otSrpServerService 형식 정의
이 불투명한 유형은 SRP 서비스를 나타냅니다.
otSrpServerServiceFlags 형식 정의
uint8_t
SRP 서비스 목록에서 검색(또는 반복)할 때 포함하거나 제외할 서비스를 나타내는 서비스 플래그 유형입니다.
otSrpServerServiceUpdateHandler )(otSrpServerServiceUpdateId aId, const otSrpServerHost *aHost, uint32_t aTimeout, void *aContext) 형식 정의
void(*
이 기능은 SRP 서비스 업데이트를 처리합니다.
otSrpServerServiceUpdateId 형식 정의
uint32_t
SRP 서버에서 SRP 서비스 업데이트 트랜잭션의 ID입니다.

기능

otSrpClientAddService ( otInstance *aInstance, otSrpClientService *aService)
서버에 등록할 서비스를 추가하는 기능입니다.
otSrpClientBuffersAllocateService ( otInstance *aInstance)
이 함수는 풀에서 새 서비스 항목을 할당합니다.
otSrpClientBuffersFreeAllServices ( otInstance *aInstance)
void
이 기능은 이전에 할당된 모든 서비스 항목을 해제합니다.
otSrpClientBuffersFreeService ( otInstance *aInstance, otSrpClientBuffersServiceEntry *aService)
void
이 기능은 이전에 할당된 서비스 항목을 해제합니다.
otSrpClientBuffersGetHostAddressesArray ( otInstance *aInstance, uint8_t *aArrayLength)
이 함수는 SRP 클라이언트 호스트 주소 목록으로 사용할 IPv6 주소 항목의 배열을 가져옵니다.
otSrpClientBuffersGetHostNameString ( otInstance *aInstance, uint16_t *aSize)
char *
이 함수는 SRP 클라이언트 호스트 이름에 사용할 문자열 버퍼를 가져옵니다.
otSrpClientBuffersGetServiceEntryInstanceNameString ( otSrpClientBuffersServiceEntry *aEntry, uint16_t *aSize)
char *
이 함수는 서비스 항목에서 서비스 인스턴스 이름에 대한 문자열 버퍼를 가져옵니다.
otSrpClientBuffersGetServiceEntryServiceNameString ( otSrpClientBuffersServiceEntry *aEntry, uint16_t *aSize)
char *
이 함수는 서비스 항목에서 서비스 이름에 대한 문자열 버퍼를 가져옵니다.
otSrpClientBuffersGetServiceEntryTxtBuffer ( otSrpClientBuffersServiceEntry *aEntry, uint16_t *aSize)
uint8_t *
이 함수는 서비스 항목에서 TXT 레코드에 대한 버퍼를 가져옵니다.
otSrpClientBuffersGetSubTypeLabelsArray ( otSrpClientBuffersServiceEntry *aEntry, uint16_t *aArrayLength)
const char **
이 함수는 서비스 항목에서 서비스 하위 유형 레이블에 대한 배열을 가져옵니다.
otSrpClientClearHostAndServices ( otInstance *aInstance)
void
이 기능은 모든 호스트 정보와 모든 서비스를 지웁니다.
otSrpClientClearService ( otInstance *aInstance, otSrpClientService *aService)
이 기능은 서비스를 지우고 클라이언트 서비스 목록에서 즉시 제거합니다.
otSrpClientDisableAutoStartMode ( otInstance *aInstance)
void
이 기능은 자동 시작 모드를 비활성화합니다.
otSrpClientEnableAutoStartMode ( otInstance *aInstance, otSrpClientAutoStartCallback aCallback, void *aContext)
void
이 기능은 자동 시작 모드를 활성화합니다.
otSrpClientGetDomainName ( otInstance *aInstance)
const char *
이 함수는 SRP 클라이언트에서 사용 중인 도메인 이름을 가져옵니다.
otSrpClientGetHostInfo ( otInstance *aInstance)
이 함수는 호스트 정보를 가져옵니다.
otSrpClientGetKeyLeaseInterval ( otInstance *aInstance)
uint32_t
이 함수는 SRP 업데이트 요청에 사용된 키 임대 간격을 가져옵니다.
otSrpClientGetLeaseInterval ( otInstance *aInstance)
uint32_t
이 함수는 SRP 업데이트 요청에 사용된 임대 간격을 가져옵니다.
otSrpClientGetServerAddress ( otInstance *aInstance)
const otSockAddr *
이 함수는 SRP 클라이언트가 사용 중인 SRP 서버의 소켓 주소(IPv6 주소 및 포트 번호)를 가져옵니다.
otSrpClientGetServices ( otInstance *aInstance)
이 함수는 클라이언트가 관리하는 서비스 목록을 가져옵니다.
otSrpClientIsAutoStartModeEnabled ( otInstance *aInstance)
bool
이 기능은 자동 시작 모드의 현재 상태(활성화 또는 비활성화)를 나타냅니다.
otSrpClientIsRunning ( otInstance *aInstance)
bool
이 기능은 SRP 클라이언트가 실행 중인지 여부를 나타냅니다.
otSrpClientIsServiceKeyRecordEnabled ( otInstance *aInstance)
bool
이 메서드는 "서비스 키 레코드 포함" 모드가 활성화되었는지 비활성화되었는지 여부를 나타냅니다.
otSrpClientItemStateToString ( otSrpClientItemState aItemState)
const char *
이 함수는 변환 otSrpClientItemState 문자열로.
otSrpClientRemoveHostAndServices ( otInstance *aInstance, bool aRemoveKeyLease, bool aSendUnregToServer)
이 기능은 호스트 정보 및 모든 서비스의 제거 프로세스를 시작합니다.
otSrpClientRemoveService ( otInstance *aInstance, otSrpClientService *aService)
이 함수는 서비스를 서버에 등록 해제하도록 요청합니다.
otSrpClientSetCallback ( otInstance *aInstance, otSrpClientCallback aCallback, void *aContext)
void
이 함수는 SRP 클라이언트의 이벤트/변경 사항을 호출자에게 알리도록 콜백을 설정합니다.
otSrpClientSetDomainName ( otInstance *aInstance, const char *aName)
이 기능은 SRP 클라이언트에서 사용할 도메인 이름을 설정합니다.
otSrpClientSetHostAddresses ( otInstance *aInstance, const otIp6Address *aIp6Addresses, uint8_t aNumAddresses)
이 기능은 호스트 IPv6 주소 목록을 설정/업데이트합니다.
otSrpClientSetHostName ( otInstance *aInstance, const char *aName)
이 함수는 호스트 이름 레이블을 설정합니다.
otSrpClientSetKeyLeaseInterval ( otInstance *aInstance, uint32_t aInterval)
void
이 기능은 SRP 업데이트 요청에 사용되는 키 임대 간격을 설정합니다.
otSrpClientSetLeaseInterval ( otInstance *aInstance, uint32_t aInterval)
void
이 기능은 SRP 업데이트 요청에 사용되는 임대 간격을 설정합니다.
otSrpClientSetServiceKeyRecordEnabled ( otInstance *aInstance, bool aEnabled)
void
이 기능은 "서비스 키 레코드 포함" 모드를 활성화/비활성화합니다.
otSrpClientStart ( otInstance *aInstance, const otSockAddr *aServerSockAddr)
이 기능은 SRP 클라이언트 작업을 시작합니다.
otSrpClientStop ( otInstance *aInstance)
void
이 기능은 SRP 클라이언트 작업을 중지합니다.
otSrpServerGetAddressMode ( otInstance *aInstance)
이 함수는 SRP 서버에서 사용 중인 주소 모드를 반환합니다.
otSrpServerGetAnycastModeSequenceNumber ( otInstance *aInstance)
uint8_t
이 함수는 애니캐스트 주소 모드에서 사용되는 시퀀스 번호를 반환합니다.
otSrpServerGetDomain ( otInstance *aInstance)
const char *
이 함수는 SRP 서버에 권한이 부여된 도메인을 반환합니다.
otSrpServerGetLeaseConfig ( otInstance *aInstance, otSrpServerLeaseConfig *aLeaseConfig)
void
이 함수는 SRP 서버 LEASE 및 KEY-LEASE 구성을 반환합니다.
otSrpServerGetNextHost ( otInstance *aInstance, const otSrpServerHost *aHost)
이 함수는 SRP 서버에 등록된 다음 호스트를 반환합니다.
otSrpServerGetState ( otInstance *aInstance)
이 함수는 SRP 서버의 상태를 반환합니다.
otSrpServerHandleServiceUpdateResult ( otInstance *aInstance, otSrpServerServiceUpdateId aId, otError aError)
void
이 기능은 SRP 업데이트 처리 결과를 SRP 서버에 보고합니다.
otSrpServerHostFindNextService (const otSrpServerHost *aHost, const otSrpServerService *aPrevService, otSrpServerServiceFlags aFlags, const char *aServiceName, const char *aInstanceName)
이 함수는 호스트에서 일치하는 다음 서비스를 찾습니다.
otSrpServerHostGetAddresses (const otSrpServerHost *aHost, uint8_t *aAddressesNum)
const otIp6Address *
이 함수는 주어진 호스트의 주소를 반환합니다.
otSrpServerHostGetFullName (const otSrpServerHost *aHost)
const char *
이 함수는 호스트의 전체 이름을 반환합니다.
otSrpServerHostGetNextService (const otSrpServerHost *aHost, const otSrpServerService *aService)
이 함수는 지정된 호스트의 다음 서비스(하위 유형 서비스 제외)를 반환합니다.
otSrpServerHostIsDeleted (const otSrpServerHost *aHost)
bool
이 기능은 SRP 서비스 호스트가 삭제되었는지 알려줍니다.
otSrpServerServiceGetFullName (const otSrpServerService *aService)
const char *
이 함수는 서비스의 전체 서비스 인스턴스 이름을 반환합니다.
otSrpServerServiceGetHost (const otSrpServerService *aService)
이 함수는 서비스 인스턴스가 있는 호스트를 반환합니다.
otSrpServerServiceGetInstanceName (const otSrpServerService *aService)
const char *
이 함수는 서비스의 전체 서비스 인스턴스 이름을 반환합니다.
otSrpServerServiceGetPort (const otSrpServerService *aService)
uint16_t
이 함수는 서비스 인스턴스의 포트를 반환합니다.
otSrpServerServiceGetPriority (const otSrpServerService *aService)
uint16_t
이 함수는 서비스 인스턴스의 우선 순위를 반환합니다.
otSrpServerServiceGetServiceName (const otSrpServerService *aService)
const char *
이 함수는 서비스의 전체 서비스 이름을 반환합니다.
otSrpServerServiceGetServiceSubTypeLabel (const otSrpServerService *aService, char *aLabel, uint8_t aMaxSize)
이 함수는 서비스 이름에서 하위 유형 레이블을 가져옵니다.
otSrpServerServiceGetTxtData (const otSrpServerService *aService, uint16_t *aDataLength)
const uint8_t *
이 함수는 서비스 인스턴스의 TXT 레코드 데이터를 반환합니다.
otSrpServerServiceGetWeight (const otSrpServerService *aService)
uint16_t
이 함수는 서비스 인스턴스의 가중치를 반환합니다.
otSrpServerServiceIsDeleted (const otSrpServerService *aService)
bool
이 기능은 SRP 서비스가 삭제되었는지 여부를 나타냅니다.
otSrpServerServiceIsSubType (const otSrpServerService *aService)
bool
이 기능은 SRP 서비스가 하위 유형인지 여부를 나타냅니다.
otSrpServerSetAddressMode ( otInstance *aInstance, otSrpServerAddressMode aMode)
이 기능은 SRP 서버에서 사용할 주소 모드를 설정합니다.
otSrpServerSetAnycastModeSequenceNumber ( otInstance *aInstance, uint8_t aSequenceNumber)
이 함수는 애니캐스트 주소 모드에서 사용되는 시퀀스 번호를 설정합니다.
otSrpServerSetDomain ( otInstance *aInstance, const char *aDomain)
이 기능은 SRP 서버의 도메인을 설정합니다.
otSrpServerSetEnabled ( otInstance *aInstance, bool aEnabled)
void
이 기능은 SRP 서버를 활성화/비활성화합니다.
otSrpServerSetLeaseConfig ( otInstance *aInstance, const otSrpServerLeaseConfig *aLeaseConfig)
이 기능은 SRP 서버 LEASE 및 KEY-LEASE 구성을 설정합니다.
otSrpServerSetServiceUpdateHandler ( otInstance *aInstance, otSrpServerServiceUpdateHandler aServiceHandler, void *aContext)
void
이 함수는 SRP 서버에서 SRP 서비스 업데이트 핸들러를 설정합니다.

구조체

otSrpClientBuffersServiceEntry

이 구조체는 SRP 클라이언트 서비스 풀 항목을 나타냅니다.

otSrpClientHostInfo

이 구조는 SRP 클라이언트 호스트 정보를 나타냅니다.

otSrp클라이언트 서비스

이 구조는 SRP 클라이언트 서비스를 나타냅니다.

otSrpServerLeaseConfig

이 구조에는 SRP 서버 LEASE 및 KEY-LEASE 구성이 포함됩니다.

열거

익명의 열거형

 anonymous enum
속성
OT_SRP_SERVER_SERVICE_FLAG_ACTIVE

활성(삭제되지 않은) 서비스를 포함합니다.

OT_SRP_SERVER_SERVICE_FLAG_BASE_TYPE

기본 서비스를 포함합니다(하위 유형 아님).

OT_SRP_SERVER_SERVICE_FLAG_DELETED

삭제된 서비스를 포함합니다.

OT_SRP_SERVER_SERVICE_FLAG_SUB_TYPE

하위 유형 서비스를 포함합니다.

익명의 열거형

 anonymous enum
속성
OT_SRP_SERVER_FLAGS_ANY_SERVICE

이 상수가 정의 otSrpServerServiceFlags 모든 서비스 수락 조합 (기재 / 서브 타입, 액티브 / 삭제).

OT_SRP_SERVER_FLAGS_ANY_TYPE_ACTIVE_SERVICE

이 상수는 정의 otSrpServerServiceFlags 활성 서비스를 받아 조합 (삭제하지 않음).

OT_SRP_SERVER_FLAGS_ANY_TYPE_DELETED_SERVICE

이 상수는 정의 otSrpServerServiceFlags 삭제 된 서비스를 받아 조합을.

OT_SRP_SERVER_FLAGS_BASE_TYPE_SERVICE_ONLY

이 상수는 정의 otSrpServerServiceFlags 유일한 기반 서비스를 받아 조합을.

OT_SRP_SERVER_FLAGS_SUB_TYPE_SERVICE_ONLY

이 상수는 정의 otSrpServerServiceFlags 전용 서브 타입의 서비스를 수용 조합.

otSrpClientItemState

 otSrpClientItemState

이 열거는 SRP 클라이언트 항목(서비스 또는 호스트 정보) 상태를 지정합니다.

속성
OT_SRP_CLIENT_ITEM_STATE_ADDING

항목을 추가/등록 중입니다.

OT_SRP_CLIENT_ITEM_STATE_REFRESHING

항목을 새로 고치는 중입니다.

OT_SRP_CLIENT_ITEM_STATE_REGISTERED

아이템이 서버에 등록되었습니다.

OT_SRP_CLIENT_ITEM_STATE_REMOVED

항목이 제거됩니다.

OT_SRP_CLIENT_ITEM_STATE_REMOVING

항목을 제거하는 중입니다.

OT_SRP_CLIENT_ITEM_STATE_TO_ADD

추가/등록할 항목입니다.

OT_SRP_CLIENT_ITEM_STATE_TO_REFRESH

갱신할 항목(리스 갱신을 위해 재등록).

OT_SRP_CLIENT_ITEM_STATE_TO_REMOVE

제거할 항목입니다.

otSrpServerAddressMode

 otSrpServerAddressMode

이 열거는 SRP 서버에서 사용하는 주소 모드를 나타냅니다.

주소 모드는 주소와 포트 번호가 SRP 서버에 의해 결정되는 방식과 이 정보가 스레드 네트워크 데이터에 게시되는 방식을 지정합니다.

속성
OT_SRP_SERVER_ADDRESS_MODE_ANYCAST

애니캐스트 주소 모드.

OT_SRP_SERVER_ADDRESS_MODE_UNICAST

유니캐스트 주소 모드.

otSrp서버 상태

 otSrpServerState

SRP 서버의 상태를 나타냅니다.

속성
OT_SRP_SERVER_STATE_DISABLED

SRP 서버가 비활성화되었습니다.

OT_SRP_SERVER_STATE_RUNNING

SRP 서버가 실행 중입니다.

OT_SRP_SERVER_STATE_STOPPED

SRP 서버가 중지되었습니다.

형식 정의

otSrpClientAutoStart콜백

void(* otSrpClientAutoStartCallback)(const otSockAddr *aServerSockAddr, void *aContext)

이 함수 포인터 유형은 SRP 클라이언트가 자동 시작 또는 중지될 때 사용자에게 알리기 위해 사용하는 콜백을 정의합니다.

자동 시작 기능의 경우에만 사용됩니다 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 활성화됩니다.

이 콜백은 자동 시작 모드가 활성화되고 SRP 클라이언트가 자동으로 시작되거나 중지될 때 호출됩니다.

세부
매개변수
[in] aServerSockAddress
NULL이 아닌 포인터는 SRP 서버가 시작되었음을 나타내며 포인터는 선택한 서버 소켓 주소를 제공합니다. NULL 포인터는 SRP 서버가 중지되었음을 나타냅니다.
[in] aContext
임의의 컨텍스트에 대한 포인터(콜백이 등록될 때 제공됨).

otSrpClientBuffersServiceEntry

struct otSrpClientBuffersServiceEntry otSrpClientBuffersServiceEntry

이 구조체는 SRP 클라이언트 서비스 풀 항목을 나타냅니다.

otSrpClient콜백

void(* otSrpClientCallback)(otError aError, const otSrpClientHostInfo *aHostInfo, const otSrpClientService *aServices, const otSrpClientService *aRemovedServices, void *aContext)

이 함수 포인터 유형은 사용자에게 변경/이벤트/오류를 알리기 위해 SRP 클라이언트에서 사용하는 콜백을 정의합니다.

이 콜백은 SRP 서버에 업데이트를 성공적으로 등록(예: 호스트 정보 및/또는 일부 서비스 추가/제거)하거나 실패 또는 오류가 있는 경우(예: 서버가 업데이트를 거부할 때) 호출됩니다. 요청 또는 클라이언트가 응답을 기다리는 시간 초과 등).

업데이 트를 성공적으로 재 등록의 경우, aError 매개 변수는 것 OT_ERROR_NONE 및 호스트 정보와 서비스의 전체 목록은 콜백에 입력 매개 변수로 제공됩니다. 호스트 정보와 서비스를 각각 대응하는 자체 상태 추적 유의 mState 관련 데이터 구조의 멤버 변수 (호스트 정보 / 서비스 등을 추가 / 제거되는 아직 등록 또는 제거하거나 하는지를 나타내는 상태).

제거 된 서비스의 목록은 자신의 연결리스트로 전달 aRemovedServices 콜백한다. 참고 콜백이 호출 될 때 SRP 클라이언트 (OpenThread 구현)에 나열된 제거 서비스 인스턴스로 이루어집니다 aRemovedServices 더 이상 트랙 / 저장한다 (즉, 우리가 전화 콜백에서 경우 otSrpClientGetServices() 제거 된 서비스가되지 않습니다 반환된 목록에 있음). 콜백에서 제거된 서비스의 별도 목록을 제공하면 사용자에게 현재 제거된 항목을 표시하고 사용자가 인스턴스를 다시 요청/재사용할 수 있도록 합니다.

서버가 SRP 업데이트 요청을 거부하면 DNS 응답 코드(RFC 2136)가 다음 오류에 매핑됩니다.

  • (0) NOERROR 성공(오류 조건 없음) -> OT_ERROR_NONE
  • (1) FORMERR 서버가 형식 오류로 인해 해석할 수 없음 -> OT_ERROR_PARSE
  • (2) SERVFAIL 서버에 내부 오류 발생 -> OT_ERROR_FAILED
  • (3) 존재해야 할 NXDOMAIN 이름, 존재하지 않음 -> OT_ERROR_NOT_FOUND
  • (4) NOTIMP Server는 쿼리 유형(OpCode) -> OT_ERROR_NOT_IMPLEMENTED를 지원하지 않습니다.
  • (5) REFUSED 정책/보안상의 이유로 서버 거부 -> OT_ERROR_SECURITY
  • (6) YXDOMAIN 존재해서는 안 되는 이름이 존재함 -> OT_ERROR_DUPLICATED
  • (7) YXRRSET 존재하지 않아야 할 일부 RRset이 존재함 -> OT_ERROR_DUPLICATED
  • (8) NXRRSET 존재해야 할 일부 RRset이 존재하지 않음 -> OT_ERROR_NOT_FOUND
  • (9) NOTAUTH 서비스는 영역 -> OT_ERROR_SECURITY에 대한 권한이 없습니다.
  • (10) NOTZONE 영역에 이름이 없습니다 -> OT_ERROR_PARSE
  • (20) BADNAME 잘못된 이름 -> OT_ERROR_PARSE
  • (21) BADALG 잘못된 알고리즘 -> OT_ERROR_SECURITY
  • (22) BADTRUN 잘못된 잘림 -> OT_ERROR_PARSE
  • 기타 응답 코드 -> OT_ERROR_FAILED

다음 오류도 발생할 수 있습니다.

  • OT_ERROR_RESPONSE_TIMEOUT : 서버의 응답을 기다리는 동안 시간이 초과되었습니다(클라이언트가 계속 재시도함).
  • OT_ERROR_INVALID_ARGS : 제공된 서비스의 구조가 유효하지 않습니다 (예를 들어, 나쁜 서비스 이름 또는 otDnsTxtEntry ).
  • OT_ERROR_NO_BUFS : 업데이트 메시지를 준비하거나 보낼 버퍼가 부족합니다.

오류가 발생한 경우 클라이언트는 작업을 계속합니다. 즉, 약간의 대기 간격 후에 SRP 업데이트 메시지를 준비하고 서버에 (재)전송합니다. 재시은 (매개 변수 구성을 참조하십시오 최소 값과 간격 시작을 기다리고 성장 인자 최대 값으로 모든 실패 최대로 증가 OPENTHREAD_CONFIG_SRP_CLIENT_MIN_RETRY_WAIT_INTERVAL 및 자세한 내용은 관련 것들).

세부
매개변수
[in] aError
오류(위 참조).
[in] aHostInfo
호스트 정보에 대한 포인터입니다.
[in] aService
모든 서비스(제거된 서비스 제외)를 포함하는 연결 목록의 머리입니다. 목록이 비어 있으면 NULL입니다.
[in] aRemovedServices
제거된 모든 서비스를 포함하는 연결 목록의 머리입니다. 목록이 비어 있으면 NULL입니다.
[in] aContext
임의의 컨텍스트에 대한 포인터(콜백이 등록될 때 제공됨).

otSrpClientHostInfo

struct otSrpClientHostInfo otSrpClientHostInfo

이 구조는 SRP 클라이언트 호스트 정보를 나타냅니다.

otSrp클라이언트 서비스

struct otSrpClientService otSrpClientService

이 구조는 SRP 클라이언트 서비스를 나타냅니다.

이 구조체의 인스턴스에서 OpenThread로 전달 된 후 이름과 TXT 레코드 항목의 문자열 버퍼를 포함하여이 구성에서의 값은, 유지 및 여행 일정해야 otSrpClientAddService() 또는 otSrpClientRemoveService() .

otSrpServerAddressMode

enum otSrpServerAddressMode otSrpServerAddressMode

이 열거는 SRP 서버에서 사용하는 주소 모드를 나타냅니다.

주소 모드는 주소와 포트 번호가 SRP 서버에 의해 결정되는 방식과 이 정보가 스레드 네트워크 데이터에 게시되는 방식을 지정합니다.

otSrp서버호스트

struct otSrpServerHost otSrpServerHost

이 불투명한 유형은 SRP 서비스 호스트를 나타냅니다.

otSrpServerLeaseConfig

struct otSrpServerLeaseConfig otSrpServerLeaseConfig

이 구조에는 SRP 서버 LEASE 및 KEY-LEASE 구성이 포함됩니다.

otSrp서버 서비스

struct otSrpServerService otSrpServerService

이 불투명한 유형은 SRP 서비스를 나타냅니다.

otSrpServerServiceFlags

uint8_t otSrpServerServiceFlags

SRP 서비스 목록에서 검색(또는 반복)할 때 포함하거나 제외할 서비스를 나타내는 서비스 플래그 유형입니다.

이것은 비트 플래그의 조합입니다. 특정 비트 플래그는 열거 형에 정의되어 OT_SRP_SERVER_FLAG_* .

otSrpServerServiceUpdateHandler

void(* otSrpServerServiceUpdateHandler)(otSrpServerServiceUpdateId aId, const otSrpServerHost *aHost, uint32_t aTimeout, void *aContext)

이 기능은 SRP 서비스 업데이트를 처리합니다.

이 기능은 SRP 호스트와 SRP 서비스가 업데이트되고 있음을 알리기 위해 SRP 서버에 의해 호출됩니다. 이 핸들러가 후에 otSrpServerHandleServiceUpdateResult 또는 배를 호출하여 결과를 반환 할 때까지 SRP 업데이트를 약속하지 않는 것이 중요합니다 aTimeout .

SRP 서비스 관찰자는 업데이트 이벤트를 수신한 직후 오류 코드 OT_ERROR_NONE과 함께 항상 otSrpServerHandleServiceUpdateResult를 호출해야 합니다.

보다 일반적인 핸들러는 SRP 호스트/서비스에 대한 유효성 검사를 수행하고 유효성 검사가 실패하면 SRP 업데이트를 거부할 수 있습니다. 예를 들어, 광고 프록시는 멀티캐스트 가능 링크에서 호스트와 서비스를 광고(또는 제거)해야 하며 오류가 발생하면 특정 오류 코드를 반환해야 합니다.

세부
매개변수
[in] aId
서비스 업데이트 트랜잭션 ID입니다. 이 ID로 다시 전달해야 otSrpServerHandleServiceUpdateResult .
[in] aHost
SRP 업데이트를 포함하는 otSrpServerHost 개체에 대한 포인터입니다. 처리기는 호스트를 게시/게시 취소해야 하며 각 서비스는 아래 규칙에 따라 이 호스트를 가리킵니다.
  1. 호스트 (로 표시 삭제되지 않는 경우 otSrpServerHostIsDeleted ), 그것은 게시 또는 mDNS를 업데이트해야합니다. 그렇지 않으면 호스트가 게시 취소되어야 합니다(AAAA RR 제거).
  2. 이 호스트에 대한 각 서비스 지점에 대해 호스트가 게시 취소되면 게시 취소되어야 합니다. 그렇지 않으면, 핸들러 게시하거나 삭제하지 않을 경우 서비스를 업데이트해야합니다 (로 표시 otSrpServerServiceIsDeleted ) 및 삭제 할 때의 선택을 취소 게시 할 수 있습니다.
[in] aTimeout
핸들러가 서비스 이벤트를 처리하는 최대 시간(밀리초)입니다.
[in] aContext
애플리케이션별 컨텍스트에 대한 포인터입니다.
또한보십시오:
otSrpServerSetServiceUpdateHandler
otSrpServerHandleServiceUpdate결과

otSrpServerServiceUpdateId

uint32_t otSrpServerServiceUpdateId

SRP 서버에서 SRP 서비스 업데이트 트랜잭션의 ID입니다.

기능

otSrpClientAddService

otError otSrpClientAddService(
  otInstance *aInstance,
  otSrpClientService *aService
)

서버에 등록할 서비스를 추가하는 기능입니다.

이 함수를 성공적으로 호출 한 후, otSrpClientCallback SRP 서버와 서비스 추가 / 등록의 상태를보고하기 위해 호출됩니다.

otSrpClientService 인스턴스에 의해 지시되는 aService 유지하고 (이 함수에서 복귀 한 후 그대로 유지해야 OT_ERROR_NONE ). OpenThread는 서비스 인스턴스에 대한 포인터를 저장합니다.

otSrpClientService 인스턴스는 더 이상 OpenThread에 의해 추적되지 않고 경우에만 재생 될 수있다

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aService
A와 포인터 otSrpClientService 인스턴스를 추가합니다.
반환 값
OT_ERROR_NONE
서비스 추가가 성공적으로 시작되었습니다. otSrpClientCallback 상태를보고하기 위해 호출됩니다.
OT_ERROR_ALREADY
동일한 서비스 및 인스턴스 이름을 가진 서비스가 이미 목록에 있습니다.
OT_ERROR_INVALID_ARGS
서비스 구조 (예, 나쁜 서비스 이름 또는 잘못된 otDnsTxtEntry ).

otSrpClientBuffersAllocateService

otSrpClientBuffersServiceEntry * otSrpClientBuffersAllocateService(
  otInstance *aInstance
)

이 함수는 풀에서 새 서비스 항목을 할당합니다.

반환된 서비스 항목 인스턴스는 다음과 같이 초기화됩니다.

  • mService.mName 함수를 사용하여 검색 될 수있는 할당 된 문자열 버퍼를 가리 otSrpClientBuffersGetServiceEntryServiceNameString() .
  • mService.mInstanceName 함수를 사용하여 검색 될 수있는 할당 된 문자열 버퍼를 가리 otSrpClientBuffersGetServiceEntryInstanceNameString() .
  • mService.mSubTypeLabels 에서 반환 된 배열 포인트 otSrpClientBuffersGetSubTypeLabelsArray() .
  • mService.mTxtEntries 가리 킵니다 mTxtEntry .
  • mService.mNumTxtEntries 하나로 설정됩니다.
  • 다른 mService 필드 (포트, 우선 순위, 체중)은 0으로 설정됩니다.
  • mTxtEntry.mKey (값이 이미 부호화로 처리된다) NULL로 설정된다.
  • mTxtEntry.mValue 함수를 사용하여 검색 될 수있는 할당 된 버퍼를 가리 otSrpClientBuffersGetServiceEntryTxtBuffer() .
  • mTxtEntry.mValueLength 0으로 설정됩니다.
  • 모든 관련 데이터/문자열 버퍼 및 배열이 모두 0으로 지워집니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
새로 할당된 서비스 항목에 대한 포인터이거나 풀에서 더 이상 항목을 사용할 수 없는 경우 NULL입니다.

otSrpClientBuffersFreeAllServices

void otSrpClientBuffersFreeAllServices(
  otInstance *aInstance
)

이 기능은 이전에 할당된 모든 서비스 항목을 해제합니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.

otSrpClientBuffersFreeService

void otSrpClientBuffersFreeService(
  otInstance *aInstance,
  otSrpClientBuffersServiceEntry *aService
)

이 기능은 이전에 할당된 서비스 항목을 해제합니다.

aService 이전에 사용하여 할당되어야한다 otSrpClientBuffersAllocateService() 아직 해제되지 않습니다. 그렇지 않으면 이 함수의 동작이 정의되지 않습니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aService
해제할 서비스 항목에 대한 포인터입니다(NULL이 아니어야 함).

otSrpClientBuffersGetHostAddressesArray

otIp6Address * otSrpClientBuffersGetHostAddressesArray(
  otInstance *aInstance,
  uint8_t *aArrayLength
)

이 함수는 SRP 클라이언트 호스트 주소 목록으로 사용할 IPv6 주소 항목의 배열을 가져옵니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[out] aArrayLength
배열 길이, 즉 배열의 IPv6 주소 항목 수를 반환하는 변수에 대한 포인터입니다(NULL이 아니어야 함).
보고
배열 포인터 otIp6Address 엔트리 (엔트리 번호에 반환 aArrayLength ).

otSrpClientBuffersGetHostNameString

char * otSrpClientBuffersGetHostNameString(
  otInstance *aInstance,
  uint16_t *aSize
)

이 함수는 SRP 클라이언트 호스트 이름에 사용할 문자열 버퍼를 가져옵니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[out] aSize
문자열 버퍼의 크기(바이트 수)를 반환하는 변수에 대한 포인터(NULL이 아니어야 함).
보고
SRP 클라이언트 호스트 이름에 사용할 char 버퍼에 대한 포인터입니다.

otSrpClientBuffersGetServiceEntryInstanceNameString

char * otSrpClientBuffersGetServiceEntryInstanceNameString(
  otSrpClientBuffersServiceEntry *aEntry,
  uint16_t *aSize
)

이 함수는 서비스 항목에서 서비스 인스턴스 이름에 대한 문자열 버퍼를 가져옵니다.

세부
매개변수
[in] aEntry
이전에 할당된 서비스 항목에 대한 포인터(NULL이 아니어야 함).
[out] aSize
문자열 버퍼의 크기(바이트 수)를 반환하는 변수에 대한 포인터입니다(NULL이 아니어야 함).
보고
문자열 버퍼에 대한 포인터입니다.

otSrpClientBuffersGetServiceEntryServiceNameString

char * otSrpClientBuffersGetServiceEntryServiceNameString(
  otSrpClientBuffersServiceEntry *aEntry,
  uint16_t *aSize
)

이 함수는 서비스 항목에서 서비스 이름에 대한 문자열 버퍼를 가져옵니다.

세부
매개변수
[in] aEntry
이전에 할당된 서비스 항목에 대한 포인터(NULL이 아니어야 함).
[out] aSize
문자열 버퍼의 크기(바이트 수)를 반환하는 변수에 대한 포인터입니다(NULL이 아니어야 함).
보고
문자열 버퍼에 대한 포인터입니다.

otSrpClientBuffersGetServiceEntryTxtBuffer

uint8_t * otSrpClientBuffersGetServiceEntryTxtBuffer(
  otSrpClientBuffersServiceEntry *aEntry,
  uint16_t *aSize
)

이 함수는 서비스 항목에서 TXT 레코드에 대한 버퍼를 가져옵니다.

세부
매개변수
[in] aEntry
이전에 할당된 서비스 항목에 대한 포인터(NULL이 아니어야 함).
[out] aSize
버퍼의 크기(바이트 수)를 반환하는 변수에 대한 포인터입니다(NULL이 아니어야 함).
보고
버퍼에 대한 포인터입니다.

otSrpClientBuffersGetSubTypeLabelsArray

const char ** otSrpClientBuffersGetSubTypeLabelsArray(
  otSrpClientBuffersServiceEntry *aEntry,
  uint16_t *aArrayLength
)

이 함수는 서비스 항목에서 서비스 하위 유형 레이블에 대한 배열을 가져옵니다.

세부
매개변수
[in] aEntry
이전에 할당된 서비스 항목에 대한 포인터(NULL이 아니어야 함).
[out] aArrayLength
배열 길이를 반환할 변수에 대한 포인터입니다(NULL이 아니어야 함).
보고
배열에 대한 포인터입니다.

otSrpClientClearHostAndServices

void otSrpClientClearHostAndServices(
  otInstance *aInstance
)

이 기능은 모든 호스트 정보와 모든 서비스를 지웁니다.

달리 otSrpClientRemoveHostAndServices() 모든 정보를 제거하기 위해 서버에 업데이트 메시지를 전송하는이 기능은 서버와의 상호 작용없이 즉시 모든 정보를 삭제합니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.

otSrpClientClearService

otError otSrpClientClearService(
  otInstance *aInstance,
  otSrpClientService *aService
)

이 기능은 서비스를 지우고 클라이언트 서비스 목록에서 즉시 제거합니다.

달리 otSrpClientRemoveService() 서비스를 제거하기 위해 서버에 업데이트 메시지를 전송,이 기능은 서버와의 상호 작용없이 클라이언트의 서비스 목록에서 서비스를 지 웁니다. 이 함수를 성공적으로 호출에서 otSrpClientCallback 호출되지 않습니다 및 aService 항목이 재생 될 수 있으며, 즉시 발신자가 재를 사용하는.

이 함수에 대한 후속 호출과 함께 이용 될 수 otSrpClientAddService() (잠재적으로 동일한 재사용 aService 기존 서비스 파라미터들을 업데이트하기 위해 동일한 서비스 인스턴스 이름 항목).

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aService
A와 포인터 otSrpClientService 인스턴스를 삭제합니다.
반환 값
OT_ERROR_NONE
aService 성공적으로 삭제됩니다. 즉시 회수하여 재사용할 수 있습니다.
OT_ERROR_NOT_FOUND
목록에서 서비스를 찾을 수 없습니다.

otSrpClientDisableAutoStartMode

void otSrpClientDisableAutoStartMode(
  otInstance *aInstance
)

이 기능은 자동 시작 모드를 비활성화합니다.

자동 시작 기능의 경우에만 사용할 수 있습니다 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 활성화됩니다.

자동 시작 모드를 비활성화하면 클라이언트가 이미 실행 중인 경우 클라이언트가 중지되지 않지만 클라이언트는 선택한 SRP 서버가 여전히 존재하는지 확인하기 위해 스레드 네트워크 데이터 모니터링을 중지합니다.

를 호출합니다 otSrpClientStop() 도 자동 시작 모드를 비활성화합니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.

otSrpClientEnableAutoStartMode

void otSrpClientEnableAutoStartMode(
  otInstance *aInstance,
  otSrpClientAutoStartCallback aCallback,
  void *aContext
)

이 기능은 자동 시작 모드를 활성화합니다.

자동 시작 기능의 경우에만 사용할 수 있습니다 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 활성화됩니다.

구성은 옵션 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_DEFAULT_MODE (가 활성화 또는 OT 스택의 시작 비활성화 여부를) 지정 기본 자동 시작 모드.

자동 시작이 활성화되면 SRP 클라이언트는 SRP 서버 서비스 항목에 대한 스레드 네트워크 데이터를 모니터링하고 SRP 서버가 감지되면 클라이언트를 자동으로 시작 및 중지합니다.

여러 SRP 서버가 발견되면 임의의 서버가 선택됩니다. 선택한 SRP 서버가 더 이상 감지되지 않으면(더 이상 스레드 네트워크 데이터에 없음) SRP 클라이언트가 중지되고 다른 SRP 서버(사용 가능한 경우)로 전환될 수 있습니다.

SRP에 클라이언트가 명시 적으로에 성공적으로 호출을 통해 시작되면 otSrpClientStart() 에서 주어진 SRP 서버 주소 otSrpClientStart() 자동 시작 모드의 상태에 관계없이 계속 사용됩니다 같은 SRP 서버 주소가 발견되는지 여부 스레드 네트워크 데이터에서. 이 경우, 명시 적 otSrpClientStop() 호출은 클라이언트를 중지합니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aCallback
클라이언트가 자동 시작/중지될 때 알리는 콜백입니다. 필요하지 않은 경우 NULL일 수 있습니다.
[in] aContext
컨텍스트는 호출 할 때 전달되는 aCallback .

otSrpClientGetDomainName

const char * otSrpClientGetDomainName(
  otInstance *aInstance
)

이 함수는 SRP 클라이언트에서 사용 중인 도메인 이름을 가져옵니다.

이 기능은 필요 OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE 가 활성화되어 있어야합니다.

도메인 이름이 설정되지 않은 경우 "default.service.arpa"가 사용됩니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
도메인 이름 문자열입니다.

otSrpClientGetHostInfo

const otSrpClientHostInfo * otSrpClientGetHostInfo(
  otInstance *aInstance
)

이 함수는 호스트 정보를 가져옵니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
호스트 정보 구조에 대한 포인터입니다.

otSrpClientGetKeyLeaseInterval

uint32_t otSrpClientGetKeyLeaseInterval(
  otInstance *aInstance
)

이 함수는 SRP 업데이트 요청에 사용된 키 임대 간격을 가져옵니다.

이것은 SRP 클라이언트가 요청한 임대 기간입니다. 서버는 다른 임대 간격을 수락하도록 선택할 수 있습니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
키 임대 간격(초)입니다.

otSrpClientGetLeaseInterval

uint32_t otSrpClientGetLeaseInterval(
  otInstance *aInstance
)

이 함수는 SRP 업데이트 요청에 사용된 임대 간격을 가져옵니다.

이것은 SRP 클라이언트가 요청한 임대 기간입니다. 서버는 다른 임대 간격을 수락하도록 선택할 수 있습니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
임대 간격(초)입니다.

otSrpClientGetServerAddress

const otSockAddr * otSrpClientGetServerAddress(
  otInstance *aInstance
)

이 함수는 SRP 클라이언트가 사용 중인 SRP 서버의 소켓 주소(IPv6 주소 및 포트 번호)를 가져옵니다.

클라이언트가 실행 중이 아니면 주소가 지정되지 않고(모두 0) 포트 번호가 0입니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
SRP 서버의 소켓 주소에 대한 포인터(항상 NULL이 아님).

otSrpClientGetServices

const otSrpClientService * otSrpClientGetServices(
  otInstance *aInstance
)

이 함수는 클라이언트가 관리하는 서비스 목록을 가져옵니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
모든 서비스의 연결 목록 헤드에 대한 포인터이거나 목록이 비어 있는 경우 NULL입니다.

otSrpClientIsAutoStartModeEnabled

bool otSrpClientIsAutoStartModeEnabled(
  otInstance *aInstance
)

이 기능은 자동 시작 모드의 현재 상태(활성화 또는 비활성화)를 나타냅니다.

자동 시작 기능의 경우에만 사용할 수 있습니다 OPENTHREAD_CONFIG_SRP_CLIENT_AUTO_START_API_ENABLE 활성화됩니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
자동 시작 모드가 활성화되면 TRUE, 그렇지 않으면 FALSE입니다.

otSrp 클라이언트가 실행 중입니다.

bool otSrpClientIsRunning(
  otInstance *aInstance
)

이 기능은 SRP 클라이언트가 실행 중인지 여부를 나타냅니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
SRP 클라이언트가 실행 중이면 TRUE, 그렇지 않으면 FALSE입니다.

otSrpClientIsServiceKeyRecordEnabled

bool otSrpClientIsServiceKeyRecordEnabled(
  otInstance *aInstance
)

이 메서드는 "서비스 키 레코드 포함" 모드가 활성화되었는지 비활성화되었는지 여부를 나타냅니다.

경우에는이 기능을 사용할 수 있습니다 OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE 구성을 사용할 수 있습니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
"서비스 키 레코드 포함" 모드가 활성화되면 TRUE이고 그렇지 않으면 FALSE입니다.

otSrpClientItemStateToString

const char * otSrpClientItemStateToString(
  otSrpClientItemState aItemState
)

이 함수는 변환 otSrpClientItemState 문자열로.

세부
매개변수
[in] aItemState
항목 상태입니다.
보고
의 문자열 표현 aItemState .

otSrpClientRemoveHostAndServices

otError otSrpClientRemoveHostAndServices(
  otInstance *aInstance,
  bool aRemoveKeyLease,
  bool aSendUnregToServer
)

이 기능은 호스트 정보 및 모든 서비스의 제거 프로세스를 시작합니다.

이 함수에서 돌아온 후, otSrpClientCallback SRP 서버에 삭제 요청의 상태를보고하기 위해 호출됩니다.

호스트 정보를 영구적으로 서버에서 제거 할 경우, aRemoveKeyLease 로 설정해야 true 서버 호스트와 관련된 키리스를 제거합니다. 그렇지 않으면 키 임대 레코드가 이전과 같이 유지되므로 클라이언트가 다시 한 번 서비스를 제공하고 등록할 수 있을 때를 위해 서버가 호스트 이름을 예약해 둡니다.

aSendUnregToServer 호스트 정보가 아직 서버에 등록되지 않은 동작을 결정합니다. 경우 aSendUnregToServer 설정되어 false (기본 / 기대 값 인) 다음 SRP 클라이언트는 즉시 서버 (아무것도 아직 등록하지 않은 경우 서버를 업데이트 할 필요가 없습니다)에 업데이트 메시지를 보내지 않고 호스트 정보 및 서비스를 제거합니다. 경우 aSendUnregToServer 설정되어 true 다음 SRP 클라이언트는 서버에 업데이트 메시지를 보내드립니다. 참고 호스트 정보는 다음 등록되어있는 경우의 값 것을 aSendUnregToServer 중요하지 않고 SRP 클라이언트가 항상 모든 정보의 삭제를 요청하는 서버에 업데이트 메시지를 보내드립니다.

하나의 상황 aSendUnregToServer 유용 할 수는 장치 재설정 / 재부팅에 발신자는 서버와 이전에 등록 된 서비스를 제거 할 수 있습니다. 이러한 경우, 호출자가 가능 otSrpClientSetHostName() 다음과 요청 otSrpClientRemoveHostAndServices()aSendUnregToServer 같이 true .

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aRemoveKeyLease
호스트 키 임대도 제거해야 하는지 여부를 나타내는 부울입니다.
[in] aSendUnregToServer
호스트 정보가 등록되지 않은 경우 서버에 업데이트를 보낼지 여부를 나타내는 부울입니다.
반환 값
OT_ERROR_NONE
호스트 정보 및 서비스 제거가 성공적으로 시작되었습니다. otSrpClientCallback 상태를보고하기 위해 호출됩니다.
OT_ERROR_ALREADY
호스트 정보가 이미 제거되었습니다.

otSrpClientRemoveService

otError otSrpClientRemoveService(
  otInstance *aInstance,
  otSrpClientService *aService
)

이 함수는 서비스를 서버에 등록 해제하도록 요청합니다.

이 함수를 성공적으로 호출 한 후, otSrpClientCallback SRP 서버에 삭제 요청의 상태를보고하기 위해 호출됩니다.

otSrpClientService 인스턴스에 의해 지시되는 aService 유지하고 (이 함수에서 복귀 한 후 그대로 유지해야 OT_ERROR_NONE ). OpenThread는 제거 프로세스 동안 서비스 인스턴스를 유지합니다. 유일한 후 otSrpClientCallback 서비스 인스턴스를 나타내는라고 SRP 클라이언트 서비스 목록에서 제거되고 재사용 / 해제 할 수 있습니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aService
A와 포인터 otSrpClientService 인스턴스를 제거합니다.
반환 값
OT_ERROR_NONE
서비스 제거가 성공적으로 시작되었습니다. otSrpClientCallback 상태를보고하기 위해 호출됩니다.
OT_ERROR_NOT_FOUND
목록에서 서비스를 찾을 수 없습니다.

otSrpClientSet콜백

void otSrpClientSetCallback(
  otInstance *aInstance,
  otSrpClientCallback aCallback,
  void *aContext
)

이 함수는 SRP 클라이언트의 이벤트/변경 사항을 호출자에게 알리도록 콜백을 설정합니다.

SRP 클라이언트는 단일 콜백을 등록할 수 있습니다. 따라서 이 함수에 대한 연속 호출은 이전에 설정된 콜백 함수를 덮어씁니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aCallback
이벤트 및 변경 사항을 알리는 콜백입니다. 필요하지 않은 경우 NULL일 수 있습니다.
[in] aContext
함께 사용되는 임의의 문맥 aCallback .

otSrpClientSetDomainName

otError otSrpClientSetDomainName(
  otInstance *aInstance,
  const char *aName
)

이 기능은 SRP 클라이언트에서 사용할 도메인 이름을 설정합니다.

이 기능은 필요 OPENTHREAD_CONFIG_SRP_CLIENT_DOMAIN_NAME_API_ENABLE 가 활성화되어 있어야합니다.

설정하지 않으면 "default.service.arpa"가 사용됩니다.

이름 문자열 버퍼가 가리키는 aName 지속이 기능에서 돌아온 후 변경 유지해야합니다. OpenThread는 문자열에 대한 포인터를 유지합니다.

도메인 이름은 클라이언트가 시작되기 전에 설정하거나 할 수 있습니다 시작 후하지만 호스트 정보는 (호스트 정보 중 하나에 있어야합니다 서버에 등록하기 전에 STATE_TO_ADD 또는 STATE_TO_REMOVE ).

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aName
도메인 이름 문자열에 대한 포인터입니다. NULL이면 기본 "default.service.arpa"로 설정됩니다.
반환 값
OT_ERROR_NONE
도메인 이름 레이블이 성공적으로 설정되었습니다.
OT_ERROR_INVALID_STATE
호스트 정보는 이미 서버에 등록되어 있습니다.

otSrpClientSetHostAddresses

otError otSrpClientSetHostAddresses(
  otInstance *aInstance,
  const otIp6Address *aIp6Addresses,
  uint8_t aNumAddresses
)

이 기능은 호스트 IPv6 주소 목록을 설정/업데이트합니다.

호스트 IPv6 주소는 호스트 정보가 제거되는 경우를 제외하고(예: 이전에 등록된 호스트 주소를 추가/제거 또는 변경하기 위해) SRP 클라이언트를 시작하기 전이나 작동하는 동안 설정/변경할 수 있습니다(클라이언트가 이전 호스트의 제거 요청을 처리하는 중). 에 전화 otSrpClientRemoveHostAndServices() 및 호스트 정보는 여전히 중 하나에있는 STATE_TO_REMOVE 또는 STATE_REMOVING 상태).

가리키는 호스트의 IPv6 주소 어레이 aAddresses 유지하고 (이 함수에서 복귀 한 후 그대로 유지해야 OT_ERROR_NONE ). OpenThread는 배열에 대한 포인터를 저장합니다.

이 함수를 성공적으로 호출 한 후, otSrpClientCallback SRP 서버와 주소 등록의 상태를보고하기 위해 호출됩니다.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aAddresses
호스트 IPv6 주소가 포함된 배열에 대한 포인터입니다.
[in] aNumAddresses
의 주소의 수 aAddresses 배열.
반환 값
OT_ERROR_NONE
호스트 IPv6 주소 목록 변경이 성공적으로 시작되었습니다. otSrpClientCallback 서버 주소를 등록 상태를보고하기 위해 호출됩니다.
OT_ERROR_INVALID_ARGS
주소 목록이 잘못되었습니다(예: 주소를 하나 이상 포함해야 함).
OT_ERROR_INVALID_STATE
호스트가 제거 중이므로 호스트 주소를 변경할 수 없습니다.

otSrpClientSet호스트 이름

otError otSrpClientSetHostName(
  otInstance *aInstance,
  const char *aName
)

이 함수는 호스트 이름 레이블을 설정합니다.

이 함수를 성공적으로 호출 한 후, otSrpClientCallback SRP 서버와 호스트 정보 등록의 상태를보고하기 위해 호출됩니다.

이름 문자열 버퍼가 가리키는 aName 지속이 기능에서 돌아온 후 변경 유지해야합니다. OpenThread는 문자열에 대한 포인터를 유지합니다.

호스트 이름은 클라이언트가 시작되기 전에 설정하거나 할 수 있습니다 시작 후하지만 호스트 정보는 (호스트 정보 중 하나에 있어야합니다 서버에 등록하기 전에 STATE_TO_ADD 또는 STATE_REMOVED ).

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aName
호스트 이름 레이블 문자열에 대한 포인터(NULL이 아니어야 함). 문자열 버퍼에 대한 포인터는 이 함수에서 반환된 후에도 유효하고 일정하게 유지되어야 합니다(MUST).
반환 값
OT_ERROR_NONE
호스트 이름 레이블이 성공적으로 설정되었습니다.
OT_ERROR_INVALID_ARGS
aName NULL입니다.
OT_ERROR_INVALID_STATE
호스트 이름은 이미 설정되어 서버에 등록되어 있습니다.

otSrpClientSetKeyLeaseInterval

void otSrpClientSetKeyLeaseInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

이 기능은 SRP 업데이트 요청에 사용되는 키 임대 간격을 설정합니다.

임대 간격을 변경해도 이미 등록된 서비스/호스트 정보의 허용된 임대 간격에는 영향을 미치지 않습니다. It only affects any future SRP update messages (ie, adding new services and/or refreshes of existing services).

세부
매개변수
[in] aInstance
A pointer to the OpenThread instance.
[in] aInterval
The key lease interval (in seconds). If zero, the default value specified by OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_KEY_LEASE would be used.

otSrpClientSetLeaseInterval

void otSrpClientSetLeaseInterval(
  otInstance *aInstance,
  uint32_t aInterval
)

This function sets the lease interval used in SRP update requests.

Changing the lease interval does not impact the accepted lease interval of already registered services/host-info. It only affects any future SRP update messages (ie, adding new services and/or refreshes of the existing services).

세부
매개변수
[in] aInstance
A pointer to the OpenThread instance.
[in] aInterval
The lease interval (in seconds). If zero, the default value specified by OPENTHREAD_CONFIG_SRP_CLIENT_DEFAULT_LEASE would be used.

otSrpClientSetServiceKeyRecordEnabled

void otSrpClientSetServiceKeyRecordEnabled(
  otInstance *aInstance,
  bool aEnabled
)

This function enables/disables "service key record inclusion" mode.

When enabled, SRP client will include KEY record in Service Description Instructions in the SRP update messages that it sends.

This function is available when OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE configuration is enabled.

세부
매개변수
[in] aInstance
A pointer to the OpenThread instance.
[in] aEnabled
TRUE to enable, FALSE to disable the "service key record inclusion" mode.

otSrpClientStart

otError otSrpClientStart(
  otInstance *aInstance,
  const otSockAddr *aServerSockAddr
)

This function starts the SRP client operation.

SRP client will prepare and send "SRP Update" message to the SRP server once all the following conditions are met:

It does not matter in which order these functions are called. When all conditions are met, the SRP client will wait for a short delay before preparing an "SRP Update" message and sending it to server. This delay allows for user to add multiple services and/or IPv6 addresses before the first SRP Update message is sent (ensuring a single SRP Update is sent containing all the info). The config OPENTHREAD_CONFIG_SRP_CLIENT_UPDATE_TX_DELAY specifies the delay interval.

세부
매개변수
[in] aInstance
A pointer to the OpenThread instance.
[in] aServerSockAddr
The socket address (IPv6 address and port number) of the SRP server.
반환 값
OT_ERROR_NONE
SRP client operation started successfully or it is already running with same server socket address and callback.
OT_ERROR_BUSY
SRP client is busy running with a different socket address.
OT_ERROR_FAILED
Failed to open/connect the client's UDP socket.

otSrpClientStop

void otSrpClientStop(
  otInstance *aInstance
)

This function stops the SRP client operation.

This function stops any further interactions with the SRP server. Note that it does not remove or clear host info and/or list of services. It marks all services to be added/removed again once the client is (re)started.

세부
매개변수
[in] aInstance
A pointer to the OpenThread instance.

otSrpServerGetAddressMode

otSrpServerAddressMode otSrpServerGetAddressMode(
  otInstance *aInstance
)

This function returns the address mode being used by the SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
The SRP server's address mode.

otSrpServerGetAnycastModeSequenceNumber

uint8_t otSrpServerGetAnycastModeSequenceNumber(
  otInstance *aInstance
)

This function returns the sequence number used with anycast address mode.

The sequence number is included in "DNS/SRP Service Anycast Address" entry published in the Network Data.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
The anycast sequence number.

otSrpServerGetDomain

const char * otSrpServerGetDomain(
  otInstance *aInstance
)

This function returns the domain authorized to the SRP server.

If the domain if not set by SetDomain, "default.service.arpa." will be returned. A trailing dot is always appended even if the domain is set without it.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
A pointer to the dot-joined domain string.

otSrpServerGetLeaseConfig

void otSrpServerGetLeaseConfig(
  otInstance *aInstance,
  otSrpServerLeaseConfig *aLeaseConfig
)

This function returns SRP server LEASE and KEY-LEASE configurations.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[out] aLeaseConfig
A pointer to an otSrpServerLeaseConfig instance.

otSrpServerGetNextHost

const otSrpServerHost * otSrpServerGetNextHost(
  otInstance *aInstance,
  const otSrpServerHost *aHost
)

This function returns the next registered host on the SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aHost
A pointer to current host; use NULL to get the first host.
보고
A pointer to the registered host. NULL, if no more hosts can be found.

otSrpServerGetState

otSrpServerState otSrpServerGetState(
  otInstance *aInstance
)

This function returns the state of the SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
보고
The current state of the SRP server.

otSrpServerHandleServiceUpdateResult

void otSrpServerHandleServiceUpdateResult(
  otInstance *aInstance,
  otSrpServerServiceUpdateId aId,
  otError aError
)

This function reports the result of processing a SRP update to the SRP server.

The Service Update Handler should call this function to return the result of its processing of a SRP update.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aId
The service update transaction ID. This should be the same ID provided via otSrpServerServiceUpdateHandler .
[in] aError
An error to be returned to the SRP server. Use OT_ERROR_DUPLICATED to represent DNS name conflicts.

otSrpServerHostFindNextService

const otSrpServerService * otSrpServerHostFindNextService(
  const otSrpServerHost *aHost,
  const otSrpServerService *aPrevService,
  otSrpServerServiceFlags aFlags,
  const char *aServiceName,
  const char *aInstanceName
)

This function finds the next matching service on the host.

The combination of flags and service and instance names enables iterating over the full list of services and/or a subset of them matching certain conditions, or finding a specific service.

To iterate over all services of a host: service = otSrpServerHostFindNextService(host, service, OT_SRP_SERVER_FLAGS_ANY_SERVICE, NULL, NULL);

To iterate over base services only (exclude sub-types): service = otSrpServerHostFindNextService(host, service, OT_SRP_SERVER_FLAGS_BASE_TYPE_SERVICE_ONLY, NULL, NULL);

To iterate over sub-types of a specific instance name instanceName : service = otSrpServerHostFindNextService(host, service, OT_SRP_SERVER_FLAGS_SUB_TYPE_SERVICE_ONLY, NULL, instanceName);

To find a specific service with service name serviceName and service instance name instanceName : service = otSrpServerHostFindNextService(host, NULL, OT_SRP_SERVER_FLAGS_ANY_SERVICE, serviceName, instanceName);

To find the base type service with a given service instance name instanceName : service = otSrpServerHostFindNextService(host, NULL, OT_SRP_SERVER_FLAGS_BASE_TYPE_SERVICE_ONLY, NULL, instanceName);

세부
매개변수
[in] aHost
A pointer to the SRP service host (MUST NOT be NULL).
[in] aPrevService
A pointer to the previous service or NULL to start from the beginning of the list.
[in] aFlags
Flags indicating which services to include (base/sub-type, active/deleted).
[in] aServiceName
The service name to match. Set to NULL to accept any name.
[in] aInstanceName
The service instance name to match. Set to NULL to accept any name.
보고
A pointer to the next matching service or NULL if no matching service could be found.

otSrpServerHostGetAddresses

const otIp6Address * otSrpServerHostGetAddresses(
  const otSrpServerHost *aHost,
  uint8_t *aAddressesNum
)

This function returns the addresses of given host.

세부
매개변수
[in] aHost
A pointer to the SRP service host.
[out] aAddressesNum
A pointer to where we should output the number of the addresses to.
보고
A pointer to the array of IPv6 Address.

otSrpServerHostGetFullName

const char * otSrpServerHostGetFullName(
  const otSrpServerHost *aHost
)

This function returns the full name of the host.

세부
매개변수
[in] aHost
A pointer to the SRP service host.
보고
A pointer to the null-terminated host name string.

otSrpServerHostGetNextService

const otSrpServerService * otSrpServerHostGetNextService(
  const otSrpServerHost *aHost,
  const otSrpServerService *aService
)

This function returns the next service (excluding any sub-type services) of given host.

세부
매개변수
[in] aHost
A pointer to the SRP service host.
[in] aService
A pointer to current SRP service instance; use NULL to get the first service.
보고
A pointer to the next service or NULL if there is no more services.

otSrpServerHostIsDeleted

bool otSrpServerHostIsDeleted(
  const otSrpServerHost *aHost
)

This function tells if the SRP service host has been deleted.

A SRP service host can be deleted but retains its name for future uses. In this case, the host instance is not removed from the SRP server/registry.

세부
매개변수
[in] aHost
A pointer to the SRP service host.
보고
TRUE if the host has been deleted, FALSE if not.

otSrpServerServiceGetFullName

const char * otSrpServerServiceGetFullName(
  const otSrpServerService *aService
)

This function returns the full service instance name of the service.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
A pointer to the null-terminated service instance name string.

otSrpServerServiceGetHost

const otSrpServerHost * otSrpServerServiceGetHost(
  const otSrpServerService *aService
)

This function returns the host which the service instance reside on.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
A pointer to the host instance.

otSrpServerServiceGetInstanceName

const char * otSrpServerServiceGetInstanceName(
  const otSrpServerService *aService
)

This function returns the full service instance name of the service.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
A pointer to the null-terminated service instance name string.

otSrpServerServiceGetPort

uint16_t otSrpServerServiceGetPort(
  const otSrpServerService *aService
)

This function returns the port of the service instance.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
The port of the service.

otSrpServerServiceGetPriority

uint16_t otSrpServerServiceGetPriority(
  const otSrpServerService *aService
)

This function returns the priority of the service instance.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
The priority of the service.

otSrpServerServiceGetServiceName

const char * otSrpServerServiceGetServiceName(
  const otSrpServerService *aService
)

This function returns the full service name of the service.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
A pointer to the null-terminated service name string.

otSrpServerServiceGetServiceSubTypeLabel

otError otSrpServerServiceGetServiceSubTypeLabel(
  const otSrpServerService *aService,
  char *aLabel,
  uint8_t aMaxSize
)

This function gets the sub-type label from service name.

This function is intended to be used when the aService is a sub-type, ie, otSrpServerServiceIsSubType() for the service returns TRUE. If it is not a sub-type this function returns OT_ERROR_INVALID_ARGS .

The full service name for a sub-type service follows " ._sub. . .". This function copies the into the aLabel buffer.

The aLabel is ensured to always be null-terminated after returning even in case of failure.

세부
매개변수
[in] aService
A pointer to the SRP service.
[out] aLabel
A pointer to a buffer to copy the sub-type label name into.
[in] aMaxSize
Maximum size of aLabel buffer.
반환 값
OT_ERROR_NONE
aLabel was updated successfully.
OT_ERROR_NO_BUFS
The sub-type label could not fit in aLabel buffer (number of chars from label that could fit are copied in aLabel ensuring it is null-terminated).
OT_ERROR_INVALID_ARGS
SRP service is not a sub-type.

otSrpServerServiceGetTxtData

const uint8_t * otSrpServerServiceGetTxtData(
  const otSrpServerService *aService,
  uint16_t *aDataLength
)

This function returns the TXT record data of the service instance.

세부
매개변수
[in] aService
A pointer to the SRP service.
[out] aDataLength
A pointer to return the TXT record data length. MUST NOT be NULL.
보고
A pointer to the buffer containing the TXT record data (the TXT data length is returned in aDataLength ).

otSrpServerServiceGetWeight

uint16_t otSrpServerServiceGetWeight(
  const otSrpServerService *aService
)

This function returns the weight of the service instance.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
The weight of the service.

otSrpServerServiceIsDeleted

bool otSrpServerServiceIsDeleted(
  const otSrpServerService *aService
)

This function indicates whether or not the SRP service has been deleted.

A SRP service can be deleted but retains its name for future uses. In this case, the service instance is not removed from the SRP server/registry. It is guaranteed that all services are deleted if the host is deleted.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
TRUE if the service has been deleted, FALSE if not.

otSrpServerServiceIsSubType

bool otSrpServerServiceIsSubType(
  const otSrpServerService *aService
)

This function indicates whether or not the SRP service is sub-type.

세부
매개변수
[in] aService
A pointer to the SRP service.
보고
TRUE if the service is a sub-type, FALSE if not.

otSrpServerSetAddressMode

otError otSrpServerSetAddressMode(
  otInstance *aInstance,
  otSrpServerAddressMode aMode
)

This function sets the address mode to be used by the SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aMode
The address mode to use.
반환 값
OT_ERROR_NONE
Successfully set the address mode.
OT_ERROR_INVALID_STATE
The SRP server is enabled and the address mode cannot be changed.

otSrpServerSetAnycastModeSequenceNumber

otError otSrpServerSetAnycastModeSequenceNumber(
  otInstance *aInstance,
  uint8_t aSequenceNumber
)

This function sets the sequence number used with anycast address mode.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aSequenceNumber
The sequence number to use.
반환 값
OT_ERROR_NONE
Successfully set the address mode.
OT_ERROR_INVALID_STATE
The SRP server is enabled and the sequence number cannot be changed.

otSrpServerSetDomain

otError otSrpServerSetDomain(
  otInstance *aInstance,
  const char *aDomain
)

This function sets the domain on the SRP server.

A trailing dot will be appended to aDomain if it is not already there. This function should only be called before the SRP server is enabled.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aDomain
The domain to be set. MUST NOT be NULL.
반환 값
OT_ERROR_NONE
Successfully set the domain to aDomain .
OT_ERROR_INVALID_STATE
The SRP server is already enabled and the Domain cannot be changed.
OT_ERROR_INVALID_ARGS
The argument aDomain is not a valid DNS domain name.
OT_ERROR_NO_BUFS
There is no memory to store content of aDomain .

otSrpServerSetEnabled

void otSrpServerSetEnabled(
  otInstance *aInstance,
  bool aEnabled
)

This function enables/disables the SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aEnabled
A boolean to enable/disable the SRP server.

otSrpServerSetLeaseConfig

otError otSrpServerSetLeaseConfig(
  otInstance *aInstance,
  const otSrpServerLeaseConfig *aLeaseConfig
)

This function sets SRP server LEASE and KEY-LEASE configurations.

When a non-zero LEASE time is requested from a client, the granted value will be limited in range [aMinLease, aMaxLease]; and a non-zero KEY-LEASE will be granted in range [aMinKeyLease, aMaxKeyLease]. For zero LEASE or KEY-LEASE time, zero will be granted.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aLeaseConfig
A pointer to an otSrpServerLeaseConfig instance.
반환 값
OT_ERROR_NONE
Successfully set the LEASE and KEY-LEASE ranges.
OT_ERROR_INVALID_ARGS
The LEASE or KEY-LEASE range is not valid.

otSrpServerSetServiceUpdateHandler

void otSrpServerSetServiceUpdateHandler(
  otInstance *aInstance,
  otSrpServerServiceUpdateHandler aServiceHandler,
  void *aContext
)

This function sets the SRP service updates handler on SRP server.

세부
매개변수
[in] aInstance
OpenThread 인스턴스에 대한 포인터입니다.
[in] aServiceHandler
A pointer to a service handler. Use NULL to remove the handler.
[in] aContext
A pointer to arbitrary context information. May be NULL if not used.