xref: /aosp_15_r20/external/curl/docs/cmdline-opts/trace.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 WorkerLong: trace
5*6236dae4SAndroid Build Coastguard WorkerArg: <file>
6*6236dae4SAndroid Build Coastguard WorkerHelp: Write a debug trace to FILE
7*6236dae4SAndroid Build Coastguard WorkerMutexed: verbose trace-ascii
8*6236dae4SAndroid Build Coastguard WorkerCategory: verbose global
9*6236dae4SAndroid Build Coastguard WorkerAdded: 7.9.7
10*6236dae4SAndroid Build Coastguard WorkerMulti: single
11*6236dae4SAndroid Build Coastguard WorkerScope: global
12*6236dae4SAndroid Build Coastguard WorkerSee-also:
13*6236dae4SAndroid Build Coastguard Worker  - trace-ascii
14*6236dae4SAndroid Build Coastguard Worker  - trace-config
15*6236dae4SAndroid Build Coastguard Worker  - trace-ids
16*6236dae4SAndroid Build Coastguard Worker  - trace-time
17*6236dae4SAndroid Build Coastguard WorkerExample:
18*6236dae4SAndroid Build Coastguard Worker  - --trace log.txt $URL
19*6236dae4SAndroid Build Coastguard Worker---
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard Worker# `--trace`
22*6236dae4SAndroid Build Coastguard Worker
23*6236dae4SAndroid Build Coastguard WorkerSave a full trace dump of all incoming and outgoing data, including
24*6236dae4SAndroid Build Coastguard Workerdescriptive information, in the given output file. Use `-` as filename to have
25*6236dae4SAndroid Build Coastguard Workerthe output sent to stdout. Use `%` as filename to have the output sent to
26*6236dae4SAndroid Build Coastguard Workerstderr.
27*6236dae4SAndroid Build Coastguard Worker
28*6236dae4SAndroid Build Coastguard WorkerNote that verbose output of curl activities and network traffic might contain
29*6236dae4SAndroid Build Coastguard Workersensitive data, including usernames, credentials or secret data content. Be
30*6236dae4SAndroid Build Coastguard Workeraware and be careful when sharing trace logs with others.
31