314 lines
8.6 KiB
Python
314 lines
8.6 KiB
Python
import netaddr
|
|
|
|
from core import utils
|
|
from core.emane.nodes import EmaneNet
|
|
from core.emulator.enumerations import LinkTypes
|
|
from core.nodes.physical import PhysicalNode
|
|
|
|
|
|
class IdGen:
|
|
def __init__(self, _id=0):
|
|
self.id = _id
|
|
|
|
def next(self):
|
|
self.id += 1
|
|
return self.id
|
|
|
|
|
|
def create_interface(node, network, interface_data):
|
|
"""
|
|
Create an interface for a node on a network using provided interface data.
|
|
|
|
:param node: node to create interface for
|
|
:param core.nodes.base.CoreNetworkBase network: network to associate interface with
|
|
:param core.emulator.emudata.InterfaceData interface_data: interface data
|
|
:return: created interface
|
|
"""
|
|
node.newnetif(
|
|
network,
|
|
addrlist=interface_data.get_addresses(),
|
|
hwaddr=interface_data.mac,
|
|
ifindex=interface_data.id,
|
|
ifname=interface_data.name,
|
|
)
|
|
return node.netif(interface_data.id)
|
|
|
|
|
|
def link_config(network, interface, link_options, devname=None, interface_two=None):
|
|
"""
|
|
Convenience method for configuring a link,
|
|
|
|
:param network: network to configure link for
|
|
:param interface: interface to configure
|
|
:param core.emulator.emudata.LinkOptions link_options: data to configure link with
|
|
:param str devname: device name, default is None
|
|
:param interface_two: other interface associated, default is None
|
|
:return: nothing
|
|
"""
|
|
config = {
|
|
"netif": interface,
|
|
"bw": link_options.bandwidth,
|
|
"delay": link_options.delay,
|
|
"loss": link_options.per,
|
|
"duplicate": link_options.dup,
|
|
"jitter": link_options.jitter,
|
|
"netif2": interface_two,
|
|
}
|
|
|
|
# hacky check here, because physical and emane nodes do not conform to the same
|
|
# linkconfig interface
|
|
if not isinstance(network, (EmaneNet, PhysicalNode)):
|
|
config["devname"] = devname
|
|
|
|
network.linkconfig(**config)
|
|
|
|
|
|
class NodeOptions:
|
|
"""
|
|
Options for creating and updating nodes within core.
|
|
"""
|
|
|
|
def __init__(self, name=None, model="PC", image=None):
|
|
"""
|
|
Create a NodeOptions object.
|
|
|
|
:param str name: name of node, defaults to node class name postfix with its id
|
|
:param str model: defines services for default and physical nodes, defaults to
|
|
"router"
|
|
:param str image: image to use for docker nodes
|
|
"""
|
|
self.name = name
|
|
self.model = model
|
|
self.canvas = None
|
|
self.icon = None
|
|
self.opaque = None
|
|
self.services = []
|
|
self.x = None
|
|
self.y = None
|
|
self.lat = None
|
|
self.lon = None
|
|
self.alt = None
|
|
self.emulation_id = None
|
|
self.server = None
|
|
self.image = image
|
|
self.emane = None
|
|
|
|
def set_position(self, x, y):
|
|
"""
|
|
Convenience method for setting position.
|
|
|
|
:param float x: x position
|
|
:param float y: y position
|
|
:return: nothing
|
|
"""
|
|
self.x = x
|
|
self.y = y
|
|
|
|
def set_location(self, lat, lon, alt):
|
|
"""
|
|
Convenience method for setting location.
|
|
|
|
:param float lat: latitude
|
|
:param float lon: longitude
|
|
:param float alt: altitude
|
|
:return: nothing
|
|
"""
|
|
self.lat = lat
|
|
self.lon = lon
|
|
self.alt = alt
|
|
|
|
|
|
class LinkOptions:
|
|
"""
|
|
Options for creating and updating links within core.
|
|
"""
|
|
|
|
def __init__(self, _type=LinkTypes.WIRED):
|
|
"""
|
|
Create a LinkOptions object.
|
|
|
|
:param core.emulator.enumerations.LinkTypes _type: type of link, defaults to
|
|
wired
|
|
"""
|
|
self.type = _type
|
|
self.session = None
|
|
self.delay = None
|
|
self.bandwidth = None
|
|
self.per = None
|
|
self.dup = None
|
|
self.jitter = None
|
|
self.mer = None
|
|
self.burst = None
|
|
self.mburst = None
|
|
self.gui_attributes = None
|
|
self.unidirectional = None
|
|
self.emulation_id = None
|
|
self.network_id = None
|
|
self.key = None
|
|
self.opaque = None
|
|
|
|
|
|
class IpPrefixes:
|
|
"""
|
|
Convenience class to help generate IP4 and IP6 addresses for nodes within CORE.
|
|
"""
|
|
|
|
def __init__(self, ip4_prefix=None, ip6_prefix=None):
|
|
"""
|
|
Creates an IpPrefixes object.
|
|
|
|
:param str ip4_prefix: ip4 prefix to use for generation
|
|
:param str ip6_prefix: ip6 prefix to use for generation
|
|
:raises ValueError: when both ip4 and ip6 prefixes have not been provided
|
|
"""
|
|
if not ip4_prefix and not ip6_prefix:
|
|
raise ValueError("ip4 or ip6 must be provided")
|
|
|
|
self.ip4 = None
|
|
if ip4_prefix:
|
|
self.ip4 = netaddr.IPNetwork(ip4_prefix)
|
|
self.ip6 = None
|
|
if ip6_prefix:
|
|
self.ip6 = netaddr.IPNetwork(ip6_prefix)
|
|
|
|
def ip4_address(self, node):
|
|
"""
|
|
Convenience method to return the IP4 address for a node.
|
|
|
|
:param node: node to get IP4 address for
|
|
:return: IP4 address or None
|
|
:rtype: str
|
|
"""
|
|
if not self.ip4:
|
|
raise ValueError("ip4 prefixes have not been set")
|
|
return str(self.ip4[node.id])
|
|
|
|
def ip6_address(self, node):
|
|
"""
|
|
Convenience method to return the IP6 address for a node.
|
|
|
|
:param node: node to get IP6 address for
|
|
:return: IP4 address or None
|
|
:rtype: str
|
|
"""
|
|
if not self.ip6:
|
|
raise ValueError("ip6 prefixes have not been set")
|
|
return str(self.ip6[node.id])
|
|
|
|
def create_interface(self, node, name=None, mac=None):
|
|
"""
|
|
Creates interface data for linking nodes, using the nodes unique id for
|
|
generation, along with a random mac address, unless provided.
|
|
|
|
:param core.nodes.base.CoreNode node: node to create interface for
|
|
:param str name: name to set for interface, default is eth{id}
|
|
:param str mac: mac address to use for this interface, default is random
|
|
generation
|
|
:return: new interface data for the provided node
|
|
:rtype: InterfaceData
|
|
"""
|
|
# interface id
|
|
inteface_id = node.newifindex()
|
|
|
|
# generate ip4 data
|
|
ip4 = None
|
|
ip4_mask = None
|
|
if self.ip4:
|
|
ip4 = self.ip4_address(node)
|
|
ip4_mask = self.ip4.prefixlen
|
|
|
|
# generate ip6 data
|
|
ip6 = None
|
|
ip6_mask = None
|
|
if self.ip6:
|
|
ip6 = self.ip6_address(node)
|
|
ip6_mask = self.ip6.prefixlen
|
|
|
|
# random mac
|
|
if not mac:
|
|
mac = utils.random_mac()
|
|
|
|
return InterfaceData(
|
|
_id=inteface_id,
|
|
name=name,
|
|
ip4=ip4,
|
|
ip4_mask=ip4_mask,
|
|
ip6=ip6,
|
|
ip6_mask=ip6_mask,
|
|
mac=mac,
|
|
)
|
|
|
|
|
|
class InterfaceData:
|
|
"""
|
|
Convenience class for storing interface data.
|
|
"""
|
|
|
|
def __init__(self, _id, name, mac, ip4, ip4_mask, ip6, ip6_mask):
|
|
"""
|
|
Creates an InterfaceData object.
|
|
|
|
:param int _id: interface id
|
|
:param str name: name for interface
|
|
:param str mac: mac address
|
|
:param str ip4: ipv4 address
|
|
:param int ip4_mask: ipv4 bit mask
|
|
:param str ip6: ipv6 address
|
|
:param int ip6_mask: ipv6 bit mask
|
|
"""
|
|
self.id = _id
|
|
self.name = name
|
|
self.mac = mac
|
|
self.ip4 = ip4
|
|
self.ip4_mask = ip4_mask
|
|
self.ip6 = ip6
|
|
self.ip6_mask = ip6_mask
|
|
|
|
def has_ip4(self):
|
|
"""
|
|
Determines if interface has an ip4 address.
|
|
|
|
:return: True if has ip4, False otherwise
|
|
"""
|
|
return all([self.ip4, self.ip4_mask])
|
|
|
|
def has_ip6(self):
|
|
"""
|
|
Determines if interface has an ip6 address.
|
|
|
|
:return: True if has ip6, False otherwise
|
|
"""
|
|
return all([self.ip6, self.ip6_mask])
|
|
|
|
def ip4_address(self):
|
|
"""
|
|
Retrieve a string representation of the ip4 address and netmask.
|
|
|
|
:return: ip4 string or None
|
|
"""
|
|
if self.has_ip4():
|
|
return f"{self.ip4}/{self.ip4_mask}"
|
|
else:
|
|
return None
|
|
|
|
def ip6_address(self):
|
|
"""
|
|
Retrieve a string representation of the ip6 address and netmask.
|
|
|
|
:return: ip4 string or None
|
|
"""
|
|
if self.has_ip6():
|
|
return f"{self.ip6}/{self.ip6_mask}"
|
|
else:
|
|
return None
|
|
|
|
def get_addresses(self):
|
|
"""
|
|
Returns a list of ip4 and ip6 address when present.
|
|
|
|
:return: list of addresses
|
|
:rtype: list
|
|
"""
|
|
ip4 = self.ip4_address()
|
|
ip6 = self.ip6_address()
|
|
return [i for i in [ip4, ip6] if i]
|