DNS: plataforma

Este módulo inclui a abstração da plataforma para enviar consultas DNS recursivas a servidores DNS upstream.

Resumo

Typedefs

otPlatDnsUpstreamQuery typedef
Esse tipo opaco representa uma transação de consulta DNS upstream.

remotas

otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Cancela uma transação de consulta upstream.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Inicia uma transação de consulta upstream.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
A plataforma chama essa função para concluir a consulta DNS.

Typedefs

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Esse tipo opaco representa uma transação de consulta DNS upstream.

remotas

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Cancela uma transação de consulta upstream.

A plataforma precisa chamar otPlatDnsUpstreamQueryDone para liberar os recursos.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread.
[in] aTxn
Um ponteiro para o objeto de transação de consulta DNS opaco.

otPlatDnsStartUpstreamQuery

void otPlatDnsStartUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  const otMessage *aQuery
)

Inicia uma transação de consulta upstream.

  • Em casos de sucesso (e erros representados por mensagens do protocolo DNS), espera-se que a plataforma chame otPlatDnsUpstreamQueryDone.
  • O núcleo do OpenThread pode cancelar uma transação de consulta (possivelmente tempo limite) chamando otPlatDnsCancelUpstreamQuery. A plataforma não pode chamar otPlatDnsUpstreamQueryDone em uma transação cancelada.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread.
[in] aTxn
Um ponteiro para o objeto de transação de consulta DNS opaco.
[in] aQuery
Um buffer de mensagem da carga útil do DNS que precisa ser enviado para o servidor DNS upstream.

otPlatDnsUpstreamQueryDone

void otPlatDnsUpstreamQueryDone(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn,
  otMessage *aResponse
)

A plataforma chama essa função para concluir a consulta DNS.

A transação vai ser liberada. Portanto, a plataforma não pode chamar a mesma transação duas vezes. Essa função transmite a propriedade de aResponse para a pilha do OpenThread.

A plataforma pode transmitir um nullptr para fechar uma transação sem uma resposta.

Detalhes
Parâmetros
[in] aInstance
A estrutura da instância do OpenThread.
[in] aTxn
Um ponteiro para o objeto de transação de consulta DNS opaco.
[in] aResponse
Um buffer de mensagem do payload de resposta do DNS ou nullptr para fechar uma transação sem uma resposta.

Recursos

Os tópicos de Referência da API OpenThread são originados do código-fonte, disponível no GitHub. Para mais informações ou para contribuir com nossa documentação, consulte Recursos.