diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2021-11-04 11:26:46 +0100 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2021-11-04 13:53:13 +0100 |
| commit | c6a66ccb5ff3436bc299e2a2e2a8fa3d271bdf24 (patch) | |
| tree | 64f1254fd104a6931aba1f11615c38be4349bdff | |
| parent | 57370855d06dd7cf8db77b52323cc2a95ca6858f (diff) | |
| download | curl-c6a66ccb5ff3436bc299e2a2e2a8fa3d271bdf24.tar.gz | |
CURLOPT_ALTSVC_CTRL.3: mention conn reuse is preferred
Ref: https://github.com/curl/curl/discussions/7954
Closes #7957
| -rw-r--r-- | docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.3 | 8 |
1 files changed, 6 insertions, 2 deletions
diff --git a/docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.3 b/docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.3 index 98ba44014..00d1471bb 100644 --- a/docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.3 +++ b/docs/libcurl/opts/CURLOPT_ALTSVC_CTRL.3 @@ -5,7 +5,7 @@ .\" * | (__| |_| | _ <| |___ .\" * \___|\___/|_| \_\_____| .\" * -.\" * Copyright (C) 1998 - 2020, Daniel Stenberg, <daniel@haxx.se>, et al. +.\" * Copyright (C) 1998 - 2021, Daniel Stenberg, <daniel@haxx.se>, et al. .\" * .\" * This software is licensed as described in the file COPYING, which .\" * you should have received as part of this distribution. The terms @@ -38,11 +38,15 @@ CURLcode curl_easy_setopt(CURL *handle, CURLOPT_ALTSVC_CTRL, long bitmask); Populate the long \fIbitmask\fP with the correct set of features to instruct libcurl how to handle Alt-Svc for the transfers using this handle. -libcurl will only accept Alt-Svc headers over a secure transport, meaning +libcurl only accepts Alt-Svc headers over a secure transport, meaning HTTPS. It will also only complete a request to an alternative origin if that origin is properly hosted over HTTPS. These requirements are there to make sure both the source and the destination are legitimate. +Alternative services are only used when setting up new connections. If there +exists an existing connection to the host in the connection pool, then that +will be preferred. + Setting any bit will enable the alt-svc engine. .IP "CURLALTSVC_READONLYFILE" Do not write the alt-svc cache back to the file specified with |