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 config
    • 4.4.7. set fwd
    • 4.4.8. show fwd
    • 4.4.9. clear fwd
    • 4.4.10. read rxd
    • 4.4.11. read txd
    • 4.4.12. ddp get list
    • 4.4.13. ddp get info
    • 4.4.14. show vf stats
    • 4.4.15. clear vf stats
    • 4.4.16. show port pctype mapping
    • 4.4.17. show rx offloading capabilities
    • 4.4.18. show rx offloading configuration
    • 4.4.19. show tx offloading capabilities
    • 4.4.20. show tx offloading configuration
    • 4.4.21. show tx metadata setting
    • 4.4.22. dump physmem
    • 4.4.23. dump memzone
    • 4.4.24. dump struct size
    • 4.4.25. dump ring
    • 4.4.26. dump mempool
    • 4.4.27. dump devargs
    • 4.4.28. dump log types
  • 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 strip
    • 4.5.23. vlan set stripq
    • 4.5.24. vlan set stripq (for VF)
    • 4.5.25. vlan set insert (for VF)
    • 4.5.26. vlan set tag (for VF)
    • 4.5.27. vlan set antispoof (for VF)
    • 4.5.28. vlan set filter
    • 4.5.29. vlan set qinq
    • 4.5.30. vlan set tpid
    • 4.5.31. rx_vlan add
    • 4.5.32. rx_vlan rm
    • 4.5.33. rx_vlan add (for VF)
    • 4.5.34. rx_vlan rm (for VF)
    • 4.5.35. tunnel_filter add
    • 4.5.36. tunnel_filter remove
    • 4.5.37. rx_vxlan_port add
    • 4.5.38. rx_vxlan_port remove
    • 4.5.39. tx_vlan set
    • 4.5.40. tx_vlan set pvid
    • 4.5.41. tx_vlan reset
    • 4.5.42. csum set
    • 4.5.43. RSS queue region
    • 4.5.44. csum parse-tunnel
    • 4.5.45. csum show
    • 4.5.46. tso set
    • 4.5.47. tso show
    • 4.5.48. tunnel tso set
    • 4.5.49. tunnel tso show
    • 4.5.50. set port - gro
    • 4.5.51. show port - gro
    • 4.5.52. set gro flush
    • 4.5.53. set port - gso
    • 4.5.54. set gso segsz
    • 4.5.55. show port - gso
    • 4.5.56. mac_addr add
    • 4.5.57. mac_addr remove
    • 4.5.58. mcast_addr add
    • 4.5.59. mcast_addr remove
    • 4.5.60. mac_addr add (for VF)
    • 4.5.61. mac_addr set
    • 4.5.62. mac_addr set (for VF)
    • 4.5.63. set eth-peer
    • 4.5.64. set port-uta
    • 4.5.65. set promisc
    • 4.5.66. set allmulti
    • 4.5.67. set promisc (for VF)
    • 4.5.68. set allmulticast (for VF)
    • 4.5.69. set tx max bandwidth (for VF)
    • 4.5.70. set tc tx min bandwidth (for VF)
    • 4.5.71. set tc tx max bandwidth (for VF)
    • 4.5.72. set tc strict link priority mode
    • 4.5.73. set tc tx min bandwidth
    • 4.5.74. set flow_ctrl rx
    • 4.5.75. set pfc_ctrl rx
    • 4.5.76. set stat_qmap
    • 4.5.77. set xstats-hide-zero
    • 4.5.78. set port - rx/tx (for VF)
    • 4.5.79. set port - mac address filter (for VF)
    • 4.5.80. set port - rx mode(for VF)
    • 4.5.81. set port - tx_rate (for Queue)
    • 4.5.82. set port - tx_rate (for VF)
    • 4.5.83. set port - mirror rule
    • 4.5.84. reset port - mirror rule
    • 4.5.85. set flush_rx
    • 4.5.86. set bypass mode
    • 4.5.87. set bypass event
    • 4.5.88. set bypass timeout
    • 4.5.89. show bypass config
    • 4.5.90. set link up
    • 4.5.91. set link down
    • 4.5.92. E-tag set
    • 4.5.93. ddp add
    • 4.5.94. ddp del
    • 4.5.95. ptype mapping
    • 4.5.96. config per port Rx offloading
    • 4.5.97. config per queue Rx offloading
    • 4.5.98. config per port Tx offloading
    • 4.5.99. config per queue Tx offloading
    • 4.5.100. Config VXLAN Encap outer layers
    • 4.5.101. Config NVGRE Encap outer layers
    • 4.5.102. Config L2 Encap
    • 4.5.103. Config L2 Decap
    • 4.5.104. Config MPLSoGRE Encap outer layers
    • 4.5.105. Config MPLSoGRE Decap outer layers
    • 4.5.106. Config MPLSoUDP Encap outer layers
    • 4.5.107. Config MPLSoUDP Decap outer layers
  • 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 config - queue ring size
    • 4.6.7. port start/stop queue
    • 4.6.8. port config - queue deferred start
    • 4.6.9. port setup queue
    • 4.6.10. port config - speed
    • 4.6.11. port config - queues/descriptors
    • 4.6.12. port config - max-pkt-len
    • 4.6.13. port config - CRC Strip
    • 4.6.14. port config - scatter
    • 4.6.15. port config - RX Checksum
    • 4.6.16. port config - VLAN
    • 4.6.17. port config - VLAN filter
    • 4.6.18. port config - VLAN strip
    • 4.6.19. port config - VLAN extend
    • 4.6.20. port config - Drop Packets
    • 4.6.21. port config - RSS
    • 4.6.22. port config - RSS Reta
    • 4.6.23. port config - DCB
    • 4.6.24. port config - Burst
    • 4.6.25. port config - Threshold
    • 4.6.26. port config - E-tag
    • 4.6.27. port config pctype mapping
    • 4.6.28. port config input set
    • 4.6.29. port config udp_tunnel_port
    • 4.6.30. port config tx_metadata
    • 4.6.31. port config mtu
    • 4.6.32. port config rss hash key
  • 4.7. Link Bonding Functions
    • 4.7.1. create bonded device
    • 4.7.2. add bonding slave
    • 4.7.3. remove bonding slave
    • 4.7.4. set bonding mode
    • 4.7.5. set bonding primary
    • 4.7.6. set bonding mac
    • 4.7.7. set bonding xmit_balance_policy
    • 4.7.8. set bonding mon_period
    • 4.7.9. set bonding lacp dedicated_queue
    • 4.7.10. set bonding agg_mode
    • 4.7.11. show bonding config
  • 4.8. Register Functions
    • 4.8.1. read reg
    • 4.8.2. read regfield
    • 4.8.3. read regbit
    • 4.8.4. write reg
    • 4.8.5. write regfield
    • 4.8.6. write regbit
  • 4.9. Traffic Metering and Policing
    • 4.9.1. show port traffic management capability
    • 4.9.2. add port meter profile (srTCM rfc2967)
    • 4.9.3. add port meter profile (trTCM rfc2968)
    • 4.9.4. add port meter profile (trTCM rfc4115)
    • 4.9.5. delete port meter profile
    • 4.9.6. create port meter
    • 4.9.7. enable port meter
    • 4.9.8. disable port meter
    • 4.9.9. delete port meter
    • 4.9.10. Set port meter profile
    • 4.9.11. set port meter dscp table
    • 4.9.12. set port meter policer action
    • 4.9.13. set port meter stats mask
    • 4.9.14. show port meter stats
  • 4.10. Traffic Management
    • 4.10.1. show port traffic management capability
    • 4.10.2. show port traffic management capability (hierarchy level)
    • 4.10.3. show port traffic management capability (hierarchy node level)
    • 4.10.4. show port traffic management hierarchy node type
    • 4.10.5. show port traffic management hierarchy node stats
    • 4.10.6. Add port traffic management private shaper profile
    • 4.10.7. Delete port traffic management private shaper profile
    • 4.10.8. Add port traffic management shared shaper
    • 4.10.9. Set port traffic management shared shaper
    • 4.10.10. Delete port traffic management shared shaper
    • 4.10.11. Set port traffic management hierarchy node private shaper
    • 4.10.12. Add port traffic management WRED profile
    • 4.10.13. Delete port traffic management WRED profile
    • 4.10.14. Add port traffic management hierarchy nonleaf node
    • 4.10.15. Add port traffic management hierarchy leaf node
    • 4.10.16. Delete port traffic management hierarchy node
    • 4.10.17. Update port traffic management hierarchy parent node
    • 4.10.18. Suspend port traffic management hierarchy node
    • 4.10.19. Resume port traffic management hierarchy node
    • 4.10.20. Commit port traffic management hierarchy
    • 4.10.21. Set port traffic management mark VLAN dei
    • 4.10.22. Set port traffic management mark IP dscp
    • 4.10.23. Set port traffic management mark IP ecn
    • 4.10.24. Set port traffic management default hierarchy (softnic forwarding mode)
  • 4.11. Filter Functions
    • 4.11.1. ethertype_filter
    • 4.11.2. 2tuple_filter
    • 4.11.3. 5tuple_filter
    • 4.11.4. syn_filter
    • 4.11.5. flex_filter
    • 4.11.6. flow_director_filter
    • 4.11.7. flush_flow_director
    • 4.11.8. flow_director_mask
    • 4.11.9. flow_director_flex_mask
    • 4.11.10. flow_director_flex_payload
    • 4.11.11. get_sym_hash_ena_per_port
    • 4.11.12. set_sym_hash_ena_per_port
    • 4.11.13. get_hash_global_config
    • 4.11.14. set_hash_global_config
    • 4.11.15. set_hash_input_set
    • 4.11.16. set_fdir_input_set
    • 4.11.17. global_config
  • 4.12. Flow rules management
    • 4.12.1. flow syntax
    • 4.12.2. Validating flow rules
    • 4.12.3. Creating flow rules
    • 4.12.4. Destroying flow rules
    • 4.12.5. Querying flow rules
    • 4.12.6. Listing flow rules
    • 4.12.7. Toggling isolated mode
    • 4.12.8. Sample QinQ flow rules
    • 4.12.9. Sample VXLAN encapsulation rule
    • 4.12.10. Sample NVGRE encapsulation rule
    • 4.12.11. Sample L2 encapsulation rule
    • 4.12.12. Sample L2 decapsulation rule
    • 4.12.13. Sample MPLSoGRE encapsulation rule
    • 4.12.14. Sample MPLSoGRE decapsulation rule
    • 4.12.15. Sample MPLSoUDP encapsulation rule
    • 4.12.16. Sample MPLSoUDP decapsulation rule
  • 4.13. BPF Functions
    • 4.13.1. bpf-load
    • 4.13.2. bpf-unload