path: root/docs/content/overview/csit/test_tags.md

---
title: "Test Tags"
weight: 4
---

# Test Tags

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
descriptions.

## Testbed Topology Tags

**2_NODE_DOUBLE_LINK_TOPO**

    2 nodes connected in a circular topology with two links interconnecting
    the devices.

**2_NODE_SINGLE_LINK_TOPO**

    2 nodes connected in a circular topology with at least one link
    interconnecting devices.

**3_NODE_DOUBLE_LINK_TOPO**

    3 nodes connected in a circular topology with two links interconnecting
    the devices.

**3_NODE_SINGLE_LINK_TOPO**

    3 nodes connected in a circular topology with at least one link
    interconnecting devices.

## Objective Tags

**SKIP_PATCH**

    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).

**SKIP_VPP_PATCH**

    Test case(s) marked to not run in case of vpp-csit-verify (i.e. VPP
    patch).

## Environment Tags

**HW_ENV**

    DUTs and TGs are running on bare metal.

**VM_ENV**

    DUTs and TGs are running in virtual environment.

**VPP_VM_ENV**

    DUTs with VPP and capable of running Virtual Machine.

## NIC Model Tags

**NIC_Intel-X520-DA2**

    Intel X520-DA2 NIC.

**NIC_Intel-XL710**

    Intel XL710 NIC.

**NIC_Intel-X710**

    Intel X710 NIC.

**NIC_Intel-XXV710**

    Intel XXV710 NIC.

**NIC_Cisco-VIC-1227**

    VIC-1227 by Cisco.

**NIC_Cisco-VIC-1385**

    VIC-1385 by Cisco.

**NIC_Amazon-Nitro-50G**

    Amazon EC2 ENA NIC.

## Scaling Tags

**FIB_20K**

    2x10,000 entries in single fib table

**FIB_200K**

    2x100,000 entries in single fib table

**FIB_1M**

    2x500,000 entries in single fib table

**FIB_2M**

    2x1,000,000 entries in single fib table

**L2BD_1**

    Test with 1 L2 bridge domain.

**L2BD_10**

    Test with 10 L2 bridge domains.

**L2BD_100**

    Test with 100 L2 bridge domains.

**L2BD_1K**

    Test with 1000 L2 bridge domains.

**VLAN_1**

    Test with 1 VLAN sub-interface.

**VLAN_10**

    Test with 10 VLAN sub-interfaces.

**VLAN_100**

    Test with 100 VLAN sub-interfaces.

**VLAN_1K**

    Test with 1000 VLAN sub-interfaces.

**VXLAN_1**

    Test with 1 VXLAN tunnel.

**VXLAN_10**

    Test with 10 VXLAN tunnels.

**VXLAN_100**

    Test with 100 VXLAN tunnels.

**VXLAN_1K**

    Test with 1000 VXLAN tunnels.

**TNL_{t}**

    IPSec in tunnel mode - {t} tunnels.

**SRC_USER_{u}**

    Traffic flow with {u} unique IPs (users) in one direction.
    {u}=(1,10,100,1000,2000,4000).

**100_FLOWS**

    Traffic stream with 100 unique flows (10 IPs/users x 10 UDP ports) in
    one direction.

**10k_FLOWS**

    Traffic stream with 10 000 unique flows (10 IPs/users x 1000 UDP ports)
    in one direction.

**100k_FLOWS**

    Traffic stream with 100 000 unique flows (100 IPs/users x 1000 UDP
    ports) in one direction.

**HOSTS_{h}**

    Stateless or stateful traffic stream with {h} client source IP4
    addresses, usually with 63 flow differing in source port number.
    Could be UDP or TCP. If NAT is used, the clients are inside.
    Outside IP range can differ.
    {h}=(1024,4096,16384,65536,262144).

**GENEVE4_{t}TUN**

    Test with {t} GENEVE IPv4 tunnel.
    {t}=(1,4,16,64,256,1024)

## Test Category Tags

**DEVICETEST**

    All vpp_device functional test cases.

**PERFTEST**

    All performance test cases.

## VPP Device Type Tags

**SCAPY**

    All test cases that uses Scapy for packet generation and validation.

## Performance Type Tags

**NDRPDR**

    Single test finding both No Drop Rate and Partial Drop Rate
    simultaneously. The search is done by optimized algorithm which
    performs multiple trial runs at different durations and transmit
    rates. The results come from the final trials, which have duration
    of 30 seconds.

**MRR**

    Performance tests where TG sends the traffic at maximum rate (line rate)
    and reports total sent/received packets over trial duration.
    The result is an average of 10 trials of 1 second duration.

**SOAK**

    Performance tests using PLRsearch to find the critical load.

**RECONF**

    Performance tests aimed to measure lost packets (time) when performing
    reconfiguration while full throughput offered load is applied.

## Ethernet Frame Size Tags

These are describing the traffic offered by Traffic Generator,
"primary" traffic in case of asymmetric load.
For traffic between DUTs, or for "secondary" traffic, see ${overhead} value.

**{b}B**

    {b} Bytes frames used for test.

**IMIX**

    IMIX frame sequence (28x 64B, 16x 570B, 4x 1518B) used for test.

## Test Type Tags

**BASE**

    Baseline test cases, no encapsulation, no feature(s) configured in tests.
    No scaling whatsoever, beyond minimum needed for RSS.

**IP4BASE**

    IPv4 baseline test cases, no encapsulation, no feature(s) configured in
    tests. Minimal number of routes. Other quantities may be scaled.

**IP6BASE**

    IPv6 baseline test cases, no encapsulation, no feature(s) configured in
    tests.

**L2XCBASE**

    L2XC baseline test cases, no encapsulation, no feature(s) configured in
    tests.

**L2BDBASE**

    L2BD baseline test cases, no encapsulation, no feature(s) configured in
    tests.

**L2PATCH**

    L2PATCH baseline test cases, no encapsulation, no feature(s) configured
    in tests.

**SCALE**

    Scale test cases. Other tags specify which quantities are scaled.
    Also applies if scaling is set on TG only (e.g. DUT works as IP4BASE).

**ENCAP**

    Test cases where encapsulation is used. Use also encapsulation tag(s).

**FEATURE**

    At least one feature is configured in test cases. Use also feature
    tag(s).

**UDP**

    Tests which use any kind of UDP traffic (STL or ASTF profile).

**TCP**

    Tests which use any kind of TCP traffic (STL or ASTF profile).

**TREX**

    Tests which test trex traffic without any software DUTs in the
    traffic path.

**UDP_UDIR**

    Tests which use unidirectional UDP traffic (STL profile only).

**UDP_BIDIR**

    Tests which use bidirectional UDP traffic (STL profile only).

**UDP_CPS**

    Tests which measure connections per second on minimal UDP
    pseudoconnections. This implies ASTF traffic profile is used.

**TCP_CPS**

    Tests which measure connections per second on empty TCP connections.
    This implies ASTF traffic profile is used.

**TCP_RPS**

    Tests which measure requests per second on empty TCP connections.
    This implies ASTF traffic profile is used.

**UDP_PPS**

    Tests which measure packets per second on lightweight UDP transactions.
    This implies ASTF traffic profile is used.

**TCP_PPS**

    Tests which measure packets per second on lightweight TCP transactions.
    This implies ASTF traffic profile is used.

**HTTP**

    Tests which use traffic formed of valid HTTP requests (and responses).

**LDP_NGINX**

    LDP NGINX is un-modified NGINX with VPP via LD_PRELOAD.

**NF_DENSITY**

    Performance tests that measure throughput of multiple VNF and CNF
    service topologies at different service densities.

## NF Service Density Tags

**CHAIN**

    NF service density tests with VNF or CNF service chain topology(ies).

**PIPE**

    NF service density tests with CNF service pipeline topology(ies).

**NF_L3FWDIP4**

    NF service density tests with DPDK l3fwd IPv4 routing as NF workload.

**NF_VPPIP4**

    NF service density tests with VPP IPv4 routing as NF workload.

**{r}R{c}C**

    Service density matrix locator {r}R{c}C, {r}Row denoting number of
    service instances, {c}Column denoting number of NFs per service
    instance.
    {r}=(1,2,4,6,8,10), {c}=(1,2,4,6,8,10).

**{n}VM{t}T**

    Service density {n}VM{t}T, {n}Number of NF Qemu VMs, {t}Number of
    threads per NF.

**{n}DCR{t}T**

    Service density {n}DCR{t}T, {n}Number of NF Docker containers,
    {t}Number of threads per NF.

**{n}_ADDED_CHAINS**

    {n}Number of chains (or pipelines) added (and/or removed)
    during RECONF test.

## Forwarding Mode Tags

**L2BDMACSTAT**

    VPP L2 bridge-domain, L2 MAC static.

**L2BDMACLRN**

    VPP L2 bridge-domain, L2 MAC learning.

**L2XCFWD**

    VPP L2 point-to-point cross-connect.

**IP4FWD**

    VPP IPv4 routed forwarding.

**IP6FWD**

    VPP IPv6 routed forwarding.

**LOADBALANCER_MAGLEV**

    VPP Load balancer maglev mode.

**LOADBALANCER_L3DSR**

    VPP Load balancer l3dsr mode.

**LOADBALANCER_NAT4**

    VPP Load balancer nat4 mode.

**N2N**

    Mode, where NICs from the same physical server are directly
    connected with a cable.

## Underlay Tags

**IP4UNRLAY**

    IPv4 underlay.

**IP6UNRLAY**

    IPv6 underlay.

**MPLSUNRLAY**

    MPLS underlay.

## Overlay Tags

**L2OVRLAY**

    L2 overlay.

**IP4OVRLAY**

    IPv4 overlay (IPv4 payload).

**IP6OVRLAY**

    IPv6 overlay (IPv6 payload).

## Tagging Tags

**DOT1Q**

    All test cases with dot1q.

**DOT1AD**

    All test cases with dot1ad.

## Encapsulation Tags

**ETH**

    All test cases with base Ethernet (no encapsulation).

**LISP**

    All test cases with LISP.

**LISPGPE**

    All test cases with LISP-GPE.

**LISP_IP4o4**

    All test cases with LISP_IP4o4.

**LISPGPE_IP4o4**

    All test cases with LISPGPE_IP4o4.

**LISPGPE_IP6o4**

    All test cases with LISPGPE_IP6o4.

**LISPGPE_IP4o6**

    All test cases with LISPGPE_IP4o6.

**LISPGPE_IP6o6**

    All test cases with LISPGPE_IP6o6.

**VXLAN**

    All test cases with Vxlan.

**VXLANGPE**

    All test cases with VXLAN-GPE.

**GRE**

    All test cases with GRE.

**GTPU**

    All test cases with GTPU.

**GTPU_HWACCEL**

    All test cases with GTPU_HWACCEL.

**IPSEC**

    All test cases with IPSEC.

**WIREGUARD**

    All test cases with WIREGUARD.

**SRv6**

    All test cases with Segment routing over IPv6 dataplane.

**SRv6_1SID**

    All SRv6 test cases with single SID.

**SRv6_2SID_DECAP**

    All SRv6 test cases with two SIDs and with decapsulation.

**SRv6_2SID_NODECAP**

    All SRv6 test cases with two SIDs and without decapsulation.

**GENEVE**

    All test cases with GENEVE.

**GENEVE_L3MODE**

    All test cases with GENEVE tunnel in L3 mode.

**FLOW**

    All test cases with FLOW.

**FLOW_DIR**

    All test cases with FLOW_DIR.

**FLOW_RSS**

    All test cases with FLOW_RSS.

**NTUPLE**

    All test cases with NTUPLE.

**L2TPV3**

    All test cases with L2TPV3.

**REASSEMBLY**

    All encap/decap tests where MTU induces IP fragmentation and reassembly.

## Interface Tags

**PHY**

    All test cases which use physical interface(s).

**GSO**

    All test cases which uses Generic Segmentation Offload.

**VHOST**

    All test cases which uses VHOST.

**VHOST_1024**

    All test cases which uses VHOST DPDK driver with qemu queue size set
    to 1024.

**VIRTIO**

    All test cases which uses VIRTIO native VPP driver.

**VIRTIO_1024**

    All test cases which uses VIRTIO native VPP driver with qemu queue 
    size set to 1024.

**CFS_OPT**

    All test cases which uses VM with optimised scheduler policy.

**TUNTAP**

    All test cases which uses TUN and TAP.

**AFPKT**

    All test cases which uses AFPKT.

**NETMAP**

    All test cases which uses Netmap.

**MEMIF**

    All test cases which uses Memif.

**SINGLE_MEMIF**

    All test cases which uses only single Memif connection per DUT. One DUT
    instance is running in container having one physical interface exposed
    to container.

**LBOND**

    All test cases which uses link bonding (BondEthernet interface).

**LBOND_DPDK**

    All test cases which uses DPDK link bonding.

**LBOND_VPP**

    All test cases which uses VPP link bonding.

**LBOND_MODE_XOR**

    All test cases which uses link bonding with mode XOR.

**LBOND_MODE_LACP**

    All test cases which uses link bonding with mode LACP.

**LBOND_LB_L34**

    All test cases which uses link bonding with load-balance mode l34.

**LBOND_{n}L**

    All test cases which use {n} link(s) for link bonding.

**DRV_{d}**

    All test cases which NIC Driver for DUT is set to {d}.
    Default is VFIO_PCI.
    {d}=(AVF, RDMA_CORE, VFIO_PCI, AF_XDP).

**TG_DRV_{d}**

    All test cases which NIC Driver for TG is set to {d}.
    Default is IGB_UIO.
    {d}=(RDMA_CORE, IGB_UIO).

**RXQ_SIZE_{n}**

    All test cases which RXQ size (RX descriptors) are set to {n}.
    Default is 0, which means VPP (API) default.

**TXQ_SIZE_{n}**

    All test cases which TXQ size (TX descriptors) are set to {n}.
    Default is 0, which means VPP (API) default.

## Feature Tags

**IACLDST**

    iACL destination.

**ADLALWLIST**

    ADL allowlist.

**NAT44**

    NAT44 configured and tested.

**NAT64**

    NAT44 configured and tested.

**ACL**

    ACL plugin configured and tested.

**IACL**

    ACL plugin configured and tested on input path.

**OACL**

    ACL plugin configured and tested on output path.

**ACL_STATELESS**

    ACL plugin configured and tested in stateless mode
    (permit action).

**ACL_STATEFUL**

    ACL plugin configured and tested in stateful mode
    (permit+reflect action).

**ACL1**

    ACL plugin configured and tested with 1 not-hitting ACE.

**ACL10**

    ACL plugin configured and tested with 10 not-hitting ACEs.

**ACL50**

    ACL plugin configured and tested with 50 not-hitting ACEs.

**SRv6_PROXY**

    SRv6 endpoint to SR-unaware appliance via proxy.

**SRv6_PROXY_STAT**

    SRv6 endpoint to SR-unaware appliance via static proxy.

**SRv6_PROXY_DYN**

    SRv6 endpoint to SR-unaware appliance via dynamic proxy.

**SRv6_PROXY_MASQ**

    SRv6 endpoint to SR-unaware appliance via masquerading proxy.

## Encryption Tags

**IPSECSW**

    Crypto in software.

**IPSECHW**

    Crypto in hardware.

**IPSECTRAN**

    IPSec in transport mode.

**IPSECTUN**

    IPSec in tunnel mode.

**IPSECINT**

    IPSec in interface mode.

**AES**

    IPSec using AES algorithms.

**AES_128_CBC**

    IPSec using AES 128 CBC algorithms.

**AES_128_GCM**

    IPSec using AES 128 GCM algorithms.

**AES_256_GCM**

    IPSec using AES 256 GCM algorithms.

**HMAC**

    IPSec using HMAC integrity algorithms.

**HMAC_SHA_256**

    IPSec using HMAC SHA 256 integrity algorithms.

**HMAC_SHA_512**

    IPSec using HMAC SHA 512 integrity algorithms.

**SCHEDULER**

    IPSec using crypto sw scheduler engine.

**FASTPATH**

    IPSec policy mode with spd fast path enabled.

## Client-Workload Tags

**VM**

    All test cases which use at least one virtual machine.

**LXC**

    All test cases which use Linux container and LXC utils.

**DRC**

    All test cases which use at least one Docker container.

**DOCKER**

    All test cases which use Docker as container manager.

**APP**

    All test cases with specific APP use.

## Container Orchestration Tags

**{n}VSWITCH**

    {n} VPP running in {n} Docker container(s) acting as a VSWITCH.
    {n}=(1).

**{n}VNF**

    {n} VPP running in {n} Docker container(s) acting as a VNF work load.
    {n}=(1).

## Multi-Threading Tags

**STHREAD**

    Dynamic tag.
    All test cases using single poll mode thread.

**MTHREAD**

    Dynamic tag.
    All test cases using more then one poll mode driver thread.

**{n}NUMA**

    All test cases with packet processing on {n} socket(s). {n}=(1,2).

**{c}C**

    {c} worker thread pinned to {c} dedicated physical core; or if
    HyperThreading is enabled, {c}*2 worker threads each pinned to
    a separate logical core within 1 dedicated physical core. Main
    thread pinned to core 1.
    {t}=(1,2,4).

**{t}T{c}C**

    *Dynamic tag*.
    {t} worker threads pinned to {c} dedicated physical cores. Main thread
    pinned to core 1. By default CSIT is configuring same amount of receive
    queues per interface as worker threads. 
    {t}=(1,2,4,8),
    {c}=(1,2,4).