xref: /aosp_15_r20/external/curl/docs/cmdline-opts/verbose.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 WorkerShort: v
5*6236dae4SAndroid Build Coastguard WorkerLong: verbose
6*6236dae4SAndroid Build Coastguard WorkerMutexed: trace trace-ascii
7*6236dae4SAndroid Build Coastguard WorkerHelp: Make the operation more talkative
8*6236dae4SAndroid Build Coastguard WorkerCategory: important verbose global
9*6236dae4SAndroid Build Coastguard WorkerAdded: 4.0
10*6236dae4SAndroid Build Coastguard WorkerMulti: boolean
11*6236dae4SAndroid Build Coastguard WorkerScope: global
12*6236dae4SAndroid Build Coastguard WorkerSee-also:
13*6236dae4SAndroid Build Coastguard Worker  - show-headers
14*6236dae4SAndroid Build Coastguard Worker  - silent
15*6236dae4SAndroid Build Coastguard Worker  - trace
16*6236dae4SAndroid Build Coastguard Worker  - trace-ascii
17*6236dae4SAndroid Build Coastguard WorkerExample:
18*6236dae4SAndroid Build Coastguard Worker  - --verbose $URL
19*6236dae4SAndroid Build Coastguard Worker---
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard Worker# `--verbose`
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerMakes curl verbose during the operation. Useful for debugging and seeing
24*6236dae4SAndroid Build Coastguard Workerwhat's going on under the hood. A line starting with \> means header data sent
25*6236dae4SAndroid Build Coastguard Workerby curl, \< means header data received by curl that is hidden in normal cases,
26*6236dae4SAndroid Build Coastguard Workerand a line starting with * means additional info provided by curl.
27*6236dae4SAndroid Build Coastguard Worker
28*6236dae4SAndroid Build Coastguard WorkerIf you only want HTTP headers in the output, --show-headers or --dump-header
29*6236dae4SAndroid Build Coastguard Workermight be more suitable options.
30*6236dae4SAndroid Build Coastguard Worker
31*6236dae4SAndroid Build Coastguard WorkerSince curl 8.10, mentioning this option several times in the same argument
32*6236dae4SAndroid Build Coastguard Workerincreases the level of the trace output. However, as before, a single
33*6236dae4SAndroid Build Coastguard Worker--verbose or --no-verbose reverts any additions by previous `-vv` again. This
34*6236dae4SAndroid Build Coastguard Workermeans that `-vv -v` is equivalent to a single -v. This avoids unwanted
35*6236dae4SAndroid Build Coastguard Workerverbosity when the option is mentioned in the command line *and* curl config
36*6236dae4SAndroid Build Coastguard Workerfiles.
37*6236dae4SAndroid Build Coastguard Worker
38*6236dae4SAndroid Build Coastguard WorkerUsing it twice, e.g. `-vv`, outputs time (--trace-time) and transfer ids
39*6236dae4SAndroid Build Coastguard Worker(--trace-ids), as well as enable tracing for all protocols (--trace-config
40*6236dae4SAndroid Build Coastguard Workerprotocol).
41*6236dae4SAndroid Build Coastguard Worker
42*6236dae4SAndroid Build Coastguard WorkerAdding a third verbose outputs transfer content (--trace-ascii %) and enable
43*6236dae4SAndroid Build Coastguard Workertracing of more components (--trace-config read,write,ssl).
44*6236dae4SAndroid Build Coastguard Worker
45*6236dae4SAndroid Build Coastguard WorkerA forth time adds tracing of all network components. (--trace-config network).
46*6236dae4SAndroid Build Coastguard Worker
47*6236dae4SAndroid Build Coastguard WorkerAny addition of the verbose option after that has no effect.
48*6236dae4SAndroid Build Coastguard Worker
49*6236dae4SAndroid Build Coastguard WorkerIf you think this option does not give you the right details, consider using
50*6236dae4SAndroid Build Coastguard Worker--trace or --trace-ascii instead. Or use it only once and use --trace-config
51*6236dae4SAndroid Build Coastguard Workerto trace the specific components you wish to see.
52*6236dae4SAndroid Build Coastguard Worker
53*6236dae4SAndroid Build Coastguard WorkerNote that verbose output of curl activities and network traffic might contain
54*6236dae4SAndroid Build Coastguard Workersensitive data, including usernames, credentials or secret data content. Be
55*6236dae4SAndroid Build Coastguard Workeraware and be careful when sharing trace logs with others.
56