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 2392945CCD; Mon, 11 Nov 2024 17:14:17 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B64D3400D6; Mon, 11 Nov 2024 17:14:16 +0100 (CET) Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182]) by mails.dpdk.org (Postfix) with ESMTP id CD23B40041 for ; Mon, 11 Nov 2024 17:14:14 +0100 (CET) Received: by linux.microsoft.com (Postfix, from userid 1213) id 2F9292171FA8; Mon, 11 Nov 2024 08:14:14 -0800 (PST) DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com 2F9292171FA8 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com; s=default; t=1731341654; bh=kkcjwCq7AXdDb6+K2qdADpf2E93DtghlHGU4GmEa+I4=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=iIyfzCLgFwfbA/cAtMRAtxyPyXbLEQfdthp/HVLEaemNScI3O8bcKMIBiTdWH3Z3P xtbw01s7AZaeS+Kybh8dChJ9wNEffHS0KSfA2s+J3Jt8Au7XJeJn8vrfEc7Qn8VsVH /dZanE7ZNlI9+hAshOy1uX4/OnfTkv49VWKBniFs= From: Andre Muezerie To: andremue@linux.microsoft.com Cc: dev@dpdk.org, dmitry.kozliuk@gmail.com, roretzla@linux.microsoft.com, thomas@monjalon.net Subject: [PATCH v6] doc: modernize build instructions on Windows Date: Mon, 11 Nov 2024 08:14:08 -0800 Message-Id: <1731341648-388-1-git-send-email-andremue@linux.microsoft.com> X-Mailer: git-send-email 1.8.3.1 In-Reply-To: <1729865715-18711-2-git-send-email-andremue@linux.microsoft.com> References: <1729865715-18711-2-git-send-email-andremue@linux.microsoft.com> 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 first version containing the fix: 1.5.2. 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 --- .mailmap | 1 + doc/guides/windows_gsg/build_dpdk.rst | 20 +++++++++++++++----- 2 files changed, 16 insertions(+), 5 deletions(-) diff --git a/.mailmap b/.mailmap index 5290420258..60db768b98 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 708875c16f..2c7bf1a309 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 `_. +The minimal Meson supported version is 1.5.2. Install the Backend @@ -129,11 +126,24 @@ 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 -- 2.34.1