| Branch: | Tag: | Revision:

mininet @ 21b2c2c4

Name Size Revision Age Author Comment
  bin e2b799b8 over 8 years Bob Lantz Fix/work around setuptools' evil PYTHONPATH mad...
  custom ce15c4f6 almost 9 years Bob Lantz rename Topo() methods for consistency: add_node...
  debian cd580deb about 9 years Bob Lantz Removed redundant debian/mininet.manpages
  doc c04ef88e over 8 years Bob Lantz Add note regarding removing old OVS junk.
  examples ce15c4f6 almost 9 years Bob Lantz rename Topo() methods for consistency: add_node...
  mininet 21b2c2c4 over 8 years Bob Lantz VERSION -> 2.0.0rc1
  util 9c0ed88c almost 9 years Bob Lantz Create version check utility and add to code ch...
.gitattributes 17 Bytes 29884297 almost 9 years Bob Lantz show method names in git diff output
.gitignore 98 Bytes 4f33cad0 almost 9 years Bob Lantz Ignore more stuff, notably generated docs and m...
.pylint 8.74 KB 350fdbfe over 9 years Bob Lantz Allow modules ( to be 1500 lines. Maybe...
INSTALL 2.81 KB 21b2c2c4 over 8 years Bob Lantz VERSION -> 2.0.0rc1
LICENSE 1.66 KB 21b2c2c4 over 8 years Bob Lantz VERSION -> 2.0.0rc1
Makefile 1.43 KB 31015ef5 almost 9 years Bob Lantz Make doc a real subdirectory so we can put othe... 4.29 KB 21b2c2c4 over 8 years Bob Lantz VERSION -> 2.0.0rc1
mnexec.c 4.59 KB d85a58fe about 9 years Bob Lantz Autogenerate man page for mnexec. 1.19 KB e8238d18 almost 9 years Bob Lantz Use Mininet version number from Con...

Latest revisions

# Date Author Comment
21b2c2c4 11/04/2012 04:38 AM Bob Lantz

VERSION -> 2.0.0rc1

e2b799b8 11/04/2012 04:36 AM Bob Lantz

Fix/work around setuptools' evil PYTHONPATH madness.

4744aa2b 11/03/2012 11:53 PM Bob Lantz

Updated README to reflect Mininet 2.0.

c04ef88e 11/03/2012 11:10 PM Bob Lantz

Add note regarding removing old OVS junk.

4b1dc93b 10/30/2012 11:58 PM Bob Lantz

Avoid modifying keyword parameter dictionary in customized()

f58f83c0 10/30/2012 11:50 PM Bob Lantz

Allow controller to optionally be a list of constructors/classes

22b8e5e4 10/30/2012 11:45 PM Bob Lantz

Add custom name to customized functions.

Note: we could probably use functools.partial.

cec44763 10/29/2012 11:10 PM Angad Singh

Merge pull request - closes #36

31015ef5 10/29/2012 10:36 PM Bob Lantz

Make doc a real subdirectory so we can put other things there.

600dad24 10/05/2012 02:08 AM Bob Lantz

Added package installation "instructions"

View all revisions | View revisions


Mininet: Rapid Prototyping for Software Defined Networks
The best way to emulate almost any network on your laptop!

Mininet 2.0.0rc1

** Welcome to Mininet! **

Mininet creates virtual SDN/OpenFlow test networks by using process-based virtualization and network namespaces.

Simulated hosts (as well as switches and controllers with the user datapath) are created as processes in separate network namespaces. This allows a complete OpenFlow network to be simulated on top of a single Linux kernel.

Mininet's support for OpenFlow and Linux allows you to create a custom network with customized routing, and to run almost any existing Linux networking application on top of it without modification. OpenFlow-based designs that work in Mininet can usually be transferred to hardware with minimal change for full line-rate execution.

Mininet may be invoked directly from the command line, and also provides a handy Python API for creating networks of varying sizes and topologies.

** Mininet 2.0.0rc1 **

Mininet 2.0.0rc1 is a major upgrade to the Mininet system and provides a number of enhancements and new features, including:

  • First-class Interface (Intf) and Link (Link) classes

  • An upgraded Topology (Topo) class which supports node and link customization

  • Link bandwidth limits using tc (TCIntf and TCLink classes)

  • CPU isolation and bandwidth limits (CPULimitedHost class)

  • Support for the Open vSwitch 1.4+ (including Ubuntu OVS packages)

  • Man pages for the mn and mnexec utilities.

[Since the API (most notably the topology) has changed, existing code that runs in Mininet 1.0 will need to be changed to run with Mininet 2.0. This is the primary reason for the major version number change.]

Mininet also includes:

  • A simple node infrastructure (Host, Switch, Controller classes) for creating virtual OpenFlow networks

  • A simple network infrastructure (Mininet class) supporting parametrized topologies (Topo subclasses.) For example, a tree network may be created with the command

    # mn --topo tree,depth=2,fanout=3

  • Basic tests, including connectivity (ping) and bandwidth (iperf)

  • A command-line interface (CLI class) which provides useful diagnostic commands, as well as the ability to send a command to a node. For example,

    mininet> h11 ifconfig -a

    tells host h11 to run the command ifconfig -a

  • A 'cleanup' command to get rid of junk (interfaces, processes, files in /tmp, etc.) which might be left around by Mininet or Linux. Try this if things stop working!

    # mn -c

  • Examples (in the examples/ directory) to help you get started.

  • Full API documentation via Python help() docstrings, as well as the ability to generate PDF/HTML documentation with "make doc."

In order to run Mininet, you must have:

  • A Linux kernel compiled with network namespace support enabled (see INSTALL for additional information.)

  • An OpenFlow implementation (either the reference user or kernel space implementations, or Open vSwitch.) Appropriate kernel modules (e.g. tun and ofdatapath for the reference kernel implementation) must be loaded.

  • Python, bash, ping, iperf, etc.

  • Root privileges (required for network device access)

Installation instructions are available in INSTALL

*** Mininet Documentation ***

In addition to the API documentation (make doc) much useful information, including a Mininet walkthrough and an introduction to the Python API is available on the Mininet Web Site. There is also a wiki which you are encouraged to read and to contribute to, particularly the Frequently Asked Questions (FAQ.)

*** Mininet Support ***

Mininet is supported by the friendly Mininet community. We encourage you to join the Mininet mailing list, mininet-discuss at:

*** Contributing to Mininet ***

Mininet is an open-source project and is currently hosted at You are encouraged to download the code, examine it, modify it, and submit bug reports, bug fixes, feature requests, and enhancements!

Best wishes, and we look forward to seeing what you can do with Mininet to change the networking world!

Bob Lantz Brandon Heller Nikhil Handigol Vimal Jeyakumar

Mininet Project

Also available in: Atom