1TRACE-CMD(1)                   libtracefs Manual                  TRACE-CMD(1)
2
3
4

NAME

6       trace-cmd - interacts with Ftrace Linux kernel internal tracer
7

SYNOPSIS

9       trace-cmd COMMAND [OPTIONS]
10

DESCRIPTION

12       The trace-cmd(1) command interacts with the Ftrace tracer that is built
13       inside the Linux kernel. It interfaces with the Ftrace specific files
14       found in the debugfs file system under the tracing directory. A COMMAND
15       must be specified to tell trace-cmd what to do.
16

COMMANDS

18           record  - record a live trace and write a trace.dat file to the
19                     local disk or to the network.
20
21           set     - set a ftrace configuration parameter.
22
23           report  - reads a trace.dat file and converts the binary data to a
24                     ASCII text readable format.
25
26           stream  - Start tracing and read the output directly
27
28           profile - Start profiling and read the output directly
29
30           hist    - show a histogram of the events.
31
32           stat    - show tracing (ftrace) status of the running system
33
34           options - list the plugin options that are available to *report*
35
36           start   - start the tracing without recording to a trace.dat file.
37
38           stop    - stop tracing (only disables recording, overhead of tracer
39                     is still in effect)
40
41           restart - restart tracing from a previous stop (only effects recording)
42
43           extract - extract the data from the kernel buffer and create a trace.dat
44                     file.
45
46           show    - display the contents of one of the Ftrace Linux kernel tracing files
47
48           reset   - disables all tracing and gives back the system performance.
49                     (clears all data from the kernel buffers)
50
51           clear   - clear the content of the Ftrace ring buffers.
52
53           split   - splits a trace.dat file into smaller files.
54
55           list    - list the available plugins or events that can be recorded.
56
57           listen  - open up a port to listen for remote tracing connections.
58
59           agent   - listen on a vsocket for trace clients
60
61           setup-guest - create FIFOs for tracing guest VMs
62
63           restore - restore the data files of a crashed run of trace-cmd record
64
65           snapshot- take snapshot of running trace
66
67           stack   - run and display the stack tracer
68
69           check-events - parse format strings for all trace events and return
70                          whether all formats are parseable
71
72           convert   - convert trace files
73
74           dump    - read out the meta data from a trace file
75

OPTIONS

77       -h, --help
78           Display the help text.
79
80       Other options see the man page for the corresponding command.
81

SEE ALSO

83       trace-cmd-record(1), trace-cmd-report(1), trace-cmd-hist(1),
84       trace-cmd-start(1), trace-cmd-stop(1), trace-cmd-extract(1),
85       trace-cmd-reset(1), trace-cmd-restore(1), trace-cmd-stack(1),
86       trace-cmd-convert(1), trace-cmd-split(1), trace-cmd-list(1),
87       trace-cmd-listen(1), trace-cmd.dat(5), trace-cmd-check-events(1)
88       trace-cmd-stat(1)
89

AUTHOR

91       Written by Steven Rostedt, <rostedt@goodmis.org[1]>
92

RESOURCES

94       https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
95

COPYING

97       Copyright (C) 2010 Red Hat, Inc. Free use of this software is granted
98       under the terms of the GNU Public License (GPL).
99

NOTES

101        1. rostedt@goodmis.org
102           mailto:rostedt@goodmis.org
103
104
105
106libtracefs                        10/11/2022                      TRACE-CMD(1)
Impressum