Mininet Python API Reference Manual
Mininet Python API Reference Manual
Contents
1 1 3 3 5 5 7 7 7 9 9
Class Documentation 5.1 mininet.cli.CLI Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5.1.1 5.1.2 Detailed Description
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Member Function Documentation 5.1.2.1 5.1.2.2 5.1.2.3 5.1.2.4 5.1.2.5 5.1.2.6 5.1.2.7 5.1.2.8 5.1.2.9
do_intfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 do_iperf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
do_iperfudp
do_link . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
ii
CONTENTS
5.1.2.21 do_x . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.1.2.22 do_xterm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.1.2.23 emptyline . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.1.2.24 waitForNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.1.3 Member Data Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 5.1.3.1 5.2 helpStr . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
start . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
5.3
cong . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16 popen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
setCPUFrac . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
5.4
5.5
5.6
5.6.3
cong . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19 setMAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
setParam . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
5.7
CONTENTS
iii
5.7.1 5.7.2
Detailed Description
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
5.8
5.8.3
intfName . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22 makeIntfPair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
5.9
5.9.3
Member Function Documentation 5.9.3.1 5.9.3.2 5.9.3.3 5.9.3.4 5.9.3.5 5.9.3.6 5.9.3.7 5.9.3.8 5.9.3.9
congLinkStatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
5.9.3.14 pingAll . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 5.9.3.15 pingAllFull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 5.9.3.16 pingFull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 5.9.3.17 pingPair . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 5.9.3.18 pingPairFull . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
iv
CONTENTS
5.9.3.23 staticArp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 5.9.3.24 stopXterms . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 5.10 mininet.log.MininetLogger Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 5.10.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
5.12.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 5.12.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 5.12.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
5.12.3.4 cmdPrint . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.12.3.5 cong . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.12.3.6 connectionsTo . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.12.3.7 deleteIntfs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.12.3.8 fdToNode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.9 intf . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.10 intfIsUp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.11 IP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.12 MAC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.13 monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37 5.12.3.14 newPort . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 5.12.3.15 pexec . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 5.12.3.16 popen . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
CONTENTS
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
5.13.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 5.13.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 5.14 mininet.node.OVSController Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41 5.14.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
5.15.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 5.15.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43 5.15.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
5.16.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 5.16.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45 5.16.3 Member Function Documentation 5.16.3.1 stop . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
5.17.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 5.17.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46 5.17.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
vi
CONTENTS
5.18.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 5.18.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 5.19 mininet.topo.SingleSwitchTopo Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47 5.19.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
5.19.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 5.19.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 5.20 mininet.log.Singleton Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 5.20.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 50
5.22.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 5.22.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51 5.22.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 51
5.25.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 5.25.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 54 5.25.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
CONTENTS
vii
5.25.3.5 addSwitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 5.25.3.6 hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 5.25.3.7 isSwitch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 5.25.3.8 links . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 5.25.3.9 port . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 5.25.3.10 sorted . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 5.25.3.11 switches . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 5.26 mininet.topolib.TreeTopo Class Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 57 5.26.1 Detailed Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 58
5.27.2 Constructor & Destructor Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 5.27.2.1 __init__ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59 5.27.3 Member Function Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 59
Index
60
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Chapter 1
Namespace Index
1.1 Namespace List
Here is a list of all documented namespaces with brief descriptions: topo Network topology creation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Namespace Index
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Chapter 2
Hierarchical Index
2.1 Class Hierarchy
This inheritance list is sorted roughly, but not completely, alphabetically: object mininet.link.Intf . . . . . . . . . . . . . . . . mininet.link.TCIntf . . . . . . . . . . . . . mininet.link.Link . . . . . . . . . . . . . . . . mininet.link.TCLink . . . . . . . . . . . . mininet.log.MininetLogger . . . . . . . . . . . mininet.net.Mininet . . . . . . . . . . . . . . mininet.net.MininetWithControlNet . . . . mininet.node.Node . . . . . . . . . . . . . . mininet.node.Controller . . . . . . . . . . mininet.node.NOX . . . . . . . . . . . mininet.node.OVSController . . . . . . mininet.node.RemoteController . . . . mininet.node.Host . . . . . . . . . . . . . mininet.node.CPULimitedHost . . . . mininet.node.Switch . . . . . . . . . . . . mininet.node.OVSLegacyKernelSwitch mininet.node.OVSSwitch . . . . . . . mininet.node.UserSwitch . . . . . . . mininet.topo.Graph . . . . . . . . . . . . . . mininet.topo.Topo . . . . . . . . . . . . . . . mininet.topo.LinearTopo . . . . . . . . . . mininet.topo.SingleSwitchReversedTopo . mininet.topo.SingleSwitchTopo . . . . . . mininet.topolib.TreeTopo . . . . . . . . . . StreamHandler mininet.log.StreamHandlerNoNewline . . . . . type mininet.log.Singleton . . . . . . . . . . . . . Cmd mininet.cli.CLI . . . . . . . . . . . . . . . . . Logger mininet.log.MininetLogger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 51 21 52 30 23 31 32 13 41 41 45 17 15 50 42 44 58 17 53 20 46 47 57
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 49 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
Hierarchical Index
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Chapter 3
Class Index
3.1 Class List
Here are the classes, structs, unions and interfaces with brief descriptions: mininet.cli.CLI Simple command-line interface to talk to nodes . . . . . . . . . . . . . . . . mininet.node.Controller A Controller is a Node that is running (or has execed?) an OpenFlow controller mininet.node.CPULimitedHost CPU limited host . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.topo.Graph Utility class to track nodes and edges - replaces networkx.Graph . . . . . . . mininet.node.Host A host is simply a Node . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.link.Intf Basic interface object that can congure itself . . . . . . . . . . . . . . . . . mininet.topo.LinearTopo Linear topology of k switches, with n hosts per switch . . . . . . . . . . . . . mininet.link.Link A basic link is just a veth pair . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.net.Mininet Network emulation with hosts spawned in network namespaces . . . . . . . mininet.log.MininetLogger Mininet-specic logger Enable each mininet .py le to with one . . . . . . . . mininet.net.MininetWithControlNet Control network . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.node.Node A virtual network node is simply a shell in a network namespace . . . . . . . mininet.node.NOX Controller to run a NOX application . . . . . . . . . . . . . . . . . . . . . . mininet.node.OVSController Open vSwitch controller . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.node.OVSLegacyKernelSwitch Open VSwitch legacy kernel-space switch using ovs-openowd . . . . . . . . mininet.node.OVSSwitch Open vSwitch switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.node.RemoteController Controller running outside of Mininets control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
. . . . . . . . . . . 13 . . . . . . . . . . . . 15 . . . . . . . . . . . . 17 . . . . . . . . . . . . 17 . . . . . . . . . . . . 18 . . . . . . . . . . . . 20 . . . . . . . . . . . . 21 . . . . . . . . . . . . 23 . . . . . . . . . . . . 30 . . . . . . . . . . . . 31 . . . . . . . . . . . . 32 . . . . . . . . . . . . 41 . . . . . . . . . . . . 41 . . . . . . . . . . . . 42 . . . . . . . . . . . . 44 . . . . . . . . . . . . 45
Class Index
mininet.topo.SingleSwitchReversedTopo Single switch connected to k hosts, with reversed ports . . . . . . . . . . . . . . . . . . . . . . . mininet.topo.SingleSwitchTopo Single switch connected to k hosts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.log.Singleton Singleton pattern from Wikipedia See . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.log.StreamHandlerNoNewline StreamHandler that doesnt print newlines by default . . . . . . . . . . . . . . . . . . . . . . . . mininet.node.Switch A Switch is a Node that is running (or has execed?) an OpenFlow switch . . . . . . . . . . . . . . mininet.link.TCIntf Interface customized by tc (trafc control) utility Allows specication of bandwidth limits (various methods) as well as delay, loss and max queue length . . . . . . . . . . . . . . . . . . . . . . . . . . mininet.link.TCLink Link with symmetric TC interfaces congured via opts . . . . . . . . . . . . . . . . . . . . . . . . mininet.topo.Topo Data center network representation for structured multi-trees . . . . . . . . . . . . . . . . . . . . mininet.topolib.TreeTopo Topology for a tree network with a given depth and fanout . . . . . . . . . . . . . . . . . . . . . . mininet.node.UserSwitch User-space switch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
. 46 . 47 . 48 . 49 . 50
. 51 . 52 . 53 . 57 . 58
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Chapter 4
Namespace Documentation
4.1 topo Namespace Reference
4.1.1
Detailed Description
Network topology creation. Author Brandon Heller (brandonh@stanford.edu) This package includes code to represent network topologies. A Topo object can be a topology database for NOX, can represent a physical setup for testing, and can even be emulated with the Mininet package.
Namespace Documentation
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Chapter 5
Class Documentation
5.1 mininet.cli.CLI Class Reference
Cmd
mininet.cli.CLI
def do_help
Describe available CLI commands.
def do_nodes
List all nodes.
def do_net
List network connections.
def do_sh
Run an external shell command.
def do_py
Evaluate a Python expression.
def do_px
Execute a Python statement.
def do_pingall
Ping between all hosts.
def do_pingpair
Ping between rst two hosts, useful for testing.
10
Class Documentation
def do_pingallfull
Ping between rst two hosts, returns all ping results.
def do_pingpairfull
Ping between rst two hosts, returns all ping results.
def do_iperf
Simple iperf TCP test between two (optionally specied) hosts.
def do_iperfudp
Simple iperf TCP test between two (optionally specied) hosts.
def do_intfs
List interfaces.
def do_dump
Dump node info.
def do_link
Bring link(s) between two nodes up or down.
def do_xterm
Spawn xterm(s) for the given node(s).
def do_x
Create an X11 tunnel to the given node, optionally starting a client.
def do_gterm
Spawn gnome-terminal(s) for the given node(s).
def do_exit
Exit.
def do_quit
Exit.
def do_EOF
Exit.
def isatty
Is our standard input a tty?
def do_noecho
Run an interactive command with echoing turned off.
def do_source
Read commands from an input le.
def do_dpctl
Run dpctl (or ovs-ofctl) command on all switches.
def do_time
Measure time taken for any command in Mininet.
def default
Called on an input line when the command prex is not recognized.
def waitForNode
Wait for a node to nish, and print its output.
Public Attributes
mn nodelist nodemap locals stdin inPoller inputFile
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
11
5.1.1
Detailed Description
5.1.2
5.1.2.1
Called on an input line when the command prex is not recognized. Overridden to run shell commands when a node is the rst CLI argument. Past the rst CLI argument, node names are automatically replaced with corresponding IP addrs.
5.1.2.2
5.1.2.3
line )
5.1.2.4
5.1.2.5
5.1.2.6
line )
List interfaces.
5.1.2.7
5.1.2.8
12
Class Documentation
5.1.2.9
5.1.2.10
line )
5.1.2.11
line )
5.1.2.12
5.1.2.13
line )
5.1.2.14
line )
5.1.2.15
line )
5.1.2.16
line )
5.1.2.17
Execute a Python statement. Node names may be used, e.g.: px print h1.cmd(ls)
5.1.2.18
5.1.2.19
13
5.1.2.20
5.1.2.21
5.1.2.22
5.1.2.23
5.1.2.24
5.1.3
5.1.3.1
Initial value:
1 = ( 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18
You may also send a command to a node using:\n <node> command {args}\n For example:\n mininet> h1 ifconfig\n \n The interpreter automatically substitutes IP addresses\n for node names when a node is the first arg, so commands\n like\n mininet> h2 ping h3\n should work.\n \n Some character-oriented interactive commands require\n noecho:\n mininet> noecho h2 vi foo.py\n However, starting up an xterm/gterm is generally better:\n mininet> xterm h2\n\n )
The documentation for this class was generated from the following le: mininet/cli.py
5.2
A Controller is a Node that is running (or has execed?) an OpenFlow controller. Inheritance diagram for mininet.node.Controller:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
14
Class Documentation
def start
Start <controller> <args> on controller.
def stop
Stop controller.
def IP
Return IP address of the Controller.
def __repr__
More informative string representation.
Public Attributes
command cargs cdir ip port execed
5.2.2
5.2.2.1
15
5.2.2.2
Stop controller. The documentation for this class was generated from the following le: mininet/node.py
5.3
def cgroupGet
Return value of cgroup parameter.
def cgroupDel
Clean up our cgroup.
def popen
Return a Popen() object in nodes namespace.
def cleanup
Clean up Node, then clean up our cgroup.
def chrt
Set RT scheduling priority.
def rtInfo
Internal method: return parameters for RT bandwidth.
def cfsInfo
Internal method: return parameters for CFS bandwidth.
def setCPUFrac
Set overall CPU fraction for this host.
def setCPUs
Specify (real) cores that our cgroup can run on.
16
Class Documentation
Public Attributes
cgroup period_us sched rtprio
5.3.1
Detailed Description
5.3.2
5.3.2.1
Parameters cpu cores params desired overall system CPU fraction (real) core(s) this host can run on parameters for Node.cong()
5.3.2.2
Return a Popen() object in nodes namespace. Parameters args kwargs Popen() args, single list, or string Popen() keyword args
5.3.2.3
Set overall CPU fraction for this host. Parameters f sched CPU bandwidth limit (fraction) rt or cfs Note cfs requires CONFIG_CFS_BANDWIDTH
The documentation for this class was generated from the following le: mininet/node.py
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
17
5.4
Utility class to track nodes and edges - replaces networkx.Graph. Inheritance diagram for mininet.topo.Graph:
object mininet.topo.Graph
def add_edge
Add edge to graph.
def nodes
Return list of graph nodes.
def edges
Iterator: return graph edges.
def __getitem__
Return link dict for the given node.
Public Attributes
data
5.4.1
Detailed Description
Utility class to track nodes and edges - replaces networkx.Graph. The documentation for this class was generated from the following le: mininet/topo.py
5.5
18
Class Documentation
A host is simply a Node. The documentation for this class was generated from the following le: mininet/node.py
5.6
Basic interface object that can congure itself. Inheritance diagram for mininet.link.Intf:
def ifcong
Congure ourselves using ifcong.
def setIP
Set our IP address.
def setMAC
Set the MAC address for an interface.
def updateIP
Return updated IP address based on ifcong.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
19
def updateMAC
Return updated MAC address based on ifcong.
def IP
Return IP address.
def MAC
Return MAC address.
def isUp
Return whether interface is up.
def rename
Rename interface.
def setParam
Internal.
def cong
Congure Node according to (optional)
def delete
Delete interface.
Public Attributes
node name link prexLen params mac ip
5.6.1
Detailed Description
5.6.2
5.6.2.1
Parameters name node link interface name (e.g. h1-eth0) owning node (where this intf most likely lives) parent link if were part of a link other arguments are passed to cong()
5.6.3
5.6.3.1
Class Documentation
MAC address IP address arbitrary interface conguration Subclasses should override this method and call the parent classs cong(params)
5.6.3.2
Set the MAC address for an interface. Parameters macstr MAC address as string
5.6.3.3
Internal. Parameters method results method param congure a single parameter dict of results to update cong method name arg=value (ignore if value=None) value may also be list or dict
The documentation for this class was generated from the following le: mininet/link.py
5.7
Linear topology of k switches, with n hosts per switch. Inheritance diagram for mininet.topo.LinearTopo:
21
Public Attributes
k n
5.7.2
5.7.2.1 Init.
Parameters k n hconf lconf number of switches number of hosts per switch host conguration options link conguration options
The documentation for this class was generated from the following le: mininet/topo.py
5.8
def intfName
Construct a canonical interface name node-ethN for interface n.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
22
Class Documentation
def makeIntfPair
Create pair of interfaces.
def delete
Delete this link.
def __str__
Public Attributes
intf2
5.8.1
Detailed Description
A basic link is just a veth pair. Other types of links could be tunnels, link emulators, etc..
5.8.2
5.8.2.1
Create veth link to another node, making two new interfaces. Parameters node1 node2 port1 port2 intf cls2 intfName1 intfName2 params1 params2 rst node second node node1 port number (optional) node2 port number (optional) default interface class/constructor cls1, optional interface-specic constructors node1 interface name (optional) node2 interface name (optional) parameters for interface 1 parameters for interface 2
5.8.3
5.8.3.1
5.8.3.2
Create pair of interfaces. Parameters intf1 intf2 name of interface 1 name of interface 2 (override this class method [and possibly delete()] to change link type)
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
23
The documentation for this class was generated from the following le: mininet/link.py
5.9
Network emulation with hosts spawned in network namespaces. Inheritance diagram for mininet.net.Mininet:
def addHost
Add host.
def addSwitch
Add switch.
def addController
Add controller.
def getNodeByName
Return node(s) with given name(s)
def get
Convenience alias for getNodeByName.
def __getitem__
net [ name ]
def __iter__
return iterator over nodes
def addLink
"Add a link from node1 to node2
def congHosts
Congure a set of hosts.
def buildFromTopo
Build mininet from a topology object At the end of this function, everything should be connected and up.
def congureControlNetwork
Control net cong hook: override in subclass.
def build
Build mininet.
def startTerms
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
24
Class Documentation
def stopXterms
Kill each xterm.
def staticArp
Add all-pairs ARP entries to remove the need to handle broadcast.
def start
Start controller and switches.
def stop
Stop the controller(s), switches and hosts.
def run
Perform a complete start/test/stop cycle.
def monitor
Monitor a set of hosts (or all hosts by default), and return their output, a line at a time.
def ping
Ping between all specied hosts.
def pingFull
Ping between all specied hosts and return all data.
def pingAll
Ping between all hosts.
def pingPair
Ping between rst two hosts, useful for testing.
def pingAllFull
Ping between all hosts.
def pingPairFull
Ping between rst two hosts, useful for testing.
def iperf
Run iperf between two hosts.
def runCpuLimitTest
run CPU limit test with while true processes.
def congLinkStatus
Change status of src <-> dst links.
def interact
Start network and run our simple CLI.
def init
Initialize Mininet.
Public Attributes
topo switch host controller link intf ipBase prexLen nextIP
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
25
inNamespace xterms cleanup autoSetMacs autoStaticArp autoPinCpus numCores nextCore listenPort hosts switches controllers nameToNode terms built
5.9.1
Detailed Description
5.9.2
5.9.2.1
Create Mininet object. Parameters topo switch host controller link intf ipBase build xterms cleanup inNamespace autoSetMacs autoStaticArp autoPinCpus listenPort Topo (topology) object or None default Switch class default Host class/constructor default Controller class/constructor default Link class/constructor default Intf class/constructor base IP address for hosts, build now from topo? if build now, spawn xterms? if build now, cleanup before creating? spawn switches and controller in net namespaces? set MAC addrs automatically like IP addresses? set all-pairs static MAC addrs? pin hosts to (real) cores (requires CPULimitedHost)? base listening port to open; will be incremented for each additional switch in the net if inNamespace=False
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
26
Class Documentation
5.9.3
5.9.3.1
5.9.3.2
5.9.3.3
Add host. Parameters name cls params name of host to add custom host class/constructor (optional) parameters for host
5.9.3.4
def mininet.net.Mininet.addLink ( self, node1, node2, port1 = None, port2 = None, cls = None, params )
"Add a link from node1 to node2 Parameters node1 node2 port1 port2 source node dest node source port dest port
5.9.3.5
Add switch.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
5.9 mininet.net.Mininet Class Reference Parameters name cls name of switch to add custom switch class/constructor (optional)
27
5.9.3.6
Build mininet.
5.9.3.7
Build mininet from a topology object At the end of this function, everything should be connected and up.
5.9.3.8
5.9.3.9
Change status of src <-> dst links. Parameters src dst status node name node name string {up, down}
5.9.3.10
5.9.3.11
Run iperf between two hosts. Parameters hosts l4Type list of hosts; if None, uses opposite hosts string, one of [ TCP, UDP ]
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Class Documentation
5.9.3.12
Monitor a set of hosts (or all hosts by default), and return their output, a line at a time. Parameters hosts timeoutms (optional) set of hosts to monitor (optional) timeout value in ms
5.9.3.13
Ping between all specied hosts. Parameters hosts timeout list of hosts time to wait for a response, as string
5.9.3.14
5.9.3.15
5.9.3.16
5.9 mininet.net.Mininet Class Reference Parameters hosts timeout list of hosts time to wait for a response, as string
29
5.9.3.17
Ping between rst two hosts, useful for testing. Returns ploss packet loss percentage
5.9.3.18
Ping between rst two hosts, useful for testing. Returns ploss packet loss percentage
5.9.3.19
5.9.3.20
run CPU limit test with while true processes. Parameters cpu duration desired CPU fraction of each host test duration in seconds returns a single list of measured CPU fractions as oats.
5.9.3.21
5.9.3.22
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
30
Class Documentation
5.9.3.23
5.9.3.24
Kill each xterm. The documentation for this class was generated from the following le: mininet/net.py
5.10
Mininet-specic logger Enable each mininet .py le to with one. Inheritance diagram for mininet.log.MininetLogger:
Logger
object
mininet.log.MininetLogger
def output
Log msg % args with severity OUTPUT.
5.10.1
Detailed Description
Mininet-specic logger Enable each mininet .py le to with one. Parameters import
from mininet.log import [lg, info, error] ...get a default logger that doesnt require one newline per logging call. Inherit from object to ensure that we have at least one new-style base class, and can then use the __metaclass__ directive, to prevent this
error TypeError
Error when calling the metaclass bases a new-style class cant have only classic bases
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
31
If Python2.5/logging/__init__.py dened Filterer as a new-style class, via Filterer( object ): rather than Filterer, we wouldnt need this. Use singleton pattern to ensure only one logger is ever created.
5.10.2
5.10.2.1
Log msg % args with severity OUTPUT. To pass exception information, use the keyword argument exc_info with a true value, e.g. logger.warning("Houston, we have a %s", "cli output", exc_info=1)
5.10.2.2
Setup loglevel.
Convenience function to support lowercase names.
The documentation for this class was generated from the following le: mininet/log.py
5.11
def congureRoutedControlNetwork
Congure a routed control network on controller and switches.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
32
Class Documentation
Notes
1. If the controller and switches are in the same (e.g. root) namespace, they can just use the loopback connection. 2. If we can get unix domain sockets to work, we can use them instead of an explicit control network. 3. Instead of routing, we could bridge or use in-band control. 4. Even if we dispense with this in general, it could still be useful for people who wish to simulate a separate control network (since real networks may need one!) 5. Basically nobody ever used this code, so it has been moved into its own class. 6. Ultimately we may wish to extend this to allow us to create a control network which every nodes control interface is attached to.
5.11.2
5.11.2.1
5.11.2.2
16 )
Congure a routed control network on controller and switches. For use with the user datapath only right now. The documentation for this class was generated from the following le: mininet/net.py
5.12
A virtual network node is simply a shell in a network namespace. Inheritance diagram for mininet.node.Node:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
33
def startShell
Start a shell process for running commands.
def cleanup
Help python collect its garbage.
def read
Buffered read from node, non-blocking.
def readline
Buffered readline from node, non-blocking.
def write
Write data to node.
def terminate
Send kill signal to Node and clean up after it.
def stop
Stop node.
def waitReadable
Wait until nodes output is readable.
def sendCmd
Send a command, followed by a command to echo a sentinel, and return without waiting for the command to complete.
def sendInt
Interrupt running command.
def monitor
Monitor and return the output of a command.
def waitOutput
Wait for a command to complete.
def cmd
Send a command, wait for output, and return it.
def cmdPrint
Call cmd and printing its output.
def popen
Return a Popen() object in our namespace.
def pexec
Execute a command using popen.
def newPort
Return the next port number to allocate.
def addIntf
Add an interface.
def defaultIntf
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
34
Class Documentation
def intf
Return our interface object with given string name, default intf if name is falsy (None, empty string, etc).
def connectionsTo
Return [ intf1, intf2...
def deleteIntfs
Delete all of our interfaces.
def setARP
Add an ARP entry.
def setHostRoute
Add route to host.
def setDefaultRoute
Set the default route to go through intf.
def setMAC
Set the MAC address for an interface.
def setIP
Set the IP address for an interface.
def IP
Return IP address of a node or specic interface.
def MAC
Return MAC address of a node or specic interface.
def intfIsUp
Check if an interface is up.
def setParam
Internal.
def cong
Congure Node according to (optional)
def congDefault
Congure with default parameters.
def linkTo
(Deprecated) Link to another node replace with Link( node1, node2)
def intfList
List of our interfaces sorted by port number.
def intfNames
The names of our interfaces sorted by port number.
def __repr__
More informative string representation.
def __str__
Abbreviated string representation.
def checkSetup
Make sure our class and superclasses are set up.
def setup
Make sure our class dependencies are available.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
35
Public Attributes
name inNamespace params intfs ports nameToIntf waiting readbuf shell stdin stdout pid pollOut execed lastCmd lastPid
5.12.1
Detailed Description
A virtual network node is simply a shell in a network namespace. We communicate with it using pipes.
5.12.2
5.12.2.1
Parameters name inNamespace params name of node in network namespace? Node parameters (see cong() for details)
5.12.3
5.12.3.1
Add an interface.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
36 Parameters intf port interface port number (optional, typically OpenFlow port number)
Class Documentation
5.12.3.2
5.12.3.3
Send a command, wait for output, and return it. Parameters cmd string
5.12.3.4
5.12.3.5
params )
Congure Node according to (optional) Parameters parameters mac ip ifcong MAC address for default interface IP address for default interface arbitrary interface conguration Subclasses should override this method and call the parent classs cong(params)
5.12.3.6
Return [ intf1, intf2... ] for all intfs that connect self to node.
5.12.3.7
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
5.12 mininet.node.Node Class Reference Parameters checkName only delete interfaces that contain our name
37
5.12.3.8
Returns node
5.12.3.9
Return our interface object with given string name, default intf if name is falsy (None, empty string, etc). or the input intf arg. Having this fcn return its arg for Intf objects makes it easier to construct functions with exible input args for interfaces (those that accept both string names and Intf objects).
5.12.3.10
5.12.3.11
5.12.3.12
5.12.3.13
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
38
Class Documentation
5.12.3.14
5.12.3.15
5.12.3.16
Return a Popen() object in our namespace. Parameters args kwargs Popen() args, single list, or string Popen() keyword args
5.12.3.17
Buffered read from node, non-blocking. Parameters maxbytes maximum number of bytes to return
5.12.3.18
Buffered readline from node, non-blocking. Returns line (minus newline) or None
5.12.3.19
Send a command, followed by a command to echo a sentinel, and return without waiting for the command to complete. Parameters args printPid command and arguments, or string print commands PID?
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
39
5.12.3.20
5.12.3.21
Add an ARP entry. Parameters ip mac IP address as string MAC address as string
5.12.3.22
Set the default route to go through intf. Parameters intf Intf or {dev <intfname> via <gw-ip> ...}
5.12.3.23
Add route to host. Parameters ip intf IP address as dotted decimal string, interface name
5.12.3.24
Set the IP address for an interface. Parameters intf ip prexLen intf or intf name IP address as a string prex length, e.g. 8 for /8 or 16M addrs
5.12.3.25
Set the MAC address for an interface. Parameters intf mac intf or intf name MAC address as string
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
40
Class Documentation
congure a single parameter dict of results to update cong method name arg=value (ignore if value=None) value may also be list or dict
5.12.3.27
Stop node.
5.12.3.28
5.12.3.29
5.12.3.30
Wait until nodes output is readable. Parameters timeoutms timeout in ms or None to wait indenitely.
5.12.3.31
The documentation for this class was generated from the following le:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
41
mininet/node.py
5.13
5.13.2
5.13.2.1 Init.
Parameters name noxArgs name to give controller arguments (strings) to pass to NOX
The documentation for this class was generated from the following le: mininet/node.py
5.14
42
Class Documentation
Open vSwitch controller. The documentation for this class was generated from the following le: mininet/node.py
5.15
Open VSwitch legacy kernel-space switch using ovs-openowd. Inheritance diagram for mininet.node.OVSLegacyKernelSwitch:
def setup
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
43
def start
Start up kernel datapath.
def stop
Terminate kernel datapath.
Public Attributes
dp intf execed
Open VSwitch legacy kernel-space switch using ovs-openowd. Currently only works in the root namespace.
5.15.2
5.15.2.1 Init.
Parameters name dp defaultMAC name for switch netlink id (0, 1, 2, ...) default MAC as unsigned int; random value if None
5.15.3
5.15.3.1
5.15.3.2
5.15.3.3
Terminate kernel datapath. The documentation for this class was generated from the following le: mininet/node.py
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
44
Class Documentation
5.16
def setup
Make sure Open vSwitch is installed and working.
def dpctl
Run ovs-ofctl command.
def attach
Connect a data port.
def detach
Disconnect a data port.
def controllerUUIDs
Return ovsdb UUIDs for our controllers.
def connected
Are we connected to at least one of our controllers?
def start
Start up a new OVS OpenFlow switch using ovs-vsctl.
def stop
Terminate OVS switch.
Public Attributes
failMode datapath
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
45
5.16.2
5.16.2.1 Init.
Parameters name failMode datapath name for switch controller loss behavior (secure|open) userspace or kernel mode (kernel|user)
5.16.3
5.16.3.1
5.16.3.2
Unfortunately OVS and Mininet are ghting over tc queuing disciplines. As a quick hack/ workaround, we clear OVSs and reapply our own. The documentation for this class was generated from the following le: mininet/node.py
5.17
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
46
Class Documentation
def start
Overridden to do nothing.
def stop
Overridden to do nothing.
def checkListening
Warn if remote controller is not accessible.
5.17.2
5.17.2.1 Init.
Parameters name ip port name to give controller the IP address where the remote controller is listening the port where the remote controller is listening
5.17.3
5.17.3.1
Overridden to do nothing.
5.17.3.2
Overridden to do nothing. The documentation for this class was generated from the following le: mininet/node.py
5.18
Single switch connected to k hosts, with reversed ports. Inheritance diagram for mininet.topo.SingleSwitchReversedTopo:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
47
Public Attributes
k
Single switch connected to k hosts, with reversed ports. The lowest-numbered host is connected to the highest-numbered port. Useful to verify that Mininet properly handles custom port numberings.
5.18.2
5.18.2.1 Init.
The documentation for this class was generated from the following le: mininet/topo.py
5.19
48
Class Documentation
Public Attributes
k
5.19.2
5.19.2.1 Init.
The documentation for this class was generated from the following le:
mininet/topo.py
5.20
49
type mininet.log.Singleton
5.20.1
Detailed Description
The documentation for this class was generated from the following le: mininet/log.py
5.21
StreamHandler that doesnt print newlines by default. Inheritance diagram for mininet.log.StreamHandlerNoNewline:
StreamHandler mininet.log.StreamHandlerNoNewline
5.21.1
Detailed Description
50
Class Documentation
Since StreamHandler automatically adds newlines, dene a mod to more easily support interactive mode when we want it, or errors-only logging for running unit tests.
5.21.2
5.21.2.1
Emit a record. If a formatter is specied, it is used to format the record. The record is then written to the stream with a trailing newline [ N.B. this may be removed depending on feedback ]. If exception information is present, it is formatted using traceback.printException and appended to the stream. The documentation for this class was generated from the following le: mininet/log.py
5.22
A Switch is a Node that is running (or has execed?) an OpenFlow switch. Inheritance diagram for mininet.node.Switch:
object mininet.node.Node mininet.node.Switch mininet.node.OVSLegacyKernelSwitch mininet.node.OVSSwitch mininet.node.UserSwitch
def defaultIntf
Return control interface.
def sendCmd
Send command to Node.
def connected
Is the switch connected to a controller? (override this method)
def __repr__
More informative string representation.
Public Attributes
dpid
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
51
5.22.1
Detailed Description
5.22.2
5.22.2.1
Parameters dpid opts listenPort dpid for switch (or None to derive from name, e.g. s1 -> 1) additional switch options port to listen on for dpctl connections
5.22.3
5.22.3.1
The documentation for this class was generated from the following le:
mininet/node.py
5.23
Interface customized by tc (trafc control) utility Allows specication of bandwidth limits (various methods) as well as delay, loss and max queue length. Inheritance diagram for mininet.link.TCIntf:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
52
Class Documentation
def tc
Execute tc command for our interface.
def cong
Congure the port and set its properties.
Interface customized by tc (trafc control) utility Allows specication of bandwidth limits (various methods) as well as delay, loss and max queue length.
5.23.2
5.23.2.1
Congure the port and set its properties. The documentation for this class was generated from the following le: mininet/link.py
5.24
Link with symmetric TC interfaces congured via opts. Inheritance diagram for mininet.link.TCLink:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
53
Link with symmetric TC interfaces congured via opts. The documentation for this class was generated from the following le: mininet/link.py
5.25
Data center network representation for structured multi-trees. Inheritance diagram for mininet.topo.Topo:
object mininet.topo.Topo mininet.topo.LinearTopo mininet.topo.SingleSwitchReversedTopo mininet.topo.SingleSwitchTopo mininet.topolib.TreeTopo
def addNode
Add Node to graph.
def addHost
Convenience.
def addSwitch
Convenience.
def addLink
node1,
def addPort
Generate port mapping for new edge.
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
54
Class Documentation
def nodes
Return nodes in graph.
def isSwitch
Returns true if node is a switch.
def switches
Return switches.
def hosts
Return hosts.
def links
Return links.
def port
Get port number.
def linkInfo
Return link metadata.
def setlinkInfo
Set link metadata.
def nodeInfo
Return metadata (dict) for node.
def setNodeInfo
Set metadata (dict) for node.
Public Attributes
g node_info link_info hopts sopts lopts ports
5.25.1
Detailed Description
5.25.2
5.25.2.1 Topo.
Parameters
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
55
5.25.3
5.25.3.1
Convenience. Parameters method name opts Add host to graph. host name host options
5.25.3.2 node1,
def mininet.topo.Topo.addLink ( self, node1, node2, port1 = None, port2 = None, opts )
Parameters node2 port2 opts nodes to link together port1, ports (optional) link options (optional)
5.25.3.3
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
56
Class Documentation
5.25.3.4
Generate port mapping for new edge. Parameters src dst source switch name destination switch name
5.25.3.5
Convenience. Parameters method name opts Add switch to graph. switch name switch options
5.25.3.6
Return hosts.
sort: sort hosts alphabetically
5.25.3.7
5.25.3.8
Return links.
sort: sort links alphabetically
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
57
5.25.3.9
Get port number. Parameters src dst source switch name destination switch name
Returns tuple (src_port, dst_port): src_port: port on source switch leading to the destination switch dst_port: port on destination switch leading to the source switch
5.25.3.10
5.25.3.11
Return switches.
sort: sort switches alphabetically
Returns dpids list of dpids The documentation for this class was generated from the following le: mininet/topo.py
5.26
Topology for a tree network with a given depth and fanout. Inheritance diagram for mininet.topolib.TreeTopo:
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
58
Class Documentation
Public Attributes
hostNum switchNum
5.26.2
5.26.2.1
Add a subtree starting with node n. Returns last node added The documentation for this class was generated from the following le: mininet/topolib.py
5.27
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
59
def setup
Ensure any dependencies are loaded; if not, try to load them.
def dpctl
Run dpctl command.
def connected
Is the switch connected to a controller?
def start
Start OpenFlow reference user datapath.
def stop
Stop OpenFlow reference user datapath.
Public Attributes
dpopts
5.27.1
Detailed Description
User-space switch.
5.27.2
5.27.2.1 Init.
Parameters name dpopts name for the switch additional arguments to ofdatapath (no-slicing)
5.27.3
5.27.3.1
5.27.3.2
60
Class Documentation
Log to /tmp/sN-{ofd,ofp}.log.
5.27.3.3
Stop OpenFlow reference user datapath. The documentation for this class was generated from the following le: mininet/node.py
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
Index
__getitem__ mininet::net::Mininet, 26 __init__ mininet::link::Intf, 19 mininet::link::Link, 22 mininet::net::Mininet, 25 mininet::node::Node, 35 mininet::node::NOX, 41 mininet::node::OVSLegacyKernelSwitch, 43 mininet::node::OVSSwitch, 45 mininet::node::RemoteController, 46 mininet::node::Switch, 51 mininet::node::UserSwitch, 59 mininet::topo::LinearTopo, 21 mininet::topo::SingleSwitchReversedTopo, 47 mininet::topo::SingleSwitchTopo, 48 mininet::topo::Topo, 54 addController mininet::net::Mininet, 26 addHost mininet::net::Mininet, 26 mininet::topo::Topo, 55 addIntf mininet::node::Node, 35 addLink mininet::net::Mininet, 26 mininet::topo::Topo, 55 addNode mininet::topo::Topo, 55 addPort mininet::topo::Topo, 55 addSwitch mininet::net::Mininet, 26 mininet::topo::Topo, 56 addTree mininet::topolib::TreeTopo, 58 build mininet::net::Mininet, 27 buildFromTopo mininet::net::Mininet, 27 cleanup mininet::node::Node, 36 cmd mininet::node::Node, 36 cmdPrint mininet::node::Node, 36 cong mininet::link::Intf, 19 mininet::link::TCIntf, 52 mininet::node::CPULimitedHost, 16 mininet::node::Node, 36 congHosts mininet::net::Mininet, 27 congLinkStatus mininet::net::Mininet, 27 congureControlNetwork mininet::net::MininetWithControlNet, 32 congureRoutedControlNetwork mininet::net::MininetWithControlNet, 32 connectionsTo mininet::node::Node, 36 default mininet::cli::CLI, 11 deleteIntfs mininet::node::Node, 36 do_dpctl mininet::cli::CLI, 11 do_dump mininet::cli::CLI, 11 do_gterm mininet::cli::CLI, 11 do_help mininet::cli::CLI, 11 do_intfs mininet::cli::CLI, 11 do_iperf mininet::cli::CLI, 11 do_iperfudp mininet::cli::CLI, 11 do_link mininet::cli::CLI, 11 do_net mininet::cli::CLI, 12 do_nodes mininet::cli::CLI, 12 do_noecho mininet::cli::CLI, 12 do_pingall
62
INDEX
mininet::cli::CLI, 12 do_pingallfull mininet::cli::CLI, 12 do_pingpair mininet::cli::CLI, 12 do_pingpairfull mininet::cli::CLI, 12 do_px mininet::cli::CLI, 12 do_py mininet::cli::CLI, 12 do_source mininet::cli::CLI, 12 do_time mininet::cli::CLI, 12 do_x mininet::cli::CLI, 13 do_xterm mininet::cli::CLI, 13 emit mininet::log::StreamHandlerNoNewline, 50 emptyline mininet::cli::CLI, 13 fdToNode mininet::node::Node, 37 helpStr mininet::cli::CLI, 13 hosts mininet::topo::Topo, 56 IP mininet::node::Node, 37 interact mininet::net::Mininet, 27 intf mininet::node::Node, 37 intfIsUp mininet::node::Node, 37 intfName mininet::link::Link, 22 iperf mininet::net::Mininet, 27 isSwitch mininet::topo::Topo, 56 links mininet::topo::Topo, 56 MAC mininet::node::Node, 37 makeIntfPair mininet::link::Link, 22
mininet.cli.CLI, 9 mininet.link.Intf, 18 mininet.link.Link, 21 mininet.link.TCIntf, 51 mininet.link.TCLink, 52 mininet.log.MininetLogger, 30 mininet.log.Singleton, 48 mininet.log.StreamHandlerNoNewline, 49 mininet.net.Mininet, 23 mininet.net.MininetWithControlNet, 31 mininet.node.CPULimitedHost, 15 mininet.node.Controller, 13 mininet.node.Host, 17 mininet.node.NOX, 41 mininet.node.Node, 32 mininet.node.OVSController, 41 mininet.node.OVSLegacyKernelSwitch, 42 mininet.node.OVSSwitch, 44 mininet.node.RemoteController, 45 mininet.node.Switch, 50 mininet.node.UserSwitch, 58 mininet.topo.Graph, 17 mininet.topo.LinearTopo, 20 mininet.topo.SingleSwitchReversedTopo, 46 mininet.topo.SingleSwitchTopo, 47 mininet.topo.Topo, 53 mininet.topolib.TreeTopo, 57 mininet::cli::CLI default, 11 do_dpctl, 11 do_dump, 11 do_gterm, 11 do_help, 11 do_intfs, 11 do_iperf, 11 do_iperfudp, 11 do_link, 11 do_net, 12 do_nodes, 12 do_noecho, 12 do_pingall, 12 do_pingallfull, 12 do_pingpair, 12 do_pingpairfull, 12 do_px, 12 do_py, 12 do_source, 12 do_time, 12 do_x, 13 do_xterm, 13 emptyline, 13 helpStr, 13 waitForNode, 13 mininet::link::Intf
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
INDEX
63
__init__, 19 cong, 19 setMAC, 20 setParam, 20 mininet::link::Link __init__, 22 intfName, 22 makeIntfPair, 22 mininet::link::TCIntf cong, 52 mininet::log::MininetLogger output, 31 setLogLevel, 31 mininet::log::StreamHandlerNoNewline emit, 50 mininet::net::Mininet __getitem__, 26 __init__, 25 addController, 26 addHost, 26 addLink, 26 addSwitch, 26 build, 27 buildFromTopo, 27 congHosts, 27 congLinkStatus, 27 interact, 27 iperf, 27 monitor, 28 ping, 28 pingAll, 28 pingAllFull, 28 pingFull, 28 pingPair, 29 pingPairFull, 29 run, 29 runCpuLimitTest, 29 start, 29 startTerms, 29 staticArp, 29 stopXterms, 30 mininet::net::MininetWithControlNet congureControlNetwork, 32 congureRoutedControlNetwork, 32 mininet::node::CPULimitedHost cong, 16 popen, 16 setCPUFrac, 16 mininet::node::Controller start, 14 stop, 14 mininet::node::NOX __init__, 41 mininet::node::Node
__init__, 35 addIntf, 35 cleanup, 36 cmd, 36 cmdPrint, 36 cong, 36 connectionsTo, 36 deleteIntfs, 36 fdToNode, 37 IP, 37 intf, 37 intfIsUp, 37 MAC, 37 monitor, 37 newPort, 37 pexec, 38 popen, 38 read, 38 readline, 38 sendCmd, 38 sendInt, 38 setARP, 39 setDefaultRoute, 39 setHostRoute, 39 setIP, 39 setMAC, 39 setParam, 39 stop, 40 terminate, 40 waitOutput, 40 waitReadable, 40 write, 40 mininet::node::OVSLegacyKernelSwitch __init__, 43 setup, 43 start, 43 stop, 43 mininet::node::OVSSwitch __init__, 45 stop, 45 TCReapply, 45 mininet::node::RemoteController __init__, 46 start, 46 stop, 46 mininet::node::Switch __init__, 51 sendCmd, 51 mininet::node::UserSwitch __init__, 59 setup, 59 start, 59 stop, 60 mininet::topo::LinearTopo
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
64
INDEX
__init__, 21 mininet::topo::SingleSwitchReversedTopo __init__, 47 mininet::topo::SingleSwitchTopo __init__, 48 mininet::topo::Topo __init__, 54 addHost, 55 addLink, 55 addNode, 55 addPort, 55 addSwitch, 56 hosts, 56 isSwitch, 56 links, 56 port, 56 sorted, 57 switches, 57 mininet::topolib::TreeTopo addTree, 58 monitor mininet::net::Mininet, 28 mininet::node::Node, 37 newPort mininet::node::Node, 37 output mininet::log::MininetLogger, 31 pexec mininet::node::Node, 38 ping mininet::net::Mininet, 28 pingAll mininet::net::Mininet, 28 pingAllFull mininet::net::Mininet, 28 pingFull mininet::net::Mininet, 28 pingPair mininet::net::Mininet, 29 pingPairFull mininet::net::Mininet, 29 popen mininet::node::CPULimitedHost, 16 mininet::node::Node, 38 port mininet::topo::Topo, 56 read mininet::node::Node, 38 readline mininet::node::Node, 38 run
mininet::net::Mininet, 29 runCpuLimitTest mininet::net::Mininet, 29 sendCmd mininet::node::Node, 38 mininet::node::Switch, 51 sendInt mininet::node::Node, 38 setARP mininet::node::Node, 39 setCPUFrac mininet::node::CPULimitedHost, 16 setDefaultRoute mininet::node::Node, 39 setHostRoute mininet::node::Node, 39 setIP mininet::node::Node, 39 setLogLevel mininet::log::MininetLogger, 31 setMAC mininet::link::Intf, 20 mininet::node::Node, 39 setParam mininet::link::Intf, 20 mininet::node::Node, 39 setup mininet::node::OVSLegacyKernelSwitch, 43 mininet::node::UserSwitch, 59 sorted mininet::topo::Topo, 57 start mininet::net::Mininet, 29 mininet::node::Controller, 14 mininet::node::OVSLegacyKernelSwitch, 43 mininet::node::RemoteController, 46 mininet::node::UserSwitch, 59 startTerms mininet::net::Mininet, 29 staticArp mininet::net::Mininet, 29 stop mininet::node::Controller, 14 mininet::node::Node, 40 mininet::node::OVSLegacyKernelSwitch, 43 mininet::node::OVSSwitch, 45 mininet::node::RemoteController, 46 mininet::node::UserSwitch, 60 stopXterms mininet::net::Mininet, 30 switches mininet::topo::Topo, 57 TCReapply
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen
INDEX
65
mininet::node::OVSSwitch, 45 terminate mininet::node::Node, 40 topo, 7 waitForNode mininet::cli::CLI, 13 waitOutput mininet::node::Node, 40 waitReadable mininet::node::Node, 40 write mininet::node::Node, 40
Generated on Tue Jul 30 2013 16:44:09 for Mininet Python API Reference Manual by Doxygen