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