xref: /aosp_15_r20/external/curl/docs/cmdline-opts/show-headers.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: show-headers
5*6236dae4SAndroid Build Coastguard WorkerShort: i
6*6236dae4SAndroid Build Coastguard WorkerHelp: Show response headers in output
7*6236dae4SAndroid Build Coastguard WorkerProtocols: HTTP FTP
8*6236dae4SAndroid Build Coastguard WorkerCategory: important verbose output
9*6236dae4SAndroid Build Coastguard WorkerAdded: 4.8
10*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - verbose
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - -i $URL
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--show-headers`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerShow response headers in the output. HTTP response headers can include things
20*6236dae4SAndroid Build Coastguard Workerlike server name, cookies, date of the document, HTTP version and more. With
21*6236dae4SAndroid Build Coastguard Workernon-HTTP protocols, the "headers" are other server communication.
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerTo view the request headers, consider the --verbose option.
24*6236dae4SAndroid Build Coastguard Worker
25*6236dae4SAndroid Build Coastguard WorkerPrior to 7.75.0 curl did not print the headers if --fail was used in
26*6236dae4SAndroid Build Coastguard Workercombination with this option and there was error reported by server.
27*6236dae4SAndroid Build Coastguard Worker
28*6236dae4SAndroid Build Coastguard WorkerThis option was called --include before 8.10.0. The previous name remains
29*6236dae4SAndroid Build Coastguard Workerfunctional.
30