diff options
Diffstat (limited to 'resources')
| -rw-r--r-- | resources/libraries/robot/traffic.robot | 49 | ||||
| -rwxr-xr-x | resources/traffic_scripts/check_ra_packet.py | 18 | ||||
| -rwxr-xr-x | resources/traffic_scripts/send_rs_check_ra.py | 121 |
3 files changed, 177 insertions, 11 deletions
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() |