From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id B1C521B2B7; Fri, 19 Jan 2018 04:36:07 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 18 Jan 2018 19:36:06 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,380,1511856000"; d="scan'208";a="11407661" Received: from dpdk2.bj.intel.com ([172.16.182.81]) by fmsmga007.fm.intel.com with ESMTP; 18 Jan 2018 19:36:04 -0800 From: Wei Zhao To: dev@dpdk.org Cc: john.mcnamara@intel.com, stable@dpdk.org, Wei Zhao Date: Fri, 19 Jan 2018 11:28:14 +0800 Message-Id: <20180119032814.57248-1-wei.zhao1@intel.com> X-Mailer: git-send-email 2.9.3 In-Reply-To: <20180108033953.142410-1-wei.zhao1@intel.com> References: <20180108033953.142410-1-wei.zhao1@intel.com> Subject: [dpdk-dev] [PATCH v4] doc: add queue region feature info to release notes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Jan 2018 03:36:08 -0000 This patch add inforation about i40e queue region realted to release notes, it has been missed before in v17.11 release notes. This feature has been implemented in v17.11. Signed-off-by: Wei Zhao --- v2: -change this information to v18.02 release notes. v3: -rework it on dpdk-next-net-intel sub tree. v4: -rework it into 17.11 release notes and i40e.rst --- doc/guides/nics/i40e.rst | 24 +++++++++++++++++++++++- doc/guides/rel_notes/release_17_11.rst | 6 ++++++ 2 files changed, 29 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/i40e.rst b/doc/guides/nics/i40e.rst index 50d5e36..345abf3 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,28 @@ 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 support a feature of queue regions +configuration for RSS in 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 region in rss with +command line. It can parse the parameters of region index, queue number, queue +start index, user priority, traffic classes and so on. According to commands +from command line, it will call i40e private API and start the process of set +or flush queue region configuration. As this feature is specific for i40e, so +private API is used. These new commands are as below, for details please reference to +document testpmd_funcs.rst. + +.. 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 016a08c..15321d6 100644 --- a/doc/guides/rel_notes/release_17_11.rst +++ b/doc/guides/rel_notes/release_17_11.rst @@ -273,6 +273,12 @@ New Features applications to classify an input packet by matching it against a set of flow rules. It uses the ``librte_table`` API to manage the flow rules. +* **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. Resolved Issues --------------- -- 2.9.3