| xf.li | 6c8fc1e | 2023-08-12 00:11:09 -0700 | [diff] [blame^] | 1 | c: Copyright (C) 1998 - 2022, Daniel Stenberg, <daniel@haxx.se>, et al. |
| 2 | SPDX-License-Identifier: curl |
| 3 | Long: proxy-header |
| 4 | Arg: <header/@file> |
| 5 | Help: Pass custom header(s) to proxy |
| 6 | Protocols: HTTP |
| 7 | Added: 7.37.0 |
| 8 | Category: proxy |
| 9 | Example: --proxy-header "X-First-Name: Joe" -x http://proxy $URL |
| 10 | Example: --proxy-header "User-Agent: surprise" -x http://proxy $URL |
| 11 | Example: --proxy-header "Host:" -x http://proxy $URL |
| 12 | See-also: proxy |
| 13 | Multi: append |
| 14 | --- |
| 15 | Extra header to include in the request when sending HTTP to a proxy. You may |
| 16 | specify any number of extra headers. This is the equivalent option to --header |
| 17 | but is for proxy communication only like in CONNECT requests when you want a |
| 18 | separate header sent to the proxy to what is sent to the actual remote host. |
| 19 | |
| 20 | curl will make sure that each header you add/replace is sent with the proper |
| 21 | end-of-line marker, you should thus **not** add that as a part of the header |
| 22 | content: do not add newlines or carriage returns, they will only mess things |
| 23 | up for you. |
| 24 | |
| 25 | Headers specified with this option will not be included in requests that curl |
| 26 | knows will not be sent to a proxy. |
| 27 | |
| 28 | Starting in 7.55.0, this option can take an argument in @filename style, which |
| 29 | then adds a header for each line in the input file. Using @- will make curl |
| 30 | read the header file from stdin. |
| 31 | |
| 32 | This option can be used multiple times to add/replace/remove multiple headers. |