From: selias Date: Tue, 6 Sep 2016 07:43:56 +0000 (+0200) Subject: CSIT-241: IPv6 Router Advertisement X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=commitdiff_plain;h=6d104077b5a6a8a0595001ecf051f63c651c131e CSIT-241: IPv6 Router Advertisement - add traffic script to verify Router Solicitation response - add keyword to execute traffic script - add test case 02: retransmit RA message after set interval - add test case 03: respond to RS request Change-Id: I83d742713ae42d0a1baacf460c29c06d32669b9a Signed-off-by: selias --- diff --git a/resources/libraries/robot/traffic.robot b/resources/libraries/robot/traffic.robot index 383eccc0f8..2522444e35 100644 --- a/resources/libraries/robot/traffic.robot +++ b/resources/libraries/robot/traffic.robot @@ -251,15 +251,16 @@ | | ... | ${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. +| | [Documentation] | Wait until RA packet is received and then verify\ +| | ... | specific fields of received RA packet. | | ... | | ... | *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 +| | ... | - src_mac - MAC address of source interface from which the link-local\ | | ... | IPv6 address is constructed and checked. Type: string +| | ... | - interval - Configured retransmit interval. Optional. Type: integer | | ... | | ... | *Return:* | | ... | - No value returned @@ -269,11 +270,49 @@ | | ... | \| Receive And Check Router Advertisement Packet \ | | ... | \| ${nodes['DUT1']} \| eth2 \| 08:00:27:cc:4f:54 \| | | ... -| | [Arguments] | ${node} | ${rx_port} | ${src_mac} +| | [Arguments] | ${node} | ${rx_port} | ${src_mac} | ${interval}=${0} | | ${rx_port_name}= | Get interface name | ${node} | ${rx_port} -| | ${args}= | Catenate | --rx_if | ${rx_port_name} | --src_mac | ${src_mac} +| | ${args}= | Catenate +| | ... | --rx_if ${rx_port_name} +| | ... | --src_mac ${src_mac} +| | ... | --interval ${interval} | | Run Traffic Script On Node | check_ra_packet.py | ${node} | ${args} +| Send Router Solicitation and check response +| | [Documentation] | Send RS packet, wait for response and then verify\ +| | ... | specific fields of received RA packet. +| | ... +| | ... | *Arguments:* +| | ... +| | ... | - tg_node - TG node to send RS packet from. Type: dictionary +| | ... | - dut_node - DUT node to send RS packet to. Type: dictionary +| | ... | - rx_port - Interface where the packet is sent from. Type: string +| | ... | - tx_port - Interface where the packet is sent to. Type: string +| | ... | - src_ip - Source IP address of RS packet. Optional. If not provided,\ +| | ... | link local address will be used. Type: string +| | ... +| | ... | *Return:* +| | ... | - No value returned +| | ... +| | ... | *Example:* +| | ... +| | ... | \| Send Router Solicitation and check response \ +| | ... | \| ${nodes['TG']} \| ${nodes['DUT1']} \| eth2 \ +| | ... | \| GigabitEthernet0/8/0 \| 10::10 \| +| | ... +| | [Arguments] | ${tg_node} | ${dut_node} | ${tx_port} | ${rx_port} +| | ... | ${src_ip}='' +| | ${src_mac}= | Get Interface Mac | ${tg_node} | ${tx_port} +| | ${dst_mac}= | Get Interface Mac | ${dut_node} | ${rx_port} +| | ${src_int_name}= | Get interface name | ${tg_node} | ${tx_port} +| | ${dst_int_name}= | Get interface name | ${dut_node} | ${rx_port} +| | ${args}= | catenate +| | ... | --rx_if ${dst_int_name} --tx_if ${src_int_name} +| | ... | --src_mac ${src_mac} | --dst_mac ${dst_mac} +| | ... | --src_ip ${src_ip} +| | Run Traffic Script On Node | send_rs_check_ra.py +| | ... | ${tg_node} | ${args} + | Send ARP Request | | [Documentation] | Send ARP Request and check if the ARP Response is received. | | ... diff --git a/resources/traffic_scripts/check_ra_packet.py b/resources/traffic_scripts/check_ra_packet.py index d95ef2d2f5..231e07da11 100755 --- a/resources/traffic_scripts/check_ra_packet.py +++ b/resources/traffic_scripts/check_ra_packet.py @@ -49,13 +49,14 @@ def main(): part. """ - args = TrafficScriptArg(['src_mac']) + args = TrafficScriptArg(['src_mac', 'interval']) rx_if = args.get_arg('rx_if') src_mac = args.get_arg('src_mac') + interval = int(args.get_arg('interval')) rxq = RxQueue(rx_if) - ether = rxq.recv(8) + ether = rxq.recv(max(5, interval)) # Check whether received packet contains layer RA and check other values if ether is None: @@ -65,14 +66,19 @@ def main(): raise RuntimeError('Not an RA packet received {0}' .format(ether.__repr__())) - address = ipaddress.IPv6Address(unicode(ether['IPv6'].src)) + src_address = ipaddress.IPv6Address(unicode(ether['IPv6'].src)) + dst_address = ipaddress.IPv6Address(unicode(ether['IPv6'].dst)) link_local = ipaddress.IPv6Address(unicode(mac_to_ipv6_linklocal(src_mac))) + all_nodes_multicast = ipaddress.IPv6Address(u'ff02::1') - if address != link_local: + if src_address != link_local: raise RuntimeError( 'Source address ({0}) not matching link local address({1})'.format( - address, link_local)) - + src_address, link_local)) + if dst_address != all_nodes_multicast: + raise RuntimeError('Packet destination address ({0}) is not the all ' + 'nodes multicast address ({1}).'.format( + dst_address, all_nodes_multicast)) if ether['IPv6'].hlim != 255: raise RuntimeError('Hop limit not correct: {0}!=255'.format( ether['IPv6'].hlim)) diff --git a/resources/traffic_scripts/send_rs_check_ra.py b/resources/traffic_scripts/send_rs_check_ra.py new file mode 100755 index 0000000000..9ba1f55b52 --- /dev/null +++ b/resources/traffic_scripts/send_rs_check_ra.py @@ -0,0 +1,121 @@ +#!/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 solicitation check script.""" + +import sys +import ipaddress + +from scapy.layers.l2 import Ether +from scapy.layers.inet6 import IPv6, ICMPv6ND_RS + +from resources.libraries.python.PacketVerifier import RxQueue, TxQueue +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(): + """Send Router Solicitation packet, check if the received response\ + is a Router Advertisement packet and verify.""" + + args = TrafficScriptArg( + ['src_mac', 'dst_mac', 'src_ip'] + ) + + router_mac = args.get_arg('dst_mac') + src_mac = args.get_arg('src_mac') + src_ip = args.get_arg('src_ip') + if not src_ip: + src_ip = mac_to_ipv6_linklocal(src_mac) + tx_if = args.get_arg('tx_if') + + txq = TxQueue(tx_if) + rxq = RxQueue(tx_if) + + pkt_raw = (Ether(src=src_mac, dst='33:33:00:00:00:02') / + IPv6(src=src_ip, dst='ff02::2') / + ICMPv6ND_RS()) + + sent_packets = [pkt_raw] + txq.send(pkt_raw) + + ether = rxq.recv(8, ignore=sent_packets) + + # Check whether received packet contains layer RA and check other values + if ether is None: + raise RuntimeError('ICMP echo Rx timeout') + + if ether.src != router_mac: + raise RuntimeError( + 'Packet source MAC ({0}) does not match ' + 'router MAC ({1}).'.format(ether.src, router_mac)) + if ether.dst != src_mac: + raise RuntimeError( + 'Packet destination MAC ({0}) does not match ' + 'RS source MAC ({1}).'.format(ether.dst, src_mac)) + + if not ether.haslayer('ICMPv6ND_RA'): + raise RuntimeError('Not an RA packet received {0}' + .format(ether.__repr__())) + + src_address = ipaddress.IPv6Address(unicode(ether['IPv6'].src)) + dst_address = ipaddress.IPv6Address(unicode(ether['IPv6'].dst)) + router_link_local = ipaddress.IPv6Address(unicode( + mac_to_ipv6_linklocal(router_mac))) + rs_src_address = ipaddress.IPv6Address(unicode(src_ip)) + + if src_address != router_link_local: + raise RuntimeError( + 'Packet source address ({0}) does not match ' + 'link local address({1})'.format(src_address, router_link_local)) + + if dst_address != rs_src_address: + raise RuntimeError( + 'Packet destination address ({0}) does not match ' + 'RS source address ({1}).'.format(dst_address, rs_src_address)) + + 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/func/ipv6/ipv6_ra.robot b/tests/func/ipv6/ipv6_ra.robot index b544e3f44b..91a1b517d8 100644 --- a/tests/func/ipv6/ipv6_ra.robot +++ b/tests/func/ipv6/ipv6_ra.robot @@ -17,18 +17,16 @@ | 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 +| 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 Setup | Setup All DUTs Before Test | Test Teardown | Run Keywords -| ... | Show packet trace on all DUTs | ${nodes} | AND -| ... | Show vpp trace dump on all DUTs +| ... | Show Packet Trace On All DUTs | ${nodes} | AND +| ... | Show VPP Trace Dump On All DUTs | Documentation | *IPv6 Router Advertisement test cases* | ... | ... | RFC4861 Neighbor Discovery. Encapsulations: Eth-IPv6-RA on links @@ -39,20 +37,76 @@ *** Variables *** | ${dut1_to_tg_ip}= | 3ffe:62::1 +| ${tg_to_dut1_ip}= | 3ffe:62::2 | ${prefix_length}= | 64 +| ${interval}= | 2 *** Test Cases *** | TC01: DUT transmits RA on IPv6 enabled interface | | [Documentation] -| | ... | On DUT1 configure IPv6 interface on the link to TG. Make TG wait\ -| | ... | for IPv6 Router Advertisement packet to be sent out by DUT1 and -| | ... | verify the received RA packet is correct. +| | ... | [Top] TG-DUT1-DUT2-TG. +| | ... | [Cfg] On DUT1 configure IPv6 interface on the link to TG. +| | ... | [Ver] Make TG wait for IPv6 Router Advertisement packet to be sent\ +| | ... | by DUT1 and verify the received RA packet is correct. | | [Tags] | EXPECTED_FAILING -| | Given Path for 3-node testing is set +| | 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 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} + +| TC02: DUT retransmits RA on IPv6 enabled interface after a set interval +| | [Documentation] +| | ... | [Top] TG-DUT1-DUT2-TG. +| | ... | [Cfg] On DUT1 configure IPv6 interface on the link to TG. +| | ... | [Ver] Make TG wait for two IPv6 Router Advertisement packets\ +| | ... | to be sent by DUT1 and verify the received RA packets are correct. +| | [Tags] | EXPECTED_FAILING +| | 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} +| | ... | interval=${interval} +| | :FOR | ${n} | IN RANGE | ${2} +| | | Then Receive And Check Router Advertisement Packet +| | | ... | ${tg_node} | ${tg_to_dut1} | ${dut1_to_tg_mac} | ${interval} + +| TC03: DUT responds to Router Solicitation request +| | [Documentation] +| | ... | [Top] TG-DUT1-DUT2-TG. +| | ... | [Cfg] On DUT1 configure IPv6 interface on the link to TG and suppress\ +| | ... | sending of Router Advertisement packets periodically. +| | ... | [Ver] Make TG send IPv6 Router Solicitation request to DUT1, listen\ +| | ... | for response from DUT1 and verify the received RA packet is correct. +| | [Tags] | EXPECTED_FAILING +| | 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 Suppress Link Layer | ${dut1_node} | ${dut1_to_tg} +| | Then Send Router Solicitation And Check Response +| | ... | ${tg_node} | ${dut1_node} | ${tg_to_dut1} | ${dut1_to_tg} +| | ... | ${tg_to_dut1_ip} + +| TC04: DUT responds to Router Solicitation request sent from link local address +| | [Documentation] +| | ... | [Top] TG-DUT1-DUT2-TG. +| | ... | [Cfg] On DUT1 configure IPv6 interface on the link to TG and suppress\ +| | ... | sending of Router Advertisement packets periodically. +| | ... | [Ver] Make TG send IPv6 Router Solicitation request to DUT1, listen\ +| | ... | for response from DUT1 and verify the received RA packet is correct. +| | [Tags] | EXPECTED_FAILING +| | 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 Suppress Link Layer | ${dut1_node} | ${dut1_to_tg} +| | Then Send Router Solicitation And Check Response +| | ... | ${tg_node} | ${dut1_node} | ${tg_to_dut1} | ${dut1_to_tg}