Skip to content

Commit

Permalink
README: Adding github markup and travis-ci build status to github rea…
Browse files Browse the repository at this point in the history
…dme page.

Signed-off-by: Pritesh Kothari <[email protected]>
Signed-off-by: Ben Pfaff <[email protected]>
  • Loading branch information
Pritesh Kothari authored and blp committed Oct 1, 2014
1 parent a07e26b commit d25e2f5
Show file tree
Hide file tree
Showing 6 changed files with 47 additions and 50 deletions.
2 changes: 1 addition & 1 deletion INSTALL
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ at some cost in features and performance (see INSTALL.userspace for
details). To compile the kernel module on Linux, you must also
install the following:

- A supported Linux kernel version. Please refer to README for a
- A supported Linux kernel version. Please refer to README.md for a
list of supported versions.

The Open vSwitch datapath requires bridging support
Expand Down
1 change: 1 addition & 0 deletions Makefile.am
Original file line number Diff line number Diff line change
Expand Up @@ -82,6 +82,7 @@ EXTRA_DIST = \
NOTICE \
OPENFLOW-1.1+ \
PORTING \
README.md \
README-lisp \
REPORTING-BUGS \
TODO \
Expand Down
88 changes: 42 additions & 46 deletions README → README.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,9 @@
Open vSwitch <http://openvswitch.org>
# Open vSwitch

Build Status:
-------------

[![Build Status](https://travis-ci.org/openvswitch/ovs.png)](https://travis-ci.org/openvswitch/ovs)

What is Open vSwitch?
---------------------
Expand All @@ -20,15 +25,15 @@ The bulk of the code is written in platform-independent C and is
easily ported to other environments. The current release of Open
vSwitch supports the following features:

* Standard 802.1Q VLAN model with trunk and access ports
* NIC bonding with or without LACP on upstream switch
* NetFlow, sFlow(R), and mirroring for increased visibility
* QoS (Quality of Service) configuration, plus policing
* Geneve, GRE, GRE over IPSEC, VXLAN, and LISP tunneling
* 802.1ag connectivity fault management
* OpenFlow 1.0 plus numerous extensions
* Transactional configuration database with C and Python bindings
* High-performance forwarding using a Linux kernel module
* Standard 802.1Q VLAN model with trunk and access ports
* NIC bonding with or without LACP on upstream switch
* NetFlow, sFlow(R), and mirroring for increased visibility
* QoS (Quality of Service) configuration, plus policing
* Geneve, GRE, GRE over IPSEC, VXLAN, and LISP tunneling
* 802.1ag connectivity fault management
* OpenFlow 1.0 plus numerous extensions
* Transactional configuration database with C and Python bindings
* High-performance forwarding using a Linux kernel module

The included Linux kernel module supports Linux 2.6.32 and up, with
testing focused on 2.6.32 with Centos and Xen patches. Open vSwitch
Expand All @@ -45,37 +50,29 @@ What's here?

The main components of this distribution are:

* ovs-vswitchd, a daemon that implements the switch, along with
a companion Linux kernel module for flow-based switching.

* ovsdb-server, a lightweight database server that ovs-vswitchd
queries to obtain its configuration.

* ovs-dpctl, a tool for configuring the switch kernel module.

* Scripts and specs for building RPMs for Citrix XenServer and Red
Hat Enterprise Linux. The XenServer RPMs allow Open vSwitch to
be installed on a Citrix XenServer host as a drop-in replacement
for its switch, with additional functionality.

* ovs-vsctl, a utility for querying and updating the configuration
of ovs-vswitchd.

* ovs-appctl, a utility that sends commands to running Open
* ovs-vswitchd, a daemon that implements the switch, along with
a companion Linux kernel module for flow-based switching.
* ovsdb-server, a lightweight database server that ovs-vswitchd
queries to obtain its configuration.
* ovs-dpctl, a tool for configuring the switch kernel module.
* Scripts and specs for building RPMs for Citrix XenServer and Red
Hat Enterprise Linux. The XenServer RPMs allow Open vSwitch to
be installed on a Citrix XenServer host as a drop-in replacement
for its switch, with additional functionality.
* ovs-vsctl, a utility for querying and updating the configuration
of ovs-vswitchd.
* ovs-appctl, a utility that sends commands to running Open
vSwitch daemons.

Open vSwitch also provides some tools:

* 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-testcontroller, a simple OpenFlow controller that may be useful
for testing (though not for production).

* A patch to tcpdump that enables it to parse OpenFlow messages.
* 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-testcontroller, a simple OpenFlow controller that may be useful
for testing (though not for production).
* A patch to tcpdump that enables it to parse OpenFlow messages.

What other documentation is available?
--------------------------------------
Expand All @@ -84,18 +81,18 @@ To install Open vSwitch on a regular Linux or FreeBSD host, please
read INSTALL. For specifics around installation on a specific
platform, please see one of these files:

- INSTALL.Debian
- INSTALL.Fedora
- INSTALL.RHEL
- INSTALL.XenServer
- INSTALL.Debian
- INSTALL.Fedora
- INSTALL.RHEL
- INSTALL.XenServer

To use Open vSwitch...

- ...with KVM on Linux, read INSTALL, read INSTALL.KVM.
- ...with KVM on Linux, read INSTALL, read INSTALL.KVM.

- ...with Libvirt, read INSTALL.Libvirt.
- ...with Libvirt, read INSTALL.Libvirt.

- ...without using a kernel module, read INSTALL.userspace.
- ...without using a kernel module, read INSTALL.userspace.

For answers to common questions, read FAQ.

Expand All @@ -109,8 +106,7 @@ of the manpages are customized to your configuration as part of the
build process, so we recommend building Open vSwitch before reading
the manpages.

Contact
Contact
-------

[email protected]
http://openvswitch.org/
2 changes: 1 addition & 1 deletion rhel/openvswitch-fedora.spec.in
Original file line number Diff line number Diff line change
Expand Up @@ -203,7 +203,7 @@ systemctl start openvswitch.service
%doc /usr/share/man/man8/ovs-test.8.gz
%doc /usr/share/man/man8/ovs-l3ping.8.gz
%doc /usr/share/man/man8/vtep-ctl.8.gz
%doc COPYING DESIGN INSTALL.SSL NOTICE README WHY-OVS FAQ NEWS INSTALL.DPDK
%doc COPYING DESIGN INSTALL.SSL NOTICE README.md WHY-OVS FAQ NEWS INSTALL.DPDK
/var/lib/openvswitch
/var/log/openvswitch
/usr/share/openvswitch/scripts/ovs-ctl
Expand Down
2 changes: 1 addition & 1 deletion rhel/openvswitch.spec.in
Original file line number Diff line number Diff line change
Expand Up @@ -174,7 +174,7 @@ exit 0
/usr/share/openvswitch/scripts/sysconfig.template
/usr/share/openvswitch/vswitch.ovsschema
/usr/share/openvswitch/vtep.ovsschema
%doc COPYING DESIGN INSTALL.SSL NOTICE README WHY-OVS FAQ NEWS
%doc COPYING DESIGN INSTALL.SSL NOTICE README.md WHY-OVS FAQ NEWS
%doc INSTALL.DPDK rhel/README.RHEL
/var/lib/openvswitch
/var/log/openvswitch
2 changes: 1 addition & 1 deletion utilities/ovs-ctl.8
Original file line number Diff line number Diff line change
Expand Up @@ -441,5 +441,5 @@ distribution are good examples of how to use \fBovs\-ctl\fR.
.
.SH "SEE ALSO"
.
\fBREADME\fR, \fBINSTALL.Linux\fR, \fBovsdb\-server\fR(8),
\fBREADME.md\fR, \fBINSTALL.Linux\fR, \fBovsdb\-server\fR(8),
\fBovs\-vswitchd\fR(8).

0 comments on commit d25e2f5

Please sign in to comment.