From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 51018A034C; Tue, 14 Dec 2021 17:10:58 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3FFFB406A2; Tue, 14 Dec 2021 17:10:58 +0100 (CET) Received: from mga06.intel.com (mga06.intel.com [134.134.136.31]) by mails.dpdk.org (Postfix) with ESMTP id A60DF40041 for ; Tue, 14 Dec 2021 17:10:56 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=simple/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1639498257; x=1671034257; h=from:to:cc:subject:date:message-id:references: in-reply-to:content-transfer-encoding:mime-version; bh=BhColrsGDDiXIjtDW+JDCyHk0vTFciNzOAL8wK8Iu1U=; b=Z7gau1vHhQCrhSTa6z6gTmDEgq3JymU9TzGy3Pv281cS5hOXekodRYVL HYEY5HyLJ+1jS4/dxvynsm6UEfcXshOsee43diKBGxOazKuqB37UK49Di 8GqFyXVvicjS8HyLHiUi3TOxRThGNX6qQf9Q0A5h7aMD1i/3hfz8+JtlH hAJJGRgv1YyO8yT9wkjicT+/pjDz5LCs0uu8vFUP9mLAk14LP3FrwJrnN v3H7HL2AijTza246BSQI0any/mmhleRfwyK/Q/v9AuqALL6NsS40rblfp 0H6V5v+DvwiWDZSk2Uv76XsnGMJKLiMC7NZkI6zLLSxsZ+x95A3Pz7ysb A==; X-IronPort-AV: E=McAfee;i="6200,9189,10197"; a="299787803" X-IronPort-AV: E=Sophos;i="5.88,205,1635231600"; d="scan'208";a="299787803" Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by orsmga104.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 14 Dec 2021 08:08:25 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.88,205,1635231600"; d="scan'208";a="661424585" Received: from orsmsx601.amr.corp.intel.com ([10.22.229.14]) by fmsmga001.fm.intel.com with ESMTP; 14 Dec 2021 08:08:25 -0800 Received: from orsmsx611.amr.corp.intel.com (10.22.229.24) by ORSMSX601.amr.corp.intel.com (10.22.229.14) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.20; Tue, 14 Dec 2021 08:08:24 -0800 Received: from orsmsx607.amr.corp.intel.com (10.22.229.20) by ORSMSX611.amr.corp.intel.com (10.22.229.24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.20; Tue, 14 Dec 2021 08:08:24 -0800 Received: from orsedg603.ED.cps.intel.com (10.7.248.4) by orsmsx607.amr.corp.intel.com (10.22.229.20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2308.20 via Frontend Transport; Tue, 14 Dec 2021 08:08:24 -0800 Received: from NAM12-BN8-obe.outbound.protection.outlook.com (104.47.55.170) by edgegateway.intel.com (134.134.137.100) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.1.2308.20; Tue, 14 Dec 2021 08:08:24 -0800 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DMRmQzi47xH791ONmDXM1MGeCMWJ5q48W7wz6UWqEDlmrsIf4eLoordthUoAyHsEtW3oKUM16UcsGrYPcgT9liWl2kO/wHz98XhRDli++JFsrMhOsD4Kzb5bqV6E91/G2OY6pdQwc/Sxv13boPlguXT5XSFtHn8LEoc9Fd74Gf/YJnUVVDAHgZO2ioYCoiF99iYfx+J3NI2Gg2HlIpRaUN1ev9DSf/qLb625GtzRJMHy0MTlNrV7lvATGjoX1iDrHYjNS/f07fBUkUwgPtbwNJAZ5XBZGzmPf/jkQfbWisbXPQtIo1s/DqqH2WOiZUO/MMy0ul/8lS2G94e5TDlgKQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=98dE5CiAxJaGHBppm4dF+eUoiS+A1D47omxA+HSNb8M=; b=nFXp5GTU4A4a5kI9q/4fadGMzn5SC8TpmR5V3woX76EXRxs2guTZEHFWnpOZ7vAwsZMu1vaNgr/jfHQTo03HC13LuxE2dM+k2465DfD8JVwiv5uuKSA/1vh8bxVFENbN/IZwyQ3QcsmpnwdT/LARAAW82J7G20LRpbBcvSbeAnoCb5TxL/8YN8AL9SkMN8j2c5UyjPVOL60v9wv9sG7tu/+ZajSVrYu0mnNaMTfdLrGoZAlbwRf3Ttref60vUycrdrdJzV7rXEbbAJKMDPq8taBQy+ihBAZdTnjBH1SQuLgfZd5px8fvKWVy9TSt8aZ4HhwxWxgp2ks5nsauidJmnA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=98dE5CiAxJaGHBppm4dF+eUoiS+A1D47omxA+HSNb8M=; b=nxgs3w4B8Tth/LcJTgwdxklPR9DTBq1EGVFfaofylAw3XqQsxUTEUTQzqFowTEWwWscKTdvDUq3PnHMf/MIUXp1L9dxFhwq2oJ0EnDyASIdyWGSWtXtqC7yWNdl8igicyAge/THRjWSp5Z7jkkjxsMvcfH3Rw12L/4lJwJX6eT8= Received: from SN6PR11MB3103.namprd11.prod.outlook.com (2603:10b6:805:d7::13) by SN6PR11MB3294.namprd11.prod.outlook.com (2603:10b6:805:c4::33) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.4778.17; Tue, 14 Dec 2021 16:08:22 +0000 Received: from SN6PR11MB3103.namprd11.prod.outlook.com ([fe80::4d37:4e1e:9da2:1bc2]) by SN6PR11MB3103.namprd11.prod.outlook.com ([fe80::4d37:4e1e:9da2:1bc2%6]) with mapi id 15.20.4778.018; Tue, 14 Dec 2021 16:08:22 +0000 From: "McDaniel, Timothy" To: "Shetty, Rashmi" , "dev@dpdk.org" CC: "jerinj@marvell.com" , "Van Haaren, Harry" , "Pathak, Pravin" , "Chen, Mike Ximing" Subject: RE: [PATCH v2] doc/dlb2: update dlb2 documentation Thread-Topic: [PATCH v2] doc/dlb2: update dlb2 documentation Thread-Index: AQHX675zTFENVwdl4UCW9dwqe9IxIqwyMWLA Date: Tue, 14 Dec 2021 16:08:22 +0000 Message-ID: References: <20211206163639.2220123-1-rashmi.shetty@intel.com> <20211207230151.2332031-1-rashmi.shetty@intel.com> In-Reply-To: <20211207230151.2332031-1-rashmi.shetty@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: dlp-product: dlpe-windows dlp-reaction: no-action dlp-version: 11.6.200.16 authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=intel.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: ef0513b8-b9e8-42e5-c77e-08d9bf1bf3e0 x-ms-traffictypediagnostic: SN6PR11MB3294:EE_ x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: xX+lHLO0yxQbHHESKaFlSIf6Zl8E2BXChZocjeyhIHfIlg7DKvK48cjsVoyKgCqjrPyoG99qp4PbbhYhYDDK11uGUr32hYuGfVHuhUHFZHxUnLDOQfUdRS1j5HYU2NrJMbFLdmma8PJoyUFWVlM77zbUwPoxJT12DcFod2xulAcd9LcYNzeMwR52Zfnpfdrtc/JtB7F67OTSbE4U6HHcRYEBchWER7Lf6kUXjMpsOKVpkmKDCRn8tBolzpJVLb2vgv0l5uXb9PQRptTop2Tiw4INIqtGJOzDGgI6Gatu28mSeF7z+6+cAwoCKgfigTo+dm2xDbA9Ywjrg7ZUAMcCq1HJKCtZ0vLklKmcTMHgMK+o20kMI43536EPDdbydTWM/agC0Zeh2dtssFlXh0X4UEh0fWDIXO8ZgMa36UIX0k/N0LOLmigiEMVeV4icrVenA5Bz98YTRSefykrx97ZS636/xGqRr6ioZbtw3AcZXlxuaAlbYI+13vHC3/Py7O1+uXrwAfmlZvI7H+HCRJqSXDR7Oy0KPZsAGz2G4k9X0pNnMj0JDtjWeJDVOy+c36gRqCfZryih66Sx/Y2S/LOuP69qXS/wK1ueTz4EugSBpv/Gg1oqfO0w0ms8xkmqUz41QivDPS8kvnxWMWdYk8DjDZqdGamwNqFiuRbD9Sz5BiUKbl2tIgEGDe1y6OECPQP9hNQRbjxLyTkO6PZh2pIceg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:SN6PR11MB3103.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFS:(366004)(8936002)(33656002)(52536014)(508600001)(55016003)(66946007)(38070700005)(64756008)(186003)(66476007)(76116006)(82960400001)(316002)(54906003)(66446008)(71200400001)(66556008)(110136005)(53546011)(6506007)(83380400001)(8676002)(122000001)(7696005)(4326008)(107886003)(15650500001)(5660300002)(38100700002)(26005)(9686003)(86362001)(2906002); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?ttsuU4XuTRHXKErdJJBoJdm5/4Qwh1f+6ftOZMmVxfrZ/nySjeQaPr5WSDUQ?= =?us-ascii?Q?pPoEpKztkd+eHEc2tWdZ6GFoXriumLW9tL32VmKOSdHutk/LcuEE+0SrcWOr?= =?us-ascii?Q?vBPbWVW4JJvYvLoJPVTG9MrtfrdphPkeZh0Lt7SMoIE+ucXceSXyNlT3rbgJ?= =?us-ascii?Q?kaXFIH7vsbnGMevZG94L/Rld4Fin5Q9+bEQJRoohqdd1eAw0Y1pGnDx6Sxr2?= =?us-ascii?Q?mNO7Ex9MO0UM3oid2UCdJ+VScuM+j/BGbayTIMi02rht/jUW1zs8ZDYgLA82?= =?us-ascii?Q?g1mJfSimmsW35DWldweoJDwKgrY2fTRmV3jDJ/HcVaXcxERUyjS8nowikEOR?= =?us-ascii?Q?Ia4Tf+x2Bapd2cmlmcSLqkBYO5J73g5RaEuV3bmcCo43sulUmaVHEeKAGmtV?= =?us-ascii?Q?zm00NoKlFDiPlc4n4YECApL9q9/GxWRj6aH/kz5JKCL+89hoVqXrjRagIXBa?= =?us-ascii?Q?x94lWs7Cio10TBD+CJ75C61JP2rXdPtudNPr1hUg93i0mHUkSdaqgF6Ndafd?= =?us-ascii?Q?1nD6I58PGO2mDtbdXBtoRpMrXGfH0vZnluh3Rfx3n+rVIUwHx7WBjMvFO+Z4?= =?us-ascii?Q?ydexmYFl5cIK6YexLm3ypIUnGrUPBmKbeXoNGXmaK6UfJ926vzGJdW/REIHI?= =?us-ascii?Q?4yTJauJJZkz2X8+paGXJABzF/Uyh0nNv9tE7CCGtZ4aRaX4lY2uJZPE2MkxW?= =?us-ascii?Q?y3bXuAUXFP2YKSvCFZGev2NXxJP1RTISPleh9Bqutx8ty9kKB9QGkD9L04Ek?= =?us-ascii?Q?xOLyEZ2IYdjihe77k4FFw0XHiFnKSeooOP70v48E30IzB6znqWaBkV23YBgB?= =?us-ascii?Q?fHLCjyApF+I5cnysqFrCqNFpvjaljWc4qECqTeMRq4hdfJbTtPpf5s2wSYim?= =?us-ascii?Q?ePJ9g+ua/6UTfE9PCDTK6X+eW6HmurAgsgqh1jMF/uhPA1ElIYZAhoJwR1su?= =?us-ascii?Q?FRyZ6qlUwLZPYJXttc+eq/0XNXlXMwagq2cmOvGbRnivRQD9nPcpNPW1m4eQ?= =?us-ascii?Q?3l5KpQZvD6wINIswPlVpJ5tIwisO+COxrHezK8h3nF8UHNOBeUbSyA8sNg0o?= =?us-ascii?Q?seFlAg1vrKlzn8yqw5Yjg4U+YSyLH9ud9qRAwKBpyhXBpwqJydsukCM4z0e8?= =?us-ascii?Q?jTzaqIfBA40v2cRaLC48rCZ1B/x3HAWQqOLFe/NDFGma31Qx3uXma84Af5a2?= =?us-ascii?Q?CgzOgCwoijXxAlcNH8TMjfPlkutTB5I0WtHHTOrcqlWG0fP9jzQJRUu8G9jA?= =?us-ascii?Q?FLg+NriJQXTQTOcuN/V40fA7QQARDFpERT4agstgxssKukCXwBIv2DSNqGb1?= =?us-ascii?Q?zefst7ZeYa1B/0PKLIa9VCtEHoa93mNoedz1OgVzPdaNe/ZA4PaafTwo9Mbt?= =?us-ascii?Q?UZw6PCto9XFSfP4nLOoPvuMSmOg7rxpxw/enyBowDbjgK6irbJ/Dam8vfnb3?= =?us-ascii?Q?Bb1woNYr5Fis9IE00rIWO+wEvp1MPrAiHw4NpQuDlejOpNgzwtrNLD8rshrJ?= =?us-ascii?Q?wHMMDnRF6X8YGVudqJ6uJKIxZUD2zCcKkKBE5Zj9GvrHWpdRD2n/DbagXbui?= =?us-ascii?Q?MfMeMxw3xdu9iO4rk3vZ9xHYFz5lS+lDyUgVSoklNRMOLXGrrcQWjxtLovYA?= =?us-ascii?Q?CiO7/ET2bw4GuvBtiBXIAcPgevkjpiAsgUyVHX0TI8GoIjCsRrDzEVl+mM0D?= =?us-ascii?Q?ql9Ccw=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: SN6PR11MB3103.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: ef0513b8-b9e8-42e5-c77e-08d9bf1bf3e0 X-MS-Exchange-CrossTenant-originalarrivaltime: 14 Dec 2021 16:08:22.4433 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: vgyb/JlWGLVj+t2WSXEuRJygtenvADs/aPg+A7wu6ZwfKcAjI16fTSFWfi/FEdwgZK1b1j2N+2TFvppKCytFgwwT5zOZ2/4IUCKR5jGzF80= X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR11MB3294 X-OriginatorOrg: intel.com 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 > -----Original Message----- > From: Shetty, Rashmi > Sent: Tuesday, December 7, 2021 5:02 PM > To: dev@dpdk.org > Cc: jerinj@marvell.com; Van Haaren, Harry ; > Pathak, Pravin ; Chen, Mike Ximing > ; McDaniel, Timothy > ; Shetty, Rashmi > Subject: [PATCH v2] doc/dlb2: update dlb2 documentation >=20 > 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. >=20 > Signed-off-by: Rashmi Shetty > --- > doc/guides/eventdevs/dlb2.rst | 19 ++++++------------- > 1 file changed, 6 insertions(+), 13 deletions(-) >=20 > diff --git a/doc/guides/eventdevs/dlb2.rst b/doc/guides/eventdevs/dlb2.rs= t > 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 f= or > 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: >=20 > .. code-block:: console > @@ -239,8 +239,8 @@ queue A. > Due to this, workers should stop retrying after a time, release the even= ts 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 e= nqueue > -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). >=20 > Priority > ~~~~~~~~ > @@ -309,18 +309,11 @@ scheduled. The likelihood of this case depends on t= he > eventdev configuration, > traffic behavior, event processing latency, potential for a worker to be > interrupted or otherwise delayed, etc. >=20 > -By default, the PMD allocates 16 buffer entries for each load-balanced q= ueue, > -which provides an even division across all 128 queues but potentially wa= stes > +By default, the PMD allocates 64 buffer entries for each load-balanced q= ueue, > +which provides an even division across all 32 queues but potentially was= tes > buffer space (e.g. if not all queues are used, or aren't used for atomic > scheduling). >=20 > -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=3D64 > - > QID Depth Threshold > ~~~~~~~~~~~~~~~~~~~ >=20 > @@ -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. >=20 > 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. >=20 > .. code-block:: console > -- > 2.25.1 Reviewed-by: Timothy McDaniel