diff options
Diffstat (limited to 'Documentation/trace-cmd/trace-cmd-stop.1.txt')
| -rw-r--r-- | Documentation/trace-cmd/trace-cmd-stop.1.txt | 63 |
1 files changed, 63 insertions, 0 deletions
diff --git a/Documentation/trace-cmd/trace-cmd-stop.1.txt b/Documentation/trace-cmd/trace-cmd-stop.1.txt new file mode 100644 index 00000000..313192c3 --- /dev/null +++ b/Documentation/trace-cmd/trace-cmd-stop.1.txt @@ -0,0 +1,63 @@ +TRACE-CMD-STOP(1) +================= + +NAME +---- +trace-cmd-stop - stop the Ftrace Linux kernel tracer from writing to the ring +buffer. + +SYNOPSIS +-------- +*trace-cmd stop* ['OPTIONS'] + +DESCRIPTION +----------- +The trace-cmd(1) stop is a complement to 'trace-cmd-start(1)'. This will +disable Ftrace from writing to the ring buffer. This does not stop the +overhead that the tracing may incur. Only the updating of the ring buffer is +disabled, the Ftrace tracing may still be inducing overhead. + +After stopping the trace, the 'trace-cmd-extract(1)' may strip out the data +from the ring buffer and create a trace.dat file. The Ftrace pseudo file +system may also be examined. + +To disable the tracing completely to remove the overhead it causes, use +'trace-cmd-reset(1)'. But after a reset is performed, the data that has been +recorded is lost. + +OPTIONS +------- +*-B* 'buffer-name':: + If the kernel supports multiple buffers, this will stop the trace for + only the given buffer. It does not affect any other buffer. This may be + used multiple times to specify different buffers. When this option is + used, the top level instance will not be stopped unless *-t* is given. + +*-a*:: + Stop the trace for all existing buffer instances. When this option + is used, the top level instance will not be stopped unless *-t* is given. + +*-t*:: + Stops the top level instance buffer. Without the *-B* or *-a* option this + is the same as the default. But if *-B* or *-a* is used, this is + required if the top level instance buffer should also be stopped. + +SEE ALSO +-------- +trace-cmd(1), trace-cmd-record(1), trace-cmd-report(1), trace-cmd-start(1), +trace-cmd-extract(1), trace-cmd-reset(1), trace-cmd-split(1), +trace-cmd-list(1), trace-cmd-listen(1) + +AUTHOR +------ +Written by Steven Rostedt, <rostedt@goodmis.org> + +RESOURCES +--------- +https://git.kernel.org/pub/scm/utils/trace-cmd/trace-cmd.git/ + +COPYING +------- +Copyright \(C) 2010 Red Hat, Inc. Free use of this software is granted under +the terms of the GNU Public License (GPL). + |