| | ... | ${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
| | ... | \| 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.
| | ...
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:
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))
--- /dev/null
+#!/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()
| 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
*** 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}
Code Review / csit.git / commitdiff