docs: Explain DOH transfers inherit some SSL settings

- Document in DOH that some SSL settings are inherited but DOH hostname
  and peer verification are not and are controlled separately.

- Document that CURLOPT_SSL_CTX_FUNCTION is inherited by DOH handles but
  we're considering changing behavior to no longer inherit it. Request
  feedback.

Closes https://github.com/curl/curl/pull/6688
This commit is contained in:
Jay Satiro 2021-03-04 00:55:53 -05:00
parent 6d176bee59
commit 8a4ef73c8f
4 changed files with 24 additions and 1 deletions

View file

@ -359,7 +359,11 @@ static CURLcode dohprobe(struct Curl_easy *data,
doh->set.dohfor = data; /* identify for which transfer this is done */
p->easy = doh;
/* add this transfer to the multi handle */
/* DOH private_data must be null because the user must have a way to
distinguish their transfer's handle from DOH handles in user
callbacks (ie SSL CTX callback). */
DEBUGASSERT(!data->set.private_data);
if(curl_multi_add_handle(multi, doh))
goto error;
}