From patchwork Mon Jan 22 05:18:30 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Zhao1, Wei" X-Patchwork-Id: 34211 X-Patchwork-Delegate: helin.zhang@intel.com Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 980101B00B; Mon, 22 Jan 2018 06:26:24 +0100 (CET) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by dpdk.org (Postfix) with ESMTP id 4B1A1199AC; Mon, 22 Jan 2018 06:26:23 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 21 Jan 2018 21:26:21 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,395,1511856000"; d="scan'208";a="23575160" Received: from dpdk2.bj.intel.com ([172.16.182.81]) by fmsmga004.fm.intel.com with ESMTP; 21 Jan 2018 21:26:20 -0800 From: Wei Zhao To: dev@dpdk.org Cc: john.mcnamara@intel.com, thomas@monjalon.net, stable@dpdk.org, Wei Zhao Date: Mon, 22 Jan 2018 13:18:30 +0800 Message-Id: <20180122051830.102203-1-wei.zhao1@intel.com> X-Mailer: git-send-email 2.9.3 In-Reply-To: <20180119032814.57248-1-wei.zhao1@intel.com> References: <20180119032814.57248-1-wei.zhao1@intel.com> Subject: [dpdk-dev] [PATCH v5] 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: , Errors-To: dev-bounces@dpdk.org Sender: "dev" 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 Acked-by: John McNamara --- 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. v5: -change some use of words and comment location in file. --- 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 50d5e36..29601f1 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 c37c71a..088778b 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``