mirror/curl
2
0
Fork 0
mirror of https://github.com/curl/curl.git synced 2025-02-23 15:10:03 +08:00
Code Issues Packages Projects Releases Wiki Activity
4c5099868e
curl/docs/cmdline-opts/verbose.md
Daniel Stenberg 81d253365c
verbose.md: mention how carriage-return might occur in headers 
Fixes #16285
Reported-by: Andrei Korshikov
Closes #16286
2025-02-11 07:44:36 +01:00

2.2 KiB
Raw Blame History

c SPDX-License-Identifier Short Long Mutexed Help Category Added Multi Scope See-also Example
Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. curl v verbose trace trace-ascii Make the operation more talkative important verbose global 4.0 boolean global
show-headers
silent
trace
trace-ascii
--verbose $URL

--verbose

Makes curl verbose during the operation. Useful for debugging and seeing what's going on under the hood. A line starting with > means header data sent by curl, < means header data received by curl that is hidden in normal cases, and a line starting with * means additional info provided by curl.

If you only want HTTP headers in the output, --show-headers or --dump-header might be more suitable options.

Since curl 8.10, mentioning this option several times in the same argument increases the level of the trace output. However, as before, a single --verbose or --no-verbose reverts any additions by previous -vv again. This means that -vv -v is equivalent to a single -v. This avoids unwanted verbosity when the option is mentioned in the command line and curl config files.

Using it twice, e.g. -vv, outputs time (--trace-time) and transfer ids (--trace-ids), as well as enable tracing for all protocols (--trace-config protocol).

Adding a third verbose outputs transfer content (--trace-ascii %) and enable tracing of more components (--trace-config read,write,ssl).

A forth time adds tracing of all network components. (--trace-config network).

Any addition of the verbose option after that has no effect.

If you think this option does not give you the right details, consider using --trace or --trace-ascii instead. Or use it only once and use --trace-config to trace the specific components you wish to see.

Note that verbose output of curl activities and network traffic might contain sensitive data, including usernames, credentials or secret data content. Be aware and be careful when sharing trace logs with others.

When the output contains protocol headers, those lines might include carriage return (ASCII code 13) characters, even on platforms that otherwise normally only use linefeed to signify line separations - as curl shows the exact contents arriving from the server.