curl/docs/cmdline-opts/dump-header.md
Daniel Stenberg 9b1e4b4632
tool_operate: support --dump-header % to direct to stderr
Similar to how --trace and --trace-ascii already do it.

Added test 1489 to verify

Closes #13992
2024-08-04 16:02:24 +02:00

33 lines
928 B
Markdown

---
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
SPDX-License-Identifier: curl
Long: dump-header
Short: D
Arg: <filename>
Help: Write the received headers to <filename>
Protocols: HTTP FTP
Category: http ftp
Added: 5.7
Multi: single
See-also:
- output
Example:
- --dump-header store.txt $URL
- --dump-header - $URL -o save
---
# `--dump-header`
Write the received protocol headers to the specified file. If no headers are
received, the use of this option creates an empty file. Specify `-` as
filename (a single minus) to have it written to stdout.
Starting in curl 8.10.0, specify `%` (a single percent sign) as filename
writes the output to stderr.
When used in FTP, the FTP server response lines are considered being "headers"
and thus are saved there.
Having multiple transfers in one set of operations (i.e. the URLs in one
--next clause), appends them to the same file, separated by a blank line.