DNS: Plataforma

En este módulo, se incluye la abstracción de la plataforma para enviar consultas de DNS recursivas a servidores DNS ascendentes.

Resumen

Typedefs

otPlatDnsUpstreamQuery typedef
Este tipo opaco representa una transacción de consulta de DNS ascendente.

remotas

otPlatDnsCancelUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn)
void
Cancela una transacción de consulta ascendente.
otPlatDnsStartUpstreamQuery(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, const otMessage *aQuery)
void
Inicia una transacción de consulta ascendente.
otPlatDnsUpstreamQueryDone(otInstance *aInstance, otPlatDnsUpstreamQuery *aTxn, otMessage *aResponse)
void
La plataforma llama a esta función para finalizar la consulta de DNS.

Typedefs

otPlatDnsUpstreamQuery

struct otPlatDnsUpstreamQuery otPlatDnsUpstreamQuery

Este tipo opaco representa una transacción de consulta de DNS ascendente.

remotas

otPlatDnsCancelUpstreamQuery

void otPlatDnsCancelUpstreamQuery(
  otInstance *aInstance,
  otPlatDnsUpstreamQuery *aTxn
)

Cancela una transacción de consulta ascendente.

La plataforma debe llamar a otPlatDnsUpstreamQueryDone para liberar los recursos.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aTxn
Un puntero al objeto de transacción de consulta de DNS opaco.

otPlatDnsStartUpstreamQuery

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

Inicia una transacción de consulta ascendente.

  • En caso de éxito (y de errores representados por mensajes del protocolo DNS), se espera que la plataforma llame a otPlatDnsUpstreamQueryDone.
  • El núcleo de OpenThread puede cancelar una transacción de consulta (posiblemente tiempo de espera) llamando a otPlatDnsCancelUpstreamQuery. La plataforma no debe llamar a otPlatDnsUpstreamQueryDone en una transacción cancelada.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aTxn
Un puntero al objeto de transacción de consulta de DNS opaco.
[in] aQuery
Un búfer de mensaje de la carga útil de DNS que se debe enviar al servidor DNS upstream.

otPlatDnsUpstreamQueryDone

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

La plataforma llama a esta función para finalizar la consulta de DNS.

La transacción se liberará, por lo que la plataforma no debe llamar dos veces a la misma transacción. Esta función pasa la propiedad de aResponse a la pila de OpenThread.

La plataforma puede pasar un valor nulo para cerrar una transacción sin una respuesta.

Detalles
Parámetros
[in] aInstance
Estructura de instancias de OpenThread
[in] aTxn
Un puntero al objeto de transacción de consulta de DNS opaco.
[in] aResponse
Un búfer de mensaje de la carga útil de la respuesta de DNS o nullptr para cerrar una transacción sin una respuesta.

Recursos

Los temas de referencia de la API de OpenThread se originan a partir del código fuente, disponible en GitHub. Para obtener más información o contribuir a nuestra documentación, consulta Recursos.