summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorDaniel Stenberg <daniel@haxx.se>2020-10-30 12:05:47 +0100
committerDaniel Stenberg <daniel@haxx.se>2020-10-31 23:45:36 +0100
commit1144886f38fd0811b29c9ea0f39133f47e7cc3fe (patch)
treee430be102f3a6d75907bbbee8e34cfc44386e823 /docs
parentc131148b695afd9cf6601ce8879711ccb8ba0a9d (diff)
downloadcurl-1144886f38fd0811b29c9ea0f39133f47e7cc3fe.tar.gz
header.d: mention the "Transfer-Encoding: chunked" handling
Ref: #6144 Closes #6148
Diffstat (limited to 'docs')
-rw-r--r--docs/cmdline-opts/header.d18
1 files changed, 10 insertions, 8 deletions
diff --git a/docs/cmdline-opts/header.d b/docs/cmdline-opts/header.d
index e84168996..ac02323b9 100644
--- a/docs/cmdline-opts/header.d
+++ b/docs/cmdline-opts/header.d
@@ -4,6 +4,7 @@ Arg: <header/@file>
Help: Pass custom header(s) to server
Protocols: HTTP
Category: http
+See-also: --user-agent --referer
---
Extra header to include in the request when sending HTTP to a server. You may
specify any number of extra headers. Note that if you should add a custom
@@ -18,17 +19,18 @@ as \-H \&"X-Custom-Header;" to send "X-Custom-Header:".
curl will make sure that each header you add/replace is sent with the proper
end-of-line marker, you should thus \fBnot\fP add that as a part of the header
-content: do not add newlines or carriage returns, they will only mess things up
-for you.
+content: do not add newlines or carriage returns, they will only mess things
+up for you.
-Starting in 7.55.0, this option can take an argument in @filename style, which
-then adds a header for each line in the input file. Using @- will make curl
-read the header file from stdin.
+This option can take an argument in @filename style, which then adds a header
+for each line in the input file. Using @- will make curl read the header file
+from stdin. Added in 7.55.0.
-See also the --user-agent and --referer options.
+You need --proxy-header to send custom headers intended for a HTTP
+proxy. Added in 7.37.0.
-Starting in 7.37.0, you need --proxy-header to send custom headers intended
-for a proxy.
+Passing on a "Transfer-Encoding: chunked" header when doing a HTTP request
+with a requst body, will make curl send the data using chunked encoding.
Example: