@@ -435,20 +435,6 @@ Remove a VLAN ID, from the set of VLAN identifiers filtered for VF(s) for port I
rx_vlan rm (vlan_id) port (port_id) vf (vf_mask)
-tx_rate (for Queue)
-~~~~~~~~~~~~~~~~~~~
-
-Set TX rate limitation for queue of a port ID:
-
-set port (port_id) queue (queue_id) rate (rate_value)
-
-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)
-
rx_vlan set tpid
~~~~~~~~~~~~~~~~
@@ -698,6 +684,20 @@ The available receive modes are:
* 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
~~~~~~~~~~~~~~~~~~~~~~
@@ -764,884 +764,889 @@ Show the bypass configuration for a bypass enabled NIC using the lowest port on
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 start
+~~~~~~~~~~
-Example:
+Start all ports or a specific port:
-.. code-block:: console
+port start (port_id|all)
- testpmd> add_ethertype_filter 0 ethertype 0x0806 priority disable 0 queue 3 index 0
- Assign ARP packet to receive queue 3
+port stop
+~~~~~~~~~
-remove_ethertype_filter
-~~~~~~~~~~~~~~~~~~~~~~~
+Stop all ports or a specific port:
-Remove a L2 Ethertype filter
+port stop (port_id|all)
-remove_ethertype_filter (port_id) index (idx)
+port close
+~~~~~~~~~~
-get_ethertype_filter
-~~~~~~~~~~~~~~~~~~~~
+Close all ports or a specific port:
-Get and display a L2 Ethertype filter
+port close (port_id|all)
-get_ethertype_filter (port_id) index (idx)
+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> get_ethertype_filter 0 index 0
+Only take effect when port is started.
- filter[0]:
- ethertype: 0x0806
- priority: disable, 0
- queue: 3
+port config - speed
+~~~~~~~~~~~~~~~~~~~
-add_2tuple_filter
-~~~~~~~~~~~~~~~~~
+Set the speed and duplex mode for all ports or a specific port:
-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.
+port config (port_id|all) speed (10|100|1000|10000|auto) duplex (half|full|auto)
-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)
+port config - queues/descriptors
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-The available information parameters are:
+Set number of queues/descriptors for rxq, txq, rxd and txd:
-* port_id: the port which the 2-tuple filter assigned on.
+port config all (rxq|txq|rxd|txd) (value)
-* pro_value: IP L4 protocol
+This is equivalent to the --rxq, --txq, --rxd and --txd command-line options.
-* pro_mask: protocol participates in the match or not, 1 means participate
+port config - max-pkt-len
+~~~~~~~~~~~~~~~~~~~~~~~~~
-* port_value: destination port in L4.
+Set the maximum packet length:
-* port_mask: destination port participates in the match or not, 1 means participate.
+port config all max-pkt-len (value)
-* flg_value: TCP control bits. The non-zero value is invalid, when the pro_value is not set to 0x06 (TCP).
+This is equivalent to the --max-pkt-len command-line option.
-* prio_value: the priority of this filter.
+port config - CRC Strip
+~~~~~~~~~~~~~~~~~~~~~~~
-* queue_id: The receive queue associated with this 2-tuple filter
+Set hardware CRC stripping on or off for all ports:
-* index: the index of this 2-tuple filter
+port config all crc-strip (on|off)
-Example:
+CRC stripping is off by default.
-.. code-block:: console
+The on option is equivalent to the --crc-strip command-line option.
- testpmd> add_2tuple_filter 0 protocol 0x06 1 dst_port 32 1 flags 0x02 priority 3 queue 3 index 0
+port config - RX Checksum
+~~~~~~~~~~~~~~~~~~~~~~~~~
-remove_2tuple_filter
-~~~~~~~~~~~~~~~~~~~~
+Set hardware RX checksum offload to on or off for all ports:
-Remove a 2-tuple filter
+port config all rx-cksum (on|off)
-remove_2tuple_filter (port_id) index (idx)
+Checksum offload is off by default.
-get_2tuple_filter
-~~~~~~~~~~~~~~~~~
+The on option is equivalent to the --enable-rx-cksum command-line option.
-Get and display a 2-tuple filter
+port config - VLAN
+~~~~~~~~~~~~~~~~~~
-get_2tuple_filter (port_id) index (idx)
+Set hardware VLAN on or off for all ports:
-Example:
+port config all hw-vlan (on|off)
-.. code-block:: console
+Hardware VLAN is on by default.
- testpmd> get_2tuple_filter 0 index 0
+The off option is equivalent to the --disable-hw-vlan command-line option.
- filter[0]:
- Destination Port: 0x0020 mask: 1
- protocol: 0x06 mask:1 tcp_flags: 0x02
- priority: 3 queue: 3
+port config - Drop Packets
+~~~~~~~~~~~~~~~~~~~~~~~~~~
-add_5tuple_filter
-~~~~~~~~~~~~~~~~~
+Set packet drop for packets with no descriptors on or off for all ports:
-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 all drop-en (on|off)
-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)
+Packet dropping for packets with no descriptors is off by default.
-The available information parameters are:
+The on option is equivalent to the --enable-drop-en command-line option.
-* port_id: the port which the 5-tuple filter assigned on.
+port config - RSS
+~~~~~~~~~~~~~~~~~
-* dst_address: destination IP address.
+Set the RSS (Receive Side Scaling) mode on or off:
-* src_address: source IP address.
+port config all rss (ip|udp|none)
-* dst_port_value: TCP/UDP destination port.
+RSS is on by default.
-* src_port_value: TCP/UDP source port.
+The off option is equivalent to the --disable-rss command-line option.
-* protocol_value: L4 protocol.
+port config - RSS Reta
+~~~~~~~~~~~~~~~~~~~~~~
-* mask_value: participates in the match or not by bit for field above, 1b means participate
+Set the RSS (Receive Side Scaling) redirection table:
-* flags_value: TCP control bits. The non-zero value is invalid, when the protocol_value is not set to 0x06 (TCP).
+port config all rss reta (hash,queue)[,(hash,queue)]
-* prio_value: the priority of this filter.
+port config - DCB
+~~~~~~~~~~~~~~~~~
-* queue_id: The receive queue associated with this 5-tuple filter.
+Set the DCB mode for an individual port:
-* index: the index of this 5-tuple filter
+port config (port_id) dcb vt (on|off) (traffic_class) pfc (on|off)
-Example:
+The traffic class should be 4 or 8.
-.. code-block:: console
+port config - Burst
+~~~~~~~~~~~~~~~~~~~
- 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 the number of packets per burst:
-remove_5tuple_filter
-~~~~~~~~~~~~~~~~~~~~
+port config all burst (value)
-Remove a 5-tuple filter
+This is equivalent to the --burst command-line option.
-remove_5tuple_filter (port_id) index (idx)
+port config - Threshold
+~~~~~~~~~~~~~~~~~~~~~~~
-get_5tuple_filter
-~~~~~~~~~~~~~~~~~
+Set thresholds for TX/RX queues:
-Get and display a 5-tuple filter
+port config all (threshold) (value)
-get_5tuple_filter (port_id) index (idx)
+Where the threshold type can be:
-Example:
+* txpt: Set the prefetch threshold register of the TX rings, 0 <= value <= 255.
-.. code-block:: console
+* txht: Set the host threshold register of the TX rings, 0 <= value <= 255.
- testpmd> get_5tuple_filter 1 index 0
+* txwt: Set the write-back threshold register of the TX rings, 0 <= value <= 255.
- 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
+* rxpt: Set the prefetch threshold register of the RX rings, 0 <= value <= 255.
-add_syn_filter
-~~~~~~~~~~~~~~
+* rxht: Set the host threshold register of the RX rings, 0 <= value <= 255.
-Add SYN filter, which can forward TCP packets whose *SYN* flag is set into a separate queue.
+* rxwt: Set the write-back threshold register of the RX rings, 0 <= value <= 255.
-add_syn_filter (port_id) priority (high|low) queue (queue_id)
+* txfreet: Set the transmit free threshold of the TX rings, 0 <= value <= txd.
-The available information parameters are:
+* rxfreet: Set the transmit free threshold of the RX rings, 0 <= value <= rxd.
-* port_id: the port which the SYN filter assigned on.
+* txrst: Set the transmit RS bit threshold of TX rings, 0 <= value <= txd.
+ These threshold options are also available from the command-line.
-* high: this SYN filter has higher priority than other filters.
+Flow Director Functions
+-----------------------
-* low: this SYN filter has lower priority than other filters.
+The Flow Director works in receive mode to identify specific flows or sets of flows and route them to specific queues.
-* queue_id: The receive queue associated with this SYN filter
+Two types of filtering are supported which are referred to as Perfect Match and Signature filters:
-Example:
+* 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> add_syn_filter 0 priority high queue 3,
+The Flow Director filters can match the following fields in a packet:
-remove_syn_filter
-~~~~~~~~~~~~~~~~~
+* Source IP and destination IP addresses.
-Remove SYN filter
+* Source port and destination port numbers (for UDP and TCP packets).
-remove_syn_filter (port_id)
+* IPv4/IPv6 and UDP/ TCP/SCTP protocol match.
-get_syn_filter
-~~~~~~~~~~~~~~
+* VLAN header.
-Get and display SYN filter
+* Flexible 2-byte tuple match anywhere in the first 64 bytes of the packet.
-get_syn_filter (port_id)
+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.
-Example:
+In the following sections, several common parameters are used in the Flow Director filters.
+These are explained below:
-.. code-block:: console
+* src: A pair of source address values. The source IP, in IPv4 or IPv6 format, and the source port:
- testpmd> get_syn_filter 0
+ src 192.168.0.1 1024
- syn filter: on, priority: high, queue: 3
+ src 2001:DB8:85A3:0:0:8A2E:370:7000 1024
-add_flex_filter
-~~~~~~~~~~~~~~~
+* dst: A pair of destination address values. The destination IP, in IPv4 or IPv6 format, and the destination port.
-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.
+* flexbytes: A 2-byte tuple to be matched within the first 64 bytes of a packet.
-add_flex_filter (port_id) len (len_value) bytes (bytes_string) mask (mask_value)
-priority (prio_value) queue (queue_id) index (idx)
+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.
-The available information parameters are:
+* vlan: The VLAN header to match in the packet.
-* port_id: the port which the Flex filter assigned on.
+* queue: The index of the RX queue to route matched packets to.
-* len_value: filter length in byte, no greater than 128.
+* soft: The 16-bit value in the MBUF flow director ID field for RX packets matching the filter.
-* bytes_string: a sting in format of octal, means the value the flex filter need to match.
+add_signature_filter
+~~~~~~~~~~~~~~~~~~~~
-* mask_value: a sting in format of octal, bit 1 means corresponding byte in DWORD participates in the match.
+Add a signature filter:
-* prio_value: the priority of this filter.
+# Command is displayed on several lines for clarity.
-* queue_id: The receive queue associated with this Flex filter.
+add_signature_filter (port_id) (ip|udp|tcp|sctp)
-* index: the index of this Flex filter
+ src (src_ip_address) (src_port)
-Example:
+ dst (dst_ip_address) (dst_port)
-.. code-block:: console
+ flexbytes (flexbytes_values)
- testpmd> add_flex_filter 0 len 16 bytes 0x00000000000000000000000008060000 mask 000C priority 3 queue 3 index 0
+ vlan (vlan_id) queue (queue_id)
-Assign a packet whose 13th and 14th bytes are 0x0806 to queue 3.
+upd_signature_filter
+~~~~~~~~~~~~~~~~~~~~
-remove_flex_filter
-~~~~~~~~~~~~~~~~~~
+Update a signature filter:
-Remove a Flex filter
+# Command is displayed on several lines for clarity.
-remove_flex_filter (port_id) index (idx)
+upd_signature_filter (port_id) (ip|udp|tcp|sctp)
-get_flex_filter
-~~~~~~~~~~~~~~~
+ src (src_ip_address) (src_port)
-Get and display a Flex filter
+ dst (dst_ip_address) (dst_port)
-get_flex_filter (port_id) index (idx)
+ flexbytes (flexbytes_values)
-Example:
+ vlan (vlan_id) queue (queue_id)
-.. code-block:: console
+rm_signature_filter
+~~~~~~~~~~~~~~~~~~~
- testpmd> get_flex_filter 0 index 0
+Remove a signature filter:
- filter[0]:
+# Command is displayed on several lines for clarity.
- length: 16
+rm_signature_filter (port_id) (ip|udp|tcp|sctp)
- 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
+ src (src_ip_address) (src_port)
- mask[]:
- 0b0000000000001100000000000000000000000000000000000000000000000000000000
- 0000000000000000000000000000000000000000000000000000000000
+ dst (dst_ip_address) (dst_port)
- priority: 3 queue: 3
+ flexbytes (flexbytes_values)
-set link up
-~~~~~~~~~~~
+ vlan (vlan_id)
-Set link up for a port.
+add_perfect_filter
+~~~~~~~~~~~~~~~~~~
-set link-up port (port id)
+Add a perfect filter:
-set link down
-~~~~~~~~~~~~~
+# Command is displayed on several lines for clarity.
-Set link down for a port.
+add_perfect_filter (port_id) (ip|udp|tcp|sctp)
-set link-down port (port id)
+ src (src_ip_address) (src_port)
-Port Functions
---------------
+ dst (dst_ip_address) (dst_port)
-The following sections show functions for configuring ports.
+ flexbytes (flexbytes_values)
-.. note::
+ vlan (vlan_id) queue (queue_id) soft (soft_id)
- Port configuration changes only become active when forwarding is started/restarted.
+upd_perfect_filter
+~~~~~~~~~~~~~~~~~~
-port start
-~~~~~~~~~~
+Update a perfect filter:
-Start all ports or a specific port:
+# Command is displayed on several lines for clarity.
-port start (port_id|all)
+upd_perfect_filter (port_id) (ip|udp|tcp|sctp)
-port stop
-~~~~~~~~~
+ src (src_ip_address) (src_port)
-Stop all ports or a specific port:
+ dst (dst_ip_address) (dst_port)
-port stop (port_id|all)
+ flexbytes (flexbytes_values)
-port close
-~~~~~~~~~~
+ vlan (vlan_id) queue (queue_id)
-Close all ports or a specific port:
+rm_perfect_filter
+~~~~~~~~~~~~~~~~~
-port close (port_id|all)
+Remove a perfect filter:
-port start/stop queue
-~~~~~~~~~~~~~~~~~~~~~
+rm_perfect_filter (port_id) (ip|udp|tcp|sctp)
-Start/stop a rx/tx queue on a specific port:
+ src (src_ip_address) (src_port)
-port (port_id) (rxq|txq) (queue_id) (start|stop)
+ dst (dst_ip_address) (dst_port)
-Only take effect when port is started.
+ flexbytes (flexbytes_values)
-port config - speed
-~~~~~~~~~~~~~~~~~~~
+ vlan (vlan_id) soft (soft_id)
-Set the speed and duplex mode for all ports or a specific port:
+set_masks_filter
+~~~~~~~~~~~~~~~~
-port config (port_id|all) speed (10|100|1000|10000|auto) duplex (half|full|auto)
+Set IPv4 filter masks:
-port config - queues/descriptors
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+# Command is displayed on several lines for clarity.
-Set number of queues/descriptors for rxq, txq, rxd and txd:
+set_masks_filter (port_id) only_ip_flow (0|1)
-port config all (rxq|txq|rxd|txd) (value)
+ src_mask (ip_src_mask) (src_port_mask)
-This is equivalent to the --rxq, --txq, --rxd and --txd command-line options.
+ dst_mask (ip_dst_mask) (dst_port_mask)
-port config - max-pkt-len
-~~~~~~~~~~~~~~~~~~~~~~~~~
+ flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
-Set the maximum packet length:
+set_ipv6_masks_filter
+~~~~~~~~~~~~~~~~~~~~~
-port config all max-pkt-len (value)
+Set IPv6 filter masks:
-This is equivalent to the --max-pkt-len command-line option.
+# Command is displayed on several lines for clarity.
-port config - CRC Strip
-~~~~~~~~~~~~~~~~~~~~~~~
+set_ipv6_masks_filter (port_id) only_ip_flow (0|1)
-Set hardware CRC stripping on or off for all ports:
+ src_mask (ip_src_mask) (src_port_mask)
-port config all crc-strip (on|off)
+ dst_mask (ip_dst_mask) (dst_port_mask)
-CRC stripping is off by default.
+ flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
-The on option is equivalent to the --crc-strip command-line option.
+ compare_dst (0|1)
-port config - RX Checksum
-~~~~~~~~~~~~~~~~~~~~~~~~~
+Link Bonding Functions
+----------------------
-Set hardware RX checksum offload to on or off for all ports:
+The Link Bonding functions make it possible to dynamically create and
+manage link bonding devices from within testpmd interactive prompt.
-port config all rx-cksum (on|off)
+create bonded device
+~~~~~~~~~~~~~~~~~~~~
-Checksum offload is off by default.
+Create a new bonding device:
-The on option is equivalent to the --enable-rx-cksum command-line option.
+create bonded device (mode) (socket)
-port config - VLAN
-~~~~~~~~~~~~~~~~~~
+For example, to create a bonded device in mode 1 on socket 0.
-Set hardware VLAN on or off for all ports:
+.. code-block:: console
-port config all hw-vlan (on|off)
+ testpmd> create bonded 1 0
+ created new bonded device (port X)
-Hardware VLAN is on by default.
+add bonding slave
+~~~~~~~~~~~~~~~~~
-The off option is equivalent to the --disable-hw-vlan command-line option.
+Adds Ethernet device to a Link Bonding device:
-port config - Drop Packets
-~~~~~~~~~~~~~~~~~~~~~~~~~~
+add bonding slave (slave id) (port id)
-Set packet drop for packets with no descriptors on or off for all ports:
+For example, to add Ethernet device (port 6) to a Link Bonding device (port 10).
-port config all drop-en (on|off)
+.. code-block:: console
-Packet dropping for packets with no descriptors is off by default.
+ testpmd> add bonding slave 6 10
-The on option is equivalent to the --enable-drop-en command-line option.
-port config - RSS
-~~~~~~~~~~~~~~~~~
+remove bonding slave
+~~~~~~~~~~~~~~~~~~~~
-Set the RSS (Receive Side Scaling) mode on or off:
+Removes an Ethernet slave device from a Link Bonding device:
-port config all rss (ip|udp|none)
+remove bonding slave (slave id) (port id)
-RSS is on by default.
+For example, to remove Ethernet slave device (port 6) to a Link Bonding device (port 10).
-The off option is equivalent to the --disable-rss command-line option.
+.. code-block:: console
-port config - RSS Reta
-~~~~~~~~~~~~~~~~~~~~~~
+ testpmd> remove bonding slave 6 10
-Set the RSS (Receive Side Scaling) redirection table:
+set bonding mode
+~~~~~~~~~~~~~~~~
-port config all rss reta (hash,queue)[,(hash,queue)]
+Set the Link Bonding mode of a Link Bonding device:
-port config - DCB
-~~~~~~~~~~~~~~~~~
+set bonding mode (value) (port id)
-Set the DCB mode for an individual port:
+For example, to set the bonding mode of a Link Bonding device (port 10) to broadcast (mode 3).
-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 mode 3 10
-port config - Burst
+set bonding primary
~~~~~~~~~~~~~~~~~~~
-Set the number of packets per burst:
-
-port config all burst (value)
-
-This is equivalent to the --burst command-line option.
+Set an Ethernet slave device as the primary device on a Link Bonding device:
-port config - Threshold
-~~~~~~~~~~~~~~~~~~~~~~~
+set bonding primary (slave id) (port id)
-Set thresholds for TX/RX queues:
+For example, to set the Ethernet slave device (port 6) as the primary port of a Link Bonding device (port 10).
-port config all (threshold) (value)
+.. code-block:: console
-Where the threshold type can be:
+ testpmd> set bonding primary 6 10
-* txpt: Set the prefetch threshold register of the TX rings, 0 <= value <= 255.
+set bonding mac
+~~~~~~~~~~~~~~~
-* txht: Set the host threshold register of the TX rings, 0 <= value <= 255.
+Set the MAC address of a Link Bonding device:
-* txwt: Set the write-back threshold register of the TX rings, 0 <= value <= 255.
+set bonding mac (port id) (mac)
-* rxpt: Set the prefetch threshold register of the RX rings, 0 <= value <= 255.
+For example, to set the MAC address of a Link Bonding device (port 10) to 00:00:00:00:00:01
-* 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> set bonding mac 10 00:00:00:00:00:01
-* txfreet: Set the transmit free threshold of the TX rings, 0 <= value <= txd.
+set bonding xmit_balance_policy
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-* rxfreet: Set the transmit free threshold of the RX rings, 0 <= value <= rxd.
+Set the transmission policy for a Link Bonding device when it is in Balance XOR mode:
-* txrst: Set the transmit RS bit threshold of TX rings, 0 <= value <= txd.
- These threshold options are also available from the command-line.
+set bonding xmit_balance_policy (port_id) (l2|l23|l34)
-Flow Director Functions
------------------------
+For example, set a Link Bonding device (port 10) to use a balance policy of layer 3+4 (IP addresses & UDP ports )
-The Flow Director works in receive mode to identify specific flows or sets of flows and route them to specific queues.
+.. code-block:: console
-Two types of filtering are supported which are referred to as Perfect Match and Signature filters:
+ testpmd> set bonding xmit_balance_policy 10 l34
-* Perfect match filters.
- The hardware checks a match between the masked fields of the received packets and the programmed filters.
+show bonding config
+~~~~~~~~~~~~~~~~~~~
-* Signature filters.
- The hardware checks a match between a hash-based signature of the masked fields of the received packet.
+Show the current configuration of a Link Bonding device:
-The Flow Director filters can match the following fields in a packet:
+show bonding config (port id)
-* Source IP and destination IP addresses.
+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.
-* Source port and destination port numbers (for UDP and TCP packets).
+.. code-block:: console
-* IPv4/IPv6 and UDP/ TCP/SCTP protocol match.
+ 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]
-* VLAN header.
+Register Functions
+------------------
-* Flexible 2-byte tuple match anywhere in the first 64 bytes of the packet.
+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.
-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.
+read reg
+~~~~~~~~
-In the following sections, several common parameters are used in the Flow Director filters.
-These are explained below:
+Display the value of a port register:
-* src: A pair of source address values. The source IP, in IPv4 or IPv6 format, and the source port:
+read reg (port_id) (address)
- src 192.168.0.1 1024
+For example, to examine the Flow Director control register (FDIRCTL, 0x0000EE000) on an IntelĀ® 82599 10 GbE Controller:
- src 2001:DB8:85A3:0:0:8A2E:370:7000 1024
+.. code-block:: console
-* dst: A pair of destination address values. The destination IP, in IPv4 or IPv6 format, and the destination port.
+ testpmd> read reg 0 0xEE00
+ port 0 PCI register at offset 0xEE00: 0x4A060029 (1241907241)
-* flexbytes: A 2-byte tuple to be matched within the first 64 bytes of a packet.
+read regfield
+~~~~~~~~~~~~~
-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.
+Display a port register bit field:
-* vlan: The VLAN header to match in the packet.
+read regfield (port_id) (address) (bit_x) (bit_y)
-* queue: The index of the RX queue to route matched packets to.
+For example, reading the lowest two bits from the register in the example above:
-* soft: The 16-bit value in the MBUF flow director ID field for RX packets matching the filter.
+.. code-block:: console
-add_signature_filter
-~~~~~~~~~~~~~~~~~~~~
+ testpmd> read regfield 0 0xEE00 0 1
+ port 0 PCI register at offset 0xEE00: bits[0, 1]=0x1 (1)
-Add a signature filter:
+read regbit
+~~~~~~~~~~~
-# Command is displayed on several lines for clarity.
+Display a single port register bit:
-add_signature_filter (port_id) (ip|udp|tcp|sctp)
+read regbit (port_id) (address) (bit_x)
- src (src_ip_address) (src_port)
+For example, reading the lowest bit from the register in the example above:
- dst (dst_ip_address) (dst_port)
+.. code-block:: console
- flexbytes (flexbytes_values)
+ testpmd> read regbit 0 0xEE00 0
+ port 0 PCI register at offset 0xEE00: bit 0=1
- vlan (vlan_id) queue (queue_id)
+write reg
+~~~~~~~~~
-upd_signature_filter
-~~~~~~~~~~~~~~~~~~~~
+Set the value of a port register:
-Update a signature filter:
+write reg (port_id) (address) (value)
-# Command is displayed on several lines for clarity.
+For example, to clear a register:
-upd_signature_filter (port_id) (ip|udp|tcp|sctp)
+.. code-block:: console
- src (src_ip_address) (src_port)
+ testpmd> write reg 0 0xEE00 0x0
+ port 0 PCI register at offset 0xEE00: 0x00000000 (0)
- dst (dst_ip_address) (dst_port)
+write regfield
+~~~~~~~~~~~~~~
- flexbytes (flexbytes_values)
+Set bit field of a port register:
- vlan (vlan_id) queue (queue_id)
+write regfield (port_id) (address) (bit_x) (bit_y) (value)
-rm_signature_filter
-~~~~~~~~~~~~~~~~~~~
+For example, writing to the register cleared in the example above:
-Remove a signature filter:
+.. code-block:: console
-# Command is displayed on several lines for clarity.
+ testpmd> write regfield 0 0xEE00 0 1 2
+ port 0 PCI register at offset 0xEE00: 0x00000002 (2)
-rm_signature_filter (port_id) (ip|udp|tcp|sctp)
+write regbit
+~~~~~~~~~~~~
- src (src_ip_address) (src_port)
+Set single bit value of a port register:
- dst (dst_ip_address) (dst_port)
+write regbit (port_id) (address) (bit_x) (value)
- flexbytes (flexbytes_values)
+For example, to set the high bit in the register from the example above:
- vlan (vlan_id)
+.. code-block:: console
-add_perfect_filter
-~~~~~~~~~~~~~~~~~~
+ testpmd> write regbit 0 0xEE00 31 1
+ port 0 PCI register at offset 0xEE00: 0x8000000A (2147483658)
-Add a perfect filter:
+Filter Functions
+-----------------------
-# Command is displayed on several lines for clarity.
+This section details the available filter functions that are available.
-add_perfect_filter (port_id) (ip|udp|tcp|sctp)
+add_ethertype_filter
+~~~~~~~~~~~~~~~~~~~~
- src (src_ip_address) (src_port)
+Add a L2 Ethertype filter, which identify packets by their L2 Ethertype mainly assign them to a receive queue.
- dst (dst_ip_address) (dst_port)
+add_ethertype_filter (port_id) ethertype (eth_value) priority (enable|disable) (pri_value) queue (queue_id) index (idx)
- 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
-~~~~~~~~~~~~~~~~~~
+* eth_value: the EtherType value want to match,
+ for example 0x0806 for ARP packet. 0x0800 (IPv4) and 0x86DD (IPv6) are invalid.
-Update a perfect filter:
+* enable: user priority participates in the match.
-# Command is displayed on several lines for clarity.
+* disable: user priority doesn't participate in the match.
-upd_perfect_filter (port_id) (ip|udp|tcp|sctp)
+* pri_value: user priority value that want to match.
- src (src_ip_address) (src_port)
+* queue_id : The receive queue associated with this EtherType filter
- dst (dst_ip_address) (dst_port)
+* index: the index of this EtherType filter
- flexbytes (flexbytes_values)
+Example:
- vlan (vlan_id) queue (queue_id)
+.. code-block:: console
-rm_perfect_filter
-~~~~~~~~~~~~~~~~~
+ testpmd> add_ethertype_filter 0 ethertype 0x0806 priority disable 0 queue 3 index 0
+ Assign ARP packet to receive queue 3
-Remove a perfect filter:
+remove_ethertype_filter
+~~~~~~~~~~~~~~~~~~~~~~~
-rm_perfect_filter (port_id) (ip|udp|tcp|sctp)
+Remove a L2 Ethertype filter
- src (src_ip_address) (src_port)
+remove_ethertype_filter (port_id) index (idx)
- dst (dst_ip_address) (dst_port)
+get_ethertype_filter
+~~~~~~~~~~~~~~~~~~~~
- flexbytes (flexbytes_values)
+Get and display a L2 Ethertype filter
- vlan (vlan_id) soft (soft_id)
+get_ethertype_filter (port_id) index (idx)
-set_masks_filter
-~~~~~~~~~~~~~~~~
+Example:
-Set IPv4 filter masks:
+.. code-block:: console
-# Command is displayed on several lines for clarity.
+ testpmd> get_ethertype_filter 0 index 0
-set_masks_filter (port_id) only_ip_flow (0|1)
+ filter[0]:
+ ethertype: 0x0806
+ priority: disable, 0
+ queue: 3
- src_mask (ip_src_mask) (src_port_mask)
+add_2tuple_filter
+~~~~~~~~~~~~~~~~~
- dst_mask (ip_dst_mask) (dst_port_mask)
+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.
- flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
+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)
-set_ipv6_masks_filter
-~~~~~~~~~~~~~~~~~~~~~
+The available information parameters are:
-Set IPv6 filter masks:
+* port_id: the port which the 2-tuple filter assigned on.
-# Command is displayed on several lines for clarity.
+* pro_value: IP L4 protocol
-set_ipv6_masks_filter (port_id) only_ip_flow (0|1)
+* pro_mask: protocol participates in the match or not, 1 means participate
- src_mask (ip_src_mask) (src_port_mask)
+* port_value: destination port in L4.
- dst_mask (ip_dst_mask) (dst_port_mask)
+* port_mask: destination port participates in the match or not, 1 means participate.
- flexbytes (0|1) vlan_id (0|1) vlan_prio (0|1)
+* flg_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: the 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.
+* index: the index of this 2-tuple filter
-create bonded device
-~~~~~~~~~~~~~~~~~~~~
+Example:
-Create a new bonding device:
+.. code-block:: console
-create bonded device (mode) (socket)
+ testpmd> add_2tuple_filter 0 protocol 0x06 1 dst_port 32 1 flags 0x02 priority 3 queue 3 index 0
-For example, to create a bonded device in mode 1 on socket 0.
+remove_2tuple_filter
+~~~~~~~~~~~~~~~~~~~~
-.. code-block:: console
+Remove a 2-tuple filter
- testpmd> create bonded 1 0
- created new bonded device (port X)
+remove_2tuple_filter (port_id) index (idx)
-add bonding slave
+get_2tuple_filter
~~~~~~~~~~~~~~~~~
-Adds Ethernet device to a Link Bonding device:
+Get and display a 2-tuple filter
-add bonding slave (slave id) (port id)
+get_2tuple_filter (port_id) index (idx)
-For example, to add Ethernet device (port 6) to a Link Bonding device (port 10).
+Example:
.. code-block:: console
- testpmd> add bonding slave 6 10
+ testpmd> get_2tuple_filter 0 index 0
+ filter[0]:
+ Destination Port: 0x0020 mask: 1
+ protocol: 0x06 mask:1 tcp_flags: 0x02
+ priority: 3 queue: 3
-remove bonding slave
-~~~~~~~~~~~~~~~~~~~~
+add_5tuple_filter
+~~~~~~~~~~~~~~~~~
-Removes an Ethernet slave device from a Link Bonding device:
+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.
-remove bonding slave (slave id) (port id)
+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)
-For example, to remove Ethernet slave device (port 6) to a Link Bonding device (port 10).
+The available information parameters are:
-.. code-block:: console
+* port_id: the port which the 5-tuple filter assigned on.
- testpmd> remove bonding slave 6 10
+* dst_address: destination IP address.
-set bonding mode
-~~~~~~~~~~~~~~~~
+* src_address: source IP address.
-Set the Link Bonding mode of a Link Bonding device:
+* dst_port_value: TCP/UDP destination port.
-set bonding mode (value) (port id)
+* src_port_value: TCP/UDP source port.
-For example, to set the bonding mode of a Link Bonding device (port 10) to broadcast (mode 3).
+* protocol_value: L4 protocol.
-.. code-block:: console
+* mask_value: participates in the match or not by bit for field above, 1b means participate
- testpmd> set bonding mode 3 10
+* flags_value: TCP control bits. The non-zero value is invalid, when the protocol_value is not set to 0x06 (TCP).
-set bonding primary
-~~~~~~~~~~~~~~~~~~~
+* prio_value: the priority of this filter.
-Set an Ethernet slave device as the primary device on a Link Bonding device:
+* queue_id: The receive queue associated with this 5-tuple filter.
-set bonding primary (slave id) (port id)
+* index: the index of this 5-tuple filter
-For example, to set the Ethernet slave device (port 6) as the primary port of a Link Bonding device (port 10).
+Example:
.. code-block:: console
- testpmd> set bonding primary 6 10
+ 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 bonding mac
-~~~~~~~~~~~~~~~
+remove_5tuple_filter
+~~~~~~~~~~~~~~~~~~~~
-Set the MAC address of a Link Bonding device:
+Remove a 5-tuple filter
-set bonding mac (port id) (mac)
+remove_5tuple_filter (port_id) index (idx)
-For example, to set the MAC address of a Link Bonding device (port 10) to 00:00:00:00:00:01
+get_5tuple_filter
+~~~~~~~~~~~~~~~~~
+
+Get and display a 5-tuple filter
+
+get_5tuple_filter (port_id) index (idx)
+
+Example:
.. code-block:: console
- testpmd> set bonding mac 10 00:00:00:00:00:01
+ testpmd> get_5tuple_filter 1 index 0
-set bonding xmit_balance_policy
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+ 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 the transmission policy for a Link Bonding device when it is in Balance XOR mode:
+add_syn_filter
+~~~~~~~~~~~~~~
-set bonding xmit_balance_policy (port_id) (l2|l23|l34)
+Add SYN filter, which can forward TCP packets whose *SYN* flag is set into a separate queue.
-For example, set a Link Bonding device (port 10) to use a balance policy of layer 3+4 (IP addresses & UDP ports )
+add_syn_filter (port_id) priority (high|low) queue (queue_id)
-.. code-block:: console
+The available information parameters are:
- testpmd> set bonding xmit_balance_policy 10 l34
+* port_id: the port which the SYN filter assigned on.
-show bonding config
-~~~~~~~~~~~~~~~~~~~
+* high: this SYN filter has higher priority than other filters.
-Show the current configuration of a Link Bonding device:
+* low: this SYN filter has lower priority than other filters.
-show bonding config (port id)
+* queue_id: The receive queue associated with this SYN filter
-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.
+Example:
.. code-block:: console
- 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]
+ testpmd> add_syn_filter 0 priority high queue 3,
-Register Functions
-------------------
+remove_syn_filter
+~~~~~~~~~~~~~~~~~
-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.
+Remove SYN filter
-read reg
-~~~~~~~~
+remove_syn_filter (port_id)
-Display the value of a port register:
+get_syn_filter
+~~~~~~~~~~~~~~
-read reg (port_id) (address)
+Get and display SYN filter
-For example, to examine the Flow Director control register (FDIRCTL, 0x0000EE000) on an IntelĀ® 82599 10 GbE Controller:
+get_syn_filter (port_id)
+
+Example:
.. code-block:: console
- testpmd> read reg 0 0xEE00
- port 0 PCI register at offset 0xEE00: 0x4A060029 (1241907241)
+ testpmd> get_syn_filter 0
-read regfield
-~~~~~~~~~~~~~
+ syn filter: on, priority: high, queue: 3
-Display a port register bit field:
+add_flex_filter
+~~~~~~~~~~~~~~~
-read regfield (port_id) (address) (bit_x) (bit_y)
+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.
-For example, reading the lowest two bits from the register in the example above:
+add_flex_filter (port_id) len (len_value) bytes (bytes_string) mask (mask_value)
+priority (prio_value) queue (queue_id) index (idx)
-.. code-block:: console
+The available information parameters are:
- testpmd> read regfield 0 0xEE00 0 1
- port 0 PCI register at offset 0xEE00: bits[0, 1]=0x1 (1)
+* port_id: the port which the Flex filter assigned on.
-read regbit
-~~~~~~~~~~~
+* len_value: filter length in byte, no greater than 128.
-Display a single port register bit:
+* bytes_string: a sting in format of octal, means the value the flex filter need to match.
-read regbit (port_id) (address) (bit_x)
+* mask_value: a sting in format of octal, bit 1 means corresponding byte in DWORD participates in the match.
-For example, reading the lowest bit from the register in the example above:
+* prio_value: the priority of this filter.
-.. code-block:: console
+* queue_id: The receive queue associated with this Flex filter.
- testpmd> read regbit 0 0xEE00 0
- port 0 PCI register at offset 0xEE00: bit 0=1
+* index: the index of this Flex filter
-write reg
-~~~~~~~~~
+Example:
-Set the value of a port register:
+.. code-block:: console
-write reg (port_id) (address) (value)
+ testpmd> add_flex_filter 0 len 16 bytes 0x00000000000000000000000008060000 mask 000C priority 3 queue 3 index 0
-For example, to clear a register:
+Assign a packet whose 13th and 14th bytes are 0x0806 to queue 3.
-.. code-block:: console
+remove_flex_filter
+~~~~~~~~~~~~~~~~~~
- testpmd> write reg 0 0xEE00 0x0
- port 0 PCI register at offset 0xEE00: 0x00000000 (0)
+Remove a Flex filter
-write regfield
-~~~~~~~~~~~~~~
+remove_flex_filter (port_id) index (idx)
-Set bit field of a port register:
+get_flex_filter
+~~~~~~~~~~~~~~~
-write regfield (port_id) (address) (bit_x) (bit_y) (value)
+Get and display a Flex filter
-For example, writing to the register cleared in the example above:
+get_flex_filter (port_id) index (idx)
-.. code-block:: console
+Example:
- testpmd> write regfield 0 0xEE00 0 1 2
- port 0 PCI register at offset 0xEE00: 0x00000002 (2)
+.. code-block:: console
-write regbit
-~~~~~~~~~~~~
+ testpmd> get_flex_filter 0 index 0
-Set single bit value of a port register:
+ filter[0]:
-write regbit (port_id) (address) (bit_x) (value)
+ length: 16
-For example, to set the high bit in the register from the example above:
+ 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
-.. code-block:: console
+ mask[]:
+ 0b0000000000001100000000000000000000000000000000000000000000000000000000
+ 0000000000000000000000000000000000000000000000000000000000
- testpmd> write regbit 0 0xEE00 31 1
- port 0 PCI register at offset 0xEE00: 0x8000000A (2147483658)
+ priority: 3 queue: 3