From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id F3A07A04B1; Mon, 23 Nov 2020 08:17:25 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 4914337AF; Mon, 23 Nov 2020 08:17:24 +0100 (CET) Received: from hqnvemgate25.nvidia.com (hqnvemgate25.nvidia.com [216.228.121.64]) by dpdk.org (Postfix) with ESMTP id 1A22623D for ; Mon, 23 Nov 2020 08:17:21 +0100 (CET) Received: from hqmail.nvidia.com (Not Verified[216.228.121.13]) by hqnvemgate25.nvidia.com (using TLS: TLSv1.2, AES256-SHA) id ; Sun, 22 Nov 2020 23:17:21 -0800 Received: from HQMAIL111.nvidia.com (172.20.187.18) by HQMAIL111.nvidia.com (172.20.187.18) with Microsoft SMTP Server (TLS) id 15.0.1473.3; Mon, 23 Nov 2020 07:17:20 +0000 Received: from NAM10-BN7-obe.outbound.protection.outlook.com (104.47.70.107) by HQMAIL111.nvidia.com (172.20.187.18) with Microsoft SMTP Server (TLS) id 15.0.1473.3 via Frontend Transport; Mon, 23 Nov 2020 07:17:19 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=W1kXgZQhDP+Zi1tGuQW/MVur4ljwz0gI0zmu+XW5SYV0GF7QNy7x3c78wcQHpmNTXXCHVswYAJPkNGZQkzXc1F0Oz90bSFjcvW0/8F0/7h+zcqZld4IITMNlUeEKnsD2v4tqVpLQCuDkDPF/NTZrVmex8ZtRYpTUeZxyciGED2iT35kz6jqlXbSmhVERA9LqLTuuFgTuGddpwcxSJxIhQnhNU7yqRZ2REoq8mQ+xg3HeVHEwEtCNn8fgeEcJlnjubvqla2k7euAbe6e8+9HXBKoiP5LjITrXnhmtxGriLOWcp9GglFKA5nH50SURKSE2M/Q7/emmnBleaqUn5WFv4A== 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-SenderADCheck; bh=22Ejl07euDMx2XKvrz2hbKN1NMLAsvdyNt3Vm6kLlK8=; b=kTMSEGLEyxyS5kmazaRkaPjSZU/nySNqb43wZLJK3OnM8VYE5sN3J/DT78MGjbXfJc1B2XeWcetMnT/Rk7yt+KnbFiABPwAxq40srnjDHQbA+WV+MEvhmHyDW+HCt0GqBav2cbOh34xHKSt/yhdKcZXI+dk1QAOj5wMEnFnmsICvfDOlDNCWzhcCp8rOLAwYFvw/1CRXdkj+hGcN2AqmN9mcEDJA0klhrWGEQtWs5vHRSqKEY4mtrrRgseWsRZYN+9e8WcLjcqSgv5ok+BGzCnywK7ok+IF67GXTEFu1iHK71gRHR7RfnTOQNZ/busw6mKHpRf5DhBgeCuW2QI1cxA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none Received: from MWHPR12MB1501.namprd12.prod.outlook.com (2603:10b6:301:f::18) by MW2PR12MB2476.namprd12.prod.outlook.com (2603:10b6:907:c::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3564.28; Mon, 23 Nov 2020 07:17:18 +0000 Received: from MWHPR12MB1501.namprd12.prod.outlook.com ([fe80::ec4d:f17d:402c:78b4]) by MWHPR12MB1501.namprd12.prod.outlook.com ([fe80::ec4d:f17d:402c:78b4%6]) with mapi id 15.20.3589.030; Mon, 23 Nov 2020 07:17:17 +0000 From: Slava Ovsiienko To: Asaf Penso , "dev@dpdk.org" CC: NBU-Contact-Thomas Monjalon , Matan Azrad , Raslan Darawsheh Thread-Topic: [PATCH] doc: add information for Rx burst functions in mlx5 Thread-Index: AQHWwMwUnpGPk6U84k6uXsZVD0BZiqnVTl9w Date: Mon, 23 Nov 2020 07:17:17 +0000 Message-ID: References: <1606048553-16127-1-git-send-email-asafp@nvidia.com> In-Reply-To: <1606048553-16127-1-git-send-email-asafp@nvidia.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: nvidia.com; dkim=none (message not signed) header.d=none;nvidia.com; dmarc=none action=none header.from=nvidia.com; x-originating-ip: [95.164.10.10] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 60b2e3bd-7abd-482b-101a-08d88f7fcf9d x-ms-traffictypediagnostic: MW2PR12MB2476: x-ld-processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:9508; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: +Epl5fmLAvKaKK5UKq57iZR6UJPSpG2Ovd0O36KxvVzp0OVEd/nWA1DJet7tZ3IonQbr+AZ0Cl5sl9EnBms6mbNxarmqGjYR+KFKgKJi/ZMTuQ0i2uczj2fyc33Erfw7FqKPd4DzkmSaateOJPX1LtD1BfLHc+39bV1Anw8MBfJ8CLer/LBgzzn9bubQYQ3bt+ocsihGR2ln8Mq4udje0KzhiC/H9twddFtZe9ONVyKdF5oSPYMQW5yojbCzt170MrmrhocG3JIcS/dLHLnSIOr9g1P1LfbKEQx2GTEkQ3pN3PdPwAMffjLxo+ek/tcuHoNETdT3+svPod3upFgkCA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:MWHPR12MB1501.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(4636009)(366004)(346002)(39860400002)(376002)(396003)(136003)(7696005)(2906002)(186003)(26005)(83380400001)(53546011)(6506007)(8936002)(8676002)(5660300002)(64756008)(33656002)(478600001)(86362001)(9686003)(52536014)(110136005)(54906003)(71200400001)(66476007)(66946007)(4326008)(66446008)(76116006)(55016002)(316002)(66556008)(107886003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: clNfqaVDgz+8bjd4RSOWAVW0EKz/XSDVlmLmvMa6CJOmHxozWcIn7Z/GrLhXyYkfgoM243PBA0CeFe2rTALrTwdGIoMDmIgUqdwFPnF6fG/tbXtkmyhDL1/FgYqmvtWaHOIosSs22QTcN2RBhZjk7IAtADVXLijkLD9Pcm7GWq50JC42jSVKc4kbMN9JMXn1S0f741M15RCk6OlMZJefcszynnh9SnMLBRinmenucifZPZ4vQETin2eRFhQN0yTyOUXkNy/r4spFPUfv/aW5C/E6ax+sa/Tl9k2zLoIbuqC95pZNASSeVBFCauLSyDNXiBoH0lob6KuW0EnD/aJHrEN5s2pFhEvJYKImKfuL4VsJDjVhNH+X/wsdXRxlsvEyPkvie9tR8adwgpZlAYsMF+CI9hVXtLIyc7rwo+rGJJ+92l8sVWng0KTDOxW37w6LVfWoE7mE1mwqslR1qLpZ40fnz1+2QKKGtCpqJgLs+MeGkYGyKyhWFvM0DwtWTVllo8W0sVz6bGQUMF32IUCngFixALDOk6B2UVtscTbK3xXXmvRRNyvkb+wBq+Rvj9flZmn2TXNEo/3sWHl2EVOx++ozQk/0fRdZvbZ8xMqPttg9Yg3ymmjRuReLemMrYi99SA0AII+YAcQ1TdOBzWzwMw== 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: MWHPR12MB1501.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 60b2e3bd-7abd-482b-101a-08d88f7fcf9d X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Nov 2020 07:17:17.8371 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: Kpggtq5cW2BU9vC24T7ZQWB4T9wVMSNlGeAKHGFIcLLEZrxJDjoiioOcB8ocUnzRsh8GY1ssyqVW0C5igi9qBw== X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW2PR12MB2476 X-OriginatorOrg: Nvidia.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nvidia.com; s=n1; t=1606115841; bh=22Ejl07euDMx2XKvrz2hbKN1NMLAsvdyNt3Vm6kLlK8=; h=ARC-Seal:ARC-Message-Signature:ARC-Authentication-Results:From:To: CC:Subject:Thread-Topic:Thread-Index:Date:Message-ID:References: In-Reply-To:Accept-Language:Content-Language:X-MS-Has-Attach: X-MS-TNEF-Correlator:authentication-results:x-originating-ip: x-ms-publictraffictype:x-ms-office365-filtering-correlation-id: x-ms-traffictypediagnostic:x-ld-processed: x-ms-exchange-transport-forked:x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers:x-ms-exchange-senderadcheck: x-microsoft-antispam:x-microsoft-antispam-message-info: x-forefront-antispam-report:x-ms-exchange-antispam-messagedata: Content-Type:Content-Transfer-Encoding:MIME-Version: X-MS-Exchange-CrossTenant-AuthAs: X-MS-Exchange-CrossTenant-AuthSource: X-MS-Exchange-CrossTenant-Network-Message-Id: X-MS-Exchange-CrossTenant-originalarrivaltime: X-MS-Exchange-CrossTenant-fromentityheader: X-MS-Exchange-CrossTenant-id:X-MS-Exchange-CrossTenant-mailboxtype: X-MS-Exchange-CrossTenant-userprincipalname: X-MS-Exchange-Transport-CrossTenantHeadersStamped:X-OriginatorOrg; b=JNG7UlGqtc3CzHVbUZCYmRhBQSgIaqrrmHYB4U3QwARHS+Ns4NOnN9mGJX9UJM5au D2Vl2XdJspeAniooR/Tmy4TCC2yaXJM2wF2YYGw32aDQPZSXeMZntL79Xux5SQyN/l ZmCGEv4MFhogmuus+OmT/4a782oAAvTVPz7ft+geLFv753iAMKTcdX/BV4Nugd0b11 Mnp1K/HG5i/+CCj2Oq5YLHEZBH5F3zmfy81pM3vucx/mQ8saWjPRrfZrwLJRugduTH 8m0LU8WuiNjXYPM3QYAc47lxpBKb67q0fnsq7YOqj8nIqAq+DtFatQO75gbhuAwOj/ t/esEefuQiRrA== Subject: Re: [dpdk-dev] [PATCH] doc: add information for Rx burst functions in mlx5 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" Hi, Asaf There is one more devargs to manage MPRQ enable: "rxqs_min_mprq". This parameters defines the number of Rx queues limit to enable MPRQ. If there is not enough Rx queues (below the limit) then MPRQ is disabled. By default, "rxqs_min_mprq" is 12. I suppose we should mention this in the list being added. With best regards, Slava > -----Original Message----- > From: Asaf Penso > Sent: Sunday, November 22, 2020 14:36 > To: dev@dpdk.org > Cc: NBU-Contact-Thomas Monjalon ; Slava Ovsiienko > ; Matan Azrad ; Raslan > Darawsheh > Subject: [PATCH] doc: add information for Rx burst functions in mlx5 >=20 > mlx5 pmd supports various rx_burst functions. > Each function is enabled differently and supports different features. >=20 > Add more comprehensive information about each function. >=20 > Signed-off-by: Asaf Penso > --- > doc/guides/nics/mlx5.rst | 55 > ++++++++++++++++++++++++++++++++++++++++++++++++ > 1 file changed, 55 insertions(+) >=20 > diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index > 205e5ba..8c1ce15 100644 > --- a/doc/guides/nics/mlx5.rst > +++ b/doc/guides/nics/mlx5.rst > @@ -1645,3 +1645,58 @@ all flows with assistance of external tools. > .. code-block:: console >=20 > mlx_steering_dump.py -f > + > +RX burst functions > +------------------ > + > +This section describes the different rx_burst functions and provides an > +elaborated information. > + > +#. Function name - rx_burst > + How to enable - rx_vec_en=3D0 > + Scatter support - Yes > + RX error recovery support - Yes > + CQE compression support - Yes > + Large MTU support - The maximal packet size should be set to = be the > + same as the MTU size. The mbuf size can b= e > + according to the application needs since = the > + pmd can perform the scatter. > + > +#. Function name - rx_burst_vec > + How to enable - rx_vec_en=3D1 (default value) > + Scatter support - No > + RX error recovery support - Supported only in case CQE compression is= off > + CQE compression support - Yes > + Large MTU support - No. Scatter is not supported, so it means > + that the mbuf must be with the same size = of > + the MTU. In this case, maximal packet siz= e =3D=3D > + mbuf size =3D=3D MTU size > + Fallback - In scatter or LRO fallback to rx_burst > + Notes - Improves CPU utilization for single-core = and > + improves performance > + > +#. Function name - rx_burst_mprq > + How to enable - mprq_en=3D1 > + Scatter support - No > + RX error recovery support - Yes > + CQE compression support - Yes > + Large MTU support - Yes. Needs to be turned on by specifying = the > + stride size > + Notes - Saving PCI bandwidth and getting higher > + performance, especially for small packets= . > + Used mainly for multi-core use cases. > + Uses externally attached buffers only. > + > +#. Function name - rx_burst_mprq_vec > + How to enable - rx_vec_en=3D1 (default mode) and mprq_en= =3D1 > + Scatter support - No > + RX error recovery support - Supported only in case CQE compression is= off > + CQE compression support - Yes > + Large MTU support - Yes. Needs to be turned on by specifying = the > + stride size > + Fallback - In scatter or LRO fallback to rx_burst_mp= rq > + Notes - Improves CPU utilization of regular > + rx_burst_mprq for multi-core and improves > + performance. > + Used mainly for multi-core use cases. > + Uses externally attached buffers only. > \ No newline at end of file > -- > 1.8.3.1