1--- 2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3SPDX-License-Identifier: curl 4Short: v 5Long: verbose 6Mutexed: trace trace-ascii 7Help: Make the operation more talkative 8Category: important verbose global 9Added: 4.0 10Multi: boolean 11Scope: global 12See-also: 13 - show-headers 14 - silent 15 - trace 16 - trace-ascii 17Example: 18 - --verbose $URL 19--- 20 21# `--verbose` 22 23Makes curl verbose during the operation. Useful for debugging and seeing 24what's going on under the hood. A line starting with \> means header data sent 25by curl, \< means header data received by curl that is hidden in normal cases, 26and a line starting with * means additional info provided by curl. 27 28If you only want HTTP headers in the output, --show-headers or --dump-header 29might be more suitable options. 30 31Since curl 8.10, mentioning this option several times in the same argument 32increases the level of the trace output. However, as before, a single 33--verbose or --no-verbose reverts any additions by previous `-vv` again. This 34means that `-vv -v` is equivalent to a single -v. This avoids unwanted 35verbosity when the option is mentioned in the command line *and* curl config 36files. 37 38Using it twice, e.g. `-vv`, outputs time (--trace-time) and transfer ids 39(--trace-ids), as well as enable tracing for all protocols (--trace-config 40protocol). 41 42Adding a third verbose outputs transfer content (--trace-ascii %) and enable 43tracing of more components (--trace-config read,write,ssl). 44 45A forth time adds tracing of all network components. (--trace-config network). 46 47Any addition of the verbose option after that has no effect. 48 49If you think this option does not give you the right details, consider using 50--trace or --trace-ascii instead. Or use it only once and use --trace-config 51to trace the specific components you wish to see. 52 53Note that verbose output of curl activities and network traffic might contain 54sensitive data, including usernames, credentials or secret data content. Be 55aware and be careful when sharing trace logs with others. 56
