X-Git-Url: https://pintos-os.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=vswitchd%2Fovs-vswitchd.8.in;h=5a016cd0adad3334e836d74345c45152b6b49327;hb=6c1b89ed0e6b9934d63ae4d71ba885bfcb87891a;hp=5c8d6c77213b87593f29970f96b1993a6748b27e;hpb=cdd35cff225bf39767ea9e2e535cf2940b0e5127;p=openvswitch diff --git a/vswitchd/ovs-vswitchd.8.in b/vswitchd/ovs-vswitchd.8.in index 5c8d6c77..5a016cd0 100644 --- a/vswitchd/ovs-vswitchd.8.in +++ b/vswitchd/ovs-vswitchd.8.in @@ -4,32 +4,39 @@ . ns . IP "\\$1" .. -.TH ovs\-vswitchd 8 "March 2009" "Open vSwitch" "Open vSwitch Manual" +.TH ovs\-vswitchd 8 "June 2009" "Open vSwitch" "Open vSwitch Manual" .ds PN ovs\-vswitchd . .SH NAME -ovs\-vswitchd \- virtual switch daemon +ovs\-vswitchd \- Open vSwitch daemon . .SH SYNOPSIS .B ovs\-vswitchd -\fIconfig\fR +\fIdatabase\fR . .SH DESCRIPTION -A daemon that manages and controls any number of virtual switches on -the local machine. +A daemon that manages and controls any number of Open vSwitch switches +on the local machine. .PP -The mandatory \fIconfig\fR argument specifies a configuration file. -For a description of \fBovs\-vswitchd\fR configuration syntax, see -\fBovs\-vswitchd.conf\fR(5). +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: +.IP "\fBtcp:\fIip\fB:\fIport\fR" +Connect to the given TCP \fIport\fR on \fIip\fR. +.IP "\fBunix:\fIfile\fR" +Connect to the Unix domain server socket named \fIfile\fR. .PP -At startup or upon receipt of a \fBSIGHUP\fR signal, \fBovs\-vswitchd\fR -reads the configuration file. It sets up Open vSwitch datapaths and then -operates switching across each bridge described in its configuration -files. If a logfile was specified on the command line it will also -be opened or reopened. +\fBovs\-vswitchd\fR retrieves its configuration from \fIdatabase\fR at +startup. It sets up Open vSwitch datapaths and then operates +switching across each bridge described in its configuration files. As +the database changes, \fBovs\-vswitchd\fR automatically updates its +configuration to match. .PP -\fBovs\-vswitchd\fR virtual switches may be configured with any of the -following features: +Upon receipt of a SIGHUP signal, \fBovs\-vswitchd\fR reopens its log +file, if one was specified on the command line. +.PP +\fBovs\-vswitchd\fR switches may be configured with any of the following +features: . .IP \(bu L2 switching with MAC learning. @@ -52,7 +59,7 @@ Connectivity to an external OpenFlow controller, such as NOX. . .PP 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 virtual switches, up +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 does all the necessary management of Open vSwitch datapaths @@ -62,7 +69,7 @@ to modify datapaths when \fBovs\-vswitchd\fR is running can interfere with its operation. (\fBovs\-dpctl\fR may still be useful for diagnostics.) .PP An Open vSwitch datapath kernel module must be loaded for \fBovs\-vswitchd\fR -to be useful. Please refer to the \fBINSTALL\fR file included in the +to be useful. Please refer to the \fBINSTALL.Linux\fR file included in the Open vSwitch distribution for instructions on how to build and load the Open vSwitch kernel module. .PP @@ -83,16 +90,7 @@ to be loaded. \fBovs\-appctl\fR(8) can send commands to a running \fBovs\-vswitchd\fR process. The currently supported commands are described below. The command descriptions assume an understanding of -how to configure Open vSwitch, as described in -\fBovs-vswitchd.conf\fR(5). -.SS "OVS\-VSWITCHD COMMANDS" -These commands manage the \fBovs-vswitchd\fR process. -.IP "\fBvswitchd/reload\fR" -Reloads the \fBovs\-vswitchd\fR configuration file, as if a -\fBSIGHUP\fR signal were received. The command completes only after -reloading is finished, in particular after all datapaths have been -created and destroyed and ports added and removed as specified by the -new configuration. +how to configure Open vSwitch. .SS "BRIDGE COMMANDS" These commands manage bridges. .IP "\fBfdb/show\fR \fIbridge\fR" @@ -148,10 +146,12 @@ updelay (or downdelay). .IP This setting is not permanent: it persists only until the carrier status of \fIslave\fR changes. +.IP "\fBbond/hash\fR \fImac\fR" +Returns the hash value which would be used for \fImac\fR. . .so lib/vlog-unixctl.man .SH "SEE ALSO" .BR ovs\-appctl (8), -.BR ovs\-vswitchd.conf (5), .BR ovs\-brcompatd (8), -\fBINSTALL\fR in the Open vSwitch distribution. +.BR ovsdb\-server (1), +\fBINSTALL.Linux\fR in the Open vSwitch distribution.