From patchwork Thu Mar 10 05:06:36 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Alexander Kozyrev X-Patchwork-Id: 108628 X-Patchwork-Delegate: rasland@nvidia.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 9B5F6A0093; Thu, 10 Mar 2022 06:07:01 +0100 (CET) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 6E9C7410FC; Thu, 10 Mar 2022 06:07:01 +0100 (CET) Received: from NAM10-BN7-obe.outbound.protection.outlook.com (mail-bn7nam10on2046.outbound.protection.outlook.com [40.107.92.46]) by mails.dpdk.org (Postfix) with ESMTP id BA720410DD for ; Thu, 10 Mar 2022 06:06:59 +0100 (CET) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=VhvizBaLjqxfnwT2TYR4rj4O17SYKBnPOcWj9IaFoGC2+IZe24kF8E+iwoWDeir311pDA4yLF4HNdMDRJhuI1kSWijLiZAPRGbDb8N24AOVzNunsUVZ1PaMYUvKTo4jsynEuwQ0chSxio4xwNKE0P4/zxoSrNuVZnSBJvXYnqaRzTqzHZ7Kz1LEN1HRCA5cddqP/CuCA5wpSCWZVxS1moJCLovRM+gZOzg0UvcTUTahjIQeBqtOLp95nk3SIC5jgfE2qS6byzyfhVYR6oRDoIqeTGW8ZWLP0r8OgFXkzlTqASc64iJPG4AB+KmaniNY0rB+PA9o1jUvAhBWWVhLRtg== 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=XorA9wQjPLp7P1bYoG1X6bsCd92M7liqooEokv+2leU=; b=EFkw5PUV4j0Ygu6DSg4p3G9nlIZ+NLR60hoLkNJ+0J4Xnhq1Sb/mIq/pYznT7dPoMgugGzA7SgVzW6ay2HClmQ+OB/z+WcOya4kDEHskixMbrDXCbT8tYUPxvE6qdccG3lvZyqshVUQ/T/MkMg7oQaVJ7fxhKa9vX53nZlkn9UFpOTVpLAOafmVhZ/gyGEcU+Pi9uHO5uxd7in5ChUyB5gzhZrkjadTqSdUSqqg3sIJu1+mkqDWXEeVGeG62UOekATQxEARgxsE1iNs5+NvjG2UpPhihK2EGH4bqlFm+f/RR75we+v1MNqw9BomqoLOzLwBKolDMnF6dgRnvZPoWtg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 12.22.5.236) smtp.rcpttodomain=dpdk.org smtp.mailfrom=nvidia.com; dmarc=pass (p=reject sp=reject pct=100) action=none header.from=nvidia.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=XorA9wQjPLp7P1bYoG1X6bsCd92M7liqooEokv+2leU=; b=OY1xgTGVItiSMEgxfs9XElR10Ls8xnvH4N37kTNlQhEPoxn4PUAO2bPHjtRkjleggbSHiWSU2ieMvC2adOzVDKy5wG7e+hAX8eJKAZdYV9SUVHpSTbcNQ/3gGOmV7OHeZHiLTTVl5u0rNdT0RGnhTyrCBRXTrmutc00yiiriHCucV96WEG+LI+tzb0MKh71S2tZJtUSp99/joLxZfONhIa0zK4jTCuK+OXbdLi7oVvnK5kj3q9601nspQQJqpCk9IKB/IkfdLlT2refb5OUMFJcw3KS2JTCJlNsdBFQRMj7gCO6aXFueWrmGmGyIP6r4X4SndWYnX3AcX0A2XaAtMA== Received: from BN9PR03CA0437.namprd03.prod.outlook.com (2603:10b6:408:113::22) by SA0PR12MB4414.namprd12.prod.outlook.com (2603:10b6:806:9a::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5038.14; Thu, 10 Mar 2022 05:06:58 +0000 Received: from BN8NAM11FT030.eop-nam11.prod.protection.outlook.com (2603:10b6:408:113:cafe::e2) by BN9PR03CA0437.outlook.office365.com (2603:10b6:408:113::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5061.20 via Frontend Transport; Thu, 10 Mar 2022 05:06:57 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 12.22.5.236) smtp.mailfrom=nvidia.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=nvidia.com; Received-SPF: Pass (protection.outlook.com: domain of nvidia.com designates 12.22.5.236 as permitted sender) receiver=protection.outlook.com; client-ip=12.22.5.236; helo=mail.nvidia.com; Received: from mail.nvidia.com (12.22.5.236) by BN8NAM11FT030.mail.protection.outlook.com (10.13.177.146) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384) id 15.20.5038.14 via Frontend Transport; Thu, 10 Mar 2022 05:06:57 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by DRHQMAIL109.nvidia.com (10.27.9.19) with Microsoft SMTP Server (TLS) id 15.0.1497.18; Thu, 10 Mar 2022 05:06:56 +0000 Received: from pegasus01.mtr.labs.mlnx (10.126.231.35) by rnnvmail201.nvidia.com (10.129.68.8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.9; Wed, 9 Mar 2022 21:06:54 -0800 From: Alexander Kozyrev To: CC: , , Subject: [PATCH] doc: mention MPRQ incompatibility with external buffers Date: Thu, 10 Mar 2022 07:06:36 +0200 Message-ID: <20220310050636.3756550-1-akozyrev@nvidia.com> X-Mailer: git-send-email 2.18.2 MIME-Version: 1.0 X-Originating-IP: [10.126.231.35] X-ClientProxiedBy: rnnvmail202.nvidia.com (10.129.68.7) To rnnvmail201.nvidia.com (10.129.68.8) X-EOPAttributedMessage: 0 X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 73e0b98b-f1c7-43ac-ff4a-08da0253cd53 X-MS-TrafficTypeDiagnostic: SA0PR12MB4414:EE_ X-Microsoft-Antispam-PRVS: X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: FZPXDjJ5IERrZSjOrObMzqGtibhj8CdQAJtwPMJhL3z/26Yfjnky0bmgaeSmMUSwkGGXuBvcurkzaMiK3QvoxOoJfcKYRP+62DBJrCcAvr7TWKvOMms3ldM0aDxKxzPY63JdnBnvXX9deVOHSyqTyuuoOnZ+EELxjPwmrbnw0NJOuX0fL0KJ4YXLqH2jv2aTXr0DIgqpvvDvTzj02mQ7XkmXaXMOc9lSXor0zWyvyhg0bSNOB59x+lj2goMLNG2P2brAuFnGDPopGqCqK8EBZGAc1KL6rpod5Gp7xOXake9GeIyVcV75hc4uGnNrMQ6lTiZXpH2fdkoQq9jWDnbf9NnqE8nwyvMHDgflKEEyAX9822OCyknwwWebFT+7P3ZCdb5eyCUt0G0e87c4rXbvRpwQC3kYJGwCIEHSw4zy3pz8HMyCA88NMWYdhspT6S621it0fYnU6lfecsFPiZ/PaBG4o71nEX/TBW0LwXpM1YsRr8BnZ1nwCjDwll5ExerIhW92432Iqs4+7ZFMAlgxseXboWQuxUd13LXaXj78uRbjX7DOBl+rybrnip/CxCEAhsbvO479sUdMAj3q1BOwezdAJJA+HEu0DwHMkyyGLQoodEfD/UW7EfKSFf7mcpo2vnxorKUoqQXb3M9H0j5h+oQPp3RGz95wEOXqfAW0EK7m3z2osc23qSATAYfIlLm0Q644xNSvQeE1C0XR/Nzceg== X-Forefront-Antispam-Report: CIP:12.22.5.236; CTRY:US; LANG:en; SCL:1; SRV:; IPV:CAL; SFV:NSPM; H:mail.nvidia.com; PTR:InfoNoRecords; CAT:NONE; SFS:(13230001)(4636009)(36840700001)(46966006)(40470700004)(6916009)(54906003)(336012)(426003)(508600001)(2906002)(2616005)(26005)(186003)(40460700003)(16526019)(1076003)(107886003)(5660300002)(86362001)(83380400001)(316002)(47076005)(36756003)(81166007)(356005)(8676002)(4326008)(70206006)(70586007)(8936002)(36860700001)(6666004)(82310400004)(36900700001); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Mar 2022 05:06:57.4846 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 73e0b98b-f1c7-43ac-ff4a-08da0253cd53 X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[12.22.5.236]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: BN8NAM11FT030.eop-nam11.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: SA0PR12MB4414 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 Multi-Packet Rx queue uses PMD-managed buffers to store packets. These buffers are externally attached to user mbufs. This conflicts with the feature that allows using user-managed externally attached buffers in an application. Add the corresponding limitation to MLX5 documentation that MPRQ and external data buffers cannot be used together. Signed-off-by: Alexander Kozyrev --- doc/guides/nics/mlx5.rst | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index a734d10d3f..9c633f1c07 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -260,7 +260,9 @@ Limitations ol_flags. As the mempool for the external buffer is managed by PMD, all the Rx mbufs must be freed before the device is closed. Otherwise, the mempool of the external buffers will be freed by PMD and the application which still - holds the external buffers may be corrupted. + holds the external buffers may be corrupted. User-managed mempools with + external pinned data buffers cannot be used in conjunction with MPRQ + since packets may be already attached to PMD-managed external buffers. - If Multi-Packet Rx queue is configured (``mprq_en``) and Rx CQE compression is enabled (``rxq_cqe_comp_en``) at the same time, RSS hash result is not fully