Testpmd Application User Guide

• 1. Introduction
• 2. Compiling the Application
• 3. Running the Application
  • 3.1. EAL Command-line Options
  • 3.2. Testpmd Command-line Options
• 4. Testpmd Runtime Functions
  • 4.1. Help Functions
  • 4.2. Command File Functions
  • 4.3. Control Functions
    • 4.3.1. start
    • 4.3.2. start tx_first
    • 4.3.3. stop
    • 4.3.4. quit
  • 4.4. Display Functions
    • 4.4.1. show port
    • 4.4.2. show port rss reta
    • 4.4.3. show port rss-hash
    • 4.4.4. clear port
    • 4.4.5. show (rxq|txq)
    • 4.4.6. show desc status(rxq|txq)
    • 4.4.7. show config
    • 4.4.8. set fwd
    • 4.4.9. show fwd
    • 4.4.10. clear fwd
    • 4.4.11. read rxd
    • 4.4.12. read txd
    • 4.4.13. ddp get list
    • 4.4.14. ddp get info
    • 4.4.15. show vf stats
    • 4.4.16. clear vf stats
    • 4.4.17. show port pctype mapping
    • 4.4.18. show rx offloading capabilities
    • 4.4.19. show rx offloading configuration
    • 4.4.20. show tx offloading capabilities
    • 4.4.21. show tx offloading configuration
    • 4.4.22. show tx metadata setting
    • 4.4.23. show port supported ptypes
    • 4.4.24. set port supported ptypes
    • 4.4.25. show device info
    • 4.4.26. dump physmem
    • 4.4.27. dump memzone
    • 4.4.28. dump struct size
    • 4.4.29. dump ring
    • 4.4.30. dump mempool
    • 4.4.31. dump devargs
    • 4.4.32. dump log types
    • 4.4.33. show (raw_encap|raw_decap)
  • 4.5. Configuration Functions
    • 4.5.1. set default
    • 4.5.2. set verbose
    • 4.5.3. set log
    • 4.5.4. set nbport
    • 4.5.5. set nbcore
    • 4.5.6. set coremask
    • 4.5.7. set portmask
    • 4.5.8. set burst
    • 4.5.9. set txpkts
    • 4.5.10. set txsplit
    • 4.5.11. set corelist
    • 4.5.12. set portlist
    • 4.5.13. set port setup on
    • 4.5.14. set tx loopback
    • 4.5.15. set drop enable
    • 4.5.16. set split drop enable (for VF)
    • 4.5.17. set mac antispoof (for VF)
    • 4.5.18. set macsec offload
    • 4.5.19. set macsec sc
    • 4.5.20. set macsec sa
    • 4.5.21. set broadcast mode (for VF)
    • 4.5.22. vlan set stripq
    • 4.5.23. vlan set stripq (for VF)
    • 4.5.24. vlan set insert (for VF)
    • 4.5.25. vlan set tag (for VF)
    • 4.5.26. vlan set antispoof (for VF)
    • 4.5.27. vlan set (strip|filter|qinq_strip|extend)
    • 4.5.28. vlan set tpid
    • 4.5.29. rx_vlan add
    • 4.5.30. rx_vlan rm
    • 4.5.31. rx_vlan add (for VF)
    • 4.5.32. rx_vlan rm (for VF)
    • 4.5.33. tunnel_filter add
    • 4.5.34. tunnel_filter remove
    • 4.5.35. rx_vxlan_port add
    • 4.5.36. rx_vxlan_port remove
    • 4.5.37. tx_vlan set
    • 4.5.38. tx_vlan set pvid
    • 4.5.39. tx_vlan reset
    • 4.5.40. csum set
    • 4.5.41. RSS queue region
    • 4.5.42. csum parse-tunnel
    • 4.5.43. csum show
    • 4.5.44. tso set
    • 4.5.45. tso show
    • 4.5.46. tunnel tso set
    • 4.5.47. tunnel tso show
    • 4.5.48. set port - gro
    • 4.5.49. show port - gro
    • 4.5.50. set gro flush
    • 4.5.51. set port - gso
    • 4.5.52. set gso segsz
    • 4.5.53. show port - gso
    • 4.5.54. mac_addr add
    • 4.5.55. mac_addr remove
    • 4.5.56. mcast_addr add
    • 4.5.57. mcast_addr remove
    • 4.5.58. mac_addr add (for VF)
    • 4.5.59. mac_addr set
    • 4.5.60. mac_addr set (for VF)
    • 4.5.61. set eth-peer
    • 4.5.62. set port-uta
    • 4.5.63. set promisc
    • 4.5.64. set allmulti
    • 4.5.65. set promisc (for VF)
    • 4.5.66. set allmulticast (for VF)
    • 4.5.67. set tx max bandwidth (for VF)
    • 4.5.68. set tc tx min bandwidth (for VF)
    • 4.5.69. set tc tx max bandwidth (for VF)
    • 4.5.70. set tc strict link priority mode
    • 4.5.71. set tc tx min bandwidth
    • 4.5.72. set flow_ctrl rx
    • 4.5.73. set pfc_ctrl rx
    • 4.5.74. set stat_qmap
    • 4.5.75. set xstats-hide-zero
    • 4.5.76. set port - rx/tx (for VF)
    • 4.5.77. set port - mac address filter (for VF)
    • 4.5.78. set port - rx mode(for VF)
    • 4.5.79. set port - tx_rate (for Queue)
    • 4.5.80. set port - tx_rate (for VF)
    • 4.5.81. set port - mirror rule
    • 4.5.82. reset port - mirror rule
    • 4.5.83. set flush_rx
    • 4.5.84. set bypass mode
    • 4.5.85. set bypass event
    • 4.5.86. set bypass timeout
    • 4.5.87. show bypass config
    • 4.5.88. set link up
    • 4.5.89. set link down
    • 4.5.90. E-tag set
    • 4.5.91. ddp add
    • 4.5.92. ddp del
    • 4.5.93. ptype mapping
    • 4.5.94. config per port Rx offloading
    • 4.5.95. config per queue Rx offloading
    • 4.5.96. config per port Tx offloading
    • 4.5.97. config per queue Tx offloading
    • 4.5.98. Config VXLAN Encap outer layers
    • 4.5.99. Config NVGRE Encap outer layers
    • 4.5.100. Config L2 Encap
    • 4.5.101. Config L2 Decap
    • 4.5.102. Config MPLSoGRE Encap outer layers
    • 4.5.103. Config MPLSoGRE Decap outer layers
    • 4.5.104. Config MPLSoUDP Encap outer layers
    • 4.5.105. Config MPLSoUDP Decap outer layers
    • 4.5.106. Config Raw Encapsulation
    • 4.5.107. Config Raw Decapsulation
  • 4.6. Port Functions
    • 4.6.1. port attach
    • 4.6.2. port detach
    • 4.6.3. port start
    • 4.6.4. port stop
    • 4.6.5. port close
    • 4.6.6. port reset
    • 4.6.7. port config - queue ring size
    • 4.6.8. port start/stop queue
    • 4.6.9. port config - queue deferred start
    • 4.6.10. port setup queue
    • 4.6.11. port config - speed
    • 4.6.12. port config - queues/descriptors
    • 4.6.13. port config - max-pkt-len
    • 4.6.14. port config - max-lro-pkt-size
    • 4.6.15. port config - Drop Packets
    • 4.6.16. port config - RSS
    • 4.6.17. port config - RSS Reta
    • 4.6.18. port config - DCB
    • 4.6.19. port config - Burst
    • 4.6.20. port config - Threshold
    • 4.6.21. port config - E-tag
    • 4.6.22. port config pctype mapping
    • 4.6.23. port config input set
    • 4.6.24. port config udp_tunnel_port
    • 4.6.25. port config tx_metadata
    • 4.6.26. port config mtu
    • 4.6.27. port config rss hash key
  • 4.7. Device Functions
    • 4.7.1. device detach
  • 4.8. Link Bonding Functions
    • 4.8.1. create bonded device
    • 4.8.2. add bonding slave
    • 4.8.3. remove bonding slave
    • 4.8.4. set bonding mode
    • 4.8.5. set bonding primary
    • 4.8.6. set bonding mac
    • 4.8.7. set bonding balance_xmit_policy
    • 4.8.8. set bonding mon_period
    • 4.8.9. set bonding lacp dedicated_queue
    • 4.8.10. set bonding agg_mode
    • 4.8.11. show bonding config
  • 4.9. Register Functions
    • 4.9.1. read reg
    • 4.9.2. read regfield
    • 4.9.3. read regbit
    • 4.9.4. write reg
    • 4.9.5. write regfield
    • 4.9.6. write regbit
  • 4.10. Traffic Metering and Policing
    • 4.10.1. show port traffic management capability
    • 4.10.2. add port meter profile (srTCM rfc2967)
    • 4.10.3. add port meter profile (trTCM rfc2968)
    • 4.10.4. add port meter profile (trTCM rfc4115)
    • 4.10.5. delete port meter profile
    • 4.10.6. create port meter
    • 4.10.7. enable port meter
    • 4.10.8. disable port meter
    • 4.10.9. delete port meter
    • 4.10.10. Set port meter profile
    • 4.10.11. set port meter dscp table
    • 4.10.12. set port meter policer action
    • 4.10.13. set port meter stats mask
    • 4.10.14. show port meter stats
  • 4.11. Traffic Management
    • 4.11.1. show port traffic management capability
    • 4.11.2. show port traffic management capability (hierarchy level)
    • 4.11.3. show port traffic management capability (hierarchy node level)
    • 4.11.4. show port traffic management hierarchy node type
    • 4.11.5. show port traffic management hierarchy node stats
    • 4.11.6. Add port traffic management private shaper profile
    • 4.11.7. Delete port traffic management private shaper profile
    • 4.11.8. Add port traffic management shared shaper
    • 4.11.9. Set port traffic management shared shaper
    • 4.11.10. Delete port traffic management shared shaper
    • 4.11.11. Set port traffic management hierarchy node private shaper
    • 4.11.12. Add port traffic management WRED profile
    • 4.11.13. Delete port traffic management WRED profile
    • 4.11.14. Add port traffic management hierarchy nonleaf node
    • 4.11.15. Add port traffic management hierarchy leaf node
    • 4.11.16. Delete port traffic management hierarchy node
    • 4.11.17. Update port traffic management hierarchy parent node
    • 4.11.18. Suspend port traffic management hierarchy node
    • 4.11.19. Resume port traffic management hierarchy node
    • 4.11.20. Commit port traffic management hierarchy
    • 4.11.21. Set port traffic management mark VLAN dei
    • 4.11.22. Set port traffic management mark IP dscp
    • 4.11.23. Set port traffic management mark IP ecn
    • 4.11.24. Set port traffic management default hierarchy (softnic forwarding mode)
  • 4.12. Filter Functions
    • 4.12.1. ethertype_filter
    • 4.12.2. 2tuple_filter
    • 4.12.3. 5tuple_filter
    • 4.12.4. syn_filter
    • 4.12.5. flex_filter
    • 4.12.6. flow_director_filter
    • 4.12.7. flush_flow_director
    • 4.12.8. flow_director_mask
    • 4.12.9. flow_director_flex_mask
    • 4.12.10. flow_director_flex_payload
    • 4.12.11. get_sym_hash_ena_per_port
    • 4.12.12. set_sym_hash_ena_per_port
    • 4.12.13. get_hash_global_config
    • 4.12.14. set_hash_global_config
    • 4.12.15. set_hash_input_set
    • 4.12.16. set_fdir_input_set
    • 4.12.17. global_config
  • 4.13. Flow rules management
    • 4.13.1. flow syntax
    • 4.13.2. Validating flow rules
    • 4.13.3. Creating flow rules
    • 4.13.4. Destroying flow rules
    • 4.13.5. Querying flow rules
    • 4.13.6. Listing flow rules
    • 4.13.7. Toggling isolated mode
    • 4.13.8. Sample QinQ flow rules
    • 4.13.9. Sample VXLAN encapsulation rule
    • 4.13.10. Sample NVGRE encapsulation rule
    • 4.13.11. Sample L2 encapsulation rule
    • 4.13.12. Sample L2 decapsulation rule
    • 4.13.13. Sample MPLSoGRE encapsulation rule
    • 4.13.14. Sample MPLSoGRE decapsulation rule
    • 4.13.15. Sample MPLSoUDP encapsulation rule
    • 4.13.16. Sample MPLSoUDP decapsulation rule
    • 4.13.17. Sample Raw encapsulation rule
    • 4.13.18. Sample Raw decapsulation rule
  • 4.14. BPF Functions
    • 4.14.1. bpf-load
    • 4.14.2. bpf-unload