Router Advertisement Tests

-JIRA: CSIT-30

Change-Id: Iedb403d555284d36a81cc490a79e56b019ebeed0
Signed-off-by: Zdeno Olsovsky <zolsovsk@cisco.com>
(cherry picked from commit 8be64446049878a0fb4a91a3a8b0481e75b20205)

4 files changed, 181 insertions, 0 deletions

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}