trace-cmd-{list, record, report}: add page, tracecmd: refresh page (#17264)

Co-authored-by: Managor <[email protected]>

Author: Harrisonust

pages/linux/trace-cmd-list.md

@@ -0,0 +1,21 @@
+# trace-cmd list
+
+> Show available tracers, events, or options for tracing.
+> See also: `trace-cmd record`, `trace-cmd report`.
+> More information: <https://manned.org/trace-cmd-list>.
+
+- List available tracers:
+
+`sudo trace-cmd list -t`
+
+- List available plugins:
+
+`sudo trace-cmd list -p`
+
+- List available events:
+
+`sudo trace-cmd list -e`
+
+- List available functions:
+
+`sudo trace-cmd list -f`

pages/linux/trace-cmd-record.md

@@ -0,0 +1,29 @@
+# trace-cmd record
+
+> Capture kernel trace events.
+> See also: `trace-cmd list`, `trace-cmd report`.
+> More information: <https://manned.org/trace-cmd-record>.
+
+- Record a trace with a specific plugin:
+
+`sudo trace-cmd record -p {{plugin}}`
+
+- Record a trace of a specific executable:
+
+`sudo trace-cmd record -F {{executable}}`
+
+- Record a trace of a specific function:
+
+`sudo trace-cmd record -g {{function}}`
+
+- Exclude a specific function from the trace:
+
+`sudo trace-cmd record -n {{function}}`
+
+- Limit the function call graph depth:
+
+`sudo trace-cmd record --max-graph-depth {{depth}}`
+
+- Record a trace from a specific process ID:
+
+`sudo trace-cmd record -P {{pid}}`

pages/linux/trace-cmd-report.md

@@ -0,0 +1,13 @@
+# trace-cmd report
+
+> Display recorded trace events.
+> See also: `trace-cmd list`, `trace-cmd record`.
+> More information: <https://manned.org/trace-cmd-report>.
+
+- Display the recorded trace:
+
+`sudo trace-cmd report`
+
+- Display the recorded trace for a specific CPU:
+
+`sudo trace-cmd report --cpu {{cpu_number}}`

pages/linux/trace-cmd.md

@@ -1,33 +1,37 @@
 # trace-cmd
 
 > Utility to interact with the Ftrace Linux kernel internal tracer.
-> This utility only runs as root.
+> See also: `trace-cmd list`, `trace-cmd record`, `trace-cmd report`.
 > More information: <https://manned.org/trace-cmd>.
 
 - Display the status of tracing system:
 
-`trace-cmd stat`
+`sudo trace-cmd stat`
 
 - List available tracers:
 
-`trace-cmd list -t`
+`sudo trace-cmd list -t`
 
 - Start tracing with a specific plugin:
 
-`trace-cmd start -p {{timerlat|osnoise|hwlat|blk|mmiotrace|function_graph|wakeup_dl|wakeup_rt|wakeup|function|nop}}`
+`sudo trace-cmd start -p {{function|function_graph|preemptirqsoff|irqsoff|preemptoff|wakeup|...}}`
 
 - View the trace output:
 
-`trace-cmd show`
+`sudo trace-cmd show`
 
 - Stop the tracing but retain the buffers:
 
-`trace-cmd stop`
+`sudo trace-cmd stop`
 
 - Clear the trace buffers:
 
-`trace-cmd clear`
+`sudo trace-cmd clear`
 
-- Clear the trace buffers and stop tracing:
+- Record a trace:
 
-`trace-cmd reset`
+`sudo trace-cmd record`
+
+- Display the recorded trace:
+
+`sudo trace-cmd report`