help display : Displaying port, stats and config information.
help config : Configuration information.
help ports : Configuring ports.
- help flowdir : Flow Director filter help.
help registers : Reading and setting port registers.
help filters : Filters configuration help.
help all : All of the above sections.
filter on
qinq(extend) off
+show port rss reta
+~~~~~~~~~~~~~~~~~~
+
+Display the rss redirection table entry indicated by masks on port X:
+
+show port (port_id) rss reta (size) (mask0, mask1...)
+
+size is used to indicate the hardware supported reta size
+
show port rss-hash
~~~~~~~~~~~~~~~~~~
-Display the RSS hash functions and RSS hash key of port (port_id).
+Display the RSS hash functions and RSS hash key of a port:
+
+show port (port_id) rss-hash [key]
-show port (port_id) rss-hash [key] clear port
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+clear port
+~~~~~~~~~~
Clear the port statistics for a given port or for all ports:
.. note::
VLAN filter must be set on that port. VLAN ID < 4096.
+ Depending on the NIC used, number of vlan_ids may be limited to the maximum entries
+ in VFTA table. This is important if enabling all vlan_ids.
rx_vlan rm
~~~~~~~~~~
rx_vlan rm (vlan_id) port (port_id) vf (vf_mask)
-tx_rate (for Queue)
-~~~~~~~~~~~~~~~~~~~
+rx_vlan set tpid
+~~~~~~~~~~~~~~~~
-Set TX rate limitation for queue of a port ID:
+Set the outer VLAN TPID for packet filtering on a port:
-set port (port_id) queue (queue_id) rate (rate_value)
+rx_vlan set tpid (value) (port_id)
-tx_rate (for VF)
-~~~~~~~~~~~~~~~~
+tunnel_filter add
+~~~~~~~~~~~~~~~~~
-Set TX rate limitation for queues in VF of a port ID:
+Add a tunnel filter on a port:
-set port (port_id) vf (vf_id) rate (rate_value) queue_mask (queue_mask)
+tunnel_filter add (port_id) (outer_mac) (inner_mac) (ip_addr) (inner_vlan)
+ (tunnel_type) (filter_type) (tenant_id) (queue_id)
-rx_vlan set tpid
-~~~~~~~~~~~~~~~~
+tunnel_filter remove
+~~~~~~~~~~~~~~~~~~~~
-Set the outer VLAN TPID for packet filtering on a port:
+Remove a tunnel filter on a port:
-rx_vlan set tpid (value) (port_id)
+tunnel_filter rm (port_id) (outer_mac) (inner_mac) (ip_addr) (inner_vlan)
+ (tunnel_type) (filter_type) (tenant_id) (queue_id)
+
+rx_vxlan_port add
+~~~~~~~~~~~~~~~~~
+
+Add an UDP port for VXLAN packet filter on a port:
+
+rx_vxlan_port add (udp_port) (port_id)
+
+rx_vxlan_port remove
+~~~~~~~~~~~~~~~~~~~~
+
+Remove an UDP port for VXLAN packet filter on a port:
+
+rx_vxlan_port rm (udp_port) (port_id)
tx_vlan set
~~~~~~~~~~~
tx_vlan reset (port_id)
-tx_checksum set mask
-~~~~~~~~~~~~~~~~~~~~
+tx_checksum set
+~~~~~~~~~~~~~~~
+
+Select hardware or software calculation of the checksum when
+transmitting a packet using the csum forward engine:
+
+tx_cksum set (ip|udp|tcp|sctp|vxlan)
+
+ip|udp|tcp|sctp always concern the inner layer.
+vxlan concerns the outer IP and UDP layer (in case the packet
+is recognized as a vxlan packet by the forward engine)
-Enable hardware insertion of checksum offload with a 4-bit mask, 0x0 - 0xF, in packets sent on a port:
+.. note::
+
+ Check the NIC Datasheet for hardware limits.
-tx_checksum set (mask) (port_id)
+tx_checksum show
+~~~~~~~~~~~~~~~~
-The bits in the mask are:
+Display tx checksum offload configuration:
-bit 0 - if set insert ip checksum offload
+tx_checksum show (port_id)
-bit 1 - if set insert udp checksum offload
+tso set
+~~~~~~~
-bit 2 - if set insert tcp checksum offload
+Enable TCP Segmentation Offload in csum forward engine:
-bit 3 - if set insert sctp checksum offload
+tso set (segsize) (port_id)
.. note::
+ Please check the NIC datasheet for HW limits
- Check the NIC Datasheet for hardware limits.
+tso show
+~~~~~~~~
+
+Display the status of TCP Segmentation Offload:
+tso show (port_id)
set fwd
~~~~~~~
set port (port_id) vf (vf_id) (rx|tx) (on|off)
+set port - mac address filter (for VF)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Add/Remove unicast or multicast MAC addr filter for a VF:
+
+set port (port_id) vf (vf_id) (mac_addr)
+ (exact-mac|exact-mac-vlan|hashmac|hashmac-vlan) (on|off)
+
set port - rx mode(for VF)
~~~~~~~~~~~~~~~~~~~~~~~~~~
* MPE: accepts all multicast packets
+set port - tx_rate (for Queue)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Set TX rate limitation for queue of a port ID:
+
+set port (port_id) queue (queue_id) rate (rate_value)
+
+set port - tx_rate (for VF)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Set TX rate limitation for queues in VF of a port ID:
+
+set port (port_id) vf (vf_id) rate (rate_value) queue_mask (queue_mask)
+
set port - mirror rule
~~~~~~~~~~~~~~~~~~~~~~
show bypass config (port_id)
-add_ethertype_filter
-~~~~~~~~~~~~~~~~~~~~
+set link up
+~~~~~~~~~~~
-Add a L2 Ethertype filter, which identify packets by their L2 Ethertype mainly assign them to a receive queue.
+Set link up for a port.
-add_ethertype_filter (port_id) ethertype (eth_value) priority (enable|disable) (pri_value) queue (queue_id) index (idx)
+set link-up port (port id)
-The available information parameters are:
+set link down
+~~~~~~~~~~~~~
-* port_id: the port which the Ethertype filter assigned on.
+Set link down for a port.
-* eth_value: the EtherType value want to match,
- for example 0x0806 for ARP packet. 0x0800 (IPv4) and 0x86DD (IPv6) are invalid.
+set link-down port (port id)
-* enable: user priority participates in the match.
+Port Functions
+--------------
-* disable: user priority doesn't participate in the match.
+The following sections show functions for configuring ports.
-* pri_value: user priority value that want to match.
+.. note::
-* queue_id : The receive queue associated with this EtherType filter
+ Port configuration changes only become active when forwarding is started/restarted.
-* index: the index of this EtherType filter
+port attach
+~~~~~~~~~~~
-Example:
+Attach a port specified by pci address or virtual device args.
-.. code-block:: console
+To attach a new pci device, the device should be recognized by kernel first.
+Then it should be moved under DPDK management.
+Finally the port can be attached to testpmd.
+On the other hand, to attach a port created by virtual device, above steps are not needed.
- testpmd> add_ethertype_filter 0 ethertype 0x0806 priority disable 0 queue 3 index 0
- Assign ARP packet to receive queue 3
+port attach (identifier)
-remove_ethertype_filter
-~~~~~~~~~~~~~~~~~~~~~~~
+For example, to attach a port whose pci address is 0000:02:00.0.
-Remove a L2 Ethertype filter
+.. code-block:: console
-remove_ethertype_filter (port_id) index (idx)
+ testpmd> port attach 0000:02:00.0
+ Attaching a new port...
+ ... snip ...
+ Port 0 is attached. Now total ports is 1
+ Done
-get_ethertype_filter
-~~~~~~~~~~~~~~~~~~~~
+For example, to attach a port created by pcap PMD.
-Get and display a L2 Ethertype filter
+.. code-block:: console
-get_ethertype_filter (port_id) index (idx)
+ testpmd> port attach eth_pcap0,iface=eth0
+ Attaching a new port...
+ ... snip ...
+ Port 0 is attached. Now total ports is 1
+ Done
-Example:
+In this case, identifier is "eth_pcap0,iface=eth0".
+This identifier format is the same as "--vdev" format of DPDK applications.
-.. code-block:: console
+port detach
+~~~~~~~~~~~
- testpmd> get_ethertype_filter 0 index 0
+Detach a specific port.
- filter[0]:
- ethertype: 0x0806
- priority: disable, 0
- queue: 3
+Before detaching a port, the port should be closed.
+Also to remove a pci device completely from the system, first detach the port from testpmd.
+Then the device should be moved under kernel management.
+Finally the device can be removed using kernel pci hotplug functionality.
+On the other hand, to remove a port created by a virtual device, above steps are not needed.
-add_2tuple_filter
-~~~~~~~~~~~~~~~~~
+port detach (port_id)
-Add a 2-tuple filter,
-which identify packets by specific protocol and destination TCP/UDP port
-and forwards packets into one of the receive queues.
+For example, to detach a port 0.
+
+.. code-block:: console
-add_2tuple_filter (port_id) protocol (pro_value) (pro_mask) dst_port (port_value) (port_mask)
-flags (flg_value) priority (prio_value) queue (queue_id) index (idx)
+ testpmd> port detach 0
+ Detaching a port...
+ ... snip ...
+ Done
-The available information parameters are:
+port start
+~~~~~~~~~~
-* port_id: the port which the 2-tuple filter assigned on.
+Start all ports or a specific port:
-* pro_value: IP L4 protocol
+port start (port_id|all)
-* pro_mask: protocol participates in the match or not, 1 means participate
+port stop
+~~~~~~~~~
-* port_value: destination port in L4.
+Stop all ports or a specific port:
-* port_mask: destination port participates in the match or not, 1 means participate.
+port stop (port_id|all)
-* flg_value: TCP control bits. The non-zero value is invalid, when the pro_value is not set to 0x06 (TCP).
+port close
+~~~~~~~~~~
-* prio_value: the priority of this filter.
+Close all ports or a specific port:
-* queue_id: The receive queue associated with this 2-tuple filter
+port close (port_id|all)
-* index: the index of this 2-tuple filter
+port start/stop queue
+~~~~~~~~~~~~~~~~~~~~~
-Example:
+Start/stop a rx/tx queue on a specific port:
-.. code-block:: console
+port (port_id) (rxq|txq) (queue_id) (start|stop)
- testpmd> add_2tuple_filter 0 protocol 0x06 1 dst_port 32 1 flags 0x02 priority 3 queue 3 index 0
+Only take effect when port is started.
-remove_2tuple_filter
-~~~~~~~~~~~~~~~~~~~~
+port config - speed
+~~~~~~~~~~~~~~~~~~~
-Remove a 2-tuple filter
+Set the speed and duplex mode for all ports or a specific port:
-remove_2tuple_filter (port_id) index (idx)
+port config (port_id|all) speed (10|100|1000|10000|auto) duplex (half|full|auto)
-get_2tuple_filter
-~~~~~~~~~~~~~~~~~
+port config - queues/descriptors
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-Get and display a 2-tuple filter
+Set number of queues/descriptors for rxq, txq, rxd and txd:
-get_2tuple_filter (port_id) index (idx)
+port config all (rxq|txq|rxd|txd) (value)
-Example:
+This is equivalent to the --rxq, --txq, --rxd and --txd command-line options.
-.. code-block:: console
+port config - max-pkt-len
+~~~~~~~~~~~~~~~~~~~~~~~~~
- testpmd> get_2tuple_filter 0 index 0
+Set the maximum packet length:
- filter[0]:
- Destination Port: 0x0020 mask: 1
- protocol: 0x06 mask:1 tcp_flags: 0x02
- priority: 3 queue: 3
+port config all max-pkt-len (value)
-add_5tuple_filter
-~~~~~~~~~~~~~~~~~
+This is equivalent to the --max-pkt-len command-line option.
-Add a 5-tuple filter,
-which consists of a 5-tuple (protocol, source and destination IP addresses, source and destination TCP/UDP/SCTP port)
-and routes packets into one of the receive queues.
+port config - CRC Strip
+~~~~~~~~~~~~~~~~~~~~~~~
-add_5tuple_filter (port_id) dst_ip (dst_address) src_ip (src_address) dst_port (dst_port_value) src_port (src_port_value)
-protocol (protocol_value) mask (mask_value) flags (flags_value) priority (prio_value) queue (queue_id) index (idx)
+Set hardware CRC stripping on or off for all ports:
-The available information parameters are:
+port config all crc-strip (on|off)
-* port_id: the port which the 5-tuple filter assigned on.
+CRC stripping is off by default.
-* dst_address: destination IP address.
+The on option is equivalent to the --crc-strip command-line option.
-* src_address: source IP address.
+port config - RX Checksum
+~~~~~~~~~~~~~~~~~~~~~~~~~
-* dst_port_value: TCP/UDP destination port.
+Set hardware RX checksum offload to on or off for all ports:
-* src_port_value: TCP/UDP source port.
+port config all rx-cksum (on|off)
-* protocol_value: L4 protocol.
+Checksum offload is off by default.
-* mask_value: participates in the match or not by bit for field above, 1b means participate
+The on option is equivalent to the --enable-rx-cksum command-line option.
-* flags_value: TCP control bits. The non-zero value is invalid, when the protocol_value is not set to 0x06 (TCP).
+port config - VLAN
+~~~~~~~~~~~~~~~~~~
-* prio_value: the priority of this filter.
+Set hardware VLAN on or off for all ports:
-* queue_id: The receive queue associated with this 5-tuple filter.
+port config all hw-vlan (on|off)
-* index: the index of this 5-tuple filter
+Hardware VLAN is on by default.
-Example:
+The off option is equivalent to the --disable-hw-vlan command-line option.
-.. code-block:: console
+port config - VLAN filter
+~~~~~~~~~~~~~~~~~~~~~~~~~
- testpmd> add_5tuple_filter 1 dst_ip 2.2.2.5 src_ip 2.2.2.4 dst_port 64 src_port 32 protocol 0x06 mask 0x1F flags 0x0 priority 3 queue 3 index 0
+Set hardware VLAN filter on or off for all ports:
-remove_5tuple_filter
-~~~~~~~~~~~~~~~~~~~~
+port config all hw-vlan-filter (on|off)
-Remove a 5-tuple filter
+Hardware VLAN filter is on by default.
-remove_5tuple_filter (port_id) index (idx)
+The off option is equivalent to the --disable-hw-vlan-filter command-line option.
-get_5tuple_filter
-~~~~~~~~~~~~~~~~~
+port config - VLAN strip
+~~~~~~~~~~~~~~~~~~~~~~~~
-Get and display a 5-tuple filter
+Set hardware VLAN strip on or off for all ports:
-get_5tuple_filter (port_id) index (idx)
+port config all hw-vlan-strip (on|off)
-Example:
+Hardware VLAN strip is on by default.
-.. code-block:: console
+The off option is equivalent to the --disable-hw-vlan-strip command-line option.
- testpmd> get_5tuple_filter 1 index 0
+port config - VLAN extend
+~~~~~~~~~~~~~~~~~~~~~~~~~
- filter[0]:
- Destination IP: 0x02020205 mask: 1
- Source IP: 0x02020204 mask: 1
- Destination Port: 0x0040 mask: 1
- Source Port: 0x0020 mask: 1
- protocol: 0x06 mask: 1
- priority: 3 flags: 0x00 queue: 3
+Set hardware VLAN extend on or off for all ports:
-add_syn_filter
-~~~~~~~~~~~~~~
+port config all hw-vlan-extend (on|off)
-Add SYN filter, which can forward TCP packets whose *SYN* flag is set into a separate queue.
+Hardware VLAN extend is off by default.
-add_syn_filter (port_id) priority (high|low) queue (queue_id)
+The off option is equivalent to the --disable-hw-vlan-extend command-line option.
-The available information parameters are:
+port config - Drop Packets
+~~~~~~~~~~~~~~~~~~~~~~~~~~
-* port_id: the port which the SYN filter assigned on.
+Set packet drop for packets with no descriptors on or off for all ports:
-* high: this SYN filter has higher priority than other filters.
+port config all drop-en (on|off)
-* low: this SYN filter has lower priority than other filters.
+Packet dropping for packets with no descriptors is off by default.
-* queue_id: The receive queue associated with this SYN filter
+The on option is equivalent to the --enable-drop-en command-line option.
-Example:
+port config - RSS
+~~~~~~~~~~~~~~~~~
-.. code-block:: console
+Set the RSS (Receive Side Scaling) mode on or off:
- testpmd> add_syn_filter 0 priority high queue 3,
+port config all rss (ip|udp|none)
-remove_syn_filter
-~~~~~~~~~~~~~~~~~
+RSS is on by default.
-Remove SYN filter
+The off option is equivalent to the --disable-rss command-line option.
-remove_syn_filter (port_id)
+port config - RSS Reta
+~~~~~~~~~~~~~~~~~~~~~~
-get_syn_filter
-~~~~~~~~~~~~~~
+Set the RSS (Receive Side Scaling) redirection table:
-Get and display SYN filter
+port config all rss reta (hash,queue)[,(hash,queue)]
-get_syn_filter (port_id)
+port config - DCB
+~~~~~~~~~~~~~~~~~
-Example:
+Set the DCB mode for an individual port:
-.. code-block:: console
+port config (port_id) dcb vt (on|off) (traffic_class) pfc (on|off)
- testpmd> get_syn_filter 0
+The traffic class should be 4 or 8.
- syn filter: on, priority: high, queue: 3
+port config - Burst
+~~~~~~~~~~~~~~~~~~~
-add_flex_filter
-~~~~~~~~~~~~~~~
+Set the number of packets per burst:
-Add a Flex filter,
-which recognizes any arbitrary pattern within the first 128 bytes of the packet
-and routes packets into one of the receive queues.
+port config all burst (value)
-add_flex_filter (port_id) len (len_value) bytes (bytes_string) mask (mask_value)
-priority (prio_value) queue (queue_id) index (idx)
+This is equivalent to the --burst command-line option.
-The available information parameters are:
+port config - Threshold
+~~~~~~~~~~~~~~~~~~~~~~~
-* port_id: the port which the Flex filter assigned on.
+Set thresholds for TX/RX queues:
-* len_value: filter length in byte, no greater than 128.
+port config all (threshold) (value)
-* bytes_string: a sting in format of octal, means the value the flex filter need to match.
+Where the threshold type can be:
-* mask_value: a sting in format of octal, bit 1 means corresponding byte in DWORD participates in the match.
+* txpt: Set the prefetch threshold register of the TX rings, 0 <= value <= 255.
-* prio_value: the priority of this filter.
+* txht: Set the host threshold register of the TX rings, 0 <= value <= 255.
-* queue_id: The receive queue associated with this Flex filter.
+* txwt: Set the write-back threshold register of the TX rings, 0 <= value <= 255.
-* index: the index of this Flex filter
+* rxpt: Set the prefetch threshold register of the RX rings, 0 <= value <= 255.
-Example:
+* rxht: Set the host threshold register of the RX rings, 0 <= value <= 255.
-.. code-block:: console
+* rxwt: Set the write-back threshold register of the RX rings, 0 <= value <= 255.
- testpmd> add_flex_filter 0 len 16 bytes 0x00000000000000000000000008060000 mask 000C priority 3 queue 3 index 0
+* txfreet: Set the transmit free threshold of the TX rings, 0 <= value <= txd.
-Assign a packet whose 13th and 14th bytes are 0x0806 to queue 3.
+* rxfreet: Set the transmit free threshold of the RX rings, 0 <= value <= rxd.
-remove_flex_filter
-~~~~~~~~~~~~~~~~~~
+* txrst: Set the transmit RS bit threshold of TX rings, 0 <= value <= txd.
+ These threshold options are also available from the command-line.
-Remove a Flex filter
+Link Bonding Functions
+----------------------
-remove_flex_filter (port_id) index (idx)
+The Link Bonding functions make it possible to dynamically create and
+manage link bonding devices from within testpmd interactive prompt.
-get_flex_filter
-~~~~~~~~~~~~~~~
+create bonded device
+~~~~~~~~~~~~~~~~~~~~
-Get and display a Flex filter
+Create a new bonding device:
-get_flex_filter (port_id) index (idx)
+create bonded device (mode) (socket)
-Example:
+For example, to create a bonded device in mode 1 on socket 0.
.. code-block:: console
- testpmd> get_flex_filter 0 index 0
+ testpmd> create bonded 1 0
+ created new bonded device (port X)
- filter[0]:
+add bonding slave
+~~~~~~~~~~~~~~~~~
- length: 16
+Adds Ethernet device to a Link Bonding device:
- dword[]: 0x00000000 00000000 00000000 08060000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000 00000000
- 00000000 00000000 00000000 00000000 00000000 00000000 00000000
+add bonding slave (slave id) (port id)
- mask[]:
- 0b0000000000001100000000000000000000000000000000000000000000000000000000
- 0000000000000000000000000000000000000000000000000000000000
+For example, to add Ethernet device (port 6) to a Link Bonding device (port 10).
- priority: 3 queue: 3
+.. code-block:: console
-set link up
-~~~~~~~~~~~
+ testpmd> add bonding slave 6 10
-Set link up for a port.
-set link-up port (port id)
+remove bonding slave
+~~~~~~~~~~~~~~~~~~~~
-set link down
-~~~~~~~~~~~~~
+Removes an Ethernet slave device from a Link Bonding device:
-Set link down for a port.
+remove bonding slave (slave id) (port id)
-set link-down port (port id)
-
-Port Functions
---------------
-
-The following sections show functions for configuring ports.
-
-.. note::
-
- Port configuration changes only become active when forwarding is started/restarted.
-
-port start
-~~~~~~~~~~
+For example, to remove Ethernet slave device (port 6) to a Link Bonding device (port 10).
-Start all ports or a specific port:
+.. code-block:: console
-port start (port_id|all)
+ testpmd> remove bonding slave 6 10
-port stop
-~~~~~~~~~
+set bonding mode
+~~~~~~~~~~~~~~~~
-Stop all ports or a specific port:
+Set the Link Bonding mode of a Link Bonding device:
-port stop (port_id|all)
+set bonding mode (value) (port id)
-port close
-~~~~~~~~~~
+For example, to set the bonding mode of a Link Bonding device (port 10) to broadcast (mode 3).
-Close all ports or a specific port:
+.. code-block:: console
-port close (port_id|all)
+ testpmd> set bonding mode 3 10
-port config - speed
+set bonding primary
~~~~~~~~~~~~~~~~~~~
-Set the speed and duplex mode for all ports or a specific port:
-
-port config (port_id|all) speed (10|100|1000|10000|auto) duplex (half|full|auto)
-
-port config - queues/descriptors
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Set number of queues/descriptors for rxq, txq, rxd and txd:
-
-port config all (rxq|txq|rxd|txd) (value)
-
-This is equivalent to the --rxq, --txq, --rxd and --txd command-line options.
-
-port config - max-pkt-len
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Set the maximum packet length:
-
-port config all max-pkt-len (value)
-
-This is equivalent to the --max-pkt-len command-line option.
-
-port config - CRC Strip
-~~~~~~~~~~~~~~~~~~~~~~~
-
-Set hardware CRC stripping on or off for all ports:
-
-port config all crc-strip (on|off)
-
-CRC stripping is off by default.
-
-The on option is equivalent to the --crc-strip command-line option.
-
-port config - RX Checksum
-~~~~~~~~~~~~~~~~~~~~~~~~~
-
-Set hardware RX checksum offload to on or off for all ports:
-
-port config all rx-cksum (on|off)
+Set an Ethernet slave device as the primary device on a Link Bonding device:
-Checksum offload is off by default.
+set bonding primary (slave id) (port id)
-The on option is equivalent to the --enable-rx-cksum command-line option.
+For example, to set the Ethernet slave device (port 6) as the primary port of a Link Bonding device (port 10).
-port config - VLAN
-~~~~~~~~~~~~~~~~~~
+.. code-block:: console
-Set hardware VLAN on or off for all ports:
+ testpmd> set bonding primary 6 10
-port config all hw-vlan (on|off)
+set bonding mac
+~~~~~~~~~~~~~~~
-Hardware VLAN is on by default.
+Set the MAC address of a Link Bonding device:
-The off option is equivalent to the --disable-hw-vlan command-line option.
+set bonding mac (port id) (mac)
-port config - Drop Packets
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+For example, to set the MAC address of a Link Bonding device (port 10) to 00:00:00:00:00:01
-Set packet drop for packets with no descriptors on or off for all ports:
+.. code-block:: console
-port config all drop-en (on|off)
+ testpmd> set bonding mac 10 00:00:00:00:00:01
-Packet dropping for packets with no descriptors is off by default.
+set bonding xmit_balance_policy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The on option is equivalent to the --enable-drop-en command-line option.
+Set the transmission policy for a Link Bonding device when it is in Balance XOR mode:
-port config - RSS
-~~~~~~~~~~~~~~~~~
+set bonding xmit_balance_policy (port_id) (l2|l23|l34)
-Set the RSS (Receive Side Scaling) mode on or off:
+For example, set a Link Bonding device (port 10) to use a balance policy of layer 3+4 (IP addresses & UDP ports )
-port config all rss (ip|udp|none)
+.. code-block:: console
-RSS is on by default.
+ testpmd> set bonding xmit_balance_policy 10 l34
-The off option is equivalent to the --disable-rss command-line option.
-port config - RSS Reta
+set bonding mon_period
~~~~~~~~~~~~~~~~~~~~~~
-Set the RSS (Receive Side Scaling) redirection table:
+Set the link status monitoring polling period in milliseconds for a bonding devicie.
-port config all rss reta (hash,queue)[,(hash,queue)]
+This adds support for PMD slave devices which do not support link status interrupts.
+When the mon_period is set to a value greater than 0 then all PMD's which do not support
+link status ISR will be queried every polling interval to check if their link status has changed.
-port config - DCB
-~~~~~~~~~~~~~~~~~
+set bonding mon_period (port_id) (value)
-Set the DCB mode for an individual port:
+For example, to set the link status monitoring polling period of bonded device (port 5) to 150ms
-port config (port_id) dcb vt (on|off) (traffic_class) pfc (on|off)
+.. code-block:: console
-The traffic class should be 4 or 8.
+ testpmd> set bonding mon_period 5 150
-port config - Burst
-~~~~~~~~~~~~~~~~~~~
-Set the number of packets per burst:
+show bonding config
+~~~~~~~~~~~~~~~~~~~
-port config all burst (value)
+Show the current configuration of a Link Bonding device:
-This is equivalent to the --burst command-line option.
+show bonding config (port id)
-port config - Threshold
-~~~~~~~~~~~~~~~~~~~~~~~
+For example,
+to show the configuration a Link Bonding device (port 9) with 3 slave devices (1, 3, 4)
+in balance mode with a transmission policy of layer 2+3.
-Set thresholds for TX/RX queues:
+.. code-block:: console
-port config all (threshold) (value)
+ testpmd> show bonding config 9
+ Bonding mode: 2
+ Balance Xmit Policy: BALANCE_XMIT_POLICY_LAYER23
+ Slaves (3): [1 3 4]
+ Active Slaves (3): [1 3 4]
+ Primary: [3]
-Where the threshold type can be:
+Register Functions
+------------------
-* txpt: Set the prefetch threshold register of the TX rings, 0 <= value <= 255.
+The Register functions can be used to read from and write to registers on the network card referenced by a port number.
+This is mainly useful for debugging purposes.
+Reference should be made to the appropriate datasheet for the network card for details on the register addresses
+and fields that can be accessed.
-* txht: Set the host threshold register of the TX rings, 0 <= value <= 255.
+read reg
+~~~~~~~~
-* txwt: Set the write-back threshold register of the TX rings, 0 <= value <= 255.
+Display the value of a port register:
-* rxpt: Set the prefetch threshold register of the RX rings, 0 <= value <= 255.
+read reg (port_id) (address)
-* rxht: Set the host threshold register of the RX rings, 0 <= value <= 255.
+For example, to examine the Flow Director control register (FDIRCTL, 0x0000EE000) on an Intel® 82599 10 GbE Controller:
-* rxwt: Set the write-back threshold register of the RX rings, 0 <= value <= 255.
+.. code-block:: console
-* txfreet: Set the transmit free threshold of the TX rings, 0 <= value <= txd.
+ testpmd> read reg 0 0xEE00
+ port 0 PCI register at offset 0xEE00: 0x4A060029 (1241907241)
-* rxfreet: Set the transmit free threshold of the RX rings, 0 <= value <= rxd.
+read regfield
+~~~~~~~~~~~~~
-* txrst: Set the transmit RS bit threshold of TX rings, 0 <= value <= txd.
- These threshold options are also available from the command-line.
+Display a port register bit field:
-Flow Director Functions
------------------------
+read regfield (port_id) (address) (bit_x) (bit_y)
-The Flow Director works in receive mode to identify specific flows or sets of flows and route them to specific queues.
+For example, reading the lowest two bits from the register in the example above:
-Two types of filtering are supported which are referred to as Perfect Match and Signature filters:
+.. code-block:: console
-* Perfect match filters.
- The hardware checks a match between the masked fields of the received packets and the programmed filters.
+ testpmd> read regfield 0 0xEE00 0 1
+ port 0 PCI register at offset 0xEE00: bits[0, 1]=0x1 (1)
-* Signature filters.
- The hardware checks a match between a hash-based signature of the masked fields of the received packet.
+read regbit
+~~~~~~~~~~~
-The Flow Director filters can match the following fields in a packet:
+Display a single port register bit:
-* Source IP and destination IP addresses.
+read regbit (port_id) (address) (bit_x)
-* Source port and destination port numbers (for UDP and TCP packets).
+For example, reading the lowest bit from the register in the example above:
-* IPv4/IPv6 and UDP/ TCP/SCTP protocol match.
+.. code-block:: console
-* VLAN header.
+ testpmd> read regbit 0 0xEE00 0
+ port 0 PCI register at offset 0xEE00: bit 0=1
-* Flexible 2-byte tuple match anywhere in the first 64 bytes of the packet.
+write reg
+~~~~~~~~~
-The Flow Director can also mask out parts of all of these fields so that filters are only applied to certain fields
-or parts of the fields.
-For example it is possible to mask out sub-nets of IP addresses or to ignore VLAN headers.
+Set the value of a port register:
-In the following sections, several common parameters are used in the Flow Director filters.
-These are explained below:
+write reg (port_id) (address) (value)
-* src: A pair of source address values. The source IP, in IPv4 or IPv6 format, and the source port:
+For example, to clear a register:
- src 192.168.0.1 1024
+.. code-block:: console
- src 2001:DB8:85A3:0:0:8A2E:370:7000 1024
+ testpmd> write reg 0 0xEE00 0x0
+ port 0 PCI register at offset 0xEE00: 0x00000000 (0)
-* dst: A pair of destination address values. The destination IP, in IPv4 or IPv6 format, and the destination port.
+write regfield
+~~~~~~~~~~~~~~
-* flexbytes: A 2-byte tuple to be matched within the first 64 bytes of a packet.
+Set bit field of a port register:
-The offset where the match occurs is set by the --pkt-filter-flexbytes-offset command-line parameter
-and is counted from the first byte of the destination Ethernet MAC address.
-The default offset is 0xC bytes, which is the "Type" word in the MAC header.
-Typically, the flexbyte value is set to 0x0800 to match the IPv4 MAC type or 0x86DD to match IPv6.
-These values change when a VLAN tag is added.
+write regfield (port_id) (address) (bit_x) (bit_y) (value)
-* vlan: The VLAN header to match in the packet.
+For example, writing to the register cleared in the example above:
-* queue: The index of the RX queue to route matched packets to.
+.. code-block:: console
-* soft: The 16-bit value in the MBUF flow director ID field for RX packets matching the filter.
+ testpmd> write regfield 0 0xEE00 0 1 2
+ port 0 PCI register at offset 0xEE00: 0x00000002 (2)
-add_signature_filter
-~~~~~~~~~~~~~~~~~~~~
+write regbit
+~~~~~~~~~~~~
-Add a signature filter:
+Set single bit value of a port register:
-# Command is displayed on several lines for clarity.
+write regbit (port_id) (address) (bit_x) (value)
-add_signature_filter (port_id) (ip|udp|tcp|sctp)
+For example, to set the high bit in the register from the example above:
- src (src_ip_address) (src_port)
+.. code-block:: console
- dst (dst_ip_address) (dst_port)
+ testpmd> write regbit 0 0xEE00 31 1
+ port 0 PCI register at offset 0xEE00: 0x8000000A (2147483658)
- flexbytes (flexbytes_values)
+Filter Functions
+----------------
- vlan (vlan_id) queue (queue_id)
+This section details the available filter functions that are available.
-upd_signature_filter
+ethertype_filter
~~~~~~~~~~~~~~~~~~~~
-Update a signature filter:
-
-# Command is displayed on several lines for clarity.
-
-upd_signature_filter (port_id) (ip|udp|tcp|sctp)
-
- src (src_ip_address) (src_port)
-
- dst (dst_ip_address) (dst_port)
-
- flexbytes (flexbytes_values)
-
- vlan (vlan_id) queue (queue_id)
-
-rm_signature_filter
-~~~~~~~~~~~~~~~~~~~
-
-Remove a signature filter:
-
-# Command is displayed on several lines for clarity.
-
-rm_signature_filter (port_id) (ip|udp|tcp|sctp)
-
- src (src_ip_address) (src_port)
-
- dst (dst_ip_address) (dst_port)
-
- flexbytes (flexbytes_values)
-
- vlan (vlan_id)
+Add or delete a L2 Ethertype filter, which identify packets by their L2 Ethertype mainly assign them to a receive queue.
-add_perfect_filter
-~~~~~~~~~~~~~~~~~~
-
-Add a perfect filter:
-
-# Command is displayed on several lines for clarity.
-
-add_perfect_filter (port_id) (ip|udp|tcp|sctp)
+ethertype_filter (port_id) (add|del) (mac_addr|mac_ignr) (mac_address) ethertype (ether_type) (drop|fwd) queue (queue_id)
- src (src_ip_address) (src_port)
-
- dst (dst_ip_address) (dst_port)
-
- flexbytes (flexbytes_values)
+The available information parameters are:
- vlan (vlan_id) queue (queue_id) soft (soft_id)
+* port_id: the port which the Ethertype filter assigned on.
-upd_perfect_filter
-~~~~~~~~~~~~~~~~~~
+* mac_addr: compare destination mac address.
-Update a perfect filter:
+* mac_ignr: ignore destination mac address match.
-# Command is displayed on several lines for clarity.
+* mac_address: destination mac address to match.
-upd_perfect_filter (port_id) (ip|udp|tcp|sctp)
+* ether_type: the EtherType value want to match,
+ for example 0x0806 for ARP packet. 0x0800 (IPv4) and 0x86DD (IPv6) are invalid.
- src (src_ip_address) (src_port)
+* queue_id : The receive queue associated with this EtherType filter. It is meaningless when deleting or dropping.
- dst (dst_ip_address) (dst_port)
+Example, to add/remove an ethertype filter rule:
- flexbytes (flexbytes_values)
+.. code-block:: console
- vlan (vlan_id) queue (queue_id)
+ testpmd> ethertype_filter 0 add mac_ignr ethertype 0x0806 fwd queue 3
+ testpmd> ethertype_filter 0 del mac_ignr ethertype 0x0806 fwd queue 3
-rm_perfect_filter
+2tuple_filter
~~~~~~~~~~~~~~~~~
-Remove a perfect filter:
-
-rm_perfect_filter (port_id) (ip|udp|tcp|sctp)
-
- src (src_ip_address) (src_port)
-
- dst (dst_ip_address) (dst_port)
-
- flexbytes (flexbytes_values)
-
- vlan (vlan_id) soft (soft_id)
-
-set_masks_filter
-~~~~~~~~~~~~~~~~
-
-Set IPv4 filter masks:
-
-# Command is displayed on several lines for clarity.
-
-set_masks_filter (port_id) only_ip_flow (0|1)
-
- src_mask (ip_src_mask) (src_port_mask)
-
- dst_mask (ip_dst_mask) (dst_port_mask)
-
- flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
+Add or delete a 2-tuple filter,
+which identify packets by specific protocol and destination TCP/UDP port
+and forwards packets into one of the receive queues.
-set_ipv6_masks_filter
-~~~~~~~~~~~~~~~~~~~~~
+2tuple_filter (port_id) (add|del) dst_port (dst_port_value) protocol (protocol_value)
+mask (mask_value) tcp_flags (tcp_flags_value) priority (prio_value) queue (queue_id)
-Set IPv6 filter masks:
+The available information parameters are:
-# Command is displayed on several lines for clarity.
+* port_id: the port which the 2-tuple filter assigned on.
-set_ipv6_masks_filter (port_id) only_ip_flow (0|1)
+* dst_port_value: destination port in L4.
- src_mask (ip_src_mask) (src_port_mask)
+* protocol_value: IP L4 protocol.
- dst_mask (ip_dst_mask) (dst_port_mask)
+* mask_value: participates in the match or not by bit for field above, 1b means participate.
- flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
+* tcp_flags_value: TCP control bits. The non-zero value is invalid, when the pro_value is not set to 0x06 (TCP).
- compare_dst (0|1)
+* prio_value: priority of this filter.
-Link Bonding Functions
-----------------------
+* queue_id: The receive queue associated with this 2-tuple filter.
-The Link Bonding functions make it possible to dynamically create and
-manage link bonding devices from within testpmd interactive prompt.
-
-create bonded device
-~~~~~~~~~~~~~~~~~~~~
-
-Create a new bonding device:
-
-create bonded device (mode) (socket)
-
-For example, to create a bonded device in mode 1 on socket 0.
+Example, to add/remove an 2tuple filter rule:
.. code-block:: console
- testpmd> create bonded 1 0
- created new bonded device (port X)
+ testpmd> 2tuple_filter 0 add dst_port 32 protocol 0x06 mask 0x03 tcp_flags 0x02 priority 3 queue 3
+ testpmd> 2tuple_filter 0 del dst_port 32 protocol 0x06 mask 0x03 tcp_flags 0x02 priority 3 queue 3
-add bonding slave
+5tuple_filter
~~~~~~~~~~~~~~~~~
-Adds Ethernet device to a Link Bonding device:
-
-add bonding slave (slave id) (port id)
+Add or delete a 5-tuple filter,
+which consists of a 5-tuple (protocol, source and destination IP addresses, source and destination TCP/UDP/SCTP port)
+and routes packets into one of the receive queues.
-For example, to add Ethernet device (port 6) to a Link Bonding device (port 10).
+5tuple_filter (port_id) (add|del) dst_ip (dst_address) src_ip (src_address) dst_port (dst_port_value) src_port (src_port_value)
+protocol (protocol_value) mask (mask_value) tcp_flags (tcp_flags_value) priority (prio_value) queue (queue_id)
-.. code-block:: console
-
- testpmd> add bonding slave 6 10
+The available information parameters are:
+* port_id: the port which the 5-tuple filter assigned on.
-remove bonding slave
-~~~~~~~~~~~~~~~~~~~~
+* dst_address: destination IP address.
-Removes an Ethernet slave device from a Link Bonding device:
+* src_address: source IP address.
-remove bonding slave (slave id) (port id)
+* dst_port_value: TCP/UDP destination port.
-For example, to remove Ethernet slave device (port 6) to a Link Bonding device (port 10).
+* src_port_value: TCP/UDP source port.
-.. code-block:: console
+* protocol_value: L4 protocol.
- testpmd> remove bonding slave 6 10
+* mask_value: participates in the match or not by bit for field above, 1b means participate
-set bonding mode
-~~~~~~~~~~~~~~~~
+* tcp_flags_value: TCP control bits. The non-zero value is invalid, when the protocol_value is not set to 0x06 (TCP).
-Set the Link Bonding mode of a Link Bonding device:
+* prio_value: the priority of this filter.
-set bonding mode (value) (port id)
+* queue_id: The receive queue associated with this 5-tuple filter.
-For example, to set the bonding mode of a Link Bonding device (port 10) to broadcast (mode 3).
+Example, to add/remove an 5tuple filter rule:
.. code-block:: console
- testpmd> set bonding mode 3 10
+ testpmd> 5tuple_filter 0 add dst_ip 2.2.2.5 src_ip 2.2.2.4 dst_port 64 src_port 32 protocol 0x06 mask 0x1F flags 0x0 priority 3 queue 3
+ testpmd> 5tuple_filter 0 del dst_ip 2.2.2.5 src_ip 2.2.2.4 dst_port 64 src_port 32 protocol 0x06 mask 0x1F flags 0x0 priority 3 queue 3
-set bonding primary
-~~~~~~~~~~~~~~~~~~~
+syn_filter
+~~~~~~~~~~~~~~
-Set an Ethernet slave device as the primary device on a Link Bonding device:
+By SYN filter, TCP packets whose *SYN* flag is set can be forwarded to a separate queue.
-set bonding primary (slave id) (port id)
+syn_filter (port_id) (add|del) priority (high|low) queue (queue_id)
-For example, to set the Ethernet slave device (port 6) as the primary port of a Link Bonding device (port 10).
-
-.. code-block:: console
+The available information parameters are:
- testpmd> set bonding primary 6 10
+* port_id: the port which the SYN filter assigned on.
-set bonding mac
-~~~~~~~~~~~~~~~
+* high: this SYN filter has higher priority than other filters.
-Set the MAC address of a Link Bonding device:
+* low: this SYN filter has lower priority than other filters.
-set bonding mac (port id) (mac)
+* queue_id: The receive queue associated with this SYN filter
-For example, to set the MAC address of a Link Bonding device (port 10) to 00:00:00:00:00:01
+Example:
.. code-block:: console
- testpmd> set bonding mac 10 00:00:00:00:00:01
+ testpmd> syn_filter 0 add priority high queue 3
-set bonding xmit_balance_policy
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+flex_filter
+~~~~~~~~~~~
-Set the transmission policy for a Link Bonding device when it is in Balance XOR mode:
+With flex filter, packets can be recognized by any arbitrary pattern within the first 128 bytes of the packet
+and routes packets into one of the receive queues.
-set bonding xmit_balance_policy (port_id) (l2|l23|l34)
+flex_filter (port_id) (add|del) len (len_value) bytes (bytes_value)
+mask (mask_value) priority (prio_value) queue (queue_id)
-For example, set a Link Bonding device (port 10) to use a balance policy of layer 3+4 (IP addresses & UDP ports )
+The available information parameters are:
-.. code-block:: console
+* port_id: the port which the Flex filter is assigned on.
- testpmd> set bonding xmit_balance_policy 10 l34
+* len_value: filter length in bytes, no greater than 128.
+* bytes_value: a string in hexadecimal, means the value the flex filter needs to match.
-set bonding mon_period
-~~~~~~~~~~~~~~~~~~~~~~
+* mask_value: a string in hexadecimal, bit 1 means corresponding byte participates in the match.
-Set the link status monitoring polling period in milliseconds for a bonding devicie.
+* prio_value: the priority of this filter.
-This adds support for PMD slave devices which do not support link status interrupts.
-When the mon_period is set to a value greater than 0 then all PMD's which do not support
-link status ISR will be queried every polling interval to check if their link status has changed.
+* queue_id: the receive queue associated with this Flex filter.
-set bonding mon_period (port_id) (value)
-
-For example, to set the link status monitoring polling period of bonded device (port 5) to 150ms
+Example:
.. code-block:: console
- testpmd> set bonding mon_period 5 150
+ testpmd> flex_filter 0 add len 16 bytes 0x00000000000000000000000008060000
+ mask 000C priority 3 queue 3
+ testpmd> flex_filter 0 del len 16 bytes 0x00000000000000000000000008060000
+ mask 000C priority 3 queue 3
-show bonding config
-~~~~~~~~~~~~~~~~~~~
+flow_director_filter
+~~~~~~~~~~~~~~~~~~~~
-Show the current configuration of a Link Bonding device:
+The Flow Director works in receive mode to identify specific flows or sets of flows and route them to specific queues.
-show bonding config (port id)
+Two types of filtering are supported which are referred to as Perfect Match and Signature filters, the match mode
+is set by the --pkt-filter-mode command-line parameter:
-For example,
-to show the configuration a Link Bonding device (port 9) with 3 slave devices (1, 3, 4)
-in balance mode with a transmission policy of layer 2+3.
+* Perfect match filters.
+ The hardware checks a match between the masked fields of the received packets and the programmed filters.
-.. code-block:: console
+* Signature filters.
+ The hardware checks a match between a hash-based signature of the masked fields of the received packet.
- testpmd> show bonding config 9
- Bonding mode: 2
- Balance Xmit Policy: BALANCE_XMIT_POLICY_LAYER23
- Slaves (3): [1 3 4]
- Active Slaves (3): [1 3 4]
- Primary: [3]
+The Flow Director filters can match the different fields for different type of packet: flow type, specific input set
+per flow type and the flexible payload. The Flow Director can also mask out parts of all of these fields so that filters
+are only applied to certain fields or parts of the fields.
-Register Functions
-------------------
+Different NICs may have different capabilities, command show port fdir (port_id) can be used to acquire the information.
-The Register functions can be used to read from and write to registers on the network card referenced by a port number.
-This is mainly useful for debugging purposes.
-Reference should be made to the appropriate datasheet for the network card for details on the register addresses
-and fields that can be accessed.
+# Commands to add flow director filters of different flow types.
-read reg
-~~~~~~~~
+flow_director_filter (port_id) (add|del|update) flow (ip4|ip4-frag|ip6|ip6-frag)
+src (src_ip_address) dst (dst_ip_address) vlan (vlan_value) flexbytes (flexbytes_value)
+(drop|fwd) queue (queue_id) fd_id (fd_id_value)
-Display the value of a port register:
+flow_director_filter (port_id) (add|del|update) flow (udp4|tcp4|udp6|tcp6)
+src (src_ip_address) (src_port) dst (dst_ip_address) (dst_port) vlan (vlan_value)
+flexbytes (flexbytes_value) (drop|fwd) queue (queue_id) fd_id (fd_id_value)
-read reg (port_id) (address)
+flow_director_filter (port_id) (add|del|update) flow (sctp4|sctp6)
+src (src_ip_address) (src_port) dst (dst_ip_address) (dst_port) tag (verification_tag)
+vlan (vlan_value) flexbytes (flexbytes_value) (drop|fwd) queue (queue_id) fd_id (fd_id_value)
-For example, to examine the Flow Director control register (FDIRCTL, 0x0000EE000) on an Intel® 82599 10 GbE Controller:
+For example, to add an udp flow type filter:
.. code-block:: console
- testpmd> read reg 0 0xEE00
- port 0 PCI register at offset 0xEE00: 0x4A060029 (1241907241)
+ testpmd> flow_director_filter 0 add flow udp4 src 2.2.2.3 32 dst 2.2.2.5 33 vlan 0x1 flexbytes (0x88,0x48) fwd queue 1 fd_id 1
-read regfield
-~~~~~~~~~~~~~
-
-Display a port register bit field:
-
-read regfield (port_id) (address) (bit_x) (bit_y)
-
-For example, reading the lowest two bits from the register in the example above:
+For example, add an ip4 flow type filter:
.. code-block:: console
- testpmd> read regfield 0 0xEE00 0 1
- port 0 PCI register at offset 0xEE00: bits[0, 1]=0x1 (1)
+ testpmd> flow_director_filter 0 add flow ip4 src 2.2.2.3 dst 2.2.2.5 vlan 0x1 flexbytes (0x88,0x48) fwd queue 1 fd_id 1
-read regbit
-~~~~~~~~~~~
+flush_flow_director
+~~~~~~~~~~~~~~~~~~~
-Display a single port register bit:
+flush all flow director filters on a device:
-read regbit (port_id) (address) (bit_x)
+flush_flow_director (port_id)
-For example, reading the lowest bit from the register in the example above:
+Example, to flush all flow director filter on port 0:
.. code-block:: console
- testpmd> read regbit 0 0xEE00 0
- port 0 PCI register at offset 0xEE00: bit 0=1
+ testpmd> flush_flow_director 0
-write reg
-~~~~~~~~~
+flow_director_mask
+~~~~~~~~~~~~~~~~~~
-Set the value of a port register:
+set flow director's masks on match input set
-write reg (port_id) (address) (value)
+flow_director_mask (port_id) vlan (vlan_value) src_mask (ipv4_src) (ipv6_src) (src_port) dst_mask (ipv4_dst) (ipv6_dst) (dst_port)
-For example, to clear a register:
+Example, to set flow director mask on port 0:
.. code-block:: console
- testpmd> write reg 0 0xEE00 0x0
- port 0 PCI register at offset 0xEE00: 0x00000000 (0)
+ testpmd> flow_director_mask 0 vlan 0xefff src_mask 255.255.255.255 FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF 0xFFFF dst_mask 255.255.255.255 FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF:FFFF 0xFFFF
-write regfield
-~~~~~~~~~~~~~~
-Set bit field of a port register:
+flow_director_flex_mask
+~~~~~~~~~~~~~~~~~~~~~~~
-write regfield (port_id) (address) (bit_x) (bit_y) (value)
+set masks of flow director's flexible payload based on certain flow type:
-For example, writing to the register cleared in the example above:
+flow_director_flex_mask (port_id) flow (raw|ip4|ip4-frag|tcp4|udp4|sctp4|ip6|ip6-frag|tcp6|udp6|sctp6|all) (mask)
+
+Example, to set flow director's udpv4 flex mask on port 0:
.. code-block:: console
- testpmd> write regfield 0 0xEE00 0 1 2
- port 0 PCI register at offset 0xEE00: 0x00000002 (2)
+ testpmd> flow_director_flex_mask 0 flow all (0xff,0xff,0,0,0,0,0,0,0,0,0,0,0,0,0,0)
-write regbit
-~~~~~~~~~~~~
-Set single bit value of a port register:
+flow_director_flex_payload
+~~~~~~~~~~~~~~~~~~~~~~~~~~
-write regbit (port_id) (address) (bit_x) (value)
+Configure flexible payload selection.
-For example, to set the high bit in the register from the example above:
+flow_director_flex_payload (port_id) (raw|l2|l3|l4) (config)
+
+For example, to select the first 16 bytes from the offset 4 (bytes) of packet’s payload as flexible payload.
.. code-block:: console
- testpmd> write regbit 0 0xEE00 31 1
- port 0 PCI register at offset 0xEE00: 0x8000000A (2147483658)
+ testpmd> flow_director_flex_payload 0 l4 (4,5,6,7,8,9,10,11,12,13,14,15,16,17,18,19)