From db449ae8da7ede67f1c61202bfae1fe36eaf1b9c Mon Sep 17 00:00:00 2001 From: Wei Zhao Date: Mon, 22 Jan 2018 13:18:30 +0800 Subject: [PATCH] doc: add i40e queue region support to release notes This patch adds information about i40e queue region related to the release notes. Cc: stable@dpdk.org Signed-off-by: Wei Zhao Acked-by: John McNamara --- doc/guides/nics/i40e.rst | 25 ++++++++++++++++++++++++- doc/guides/rel_notes/release_17_11.rst | 7 +++++++ 2 files changed, 31 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index 50d5e36a5d..29601f1007 100644 --- a/doc/guides/nics/i40e.rst +++ b/doc/guides/nics/i40e.rst @@ -66,7 +66,7 @@ Features of the I40E PMD are: - IEEE1588/802.1AS timestamping - VF Daemon (VFD) - EXPERIMENTAL - Dynamic Device Personalization (DDP) - +- Queue region configuration Prerequisites ------------- @@ -430,6 +430,29 @@ For example, to use only 48bit prefix for IPv6 src address for IPv6 TCP RSS: testpmd> port config 0 pctype 43 hash_inset set field 14 testpmd> port config 0 pctype 43 hash_inset set field 15 +Queue region configuration +~~~~~~~~~~~~~~~~~~~~~~~~~~~ +The Ethernet Controller X710/XL710 supports a feature of queue regions +configuration for RSS in the PF, so that different traffic classes or +different packet classification types can be separated to different +queues in different queue regions. There is an API for configuration +of queue regions in RSS with a command line. It can parse the parameters +of the region index, queue number, queue start index, user priority, traffic +classes and so on. Depending on commands from the command line, it will call +i40e private APIs and start the process of setting or flushing the queue +region configuration. As this feature is specific for i40e only private +APIs are used. These new ``test_pmd`` commands are as shown below. For +details please refer to :doc:`../testpmd_app_ug/index`. + +.. code-block:: console + + testpmd> set port (port_id) queue-region region_id (value) \ + queue_start_index (value) queue_num (value) + testpmd> set port (port_id) queue-region region_id (value) flowtype (value) + testpmd> set port (port_id) queue-region UP (value) region_id (value) + testpmd> set port (port_id) queue-region flush (on|off) + testpmd> show port (port_id) queue-region + Limitations or Known issues --------------------------- diff --git a/doc/guides/rel_notes/release_17_11.rst b/doc/guides/rel_notes/release_17_11.rst index c37c71a809..088778bf61 100644 --- a/doc/guides/rel_notes/release_17_11.rst +++ b/doc/guides/rel_notes/release_17_11.rst @@ -216,6 +216,13 @@ New Features profiles which can be programmed by dynamic device personalization (DDP) process. +* **Added the i40e ethernet driver to support queue region feature.** + + This feature enable queue regions configuration for RSS in PF, + so that different traffic classes or different packet + classification types can be separated into different queues in + different queue regions. + * **Updated ipsec-secgw application to support rte_security.** Updated the ``ipsec-secgw`` sample application to support ``rte_security`` -- 2.20.1