def add_tap_interface(node, tap_name, mac=None):
"""Add tap interface with name and optionally with MAC.
:param node: Node to add tap on.
:param tap_name: Tap interface name for linux tap.
:param mac: Optional MAC address for VPP tap.
:type node: dict
:type tap_name: str
:type mac: str
:returns: Returns a interface index.
:rtype: int
"""
command = 'connect'
if mac is not None:
args = 'tapname {} mac {}'.format(tap_name, mac)
else:
args = 'tapname {}'.format(tap_name)
with VatTerminal(node) as vat:
resp = vat.vat_terminal_exec_cmd_from_template('tap.vat',
tap_command=command,
tap_arguments=args)
sw_if_idx = resp[0]['sw_if_index']
if_key = Topology.add_new_port(node, 'tap')
Topology.update_interface_sw_if_index(node, if_key, sw_if_idx)
ifc_name = Tap.vpp_get_tap_interface_name(node, sw_if_idx)
Topology.update_interface_name(node, if_key, ifc_name)
if mac is None:
mac = Tap.vpp_get_tap_interface_mac(node, sw_if_idx)
Topology.update_interface_mac_address(node, if_key, mac)
Topology.update_interface_tap_dev_name(node, if_key, tap_name)
return sw_if_idx
def modify_tap_interface(node, if_index, tap_name, mac=None):
"""Modify tap interface like linux interface name or VPP MAC.
:param node: Node to modify tap on.
:param if_index: Index of tap interface to be modified.
:param tap_name: Tap interface name for linux tap.
:param mac: Optional MAC address for VPP tap.
:type node: dict
:type if_index: int
:type tap_name: str
:type mac: str
:returns: Returns a interface index.
:rtype: int
"""
command = 'modify'
if mac is not None:
args = 'sw_if_index {} tapname {} mac {}'.format(
if_index, tap_name, mac)
else:
args = 'sw_if_index {} tapname {}'.format(if_index, tap_name)
with VatTerminal(node) as vat:
resp = vat.vat_terminal_exec_cmd_from_template('tap.vat',
tap_command=command,
tap_arguments=args)
if_key = Topology.get_interface_by_sw_index(node, if_index)
Topology.update_interface_tap_dev_name(node, if_key, tap_name)
if mac:
Topology.update_interface_mac_address(node, if_key, mac)
return resp[0]['sw_if_index']
def add_tap_interface(node, tap_name, mac=None, num_rx_queues=1):
"""Add tap interface with name and optionally with MAC.
:param node: Node to add tap on.
:param tap_name: Tap interface name for linux tap.
:param mac: Optional MAC address for VPP tap.
:param num_rx_queues: Number of RX queues.
:type node: dict
:type tap_name: str
:type mac: str
:type num_rx_queues: int
:returns: Returns a interface index.
:rtype: int
"""
cmd = u"tap_create_v2"
args = dict(id=Constants.BITWISE_NON_ZERO,
use_random_mac=bool(mac is None),
mac_address=L2Util.mac_to_bin(mac) if mac else None,
num_rx_queues=int(num_rx_queues),
host_mtu_set=False,
host_mac_addr_set=False,
host_ip4_prefix_set=False,
host_ip6_prefix_set=False,
host_ip4_gw_set=False,
host_ip6_gw_set=False,
host_namespace_set=False,
host_if_name_set=True,
host_if_name=tap_name,
host_bridge_set=False)
err_msg = f"Failed to create tap interface {tap_name} " \
f"on host {node[u'host']}"
with PapiSocketExecutor(node) as papi_exec:
sw_if_index = papi_exec.add(cmd, **args).get_sw_if_index(err_msg)
if_key = Topology.add_new_port(node, u"tap")
Topology.update_interface_sw_if_index(node, if_key, sw_if_index)
Topology.update_interface_name(node, if_key, tap_name)
if mac is None:
mac = Tap.vpp_get_tap_interface_mac(node, tap_name)
Topology.update_interface_mac_address(node, if_key, mac)
tap_dev_name = Tap.vpp_get_tap_dev_name(node, tap_name)
Topology.update_interface_tap_dev_name(node, if_key, tap_dev_name)
return sw_if_index
