From patchwork Tue Sep 27 00:10:39 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Sevincer, Abdullah" X-Patchwork-Id: 116916 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 66BE2A00C2; Tue, 27 Sep 2022 02:10:45 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 4943340A8A; Tue, 27 Sep 2022 02:10:45 +0200 (CEST) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by mails.dpdk.org (Postfix) with ESMTP id 0210740146 for ; Tue, 27 Sep 2022 02:10:42 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1664237443; x=1695773443; h=from:to:cc:subject:date:message-id:mime-version: content-transfer-encoding; bh=YnMyB3LMkG6I9zep96iFFIzXu6Li7gRhCc5WVUW0JiI=; b=KdPi4iEwu/x+c/7Bu5umkjuekJhBABCyE0DL5ipzIDgN+2uHjPpK9hxC 1zZBo5ZxIhMx/NmwtadBijynlRX5cBuWe84dd5ic5kIrALvU+/3bYYyXG GyeFpeXkDKhsHrILnXnZFQZWkYJ1Rv8IiRPHCjGzEKVoBUTVdK8T7wzXF 5fH0bW9t0x3YKLa2Fv0+JJkpMNAzJMgRdb3KV8e66Ugkuj/x5TIn/0iYY tPfGg8b9Xha1+nw1vubXqSZC5y8wTzlpdqlGXhfEcyXVGd25vEos/kdmM EfDGYZYGpq60sJBfDSJerluMOEZwSOUxoakZA4v4uIrLtXNqG0PfBhAx/ Q==; X-IronPort-AV: E=McAfee;i="6500,9779,10482"; a="288317881" X-IronPort-AV: E=Sophos;i="5.93,347,1654585200"; d="scan'208";a="288317881" Received: from orsmga007.jf.intel.com ([10.7.209.58]) by orsmga101.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 26 Sep 2022 17:10:42 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=McAfee;i="6500,9779,10482"; a="616620513" X-IronPort-AV: E=Sophos;i="5.93,347,1654585200"; d="scan'208";a="616620513" Received: from txanpdk02.an.intel.com ([10.123.117.76]) by orsmga007.jf.intel.com with ESMTP; 26 Sep 2022 17:10:41 -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 v2] doc: update DLB2 documentation Date: Mon, 26 Sep 2022 19:10:39 -0500 Message-Id: <20220927001039.1393551-1-abdullah.sevincer@intel.com> X-Mailer: git-send-email 2.25.1 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=