Signed-off-by: Mark Hamilton <[email protected]>
---
debian/openvswitch-switch.install | 1 +
debian/openvswitch-switch.manpages | 1 +
manpages.mk | 4 +++
utilities/automake.mk | 10 +++++--
utilities/ovs-dpctl-top.8.in | 58 ++++++++++++++++++++++++++++++++++++
5 files changed, 72 insertions(+), 2 deletions(-)
create mode 100644 utilities/ovs-dpctl-top.8.in
diff --git a/debian/openvswitch-switch.install
b/debian/openvswitch-switch.install
index 4d7a15b..ab111be 100644
--- a/debian/openvswitch-switch.install
+++ b/debian/openvswitch-switch.install
@@ -1,6 +1,7 @@
usr/bin/ovs-dpctl
usr/bin/ovs-pcap
usr/bin/ovs-tcpundump
+usr/bin/ovs-dpctl-top
usr/bin/ovs-vlan-test
usr/bin/ovs-vsctl
usr/bin/ovsdb-tool
diff --git a/debian/openvswitch-switch.manpages
b/debian/openvswitch-switch.manpages
index a0a331c..3a9f8b7 100644
--- a/debian/openvswitch-switch.manpages
+++ b/debian/openvswitch-switch.manpages
@@ -3,6 +3,7 @@ _debian/utilities/ovs-dpctl.8
_debian/utilities/ovs-pcap.1
_debian/utilities/ovs-tcpundump.1
_debian/utilities/ovs-vlan-test.8
+_debian/utilities/ovs-dpctl-top.8
_debian/utilities/ovs-vsctl.8
_debian/vswitchd/ovs-vswitchd.8
vswitchd/ovs-vswitchd.conf.db.5
diff --git a/manpages.mk b/manpages.mk
index 263f2ea..2a34f04 100644
--- a/manpages.mk
+++ b/manpages.mk
@@ -116,6 +116,10 @@ lib/vconn-active.man:
lib/vconn-passive.man:
lib/vlog.man:
+utilities/ovs-dpctl-top.8: \
+ utilities/ovs-dpctl-top.8.in
+utilities/ovs-dpctl-top.8.in:
+
utilities/ovs-dpctl.8: \
utilities/ovs-dpctl.8.in \
lib/common.man \
diff --git a/utilities/automake.mk b/utilities/automake.mk
index 9f2bb63..83f2277 100644
--- a/utilities/automake.mk
+++ b/utilities/automake.mk
@@ -10,14 +10,15 @@ bin_SCRIPTS += \
utilities/ovs-l3ping \
utilities/ovs-parse-backtrace \
utilities/ovs-pcap \
+ utilities/ovs-dpctl-top \
utilities/ovs-tcpundump \
utilities/ovs-test \
- utilities/ovs-vlan-test
+ utilities/ovs-vlan-test
endif
scripts_SCRIPTS += \
utilities/ovs-check-dead-ifs \
utilities/ovs-ctl \
- utilities/ovs-save
+ utilities/ovs-save
scripts_DATA += utilities/ovs-lib
EXTRA_DIST += \
@@ -30,6 +31,7 @@ EXTRA_DIST += \
utilities/ovs-pcap.in \
utilities/ovs-pki.in \
utilities/ovs-save \
+ utilities/ovs-dpctl-top.in \
utilities/ovs-tcpundump.in \
utilities/ovs-test.in \
utilities/ovs-vlan-test.in
@@ -44,6 +46,7 @@ MAN_ROOTS += \
utilities/ovs-parse-backtrace.8 \
utilities/ovs-pcap.1.in \
utilities/ovs-pki.8.in \
+ utilities/ovs-dpctl-top.8.in \
utilities/ovs-tcpundump.1.in \
utilities/ovs-vlan-bug-workaround.8.in \
utilities/ovs-test.8.in \
@@ -66,6 +69,8 @@ DISTCLEANFILES += \
utilities/ovs-pcap.1 \
utilities/ovs-pki \
utilities/ovs-pki.8 \
+ utilities/ovs-dpctl-top \
+ utilities/ovs-dpctl-top.8 \
utilities/ovs-tcpundump \
utilities/ovs-tcpundump.1 \
utilities/ovs-test \
@@ -85,6 +90,7 @@ man_MANS += \
utilities/ovs-parse-backtrace.8 \
utilities/ovs-pcap.1 \
utilities/ovs-pki.8 \
+ utilities/ovs-dpctl-top.8 \
utilities/ovs-tcpundump.1 \
utilities/ovs-vlan-bug-workaround.8 \
utilities/ovs-test.8 \
diff --git a/utilities/ovs-dpctl-top.8.in b/utilities/ovs-dpctl-top.8.in
new file mode 100644
index 0000000..a4fa4a1
--- /dev/null
+++ b/utilities/ovs-dpctl-top.8.in
@@ -0,0 +1,58 @@
+.TH ovs\-dpctl\-top 8 "July 2013" "Open vSwitch" "Open vSwitch Manual"
+.
+.SH NAME
+ovs\-dpctl\-top \- summarizes ovs-dpctl dump-flow output
+.SH DESCRIPTION
+usage: ovs\-dpctl\-top [\-h] [\-v] [\-f FLOWFILE] [\-V] [\-t] [\-s]
+.PP
+Top like behavior for ovs\-dpctl dump\-flows output.
+.PP
+This program summarizes ovs\-dpctl flow content by aggregrating the number
+of packets and occurances of key flow concepts. These concepts are:
+.IP \[bu] 2
+the source and destination MAC address
+.IP \[bu]
+the source and destination IPv4 address
+.IP \[bu]
+the source and destination IPv6 address
+.IP \[bu]
+ethernet types
+.IP \[bu]
+IP protocol
+.IP \[bu]
+destination port and in port
+.SS "Output shows three values:"
+.IP \[bu] 2
+FLOW \- the flow concept
+.IP \[bu]
+PACKETS \- the total number of packets containing the flow concept
+.IP \[bu]
+COUNT \- the number of lines
+.PP
+in the dump\-flow output contain the flow concept.
+.PP
+Expected usage:
+.PP
+$ ovs\-dpctl\-top
+.PP
+or to run in a script:
+.PP
+$ ovs\-dpctl dump\-flows > dump\-flows.log
+.PP
+$ ovs\-dpctl\-top.py \fB\-\-script\fR \fB\-f\fR dump\-flows.log
+.SS "optional arguments:"
+.TP
+\fB\-h\fR, \fB\-\-help\fR
+show this help message and exit
+.TP
+\fB\-v\fR, \fB\-\-version\fR
+show program's version number and exit
+.TP
+\fB\-f\fR FLOWFILE, \fB\-\-flow\-file\fR FLOWFILE
+file containing flows frmo ovs\-dpctl dump\-flow
+.TP
+\fB\-V\fR, \fB\-\-verbose\fR
+enable debug level verbosity
+.TP
+\fB\-s\fR, \fB\-\-script\fR
+Run from a script (no suser interface)
--
1.7.10.4
_______________________________________________
dev mailing list
[email protected]
http://openvswitch.org/mailman/listinfo/dev
