From: Justin Pettit Date: Tue, 23 Jun 2009 21:18:43 +0000 (-0700) Subject: Remove references to Open vSwitch being a "virtual" switch X-Git-Tag: v0.90.2~6 X-Git-Url: http://git.onelab.eu/?p=sliver-openvswitch.git;a=commitdiff_plain;h=f30f26bef42da4b9a81e8363152563f5f0915aca Remove references to Open vSwitch being a "virtual" switch The Open vSwitch system is not limted to being a virtual switch. This commit removes these references. We are now a "versatile" switch! --- diff --git a/README b/README index 7311292b6..aee0840a1 100644 --- a/README +++ b/README @@ -3,7 +3,7 @@ What is Open vSwitch? --------------------- -Open vSwitch is an Ethernet switch for virtual servers with the +Open vSwitch is a versatile software-based Ethernet switch with the following features: * NIC bonding with automatic fail-over and source MAC-based TX @@ -15,8 +15,7 @@ following features: * NetFlow v5 flow logging. - * Connectivity to an external OpenFlow controller, such as - NOX. + * Connectivity to an external OpenFlow controller, such as NOX. Open vSwitch supports Linux 2.6.15 and up, with testing focused on 2.6.18 with Centos and Xen patches and version 2.6.26 from kernel.org. @@ -27,43 +26,39 @@ What's here? The main components of this distribution are: - - ovs-vswitchd, a daemon that implements the virtual switch, - along with a companion Linux kernel module for flow-based - switching. + * ovs-vswitchd, a daemon that implements the switch, along with + a companion Linux kernel module for flow-based switching. - - ovs-brcompatd, a daemon that allows ovs-vswitchd to act as a - drop-in replacement for the Linux bridge in many - environments, along with a companion Linux kernel module to - intercept bridge ioctls. + * ovs-brcompatd, a daemon that allows ovs-vswitchd to act as a + drop-in replacement for the Linux bridge in many environments, + along with a companion Linux kernel module to intercept bridge + ioctls. - - ovs-dpctl, a tool for configuring the virtual switch kernel - module. + * ovs-dpctl, a tool for configuring the switch kernel module. - - Scripts and specs for building RPMs that allow Open vSwitch - to be installed on a Citrix XenServer host as a drop-in - replacement for its virtual switch, with additional - functionality. + * Scripts and specs for building RPMs that allow Open vSwitch + to be installed on a Citrix XenServer host as a drop-in + replacement for its switch, with additional functionality. - - vlog-appctl, a utility that can control Open vSwitch daemons, - adjusting their logging levels among other uses. + * vlog-appctl, a utility that can control Open vSwitch daemons, + adjusting their logging levels among other uses. Open vSwitch also provides an OpenFlow implementation and tools for those interested in OpenFlow but not additional Open vSwitch features: - - secchan, a program that implements a simple OpenFlow switch - (without the special features provided by ovs-vswitchd) using - the same kernel module as ovs-vswitchd. + * secchan, a program that implements a simple OpenFlow switch + (without the special features provided by ovs-vswitchd) using + the same kernel module as ovs-vswitchd. - - ovs-controller, a simple OpenFlow controller. + * ovs-controller, a simple OpenFlow controller. - - ovs-ofctl, a utility for querying and controlling OpenFlow - switches and controllers. + * ovs-ofctl, a utility for querying and controlling OpenFlow + switches and controllers. - - ovs-pki, a utility for creating and managing the public-key - infrastructure for OpenFlow switches. + * ovs-pki, a utility for creating and managing the public-key + infrastructure for OpenFlow switches. - - A patch to tcpdump that enables it to parse OpenFlow - messages. + * A patch to tcpdump that enables it to parse OpenFlow messages. What other documentation is available? -------------------------------------- diff --git a/debian/control b/debian/control index 09eda1148..3c904b670 100644 --- a/debian/control +++ b/debian/control @@ -15,8 +15,7 @@ Description: Source code for Open vSwitch datapath Linux module from it using module-assistant or make-kpkg. README.Debian in this package provides further instructions. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-common Architecture: any @@ -25,8 +24,7 @@ Description: Open vSwitch common components openvswitch-common provides components required by both openvswitch-switch and openvswitch-controller. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-switch Architecture: any @@ -36,8 +34,7 @@ Description: Open vSwitch switch implementations openvswitch-switch provides the userspace components and utilities for the Open vSwitch kernel-based switch. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-switch-config Architecture: any @@ -46,8 +43,7 @@ Description: Open vSwitch switch implementations openvswitch-switch-config provides a utility for interactively configuring the Open vSwitch switch provided in the openvswitch-switch package. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-switchui Architecture: any @@ -71,8 +67,7 @@ Description: Open vSwitch public key infrastructure Open vSwitch switches and controllers, reducing the risk of man-in-the-middle attacks on the Open vSwitch network infrastructure. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-pki-server Architecture: all @@ -84,8 +79,7 @@ Description: Open vSwitch public key infrastructure (HTTP server support) convenient OpenFlow switch setup using the ovs-switch-setup program in the openvswitch-switch package. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: openvswitch-controller Architecture: any @@ -94,8 +88,7 @@ Description: Open vSwitch controller implementation The Open vSwitch controller enables OpenFlow switches that connect to it to act as MAC-learning Ethernet switches. . - Open vSwitch is a software-based Ethernet switch targeted at virtual - servers. + Open vSwitch is a full-featured software-based Ethernet switch. Package: corekeeper Architecture: all diff --git a/utilities/ovs-ofctl.8.in b/utilities/ovs-ofctl.8.in index 3a9c305f2..eb98043ca 100644 --- a/utilities/ovs-ofctl.8.in +++ b/utilities/ovs-ofctl.8.in @@ -1,4 +1,4 @@ -.TH ovs\-ofctl 8 "March 2009" "Open vSwitch" "Open vSwitch Manual" +.TH ovs\-ofctl 8 "June 2009" "Open vSwitch" "Open vSwitch Manual" .ds PN ovs\-ofctl .SH NAME @@ -224,8 +224,8 @@ Matches physical port \fIport_no\fR. Switch ports are numbered as displayed by \fBovs\-ofctl show\fR. .IP \fBdl_vlan=\fIvlan\fR -Matches IEEE 802.1q virtual LAN tag \fIvlan\fR. Specify \fB0xffff\fR -as \fIvlan\fR to match packets that are not tagged with a virtual LAN; +Matches IEEE 802.1q Virtual LAN tag \fIvlan\fR. Specify \fB0xffff\fR +as \fIvlan\fR to match packets that are not tagged with a Virtual LAN; otherwise, specify a number between 0 and 4095, inclusive, as the 12-bit VLAN ID to match. diff --git a/vswitchd/ovs-vswitchd.8.in b/vswitchd/ovs-vswitchd.8.in index 28e55ba31..2585a20cb 100644 --- a/vswitchd/ovs-vswitchd.8.in +++ b/vswitchd/ovs-vswitchd.8.in @@ -1,16 +1,16 @@ -.TH ovs\-vswitchd 8 "March 2009" "Open vSwitch" "OpenVSwitch 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 . .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 @@ -22,8 +22,8 @@ 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. .PP -\fBovs\-vswitchd\fR virtual switches may be configured with any of the -following features: +\fBovs\-vswitchd\fR switches may be configured with any of the following +features: . .IP \(bu L2 switching with MAC learning. @@ -46,10 +46,10 @@ 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 OpenVSwitch datapaths +\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 to modify datapaths when \fBovs\-vswitchd\fR is running can interfere with diff --git a/vswitchd/ovs-vswitchd.c b/vswitchd/ovs-vswitchd.c index 01a0e7edf..84c373f12 100644 --- a/vswitchd/ovs-vswitchd.c +++ b/vswitchd/ovs-vswitchd.c @@ -228,7 +228,7 @@ parse_options(int argc, char *argv[]) static void usage(void) { - printf("%s: virtual switch daemon\n" + printf("%s: Open vSwitch daemon\n" "usage: %s [OPTIONS] CONFIG\n" "CONFIG is a configuration file in ovs-vswitchd.conf(5) format.\n", program_name, program_name); diff --git a/vswitchd/ovs-vswitchd.conf.5.in b/vswitchd/ovs-vswitchd.conf.5.in index 8812c65ad..00a0d1eb2 100644 --- a/vswitchd/ovs-vswitchd.conf.5.in +++ b/vswitchd/ovs-vswitchd.conf.5.in @@ -16,14 +16,14 @@ . RE . PP .. -.TH ovs\-vswitchd.conf 5 "April 2009" "Open vSwitch" "OpenVSwitch Manual" +.TH ovs\-vswitchd.conf 5 "June 2009" "Open vSwitch" "Open vSwitch Manual" . .SH NAME ovs\-vswitchd.conf \- configuration file for \fBovs\-vswitchd\fR . .SH DESCRIPTION This manual page describes the syntax for the configuration file used -by \fBovs\-vswitchd\fR(8), the virtual switch daemon. +by \fBovs\-vswitchd\fR(8), the Open vSwitch daemon. .PP The configuration file is based on key-value pairs, which are given one per line in the form \fIkey\fB=\fIvalue\fR. Each \fIkey\fR @@ -56,8 +56,8 @@ with \fBdp\fR or \fBnl:\fR followed by a digit.) The names given on \fBbridge.\fIname\fB.port\fR must be the names of existing network devices, except for ``internal ports.'' An internal port is a simulated network device that receives traffic only -through the virtual switch and switches any traffic sent it through -virtual switch. An internal port may configured with an IP address, +through the switch and switches any traffic sent it through the +switch. An internal port may configured with an IP address, etc. using the usual system tools (e.g. \fBifconfig\fR, \fBip\fR). To designate network device \fInetdev\fR as an internal port, add \fBiface.\fInetdev\fB.internal=true\fR to the configuration file. @@ -322,7 +322,7 @@ This can be overridden with the \fBnetflow.\fIbridge\fB.engine-type\fR and \fBnetflow.\fIbridge\fB.engine-id\fR, respectively. Each takes a value between 0 and 255, inclusive. -Many NetFlow collectors do not expect multiple virtual switches to be +Many NetFlow collectors do not expect multiple switches to be sending messages from the same host, and they do not store the engine information which could be used to disambiguate the traffic. To prevent flows from multiple switches appearing as if they came on the interface, @@ -473,7 +473,7 @@ This optional setting may be set to \fIsecs\fR, a number of seconds. The minimum value of \fIsecs\fR is 5 seconds. The default is taken from \fBmgmt.inactivity-probe\fR (see above). .IP -When the virtual switch is connected to the controller, it waits for a +When the switch is connected to the controller, it waits for a message to be received from the controller for \fIsecs\fR seconds before it sends a inactivity probe to the controller. After sending the inactivity probe, if no response is received for an additional @@ -485,7 +485,7 @@ before entering standalone mode (see below). .IP "\fBbridge.\fIname\fB.controller.fail-mode=\fBstandalone\fR|\fBsecure\fR" .IQ "\fBmgmt.fail-mode=standalone\fR|\fBsecure\fR" When a controller is configured, it is, ordinarily, responsible for -setting up all flows on the virtual switch. Thus, if the connection to +setting up all flows on the switch. Thus, if the connection to the controller fails, no new network connections can be set up. If the connection to the controller stays down long enough, no packets can pass through the switch at all. @@ -510,7 +510,7 @@ connection attempts starts at 1 second and doubles on each failing attempt until it reaches the maximum. The default maximum backoff time is taken from \fBmgmt.max-backoff\fR. .ST "Controller Rate-Limiting" -These settings configure how the virtual switch applies a ``token +These settings configure how the switch applies a ``token bucket'' to limit the rate at which packets in unknown flows are forwarded to the OpenFlow controller for flow-setup processing. This feature prevents a single bridge from overwhelming a controller. @@ -563,24 +563,23 @@ When \fBovs\-vswitchd\fR is configured to connect over SSL for management or for controller connectivity, the following settings are required: .TP \fBssl.private-key=\fIprivkey.pem\fR -Specifies a PEM file containing the private key used as the virtual +Specifies a PEM file containing the private key used as the switch's identity for SSL connections to the controller. .TP \fBssl.certificate=\fIcert.pem\fR Specifies a PEM file containing a certificate, signed by the certificate authority (CA) used by the controller and manager, that -certifies the virtual switch's private key, identifying a trustworthy +certifies the switch's private key, identifying a trustworthy switch. .TP \fBssl.ca-cert=\fIcacert.pem\fR Specifies a PEM file containing the CA certificate used to verify that -the virtual switch is connected to a trustworthy controller. +the switch is connected to a trustworthy controller. .PP These files are read only once, at \fBovs\-vswitchd\fR startup time. If their contents change, \fBovs\-vswitchd\fR must be killed and restarted. .PP -These SSL settings apply to all SSL connections made by the virtual -switch. +These SSL settings apply to all SSL connections made by the switch. .ST "CA Certificate Bootstrap" Ordinarily, all of the files named in the SSL configuration must exist when \fBovs\-vswitchd\fR starts. However, if \fBssl.bootstrap-ca-cert\fR