6 from parameterized import parameterized
8 import scapy.layers.inet6 as inet6
9 from scapy.contrib.mpls import MPLS
10 from scapy.layers.inet6 import IPv6, ICMPv6ND_NS, ICMPv6ND_RS, \
11 ICMPv6ND_RA, ICMPv6NDOptMTU, ICMPv6NDOptSrcLLAddr, ICMPv6NDOptPrefixInfo, \
12 ICMPv6ND_NA, ICMPv6NDOptDstLLAddr, ICMPv6DestUnreach, icmp6types, \
13 ICMPv6TimeExceeded, ICMPv6EchoRequest, ICMPv6EchoReply
14 from scapy.layers.l2 import Ether, Dot1Q
15 from scapy.packet import Raw
16 from scapy.utils import inet_pton, inet_ntop
17 from scapy.utils6 import in6_getnsma, in6_getnsmac, in6_ptop, in6_islladdr, \
21 from framework import VppTestCase, VppTestRunner
22 from util import ppp, ip6_normalize, mk_ll_addr
23 from vpp_ip import DpoProto
24 from vpp_ip_route import VppIpRoute, VppRoutePath, find_route, VppIpMRoute, \
25 VppMRoutePath, MRouteItfFlags, MRouteEntryFlags, VppMplsIpBind, \
26 VppMplsRoute, VppMplsTable, VppIpTable
27 from vpp_neighbor import find_nbr, VppNeighbor
28 from vpp_pg_interface import is_ipv6_misc
29 from vpp_sub_interface import VppSubInterface, VppDot1QSubint
30 from ipaddress import IPv6Network, IPv4Network
32 AF_INET6 = socket.AF_INET6
40 class TestIPv6ND(VppTestCase):
41 def validate_ra(self, intf, rx, dst_ip=None):
43 dst_ip = intf.remote_ip6
45 # unicasted packets must come to the unicast mac
46 self.assertEqual(rx[Ether].dst, intf.remote_mac)
48 # and from the router's MAC
49 self.assertEqual(rx[Ether].src, intf.local_mac)
51 # the rx'd RA should be addressed to the sender's source
52 self.assertTrue(rx.haslayer(ICMPv6ND_RA))
53 self.assertEqual(in6_ptop(rx[IPv6].dst),
56 # and come from the router's link local
57 self.assertTrue(in6_islladdr(rx[IPv6].src))
58 self.assertEqual(in6_ptop(rx[IPv6].src),
59 in6_ptop(mk_ll_addr(intf.local_mac)))
61 def validate_na(self, intf, rx, dst_ip=None, tgt_ip=None):
63 dst_ip = intf.remote_ip6
65 dst_ip = intf.local_ip6
67 # unicasted packets must come to the unicast mac
68 self.assertEqual(rx[Ether].dst, intf.remote_mac)
70 # and from the router's MAC
71 self.assertEqual(rx[Ether].src, intf.local_mac)
73 # the rx'd NA should be addressed to the sender's source
74 self.assertTrue(rx.haslayer(ICMPv6ND_NA))
75 self.assertEqual(in6_ptop(rx[IPv6].dst),
78 # and come from the target address
80 in6_ptop(rx[IPv6].src), in6_ptop(tgt_ip))
82 # Dest link-layer options should have the router's MAC
83 dll = rx[ICMPv6NDOptDstLLAddr]
84 self.assertEqual(dll.lladdr, intf.local_mac)
86 def validate_ns(self, intf, rx, tgt_ip):
87 nsma = in6_getnsma(inet_pton(AF_INET6, tgt_ip))
88 dst_ip = inet_ntop(AF_INET6, nsma)
91 self.assertEqual(rx[Ether].dst, in6_getnsmac(nsma))
93 # and from the router's MAC
94 self.assertEqual(rx[Ether].src, intf.local_mac)
96 # the rx'd NS should be addressed to an mcast address
97 # derived from the target address
99 in6_ptop(rx[IPv6].dst), in6_ptop(dst_ip))
101 # expect the tgt IP in the NS header
103 self.assertEqual(in6_ptop(ns.tgt), in6_ptop(tgt_ip))
105 # packet is from the router's local address
107 in6_ptop(rx[IPv6].src), intf.local_ip6)
109 # Src link-layer options should have the router's MAC
110 sll = rx[ICMPv6NDOptSrcLLAddr]
111 self.assertEqual(sll.lladdr, intf.local_mac)
113 def send_and_expect_ra(self, intf, pkts, remark, dst_ip=None,
114 filter_out_fn=is_ipv6_misc):
115 intf.add_stream(pkts)
116 self.pg_enable_capture(self.pg_interfaces)
118 rx = intf.get_capture(1, filter_out_fn=filter_out_fn)
120 self.assertEqual(len(rx), 1)
122 self.validate_ra(intf, rx, dst_ip)
124 def send_and_expect_na(self, intf, pkts, remark, dst_ip=None,
126 filter_out_fn=is_ipv6_misc):
127 intf.add_stream(pkts)
128 self.pg_enable_capture(self.pg_interfaces)
130 rx = intf.get_capture(1, filter_out_fn=filter_out_fn)
132 self.assertEqual(len(rx), 1)
134 self.validate_na(intf, rx, dst_ip, tgt_ip)
136 def send_and_expect_ns(self, tx_intf, rx_intf, pkts, tgt_ip,
137 filter_out_fn=is_ipv6_misc):
138 tx_intf.add_stream(pkts)
139 self.pg_enable_capture(self.pg_interfaces)
141 rx = rx_intf.get_capture(1, filter_out_fn=filter_out_fn)
143 self.assertEqual(len(rx), 1)
145 self.validate_ns(rx_intf, rx, tgt_ip)
147 def verify_ip(self, rx, smac, dmac, sip, dip):
149 self.assertEqual(ether.dst, dmac)
150 self.assertEqual(ether.src, smac)
153 self.assertEqual(ip.src, sip)
154 self.assertEqual(ip.dst, dip)
157 class TestIPv6(TestIPv6ND):
158 """ IPv6 Test Case """
162 super(TestIPv6, cls).setUpClass()
166 Perform test setup before test case.
169 - create 3 pg interfaces
170 - untagged pg0 interface
171 - Dot1Q subinterface on pg1
172 - Dot1AD subinterface on pg2
174 - put it into UP state
176 - resolve neighbor address using NDP
177 - configure 200 fib entries
179 :ivar list interfaces: pg interfaces and subinterfaces.
180 :ivar dict flows: IPv4 packet flows in test.
182 *TODO:* Create AD sub interface
184 super(TestIPv6, self).setUp()
186 # create 3 pg interfaces
187 self.create_pg_interfaces(range(3))
189 # create 2 subinterfaces for p1 and pg2
190 self.sub_interfaces = [
191 VppDot1QSubint(self, self.pg1, 100),
192 VppDot1QSubint(self, self.pg2, 200)
193 # TODO: VppDot1ADSubint(self, self.pg2, 200, 300, 400)
196 # packet flows mapping pg0 -> pg1.sub, pg2.sub, etc.
198 self.flows[self.pg0] = [self.pg1.sub_if, self.pg2.sub_if]
199 self.flows[self.pg1.sub_if] = [self.pg0, self.pg2.sub_if]
200 self.flows[self.pg2.sub_if] = [self.pg0, self.pg1.sub_if]
203 self.pg_if_packet_sizes = [64, 1500, 9020]
205 self.interfaces = list(self.pg_interfaces)
206 self.interfaces.extend(self.sub_interfaces)
208 # setup all interfaces
209 for i in self.interfaces:
214 # config 2M FIB entries
215 self.config_fib_entries(200)
218 """Run standard test teardown and log ``show ip6 neighbors``."""
219 for i in self.interfaces:
223 for i in self.sub_interfaces:
224 i.remove_vpp_config()
226 super(TestIPv6, self).tearDown()
227 if not self.vpp_dead:
228 self.logger.info(self.vapi.cli("show ip6 neighbors"))
229 # info(self.vapi.cli("show ip6 fib")) # many entries
231 def config_fib_entries(self, count):
232 """For each interface add to the FIB table *count* routes to
233 "fd02::1/128" destination with interface's local address as next-hop
236 :param int count: Number of FIB entries.
238 - *TODO:* check if the next-hop address shouldn't be remote address
239 instead of local address.
241 n_int = len(self.interfaces)
244 dest_addr = inet_pton(AF_INET6, "fd02::1")
246 for i in self.interfaces:
247 next_hop_address = i.local_ip6n
248 for j in range(count / n_int):
249 self.vapi.ip_add_del_route(dst_address=dest_addr,
250 dst_address_length=dest_addr_len,
251 next_hop_address=next_hop_address,
254 if counter / count * 100 > percent:
255 self.logger.info("Configure %d FIB entries .. %d%% done" %
259 def modify_packet(self, src_if, packet_size, pkt):
260 """Add load, set destination IP and extend packet to required packet
261 size for defined interface.
263 :param VppInterface src_if: Interface to create packet for.
264 :param int packet_size: Required packet size.
265 :param Scapy pkt: Packet to be modified.
267 dst_if_idx = packet_size / 10 % 2
268 dst_if = self.flows[src_if][dst_if_idx]
269 info = self.create_packet_info(src_if, dst_if)
270 payload = self.info_to_payload(info)
271 p = pkt / Raw(payload)
272 p[IPv6].dst = dst_if.remote_ip6
274 if isinstance(src_if, VppSubInterface):
275 p = src_if.add_dot1_layer(p)
276 self.extend_packet(p, packet_size)
280 def create_stream(self, src_if):
281 """Create input packet stream for defined interface.
283 :param VppInterface src_if: Interface to create packet stream for.
285 hdr_ext = 4 if isinstance(src_if, VppSubInterface) else 0
286 pkt_tmpl = (Ether(dst=src_if.local_mac, src=src_if.remote_mac) /
287 IPv6(src=src_if.remote_ip6) /
288 inet6.UDP(sport=1234, dport=1234))
290 pkts = [self.modify_packet(src_if, i, pkt_tmpl)
291 for i in moves.range(self.pg_if_packet_sizes[0],
292 self.pg_if_packet_sizes[1], 10)]
293 pkts_b = [self.modify_packet(src_if, i, pkt_tmpl)
294 for i in moves.range(self.pg_if_packet_sizes[1] + hdr_ext,
295 self.pg_if_packet_sizes[2] + hdr_ext,
301 def verify_capture(self, dst_if, capture):
302 """Verify captured input packet stream for defined interface.
304 :param VppInterface dst_if: Interface to verify captured packet stream
306 :param list capture: Captured packet stream.
308 self.logger.info("Verifying capture on interface %s" % dst_if.name)
310 for i in self.interfaces:
311 last_info[i.sw_if_index] = None
313 dst_sw_if_index = dst_if.sw_if_index
314 if hasattr(dst_if, 'parent'):
316 for packet in capture:
318 # Check VLAN tags and Ethernet header
319 packet = dst_if.remove_dot1_layer(packet)
320 self.assertTrue(Dot1Q not in packet)
323 udp = packet[inet6.UDP]
324 payload_info = self.payload_to_info(packet[Raw])
325 packet_index = payload_info.index
326 self.assertEqual(payload_info.dst, dst_sw_if_index)
328 "Got packet on port %s: src=%u (id=%u)" %
329 (dst_if.name, payload_info.src, packet_index))
330 next_info = self.get_next_packet_info_for_interface2(
331 payload_info.src, dst_sw_if_index,
332 last_info[payload_info.src])
333 last_info[payload_info.src] = next_info
334 self.assertTrue(next_info is not None)
335 self.assertEqual(packet_index, next_info.index)
336 saved_packet = next_info.data
337 # Check standard fields
339 ip.src, saved_packet[IPv6].src)
341 ip.dst, saved_packet[IPv6].dst)
343 udp.sport, saved_packet[inet6.UDP].sport)
345 udp.dport, saved_packet[inet6.UDP].dport)
347 self.logger.error(ppp("Unexpected or invalid packet:", packet))
349 for i in self.interfaces:
350 remaining_packet = self.get_next_packet_info_for_interface2(
351 i.sw_if_index, dst_sw_if_index, last_info[i.sw_if_index])
352 self.assertTrue(remaining_packet is None,
353 "Interface %s: Packet expected from interface %s "
354 "didn't arrive" % (dst_if.name, i.name))
360 - Create IPv6 stream for pg0 interface
361 - Create IPv6 tagged streams for pg1's and pg2's subinterface.
362 - Send and verify received packets on each interface.
365 pkts = self.create_stream(self.pg0)
366 self.pg0.add_stream(pkts)
368 for i in self.sub_interfaces:
369 pkts = self.create_stream(i)
370 i.parent.add_stream(pkts)
372 self.pg_enable_capture(self.pg_interfaces)
375 pkts = self.pg0.get_capture()
376 self.verify_capture(self.pg0, pkts)
378 for i in self.sub_interfaces:
379 pkts = i.parent.get_capture()
380 self.verify_capture(i, pkts)
383 """ IPv6 Neighbour Solicitation Exceptions
386 - Send an NS Sourced from an address not covered by the link sub-net
387 - Send an NS to an mcast address the router has not joined
388 - Send NS for a target address the router does not onn.
392 # An NS from a non link source address
394 nsma = in6_getnsma(inet_pton(AF_INET6, self.pg0.local_ip6))
395 d = inet_ntop(AF_INET6, nsma)
397 p = (Ether(dst=in6_getnsmac(nsma)) /
398 IPv6(dst=d, src="2002::2") /
399 ICMPv6ND_NS(tgt=self.pg0.local_ip6) /
400 ICMPv6NDOptSrcLLAddr(
401 lladdr=self.pg0.remote_mac))
404 self.send_and_assert_no_replies(
406 "No response to NS source by address not on sub-net")
409 # An NS for sent to a solicited mcast group the router is
410 # not a member of FAILS
413 nsma = in6_getnsma(inet_pton(AF_INET6, "fd::ffff"))
414 d = inet_ntop(AF_INET6, nsma)
416 p = (Ether(dst=in6_getnsmac(nsma)) /
417 IPv6(dst=d, src=self.pg0.remote_ip6) /
418 ICMPv6ND_NS(tgt=self.pg0.local_ip6) /
419 ICMPv6NDOptSrcLLAddr(
420 lladdr=self.pg0.remote_mac))
423 self.send_and_assert_no_replies(
425 "No response to NS sent to unjoined mcast address")
428 # An NS whose target address is one the router does not own
430 nsma = in6_getnsma(inet_pton(AF_INET6, self.pg0.local_ip6))
431 d = inet_ntop(AF_INET6, nsma)
433 p = (Ether(dst=in6_getnsmac(nsma)) /
434 IPv6(dst=d, src=self.pg0.remote_ip6) /
435 ICMPv6ND_NS(tgt="fd::ffff") /
436 ICMPv6NDOptSrcLLAddr(
437 lladdr=self.pg0.remote_mac))
440 self.send_and_assert_no_replies(self.pg0, pkts,
441 "No response to NS for unknown target")
444 # A neighbor entry that has no associated FIB-entry
446 self.pg0.generate_remote_hosts(4)
447 nd_entry = VppNeighbor(self,
448 self.pg0.sw_if_index,
449 self.pg0.remote_hosts[2].mac,
450 self.pg0.remote_hosts[2].ip6,
452 nd_entry.add_vpp_config()
455 # check we have the neighbor, but no route
457 self.assertTrue(find_nbr(self,
458 self.pg0.sw_if_index,
459 self.pg0._remote_hosts[2].ip6))
460 self.assertFalse(find_route(self,
461 self.pg0._remote_hosts[2].ip6,
466 # send an NS from a link local address to the interface's global
469 p = (Ether(dst=in6_getnsmac(nsma), src=self.pg0.remote_mac) /
471 dst=d, src=self.pg0._remote_hosts[2].ip6_ll) /
472 ICMPv6ND_NS(tgt=self.pg0.local_ip6) /
473 ICMPv6NDOptSrcLLAddr(
474 lladdr=self.pg0.remote_mac))
476 self.send_and_expect_na(self.pg0, p,
477 "NS from link-local",
478 dst_ip=self.pg0._remote_hosts[2].ip6_ll,
479 tgt_ip=self.pg0.local_ip6)
482 # we should have learned an ND entry for the peer's link-local
483 # but not inserted a route to it in the FIB
485 self.assertTrue(find_nbr(self,
486 self.pg0.sw_if_index,
487 self.pg0._remote_hosts[2].ip6_ll))
488 self.assertFalse(find_route(self,
489 self.pg0._remote_hosts[2].ip6_ll,
494 # An NS to the router's own Link-local
496 p = (Ether(dst=in6_getnsmac(nsma), src=self.pg0.remote_mac) /
498 dst=d, src=self.pg0._remote_hosts[3].ip6_ll) /
499 ICMPv6ND_NS(tgt=self.pg0.local_ip6_ll) /
500 ICMPv6NDOptSrcLLAddr(
501 lladdr=self.pg0.remote_mac))
503 self.send_and_expect_na(self.pg0, p,
504 "NS to/from link-local",
505 dst_ip=self.pg0._remote_hosts[3].ip6_ll,
506 tgt_ip=self.pg0.local_ip6_ll)
509 # we should have learned an ND entry for the peer's link-local
510 # but not inserted a route to it in the FIB
512 self.assertTrue(find_nbr(self,
513 self.pg0.sw_if_index,
514 self.pg0._remote_hosts[3].ip6_ll))
515 self.assertFalse(find_route(self,
516 self.pg0._remote_hosts[3].ip6_ll,
520 def test_ns_duplicates(self):
524 # Generate some hosts on the LAN
526 self.pg1.generate_remote_hosts(3)
529 # Add host 1 on pg1 and pg2
531 ns_pg1 = VppNeighbor(self,
532 self.pg1.sw_if_index,
533 self.pg1.remote_hosts[1].mac,
534 self.pg1.remote_hosts[1].ip6)
535 ns_pg1.add_vpp_config()
536 ns_pg2 = VppNeighbor(self,
537 self.pg2.sw_if_index,
539 self.pg1.remote_hosts[1].ip6)
540 ns_pg2.add_vpp_config()
543 # IP packet destined for pg1 remote host arrives on pg1 again.
545 p = (Ether(dst=self.pg0.local_mac,
546 src=self.pg0.remote_mac) /
547 IPv6(src=self.pg0.remote_ip6,
548 dst=self.pg1.remote_hosts[1].ip6) /
549 inet6.UDP(sport=1234, dport=1234) /
552 self.pg0.add_stream(p)
553 self.pg_enable_capture(self.pg_interfaces)
556 rx1 = self.pg1.get_capture(1)
558 self.verify_ip(rx1[0],
560 self.pg1.remote_hosts[1].mac,
562 self.pg1.remote_hosts[1].ip6)
565 # remove the duplicate on pg1
566 # packet stream should generate NSs out of pg1
568 ns_pg1.remove_vpp_config()
570 self.send_and_expect_ns(self.pg0, self.pg1,
571 p, self.pg1.remote_hosts[1].ip6)
576 ns_pg1.add_vpp_config()
578 self.pg0.add_stream(p)
579 self.pg_enable_capture(self.pg_interfaces)
582 rx1 = self.pg1.get_capture(1)
584 self.verify_ip(rx1[0],
586 self.pg1.remote_hosts[1].mac,
588 self.pg1.remote_hosts[1].ip6)
590 def validate_ra(self, intf, rx, dst_ip=None, mtu=9000, pi_opt=None):
592 dst_ip = intf.remote_ip6
594 # unicasted packets must come to the unicast mac
595 self.assertEqual(rx[Ether].dst, intf.remote_mac)
597 # and from the router's MAC
598 self.assertEqual(rx[Ether].src, intf.local_mac)
600 # the rx'd RA should be addressed to the sender's source
601 self.assertTrue(rx.haslayer(ICMPv6ND_RA))
602 self.assertEqual(in6_ptop(rx[IPv6].dst),
605 # and come from the router's link local
606 self.assertTrue(in6_islladdr(rx[IPv6].src))
607 self.assertEqual(in6_ptop(rx[IPv6].src),
608 in6_ptop(mk_ll_addr(intf.local_mac)))
610 # it should contain the links MTU
612 self.assertEqual(ra[ICMPv6NDOptMTU].mtu, mtu)
614 # it should contain the source's link layer address option
615 sll = ra[ICMPv6NDOptSrcLLAddr]
616 self.assertEqual(sll.lladdr, intf.local_mac)
619 # the RA should not contain prefix information
620 self.assertFalse(ra.haslayer(
621 ICMPv6NDOptPrefixInfo))
623 raos = rx.getlayer(ICMPv6NDOptPrefixInfo, 1)
625 # the options are nested in the scapy packet in way that i cannot
626 # decipher how to decode. this 1st layer of option always returns
627 # nested classes, so a direct obj1=obj2 comparison always fails.
628 # however, the getlayer(.., 2) does give one instnace.
629 # so we cheat here and construct a new opt instance for comparison
630 rd = ICMPv6NDOptPrefixInfo(
631 prefixlen=raos.prefixlen,
635 if type(pi_opt) is list:
636 for ii in range(len(pi_opt)):
637 self.assertEqual(pi_opt[ii], rd)
639 ICMPv6NDOptPrefixInfo, ii + 2)
641 self.assertEqual(pi_opt, raos)
643 def send_and_expect_ra(self, intf, pkts, remark, dst_ip=None,
644 filter_out_fn=is_ipv6_misc,
646 intf.add_stream(pkts)
647 self.pg_enable_capture(self.pg_interfaces)
649 rx = intf.get_capture(1, filter_out_fn=filter_out_fn)
651 self.assertEqual(len(rx), 1)
653 self.validate_ra(intf, rx, dst_ip, pi_opt=opt)
656 """ IPv6 Router Solicitation Exceptions
662 # Before we begin change the IPv6 RA responses to use the unicast
663 # address - that way we will not confuse them with the periodic
664 # RAs which go to the mcast address
665 # Sit and wait for the first periodic RA.
669 self.pg0.ip6_ra_config(send_unicast=1)
672 # An RS from a link source address
673 # - expect an RA in return
675 p = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
677 dst=self.pg0.local_ip6, src=self.pg0.remote_ip6) /
680 self.send_and_expect_ra(self.pg0, pkts, "Genuine RS")
683 # For the next RS sent the RA should be rate limited
685 self.send_and_assert_no_replies(self.pg0, pkts, "RA rate limited")
688 # When we reconfigure the IPv6 RA config,
689 # we reset the RA rate limiting,
690 # so we need to do this before each test below so as not to drop
691 # packets for rate limiting reasons. Test this works here.
693 self.pg0.ip6_ra_config(send_unicast=1)
694 self.send_and_expect_ra(self.pg0, pkts, "Rate limit reset RS")
697 # An RS sent from a non-link local source
699 self.pg0.ip6_ra_config(send_unicast=1)
700 p = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
701 IPv6(dst=self.pg0.local_ip6,
705 self.send_and_assert_no_replies(self.pg0, pkts,
706 "RS from non-link source")
709 # Source an RS from a link local address
711 self.pg0.ip6_ra_config(send_unicast=1)
712 ll = mk_ll_addr(self.pg0.remote_mac)
713 p = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
714 IPv6(dst=self.pg0.local_ip6, src=ll) /
717 self.send_and_expect_ra(self.pg0, pkts,
718 "RS sourced from link-local",
722 # Send the RS multicast
724 self.pg0.ip6_ra_config(send_unicast=1)
725 dmac = in6_getnsmac(inet_pton(AF_INET6, "ff02::2"))
726 ll = mk_ll_addr(self.pg0.remote_mac)
727 p = (Ether(dst=dmac, src=self.pg0.remote_mac) /
728 IPv6(dst="ff02::2", src=ll) /
731 self.send_and_expect_ra(self.pg0, pkts,
732 "RS sourced from link-local",
736 # Source from the unspecified address ::. This happens when the RS
737 # is sent before the host has a configured address/sub-net,
738 # i.e. auto-config. Since the sender has no IP address, the reply
739 # comes back mcast - so the capture needs to not filter this.
740 # If we happen to pick up the periodic RA at this point then so be it,
743 self.pg0.ip6_ra_config(send_unicast=1, suppress=1)
744 p = (Ether(dst=dmac, src=self.pg0.remote_mac) /
745 IPv6(dst="ff02::2", src="::") /
748 self.send_and_expect_ra(self.pg0, pkts,
749 "RS sourced from unspecified",
754 # Configure The RA to announce the links prefix
756 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
757 self.pg0.local_ip6_prefix_len)
760 # RAs should now contain the prefix information option
762 opt = ICMPv6NDOptPrefixInfo(
763 prefixlen=self.pg0.local_ip6_prefix_len,
764 prefix=self.pg0.local_ip6,
768 self.pg0.ip6_ra_config(send_unicast=1)
769 ll = mk_ll_addr(self.pg0.remote_mac)
770 p = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
771 IPv6(dst=self.pg0.local_ip6, src=ll) /
773 self.send_and_expect_ra(self.pg0, p,
774 "RA with prefix-info",
779 # Change the prefix info to not off-link
782 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
783 self.pg0.local_ip6_prefix_len,
786 opt = ICMPv6NDOptPrefixInfo(
787 prefixlen=self.pg0.local_ip6_prefix_len,
788 prefix=self.pg0.local_ip6,
792 self.pg0.ip6_ra_config(send_unicast=1)
793 self.send_and_expect_ra(self.pg0, p,
794 "RA with Prefix info with L-flag=0",
799 # Change the prefix info to not off-link, no-autoconfig
800 # L and A flag are clear in the advert
802 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
803 self.pg0.local_ip6_prefix_len,
807 opt = ICMPv6NDOptPrefixInfo(
808 prefixlen=self.pg0.local_ip6_prefix_len,
809 prefix=self.pg0.local_ip6,
813 self.pg0.ip6_ra_config(send_unicast=1)
814 self.send_and_expect_ra(self.pg0, p,
815 "RA with Prefix info with A & L-flag=0",
820 # Change the flag settings back to the defaults
821 # L and A flag are set in the advert
823 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
824 self.pg0.local_ip6_prefix_len)
826 opt = ICMPv6NDOptPrefixInfo(
827 prefixlen=self.pg0.local_ip6_prefix_len,
828 prefix=self.pg0.local_ip6,
832 self.pg0.ip6_ra_config(send_unicast=1)
833 self.send_and_expect_ra(self.pg0, p,
834 "RA with Prefix info",
839 # Change the prefix info to not off-link, no-autoconfig
840 # L and A flag are clear in the advert
842 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
843 self.pg0.local_ip6_prefix_len,
847 opt = ICMPv6NDOptPrefixInfo(
848 prefixlen=self.pg0.local_ip6_prefix_len,
849 prefix=self.pg0.local_ip6,
853 self.pg0.ip6_ra_config(send_unicast=1)
854 self.send_and_expect_ra(self.pg0, p,
855 "RA with Prefix info with A & L-flag=0",
860 # Use the reset to defaults option to revert to defaults
861 # L and A flag are clear in the advert
863 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
864 self.pg0.local_ip6_prefix_len,
867 opt = ICMPv6NDOptPrefixInfo(
868 prefixlen=self.pg0.local_ip6_prefix_len,
869 prefix=self.pg0.local_ip6,
873 self.pg0.ip6_ra_config(send_unicast=1)
874 self.send_and_expect_ra(self.pg0, p,
875 "RA with Prefix reverted to defaults",
880 # Advertise Another prefix. With no L-flag/A-flag
882 self.pg0.ip6_ra_prefix(self.pg1.local_ip6,
883 self.pg1.local_ip6_prefix_len,
887 opt = [ICMPv6NDOptPrefixInfo(
888 prefixlen=self.pg0.local_ip6_prefix_len,
889 prefix=self.pg0.local_ip6,
892 ICMPv6NDOptPrefixInfo(
893 prefixlen=self.pg1.local_ip6_prefix_len,
894 prefix=self.pg1.local_ip6,
898 self.pg0.ip6_ra_config(send_unicast=1)
899 ll = mk_ll_addr(self.pg0.remote_mac)
900 p = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
901 IPv6(dst=self.pg0.local_ip6, src=ll) /
903 self.send_and_expect_ra(self.pg0, p,
904 "RA with multiple Prefix infos",
909 # Remove the first prefix-info - expect the second is still in the
912 self.pg0.ip6_ra_prefix(self.pg0.local_ip6,
913 self.pg0.local_ip6_prefix_len,
916 opt = ICMPv6NDOptPrefixInfo(
917 prefixlen=self.pg1.local_ip6_prefix_len,
918 prefix=self.pg1.local_ip6,
922 self.pg0.ip6_ra_config(send_unicast=1)
923 self.send_and_expect_ra(self.pg0, p,
924 "RA with Prefix reverted to defaults",
929 # Remove the second prefix-info - expect no prefix-info in the adverts
931 self.pg0.ip6_ra_prefix(self.pg1.local_ip6,
932 self.pg1.local_ip6_prefix_len,
935 self.pg0.ip6_ra_config(send_unicast=1)
936 self.send_and_expect_ra(self.pg0, p,
937 "RA with Prefix reverted to defaults",
941 # Reset the periodic advertisements back to default values
943 self.pg0.ip6_ra_config(no=1, suppress=1, send_unicast=0)
946 class TestICMPv6Echo(VppTestCase):
947 """ ICMPv6 Echo Test Case """
950 super(TestICMPv6Echo, self).setUp()
952 # create 1 pg interface
953 self.create_pg_interfaces(range(1))
955 for i in self.pg_interfaces:
961 super(TestICMPv6Echo, self).tearDown()
962 for i in self.pg_interfaces:
967 def test_icmpv6_echo(self):
968 """ VPP replies to ICMPv6 Echo Request
972 - Receive ICMPv6 Echo Request message on pg0 interface.
973 - Check outgoing ICMPv6 Echo Reply message on pg0 interface.
978 icmpv6_data = b'\x0a' * 18
979 p_echo_request = (Ether(src=self.pg0.remote_mac,
980 dst=self.pg0.local_mac) /
981 IPv6(src=self.pg0.remote_ip6,
982 dst=self.pg0.local_ip6) /
988 self.pg0.add_stream(p_echo_request)
989 self.pg_enable_capture(self.pg_interfaces)
992 rx = self.pg0.get_capture(1)
996 icmpv6 = rx[ICMPv6EchoReply]
998 self.assertEqual(ether.src, self.pg0.local_mac)
999 self.assertEqual(ether.dst, self.pg0.remote_mac)
1001 self.assertEqual(ipv6.src, self.pg0.local_ip6)
1002 self.assertEqual(ipv6.dst, self.pg0.remote_ip6)
1005 icmp6types[icmpv6.type], "Echo Reply")
1006 self.assertEqual(icmpv6.id, icmpv6_id)
1007 self.assertEqual(icmpv6.seq, icmpv6_seq)
1008 self.assertEqual(icmpv6.data, icmpv6_data)
1011 class TestIPv6RD(TestIPv6ND):
1012 """ IPv6 Router Discovery Test Case """
1015 def setUpClass(cls):
1016 super(TestIPv6RD, cls).setUpClass()
1019 super(TestIPv6RD, self).setUp()
1021 # create 2 pg interfaces
1022 self.create_pg_interfaces(range(2))
1024 self.interfaces = list(self.pg_interfaces)
1026 # setup all interfaces
1027 for i in self.interfaces:
1032 for i in self.interfaces:
1035 super(TestIPv6RD, self).tearDown()
1037 def test_rd_send_router_solicitation(self):
1038 """ Verify router solicitation packets """
1041 self.pg_enable_capture(self.pg_interfaces)
1043 self.vapi.ip6nd_send_router_solicitation(self.pg1.sw_if_index,
1045 rx_list = self.pg1.get_capture(count, timeout=3)
1046 self.assertEqual(len(rx_list), count)
1047 for packet in rx_list:
1048 self.assertEqual(packet.haslayer(IPv6), 1)
1049 self.assertEqual(packet[IPv6].haslayer(
1051 dst = ip6_normalize(packet[IPv6].dst)
1052 dst2 = ip6_normalize("ff02::2")
1053 self.assert_equal(dst, dst2)
1054 src = ip6_normalize(packet[IPv6].src)
1055 src2 = ip6_normalize(self.pg1.local_ip6_ll)
1056 self.assert_equal(src, src2)
1058 bool(packet[ICMPv6ND_RS].haslayer(
1059 ICMPv6NDOptSrcLLAddr)))
1061 packet[ICMPv6NDOptSrcLLAddr].lladdr,
1064 def verify_prefix_info(self, reported_prefix, prefix_option):
1065 prefix = IPv6Network(
1066 text_type(prefix_option.getfieldval("prefix") +
1068 text_type(prefix_option.getfieldval("prefixlen"))),
1070 self.assert_equal(reported_prefix.prefix.network_address,
1071 prefix.network_address)
1072 L = prefix_option.getfieldval("L")
1073 A = prefix_option.getfieldval("A")
1074 option_flags = (L << 7) | (A << 6)
1075 self.assert_equal(reported_prefix.flags, option_flags)
1076 self.assert_equal(reported_prefix.valid_time,
1077 prefix_option.getfieldval("validlifetime"))
1078 self.assert_equal(reported_prefix.preferred_time,
1079 prefix_option.getfieldval("preferredlifetime"))
1081 def test_rd_receive_router_advertisement(self):
1082 """ Verify events triggered by received RA packets """
1084 self.vapi.want_ip6_ra_events()
1086 prefix_info_1 = ICMPv6NDOptPrefixInfo(
1090 preferredlifetime=500,
1095 prefix_info_2 = ICMPv6NDOptPrefixInfo(
1099 preferredlifetime=1000,
1104 p = (Ether(dst=self.pg1.local_mac, src=self.pg1.remote_mac) /
1105 IPv6(dst=self.pg1.local_ip6_ll,
1106 src=mk_ll_addr(self.pg1.remote_mac)) /
1110 self.pg1.add_stream([p])
1113 ev = self.vapi.wait_for_event(10, "ip6_ra_event")
1115 self.assert_equal(ev.current_hop_limit, 0)
1116 self.assert_equal(ev.flags, 8)
1117 self.assert_equal(ev.router_lifetime_in_sec, 1800)
1118 self.assert_equal(ev.neighbor_reachable_time_in_msec, 0)
1120 ev.time_in_msec_between_retransmitted_neighbor_solicitations, 0)
1122 self.assert_equal(ev.n_prefixes, 2)
1124 self.verify_prefix_info(ev.prefixes[0], prefix_info_1)
1125 self.verify_prefix_info(ev.prefixes[1], prefix_info_2)
1128 class TestIPv6RDControlPlane(TestIPv6ND):
1129 """ IPv6 Router Discovery Control Plane Test Case """
1132 def setUpClass(cls):
1133 super(TestIPv6RDControlPlane, cls).setUpClass()
1136 super(TestIPv6RDControlPlane, self).setUp()
1138 # create 1 pg interface
1139 self.create_pg_interfaces(range(1))
1141 self.interfaces = list(self.pg_interfaces)
1143 # setup all interfaces
1144 for i in self.interfaces:
1149 super(TestIPv6RDControlPlane, self).tearDown()
1152 def create_ra_packet(pg, routerlifetime=None):
1153 src_ip = pg.remote_ip6_ll
1154 dst_ip = pg.local_ip6
1155 if routerlifetime is not None:
1156 ra = ICMPv6ND_RA(routerlifetime=routerlifetime)
1159 p = (Ether(dst=pg.local_mac, src=pg.remote_mac) /
1160 IPv6(dst=dst_ip, src=src_ip) / ra)
1164 def get_default_routes(fib):
1167 if entry.address_length == 0:
1168 for path in entry.path:
1169 if path.sw_if_index != 0xFFFFFFFF:
1171 default_route['sw_if_index'] = path.sw_if_index
1172 default_route['next_hop'] = path.next_hop
1173 list.append(default_route)
1177 def get_interface_addresses(fib, pg):
1180 if entry.address_length == 128:
1181 path = entry.path[0]
1182 if path.sw_if_index == pg.sw_if_index:
1183 list.append(entry.address)
1187 """ Test handling of SLAAC addresses and default routes """
1189 fib = self.vapi.ip6_fib_dump()
1190 default_routes = self.get_default_routes(fib)
1191 initial_addresses = set(self.get_interface_addresses(fib, self.pg0))
1192 self.assertEqual(default_routes, [])
1193 router_address = self.pg0.remote_ip6n_ll
1195 self.vapi.ip6_nd_address_autoconfig(self.pg0.sw_if_index, 1, 1)
1200 packet = (self.create_ra_packet(
1201 self.pg0) / ICMPv6NDOptPrefixInfo(
1205 preferredlifetime=2,
1208 ) / ICMPv6NDOptPrefixInfo(
1212 preferredlifetime=1000,
1216 self.pg0.add_stream([packet])
1221 fib = self.vapi.ip6_fib_dump()
1223 # check FIB for new address
1224 addresses = set(self.get_interface_addresses(fib, self.pg0))
1225 new_addresses = addresses.difference(initial_addresses)
1226 self.assertEqual(len(new_addresses), 1)
1227 prefix = list(new_addresses)[0][:8] + '\0\0\0\0\0\0\0\0'
1228 self.assertEqual(inet_ntop(AF_INET6, prefix), '1::')
1230 # check FIB for new default route
1231 default_routes = self.get_default_routes(fib)
1232 self.assertEqual(len(default_routes), 1)
1233 dr = default_routes[0]
1234 self.assertEqual(dr['sw_if_index'], self.pg0.sw_if_index)
1235 self.assertEqual(dr['next_hop'], router_address)
1237 # send RA to delete default route
1238 packet = self.create_ra_packet(self.pg0, routerlifetime=0)
1239 self.pg0.add_stream([packet])
1244 # check that default route is deleted
1245 fib = self.vapi.ip6_fib_dump()
1246 default_routes = self.get_default_routes(fib)
1247 self.assertEqual(len(default_routes), 0)
1252 packet = self.create_ra_packet(self.pg0)
1253 self.pg0.add_stream([packet])
1258 # check FIB for new default route
1259 fib = self.vapi.ip6_fib_dump()
1260 default_routes = self.get_default_routes(fib)
1261 self.assertEqual(len(default_routes), 1)
1262 dr = default_routes[0]
1263 self.assertEqual(dr['sw_if_index'], self.pg0.sw_if_index)
1264 self.assertEqual(dr['next_hop'], router_address)
1266 # send RA, updating router lifetime to 1s
1267 packet = self.create_ra_packet(self.pg0, 1)
1268 self.pg0.add_stream([packet])
1273 # check that default route still exists
1274 fib = self.vapi.ip6_fib_dump()
1275 default_routes = self.get_default_routes(fib)
1276 self.assertEqual(len(default_routes), 1)
1277 dr = default_routes[0]
1278 self.assertEqual(dr['sw_if_index'], self.pg0.sw_if_index)
1279 self.assertEqual(dr['next_hop'], router_address)
1283 # check that default route is deleted
1284 fib = self.vapi.ip6_fib_dump()
1285 default_routes = self.get_default_routes(fib)
1286 self.assertEqual(len(default_routes), 0)
1288 # check FIB still contains the SLAAC address
1289 addresses = set(self.get_interface_addresses(fib, self.pg0))
1290 new_addresses = addresses.difference(initial_addresses)
1291 self.assertEqual(len(new_addresses), 1)
1292 prefix = list(new_addresses)[0][:8] + '\0\0\0\0\0\0\0\0'
1293 self.assertEqual(inet_ntop(AF_INET6, prefix), '1::')
1297 # check that SLAAC address is deleted
1298 fib = self.vapi.ip6_fib_dump()
1299 addresses = set(self.get_interface_addresses(fib, self.pg0))
1300 new_addresses = addresses.difference(initial_addresses)
1301 self.assertEqual(len(new_addresses), 0)
1304 class IPv6NDProxyTest(TestIPv6ND):
1305 """ IPv6 ND ProxyTest Case """
1308 super(IPv6NDProxyTest, self).setUp()
1310 # create 3 pg interfaces
1311 self.create_pg_interfaces(range(3))
1313 # pg0 is the master interface, with the configured subnet
1315 self.pg0.config_ip6()
1316 self.pg0.resolve_ndp()
1318 self.pg1.ip6_enable()
1319 self.pg2.ip6_enable()
1322 super(IPv6NDProxyTest, self).tearDown()
1324 def test_nd_proxy(self):
1325 """ IPv6 Proxy ND """
1328 # Generate some hosts in the subnet that we are proxying
1330 self.pg0.generate_remote_hosts(8)
1332 nsma = in6_getnsma(inet_pton(AF_INET6, self.pg0.local_ip6))
1333 d = inet_ntop(AF_INET6, nsma)
1336 # Send an NS for one of those remote hosts on one of the proxy links
1337 # expect no response since it's from an address that is not
1338 # on the link that has the prefix configured
1340 ns_pg1 = (Ether(dst=in6_getnsmac(nsma), src=self.pg1.remote_mac) /
1342 src=self.pg0._remote_hosts[2].ip6) /
1343 ICMPv6ND_NS(tgt=self.pg0.local_ip6) /
1344 ICMPv6NDOptSrcLLAddr(
1345 lladdr=self.pg0._remote_hosts[2].mac))
1347 self.send_and_assert_no_replies(self.pg1, ns_pg1, "Off link NS")
1350 # Add proxy support for the host
1352 self.vapi.ip6nd_proxy_add_del(
1353 ip=inet_pton(AF_INET6, self.pg0._remote_hosts[2].ip6),
1354 sw_if_index=self.pg1.sw_if_index)
1357 # try that NS again. this time we expect an NA back
1359 self.send_and_expect_na(self.pg1, ns_pg1,
1360 "NS to proxy entry",
1361 dst_ip=self.pg0._remote_hosts[2].ip6,
1362 tgt_ip=self.pg0.local_ip6)
1365 # ... and that we have an entry in the ND cache
1367 self.assertTrue(find_nbr(self,
1368 self.pg1.sw_if_index,
1369 self.pg0._remote_hosts[2].ip6))
1372 # ... and we can route traffic to it
1374 t = (Ether(dst=self.pg0.local_mac, src=self.pg0.remote_mac) /
1375 IPv6(dst=self.pg0._remote_hosts[2].ip6,
1376 src=self.pg0.remote_ip6) /
1377 inet6.UDP(sport=10000, dport=20000) /
1380 self.pg0.add_stream(t)
1381 self.pg_enable_capture(self.pg_interfaces)
1383 rx = self.pg1.get_capture(1)
1386 self.assertEqual(rx[Ether].dst, self.pg0._remote_hosts[2].mac)
1387 self.assertEqual(rx[Ether].src, self.pg1.local_mac)
1389 self.assertEqual(rx[IPv6].src,
1391 self.assertEqual(rx[IPv6].dst,
1395 # Test we proxy for the host on the main interface
1397 ns_pg0 = (Ether(dst=in6_getnsmac(nsma), src=self.pg0.remote_mac) /
1398 IPv6(dst=d, src=self.pg0.remote_ip6) /
1400 tgt=self.pg0._remote_hosts[2].ip6) /
1401 ICMPv6NDOptSrcLLAddr(
1402 lladdr=self.pg0.remote_mac))
1404 self.send_and_expect_na(self.pg0, ns_pg0,
1405 "NS to proxy entry on main",
1406 tgt_ip=self.pg0._remote_hosts[2].ip6,
1407 dst_ip=self.pg0.remote_ip6)
1410 # Setup and resolve proxy for another host on another interface
1412 ns_pg2 = (Ether(dst=in6_getnsmac(nsma), src=self.pg2.remote_mac) /
1414 src=self.pg0._remote_hosts[3].ip6) /
1415 ICMPv6ND_NS(tgt=self.pg0.local_ip6) /
1416 ICMPv6NDOptSrcLLAddr(
1417 lladdr=self.pg0._remote_hosts[2].mac))
1419 self.vapi.ip6nd_proxy_add_del(
1420 ip=inet_pton(AF_INET6, self.pg0._remote_hosts[3].ip6),
1421 sw_if_index=self.pg2.sw_if_index)
1423 self.send_and_expect_na(self.pg2, ns_pg2,
1424 "NS to proxy entry other interface",
1425 dst_ip=self.pg0._remote_hosts[3].ip6,
1426 tgt_ip=self.pg0.local_ip6)
1428 self.assertTrue(find_nbr(self,
1429 self.pg2.sw_if_index,
1430 self.pg0._remote_hosts[3].ip6))
1433 # hosts can communicate. pg2->pg1
1435 t2 = (Ether(dst=self.pg2.local_mac,
1436 src=self.pg0.remote_hosts[3].mac) /
1437 IPv6(dst=self.pg0._remote_hosts[2].ip6,
1438 src=self.pg0._remote_hosts[3].ip6) /
1439 inet6.UDP(sport=10000, dport=20000) /
1442 self.pg2.add_stream(t2)
1443 self.pg_enable_capture(self.pg_interfaces)
1445 rx = self.pg1.get_capture(1)
1448 self.assertEqual(rx[Ether].dst, self.pg0._remote_hosts[2].mac)
1449 self.assertEqual(rx[Ether].src, self.pg1.local_mac)
1451 self.assertEqual(rx[IPv6].src,
1453 self.assertEqual(rx[IPv6].dst,
1457 # remove the proxy configs
1459 self.vapi.ip6nd_proxy_add_del(
1460 ip=inet_pton(AF_INET6, self.pg0._remote_hosts[2].ip6),
1461 sw_if_index=self.pg1.sw_if_index, is_del=1)
1462 self.vapi.ip6nd_proxy_add_del(
1463 ip=inet_pton(AF_INET6, self.pg0._remote_hosts[3].ip6),
1464 sw_if_index=self.pg2.sw_if_index, is_del=1)
1466 self.assertFalse(find_nbr(self,
1467 self.pg2.sw_if_index,
1468 self.pg0._remote_hosts[3].ip6))
1469 self.assertFalse(find_nbr(self,
1470 self.pg1.sw_if_index,
1471 self.pg0._remote_hosts[2].ip6))
1474 # no longer proxy-ing...
1476 self.send_and_assert_no_replies(self.pg0, ns_pg0, "Proxy unconfigured")
1477 self.send_and_assert_no_replies(self.pg1, ns_pg1, "Proxy unconfigured")
1478 self.send_and_assert_no_replies(self.pg2, ns_pg2, "Proxy unconfigured")
1481 # no longer forwarding. traffic generates NS out of the glean/main
1484 self.pg2.add_stream(t2)
1485 self.pg_enable_capture(self.pg_interfaces)
1488 rx = self.pg0.get_capture(1)
1490 self.assertTrue(rx[0].haslayer(ICMPv6ND_NS))
1493 class TestIPNull(VppTestCase):
1494 """ IPv6 routes via NULL """
1497 super(TestIPNull, self).setUp()
1499 # create 2 pg interfaces
1500 self.create_pg_interfaces(range(1))
1502 for i in self.pg_interfaces:
1508 super(TestIPNull, self).tearDown()
1509 for i in self.pg_interfaces:
1513 def test_ip_null(self):
1514 """ IP NULL route """
1516 p = (Ether(src=self.pg0.remote_mac,
1517 dst=self.pg0.local_mac) /
1518 IPv6(src=self.pg0.remote_ip6, dst="2001::1") /
1519 inet6.UDP(sport=1234, dport=1234) /
1523 # A route via IP NULL that will reply with ICMP unreachables
1525 ip_unreach = VppIpRoute(self, "2001::", 64, [], is_unreach=1, is_ip6=1)
1526 ip_unreach.add_vpp_config()
1528 self.pg0.add_stream(p)
1529 self.pg_enable_capture(self.pg_interfaces)
1532 rx = self.pg0.get_capture(1)
1534 icmp = rx[ICMPv6DestUnreach]
1536 # 0 = "No route to destination"
1537 self.assertEqual(icmp.code, 0)
1539 # ICMP is rate limited. pause a bit
1543 # A route via IP NULL that will reply with ICMP prohibited
1545 ip_prohibit = VppIpRoute(self, "2001::1", 128, [],
1546 is_prohibit=1, is_ip6=1)
1547 ip_prohibit.add_vpp_config()
1549 self.pg0.add_stream(p)
1550 self.pg_enable_capture(self.pg_interfaces)
1553 rx = self.pg0.get_capture(1)
1555 icmp = rx[ICMPv6DestUnreach]
1557 # 1 = "Communication with destination administratively prohibited"
1558 self.assertEqual(icmp.code, 1)
1561 class TestIPDisabled(VppTestCase):
1562 """ IPv6 disabled """
1565 super(TestIPDisabled, self).setUp()
1567 # create 2 pg interfaces
1568 self.create_pg_interfaces(range(2))
1572 self.pg0.config_ip6()
1573 self.pg0.resolve_ndp()
1575 # PG 1 is not IP enabled
1579 super(TestIPDisabled, self).tearDown()
1580 for i in self.pg_interfaces:
1584 def test_ip_disabled(self):
1589 # one accepting interface, pg0, 2 forwarding interfaces
1591 route_ff_01 = VppIpMRoute(
1595 MRouteEntryFlags.MFIB_ENTRY_FLAG_NONE,
1596 [VppMRoutePath(self.pg1.sw_if_index,
1597 MRouteItfFlags.MFIB_ITF_FLAG_ACCEPT),
1598 VppMRoutePath(self.pg0.sw_if_index,
1599 MRouteItfFlags.MFIB_ITF_FLAG_FORWARD)],
1601 route_ff_01.add_vpp_config()
1603 pu = (Ether(src=self.pg1.remote_mac,
1604 dst=self.pg1.local_mac) /
1605 IPv6(src="2001::1", dst=self.pg0.remote_ip6) /
1606 inet6.UDP(sport=1234, dport=1234) /
1608 pm = (Ether(src=self.pg1.remote_mac,
1609 dst=self.pg1.local_mac) /
1610 IPv6(src="2001::1", dst="ffef::1") /
1611 inet6.UDP(sport=1234, dport=1234) /
1615 # PG1 does not forward IP traffic
1617 self.send_and_assert_no_replies(self.pg1, pu, "IPv6 disabled")
1618 self.send_and_assert_no_replies(self.pg1, pm, "IPv6 disabled")
1623 self.pg1.config_ip6()
1626 # Now we get packets through
1628 self.pg1.add_stream(pu)
1629 self.pg_enable_capture(self.pg_interfaces)
1631 rx = self.pg0.get_capture(1)
1633 self.pg1.add_stream(pm)
1634 self.pg_enable_capture(self.pg_interfaces)
1636 rx = self.pg0.get_capture(1)
1641 self.pg1.unconfig_ip6()
1644 # PG1 does not forward IP traffic
1646 self.send_and_assert_no_replies(self.pg1, pu, "IPv6 disabled")
1647 self.send_and_assert_no_replies(self.pg1, pm, "IPv6 disabled")
1650 class TestIP6LoadBalance(VppTestCase):
1651 """ IPv6 Load-Balancing """
1654 super(TestIP6LoadBalance, self).setUp()
1656 self.create_pg_interfaces(range(5))
1658 mpls_tbl = VppMplsTable(self, 0)
1659 mpls_tbl.add_vpp_config()
1661 for i in self.pg_interfaces:
1668 for i in self.pg_interfaces:
1672 super(TestIP6LoadBalance, self).tearDown()
1674 def pg_send(self, input, pkts):
1675 self.vapi.cli("clear trace")
1676 input.add_stream(pkts)
1677 self.pg_enable_capture(self.pg_interfaces)
1680 def send_and_expect_load_balancing(self, input, pkts, outputs):
1681 self.pg_send(input, pkts)
1683 rx = oo._get_capture(1)
1684 self.assertNotEqual(0, len(rx))
1686 def send_and_expect_one_itf(self, input, pkts, itf):
1687 self.pg_send(input, pkts)
1688 rx = itf.get_capture(len(pkts))
1690 def test_ip6_load_balance(self):
1691 """ IPv6 Load-Balancing """
1694 # An array of packets that differ only in the destination port
1698 # - MPLS non-EOS with an entropy label
1702 port_mpls_neos_pkts = []
1706 # An array of packets that differ only in the source address
1711 for ii in range(65):
1713 IPv6(dst="3000::1", src="3000:1::1") /
1714 inet6.UDP(sport=1234, dport=1234 + ii) /
1716 port_ip_pkts.append((Ether(src=self.pg0.remote_mac,
1717 dst=self.pg0.local_mac) /
1719 port_mpls_pkts.append((Ether(src=self.pg0.remote_mac,
1720 dst=self.pg0.local_mac) /
1721 MPLS(label=66, ttl=2) /
1723 port_mpls_neos_pkts.append((Ether(src=self.pg0.remote_mac,
1724 dst=self.pg0.local_mac) /
1725 MPLS(label=67, ttl=2) /
1726 MPLS(label=77, ttl=2) /
1728 port_ent_pkts.append((Ether(src=self.pg0.remote_mac,
1729 dst=self.pg0.local_mac) /
1730 MPLS(label=67, ttl=2) /
1731 MPLS(label=14, ttl=2) /
1732 MPLS(label=999, ttl=2) /
1735 IPv6(dst="3000::1", src="3000:1::%d" % ii) /
1736 inet6.UDP(sport=1234, dport=1234) /
1738 src_ip_pkts.append((Ether(src=self.pg0.remote_mac,
1739 dst=self.pg0.local_mac) /
1741 src_mpls_pkts.append((Ether(src=self.pg0.remote_mac,
1742 dst=self.pg0.local_mac) /
1743 MPLS(label=66, ttl=2) /
1747 # A route for the IP packets
1749 route_3000_1 = VppIpRoute(self, "3000::1", 128,
1750 [VppRoutePath(self.pg1.remote_ip6,
1751 self.pg1.sw_if_index,
1752 proto=DpoProto.DPO_PROTO_IP6),
1753 VppRoutePath(self.pg2.remote_ip6,
1754 self.pg2.sw_if_index,
1755 proto=DpoProto.DPO_PROTO_IP6)],
1757 route_3000_1.add_vpp_config()
1760 # a local-label for the EOS packets
1762 binding = VppMplsIpBind(self, 66, "3000::1", 128, is_ip6=1)
1763 binding.add_vpp_config()
1766 # An MPLS route for the non-EOS packets
1768 route_67 = VppMplsRoute(self, 67, 0,
1769 [VppRoutePath(self.pg1.remote_ip6,
1770 self.pg1.sw_if_index,
1772 proto=DpoProto.DPO_PROTO_IP6),
1773 VppRoutePath(self.pg2.remote_ip6,
1774 self.pg2.sw_if_index,
1776 proto=DpoProto.DPO_PROTO_IP6)])
1777 route_67.add_vpp_config()
1780 # inject the packet on pg0 - expect load-balancing across the 2 paths
1781 # - since the default hash config is to use IP src,dst and port
1783 # We are not going to ensure equal amounts of packets across each link,
1784 # since the hash algorithm is statistical and therefore this can never
1785 # be guaranteed. But with 64 different packets we do expect some
1786 # balancing. So instead just ensure there is traffic on each link.
1788 self.send_and_expect_load_balancing(self.pg0, port_ip_pkts,
1789 [self.pg1, self.pg2])
1790 self.send_and_expect_load_balancing(self.pg0, src_ip_pkts,
1791 [self.pg1, self.pg2])
1792 self.send_and_expect_load_balancing(self.pg0, port_mpls_pkts,
1793 [self.pg1, self.pg2])
1794 self.send_and_expect_load_balancing(self.pg0, src_mpls_pkts,
1795 [self.pg1, self.pg2])
1796 self.send_and_expect_load_balancing(self.pg0, port_mpls_neos_pkts,
1797 [self.pg1, self.pg2])
1800 # The packets with Entropy label in should not load-balance,
1801 # since the Entropy value is fixed.
1803 self.send_and_expect_one_itf(self.pg0, port_ent_pkts, self.pg1)
1806 # change the flow hash config so it's only IP src,dst
1807 # - now only the stream with differing source address will
1810 self.vapi.set_ip_flow_hash(vrf_id=0, src=1, dst=1, sport=0, dport=0,
1813 self.send_and_expect_load_balancing(self.pg0, src_ip_pkts,
1814 [self.pg1, self.pg2])
1815 self.send_and_expect_load_balancing(self.pg0, src_mpls_pkts,
1816 [self.pg1, self.pg2])
1817 self.send_and_expect_one_itf(self.pg0, port_ip_pkts, self.pg2)
1820 # change the flow hash config back to defaults
1822 self.vapi.set_ip_flow_hash(vrf_id=0, src=1, dst=1, sport=1, dport=1,
1826 # Recursive prefixes
1827 # - testing that 2 stages of load-balancing occurs and there is no
1828 # polarisation (i.e. only 2 of 4 paths are used)
1833 for ii in range(257):
1834 port_pkts.append((Ether(src=self.pg0.remote_mac,
1835 dst=self.pg0.local_mac) /
1838 inet6.UDP(sport=1234,
1841 src_pkts.append((Ether(src=self.pg0.remote_mac,
1842 dst=self.pg0.local_mac) /
1844 src="4000:1::%d" % ii) /
1845 inet6.UDP(sport=1234, dport=1234) /
1848 route_3000_2 = VppIpRoute(self, "3000::2", 128,
1849 [VppRoutePath(self.pg3.remote_ip6,
1850 self.pg3.sw_if_index,
1851 proto=DpoProto.DPO_PROTO_IP6),
1852 VppRoutePath(self.pg4.remote_ip6,
1853 self.pg4.sw_if_index,
1854 proto=DpoProto.DPO_PROTO_IP6)],
1856 route_3000_2.add_vpp_config()
1858 route_4000_1 = VppIpRoute(self, "4000::1", 128,
1859 [VppRoutePath("3000::1",
1861 proto=DpoProto.DPO_PROTO_IP6),
1862 VppRoutePath("3000::2",
1864 proto=DpoProto.DPO_PROTO_IP6)],
1866 route_4000_1.add_vpp_config()
1869 # inject the packet on pg0 - expect load-balancing across all 4 paths
1871 self.vapi.cli("clear trace")
1872 self.send_and_expect_load_balancing(self.pg0, port_pkts,
1873 [self.pg1, self.pg2,
1874 self.pg3, self.pg4])
1875 self.send_and_expect_load_balancing(self.pg0, src_pkts,
1876 [self.pg1, self.pg2,
1877 self.pg3, self.pg4])
1880 # Recursive prefixes
1881 # - testing that 2 stages of load-balancing no choices
1885 for ii in range(257):
1886 port_pkts.append((Ether(src=self.pg0.remote_mac,
1887 dst=self.pg0.local_mac) /
1890 inet6.UDP(sport=1234,
1894 route_5000_2 = VppIpRoute(self, "5000::2", 128,
1895 [VppRoutePath(self.pg3.remote_ip6,
1896 self.pg3.sw_if_index,
1897 proto=DpoProto.DPO_PROTO_IP6)],
1899 route_5000_2.add_vpp_config()
1901 route_6000_1 = VppIpRoute(self, "6000::1", 128,
1902 [VppRoutePath("5000::2",
1904 proto=DpoProto.DPO_PROTO_IP6)],
1906 route_6000_1.add_vpp_config()
1909 # inject the packet on pg0 - expect load-balancing across all 4 paths
1911 self.vapi.cli("clear trace")
1912 self.send_and_expect_one_itf(self.pg0, port_pkts, self.pg3)
1915 class TestIP6Punt(VppTestCase):
1916 """ IPv6 Punt Police/Redirect """
1919 super(TestIP6Punt, self).setUp()
1921 self.create_pg_interfaces(range(4))
1923 for i in self.pg_interfaces:
1929 super(TestIP6Punt, self).tearDown()
1930 for i in self.pg_interfaces:
1934 def test_ip_punt(self):
1935 """ IP6 punt police and redirect """
1937 p = (Ether(src=self.pg0.remote_mac,
1938 dst=self.pg0.local_mac) /
1939 IPv6(src=self.pg0.remote_ip6,
1940 dst=self.pg0.local_ip6) /
1941 inet6.TCP(sport=1234, dport=1234) /
1947 # Configure a punt redirect via pg1.
1949 nh_addr = self.pg1.remote_ip6
1950 self.vapi.ip_punt_redirect(self.pg0.sw_if_index,
1951 self.pg1.sw_if_index,
1954 self.send_and_expect(self.pg0, pkts, self.pg1)
1959 policer = self.vapi.policer_add_del(b"ip6-punt", 400, 0, 10, 0,
1961 self.vapi.ip_punt_police(policer.policer_index, is_ip6=1)
1963 self.vapi.cli("clear trace")
1964 self.pg0.add_stream(pkts)
1965 self.pg_enable_capture(self.pg_interfaces)
1969 # the number of packet received should be greater than 0,
1970 # but not equal to the number sent, since some were policed
1972 rx = self.pg1._get_capture(1)
1973 self.assertGreater(len(rx), 0)
1974 self.assertLess(len(rx), len(pkts))
1977 # remove the policer. back to full rx
1979 self.vapi.ip_punt_police(policer.policer_index, is_add=0, is_ip6=1)
1980 self.vapi.policer_add_del(b"ip6-punt", 400, 0, 10, 0,
1981 rate_type=1, is_add=0)
1982 self.send_and_expect(self.pg0, pkts, self.pg1)
1985 # remove the redirect. expect full drop.
1987 self.vapi.ip_punt_redirect(self.pg0.sw_if_index,
1988 self.pg1.sw_if_index,
1991 self.send_and_assert_no_replies(self.pg0, pkts,
1992 "IP no punt config")
1995 # Add a redirect that is not input port selective
1997 self.vapi.ip_punt_redirect(0xffffffff,
1998 self.pg1.sw_if_index,
2000 self.send_and_expect(self.pg0, pkts, self.pg1)
2002 self.vapi.ip_punt_redirect(0xffffffff,
2003 self.pg1.sw_if_index,
2007 def test_ip_punt_dump(self):
2008 """ IP6 punt redirect dump"""
2011 # Configure a punt redirects
2013 nh_addr = self.pg3.remote_ip6
2014 self.vapi.ip_punt_redirect(self.pg0.sw_if_index,
2015 self.pg3.sw_if_index,
2017 self.vapi.ip_punt_redirect(self.pg1.sw_if_index,
2018 self.pg3.sw_if_index,
2020 self.vapi.ip_punt_redirect(self.pg2.sw_if_index,
2021 self.pg3.sw_if_index,
2025 # Dump pg0 punt redirects
2027 punts = self.vapi.ip_punt_redirect_dump(self.pg0.sw_if_index,
2030 self.assertEqual(p.punt.rx_sw_if_index, self.pg0.sw_if_index)
2033 # Dump punt redirects for all interfaces
2035 punts = self.vapi.ip_punt_redirect_dump(0xffffffff, is_ipv6=1)
2036 self.assertEqual(len(punts), 3)
2038 self.assertEqual(p.punt.tx_sw_if_index, self.pg3.sw_if_index)
2039 self.assertNotEqual(punts[1].punt.nh, self.pg3.remote_ip6)
2040 self.assertEqual(str(punts[2].punt.nh), '::')
2043 class TestIPDeag(VppTestCase):
2044 """ IPv6 Deaggregate Routes """
2047 super(TestIPDeag, self).setUp()
2049 self.create_pg_interfaces(range(3))
2051 for i in self.pg_interfaces:
2057 super(TestIPDeag, self).tearDown()
2058 for i in self.pg_interfaces:
2062 def test_ip_deag(self):
2063 """ IP Deag Routes """
2066 # Create a table to be used for:
2067 # 1 - another destination address lookup
2068 # 2 - a source address lookup
2070 table_dst = VppIpTable(self, 1, is_ip6=1)
2071 table_src = VppIpTable(self, 2, is_ip6=1)
2072 table_dst.add_vpp_config()
2073 table_src.add_vpp_config()
2076 # Add a route in the default table to point to a deag/
2077 # second lookup in each of these tables
2079 route_to_dst = VppIpRoute(self, "1::1", 128,
2083 proto=DpoProto.DPO_PROTO_IP6)],
2085 route_to_src = VppIpRoute(self, "1::2", 128,
2090 proto=DpoProto.DPO_PROTO_IP6)],
2092 route_to_dst.add_vpp_config()
2093 route_to_src.add_vpp_config()
2096 # packets to these destination are dropped, since they'll
2097 # hit the respective default routes in the second table
2099 p_dst = (Ether(src=self.pg0.remote_mac,
2100 dst=self.pg0.local_mac) /
2101 IPv6(src="5::5", dst="1::1") /
2102 inet6.TCP(sport=1234, dport=1234) /
2104 p_src = (Ether(src=self.pg0.remote_mac,
2105 dst=self.pg0.local_mac) /
2106 IPv6(src="2::2", dst="1::2") /
2107 inet6.TCP(sport=1234, dport=1234) /
2109 pkts_dst = p_dst * 257
2110 pkts_src = p_src * 257
2112 self.send_and_assert_no_replies(self.pg0, pkts_dst,
2114 self.send_and_assert_no_replies(self.pg0, pkts_src,
2118 # add a route in the dst table to forward via pg1
2120 route_in_dst = VppIpRoute(self, "1::1", 128,
2121 [VppRoutePath(self.pg1.remote_ip6,
2122 self.pg1.sw_if_index,
2123 proto=DpoProto.DPO_PROTO_IP6)],
2126 route_in_dst.add_vpp_config()
2128 self.send_and_expect(self.pg0, pkts_dst, self.pg1)
2131 # add a route in the src table to forward via pg2
2133 route_in_src = VppIpRoute(self, "2::2", 128,
2134 [VppRoutePath(self.pg2.remote_ip6,
2135 self.pg2.sw_if_index,
2136 proto=DpoProto.DPO_PROTO_IP6)],
2139 route_in_src.add_vpp_config()
2140 self.send_and_expect(self.pg0, pkts_src, self.pg2)
2143 # loop in the lookup DP
2145 route_loop = VppIpRoute(self, "3::3", 128,
2148 proto=DpoProto.DPO_PROTO_IP6)],
2150 route_loop.add_vpp_config()
2152 p_l = (Ether(src=self.pg0.remote_mac,
2153 dst=self.pg0.local_mac) /
2154 IPv6(src="3::4", dst="3::3") /
2155 inet6.TCP(sport=1234, dport=1234) /
2158 self.send_and_assert_no_replies(self.pg0, p_l * 257,
2162 class TestIP6Input(VppTestCase):
2163 """ IPv6 Input Exception Test Cases """
2166 super(TestIP6Input, self).setUp()
2168 self.create_pg_interfaces(range(2))
2170 for i in self.pg_interfaces:
2176 super(TestIP6Input, self).tearDown()
2177 for i in self.pg_interfaces:
2181 def test_ip_input_icmp_reply(self):
2182 """ IP6 Input Exception - Return ICMP (3,0) """
2184 # hop limit - ICMP replies
2186 p_version = (Ether(src=self.pg0.remote_mac,
2187 dst=self.pg0.local_mac) /
2188 IPv6(src=self.pg0.remote_ip6,
2189 dst=self.pg1.remote_ip6,
2191 inet6.UDP(sport=1234, dport=1234) /
2194 rx = self.send_and_expect(self.pg0, p_version * 65, self.pg0)
2196 icmp = rx[ICMPv6TimeExceeded]
2198 # 0: "hop limit exceeded in transit",
2199 self.assertEqual((icmp.type, icmp.code), (3, 0))
2201 icmpv6_data = '\x0a' * 18
2203 all_1s = "FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF"
2205 @parameterized.expand([
2206 # Name, src, dst, l4proto, msg, timeout
2207 ("src='iface', dst='iface'", None, None,
2208 inet6.UDP(sport=1234, dport=1234), "funky version", None),
2209 ("src='All 0's', dst='iface'", all_0s, None,
2210 ICMPv6EchoRequest(id=0xb, seq=5, data=icmpv6_data), None, 0.1),
2211 ("src='iface', dst='All 0's'", None, all_0s,
2212 ICMPv6EchoRequest(id=0xb, seq=5, data=icmpv6_data), None, 0.1),
2213 ("src='All 1's', dst='iface'", all_1s, None,
2214 ICMPv6EchoRequest(id=0xb, seq=5, data=icmpv6_data), None, 0.1),
2215 ("src='iface', dst='All 1's'", None, all_1s,
2216 ICMPv6EchoRequest(id=0xb, seq=5, data=icmpv6_data), None, 0.1),
2217 ("src='All 1's', dst='All 1's'", all_1s, all_1s,
2218 ICMPv6EchoRequest(id=0xb, seq=5, data=icmpv6_data), None, 0.1),
2221 def test_ip_input_no_replies(self, name, src, dst, l4, msg, timeout):
2223 self._testMethodDoc = 'IPv6 Input Exception - %s' % name
2225 p_version = (Ether(src=self.pg0.remote_mac,
2226 dst=self.pg0.local_mac) /
2227 IPv6(src=src or self.pg0.remote_ip6,
2228 dst=dst or self.pg1.remote_ip6,
2233 self.send_and_assert_no_replies(self.pg0, p_version * 65,
2238 if __name__ == '__main__':
2239 unittest.main(testRunner=VppTestRunner)