Mercurial > hgrepos > Python2 > PyMuPDF

comparison mupdf-source/thirdparty/curl/docs/cmdline-opts/header.d @ 2:b50eed0cc0ef upstream

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
ADD: MuPDF v1.26.7: the MuPDF source as downloaded by a default build of PyMuPDF 1.26.4. The directory name has changed: no version number in the expanded directory now.
author Franz Glasner <fzglas.hg@dom66.de>
date Mon, 15 Sep 2025 11:43:07 +0200
parents
children
comparison
equal deleted inserted replaced
1:1d09e1dec1d9 2:b50eed0cc0ef
1 Long: header
2 Short: H
3 Arg: <header/@file>
4 Help: Pass custom header(s) to server
5 Protocols: HTTP
6 ---
7 Extra header to include in the request when sending HTTP to a server. You may
8 specify any number of extra headers. Note that if you should add a custom
9 header that has the same name as one of the internal ones curl would use, your
10 externally set header will be used instead of the internal one. This allows
11 you to make even trickier stuff than curl would normally do. You should not
12 replace internally set headers without knowing perfectly well what you're
13 doing. Remove an internal header by giving a replacement without content on
14 the right side of the colon, as in: -H \&"Host:". If you send the custom
15 header with no-value then its header must be terminated with a semicolon, such
16 as \-H \&"X-Custom-Header;" to send "X-Custom-Header:".
17
18 curl will make sure that each header you add/replace is sent with the proper
19 end-of-line marker, you should thus \fBnot\fP add that as a part of the header
20 content: do not add newlines or carriage returns, they will only mess things up
21 for you.
22
23 Starting in 7.55.0, this option can take an argument in @filename style, which
24 then adds a header for each line in the input file. Using @- will make curl
25 read the header file from stdin.
26
27 See also the --user-agent and --referer options.
28
29 Starting in 7.37.0, you need --proxy-header to send custom headers intended
30 for a proxy.
31
32 Example:
33
34 curl -H "X-First-Name: Joe" http://example.com/
35
36 \fBWARNING\fP: headers set with this option will be set in all requests - even
37 after redirects are followed, like when told with --location. This can lead to
38 the header being sent to other hosts than the original host, so sensitive
39 headers should be used with caution combined with following redirects.
40
41 This option can be used multiple times to add/replace/remove multiple headers.