trust_dns_https::response

Function new

Source
pub fn new(message_len: usize) -> Result<Response<()>, Error>
Expand description

Create a new Response for an http/2 dns-message request

 4.2.1.  Handling DNS and HTTP Errors

DNS response codes indicate either success or failure for the DNS
query.  A successful HTTP response with a 2xx status code ([RFC7231]
Section 6.3) is used for any valid DNS response, regardless of the
DNS response code.  For example, a successful 2xx HTTP status code is
used even with a DNS message whose DNS response code indicates
failure, such as SERVFAIL or NXDOMAIN.

HTTP responses with non-successful HTTP status codes do not contain
replies to the original DNS question in the HTTP request.  DoH

clients need to use the same semantic processing of non-successful
HTTP status codes as other HTTP clients.  This might mean that the
DoH client retries the query with the same DoH server, such as if
there are authorization failures (HTTP status code 401 [RFC7235]
Section 3.1).  It could also mean that the DoH client retries with a
different DoH server, such as for unsupported media types (HTTP
status code 415, [RFC7231] Section 6.5.13), or where the server
cannot generate a representation suitable for the client (HTTP status
code 406, [RFC7231] Section 6.5.6), and so on.