.. |br| raw:: html

    <br />


.. |prein| raw:: html

    <pre>


.. |preout| raw:: html

    </pre>

Tap Interface
-------------

api-crud-tap-func
'''''''''''''''''

**Tap Interface CRUD Tests**  

 - **[Top] Network Topologies:** TG=DUT1 2-node topology with two links between nodes.  

 - **[Enc] Packet Encapsulations:** No packet sent.  

 - **[Cfg] DUT configuration:** Add/Modify/Delete linux-TAP on DUT1.  

 - **[Ver] Verification:** Check dump of tap interfaces for correctness.  

 - **[Ref] Applicable standard specifications:**

+---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name                                  | VPP API Test (VAT) Commands History - Commands Used Per Test Case                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
+=======================================+=======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| TC01: Tap Interface Modify And Delete |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| tap_connect tapname tap_int2 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_flags sw_if_index 6 admin-up |br| tap_modify sw_if_index 5 tapname tap_int1MOD |br| sw_interface_tap_dump |br| tap_delete sw_if_index 5 |br| sw_interface_tap_dump |br| sw_interface_tap_dump |br| tap_delete sw_if_index 6 |br| sw_interface_tap_dump |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+---------------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

eth2p-eth-l2bdbasemaclrn-eth-2tap-func
''''''''''''''''''''''''''''''''''''''

**Tap Interface Traffic Tests**  

 - **[Top] Network Topologies:** TG=DUT1 2-node topology with two links between nodes.  

 - **[Enc] Packet Encapsulations:** Eth-IPv4-ICMPv4 for L2 switching of IPv4.  

 - **[Cfg] DUT configuration:** DUT1 and DUT2 are configured with L2 bridge-domain (L2BD) MAC learning enabled; Split Horizon Groups (SHG) are set depending on test case; Namespaces (NM) are set on DUT1 with attached linux-TAP.  

 - **[Ver] TG verification:** Test ICMPv4 Echo Request packets are sent by TG on link to DUT1; On receipt TG verifies packets for correctness and their IPv4 src-addr, dst-addr, and MAC addresses.  

 - **[Ref] Applicable standard specifications:**

+-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name                          | VPP API Test (VAT) Commands History - Commands Used Per Test Case                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
+===============================+=================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| TC01: Tap Interface Simple BD |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| tap_connect tapname tap_int2 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_flags sw_if_index 6 admin-up |br| bridge_domain_add_del bd_id 19 flood 1 uu-flood 1 forward 1 learn 1 arp-term 0 |br| bridge_domain_add_del bd_id 20 flood 1 uu-flood 1 forward 1 learn 1 arp-term 0 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_l2_bridge sw_if_index 5 bd_id 20 shg 0 enable |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_l2_bridge sw_if_index 2 bd_id 20 shg 0 enable |br| sw_interface_set_flags sw_if_index 6 admin-up |br| sw_interface_set_l2_bridge sw_if_index 6 bd_id 19 shg 0 enable |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_set_l2_bridge sw_if_index 1 bd_id 19 shg 0 enable |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+-------------------------------+-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

eth2p-eth-l2bdbasemaclrn-l2shg-eth-2tap-func
''''''''''''''''''''''''''''''''''''''''''''

**Tap Interface Traffic Tests**  

 - **[Top] Network Topologies:** TG=DUT1 2-node topology with two links between nodes.  

 - **[Enc] Packet Encapsulations:** Eth-IPv4-ICMPv4 for L2 switching of IPv4.  

 - **[Cfg] DUT configuration:** DUT1 and DUT2 are configured with L2 bridge-domain (L2BD) MAC learning enabled; Split Horizon Groups (SHG) are set depending on test case; Namespaces (NM) are set on DUT1 with attached linux-TAP.  

 - **[Ver] TG verification:** Test ICMPv4 Echo Request packets are sent by TG on link to DUT1; On receipt TG verifies packets for correctness and their IPv4 src-addr, dst-addr, and MAC addresses.  

 - **[Ref] Applicable standard specifications:**

+--------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name                                             | VPP API Test (VAT) Commands History - Commands Used Per Test Case                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
+==================================================+======================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| TC01: Tap Interface BD - Different Split Horizon |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| tap_connect tapname tap_int2 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_flags sw_if_index 6 admin-up |br| bridge_domain_add_del bd_id 21 flood 1 uu-flood 1 forward 1 learn 1 arp-term 0 |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_l2_bridge sw_if_index 2 bd_id 21 shg 0 enable |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_l2_bridge sw_if_index 5 bd_id 21 shg 2 enable |br| sw_interface_set_flags sw_if_index 6 admin-up |br| sw_interface_set_l2_bridge sw_if_index 6 bd_id 21 shg 3 enable |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+--------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| TC02: Tap Interface BD - Same Split Horizon      |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| tap_connect tapname tap_int2 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_flags sw_if_index 6 admin-up |br| bridge_domain_add_del bd_id 21 flood 1 uu-flood 1 forward 1 learn 1 arp-term 0 |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_l2_bridge sw_if_index 2 bd_id 21 shg 0 enable |br| sw_interface_set_flags sw_if_index 5 admin-up |br| sw_interface_set_l2_bridge sw_if_index 5 bd_id 21 shg 2 enable |br| sw_interface_set_flags sw_if_index 6 admin-up |br| sw_interface_set_l2_bridge sw_if_index 6 bd_id 21 shg 2 enable |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+--------------------------------------------------+------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+

eth2p-ethip4-ip4base-eth-1tap-func
''''''''''''''''''''''''''''''''''

**Tap Interface Traffic Tests**  

 - **[Top] Network Topologies:** TG=DUT1 2-node topology with two links between nodes.  

 - **[Enc] Packet Encapsulations:** Eth-IPv4-ICMPv4 for L2 switching of IPv4.  

 - **[Cfg] DUT configuration:** DUT1 and DUT2 are configured with L2 bridge-domain (L2BD) MAC learning enabled; Split Horizon Groups (SHG) are set depending on test case; Namespaces (NM) are set on DUT1 with attached linux-TAP.  

 - **[Ver] TG verification:** Test ICMPv4 Echo Request packets are sent by TG on link to DUT1; On receipt TG verifies packets for correctness and their IPv4 src-addr, dst-addr, and MAC addresses.  

 - **[Ref] Applicable standard specifications:**

+-----------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| Name                                          | VPP API Test (VAT) Commands History - Commands Used Per Test Case                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
+===============================================+============================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================+
| TC01: Tap Interface IP Ping Without Namespace |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| sw_interface_add_del_address sw_if_index 5 16.0.10.1/24 |br| sw_interface_add_del_address sw_if_index 2 192.168.0.1/24 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| ip_neighbor_add_del sw_if_index 2 dst 192.168.0.2 mac fa:16:3e:6b:a9:9f |br| ip_neighbor_add_del sw_if_index 5 dst 16.0.10.2 mac 02:00:00:00:00:02 |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+-----------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+
| TC02: Tap Interface IP Ping With Namespace    |  |prein| **DUT1:** |br| sw_interface_set_flags sw_if_index 2 admin-up |br| sw_interface_set_flags sw_if_index 1 admin-up |br| sw_interface_dump |br| tap_connect tapname tap_int1 |br| sw_interface_add_del_address sw_if_index 5 16.0.10.1/24 |br| sw_interface_add_del_address sw_if_index 2 192.168.0.1/24 |br| sw_interface_set_flags sw_if_index 5 admin-up |br| ip_neighbor_add_del sw_if_index 2 dst 192.168.0.2 mac fa:16:3e:6b:a9:9f |br| ip_neighbor_add_del sw_if_index 5 dst 16.0.10.2 mac 02:00:00:00:00:02 |br|  |br| **DUT2:** |br| no VAT command executed |br|  |preout|  |
+-----------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------+