aboutsummaryrefslogtreecommitdiff
path: root/utilities/ovs-parse-backtrace.8
diff options
context:
space:
mode:
authorEthan Jackson <ethan@nicira.com>2012-10-15 12:42:48 -0700
committerEthan Jackson <ethan@nicira.com>2012-10-17 13:23:24 -0700
commit013061cfa364fe4c2f3f1f17fe90ab4b226f37df (patch)
tree4462f6ddeeb81b5206e6be7f14cab4b9a5ed715b /utilities/ovs-parse-backtrace.8
parent3d7cab5fe02a7c7181d1479f3b41f4b6d3fa0264 (diff)
utilities: New helper ovs-parse-backtrace.
The new ovs-parse-backtrace utility makes the output of ovs-appctl backtrace more human readable by removing duplicate traces and converting addresses to function names. Signed-off-by: Ethan Jackson <ethan@nicira.com>
Diffstat (limited to 'utilities/ovs-parse-backtrace.8')
-rw-r--r--utilities/ovs-parse-backtrace.828
1 files changed, 28 insertions, 0 deletions
diff --git a/utilities/ovs-parse-backtrace.8 b/utilities/ovs-parse-backtrace.8
new file mode 100644
index 00000000..2fa7c174
--- /dev/null
+++ b/utilities/ovs-parse-backtrace.8
@@ -0,0 +1,28 @@
+.TH ovs\-parse\-backtrace 8 "October 2012" "Open vSwitch" "Open vSwitch Manual"
+.
+.SH NAME
+ovs\-parse\-backtrace \- parses ovs-appctl backtrace output
+.
+.SH SYNOPSIS
+\fBovs\-appctl backtrace\fR | \fBovs\-parse\-backtrace\fR [\fIbinary\fR]
+.P
+\fBovs\-parse\-backtrace\fR [\fIbinary\fR] < \fIbacktrace\fR
+.
+.SH DESCRIPTION
+In some configurations, many Open vSwitch daemons can produce a series of
+backtraces using the \fBovs\-appctl backtrace\fR command. Users can analyze
+these backtraces to figure out what the given Open vSwitch daemon may be
+spending most of its time doing. \fBovs\-parse\-backtrace\fR makes this output
+easier to interpret.
+.PP
+The \fBovs\-appctl backtrace\fR output must be supplied on standard input. The
+binary that produced the output should be supplied as the sole non-option
+argument. For best results, the binary should have debug symbols.
+.
+.SH OPTIONS
+.TP
+\fB\-\-help\fR
+Prints a usage message and exits.
+.P
+\fB\-\-version\fR
+Prints the version and exits.