X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=vswitchd%2Fovs-vswitchd.8.in;h=e59893ff4e36d944f80ba837023cb51eec4122eb;hb=d530fcd2425c2443c1a1c093903b6932c4c5814c;hp=24c1c5d3df6f9a26c2633df28c0fb26eff612ce1;hpb=9e15c889f7a94db2decefd93dd6b3f77fb1b7bc6;p=openvswitch diff --git a/vswitchd/ovs-vswitchd.8.in b/vswitchd/ovs-vswitchd.8.in index 24c1c5d3..e59893ff 100644 --- a/vswitchd/ovs-vswitchd.8.in +++ b/vswitchd/ovs-vswitchd.8.in @@ -5,7 +5,10 @@ . IP "\\$1" .. .TH ovs\-vswitchd 8 "June 2009" "Open vSwitch" "Open vSwitch Manual" +.\" This program's name: .ds PN ovs\-vswitchd +.\" SSL peer program's name: +.ds SN ovs\-controller . .SH NAME ovs\-vswitchd \- Open vSwitch daemon @@ -18,9 +21,10 @@ ovs\-vswitchd \- Open vSwitch daemon A daemon that manages and controls any number of Open vSwitch switches on the local machine. .PP -The mandatory \fIdatabase\fR argument specifies the -\fBovsdb\-server\fR from which \fBovs\-vswitchd\fR's configuration -should be retrieved. It takes one of the following forms: +The mandatory \fIdatabase\fR argument normally takes the form +\fBunix:\fIfile\fR, where \fIfile\fR is the name of a Unix domain +socket on which \fBovsdb\-server\fR is listening. However, all of the +following forms are accepted: .so ovsdb/remote-active.man .so ovsdb/remote-passive.man .PP @@ -63,6 +67,9 @@ Only a single instance of \fBovs\-vswitchd\fR is intended to run at a time. A single \fBovs\-vswitchd\fR can manage any number of switch instances, up to the maximum number of supported Open vSwitch datapaths. .PP +\fBovs\-vswitchd\fR provides all the features of \fBovs-openflowd\fR, +and more. Do not run both daemons at the same time. +.PP \fBovs\-vswitchd\fR does all the necessary management of Open vSwitch datapaths itself. Thus, external tools, such \fBovs\-dpctl\fR(8), are not needed for managing datapaths in conjunction with \fBovs\-vswitchd\fR, and their use @@ -75,7 +82,7 @@ Open vSwitch distribution for instructions on how to build and load the Open vSwitch kernel module. .PP .SH OPTIONS -.IP "\fB--mlockall\fR" +.IP "\fB\-\-mlockall\fR" Causes \fBovs\-vswitchd\fR to call the \fBmlockall()\fR function, to attempt to lock all of its process memory into physical RAM, preventing the kernel from paging any of its memory to disk. This @@ -86,12 +93,14 @@ only allow privileged users, such as the superuser, to use it. \fBovs\-vswitchd\fR emits a log message if \fBmlockall()\fR is unavailable or unsuccessful. . -.IP "\fB--fake-proc-net\fR" +.IP "\fB\-\-fake\-proc\-net\fR" Causes \fBovs\-vswitchd\fR to simulate some files in \fB/proc/net/vlan\fR and \fB/proc/net/bonding\fR that some legacy software expects to exist. This option should only be used if such legacy software is actually in use. It requires the \fBbrcompat_mod.ko\fR kernel module to be loaded. +.IP +On non-Linux hosts, this option is accepted but has no effect. . .so lib/daemon.man .SS "Public Key Infrastructure Options" @@ -115,10 +124,16 @@ These commands manage bridges. Lists each MAC address/VLAN pair learned by the specified \fIbridge\fR, along with the port on which it was learned and the age of the entry, in seconds. +.IP "\fBbridge/reconnect\fR [\fIbridge\fR]" +Makes \fIbridge\fR drop all of its OpenFlow controller connections and +reconnect. If \fIbridge\fR is not specified, then all bridges drop +their controller connections and reconnect. +.IP +This command might be useful for debugging OpenFlow controller issues. . -.IP "\fBbridge/dump-flows\fR \fIbridge\fR" +.IP "\fBbridge/dump\-flows\fR \fIbridge\fR" Lists all flows in \fIbridge\fR, including those normally hidden to -commands such as \fBovs-ofctl dump-flows\fR. Flows set up by mechanisms +commands such as \fBovs\-ofctl dump\-flows\fR. Flows set up by mechanisms such as in-band control and fail-open are hidden from the controller since it is not allowed to modify or override them. .SS "BOND COMMANDS" @@ -151,14 +166,14 @@ cause the MAC hash to be shifted to a new slave in the usual manner. .IP A MAC hash cannot be migrated to a disabled slave. -.IP "\fBbond/set-active-slave\fR \fIport\fR \fIslave\fR" +.IP "\fBbond/set\-active\-slave\fR \fIport\fR \fIslave\fR" Sets \fIslave\fR as the active slave on \fIport\fR. \fIslave\fR must currently be enabled. .IP The setting is not permanent: a new active slave will be selected if \fIslave\fR becomes disabled. -.IP "\fBbond/enable-slave\fR \fIport\fR \fIslave\fR" -.IQ "\fBbond/disable-slave\fR \fIport\fR \fIslave\fR" +.IP "\fBbond/enable\-slave\fR \fIport\fR \fIslave\fR" +.IQ "\fBbond/disable\-slave\fR \fIport\fR \fIslave\fR" Enables (or disables) \fIslave\fR on the given bond \fIport\fR, skipping any updelay (or downdelay). .IP