From patchwork Thu Jan 18 03:45:03 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Zhao1, Wei" X-Patchwork-Id: 33956 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 D32AF1B1A7; Thu, 18 Jan 2018 04:52:58 +0100 (CET) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 21E581B16F for ; Thu, 18 Jan 2018 04:52:56 +0100 (CET) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga101.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 17 Jan 2018 19:52:55 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.46,375,1511856000"; d="scan'208";a="27383945" Received: from dpdk2.bj.intel.com ([172.16.182.81]) by orsmga002.jf.intel.com with ESMTP; 17 Jan 2018 19:52:54 -0800 From: Wei Zhao To: dev@dpdk.org Cc: john.mcnamara@intel.com, Wei Zhao Date: Thu, 18 Jan 2018 11:45:03 +0800 Message-Id: <20180118034503.42354-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: , 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 --- 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 ---------------