X-Git-Url: https://gerrit.fd.io/r/gitweb?p=csit.git;a=blobdiff_plain;f=docs%2Freport%2Fvpp_unit_tests%2Foverview.rst;fp=docs%2Freport%2Fvpp_unit_tests%2Foverview.rst;h=7c8210bb7f3f08fea2111e045e00f3b02e852e00;hp=0000000000000000000000000000000000000000;hb=da2aa127ee071e37bc4d6060dd39476179e65365;hpb=a1d482fcf9c221cda2f13429810bca945d9f09f4 diff --git a/docs/report/vpp_unit_tests/overview.rst b/docs/report/vpp_unit_tests/overview.rst new file mode 100644 index 0000000000..7c8210bb7f --- /dev/null +++ b/docs/report/vpp_unit_tests/overview.rst @@ -0,0 +1,61 @@ +Overview +======== + +.. note:: + + This section includes an abbreviated version of the VPP Test Framework + overview maintained within the VPP project. Complete overview can be found + in `VPP unit test documentation `_ + +VPP Unit Test Framework +----------------------- + +VPP Test Framework is used to ease writing, running and debugging unit tests +for the VPP. It is based on python as a high level language to allow rapid +test development. scapy\_ is used as a tool for creating and dissecting +packets. + +VPP Test Framework does not send any packets to VPP directly. Traffic is +instead injected using VPP packet-generator interfaces. Packets are written +into a temporary .pcap file, which is then read by the VPP code with packets +getting injected into the VPP processing nodes. + +Similarly, VPP does not send any packets to VPP Test Framework directly. +Instead, VPP packet capture feature is used to capture and write packets to a +temporary .pcap file, which is then read and analyzed by the VPP Test +Framework. + +For complete description of the VPP Test Framework including anatomy of a test +case and detailed documentation of existing VPP unit test cases please refer +to the `VPP unit test documentation `_ + +Unit Tests Coverage +------------------- + +Following VPP functional test areas are covered in VPP unit test code included +in VPP rls1701 with results listed in this report: + +- CRUD Loopback - create, read, update, delete Loopback interfaces. +- Flow-per-packet plugin - collect and report L2 and IP4 flow statistics. +- DHCP - DHCPv4 and DHCPv6 Proxy. +- IP4 VRF Multi-instance - create, read, update, delete and verify IPv4 VRFs. +- Load Balancer - IP4 GRE4, IP4 GRE6, IP6 GRE4, IP6 GRE6 +- Bidirectional Forwarding Detection (BFD) IPv4 - baseline BFD session operation. +- Bidirectional Forwarding Detection (BFD) IPv6 - baseline BFD session operation. +- Bidirectional Forwarding Detection (BFD) - API tests. +- Bidirectional Forwarding Detection (BFD) - changing authorization. +- Bidirectional Forwarding Detection (BFD) - SHA1 authentication. +- IPv6 Tests - baseline FIB operations, NS/RS exception handling. +- SPAN Test - Switched Port Analyzer packet mirroring. +- GRE Tests - GRE tunnel tests. +- SNAT Test Cases - SNAT44 tests. +- L2XC Multi-instance - L2 cross-connect multi-instance tests. +- IPv4 Tests - baseline FIB tests. +- IPv4 FIB CRUD - add/update/delete IPv4 routes. +- IRB Tests - Integrated Routing and Bridging tests. +- MPLS Tests - MPLS baseline tests. +- L2XC Tests - L2 cross-connect baseline tests incl. single- and dual-loop. +- Classifier - classification with IP ACL, MAC ACL, IP PBR. +- VXLAN Tests - baseline VXLAN tunneling. +- L2 FIB CRUD - add/update/delete L2 MAC entries. +- L2BD Tests - L2 Bridge-Domain baseline tests incl. single- and dual-loop.