From 8be64446049878a0fb4a91a3a8b0481e75b20205 Mon Sep 17 00:00:00 2001 From: Zdeno Olsovsky Date: Wed, 1 Jun 2016 13:41:09 +0200 Subject: [PATCH] Router Advertisement Tests -JIRA: CSIT-30 Change-Id: Iedb403d555284d36a81cc490a79e56b019ebeed0 Signed-off-by: Zdeno Olsovsky --- resources/libraries/python/IPv6Setup.py | 18 ++++++ resources/libraries/robot/traffic.robot | 23 ++++++++ resources/traffic_scripts/check_ra_packet.py | 87 ++++++++++++++++++++++++++++ tests/suites/ipv6/ipv6_ra.robot | 53 +++++++++++++++++ 4 files changed, 181 insertions(+) create mode 100755 resources/traffic_scripts/check_ra_packet.py create mode 100644 tests/suites/ipv6/ipv6_ra.robot diff --git a/resources/libraries/python/IPv6Setup.py b/resources/libraries/python/IPv6Setup.py index 6b5d8a5f66..12f6de7af9 100644 --- a/resources/libraries/python/IPv6Setup.py +++ b/resources/libraries/python/IPv6Setup.py @@ -246,6 +246,24 @@ class IPv6Setup(object): sw_if_id=sw_if_index, param='surpress') + @staticmethod + def vpp_ra_send_after_interval(node, interface, interval=2): + """Setup vpp router advertisement(RA) in such way it sends RA packet + after and every interval value. + + :param node: VPP node. + :param interface: Interface name. + :param interval: Interval for RA resend + :type node: dict + :type interface: str + :type interval: int + """ + sw_if_index = Topology.get_interface_sw_index(node, interface) + VatExecutor.cmd_from_template(node, + 'sw_interface_ip6nd_ra_config.vat', + sw_if_id=sw_if_index, + param='interval {0}'.format(interval)) + def vpp_all_ra_suppress_link_layer(self, nodes): """Suppress ICMPv6 router advertisement message for link scope address on all VPP nodes in the topology. diff --git a/resources/libraries/robot/traffic.robot b/resources/libraries/robot/traffic.robot index 7dba5efbe3..eb7dd7c6e1 100644 --- a/resources/libraries/robot/traffic.robot +++ b/resources/libraries/robot/traffic.robot @@ -239,3 +239,26 @@ | | Run Keyword And Expect Error | TCP/UDP Rx timeout | | ... | Run Traffic Script On Node | send_tcp_udp.py | | ... | ${tg_node} | ${args} + +| Receive And Check Router Advertisement Packet +| | [Documentation] | Wait until RA packet is received and then check +| | ... | specific packet fields whether they are correct. +| | ... +| | ... | *Arguments:* +| | ... +| | ... | - node - Node where to check for RA packet. Type: dictionary +| | ... | - rx_port - Interface where the packet is received. Type: string +| | ... | - src_mac - MAC address of source interface from which the link-local +| | ... | IPv6 address is constructed and checked. Type: string +| | ... +| | ... | *Return:* +| | ... | - No value returned +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Receive And Check Router Advertisement Packet \ +| | ... | \| ${nodes['DUT1']} \| eth2 \| 08:00:27:cc:4f:54 \| +| | ... +| | [Arguments] | ${node} | ${rx_port} | ${src_mac} +| | ${args}= | Catenate | --rx_if | ${rx_port} | --src_mac | ${src_mac} +| | Run Traffic Script On Node | check_ra_packet.py | ${node} | ${args} diff --git a/resources/traffic_scripts/check_ra_packet.py b/resources/traffic_scripts/check_ra_packet.py new file mode 100755 index 0000000000..d95ef2d2f5 --- /dev/null +++ b/resources/traffic_scripts/check_ra_packet.py @@ -0,0 +1,87 @@ +#!/usr/bin/env python +# 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. + +"""Router advertisement check script.""" + +import sys +import ipaddress + +from resources.libraries.python.PacketVerifier import RxQueue +from resources.libraries.python.TrafficScriptArg import TrafficScriptArg + + +def mac_to_ipv6_linklocal(mac): + """Transfer MAC address into specific link-local IPv6 address. + + :param mac: MAC address to be transferred. + :type mac: str + :return: IPv6 link-local address. + :rtype: str + """ + # Remove the most common delimiters: dots, dashes, etc. + mac_value = int(mac.translate(None, ' .:-'), 16) + + # Split out the bytes that slot into the IPv6 address + # XOR the most significant byte with 0x02, inverting the + # Universal / Local bit + high2 = mac_value >> 32 & 0xffff ^ 0x0200 + high1 = mac_value >> 24 & 0xff + low1 = mac_value >> 16 & 0xff + low2 = mac_value & 0xffff + + return 'fe80::{:04x}:{:02x}ff:fe{:02x}:{:04x}'.format( + high2, high1, low1, low2) + + +def main(): + """Check packets on specific port and look for the Router Advertisement + part. + """ + + args = TrafficScriptArg(['src_mac']) + + rx_if = args.get_arg('rx_if') + src_mac = args.get_arg('src_mac') + rxq = RxQueue(rx_if) + + ether = rxq.recv(8) + + # Check whether received packet contains layer RA and check other values + if ether is None: + raise RuntimeError('ICMP echo Rx timeout') + + if not ether.haslayer('ICMPv6ND_RA'): + raise RuntimeError('Not an RA packet received {0}' + .format(ether.__repr__())) + + address = ipaddress.IPv6Address(unicode(ether['IPv6'].src)) + link_local = ipaddress.IPv6Address(unicode(mac_to_ipv6_linklocal(src_mac))) + + if address != link_local: + raise RuntimeError( + 'Source address ({0}) not matching link local address({1})'.format( + address, link_local)) + + if ether['IPv6'].hlim != 255: + raise RuntimeError('Hop limit not correct: {0}!=255'.format( + ether['IPv6'].hlim)) + + ra_code = ether['ICMPv6 Neighbor Discovery - Router Advertisement'].code + if ra_code != 0: + raise RuntimeError('ICMP code: {0} not correct. '.format(ra_code)) + + sys.exit(0) + +if __name__ == "__main__": + main() diff --git a/tests/suites/ipv6/ipv6_ra.robot b/tests/suites/ipv6/ipv6_ra.robot new file mode 100644 index 0000000000..9ce824d807 --- /dev/null +++ b/tests/suites/ipv6/ipv6_ra.robot @@ -0,0 +1,53 @@ +# 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. + +*** Settings *** +| Resource | resources/libraries/robot/default.robot +| Resource | resources/libraries/robot/counters.robot +| Resource | resources/libraries/robot/interfaces.robot +| Resource | resources/libraries/robot/testing_path.robot +| Resource | resources/libraries/robot/ipv6.robot +| Resource | resources/libraries/robot/l2_xconnect.robot +| Resource | resources/libraries/robot/traffic.robot +| Library | resources.libraries.python.Classify.Classify +| Library | resources.libraries.python.Trace + +| Force Tags | HW_ENV | VM_ENV | 3_NODE_SINGLE_LINK_TOPO +| Suite Setup | Run Keywords | Setup all TGs before traffic script +| ... | AND | Update All Interface Data On All Nodes | ${nodes} +| Test Setup | Setup all DUTs before test +| Test Teardown | Show packet trace on all DUTs | ${nodes} +| Documentation | *Router advertisement tests.* +| ... +| ... | Test suite uses 3-node topology TG - DUT1 - DUT2 - TG +| ... | with one link between nodes where Router advertisement functionality is +| ... | tested in following test cases. + + +*** Variables *** +| ${dut1_to_tg_ip}= | 3ffe:62::1 +| ${prefix_length}= | 64 + +*** Test Cases *** +| VPP transmits RA from IPv6 enabled interface +| | [Documentation] | Setup IPv6 interace and wait for router advertisement \ +| | ... | packet from this interface to be sent. Subsequently, \ +| | ... | check received packet for correct contents. +| | Given Path for 3-node testing is set +| | ... | ${nodes['TG']} | ${nodes['DUT1']} | ${nodes['DUT2']} | ${nodes['TG']} +| | And Interfaces in 3-node path are up +| | And Vpp Set If Ipv6 Addr | ${dut1_node} +| | ... | ${dut1_to_tg} | ${dut1_to_tg_ip} | ${prefix_length} +| | When Vpp RA Send After Interval | ${dut1_node} | ${dut1_to_tg} +| | Then Receive And Check Router Advertisement Packet +| | ... | ${tg_node} | ${tg_to_dut1} | ${dut1_to_tg_mac} -- 2.16.6