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
    • 3.2.1. Testpmd Multi-Process 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 (module_eeprom|eeprom)
    • 4.4.3. set eeprom
    • 4.4.4. show port rss reta
    • 4.4.5. show port rss-hash
    • 4.4.6. clear port
    • 4.4.7. show (rxq|txq)
    • 4.4.8. show desc status(rxq|txq)
    • 4.4.9. show desc used count(rxq|txq)
    • 4.4.10. show config
    • 4.4.11. set fwd
    • 4.4.12. show fwd
    • 4.4.13. clear fwd
    • 4.4.14. read rxd
    • 4.4.15. read txd
    • 4.4.16. show vf stats
    • 4.4.17. clear vf stats
    • 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 port mac addresses info
    • 4.4.26. show port multicast mac addresses info
    • 4.4.27. show flow transfer proxy port ID for the given port
    • 4.4.28. show device info
    • 4.4.29. dump physmem
    • 4.4.30. dump memzone
    • 4.4.31. dump socket memory
    • 4.4.32. dump struct size
    • 4.4.33. dump ring
    • 4.4.34. dump mempool
    • 4.4.35. dump devargs
    • 4.4.36. dump lcores
    • 4.4.37. dump trace
    • 4.4.38. dump log types
    • 4.4.39. show (raw_encap|raw_decap)
    • 4.4.40. show fec capabilities
    • 4.4.41. show fec mode
  • 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 record-core-cycles
    • 4.5.9. set record-burst-stats
    • 4.5.10. set burst
    • 4.5.11. set rxoffs
    • 4.5.12. set rxpkts
    • 4.5.13. set rxhdrs
    • 4.5.14. set txpkts
    • 4.5.15. set txtimes
    • 4.5.16. set txsplit
    • 4.5.17. set corelist
    • 4.5.18. set portlist
    • 4.5.19. set port setup on
    • 4.5.20. set tx loopback
    • 4.5.21. set drop enable
    • 4.5.22. set mac antispoof (for VF)
    • 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 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. rx_vxlan_port add
    • 4.5.34. rx_vxlan_port remove
    • 4.5.35. tx_vlan set
    • 4.5.36. tx_vlan set pvid
    • 4.5.37. tx_vlan reset
    • 4.5.38. csum set
    • 4.5.39. csum parse-tunnel
    • 4.5.40. csum show
    • 4.5.41. tso set
    • 4.5.42. tso show
    • 4.5.43. tunnel tso set
    • 4.5.44. tunnel tso show
    • 4.5.45. set port - gro
    • 4.5.46. show port - gro
    • 4.5.47. set gro flush
    • 4.5.48. set port - gso
    • 4.5.49. set gso segsz
    • 4.5.50. show port - gso
    • 4.5.51. mac_addr add
    • 4.5.52. mac_addr remove
    • 4.5.53. mcast_addr add
    • 4.5.54. mcast_addr remove
    • 4.5.55. mcast_addr flush
    • 4.5.56. mac_addr add (for VF)
    • 4.5.57. mac_addr set
    • 4.5.58. mac_addr set (for VF)
    • 4.5.59. set eth-peer
    • 4.5.60. set port-uta
    • 4.5.61. set promisc
    • 4.5.62. set allmulti
    • 4.5.63. set flow_ctrl rx
    • 4.5.64. show flow control
    • 4.5.65. set pfc_ctrl rx
    • 4.5.66. set pfc_queue_ctrl
    • 4.5.67. Set Rx queue available descriptors threshold
    • 4.5.68. set stat_qmap
    • 4.5.69. set xstats-hide-zero
    • 4.5.70. set port - rx/tx (for VF)
    • 4.5.71. set port - rx mode(for VF)
    • 4.5.72. set port - tx_rate (for Queue)
    • 4.5.73. set port - tx_rate (for VF)
    • 4.5.74. set flush_rx
    • 4.5.75. set link up
    • 4.5.76. set link down
    • 4.5.77. E-tag set
    • 4.5.78. config per port Rx offloading
    • 4.5.79. config per queue Rx offloading
    • 4.5.80. config per port Tx offloading
    • 4.5.81. config per queue Tx offloading
    • 4.5.82. config per queue Tx affinity mapping
    • 4.5.83. Config VXLAN Encap outer layers
    • 4.5.84. Config NVGRE Encap outer layers
    • 4.5.85. Config L2 Encap
    • 4.5.86. Config L2 Decap
    • 4.5.87. Config MPLSoGRE Encap outer layers
    • 4.5.88. Config MPLSoGRE Decap outer layers
    • 4.5.89. Config MPLSoUDP Encap outer layers
    • 4.5.90. Config MPLSoUDP Decap outer layers
    • 4.5.91. Config Raw Encapsulation
    • 4.5.92. Config Raw Decapsulation
    • 4.5.93. Set fec mode
    • 4.5.94. Config Sample actions list
    • 4.5.95. set port led
  • 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 pctype mapping
    • 4.6.22. port config input set
    • 4.6.23. port config udp_tunnel_port
    • 4.6.24. port config tx_metadata
    • 4.6.25. port config dynf
    • 4.6.26. port config mtu
    • 4.6.27. port config rss hash key
    • 4.6.28. port config rss hash algorithm
    • 4.6.29. port cleanup txq mbufs
  • 4.7. Device Functions
    • 4.7.1. device detach
  • 4.8. Link Bonding Functions
  • 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 policy
    • 4.9.7. delete port policy
    • 4.9.8. create port meter
    • 4.9.9. enable port meter
    • 4.9.10. disable port meter
    • 4.9.11. delete port meter
    • 4.9.12. Set port meter profile
    • 4.9.13. set port meter dscp table
    • 4.9.14. set port meter vlan table
    • 4.9.15. set port meter protocol
    • 4.9.16. get port meter protocol
    • 4.9.17. get port meter protocol priority
    • 4.9.18. set port meter stats mask
    • 4.9.19. 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 nonleaf node with packet mode
    • 4.10.16. Add port traffic management hierarchy leaf node
    • 4.10.17. Query port traffic management hierarchy node
    • 4.10.18. Delete port traffic management hierarchy node
    • 4.10.19. Update port traffic management hierarchy parent node
    • 4.10.20. Suspend port traffic management hierarchy node
    • 4.10.21. Resume port traffic management hierarchy node
    • 4.10.22. Commit port traffic management hierarchy
    • 4.10.23. Set port traffic management mark VLAN dei
    • 4.10.24. Set port traffic management mark IP dscp
    • 4.10.25. Set port traffic management mark IP ecn
  • 4.11. Congestion Management
    • 4.11.1. Get capabilities
    • 4.11.2. Get configuration
    • 4.11.3. Set configuration
  • 4.12. Flow rules management
    • 4.12.1. flow syntax
    • 4.12.2. Retrieving info about flow management engine
    • 4.12.3. Configuring flow management engine
    • 4.12.4. Creating pattern templates
    • 4.12.5. Destroying pattern templates
    • 4.12.6. Creating actions templates
    • 4.12.7. Destroying actions templates
    • 4.12.8. Creating template table
    • 4.12.9. Destroying flow table
    • 4.12.10. Pushing enqueued operations
    • 4.12.11. Pulling flow operations results
    • 4.12.12. Calculating hash
    • 4.12.13. Simulate encap hash calculation
    • 4.12.14. Creating a tunnel stub for offload
    • 4.12.15. Destroying tunnel offload stub
    • 4.12.16. Listing tunnel offload stubs
    • 4.12.17. Validating flow rules
    • 4.12.18. Creating flow rules
    • 4.12.19. Enqueueing creation of flow rules
    • 4.12.20. Destroying flow rules
    • 4.12.21. Updating flow rules with new actions
    • 4.12.22. Enqueueing destruction of flow rules
    • 4.12.23. Querying flow rules
    • 4.12.24. Listing flow rules
    • 4.12.25. Toggling isolated mode
    • 4.12.26. Dumping HW internal information
    • 4.12.27. Listing and destroying aged flow rules
    • 4.12.28. Enqueueing listing and destroying aged flow rules
    • 4.12.29. Creating indirect actions
    • 4.12.30. Enqueueing creation of indirect actions
    • 4.12.31. Updating indirect actions
    • 4.12.32. Enqueueing update of indirect actions
    • 4.12.33. Destroying indirect actions
    • 4.12.34. Enqueueing destruction of indirect actions
    • 4.12.35. Query indirect actions
    • 4.12.36. Enqueueing query of indirect actions
    • 4.12.37. Sample QinQ flow rules
    • 4.12.38. Sample VXLAN flow rules
    • 4.12.39. Sample VXLAN encapsulation rule
    • 4.12.40. Sample NVGRE encapsulation rule
    • 4.12.41. Sample L2 encapsulation rule
    • 4.12.42. Sample L2 decapsulation rule
    • 4.12.43. Sample MPLSoGRE encapsulation rule
    • 4.12.44. Sample MPLSoGRE decapsulation rule
    • 4.12.45. Sample MPLSoUDP encapsulation rule
    • 4.12.46. Sample MPLSoUDP decapsulation rule
    • 4.12.47. Sample Raw encapsulation rule
    • 4.12.48. Sample Raw decapsulation rule
    • 4.12.49. Sample ESP rules
    • 4.12.50. Sample AH rules
    • 4.12.51. Sample PFCP rules
    • 4.12.52. Sample Sampling/Mirroring rules
    • 4.12.53. Sample integrity rules
    • 4.12.54. Sample conntrack rules
    • 4.12.55. Sample meter with policy rules
    • 4.12.56. Sample L2TPv2 RSS rules
    • 4.12.57. Sample L2TPv2 FDIR rules
    • 4.12.58. Sample RAW rule
    • 4.12.59. Sample match with comparison rule
  • 4.13. BPF Functions
    • 4.13.1. bpf-load
    • 4.13.2. bpf-unload
  • 4.14. Flex Item Functions
    • 4.14.1. Create flex item
    • 4.14.2. Flex pattern and flow rules
  • 4.15. Driver specific commands