diff options
| author | Daniel Stenberg <daniel@haxx.se> | 2021-10-08 13:44:10 +0200 |
|---|---|---|
| committer | Daniel Stenberg <daniel@haxx.se> | 2021-10-08 15:15:30 +0200 |
| commit | 33882a066ec16c3f5152bf169f3cd6845695e8aa (patch) | |
| tree | 3f1691fe005521395a09b7aea477fdf1cf80b008 | |
| parent | 4e0c28923a5becacecc4a0e9a8f9e8fc2a3ac701 (diff) | |
| download | curl-33882a066ec16c3f5152bf169f3cd6845695e8aa.tar.gz | |
CURLOPT_HTTPHEADER.3: add descripion for specific headers
Settting Host: or Transfer-Encoding: chunked actually have special
meanings to libcurl. This change tries to document them
Closes #7829
| -rw-r--r-- | docs/libcurl/opts/CURLOPT_HTTPHEADER.3 | 10 |
1 files changed, 10 insertions, 0 deletions
diff --git a/docs/libcurl/opts/CURLOPT_HTTPHEADER.3 b/docs/libcurl/opts/CURLOPT_HTTPHEADER.3 index 8e3994beb..685f6a44d 100644 --- a/docs/libcurl/opts/CURLOPT_HTTPHEADER.3 +++ b/docs/libcurl/opts/CURLOPT_HTTPHEADER.3 @@ -68,6 +68,16 @@ The most commonly replaced headers have "shortcuts" in the options There's an alternative option that sets or replaces headers only for requests that are sent with CONNECT to a proxy: \fICURLOPT_PROXYHEADER(3)\fP. Use \fICURLOPT_HEADEROPT(3)\fP to control the behavior. +.SH SPECIFIC HEADERS +Setting some specific headers will cause libcurl to act differently. +.IP "Host:" +The specified host name will be used for cookie matching if the cookie engine +is also enabled for this transfer. If the request is done over HTTP/2 or +HTTP/3, the custom host name will instead be used in the ":authority" header +field and Host: will not be sent at all over the wire. +.IP "Transfer-Encoding: chunked" +Tells libcurl the upload is to be done using this chunked encoding instead of +providing the Content-Length: field in the request. .SH SECURITY CONCERNS By default, this option makes libcurl send the given headers in all HTTP requests done by this handle. You should therefore use this option with |