DNSv6

Este tipo de enumeração representa o modo NAT64 num otDnsQueryConfig .

O modo NAT64 indica se deve permitir ou não a tradução de endereço NAT64 durante a resolução de endereço de cliente DNS. Este modo só é utilizado quando OPENTHREAD_CONFIG_DNS_CLIENT_NAT64_ENABLE está habilitado.

Este tipo de enumeração representa o sinalizador "recursão desejado" (RD) num otDnsQueryConfig .

Este ponteiro de função é chamado quando uma resposta DNS é recebida para uma consulta de resolução de endereço.

Dentro deste callback o usuário pode usar otDnsAddressResponseGet{Item}() funções juntamente com o aResponse ponteiro de obter mais informação sobre a resposta.

O aResponse ponteiro só pode ser usado dentro desse retorno de chamada e depois de voltar de esta função não vai ficar válida, de modo que o usuário não deve reter o aResponse ponteiro para uso posterior.

O aError pode ter o seguinte:

• OT_ERROR_NONE Uma resposta foi recebida com sucesso.
• OT_ERROR_ABORT Uma transação DNS foi abortada por pilha.
• OT_ERROR_RESPONSE_TIMEOUT Nenhuma resposta DNS foi recebida dentro do tempo limite.

Se o servidor rejeitar a solicitação de resolução de endereço, o código de erro do servidor será mapeado da seguinte forma:

• (0) NOERROR Sucesso (sem condição de erro) -> OT_ERROR_NONE
• (1) FORMERR Server incapaz de interpretar devido a erro de formato -> OT_ERROR_PARSE
• (2) O servidor SERVFAIL encontrou uma falha interna -> OT_ERROR_FAILED
• (3) NXDOMAIN Nome que deveria existir, não existe -> OT_ERROR_NOT_FOUND
• (4) NOTIMP Server não suporta o tipo de consulta (OpCode) -> OT_ERROR_NOT_IMPLEMENTED
• (5) RECUSADO Servidor recusado por razões de política / segurança -> OT_ERROR_SECURITY
• (6) YXDOMAIN Algum nome que não deveria existir, existe -> OT_ERROR_DUPLICATED
• (7) YXRRSET Algum RRset que não deveria existir, existe -> OT_ERROR_DUPLICATED
• (8) NXRRSET Algum RRset que deveria existir, não existe -> OT_ERROR_NOT_FOUND
• (9) O serviço NOTAUTH não tem autoridade para a zona -> OT_ERROR_SECURITY
• (10) NOTZONE Um nome não está na zona -> OT_ERROR_PARSE
• (20) Mau nome de BADNAME -> OT_ERROR_PARSE
• (21) BADALG Algoritmo ruim -> OT_ERROR_SECURITY
• (22) BADTRUN Truncamento ruim -> OT_ERROR_PARSE
• Outros códigos de resposta -> OT_ERROR_FAILED

Este tipo é uma representação opaca de uma resposta a uma consulta DNS de resolução de endereço.

Os apontadores para exemplo deste tipo são fornecidos a partir de retorno de chamada otDnsAddressCallback .

Este ponteiro de função é chamado quando uma resposta DNS é recebida para uma consulta de navegação (enumeração de instância de serviço).

Dentro deste callback o usuário pode usar otDnsBrowseResponseGet{Item}() funções juntamente com o aResponse ponteiro de obter mais informação sobre a resposta.

O aResponse ponteiro só pode ser usado dentro desse retorno de chamada e depois de voltar de esta função não vai ficar válida, de modo que o usuário não deve reter o aResponse ponteiro para uso posterior.

Para a lista completa de valores possíveis para aError , consulte otDnsAddressCallback() .

Este tipo é uma representação opaca de uma resposta a uma consulta DNS de navegação (enumeração de instância de serviço).

Os apontadores para exemplo deste tipo são fornecidos a partir de retorno de chamada otDnsBrowseCallback .

Esta estrutura representa uma configuração de consulta DNS.

Qualquer um dos campos nesta estrutura pode ser definido como zero para indicar que não foi especificado. Como os campos não especificados são tratadas é determinada pela função que utiliza o exemplo de otDnsQueryConfig .

Este ponteiro de função é chamado quando uma resposta DNS é recebida para uma consulta de resolução de instância de serviço.

Dentro deste callback o usuário pode usar otDnsServiceResponseGet{Item}() funções juntamente com o aResponse ponteiro de obter mais informação sobre a resposta.

O aResponse ponteiro só pode ser usado dentro desse retorno de chamada e depois de voltar de esta função não vai ficar válida, de modo que o usuário não deve reter o aResponse ponteiro para uso posterior.

Para a lista completa de valores possíveis para aError , consulte otDnsAddressCallback() .

Esta estrutura fornece informações para uma instância de serviço DNS.

Este tipo é uma representação opaca de uma resposta a uma consulta DNS de resolução de instância de serviço.

Os apontadores para exemplo deste tipo são fornecidos a partir de retorno de chamada otDnsAddressCallback .

Esta estrutura representa uma entrada de registro TXT que representa um par chave / valor (RFC 6763 - seção 6.3).

Os buffers de cadeias apontada por mKey e mValue deve persistir e permanecem inalterados depois de um exemplo de tal estrutura é passada para OpenThread (como parte de otSrpClientService exemplo).

Uma matriz de otDnsTxtEntry entradas são usadas em otSrpClientService para especificar o registro TXT completa (uma lista de entradas).

Esta estrutura representa um iterador para entradas de registro TXT (pares chave / valor).

Os campos de dados nesta estrutura são destinados ao uso do núcleo OpenThread e o chamador não deve lê-los ou alterá-los.

Esta função obtém um endereço IPv6 associado a uma resposta DNS de resolução de endereço.

Esta função só deve ser utilizada a partir otDnsAddressCallback .

A resposta pode incluir vários registros de endereço IPv6. aIndex pode ser usado para percorrer a lista de endereços. O índice zero obtém o primeiro endereço e assim por diante. Quando chegar ao fim da lista, OT_ERROR_NOT_FOUND é retornado.

Esta função obtém o nome completo do host associado a uma resposta DNS de resolução de endereço.

Esta função só deve ser utilizada a partir otDnsAddressCallback .

Esta função obtém o endereço IPv6 do host de uma resposta do navegador DNS (enumeração da instância de serviço).

Esta função só deve ser utilizada a partir otDnsBrowseCallback .

A resposta pode incluir zero ou mais registros de endereço IPv6. aIndex pode ser usado para percorrer a lista de endereços. O índice zero obtém o primeiro endereço e assim por diante. Quando chegar ao fim da lista, OT_ERROR_NOT_FOUND é retornado.

Esta função obtém informações para uma instância de serviço de uma resposta do navegador DNS (enumeração de instância de serviço).

Esta função só deve ser utilizada a partir otDnsBrowseCallback .

Uma resposta DNS do navegador deve incluir os registros SRV, TXT e AAAA para as instâncias de serviço enumeradas (observe que é um DEVER e não um requisito OBRIGATÓRIO). Esta função tenta recuperar essas informações para uma determinada instância de serviço, quando disponível.

• Se nenhum registro SRV for encontrado em aResponse , OT_ERROR_NOT_FOUND é retornado.
• Se um registro SRV for encontrado em aResponse , aServiceInfo é atualizado e OT_ERROR_NONE é retornado.
• Se nenhum registro TXT correspondente for encontrado na aResponse , mTxtDataSize em aServiceInfo está definido para zero.
• Se nenhum registro AAAA correspondente for encontrado na aResponse , mHostAddress is set to all zero or unspecified address.
• If there are multiple AAAA records for the host name in @p aResponse, mHostAddress is set to the first one. The other addresses can be retrieved using otDnsBrowseResponseGetHostAddress () `.

Esta função obtém uma instância de serviço associada a uma resposta do navegador DNS (enumeração de instância de serviço).

Esta função só deve ser utilizada a partir otDnsBrowseCallback .

A resposta pode incluir vários registros de instância de serviço. aIndex pode ser usado para percorrer a lista. O índice zero fornece o primeiro registro. Quando chegar ao fim da lista, OT_ERROR_NOT_FOUND é retornado.

Observe que esta função obtém o rótulo da instância de serviço e não o nome completo da instância de serviço que está no formato . . . . .

Esta função obtém o nome do serviço associado a uma resposta do navegador DNS (enumeração da instância do serviço).

Esta função só deve ser utilizada a partir otDnsBrowseCallback .

Esta função envia uma consulta de navegação DNS (enumeração de instância de serviço) para um determinado nome de serviço.

Esta função está disponível quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE está habilitado.

O aConfig pode ser NULL. Neste caso, a configuração padrão (de otDnsClientGetDefaultConfig() ) será usado como a configuração para esta consulta. Em um não NULL- aConfig , alguns dos campos podem ser deixados não especificado (zero valor). Os campos não especificados são então substituídos pelos valores da configuração padrão.

Esta função obtém a configuração de consulta padrão atual usada pelo cliente DNS.

Quando começa OpenThread pilha, a configuração consulta DNS padrão é determinado a partir de um conjunto de opções de configuração do AT como OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_IP6_ADDRESS , _DEFAULT_SERVER_PORT , _DEFAULT_RESPONSE_TIMEOUT , etc. (ver config/dns_client.h para todas as opções de configuração relacionadas).

Esta função envia uma consulta DNS de resolução de endereço para registro (s) AAAA (IPv6) para um determinado nome de host.

O aConfig pode ser NULL. Neste caso, a configuração padrão (de otDnsClientGetDefaultConfig() ) será usado como a configuração para esta consulta. Em um não NULL- aConfig , alguns dos campos podem ser deixados não especificado (zero valor). Os campos não especificados são então substituídos pelos valores da configuração padrão.

Esta função envia uma consulta de resolução de instância de serviço DNS para uma determinada instância de serviço.

Esta função está disponível quando OPENTHREAD_CONFIG_DNS_CLIENT_SERVICE_DISCOVERY_ENABLE está habilitado.

O aConfig pode ser NULL. Neste caso, a configuração padrão (de otDnsClientGetDefaultConfig() ) será usado como a configuração para esta consulta. Em um não NULL- aConfig , alguns dos campos podem ser deixados não especificado (zero valor). Os campos não especificados são então substituídos pelos valores da configuração padrão.

Esta função define a configuração de consulta padrão no cliente DNS.

Nota: Qualquer consulta em curso continuarão a usar a configuração a partir de quando ele foi iniciado. A nova configuração padrão será usada para quaisquer consultas DNS futuras. O aConfig pode ser NULL. Neste caso, a configuração padrão será definido como os padrões de opções de configuração OT OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} . Isso redefine a configuração da consulta padrão de volta à configuração quando a pilha OpenThread é iniciada.

Em um não NULL- aConfig , chamador pode optar por deixar alguns dos campos em otDnsQueryConfig instância não especificado (valor zero). Os campos não especificados são substituídos pelo correspondente OT configuração opção definições OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_{} para formar a configuração de consulta padrão.

Quando OPENTHREAD_CONFIG_DNS_CLIENT_DEFAULT_SERVER_ADDRESS_AUTO_SET_ENABLE está habilitado, o endereço IPv6 do servidor na configuração padrão é automaticamente definido e actualizado pelo cliente DNS. Isso é feito apenas quando o usuário não define ou especifica explicitamente. Esse comportamento requer que o cliente SRP e seu recurso de inicialização automática estejam habilitados. O cliente SRP monitorará então os dados da rede do segmento para entradas de serviço DNS / SRP para selecionar um servidor SRP. O endereço do servidor SRP selecionado também é definido como o endereço do servidor DNS na configuração padrão.

Esta função analisa os dados TXT de um iterador e obtém a próxima entrada de registro TXT (par chave / valor).

O aIterator deve ser inicializado usando otDnsInitTxtEntryIterator() antes de ligar esta função e os dados TXT tampão utilizado para inicializar o iteração deve persistir e permanecem inalterados. Caso contrário, o comportamento desta função é indefinido.

Se o comprimento da corda chave analisado é menor ou igual a OT_DNS_TXT_KEY_MAX_LENGTH (recomendado comprimento da chave max) a string chave é devolvido em mKey em aEntry . Mas, se a chave for maior, então mKey é definido como NULL e toda a cadeia de entrada TXT codificado é retornado em mValue e mValueLength .

Esta função inicializa um iterador de registro TXT.

O ponteiro tampão aTxtData e o seu teor deve persistir e permanecem inalteradas, enquanto aIterator objecto está a ser utilizado.

Esta função indica se o modo "compressão de nome DNS" está habilitado ou não.

Este destina-se apenas para teste e disponível quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE configuração é habilitado.

Esta função obtém o endereço IPv6 do host de uma resposta de resolução de instância de serviço DNS.

Esta função só deve ser utilizada a partir otDnsServiceCallback .

A resposta pode incluir zero ou mais registros de endereço IPv6. aIndex pode ser usado para percorrer a lista de endereços. O índice zero obtém o primeiro endereço e assim por diante. Quando chegar ao fim da lista, OT_ERROR_NOT_FOUND é retornado.

Esta função obtém informações para uma instância de serviço de uma resposta de resolução de instância de serviço DNS.

Esta função só deve ser utilizada a partir otDnsServiceCallback .

• Se nenhum registro SRV for encontrado em aResponse , OT_ERROR_NOT_FOUND é retornado.
• Se um registro SRV for encontrado em aResponse , aServiceInfo é atualizado e OT_ERROR_NONE é retornado.
• Se nenhum registro TXT correspondente for encontrado na aResponse , mTxtDataSize em aServiceInfo está definido para zero.
• Se nenhum registro AAAA correspondente for encontrado na aResponse , mHostAddress is set to all zero or unspecified address.
• If there are multiple AAAA records for the host name in @p aResponse, mHostAddress is set to the first one. The other addresses can be retrieved using otDnsServiceResponseGetHostAddress () `.

Esta função obtém o nome da instância do serviço associado a uma resposta de resolução da instância do serviço DNS.

Esta função só deve ser utilizada a partir otDnsServiceCallback .

Esta função ativa / desativa o modo "compressão de nome DNS".

Por padrão, a compactação de nomes DNS está ativada. Quando desativados, os nomes DNS são anexados como completos e nunca compactados. Isso é aplicável aos módulos cliente / servidor DNS e SRP do OpenThread.

Este destina-se apenas para teste e disponível quando OPENTHREAD_CONFIG_REFERENCE_DEVICE_ENABLE configuração é habilitado.

Note-se que no caso OPENTHREAD_CONFIG_MULTIPLE_INSTANCE_ENABLE é usado, este modo aplica-se a todos os casos OpenThread (isto é, ligando esta função activa / desactiva o modo de compressão em todos os casos OpenThread).

Tamanho máximo da string do rótulo (incluir caractere nulo no final da string).

Tamanho máximo da string de nome (inclui caractere nulo no final da string).

Comprimento máximo recomendado da string da chave do registro TXT (RFC 6763 - seção 6.4).

Comprimento mínimo da string da chave do registro TXT (RFC 6763 - seção 6.4).