2 """CRUD tests of APIs (Create, Read, Update, Delete) HLD:
4 - interface up/down/add/delete - interface type:
10 - tuntap (root privileges needed)
16 from scapy.layers.inet import IP, ICMP
17 from scapy.layers.l2 import Ether
19 from framework import VppTestCase, VppTestRunner
22 class TestLoopbackInterfaceCRUD(VppTestCase):
27 super(TestLoopbackInterfaceCRUD, cls).setUpClass()
29 cls.create_pg_interfaces(range(1))
30 for i in cls.pg_interfaces:
31 i.config_ip4().resolve_arp()
37 def tearDownClass(cls):
38 super(TestLoopbackInterfaceCRUD, cls).tearDownClass()
41 def create_icmp_stream(src_if, dst_ifs):
44 :param VppInterface src_if: Packets are send to this interface,
45 using this interfaces remote host.
46 :param list dst_ifs: IPv4 ICMP requests are send to interfaces
48 :return: List of generated packets.
53 Ether(dst=src_if.local_mac, src=src_if.remote_mac)
54 / IP(src=src_if.remote_ip4, dst=i.local_ip4)
55 / ICMP(id=i.sw_if_index, type="echo-request")
60 def verify_icmp(self, capture, request_src_if, dst_ifs):
63 :param capture: Capture to verify.
64 :param VppInterface request_src_if: Interface where was send packets.
65 :param list dst_ifs: Interfaces where was generated IPv4 ICMP requests.
75 info = (ip.src, ip.dst, icmp.type, icmp.id)
76 rcvd_icmp_pkts.append(info)
79 # 0 - icmp echo response
80 info = (i.local_ip4, request_src_if.remote_ip4, 0, i.sw_if_index)
81 self.assertIn(info, rcvd_icmp_pkts)
85 loopbacks = self.create_loopback_interfaces(20)
87 i.local_ip4_prefix_len = 32
88 i.config_ip4().admin_up()
90 # read (check sw if dump, ip4 fib, ip6 fib)
91 if_dump = self.vapi.sw_interface_dump(
92 name_filter_valid=True, name_filter="loop"
94 fib4_dump = self.vapi.ip_route_dump(0)
96 self.assertTrue(i.is_interface_config_in_dump(if_dump))
97 self.assertTrue(i.is_ip4_entry_in_fib_dump(fib4_dump))
99 if_dump = self.vapi.sw_interface_dump(
100 name_filter_valid=True, name_filter="loopXYZ"
102 self.assertEqual(len(if_dump), 0)
105 stream = self.create_icmp_stream(self.pg0, loopbacks)
106 self.pg0.add_stream(stream)
107 self.pg_enable_capture(self.pg_interfaces)
109 capture = self.pg0.get_capture(expected_count=len(stream))
111 self.verify_icmp(capture, self.pg0, loopbacks)
115 i.remove_vpp_config()
117 # read (check not in sw if dump, ip4 fib, ip6 fib)
118 if_dump = self.vapi.sw_interface_dump()
119 fib4_dump = self.vapi.ip_route_dump(0)
121 self.assertFalse(i.is_interface_config_in_dump(if_dump))
122 self.assertFalse(i.is_ip4_entry_in_fib_dump(fib4_dump))
125 stream = self.create_icmp_stream(self.pg0, loopbacks)
126 self.pg0.add_stream(stream)
127 self.pg_enable_capture(self.pg_interfaces)
129 self.pg0.assert_nothing_captured()
133 loopbacks = self.create_loopback_interfaces(20)
135 i.local_ip4_prefix_len = 32
136 i.config_ip4().admin_up()
140 i.admin_down().unconfig_ip4()
142 # read (check not in sw if dump, ip4 fib, ip6 fib)
143 if_dump = self.vapi.sw_interface_dump()
144 fib4_dump = self.vapi.ip_route_dump(0)
146 self.assertTrue(i.is_interface_config_in_dump(if_dump))
147 self.assertFalse(i.is_ip4_entry_in_fib_dump(fib4_dump))
150 stream = self.create_icmp_stream(self.pg0, loopbacks)
151 self.pg0.add_stream(stream)
152 self.pg_enable_capture(self.pg_interfaces)
154 self.pg0.assert_nothing_captured()
157 class TestInterfaceDumpApiLocalOnly(VppTestCase):
158 """test_interface_crud.TestInterfaceDumpApiLocalOnly"""
160 def test_sw_if_index_0(self):
161 rv = self.vapi.sw_interface_dump(sw_if_index=0)
162 self.assertEqual(rv[0].sw_if_index, 0)
164 def test_sw_if_index_twiddle0(self):
165 rv = self.vapi.sw_interface_dump(sw_if_index=0xFFFFFFFF)
166 self.assertEqual(rv[0].sw_if_index, 0)
168 def test_sw_if_index_1_not_existing(self):
169 rv = self.vapi.sw_interface_dump(sw_if_index=1)
170 self.assertEqual(len(rv), 0, "expected no records.")
173 class TestInterfaceDumpApi(VppTestCase):
174 """test_interface_crud.TestInterfaceDumpApi"""
176 def test_sw_if_index_1(self):
177 self.vapi.create_loopback_instance(is_specified=1, user_instance=10)
178 self.vapi.create_loopback_instance(is_specified=1, user_instance=5)
180 # Can I get back the specified record?
181 rv = self.vapi.sw_interface_dump(sw_if_index=1)
182 self.assertEqual(rv[0].sw_if_index, 1, rv)
184 # verify 3 interfaces
185 rv = self.vapi.sw_interface_dump(sw_if_index=0xFFFFFFFF)
186 self.assertEqual(len(rv), 3, "Expected 3 interfaces.")
189 if __name__ == "__main__":
190 unittest.main(testRunner=VppTestRunner)