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 136A8A04B8; Tue, 5 May 2020 10:55:44 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id DC3DD1D58F; Tue, 5 May 2020 10:55:43 +0200 (CEST) Received: from EUR03-VE1-obe.outbound.protection.outlook.com (mail-eopbgr50072.outbound.protection.outlook.com [40.107.5.72]) by dpdk.org (Postfix) with ESMTP id 9CA721D580 for ; Tue, 5 May 2020 10:55:41 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=iTdqcybRcdsXKJKwYApViJ3oeTrtYABvRHpDUKcnKP1BM0dswwJISpFY1puWUU4OY5l8UJhFhdlGaxiX8vsp4rUsRB9R9PJPgOqueOdaV2yzLUPtcgg7ZcdMIFBVHgN/i/mW7SDKsMWKMDFgHege0YDzFTKEAe8IazKJnDCTlrhe3SvYtwYybcr+mtDMcs3qsTAZ58D1OMZYefOReA7a0krY4G/iT4fGtvMyq6yniGmGmJtG9UdOFlajF9bCJ09oUhIEf1uuQHcPRJrqhSXNe0nSY0Lv9fII42J4I/rEil0BND3yXXp47y5N+lwgnBQbTijgIif3gO+QnZ+Rkihl9w== 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=XW+1iU4hV8a6NTAnGFYJAcO6oE9ptsxyIzaPWnz6xxo=; b=VscfB+kZm5xk9RGBgBukh6GMxmkHSt5Gac5ogBOqwurQH3qrDaiOGH7tD5w97qgqbuS5MQcqW4OuW9YwQQSfKYbZy9tef+txXvaHT+fGGLOm8zbpGhm4strxDM3c9eTxHeI6qndZrBgQiT6WuubCBkNGCmF/cBrjGkWkqIglB2WeL8YYdP4gVnxkw+1Z7ci4SAAyQauOXGGEPvtJiTaDLDNBBgNOuKiPPG8als4oJq2oxhOZbfHP9wsvasSgyUHv+wnk2TC/Wo8tj9q5nARHAdhtinKTyBh6N4vf3mauJk8H+OQwvgde627FihenXMg3wYgq5ljk2pE4o462FKX1eA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=mellanox.com; dmarc=pass action=none header.from=mellanox.com; dkim=pass header.d=mellanox.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=XW+1iU4hV8a6NTAnGFYJAcO6oE9ptsxyIzaPWnz6xxo=; b=kWyiaamTSdZTaerzlyPJXGT2oOKbtbtjr0+kIj/8+BxjiymZfgYDRZORKyUPLuPCcsV/kjMBCF2V6PAsJqiy07UDKVIAEqY88djdPq56FdfIgU2RAE9a4G9cdHjpXTcQHdiz/P6YtUSiEG7vnybijCAEqE5/DGRaYLaZM2AuyRc= Received: from AM0PR05MB6707.eurprd05.prod.outlook.com (2603:10a6:20b:15b::17) by AM0PR05MB5284.eurprd05.prod.outlook.com (2603:10a6:208:eb::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2958.19; Tue, 5 May 2020 08:55:40 +0000 Received: from AM0PR05MB6707.eurprd05.prod.outlook.com ([fe80::508:747b:cc12:5f6e]) by AM0PR05MB6707.eurprd05.prod.outlook.com ([fe80::508:747b:cc12:5f6e%5]) with mapi id 15.20.2958.030; Tue, 5 May 2020 08:55:40 +0000 From: Raslan Darawsheh To: Bing Zhao , "john.mcnamara@intel.com" , "marko.kovacevic@intel.com" , Slava Ovsiienko , Ori Kam , Matan Azrad CC: Shahaf Shuler , "dev@dpdk.org" , Thomas Monjalon Thread-Topic: [PATCH v4] doc: update hairpin data buffer size config Thread-Index: AQHWGFPNezE7th4R0UaX7eP3KfDXqaiZRSSA Date: Tue, 5 May 2020 08:55:40 +0000 Message-ID: References: <1587454163-127981-1-git-send-email-bingz@mellanox.com> <1587525080-239250-1-git-send-email-bingz@mellanox.com> In-Reply-To: <1587525080-239250-1-git-send-email-bingz@mellanox.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: mellanox.com; dkim=none (message not signed) header.d=none;mellanox.com; dmarc=none action=none header.from=mellanox.com; x-originating-ip: [188.161.229.217] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: 34dd92ec-8d73-49a1-bb90-08d7f0d21657 x-ms-traffictypediagnostic: AM0PR05MB5284:|AM0PR05MB5284: x-ld-processed: a652971c-7d2e-4d9b-a6a4-d149256f461b,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:7691; x-forefront-prvs: 0394259C80 x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: Ldpl4JYc40C8kcap6hlG5X+xSNDU4FAz1uaJb8gLppmjHSoLQIqKALpxrqR19WxdeuvnnSRjBvx1uKSsUq1rzv3BQ6BSSkOr/LNtMyT5vBr20gVl36vrMc24SWBAVrTMpCOvgFF/GscO5rtd+cUh8tkf6IrHc0aii/Wumo8b+7G8M1bm5RhSXP9UIUiXL/MNpeqoTY2CzohMAm+x5klwgnguf23RhlwV6ffMyqox6w2tZf+rsaVTDtpw19OEaCg6oYd32tEGcNVS4vdp47NQqZ1wF02a30sKRVTKzB9w/K4nir7cdL/8kOyaNSG6IZ5h2dmJIFPB4Q5hWCCLsYQs6zA458f08jGsUmtvPrpDOiWLlWVlEjLDw33MHJnDH0iAfIKDudlGfMUNtKixh3Wj4wRSGEgebVm2GnDp1qCBollyCwREtJS1HRAIyGWVI7GsfMiePW8kKm4OCoY5u/CIPsX5Q91a8mIZepMBKEjD5GDaDJB3swGFEWMMhwZtuFz6giMI9eFaDRDv/yDnEQ30mg== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AM0PR05MB6707.eurprd05.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(366004)(39860400002)(396003)(346002)(376002)(136003)(33430700001)(2906002)(55016002)(9686003)(33656002)(316002)(33440700001)(86362001)(54906003)(76116006)(110136005)(71200400001)(8676002)(8936002)(186003)(26005)(478600001)(52536014)(66476007)(64756008)(66446008)(66556008)(66946007)(6506007)(6636002)(53546011)(4326008)(5660300002)(15650500001)(7696005); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: rFRKNR3qIRmau/bDcXqItUG3eVxIf3bcD7ROeyPKT5f3ncRWmzLCpMyhiYP9fod9Auq8bFT2hvKQZvqcjKdoNXR3I3s9Khy7kCUyIEmZ/hEWGsmVNcSuhe6XBeK9kw2DUj/8qbxaBtMGJYmttfsAl80fY12s/8WEORI0K2LJJb1rQWhVLSUSso3t3k5NqsMtRRqSr9scIDxnDhn97mbJT5gCcNw9b4IxfwwWPaO+wi1nCbR8kax8i8orAsBBGWfQL+6M5l23Xe75gxa1vlNamvskUyRfhUxANrcJseXK+tUiWJjVpPpJjwb+xDQyYJdTVVfs8r0/Cfgk1zEMx+AcUGtOopr/4EqLZtMRC4UxQWBYcXK3h/l8vTSQwRGCx4EV2UaE5ALiyDu8d3aMzqV68sej9II0tdBxx+oBpLRfEWAOUskKHhjJbxAMD7BeJAeFhr7MSwPbv0vQJwfJKCFwuqwRU0cuLoMTyf+Y0wsZKJ5ZLF7slocqIFckIHB+0c9ZwE36+Lg5JeDz9ij0MZbxV2UNTBVH5G71IofpN3AVu+kEE/ZL3nvWjtaKUrN8Scvv3dxftDO2D4WaYVpjZvMVLKWwRkwiXveAYIZVF34dQhyoVjKjtPwvOoCvqM+kdbFe5xW7Gk13FiCXMtZDYu4c3gx5FZuo0gOYOqeYUmVu+sT7EglpkbB8HZmH3QvNK+Rb10MZ2zLVemKeKljmxgENKrlTRLrYL2tfwFiie7uWCSzqzi//WBKMN30KdWvrjmw4FWqi3RT3gEH4JtqB/01F9bNDKDj5hqKU+zMZwrMLyDwwy1379PBG7/tsUptiid8z Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-Network-Message-Id: 34dd92ec-8d73-49a1-bb90-08d7f0d21657 X-MS-Exchange-CrossTenant-originalarrivaltime: 05 May 2020 08:55:40.3218 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: ysf5i/5qpWpxjyYUvyx8EPaIPnk4geEd+R4qf9B8fU4UoMapxkvz3xi7Iaohbb7Vfek/PzC5ocdykEbeEJBcxA== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM0PR05MB5284 Subject: Re: [dpdk-dev] [PATCH v4] doc: update hairpin data buffer size config 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, > -----Original Message----- > From: Bing Zhao > Sent: Wednesday, April 22, 2020 6:11 AM > To: john.mcnamara@intel.com; marko.kovacevic@intel.com; Slava Ovsiienko > ; Ori Kam ; Matan > Azrad > Cc: Shahaf Shuler ; Raslan Darawsheh > ; dev@dpdk.org; Thomas Monjalon > > Subject: [PATCH v4] doc: update hairpin data buffer size config >=20 > This patch updates the MLX5 PMD and release notes documentations. > Adding the guideline for hairpin data buffer size configuration. >=20 > Signed-off-by: Bing Zhao > Acked-by: Ori Kam > --- > v2: update the range description of hairpin data buffer size > v3: correct the minimum value of the range > v4: correct some typos and grammatical errors > --- > doc/guides/nics/mlx5.rst | 16 ++++++++++++++++ > doc/guides/rel_notes/release_20_05.rst | 1 + > 2 files changed, 17 insertions(+) >=20 > diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst > index 759d0ac..51b5d47 100644 > --- a/doc/guides/nics/mlx5.rst > +++ b/doc/guides/nics/mlx5.rst > @@ -99,6 +99,7 @@ Features > - Support for multiple rte_flow groups. > - Per packet no-inline hint flag to disable packet data copying into Tx > descriptors. > - Hardware LRO. > +- Hairpin. >=20 > Limitations > ----------- > @@ -786,6 +787,21 @@ Run-time configuration > If this parameter is not specified, by default PMD will set > the smallest value supported by HW. >=20 > +- ``hp_buf_log_sz`` parameter [int] > + > + The total data buffer size of a hairpin queue (logarithmic form), in b= ytes. > + PMD will set the data buffer size to 2 ** ``hp_buf_log_sz``, both for = RX & > TX. > + The capacity of the value is specified by the firmware and the initial= ization > + will get a failure if it is out of scope. > + The range of the value is from 11 to 19 right now, and the supported f= rame > + size of a single packet for hairpin is from 512B to 128KB. It might ch= ange if > + different firmware release is being used. By using a small value, it c= ould > + reduce memory consumption but not work with a large frame. If the valu= e > is > + too large, the memory consumption will be high and some potential > performance > + degradation will be introduced. > + By default, the PMD will set this value to 16, which means that 9KB ju= mbo > + frames will be supported. > + > .. _mlx5_firmware_config: >=20 > Firmware configuration > diff --git a/doc/guides/rel_notes/release_20_05.rst > b/doc/guides/rel_notes/release_20_05.rst > index 1e5304d..d43aa2e 100644 > --- a/doc/guides/rel_notes/release_20_05.rst > +++ b/doc/guides/rel_notes/release_20_05.rst > @@ -78,6 +78,7 @@ New Features >=20 > * Added support for matching on IPv4 Time To Live and IPv6 Hop Limit. > * Added support for creating Relaxed Ordering Memory Regions. > + * Added support for configuring Hairpin queue data buffer size. > * Added support for jumbo frame size (9K MTU) in Multi-Packet RQ mode. > * Optimized the memory consumption of flow. >=20 > -- > 1.8.3.1 Patch rebased and applied to next-net-mlx, Kindest regards, Raslan Darawsheh