6 from framework import VppTestCase, VppTestRunner
7 from vpp_sub_interface import VppSubInterface, VppDot1QSubint, VppDot1ADSubint
9 from scapy.packet import Raw
10 from scapy.layers.l2 import Ether, Dot1Q
11 from scapy.layers.inet import IP, UDP
15 class TestIPv4(VppTestCase):
16 """ IPv4 Test Case """
20 Perform test setup before test case.
23 - create 3 pg interfaces
24 - untagged pg0 interface
25 - Dot1Q subinterface on pg1
26 - Dot1AD subinterface on pg2
28 - put it into UP state
30 - resolve neighbor address using ARP
31 - configure 200 fib entries
33 :ivar list interfaces: pg interfaces and subinterfaces.
34 :ivar dict flows: IPv4 packet flows in test.
35 :ivar list pg_if_packet_sizes: packet sizes in test.
37 super(TestIPv4, self).setUp()
39 # create 3 pg interfaces
40 self.create_pg_interfaces(range(3))
42 # create 2 subinterfaces for pg1 and pg2
43 self.sub_interfaces = [
44 VppDot1QSubint(self, self.pg1, 100),
45 VppDot1ADSubint(self, self.pg2, 200, 300, 400)]
47 # packet flows mapping pg0 -> pg1.sub, pg2.sub, etc.
49 self.flows[self.pg0] = [self.pg1.sub_if, self.pg2.sub_if]
50 self.flows[self.pg1.sub_if] = [self.pg0, self.pg2.sub_if]
51 self.flows[self.pg2.sub_if] = [self.pg0, self.pg1.sub_if]
54 self.pg_if_packet_sizes = [64, 512, 1518, 9018]
55 self.sub_if_packet_sizes = [64, 512, 1518 + 4, 9018 + 4]
57 self.interfaces = list(self.pg_interfaces)
58 self.interfaces.extend(self.sub_interfaces)
60 # setup all interfaces
61 for i in self.interfaces:
66 # config 2M FIB entries
67 self.config_fib_entries(200)
70 """Run standard test teardown and log ``show ip arp``."""
71 super(TestIPv4, self).tearDown()
73 self.logger.info(self.vapi.cli("show ip arp"))
74 # info(self.vapi.cli("show ip fib")) # many entries
76 def config_fib_entries(self, count):
77 """For each interface add to the FIB table *count* routes to
78 "10.0.0.1/32" destination with interface's local address as next-hop
81 :param int count: Number of FIB entries.
83 - *TODO:* check if the next-hop address shouldn't be remote address
84 instead of local address.
86 n_int = len(self.interfaces)
89 dest_addr = socket.inet_pton(socket.AF_INET, "10.0.0.1")
91 for i in self.interfaces:
92 next_hop_address = i.local_ip4n
93 for j in range(count / n_int):
94 self.vapi.ip_add_del_route(
95 dest_addr, dest_addr_len, next_hop_address)
97 if counter / count * 100 > percent:
98 self.logger.info("Configure %d FIB entries .. %d%% done" %
102 def create_stream(self, src_if, packet_sizes):
103 """Create input packet stream for defined interface.
105 :param VppInterface src_if: Interface to create packet stream for.
106 :param list packet_sizes: Required packet sizes.
109 for i in range(0, 257):
110 dst_if = self.flows[src_if][i % 2]
111 info = self.create_packet_info(src_if, dst_if)
112 payload = self.info_to_payload(info)
113 p = (Ether(dst=src_if.local_mac, src=src_if.remote_mac) /
114 IP(src=src_if.remote_ip4, dst=dst_if.remote_ip4) /
115 UDP(sport=1234, dport=1234) /
118 if isinstance(src_if, VppSubInterface):
119 p = src_if.add_dot1_layer(p)
120 size = packet_sizes[(i // 2) % len(packet_sizes)]
121 self.extend_packet(p, size)
125 def verify_capture(self, dst_if, capture):
126 """Verify captured input packet stream for defined interface.
128 :param VppInterface dst_if: Interface to verify captured packet stream
130 :param list capture: Captured packet stream.
132 self.logger.info("Verifying capture on interface %s" % dst_if.name)
134 for i in self.interfaces:
135 last_info[i.sw_if_index] = None
137 dst_sw_if_index = dst_if.sw_if_index
138 if hasattr(dst_if, 'parent'):
140 for packet in capture:
142 # Check VLAN tags and Ethernet header
143 packet = dst_if.remove_dot1_layer(packet)
144 self.assertTrue(Dot1Q not in packet)
148 payload_info = self.payload_to_info(str(packet[Raw]))
149 packet_index = payload_info.index
150 self.assertEqual(payload_info.dst, dst_sw_if_index)
151 self.logger.debug("Got packet on port %s: src=%u (id=%u)" %
152 (dst_if.name, payload_info.src, packet_index))
153 next_info = self.get_next_packet_info_for_interface2(
154 payload_info.src, dst_sw_if_index,
155 last_info[payload_info.src])
156 last_info[payload_info.src] = next_info
157 self.assertTrue(next_info is not None)
158 self.assertEqual(packet_index, next_info.index)
159 saved_packet = next_info.data
160 # Check standard fields
161 self.assertEqual(ip.src, saved_packet[IP].src)
162 self.assertEqual(ip.dst, saved_packet[IP].dst)
163 self.assertEqual(udp.sport, saved_packet[UDP].sport)
164 self.assertEqual(udp.dport, saved_packet[UDP].dport)
166 self.logger.error(ppp("Unexpected or invalid packet:", packet))
168 for i in self.interfaces:
169 remaining_packet = self.get_next_packet_info_for_interface2(
170 i.sw_if_index, dst_sw_if_index, last_info[i.sw_if_index])
171 self.assertTrue(remaining_packet is None,
172 "Interface %s: Packet expected from interface %s "
173 "didn't arrive" % (dst_if.name, i.name))
180 - Create IPv4 stream for pg0 interface
181 - Create IPv4 tagged streams for pg1's and pg2's subinterface.
182 - Send and verify received packets on each interface.
185 pkts = self.create_stream(self.pg0, self.pg_if_packet_sizes)
186 self.pg0.add_stream(pkts)
188 for i in self.sub_interfaces:
189 pkts = self.create_stream(i, self.sub_if_packet_sizes)
190 i.parent.add_stream(pkts)
192 self.pg_enable_capture(self.pg_interfaces)
195 pkts = self.pg0.get_capture()
196 self.verify_capture(self.pg0, pkts)
198 for i in self.sub_interfaces:
199 pkts = i.parent.get_capture()
200 self.verify_capture(i, pkts)
203 class TestIPv4FibCrud(VppTestCase):
204 """ FIB - add/update/delete - ip4 routes
212 ..note:: Python API is to slow to add many routes, needs C code replacement.
215 def config_fib_many_to_one(self, start_dest_addr, next_hop_addr, count):
218 :param start_dest_addr:
219 :param next_hop_addr:
221 :return list: added ips with 32 prefix
225 socket.inet_pton(socket.AF_INET, start_dest_addr).encode('hex'), 16)
227 n_next_hop_addr = socket.inet_pton(socket.AF_INET, next_hop_addr)
228 for _ in range(count):
229 n_dest_addr = '{:08x}'.format(dest_addr).decode('hex')
230 self.vapi.ip_add_del_route(n_dest_addr, dest_addr_len,
232 added_ips.append(socket.inet_ntoa(n_dest_addr))
236 def unconfig_fib_many_to_one(self, start_dest_addr, next_hop_addr, count):
240 socket.inet_pton(socket.AF_INET, start_dest_addr).encode('hex'), 16)
242 n_next_hop_addr = socket.inet_pton(socket.AF_INET, next_hop_addr)
243 for _ in range(count):
244 n_dest_addr = '{:08x}'.format(dest_addr).decode('hex')
245 self.vapi.ip_add_del_route(n_dest_addr, dest_addr_len,
246 n_next_hop_addr, is_add=0)
247 removed_ips.append(socket.inet_ntoa(n_dest_addr))
251 def create_stream(self, src_if, dst_if, dst_ips, count):
254 for _ in range(count):
255 dst_addr = random.choice(dst_ips)
256 info = self.create_packet_info(src_if, dst_if)
257 payload = self.info_to_payload(info)
258 p = (Ether(dst=src_if.local_mac, src=src_if.remote_mac) /
259 IP(src=src_if.remote_ip4, dst=dst_addr) /
260 UDP(sport=1234, dport=1234) /
263 self.extend_packet(p, random.choice(self.pg_if_packet_sizes))
268 def _find_ip_match(self, find_in, pkt):
270 if self.payload_to_info(str(p[Raw])) == \
271 self.payload_to_info(str(pkt[Raw])):
272 if p[IP].src != pkt[IP].src:
274 if p[IP].dst != pkt[IP].dst:
276 if p[UDP].sport != pkt[UDP].sport:
278 if p[UDP].dport != pkt[UDP].dport:
284 def _match_route_detail(route_detail, ip, address_length=32, table_id=0):
285 if route_detail.address == socket.inet_pton(socket.AF_INET, ip):
286 if route_detail.table_id != table_id:
288 elif route_detail.address_length != address_length:
295 def verify_capture(self, dst_interface, received_pkts, expected_pkts):
296 self.assertEqual(len(received_pkts), len(expected_pkts))
297 to_verify = list(expected_pkts)
298 for p in received_pkts:
299 self.assertEqual(p.src, dst_interface.local_mac)
300 self.assertEqual(p.dst, dst_interface.remote_mac)
301 x = self._find_ip_match(to_verify, p)
303 self.assertListEqual(to_verify, [])
305 def verify_route_dump(self, fib_dump, ips):
307 def _ip_in_route_dump(ip, fib_dump):
308 return next((route for route in fib_dump
309 if self._match_route_detail(route, ip)),
313 self.assertTrue(_ip_in_route_dump(ip, fib_dump),
314 'IP {} is not in fib dump.'.format(ip))
316 def verify_not_in_route_dump(self, fib_dump, ips):
318 def _ip_in_route_dump(ip, fib_dump):
319 return next((route for route in fib_dump
320 if self._match_route_detail(route, ip)),
324 self.assertFalse(_ip_in_route_dump(ip, fib_dump),
325 'IP {} is in fib dump.'.format(ip))
330 #. Create and initialize 3 pg interfaces.
331 #. initialize class attributes configured_routes and deleted_routes
332 to store information between tests.
334 super(TestIPv4FibCrud, cls).setUpClass()
337 # create 3 pg interfaces
338 cls.create_pg_interfaces(range(3))
340 cls.interfaces = list(cls.pg_interfaces)
342 # setup all interfaces
343 for i in cls.interfaces:
348 cls.configured_routes = []
349 cls.deleted_routes = []
350 cls.pg_if_packet_sizes = [64, 512, 1518, 9018]
353 super(TestIPv4FibCrud, cls).tearDownClass()
357 super(TestIPv4FibCrud, self).setUp()
358 self.reset_packet_infos()
360 def test_1_add_routes(self):
363 - add 100 routes check with traffic script.
365 # config 1M FIB entries
366 self.configured_routes.extend(self.config_fib_many_to_one(
367 "10.0.0.0", self.pg0.remote_ip4, 100))
369 fib_dump = self.vapi.ip_fib_dump()
370 self.verify_route_dump(fib_dump, self.configured_routes)
372 self.stream_1 = self.create_stream(
373 self.pg1, self.pg0, self.configured_routes, 100)
374 self.stream_2 = self.create_stream(
375 self.pg2, self.pg0, self.configured_routes, 100)
376 self.pg1.add_stream(self.stream_1)
377 self.pg2.add_stream(self.stream_2)
379 self.pg_enable_capture(self.pg_interfaces)
382 pkts = self.pg0.get_capture(len(self.stream_1) + len(self.stream_2))
383 self.verify_capture(self.pg0, pkts, self.stream_1 + self.stream_2)
385 def test_2_del_routes(self):
386 """ Delete 100 routes
388 - delete 10 routes check with traffic script.
390 self.deleted_routes.extend(self.unconfig_fib_many_to_one(
391 "10.0.0.10", self.pg0.remote_ip4, 10))
392 for x in self.deleted_routes:
393 self.configured_routes.remove(x)
395 fib_dump = self.vapi.ip_fib_dump()
396 self.verify_route_dump(fib_dump, self.configured_routes)
398 self.stream_1 = self.create_stream(
399 self.pg1, self.pg0, self.configured_routes, 100)
400 self.stream_2 = self.create_stream(
401 self.pg2, self.pg0, self.configured_routes, 100)
402 self.stream_3 = self.create_stream(
403 self.pg1, self.pg0, self.deleted_routes, 100)
404 self.stream_4 = self.create_stream(
405 self.pg2, self.pg0, self.deleted_routes, 100)
406 self.pg1.add_stream(self.stream_1 + self.stream_3)
407 self.pg2.add_stream(self.stream_2 + self.stream_4)
408 self.pg_enable_capture(self.pg_interfaces)
411 pkts = self.pg0.get_capture(len(self.stream_1) + len(self.stream_2))
412 self.verify_capture(self.pg0, pkts, self.stream_1 + self.stream_2)
414 def test_3_add_new_routes(self):
417 - re-add 5 routes check with traffic script.
418 - add 100 routes check with traffic script.
420 tmp = self.config_fib_many_to_one(
421 "10.0.0.10", self.pg0.remote_ip4, 5)
422 self.configured_routes.extend(tmp)
424 self.deleted_routes.remove(x)
426 self.configured_routes.extend(self.config_fib_many_to_one(
427 "10.0.1.0", self.pg0.remote_ip4, 100))
429 fib_dump = self.vapi.ip_fib_dump()
430 self.verify_route_dump(fib_dump, self.configured_routes)
432 self.stream_1 = self.create_stream(
433 self.pg1, self.pg0, self.configured_routes, 300)
434 self.stream_2 = self.create_stream(
435 self.pg2, self.pg0, self.configured_routes, 300)
436 self.stream_3 = self.create_stream(
437 self.pg1, self.pg0, self.deleted_routes, 100)
438 self.stream_4 = self.create_stream(
439 self.pg2, self.pg0, self.deleted_routes, 100)
441 self.pg1.add_stream(self.stream_1 + self.stream_3)
442 self.pg2.add_stream(self.stream_2 + self.stream_4)
443 self.pg_enable_capture(self.pg_interfaces)
446 pkts = self.pg0.get_capture(len(self.stream_1) + len(self.stream_2))
447 self.verify_capture(self.pg0, pkts, self.stream_1 + self.stream_2)
449 def test_4_del_routes(self):
450 """ Delete 1.5k routes
452 - delete 5 routes check with traffic script.
453 - add 100 routes check with traffic script.
455 self.deleted_routes.extend(self.unconfig_fib_many_to_one(
456 "10.0.0.0", self.pg0.remote_ip4, 15))
457 self.deleted_routes.extend(self.unconfig_fib_many_to_one(
458 "10.0.0.20", self.pg0.remote_ip4, 85))
459 self.deleted_routes.extend(self.unconfig_fib_many_to_one(
460 "10.0.1.0", self.pg0.remote_ip4, 100))
461 fib_dump = self.vapi.ip_fib_dump()
462 self.verify_not_in_route_dump(fib_dump, self.deleted_routes)
465 if __name__ == '__main__':
466 unittest.main(testRunner=VppTestRunner)