#
# NEPI, a framework to manage network experiments
# Copyright (C) 2014 INRIA
#
# This program is free software: you can redistribute it and/or modify
# it under the terms of the GNU General Public License version 2 as
# published by the Free Software Foundation;
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program. If not, see <http://www.gnu.org/licenses/>.
#
from nepi.execution.attribute import Attribute, Flags, Types
from nepi.execution.trace import Trace, TraceAttr
from nepi.execution.resource import ResourceManager, clsinit_copy, \
ResourceState
from nepi.resources.ns3.ns3netdevice import NS3BaseNetDevice
@clsinit_copy
[docs]class NS3EmuNetDevice(NS3BaseNetDevice):
_rtype = "ns3::EmuNetDevice"
@classmethod
def _register_attributes(cls):
attr_mtu = Attribute("Mtu",
"The MAC-level Maximum Transmission Unit",
type = Types.Integer,
default = "0",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_mtu)
attr_address = Attribute("Address",
"The ns-3 MAC address of this (virtual) device.",
type = Types.String,
default = "ff:ff:ff:ff:ff:ff",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_address)
attr_devicename = Attribute("DeviceName",
"The name of the underlying real device (e.g. eth1).",
type = Types.String,
default = "eth1",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_devicename)
attr_start = Attribute("Start",
"The simulation time at which to spin up the device thread.",
type = Types.String,
default = "+0.0ns",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_start)
attr_stop = Attribute("Stop",
"The simulation time at which to tear down the device thread.",
type = Types.String,
default = "+0.0ns",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_stop)
attr_rxqueuesize = Attribute("RxQueueSize",
"Maximum size of the read queue. This value limits number of packets that have been read from the network into a memory buffer but have not yet been processed by the simulator.",
type = Types.Integer,
default = "1000",
allowed = None,
range = None,
flags = Flags.Reserved | Flags.Construct)
cls._register_attribute(attr_rxqueuesize)
@classmethod
def _register_traces(cls):
mactx = Trace("MacTx", "Trace source indicating a packet has arrived for transmission by this device")
cls._register_trace(mactx)
mactxdrop = Trace("MacTxDrop", "Trace source indicating a packet has been dropped by the device before transmission")
cls._register_trace(mactxdrop)
macpromiscrx = Trace("MacPromiscRx", "A packet has been received by this device, has been passed up from the physical layer and is being forwarded up the local protocol stack. This is a promiscuous trace,")
cls._register_trace(macpromiscrx)
macrx = Trace("MacRx", "A packet has been received by this device, has been passed up from the physical layer and is being forwarded up the local protocol stack. This is a non-promiscuous trace,")
cls._register_trace(macrx)
sniffer = Trace("Sniffer", "Trace source simulating a non-promiscuous packet sniffer attached to the device")
cls._register_trace(sniffer)
promiscsniffer = Trace("PromiscSniffer", "Trace source simulating a promiscuous packet sniffer attached to the device")
cls._register_trace(promiscsniffer)
def __init__(self, ec, guid):
super(NS3EmuNetDevice, self).__init__(ec, guid)
self._home = "ns3-emu-net-device-%s" % self.guid