aboutsummaryrefslogtreecommitdiff
path: root/docs/cmdline-opts/trace.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/cmdline-opts/trace.md')
-rw-r--r--docs/cmdline-opts/trace.md30
1 files changed, 30 insertions, 0 deletions
diff --git a/docs/cmdline-opts/trace.md b/docs/cmdline-opts/trace.md
new file mode 100644
index 000000000..90bb28f4f
--- /dev/null
+++ b/docs/cmdline-opts/trace.md
@@ -0,0 +1,30 @@
+---
+c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
+SPDX-License-Identifier: curl
+Long: trace
+Arg: <file>
+Help: Write a debug trace to FILE
+Mutexed: verbose trace-ascii
+Category: verbose
+Added: 7.9.7
+Multi: single
+Scope: global
+See-also:
+ - trace-ascii
+ - trace-config
+ - trace-ids
+ - trace-time
+Example:
+ - --trace log.txt $URL
+---
+
+# `--trace`
+
+Enables a full trace dump of all incoming and outgoing data, including
+descriptive information, to the given output file. Use "-" as filename to have
+the output sent to stdout. Use "%" as filename to have the output sent to
+stderr.
+
+Note that verbose output of curl activities and network traffic might contain
+sensitive data, including user names, credentials or secret data content. Be
+aware and be careful when sharing trace logs with others.