From patchwork Tue Sep 27 00:18:35 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Sevincer, Abdullah" X-Patchwork-Id: 116917 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 75F44A00C2; Tue, 27 Sep 2022 02:18:42 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 1079B40A8A; Tue, 27 Sep 2022 02:18:42 +0200 (CEST) Received: from mga14.intel.com (mga14.intel.com [192.55.52.115]) by mails.dpdk.org (Postfix) with ESMTP id A05F140146 for ; Tue, 27 Sep 2022 02:18:39 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1664237919; x=1695773919; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=YnMyB3LMkG6I9zep96iFFIzXu6Li7gRhCc5WVUW0JiI=; b=YtkQYkfpOkt4CASQXevRW7ygT1+cLP3BdejEW88YKdOUG+sLsfAU1g6A 9aznzGB894ZCW4l7rZScvZQ5lRQKJM4keqNAVbUKNpeBfj3IFvbxxm9xS vZuzQpxDw2Y0Bjth5ZR/dAWmrURvesKC76QxXgg706Ghyu7wQXcC0U7mq AgcV+6IaF3vaUkJp/yHvI1Wrqchf4V4WmFMLLwg6luAgEJA+2LSXH1nFj KOJXdjv06Q+iBynJJ7HeMrejqCsVX29IpgfdymbyQaEIIOA+1mUJL+HTo ZmGlE/YF6rikhqGl8wl9AQLZZ8K6OqKpJEKGkVqrlZOOjQZcgoCQyrY0e w==; X-IronPort-AV: E=McAfee;i="6500,9779,10482"; a="301157051" X-IronPort-AV: E=Sophos;i="5.93,347,1654585200"; d="scan'208";a="301157051" Received: from orsmga003.jf.intel.com ([10.7.209.27]) by fmsmga103.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Sep 2022 17:18:38 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10482"; a="572440144" X-IronPort-AV: E=Sophos;i="5.93,347,1654585200"; d="scan'208";a="572440144" Received: from txanpdk02.an.intel.com ([10.123.117.76]) by orsmga003.jf.intel.com with ESMTP; 26 Sep 2022 17:18:37 -0700 From: Abdullah Sevincer To: dev@dpdk.org Cc: jerinj@marvell.com, rashmi.shetty@intel.com, pravin.pathak@intel.com, mike.ximing.chen@intel.com, timothy.mcdaniel@intel.com, shivani.doneria@intel.com, tirthendu.sarkar@intel.com, Abdullah Sevincer Subject: [PATCH v3] doc: update DLB2 documentation Date: Mon, 26 Sep 2022 19:18:35 -0500 Message-Id: <20220927001835.1394994-1-abdullah.sevincer@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20220926230703.1388093-1-abdullah.sevincer@intel.com> References: <20220926230703.1388093-1-abdullah.sevincer@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 This commit updates the dlb2.rst eventdev guide to document a new devarg. A new devarg: "default_port_allocation" added to allow default ldb port allocation scheme. Signed-off-by: Abdullah Sevincer --- doc/guides/eventdevs/dlb2.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rst index 5b21f13b68..2a0bdacfbd 100644 --- a/doc/guides/eventdevs/dlb2.rst +++ b/doc/guides/eventdevs/dlb2.rst @@ -414,3 +414,22 @@ Note that the weight may not exceed the maximum CQ depth. --allow ea:00.0,cq_weight=all: --allow ea:00.0,cq_weight=qidA-qidB: --allow ea:00.0,cq_weight=qid: + +Default LDB Port Allocation +~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +For optimal load balancing ports that map to one or more QIDs in common +should not be in numerical sequence. The port->QID mapping is application +dependent, but the driver interleaves port IDs as much as possible to +reduce the likelihood of sequential ports mapping to the same QID(s). + +Hence, DLB uses an initial allocation of Port IDs to maximize the +average distance between an ID and its immediate neighbors. (i.e.the +distance from 1 to 0 and to 2, the distance from 2 to 1 and to 3, etc.). +Initial port allocation option can be passed through devarg. If y (or Y) +inial port allocation will be used, otherwise initial port allocation +won't be used. + + .. code-block:: console + + --allow ea:00.0,default_port_allocation=