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 105A945C16; Wed, 30 Oct 2024 16:21:49 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 043E54341E; Wed, 30 Oct 2024 16:21:49 +0100 (CET) Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182]) by mails.dpdk.org (Postfix) with ESMTP id A52DA4341D for ; Wed, 30 Oct 2024 16:21:47 +0100 (CET) Received: by linux.microsoft.com (Postfix, from userid 1213) id E4C0720C5D6F; Wed, 30 Oct 2024 08:21:46 -0700 (PDT) DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com E4C0720C5D6F DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com; s=default; t=1730301706; bh=qfMgco9QRtnmLFiCtrpux5Ksu99of78hNMQEWtHda5Q=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=j2jCDwccs3C4avfxOik/GKdWYrT8wnoR7W1xXEkMEkXK+1ERy7YtDQJIC0OKJ5tqX k3/XSYtCUBPVrAxpei4ZHzLy7YRhBRMAmwOq+WVIIf9TLo+j0I+s+3Hj3kKFZSJeEu 4/u+otoWJtIzgxG5NdFwtVA5jzmZ68tkWQRcZr5Y= From: Andre Muezerie To: dmitry.kozliuk@gmail.com Cc: andremue@linux.microsoft.com, dev@dpdk.org Subject: [PATCH v4] doc: modernize build instructions on Windows Date: Wed, 30 Oct 2024 08:19:45 -0700 Message-Id: <1730301585-14536-1-git-send-email-andremue@linux.microsoft.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <20241030120920.55303842@sovereign> References: <20241030120920.55303842@sovereign> 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 Meson 0.57 was an unstable version and is now outdated. The referenced bug in Meson 0.58 is fixed in stable releases. Recommend the latest stable release which is tested. Building DPDK applications that run on 32-bit Windows is currently not supported. However, some Visual Studio environments default to producing 32-bit binaries. Recommend instructing the developer prompt to produce 64-bit binaries when that is the case. Signed-off-by: Andre Muezerie --- v4: - Clarified that "32-bit binaries" were refering to the Windows environment. - Added clarifying commit messages. v3: - Recommended Meson version to use and removed mention about old bug. - Set VS developer prompt to produce 64 bit binaries if needed. v2: - provide Meson version that works .mailmap | 1 + doc/guides/windows_gsg/build_dpdk.rst | 22 ++++++++++++++++------ 2 files changed, 17 insertions(+), 6 deletions(-) diff --git a/.mailmap b/.mailmap index 5290420..60db768 100644 --- a/.mailmap +++ b/.mailmap @@ -98,6 +98,7 @@ Anatolii Gerasymenko Anatoly Burakov Anbarasan Murugesan Anders Roxell +Andre Muezerie Andrea Arcangeli Andrea Grandi Andre Richter diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst index 708875c..ff89e95 100644 --- a/doc/guides/windows_gsg/build_dpdk.rst +++ b/doc/guides/windows_gsg/build_dpdk.rst @@ -72,10 +72,7 @@ A good option to choose is the MSI installer for both meson and ninja together:: http://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer%22 -Required version is Meson 0.57. - -Versions starting from 0.58 are unusable with LLVM toolchain -because of a `Meson issue `_. +Meson version 1.5.2 or newer is recommended. Install the Backend @@ -129,13 +126,26 @@ Depending on the distribution, paths in this file may need adjustments. Option 3. Native Build on Windows using MSVC ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -Open a 'Developer PowerShell for VS 2022' prompt from the start menu. +Open a 'Visual Studio Developer Command Prompt'. The developer prompt will configure the environment to select the appropriate compiler, linker and SDK paths required to build with Visual Studio 2022. +Building DPDK applications that run on 32-bit Windows is currently not +supported. If your Visual Studio environment defaults to producing +32-bit binaries you can instruct the toolset to produce 64-bit binaries using "-arch" parameter. +For more details about the Developer Prompt options look at the `Visual Studio Developer +Command Prompt and Developer PowerShell +`_. + +.. code-block:: console + + "C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64 + +Compile the code from the developer prompt. + .. code-block:: console cd C:\Users\me\dpdk meson setup -Denable_stdatomic=true build - meson compile -C build + meson compile -C build \ No newline at end of file -- 1.8.3.1