From patchwork Tue Dec 7 23:01:51 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rashmi Shetty X-Patchwork-Id: 105010 X-Patchwork-Delegate: jerinj@marvell.com Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 14E19A00C3; Wed, 8 Dec 2021 00:02:01 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id AE825410E8; Wed, 8 Dec 2021 00:02:00 +0100 (CET) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by mails.dpdk.org (Postfix) with ESMTP id E3EF2406A2 for ; Wed, 8 Dec 2021 00:01:58 +0100 (CET) X-IronPort-AV: E=McAfee;i="6200,9189,10191"; a="224963136" X-IronPort-AV: E=Sophos;i="5.87,295,1631602800"; d="scan'208";a="224963136" Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga101.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 07 Dec 2021 15:01:54 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.87,295,1631602800"; d="scan'208";a="515502486" Received: from txanpdk02.an.intel.com ([10.123.117.76]) by orsmga008.jf.intel.com with ESMTP; 07 Dec 2021 15:01:53 -0800 From: Rashmi Shetty To: dev@dpdk.org Cc: jerinj@marvell.com, harry.van.haaren@intel.com, pravin.pathak@intel.com, mike.ximing.chen@intel.com, timothy.mcdaniel@intel.com, Rashmi Shetty Subject: [PATCH v2] doc/dlb2: update dlb2 documentation Date: Tue, 7 Dec 2021 17:01:51 -0600 Message-Id: <20211207230151.2332031-1-rashmi.shetty@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20211206163639.2220123-1-rashmi.shetty@intel.com> References: <20211206163639.2220123-1-rashmi.shetty@intel.com> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Number of direct credits, atomic inflight and history list are updated to DLB2.0 supported sizes. As DLB2.0 does not provide dev arg to override the default per-queue atomic inflight allocation, it is removed from the documentation. Signed-off-by: Rashmi Shetty --- doc/guides/eventdevs/dlb2.rst | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) diff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rst index bce984ca08..bc53618b53 100644 --- a/doc/guides/eventdevs/dlb2.rst +++ b/doc/guides/eventdevs/dlb2.rst @@ -151,7 +151,7 @@ load-balanced queues, and directed credits are used for directed queues. These pools' sizes are controlled by the nb_events_limit field in struct rte_event_dev_config. The load-balanced pool is sized to contain nb_events_limit credits, and the directed pool is sized to contain -nb_events_limit/4 credits. The directed pool size can be overridden with the +nb_events_limit/2 credits. The directed pool size can be overridden with the num_dir_credits devargs argument, like so: .. code-block:: console @@ -239,8 +239,8 @@ queue A. Due to this, workers should stop retrying after a time, release the events it is attempting to enqueue, and dequeue more events. It is important that the worker release the events and don't simply set them aside to retry the enqueue -again later, because the port has limited history list size (by default, twice -the port's dequeue_depth). +again later, because the port has limited history list size (by default, same +as port's dequeue_depth). Priority ~~~~~~~~ @@ -309,18 +309,11 @@ scheduled. The likelihood of this case depends on the eventdev configuration, traffic behavior, event processing latency, potential for a worker to be interrupted or otherwise delayed, etc. -By default, the PMD allocates 16 buffer entries for each load-balanced queue, -which provides an even division across all 128 queues but potentially wastes +By default, the PMD allocates 64 buffer entries for each load-balanced queue, +which provides an even division across all 32 queues but potentially wastes buffer space (e.g. if not all queues are used, or aren't used for atomic scheduling). -The PMD provides a dev arg to override the default per-queue allocation. To -increase per-queue atomic-inflight allocation to (for example) 64: - - .. code-block:: console - - --allow ea:00.0,atm_inflights=64 - QID Depth Threshold ~~~~~~~~~~~~~~~~~~~ @@ -337,7 +330,7 @@ Per queue threshold metrics are tracked in the DLB xstats, and are also returned in the impl_opaque field of each received event. The per qid threshold can be specified as part of the device args, and -can be applied to all queue, a range of queues, or a single queue, as +can be applied to all queues, a range of queues, or a single queue, as shown below. .. code-block:: console