A Discrete-Event Network Simulator
API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Groups Pages
tap-csma-virtual-machine.py
1 # -*- Mode: Python; -*-
2 #
3 # Copyright 2010 University of Washington
4 #
5 # This program is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License version 2 as
7 # published by the Free Software Foundation;
8 #
9 # This program is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 # GNU General Public License for more details.
13 #
14 # You should have received a copy of the GNU General Public License
15 # along with this program; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 #
18 
19 import sys
20 
21 import ns.core
22 import ns.csma
23 import ns.internet
24 import ns.network
25 import ns.tap_bridge
26 
27 def main(argv):
28  #
29  # We are interacting with the outside, real, world. This means we have to
30  # interact in real-time and therefore we have to use the real-time simulator
31  # and take the time to calculate checksums.
32  #
33  ns.core.GlobalValue.Bind("SimulatorImplementationType", ns.core.StringValue("ns3::RealtimeSimulatorImpl"))
34  ns.core.GlobalValue.Bind("ChecksumEnabled", ns.core.BooleanValue("true"))
35 
36  #
37  # Create two ghost nodes. The first will represent the virtual machine host
38  # on the left side of the network; and the second will represent the VM on
39  # the right side.
40  #
41  nodes = ns.network.NodeContainer()
42  nodes.Create (2)
43 
44  #
45  # Use a CsmaHelper to get a CSMA channel created, and the needed net
46  # devices installed on both of the nodes. The data rate and delay for the
47  # channel can be set through the command-line parser.
48  #
49  csma = ns.csma.CsmaHelper()
50  devices = csma.Install(nodes)
51 
52  #
53  # Use the TapBridgeHelper to connect to the pre-configured tap devices for
54  # the left side. We go with "UseLocal" mode since the wifi devices do not
55  # support promiscuous mode (because of their natures0. This is a special
56  # case mode that allows us to extend a linux bridge into ns-3 IFF we will
57  # only see traffic from one other device on that bridge. That is the case
58  # for this configuration.
59  #
60  tapBridge = ns.tap_bridge.TapBridgeHelper()
61  tapBridge.SetAttribute ("Mode", ns.core.StringValue ("UseLocal"))
62  tapBridge.SetAttribute ("DeviceName", ns.core.StringValue ("tap-left"))
63  tapBridge.Install (nodes.Get (0), devices.Get (0))
64 
65  #
66  # Connect the right side tap to the right side wifi device on the right-side
67  # ghost node.
68  #
69  tapBridge.SetAttribute ("DeviceName", ns.core.StringValue ("tap-right"))
70  tapBridge.Install (nodes.Get (1), devices.Get (1))
71 
72  #
73  # Run the simulation for ten minutes to give the user time to play around
74  #
75  ns.core.Simulator.Stop (ns.core.Seconds (600))
76  ns.core.Simulator.Run(signal_check_frequency = -1)
77  ns.core.Simulator.Destroy()
78  return 0
79 
80 if __name__ == '__main__':
81  sys.exit(main(sys.argv))