mir/ovs
2
0
Fork 0
mirror of https://github.com/openvswitch/ovs synced 2025-08-22 09:58:01 +00:00
Code Issues Releases Wiki Activity
ovs/ofproto/ofproto-dpif-unixctl.man

35 lines
1.5 KiB
Groff
Raw Permalink Normal View History

dpctl: add ovs-appctl dpctl/* commands to talk to dpif-netdev This commit introduces multiple appctl commands (dpctl/*) They are needed to interact with userspace datapaths (dpif-netdev), because the ovs-dpctl command runs in a separate process and cannot see the userspace datapaths inside vswitchd. This change moves most of the code of utilities/ovs-dpctl.c in lib/dpctl.c. Both the ovs-dpctl command and the ovs-appctl dpctl/* commands make calls to lib/dpctl.c functions, to interact with datapaths. The code from utilities/ovs-dpctl.c has been moved to lib/dpctl.c and has been changed for different reasons: - An exit() call in the old code made perfectly sense. Now (since the code can be run inside vswitchd) it would terminate the daemon. Same reasoning can be applied to ovs_fatal_*() calls. - The lib/dpctl.c code _should_ not leak memory. - All the print* have been replaced with a function pointer provided by the caller, since this code can be run in the ovs-dpctl process (in which case we need to print to stdout) or in response to a unixctl request (and in this case we need to send everything through a socket, using JSON encapsulation). The syntax is ovs-appctl dpctl/(COMMAND) [OPTIONS] [PARAMETERS] while the ovs-dpctl syntax (which _should_ remain the same after this change) is ovs-dpctl [OPTIONS] (COMMAND) [PARAMETERS] Signed-off-by: Daniele Di Proietto <ddiproietto@vmware.com> [blp@nicira.com made stylistic and documentation changes] Signed-off-by: Ben Pfaff <blp@nicira.com>
2014-07-17 17:26:00 -07:00
.SS "DATAPATH DEBUGGING COMMANDS"
These commands query and modify datapaths. They are are similar to
\fBovs\-dpctl\fR(8) commands. \fBdpif/show\fR has the additional
functionality, beyond \fBdpctl/show\fR of printing OpenFlow port
numbers. The other commands are redundant and will be removed in a
future release.
ofproto-dpif: Add ovs-appctl commands for ovs-dpctl functions. These commands will be useful in a future commit that makes multiple bridges share a single backing datapath. The ovs-dpctl commands will show information about the backing datapath, so it will be difficult to determine which information belongs to which bridge. The new "dpif/*" ovs-appctl commands return information about the bridge--regardless of how the backing datapath is configured. Signed-off-by: Justin Pettit <jpettit@nicira.com>
2012-09-25 18:47:02 -07:00
.
.IP "\fBdpif/dump\-dps\fR"
Prints the name of each configured datapath on a separate line.
.
ofproto: Track subfacet stats in the backer. Subfacets being per-datapath entities, their statistics are really only interesting at per-datapath granularity. This patch moves them to the dpif_backer and makes some related simplifications. Signed-off-by: Ethan Jackson <ethan@nicira.com>
2013-06-04 15:48:31 -07:00
.IP "\fBdpif/show\fR"
ofproto-dpif: Add ovs-appctl commands for ovs-dpctl functions. These commands will be useful in a future commit that makes multiple bridges share a single backing datapath. The ovs-dpctl commands will show information about the backing datapath, so it will be difficult to determine which information belongs to which bridge. The new "dpif/*" ovs-appctl commands return information about the bridge--regardless of how the backing datapath is configured. Signed-off-by: Justin Pettit <jpettit@nicira.com>
2012-09-25 18:47:02 -07:00
Prints a summary of configured datapaths, including statistics and a
list of connected ports. The port information includes the OpenFlow
port number, datapath port number, and the type. (The local port is
identified as OpenFlow port 65534.)
.
ofproto-dpif: Verbosity option for dpif/dump-flows command. The display of port names instead of port number for in_port is considered useful. Enabling the verbosity option also lets you see all the wildcarded fields and can be helpful. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2013-12-23 17:43:48 -08:00
.IP "\fBdpif/dump\-flows\fR [\fB\-m\fR] \fIdp\fR"
ofproto-dpif: Add ovs-appctl commands for ovs-dpctl functions. These commands will be useful in a future commit that makes multiple bridges share a single backing datapath. The ovs-dpctl commands will show information about the backing datapath, so it will be difficult to determine which information belongs to which bridge. The new "dpif/*" ovs-appctl commands return information about the bridge--regardless of how the backing datapath is configured. Signed-off-by: Justin Pettit <jpettit@nicira.com>
2012-09-25 18:47:02 -07:00
Prints to the console all flow entries in datapath \fIdp\fR's
ofproto-dpif: Verbosity option for dpif/dump-flows command. The display of port names instead of port number for in_port is considered useful. Enabling the verbosity option also lets you see all the wildcarded fields and can be helpful. Signed-off-by: Gurucharan Shetty <gshetty@nicira.com> Acked-by: Ben Pfaff <blp@nicira.com>
2013-12-23 17:43:48 -08:00
flow table. Without \fB\-m\fR, output omits match fields that a flow
wildcards entirely; with \fB\-m\fR output includes all wildcarded fields.
ofproto-dpif: Add ovs-appctl commands for ovs-dpctl functions. These commands will be useful in a future commit that makes multiple bridges share a single backing datapath. The ovs-dpctl commands will show information about the backing datapath, so it will be difficult to determine which information belongs to which bridge. The new "dpif/*" ovs-appctl commands return information about the bridge--regardless of how the backing datapath is configured. Signed-off-by: Justin Pettit <jpettit@nicira.com>
2012-09-25 18:47:02 -07:00
.IP
This command is primarily useful for debugging Open vSwitch. The flow
table entries that it displays are not OpenFlow flow entries. Instead,
they are different and considerably simpler flows maintained by the
datapath module. If you wish to see the OpenFlow flow entries, use
\fBovs\-ofctl dump\-flows\fR.
.
.IP "\fBdpif/del\-flows \fIdp\fR"
Deletes all flow entries from datapath \fIdp\fR's flow table and
underlying datapath implementation (e.g., kernel datapath module).
.IP
This command is primarily useful for debugging Open vSwitch. As
discussed in \fBdpif/dump\-flows\fR, these entries are
not OpenFlow flow entries.
Reference in New Issue Copy Permalink