# Copyright (c) 2016 Cisco and/or its affiliates. # Licensed under the Apache License, Version 2.0 (the "License"); # you may not use this file except in compliance with the License. # You may obtain a copy of the License at: # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. # See the License for the specific language governing permissions and # limitations under the License. """IPv6 utilities library.""" import re from resources.libraries.python.ssh import SSH from resources.libraries.python.VatExecutor import VatTerminal from resources.libraries.python.topology import Topology class IPv6Util(object): """IPv6 utilities""" @staticmethod def ipv6_ping(src_node, dst_addr, count=3, data_size=56, timeout=1): """IPv6 ping. :param src_node: Node where ping run. :param dst_addr: Destination IPv6 address. :param count: Number of echo requests. (Optional) :param data_size: Number of the data bytes. (Optional) :param timeout: Time to wait for a response, in seconds. (Optional) :type src_node: dict :type dst_addr: str :type count: int :type data_size: int :type timeout: int :return: Number of lost packets. :rtype: int """ ssh = SSH() ssh.connect(src_node) cmd = "ping6 -c {c} -s {s} -W {W} {dst}".format(c=count, s=data_size, W=timeout, dst=dst_addr) (_, stdout, _) = ssh.exec_command(cmd) regex = re.compile(r'(\d+) packets transmitted, (\d+) received') match = regex.search(stdout) sent, received = match.groups() packet_lost = int(sent) - int(received) return packet_lost @staticmethod def ipv6_ping_port(nodes_ip, src_node, dst_node, port, cnt=3, size=56, timeout=1): """Send IPv6 ping to the node port. :param nodes_ip: Nodes IPv6 addresses. :param src_node: Node where ping run. :param dst_node: Destination node. :param port: Port on the destination node. :param cnt: Number of echo requests. (Optional) :param size: Number of the data bytes. (Optional) :param timeout: Time to wait for a response, in seconds. (Optional) :type nodes_ip: dict :type src_node: dict :type dst_node: dict :type port: str :type cnt: int :type size: int :type timeout: int :return: Number of lost packets. :rtype: int """ dst_ip = IPv6Util.get_node_port_ipv6_address(dst_node, port, nodes_ip) return IPv6Util.ipv6_ping(src_node, dst_ip, cnt, size, timeout) @staticmethod def get_node_port_ipv6_address(node, iface_key, nodes_addr): """Return IPv6 address of the node port. :param node: Node in the topology. :param iface_key: Interface key of the node. :param nodes_addr: Nodes IPv6 addresses. :type node: dict :type iface_key: str :type nodes_addr: dict :return: IPv6 address string. :rtype: str """ interface = Topology.get_interface_name(node, iface_key) for net in nodes_addr.values(): for port in net['ports'].values(): host = port.get('node') dev = port.get('if') if host == node['host'] and dev == interface: ip_addr = port.get('addr') if ip_addr is not None: return ip_addr else: raise Exception( 'Node {n} port {p} IPv6 address is not set'.format( n=node['host'], p=interface)) raise Exception('Node {n} port {p} IPv6 address not found.'.format( n=node['host'], p=interface)) @staticmethod def add_ip_neighbor(node, interface, ip_address, mac_address, vrf=None): """Add IP neighbor. :param node: VPP node to add ip neighbor. :param interface: Interface name or sw_if_index. :param ip_address: IP address. :param mac_address: MAC address. :param vrf: VRF table ID (Optional). :type node: dict :type interface: str or int :type ip_address: str :type mac_address: str :type vrf: int """ vrf = "vrf {}".format(vrf) if vrf else '' if isinstance(interface, basestring): sw_if_index = Topology.get_interface_sw_index(node, interface) else: sw_if_index = interface with VatTerminal(node) as vat: vat.vat_terminal_exec_cmd_from_template("add_ip_neighbor.vat", sw_if_index=sw_if_index, ip_address=ip_address, mac_address=mac_address, vrf=vrf)