xref: /curl/docs/cmdline-opts/trace.md (revision 2abfc759)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: trace
5Arg: <file>
6Help: Write a debug trace to FILE
7Mutexed: verbose trace-ascii
8Category: verbose global
9Added: 7.9.7
10Multi: single
11Scope: global
12See-also:
13  - trace-ascii
14  - trace-config
15  - trace-ids
16  - trace-time
17Example:
18  - --trace log.txt $URL
19---
20
21# `--trace`
22
23Save a full trace dump of all incoming and outgoing data, including
24descriptive information, in the given output file. Use `-` as filename to have
25the output sent to stdout. Use `%` as filename to have the output sent to
26stderr.
27
28Note that verbose output of curl activities and network traffic might contain
29sensitive data, including usernames, credentials or secret data content. Be
30aware and be careful when sharing trace logs with others.
31