1TRACE-CMD(1)                                                      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           report  - reads a trace.dat file and converts the binary data to a
22                     ASCII text readable format.
23
24           hist    - show a histogram of the events.
25
26           stat    - show tracing (ftrace) status of the running system
27
28           options - list the plugin options that are available to *report*
29
30           start   - start the tracing without recording to a trace.dat file.
31
32           stop    - stop tracing (only disables recording, overhead of tracer
33                     is still in effect)
34
35           restart - restart tracing from a previous stop (only effects recording)
36
37           extract - extract the data from the kernel buffer and create a trace.dat
38                     file.
39
40           reset   - disables all tracing and gives back the system performance.
41                     (clears all data from the kernel buffers)
42
43           split   - splits a trace.dat file into smaller files.
44
45           list    - list the available plugins or events that can be recorded.
46
47           listen  - open up a port to listen for remote tracing connections.
48
49           restore - restore the data files of a crashed run of trace-cmd record
50
51           stack   - run and display the stack tracer
52
53           check-events - parse format strings for all trace events and return
54                          whether all formats are parseable
55

OPTIONS

57       -h, --help
58           Display the help text.
59
60       Other options see the man page for the corresponding command.
61

SEE ALSO

63       trace-cmd-record(1), trace-cmd-report(1), trace-cmd-hist(1),
64       trace-cmd-start(1), trace-cmd-stop(1), trace-cmd-extract(1),
65       trace-cmd-reset(1), trace-cmd-restore(1), trace-cmd-stack(1),
66       trace-cmd-split(1), trace-cmd-list(1), trace-cmd-listen(1),
67       trace-cmd.dat(5), trace-cmd-check-events(1) trace-cmd-stat(1)
68

AUTHOR

70       Written by Steven Rostedt, <rostedt@goodmis.org[1]>
71

RESOURCES

73       git://git.kernel.org/pub/scm/linux/kernel/git/rostedt/trace-cmd.git
74

COPYING

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

NOTES

80        1. rostedt@goodmis.org
81           mailto:rostedt@goodmis.org
82
83
84
85                                  12/02/2020                      TRACE-CMD(1)
Impressum