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 9BC784301F for ; Thu, 10 Aug 2023 02:12:27 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 94A9440DD8; Thu, 10 Aug 2023 02:12:27 +0200 (CEST) Received: from NAM04-BN8-obe.outbound.protection.outlook.com (mail-bn8nam04on2068.outbound.protection.outlook.com [40.107.100.68]) by mails.dpdk.org (Postfix) with ESMTP id 0F171406B6 for ; Thu, 10 Aug 2023 02:12:26 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=Qy/S1iFsWXFfeUMeOZsruUpFnH5TLpyDoPl7RJq5+YBc23YQxeM/BOY24Hg13F5vIhI7AFSlWy/dNKfr80X4XOhtOioS3qOcBgZ1qMNago/quZ3rMCBmd5R0A4LQ0oP3teCrQOa3yiD0GJsX6M3blPV6WY/gAQtyYt3D1Nq7mV78gV1ATBKU3kF2OQ2ELeXX/+WCMBq5cuUoAA/hJkDrY5wpOfDqCs8mKANsBecV2C4WwVckcQ0MAyHA3hGhSvZ8xShRE5groGoaMGd9umrWvrre2/XKHQdaA1Y1Jjqbqnf+Y1MbHZAs9D859JCO15gBUETg0+NjaECWUQP3+qyxdQ== 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=2oTF/ejOok9V0fidMEGRqy2myICRBxVjK/30IyaY/ow=; b=IyqJz3NG5Q8mBTLU8YiVJqiyq+L4d8HjONK1FXkljVMEplfxQSWVRqnAgweKWCSvCV7xPgsmXi4GUoQKipiB3kzbGvISvnzBvX1AW8sG27+ko7USXBdCpKu/DyjpbEnJ0UnKKST8AEdA/y+OMJZNa1uKa/2+XLf5jN4deNUPFCxY799RZHUXcAfuyRBCPEH7b2qaWlsls3VqwIMR49gqZLqfcBlHjPO5EHTP/rmG75qLkWRxT/BtUn6+OueBzxP7OY9689PkrDCyn952ZvSWw2ZDQ/Fw+7+cXmHDonmTPlSnZvuKVst2F4CH8AmtD3fg3o7Nl8WB0qPGdsFX4zwtFA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 216.228.117.161) 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=2oTF/ejOok9V0fidMEGRqy2myICRBxVjK/30IyaY/ow=; b=O1XJ5El6W0w32LcOFeaKQ7LFEtAk2YkvGYYsaIglWdfIyL6E+LhZsXdGLcObXllWnLgnhCyumo5WABDZyl4mDbUvxi4oDhgjGP2eNnHQX8Q+fcIWCGz0MYyRBlttPcaAcCM8d9vELYOc+HjWbYockM5dHXh9UYzkHtun8vNTw/iAbac/MC3liyKTTJ5itiMzy/aTIrO8RjBOvcsPAw19cWu1gCQ7d9AgVUqBoLty9yEXj08PWnvyU3AL+Gh5czWk2sH4deQj6SFufTw77NIOGne5dqoszkGedDl1mlkgpWYO5BawnbQ4jMgPsd6YjEu0kkoq3RrhiGkAc89GqS3tfQ== Received: from SJ0PR13CA0175.namprd13.prod.outlook.com (2603:10b6:a03:2c7::30) by MW4PR12MB6754.namprd12.prod.outlook.com (2603:10b6:303:1eb::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.30; Thu, 10 Aug 2023 00:12:24 +0000 Received: from CO1PEPF000044F5.namprd05.prod.outlook.com (2603:10b6:a03:2c7:cafe::3e) by SJ0PR13CA0175.outlook.office365.com (2603:10b6:a03:2c7::30) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6678.18 via Frontend Transport; Thu, 10 Aug 2023 00:12:24 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 216.228.117.161) 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 216.228.117.161 as permitted sender) receiver=protection.outlook.com; client-ip=216.228.117.161; helo=mail.nvidia.com; pr=C Received: from mail.nvidia.com (216.228.117.161) by CO1PEPF000044F5.mail.protection.outlook.com (10.167.241.75) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.19 via Frontend Transport; Thu, 10 Aug 2023 00:12:23 +0000 Received: from rnnvmail201.nvidia.com (10.129.68.8) by mail.nvidia.com (10.129.200.67) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.2.986.5; Wed, 9 Aug 2023 17:12:13 -0700 Received: from nvidia.com (10.126.231.37) 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.37; Wed, 9 Aug 2023 17:12:11 -0700 From: Xueming Li To: Ali Alnubani CC: dpdk stable Subject: patch 'doc: improve wording of cuda guide' has been queued to stable release 22.11.3 Date: Thu, 10 Aug 2023 08:10:36 +0800 Message-ID: <20230810001045.2662-16-xuemingl@nvidia.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230810001045.2662-1-xuemingl@nvidia.com> References: <20230625063544.11183-1-xuemingl@nvidia.com> <20230810001045.2662-1-xuemingl@nvidia.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-Originating-IP: [10.126.231.37] 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-TrafficTypeDiagnostic: CO1PEPF000044F5:EE_|MW4PR12MB6754:EE_ X-MS-Office365-Filtering-Correlation-Id: af22478f-72bd-43d9-45c3-08db993678fe X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: GmrSr9vQprUfPA7Fcoq8ETG2rXEdELVvPAXoCq0lrbBB2EiGtSyAT35SMx2qdHp9QGJDP9Vrigl0RJl1VKvDZk2PIIfDuN7ydW8PoEN0rPiRL5bnug+Y14orAUz6+wPSm0oInPwEXfs6QvPszhnESYMWjlsDqtW+QEXU3NEz7x9BxyIs6S+/gpD5glen4MzM8JMJ4jVH3BA/us8gS0B8PZoWuaq6aRKbU4YygiDAcdSk4Fndd2IATdnDMq6vQG8qVv0gUJMmsC68G7M16x0mQDL2qAyLLVY088JivXCwGeq3jUKWl393fyutdLLThc8f2B2N3mtx3Js/7IZh2KNh3egHnCLCjsYz522YMhcIu3ECgQYKqcuz2fPwQJ62CSEU6bflLXD2hIazg4WT+Q+BUbryteVzaKNuQS/FO+Htusp6u2eOvKluqyDRcqEgU7HD4/k/aQiUslmi1MB2mOV32VUROeVbb4tv61S54zVRWSrQH/4/w7lAfUe4SDiurZSHjJk7zUY5XRRrNl/2Xbdg7W1qQZmsyHZN/Q6HXFQhoiLDEJ6FgWCBGsoeBDPjDOBkL4PHy0cwhagFTdYp6dEPOSkudtKsK1EcdeDJco2cDSsJP6XbwByabs9KdoY+NZE1A8G8QvNBHpGvR+ZMp58XCBs0e9Bth8ZRfLARsYwP2WxPEnVxygKWsgzkAJ/kIlOFy0ak8yWOLmJtjWUk1nH/pPBVtsXU6cCVEZAEZ9tIJY0DXeDrNF5Y/qVGZY4kmgXMOdtDUQFTP24g4J/fNA6VpQ== X-Forefront-Antispam-Report: CIP:216.228.117.161; CTRY:US; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:mail.nvidia.com; PTR:dc6edge2.nvidia.com; CAT:NONE; SFS:(13230028)(4636009)(136003)(346002)(376002)(396003)(39860400002)(451199021)(82310400008)(186006)(1800799006)(36840700001)(40470700004)(46966006)(7636003)(82740400003)(336012)(16526019)(6286002)(83380400001)(37006003)(55016003)(8936002)(8676002)(6862004)(86362001)(6666004)(356005)(2906002)(53546011)(1076003)(7696005)(26005)(966005)(40460700003)(478600001)(2616005)(70206006)(316002)(40480700001)(4326008)(6636002)(70586007)(5660300002)(47076005)(41300700001)(426003)(36860700001)(36756003); DIR:OUT; SFP:1101; X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 10 Aug 2023 00:12:23.9333 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: af22478f-72bd-43d9-45c3-08db993678fe X-MS-Exchange-CrossTenant-Id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=43083d15-7273-40c1-b7db-39efd9ccc17a; Ip=[216.228.117.161]; Helo=[mail.nvidia.com] X-MS-Exchange-CrossTenant-AuthSource: CO1PEPF000044F5.namprd05.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: MW4PR12MB6754 X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org Hi, FYI, your patch has been queued to stable release 22.11.3 Note it hasn't been pushed to http://dpdk.org/browse/dpdk-stable yet. It will be pushed if I get no objections before 08/11/23. So please shout if anyone has objections. Also note that after the patch there's a diff of the upstream commit vs the patch applied to the branch. This will indicate if there was any rebasing needed to apply to the stable branch. If there were code changes for rebasing (ie: not only metadata diffs), please double check that the rebase was correctly done. Queued patches are on a temporary branch at: https://git.dpdk.org/dpdk-stable/log/?h=22.11-staging This queued commit can be viewed at: https://git.dpdk.org/dpdk-stable/commit/?h=22.11-staging&id=fdb81fcc2ceb4cfd4271cd650c2cd3748e370cf7 Thanks. Xueming Li --- >From fdb81fcc2ceb4cfd4271cd650c2cd3748e370cf7 Mon Sep 17 00:00:00 2001 From: Ali Alnubani Date: Mon, 3 Jul 2023 11:14:23 +0300 Subject: [PATCH] doc: improve wording of cuda guide Cc: Xueming Li [ upstream commit 135551ae0bae5a9e575b0a531490c24ef730dac0 ] Adds missing punctuation, and improves wording. Additionally, one of the example commands for adding CUDA headers to CFLAGS is removed as it's redundant. Fixes: 24c77594e08f ("gpu/cuda: map GPU memory with GDRCopy") Fixes: 1306a73b1958 ("gpu/cuda: introduce CUDA driver") Signed-off-by: Ali Alnubani --- doc/guides/gpus/cuda.rst | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/doc/guides/gpus/cuda.rst b/doc/guides/gpus/cuda.rst index 114e3bc8cb..6520c17c3e 100644 --- a/doc/guides/gpus/cuda.rst +++ b/doc/guides/gpus/cuda.rst @@ -12,20 +12,19 @@ Information and documentation about these devices can be found on the Build dependencies ------------------ -The CUDA GPU driver library has an header-only dependency on ``cuda.h`` and ``cudaTypedefs.h``. -To get these headers there are two options: +The CUDA GPU driver library has a header-only dependency on ``cuda.h`` and ``cudaTypedefs.h``. +To get these headers, there are two options: - Install `CUDA Toolkit `_ (either regular or stubs installation). - Download these two headers from this `CUDA headers `_ repository. -You need to indicate to meson where CUDA headers files are through the CFLAGS variable. -Three ways: +You can point to CUDA header files either with the ``CFLAGS`` environment variable, +or with the ``c_args`` Meson option. Examples: -- Set ``export CFLAGS=-I/usr/local/cuda/include`` before building -- Add CFLAGS in the meson command line ``CFLAGS=-I/usr/local/cuda/include meson setup build`` -- Add the ``-Dc_args`` in meson command line ``meson setup build -Dc_args=-I/usr/local/cuda/include`` +- ``CFLAGS=-I/usr/local/cuda/include meson setup build`` +- ``meson setup build -Dc_args=-I/usr/local/cuda/include`` If headers are not found, the CUDA GPU driver library is not built. @@ -46,15 +45,15 @@ A quick recipe to download, build and run GDRCopy library and driver: $ # Launch gdrdrv kernel module on the system $ sudo ./insmod.sh -You need to indicate to meson where GDRCopy headers files are as in case of CUDA headers. +You need to indicate to Meson where GDRCopy header files are as in case of CUDA headers. An example would be: .. code-block:: console $ meson setup build -Dc_args="-I/usr/local/cuda/include -I/path/to/gdrcopy/include" -If headers are not found, the CUDA GPU driver library is built without the CPU map capability -and will return error if the application invokes the gpudev ``rte_gpu_mem_cpu_map`` function. +If headers are not found, the CUDA GPU driver library is built without the CPU map capability, +and will return an error if the application invokes the gpudev ``rte_gpu_mem_cpu_map`` function. CUDA Shared Library @@ -143,7 +142,7 @@ if the address is not in the table the CUDA driver library will return an error. Features -------- -- Register new child devices aka new CUDA Driver contexts. +- Register new child devices, aka CUDA driver contexts. - Allocate memory on the GPU. - Register CPU memory to make it visible from GPU. @@ -189,9 +188,10 @@ External references A good example of how to use the GPU CUDA driver library through the gpudev library is the l2fwd-nv application that can be found `here `_. -The application is based on vanilla DPDK example l2fwd -and is enhanced with GPU memory managed through gpudev library -and CUDA to launch the swap of packets MAC addresses workload on the GPU. +The application is based on the DPDK example l2fwd, +with GPU memory managed through gpudev library. +It includes a CUDA workload swapping MAC addresses +of packets received in the GPU. l2fwd-nv is not intended to be used for performance (testpmd is the good candidate for this). -- 2.25.1 --- Diff of the applied patch vs upstream commit (please double-check if non-empty: --- --- - 2023-08-09 21:51:21.182320200 +0800 +++ 0119-doc-improve-wording-of-cuda-guide.patch 2023-08-09 21:51:18.294352000 +0800 @@ -1 +1 @@ -From 135551ae0bae5a9e575b0a531490c24ef730dac0 Mon Sep 17 00:00:00 2001 +From fdb81fcc2ceb4cfd4271cd650c2cd3748e370cf7 Mon Sep 17 00:00:00 2001 @@ -4,0 +5,3 @@ +Cc: Xueming Li + +[ upstream commit 135551ae0bae5a9e575b0a531490c24ef730dac0 ]