3. Robot Library

• 3.1. crypto
  • 3.1.1. ipsec suite
    • 3.1.1.1. Generate keys for IPSec
    • 3.1.1.2. Configure topology for IPv4 IPsec testing
    • 3.1.1.3. Configure topology for IPv6 IPsec testing
    • 3.1.1.4. Configure manual keyed connection for IPSec
    • 3.1.1.5. Initialize IPSec in 3-node circular topology
    • 3.1.1.6. Initialize IPSec in 3-node circular container topology
    • 3.1.1.7. Initialize IPSec in 2-node circular topology
    • 3.1.1.8. Enable IPSec Async Mode on all VPP DUTs
    • 3.1.1.9. Set Data Plane And Feature Plane Workers for IPsec on all VPP DUTs
    • 3.1.1.10. Enable SPD flow cache IPv4 Outbound
• 3.2. features
  • 3.2.1. acl suite
    • 3.2.1.1. Configure MACIP ACLs
    • 3.2.1.2. Configure IPv4 ACLs
    • 3.2.1.3. Configure ACLs on a single interface
    • 3.2.1.4. Initialize IPv4 routing with IPv4 ACLs on DUT1 in circular topology
  • 3.2.2. policer suite
    • 3.2.2.1. Initialize IPv4 policer 2r3c-${t} in circular topology
    • 3.2.2.2. Initialize IPv6 policer 2r3c-${t} in circular topology
    • 3.2.2.3. Show Classify Tables Verbose on all DUTs
• 3.3. hoststack
  • 3.3.1. hoststack suite
    • 3.3.1.1. Set VPP Hoststack Attributes
    • 3.3.1.2. Set VPP Echo Server Attributes
    • 3.3.1.3. Set VPP Echo Client Attributes
    • 3.3.1.4. Set Iperf3 Server Attributes
    • 3.3.1.5. Set Iperf3 Client Attributes
    • 3.3.1.6. Run hoststack test program on DUT
    • 3.3.1.7. Additional VPP Config For Feature quic
    • 3.3.1.8. Configure VPP hoststack attributes on all DUTs
    • 3.3.1.9. Get Test Results From Hoststack VPP Echo Test
    • 3.3.1.10. Get Test Results From Hoststack Iperf3 Test
    • 3.3.1.11. Set up LDP or VCL Nginx on DUT node
    • 3.3.1.12. Measure TLS requests or connections per second
• 3.4. ip
  • 3.4.1. geneve suite
    • 3.4.1.1. Initialize GENEVE L3 mode in circular topology
  • 3.4.2. ip4 suite
    • 3.4.2.1. Initialize IPv4 forwarding in circular topology
    • 3.4.2.2. Initialize IPv4 forwarding with scaling in circular topology
    • 3.4.2.3. Initialize IPv4 routing with memif pairs
    • 3.4.2.4. Initialize IPv4 routing with memif pairs on DUT node
    • 3.4.2.5. Initialize IPv4 forwarding with vhost in 2-node circular topology
    • 3.4.2.6. Initialize IPv4 forwarding with vhost in 3-node circular topology
    • 3.4.2.7. Initialize IPv4 forwarding with VLAN dot1q sub-interfaces in circular topology
  • 3.4.3. ip6 suite
    • 3.4.3.1. Initialize IPv6 forwarding in circular topology
    • 3.4.3.2. Initialize IPv6 forwarding with scaling in circular topology
    • 3.4.3.3. Initialize IPv6 forwarding with vhost in 2-node circular topology
    • 3.4.3.4. Initialize IPv6 forwarding with VLAN dot1q sub-interfaces in circular topology
  • 3.4.4. nat suite
    • 3.4.4.1. Configure inside and outside interfaces
    • 3.4.4.2. Initialize NAT44 endpoint-dependent mode in circular topology
    • 3.4.4.3. Initialize IPv4 forwarding for NAT44 in circular topology
    • 3.4.4.4. Verify NAT44 TCP sessions number on DUT1 node
    • 3.4.4.5. Verify NAT44 UDP sessions number on DUT1 node
    • 3.4.4.6. Verify NAT44 sessions number
    • 3.4.4.7. Enable DET44 plugin on DUT
    • 3.4.4.8. Configure DET44 interfaces
    • 3.4.4.9. Configure deterministic mode for NAT44
    • 3.4.4.10. Initialize NAT44 deterministic mode in circular topology
    • 3.4.4.11. Show DET44 verbose
    • 3.4.4.12. Verify DET44 sessions number on DUT1 node
    • 3.4.4.13. Verify DET44 sessions number
• 3.5. l2
  • 3.5.1. l2_bridge_domain suite
    • 3.5.1.1. Show Bridge Domain Data On All DUTs
    • 3.5.1.2. Add interface to bridge domain
    • 3.5.1.3. Initialize L2 bridge domain on node
    • 3.5.1.4. Initialize L2 bridge domain
    • 3.5.1.5. Initialize L2 bridge domains with Vhost-User on node
    • 3.5.1.6. Initialize L2 bridge domains with Vhost-User
    • 3.5.1.7. Initialize L2 bridge domains for multiple chains with Vhost-User
    • 3.5.1.8. Initialize L2 bridge domain with VXLANoIPv4 in 3-node circular topology
    • 3.5.1.9. Initialize L2 bridge domain with VLAN and VXLANoIPv4 in 3-node circular topology
    • 3.5.1.10. Initialize L2 bridge domains with Vhost-User and VXLANoIPv4 in 3-node circular topology
    • 3.5.1.11. Initialize L2 bridge domains with VLAN dot1q sub-interfaces in circular topology
    • 3.5.1.12. Initialize L2 bridge domains with Vhost-User and VLAN in circular topology
    • 3.5.1.13. Initialize L2 bridge domains with Vhost-User and VLAN with VPP link bonding in a 3-node circular topology
    • 3.5.1.14. Initialize L2 Bridge Domain with memif pairs on DUT node
    • 3.5.1.15. Initialize L2 Bridge Domain with memif pairs
    • 3.5.1.16. Initialize L2 Bridge Domain for multiple chains with memif pairs
    • 3.5.1.17. Initialize L2 Bridge Domain for pipeline with memif pairs
    • 3.5.1.18. Initialize L2 Bridge Domain for multiple pipelines with memif pairs
    • 3.5.1.19. Initialize L2 Bridge Domain with memif pairs and VLAN in circular topology
    • 3.5.1.20. Initialize L2 Bridge Domain for single memif
    • 3.5.1.21. Initialize L2 bridge domain with MACIP ACLs in circular topology
    • 3.5.1.22. Initialize L2 bridge domain with IPv4 ACLs in circular topology
  • 3.5.2. l2_patch suite
    • 3.5.2.1. Initialize L2 patch
  • 3.5.3. l2_traffic suite
    • 3.5.3.1. Send IP packet and verify received packet
    • 3.5.3.2. Send IPv4 bidirectionally and verify received packets
    • 3.5.3.3. Send IPv6 bidirectionally and verify received packets
  • 3.5.4. l2_xconnect suite
    • 3.5.4.1. Configure L2XC
    • 3.5.4.2. Initialize L2 cross connect on node
    • 3.5.4.3. Initialize L2 cross connect
    • 3.5.4.4. Initialize L2 xconnect with VXLANoIPv4 in 3-node circular topology
    • 3.5.4.5. Initialize L2 xconnect with Vhost-User on node
    • 3.5.4.6. Initialize L2 xconnect with Vhost-User
    • 3.5.4.7. Initialize L2 xconnect with Vhost-User and VLAN in circular topology
    • 3.5.4.8. Initialize L2 xconnect with Vhost-User and VLAN with VPP link bonding in 3-node circular topology
    • 3.5.4.9. Initialize L2 xconnect with memif pairs on DUT node
    • 3.5.4.10. Initialize L2 xconnect with memif pairs
  • 3.5.5. tagging suite
    • 3.5.5.1. Initialize VLAN sub-interfaces in 3-node circular topology
    • 3.5.5.2. Initialize VLAN dot1q sub-interfaces in circular topology
    • 3.5.5.3. Configure L2 tag rewrite method on interfaces
    • 3.5.5.4. Configure L2 tag rewrite method on interface
• 3.6. lb
  • 3.6.1. load_balancer suite
    • 3.6.1.1. Initialize loadbalancer maglev
    • 3.6.1.2. Initialize loadbalancer l3dsr
    • 3.6.1.3. Initialize loadbalancer nat4
    • 3.6.1.4. Add Ip Neighbors
    • 3.6.1.5. Add Lb As Addresses
• 3.7. nginx
  • 3.7.1. default suite
    • 3.7.1.1. Apply Nginx configuration on DUT
• 3.8. nsim
  • 3.8.1. nsim suite
    • 3.8.1.1. Set VPP NSIM Attributes
• 3.9. overlay
  • 3.9.1. gtpu suite
    • 3.9.1.1. Initialize IP4 forwarding with GTPU tunnel in 3-node circular topology
  • 3.9.2. lisp suite
    • 3.9.2.1. Configure topology for IPv4 LISP testing
    • 3.9.2.2. Configure topology for IPv6 LISP testing
    • 3.9.2.3. Configure LISP topology in 3-node circular topology
    • 3.9.2.4. Configure LISP in 2-node circular topology
    • 3.9.2.5. Configure topology for IPv6 LISPoIP4 testing
    • 3.9.2.6. Configure topology for IPv4 LISPoIP6 testing
    • 3.9.2.7. Initialize LISP IPv4 forwarding in 3-node circular topology
    • 3.9.2.8. Initialize LISP GPE IPv4 over IPsec in 3-node circular topology
    • 3.9.2.9. Initialize LISP IPv6 forwarding in 3-node circular topology
    • 3.9.2.10. Initialize LISP IPv4 over IPv6 forwarding in 3-node circular topology
    • 3.9.2.11. Initialize LISP IPv6 over IPv4 forwarding in 3-node circular topology
  • 3.9.3. lisp_api suite
    • 3.9.3.1. Enable LISP
    • 3.9.3.2. Disable LISP
    • 3.9.3.3. Enable Lisp Gpe
  • 3.9.4. lispgpe suite
    • 3.9.4.1. Configure LISP GPE topology in 3-node circular topology
  • 3.9.5. srv6 suite
    • 3.9.5.1. Configure SR LocalSID on DUT
    • 3.9.5.2. Show SR LocalSIDs on DUT
    • 3.9.5.3. Configure SR Policy on DUT
    • 3.9.5.4. Show SR Policies on DUT
    • 3.9.5.5. Configure SR Steer on DUT
    • 3.9.5.6. Show SR Steering Policies on DUT
    • 3.9.5.7. Set SR Encaps Source Address on DUT
    • 3.9.5.8. Show SR Policies on all DUTs
    • 3.9.5.9. Show SR Steering Policies on all DUTs
    • 3.9.5.10. Show SR LocalSIDs on all DUTs
    • 3.9.5.11. Initialize SRv6 encapsulation with ‘${n}’ x SID ‘${prepos}’ decapsulation
    • 3.9.5.12. Initialize SRv6 with ‘${behavior}’ SR-unaware Service Function
  • 3.9.6. vxlan suite
    • 3.9.6.1. Get VXLAN dump
• 3.10. performance
  • 3.10.1. performance_actions suite
    • 3.10.1.1. Additional Statistics Action For bash-perf-stat
    • 3.10.1.2. Additional Statistics Action For trex-runtime
    • 3.10.1.3. Additional Statistics Action For vpp-runtime
    • 3.10.1.4. Additional Statistics Action For vpp-runtime-iperf3
    • 3.10.1.5. Additional Statistics Action For noop
    • 3.10.1.6. Additional Statistics Action For vpp-clear-stats
    • 3.10.1.7. Additional Statistics Action For vpp-enable-packettrace
    • 3.10.1.8. Additional Statistics Action For vpp-show-packettrace
    • 3.10.1.9. Additional Statistics Action For vpp-show-stats
  • 3.10.2. performance_display suite
    • 3.10.2.1. Check NDRPDR interval validity
    • 3.10.2.2. Compute Bandwidth
    • 3.10.2.3. Display Reconfig Test Message
    • 3.10.2.4. Display result of NDRPDR search
    • 3.10.2.5. Display result of soak search
    • 3.10.2.6. Display single bound
    • 3.10.2.7. Display Single CPS Bound
    • 3.10.2.8. Display Single PPS Bound
  • 3.10.3. performance_utils suite
    • 3.10.3.1. Find critical load using PLRsearch
    • 3.10.3.2. Find NDR and PDR intervals using optimized search
    • 3.10.3.3. Find Throughput Using MLRsearch
    • 3.10.3.4. Measure and show latency at specified rate
    • 3.10.3.5. Send ramp-up traffic
    • 3.10.3.6. Send traffic at specified rate
    • 3.10.3.7. Traffic should pass with maximum rate on iPerf3
    • 3.10.3.8. Send iPerf3 traffic at specified rate
    • 3.10.3.9. Start Traffic on Background
    • 3.10.3.10. Stop Running Traffic
    • 3.10.3.11. Traffic should pass with maximum rate
  • 3.10.4. performance_vars suite
    • 3.10.4.1. Get Disable Latency
    • 3.10.4.2. Get Max Rate
    • 3.10.4.3. Get Min Rate Hard
    • 3.10.4.4. Get Min Rate Soft
    • 3.10.4.5. Get Mrr Trial Duration
    • 3.10.4.6. Get Mrr Trial Multiplicity
    • 3.10.4.7. Get Packet Loss Ratio
    • 3.10.4.8. Get Packets Per Transaction Aggregated
    • 3.10.4.9. Get Packets Per Transaction And Direction
    • 3.10.4.10. Get Ramp Up Duration
    • 3.10.4.11. Get Ramp Up Rate
    • 3.10.4.12. Get Rate For Teardown
    • 3.10.4.13. Get Resetter
    • 3.10.4.14. Get Runtime Duration
    • 3.10.4.15. Get Runtime Rate
    • 3.10.4.16. Get Traffic Directions
    • 3.10.4.17. Get Transaction Duration
    • 3.10.4.18. Get Transaction Scale
    • 3.10.4.19. Get Transaction Type
    • 3.10.4.20. Get Use Latency
    • 3.10.4.21. Set Jumbo
    • 3.10.4.22. Set Max Rate And Jumbo
    • 3.10.4.23. Set Numeric Frame Sizes
    • 3.10.4.24. Apply Tcp Cps Proto Overhead
    • 3.10.4.25. Apply Tcp Tput Proto Overhead
    • 3.10.4.26. Set Rates For Policer
• 3.11. shared
  • 3.11.1. container suite
    • 3.11.1.1. Construct container on all DUTs
    • 3.11.1.2. Construct container on DUT
    • 3.11.1.3. Construct chain of containers
    • 3.11.1.4. Construct chains of containers
    • 3.11.1.5. Acquire all ‘${group}’ containers
    • 3.11.1.6. Create all ‘${group}’ containers
    • 3.11.1.7. Start VPP in all ‘${group}’ containers
    • 3.11.1.8. Restart VPP in all ‘${group}’ containers
    • 3.11.1.9. Configure VPP in all ‘${group}’ containers
    • 3.11.1.10. Stop all ‘${group}’ containers
    • 3.11.1.11. Destroy all ‘${group}’ containers
    • 3.11.1.12. Verify VPP in all ‘${group}’ containers
    • 3.11.1.13. Start containers for test
    • 3.11.1.14. Start vswitch in container on DUT
    • 3.11.1.15. Start vswitch in container
  • 3.11.2. default suite
    • 3.11.2.1. Call Resetter
    • 3.11.2.2. Configure crypto device on all DUTs
    • 3.11.2.3. Configure kernel module on all DUTs
    • 3.11.2.4. Get Keyname for DUT
    • 3.11.2.5. Create base startup configuration of VPP on all DUTs
    • 3.11.2.6. Add worker threads to all DUTs
    • 3.11.2.7. Create compute resources variables
    • 3.11.2.8. Add NAT to all DUTs
    • 3.11.2.9. Add NAT max translations per thread to all DUTs
    • 3.11.2.10. Write startup configuration on all VPP DUTs
    • 3.11.2.11. Apply startup configuration on all VPP DUTs
    • 3.11.2.12. Apply startup configuration on VPP DUT
    • 3.11.2.13. Save VPP PIDs
    • 3.11.2.14. Save VPP PIDs on DUT
    • 3.11.2.15. Verify VPP PID in Teardown
  • 3.11.3. interfaces suite
    • 3.11.3.1. Set single interfaces in path up
    • 3.11.3.2. Set interfaces in path up
    • 3.11.3.3. Set interfaces in path up on node
    • 3.11.3.4. Set interfaces in path up on node on PF
    • 3.11.3.5. Pre-initialize layer driver
    • 3.11.3.6. Pre-initialize layer tap on all DUTs
    • 3.11.3.7. Pre-initialize layer vhost on all DUTs
    • 3.11.3.8. Pre-initialize layer vfio-pci on all DUTs
    • 3.11.3.9. Pre-initialize layer avf on all DUTs
    • 3.11.3.10. Pre-initialize layer af_xdp on all DUTs
    • 3.11.3.11. Pre-initialize layer rdma-core on all DUTs
    • 3.11.3.12. Pre-initialize layer mlx5_core on all DUTs
    • 3.11.3.13. Initialize layer driver
    • 3.11.3.14. Initialize layer driver on node
    • 3.11.3.15. Initialize layer tap on node
    • 3.11.3.16. Initialize layer vhost on node
    • 3.11.3.17. Initialize layer vfio-pci on node
    • 3.11.3.18. Initialize layer avf on node
    • 3.11.3.19. Initialize layer af_xdp on node
    • 3.11.3.20. Initialize layer rdma-core on node
    • 3.11.3.21. Initialize layer mlx5_core on node
    • 3.11.3.22. Initialize layer interface
    • 3.11.3.23. Initialize layer interface on node
    • 3.11.3.24. Initialize layer interface on node on PF
    • 3.11.3.25. Initialize layer bonding
    • 3.11.3.26. Initialize layer bonding on node
    • 3.11.3.27. Initialize layer dot1q
    • 3.11.3.28. Initialize layer dot1q on node
    • 3.11.3.29. Initialize layer dot1q on node on PF
    • 3.11.3.30. Initialize layer dot1q on node on PF for chain
    • 3.11.3.31. Initialize layer ip4vxlan
    • 3.11.3.32. Initialize layer ip4vxlan on node
    • 3.11.3.33. Initialize layer ip4vxlan on node on PF
    • 3.11.3.34. Configure vhost interfaces
    • 3.11.3.35. Get Vhost dump
  • 3.11.4. memif suite
    • 3.11.4.1. Set up memif interfaces on DUT node
    • 3.11.4.2. Set up single memif interface on DUT node
  • 3.11.5. suite_setup suite
    • 3.11.5.1. Create suite topology variables
    • 3.11.5.2. Setup suite topology interfaces
    • 3.11.5.3. Setup suite topology interfaces with no TG
    • 3.11.5.4. Setup suite topology interfaces with no DUT
    • 3.11.5.5. Additional Suite Setup Action For scapy
    • 3.11.5.6. Additional Suite Setup Action For dpdk
    • 3.11.5.7. Additional Suite Setup Action For performance vf
    • 3.11.5.8. Additional Suite Setup Action For performance pf
    • 3.11.5.9. Additional Suite Setup Action For performance
    • 3.11.5.10. Additional Suite Setup Action For performance_tg_nic
    • 3.11.5.11. Additional Suite Setup Action For iPerf3
    • 3.11.5.12. Additional Suite Setup Action For ipsechw
    • 3.11.5.13. Additional Suite Setup Action For nginx
    • 3.11.5.14. Additional Suite Setup Action For vppecho
    • 3.11.5.15. Additional Suite Setup Action For ab
  • 3.11.6. suite_teardown suite
    • 3.11.6.1. Tear down suite
    • 3.11.6.2. Additional Suite Tear Down Action For ab
    • 3.11.6.3. Additional Suite Tear Down Action For performance
    • 3.11.6.4. Additional Suite Tear Down Action For dpdk
    • 3.11.6.5. Additional Suite Tear Down Action For hoststack
  • 3.11.7. test_setup suite
    • 3.11.7.1. Setup test
    • 3.11.7.2. Additional Test Setup Action For namespace
    • 3.11.7.3. Additional Test Setup Action For performance
  • 3.11.8. test_teardown suite
    • 3.11.8.1. Tear down test
    • 3.11.8.2. Tear down test raw
    • 3.11.8.3. Additional Test Tear Down Action For acl
    • 3.11.8.4. Additional Test Tear Down Action For classify
    • 3.11.8.5. Additional Test Tear Down Action For container
    • 3.11.8.6. Additional Test Tear Down Action For nginx
    • 3.11.8.7. Additional Test Tear Down Action For det44
    • 3.11.8.8. Additional Test Tear Down Action For geneve4
    • 3.11.8.9. Additional Test Tear Down Action For iPerf3
    • 3.11.8.10. Additional Test Tear Down Action For ipsec_sa
    • 3.11.8.11. Additional Test Tear Down Action For ipsec_all
    • 3.11.8.12. Additional Test Tear Down Action For linux_bridge
    • 3.11.8.13. Additional Test Tear Down Action For macipacl
    • 3.11.8.14. Additional Test Tear Down Action For namespace
    • 3.11.8.15. Additional Test Tear Down Action For nat-ed
    • 3.11.8.16. Additional Test Tear Down Action For packet_trace
    • 3.11.8.17. Additional Test Tear Down Action For telemetry
    • 3.11.8.18. Additional Test Tear Down Action For performance
    • 3.11.8.19. Additional Test Tear Down Action For srv6
    • 3.11.8.20. Additional Test Tear Down Action For vhost
    • 3.11.8.21. Additional Test Tear Down Action For vhost-pt
  • 3.11.9. traffic suite
    • 3.11.9.1. Send packet and verify headers
    • 3.11.9.2. Packet transmission from port to port should fail
    • 3.11.9.3. Send packet and verify marking
    • 3.11.9.4. Send VXLAN encapsulated packet and verify received packet
    • 3.11.9.5. Send ICMP echo request and verify answer
    • 3.11.9.6. Send IPsec Packet and verify ESP encapsulation in received packet
    • 3.11.9.7. Send packet and verify LISP encap
    • 3.11.9.8. Send IP Packet and verify ESP encapsulation in received packet
    • 3.11.9.9. Send packet and verify LISP GPE encap
    • 3.11.9.10. Send packet and verify LISPoTunnel encap
    • 3.11.9.11. Send IPv6 Packet and verify SRv6 encapsulation in received packet
    • 3.11.9.12. Send TCP or UDP packet and verify network address translations
    • 3.11.9.13. Send IP packet and verify GENEVE encapsulation in received packets
    • 3.11.9.14. Send flow packet and verify action
  • 3.11.10. vm suite
    • 3.11.10.1. Configure chains of NFs connected via vhost-user
    • 3.11.10.2. Configure chains of NFs connected via vhost-user on single node
    • 3.11.10.3. Configure chains of NFs connected via passtrough
• 3.12. wireguard
  • 3.12.1. wireguard suite
    • 3.12.1.1. Generate keys for WireGuard
    • 3.12.1.2. Initialize WireGuard in 3-node circular topology

3.13. index suite