X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=utilities%2Fovs-dpctl.8.in;h=12fa27bfa69534af895e4c252f5179ef7c09c92e;hb=40a09c8aa9577d0d099eb5bbcb5ef69800e9e6f0;hp=b7965bc37b08f9551bf4e8ed8dc42914be9e0a13;hpb=4e312e694f1e9e34ed0aad7d5778b73d7add270d;p=openvswitch diff --git a/utilities/ovs-dpctl.8.in b/utilities/ovs-dpctl.8.in index b7965bc3..12fa27bf 100644 --- a/utilities/ovs-dpctl.8.in +++ b/utilities/ovs-dpctl.8.in @@ -21,29 +21,22 @@ host's other network devices. To intercept and process traffic on a given network device, use the \fBadd\-if\fR command to explicitly add that network device to the datapath. .PP -Do not use \fBovs\-dpctl\fR commands to modify datapaths if -\fBovs\-vswitchd\fR(8) is in use. Instead, modify the -\fBovs\-vswitchd\fR configuration file and send \fBSIGHUP\fR to the -\fBovs\-vswitchd\fR process. +If \fBovs\-vswitchd\fR(8) is in use, use \fBovs\-vsctl\fR(8) instead +of \fBovs\-dpctl\fR. .PP -Most \fBovs\-dpctl\fR commands that work with datapaths take an argument -that specifies the name of the datapath, in one of the following -forms: -.so lib/dpif.man +Most \fBovs\-dpctl\fR commands that work with datapaths take an +argument that specifies the name of the datapath. Datapath names take +the form [\fItype\fB@\fR]\fIname\fR, where \fIname\fR is the network +device associated with the datapath's local port. If \fItype\fR is +given, it specifies the datapath provider of \fIname\fR, otherwise the +default provider \fBsystem\fR is assumed. .PP The following commands manage datapaths. . .TP \fBadd\-dp \fIdp\fR [\fInetdev\fR...] -Creates datapath \fIdp\fR. The name of the new datapath's local port -depends on how \fIdp\fR is specified: if it takes the form -\fBdp\fIN\fR, the local port will be named \fBdp\fIN\fR; otherwise, -the local port's name will be \fIdp\fR. -.IP -This will fail if the host already has 256 datapaths, if a network -device with the same name as the new datapath's local port already -exists, or if \fIdp\fR is given in the form \fBdp\fIN\fR -and a datapath numbered \fIN\fR already exists. +Creates datapath \fIdp\fR, with a local port also named \fIdp\fR. +This will fail if a network device \fIdp\fR already exists. .IP If \fInetdev\fRs are specified, \fBovs\-dpctl\fR adds them to the datapath. . @@ -66,10 +59,14 @@ A \fInetdev\fR may be followed by a comma-separated list of options. The following options are currently supported: . .RS -.IP "\fBinternal\fR" -Instead of attaching an existing \fInetdev\fR, creates an internal -port (analogous to the local port) with that name. +.IP "\fBtype=\fItype\fR" +Specifies the type of port to add. The default type is \fBsystem\fR. +.IP "\fIkey\fB=\fIvalue\fR" +Adds an arbitrary key-value option to the port's configuration. .RE +.IP +\fBovs\-vswitchd.conf.db\fR(5) documents the available port types and +options. . .TP \fBdel\-if \fIdp netdev\fR... @@ -106,16 +103,6 @@ discussed in \fBdump\-flows\fR, these entries are not OpenFlow flow entries. By deleting them, the process that set them up may be confused about their disappearance. . -.IP "\fBdump\-groups \fIdp\fR" -Prints to the console the sets of port groups maintained by datapath -\fIdp\fR. Ordinarily there are at least 2 port groups in a datapath -that \fBovs\-openflowd\fR or \fBovs\-vswitch\fR is controlling: group -0 contains -all ports except those disabled by STP, and group 1 contains all -ports. Additional or different groups might be used in the future. -.IP -This command is primarily useful for debugging Open vSwitch. OpenFlow -does not have a concept of port groups. .SH OPTIONS .TP \fB\-t\fR, \fB\-\-timeout=\fIsecs\fR