2 # NEPI, a framework to manage network experiments
3 # Copyright (C) 2014 INRIA
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;
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.
14 # You should have received a copy of the GNU General Public License
15 # along with this program. If not, see <http://www.gnu.org/licenses/>.
18 from nepi.execution.attribute import Attribute, Flags, Types
19 from nepi.execution.trace import Trace, TraceAttr
20 from nepi.execution.resource import ResourceManager, clsinit_copy, \
22 from nepi.resources.ns3.ns3netdevice import NS3BaseNetDevice
25 class NS3TapBridge(NS3BaseNetDevice):
26 _rtype = "ns3::TapBridge"
29 def _register_attributes(cls):
31 attr_mtu = Attribute("Mtu",
32 "The MAC-level Maximum Transmission Unit",
37 flags = Flags.Reserved | Flags.Construct)
39 cls._register_attribute(attr_mtu)
41 attr_devicename = Attribute("DeviceName",
42 "The name of the tap device to create.",
47 flags = Flags.Reserved | Flags.Construct)
49 cls._register_attribute(attr_devicename)
51 attr_gateway = Attribute("Gateway",
52 "The IP address of the default gateway to assign to the host machine, when in ConfigureLocal mode.",
54 default = "255.255.255.255",
57 flags = Flags.Reserved | Flags.Construct)
59 cls._register_attribute(attr_gateway)
61 attr_ipaddress = Attribute("IpAddress",
62 "The IP address to assign to the tap device, when in ConfigureLocal mode. This address will override the discovered IP address of the simulated device.",
64 default = "255.255.255.255",
67 flags = Flags.Reserved | Flags.Construct)
69 cls._register_attribute(attr_ipaddress)
71 attr_macaddress = Attribute("MacAddress",
72 "The MAC address to assign to the tap device, when in ConfigureLocal mode. This address will override the discovered MAC address of the simulated device.",
74 default = "ff:ff:ff:ff:ff:ff",
77 flags = Flags.Reserved | Flags.Construct)
79 cls._register_attribute(attr_macaddress)
81 attr_netmask = Attribute("Netmask",
82 "The network mask to assign to the tap device, when in ConfigureLocal mode. This address will override the discovered MAC address of the simulated device.",
84 default = "255.255.255.255",
87 flags = Flags.Reserved | Flags.Construct)
89 cls._register_attribute(attr_netmask)
91 attr_start = Attribute("Start",
92 "The simulation time at which to spin up the tap device read thread.",
97 flags = Flags.Reserved | Flags.Construct)
99 cls._register_attribute(attr_start)
101 attr_stop = Attribute("Stop",
102 "The simulation time at which to tear down the tap device read thread.",
107 flags = Flags.Reserved | Flags.Construct)
109 cls._register_attribute(attr_stop)
114 def _register_traces(cls):
117 def __init__(self, ec, guid):
118 super(NS3TapBridge, self).__init__(ec, guid)
119 self._home = "ns3-tap-bridge-%s" % self.guid