mirror of
https://github.com/curl/curl.git
synced 2024-12-03 06:20:31 +08:00
68784d73c3
The file format for each option now features a "Example:" header that can provide one or more examples that get rendered appropriately in the output. All options MUST have at least one example or gen.pl complains at build-time. This fix also does a few other minor format and consistency cleanups. Closes #7654
44 lines
2.0 KiB
Makefile
44 lines
2.0 KiB
Makefile
Long: header
|
|
Short: H
|
|
Arg: <header/@file>
|
|
Help: Pass custom header(s) to server
|
|
Protocols: HTTP
|
|
Category: http
|
|
See-also: user-agent referer
|
|
Example: -H "X-First-Name: Joe" $URL
|
|
Example: -H "User-Agent: yes-please/2000" $URL
|
|
Example: -H "Host:" $URL
|
|
---
|
|
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
|
|
header that has the same name as one of the internal ones curl would use, your
|
|
externally set header will be used instead of the internal one. This allows
|
|
you to make even trickier stuff than curl would normally do. You should not
|
|
replace internally set headers without knowing perfectly well what you're
|
|
doing. Remove an internal header by giving a replacement without content on
|
|
the right side of the colon, as in: -H \&"Host:". If you send the custom
|
|
header with no-value then its header must be terminated with a semicolon, such
|
|
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 **not** add that as a part of the header
|
|
content: do not add newlines or carriage returns, they will only mess things
|
|
up for you.
|
|
|
|
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.
|
|
|
|
You need --proxy-header to send custom headers intended for a HTTP
|
|
proxy. Added in 7.37.0.
|
|
|
|
Passing on a "Transfer-Encoding: chunked" header when doing a HTTP request
|
|
with a request body, will make curl send the data using chunked encoding.
|
|
|
|
**WARNING**: headers set with this option will be set in all requests - even
|
|
after redirects are followed, like when told with --location. This can lead to
|
|
the header being sent to other hosts than the original host, so sensitive
|
|
headers should be used with caution combined with following redirects.
|
|
|
|
This option can be used multiple times to add/replace/remove multiple headers.
|