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           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
56           convert   - convert trace files
57

OPTIONS

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

SEE ALSO

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

AUTHOR

73       Written by Steven Rostedt, <rostedt@goodmis.org[1]>
74

RESOURCES

76       https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/
77

COPYING

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

NOTES

83        1. rostedt@goodmis.org
84           mailto:rostedt@goodmis.org
85
86
87
88libtracefs                        04/15/2022                      TRACE-CMD(1)
Impressum