CSIT TAGs Descriptions
======================
-Documentation for tags used to select and identify test cases.
-
+All CSIT test cases are labelled with Robot Framework tags used to allow for
+easy test case type identification, test case grouping and selection for
+execution. Following sections list currently used CSIT TAGs and their
+documentation.
Topology TAGs
-------------
Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch)
and csit-vpp-verify jobs (i.e. CSIT patch).
+.. topic:: SKIP_VPP_PATCH
+
+ Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP patch).
Environment TAGs
----------------
DUTs with VPP and capable of running Virtual Machine.
-
NIC model tags
--------------
VIC-1385 by Cisco.
-
Scaling TAGs
------------
Traffic flow with 4000 unique IPs (users) in one direction.
+.. topic:: 100_FLOWS
+
+ Traffic stream with 100 unique flows (10 IPs/users x 10 UDP ports) in one
+ direction.
+
+.. topic:: 10k_FLOWS
+
+ Traffic stream with 10 000 unique flows (10 IPs/users x 1000 UDP ports) in
+ one direction.
+
+.. topic:: 100k_FLOWS
+
+ Traffic stream with 100 000 unique flows (100 IPs/users x 1000 UDP ports) in
+ one direction.
Tags marking functional vs. performance of tests
------------------------------------------------
All performance test cases.
-
Performance testing tags
------------------------
.. topic:: NDRPDRDISC
- Find performance of DUT based on RFC2544 with linear / binary / combined
+ Find performance of DUT based on :rfc:`2544` with linear / binary / combined
search. (Previous LONG tests.)
Ethernet frame size tags for performance tests
At least one feature is configured in test cases. Use also feature tag(s).
+.. topic:: TLDK
+
+ Functional test cases for TLDK.
Forwarding mode tags
--------------------
VPP IPv6 routed forwarding.
-
Underlay tags
-------------
MPLS underlay.
-
Overlay tags
------------
IPv6 overlay (IPv6 payload).
-
-Encapsulation tags
-------------------
-
-.. topic:: ETH
-
- All test cases with base Ethernet (no encapsulation).
+Tagging tags
+------------
.. topic:: DOT1Q
All test cases with dot1ad.
+Encapsulation tags
+------------------
+
+.. topic:: ETH
+
+ All test cases with base Ethernet (no encapsulation).
+
.. topic:: LISP
All test cases with LISP.
All test cases with IPSEC.
-
Interface tags
--------------
All test cases which uses VHOST.
+.. topic:: VHOST_256
+
+ All test cases which uses VHOST with qemu queue size set to 256.
+
+.. topic:: VHOST_1024
+
+ All test cases which uses VHOST with qemu queue size set to 1024.
+
+.. topic:: CFS_OPT
+
+ All test cases which uses VM with optimised scheduler policy.
+
.. topic:: TUNTAP
All test cases which uses TUN and TAP.
All test cases which uses Netmap.
+.. topic:: MEMIF
+
+ All test cases which uses Memif.
Feature tags
------------
COP whitelist.
-.. topic:: SNAT
+.. topic:: NAT44
+
+ NAT44 configured and tested.
+
+.. topic:: NAT64
+
+ NAT44 configured and tested.
+
+.. topic:: ACL
+
+ ACL plugin configured and tested.
+
+.. topic:: IACL
- SNAT configured and tested.
+ ACL plugin configured and tested on input path.
+.. topic:: OACL
+
+ ACL plugin configured and tested on output path.
+
+.. topic:: ACL_STATELESS
+
+ ACL plugin configured and tested in stateless mode (permit action).
+
+.. topic:: ACL_STATEFUL
+
+ ACL plugin configured and tested in stateful mode (permit+reflect action).
+
+.. topic:: ACL1
+
+ ACL plugin configured and tested with 1 not-hitting ACE.
+
+.. topic:: ACL10
+
+ ACL plugin configured and tested with 10 not-hitting ACEs.
+
+.. topic:: ACL50
+
+ ACL plugin configured and tested with 50 not-hitting ACEs.
Encryption tags
---------------
IPSec in tunnel mode.
-
Client-workload tags
--------------------
All test cases with specific APP use.
-
Multi-threading tags
--------------------
8 worker threads pinned to 8 dedicated physical cores. 4 receive queues per
interface. Main thread pinned to core 0.
-
Honeycomb tags
--------------