From mboxrd@z Thu Jan 1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
by inbox.dpdk.org (Postfix) with ESMTP id B6E5045BD7;
Fri, 25 Oct 2024 21:31:57 +0200 (CEST)
Received: from mails.dpdk.org (localhost [127.0.0.1])
by mails.dpdk.org (Postfix) with ESMTP id A8E40402E2;
Fri, 25 Oct 2024 21:31:57 +0200 (CEST)
Received: from linux.microsoft.com (linux.microsoft.com [13.77.154.182])
by mails.dpdk.org (Postfix) with ESMTP id AC3B9402E2
for <dev@dpdk.org>; Fri, 25 Oct 2024 21:31:56 +0200 (CEST)
Received: by linux.microsoft.com (Postfix, from userid 1213)
id E9ACA210AF0F; Fri, 25 Oct 2024 12:31:55 -0700 (PDT)
DKIM-Filter: OpenDKIM Filter v2.11.0 linux.microsoft.com E9ACA210AF0F
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linux.microsoft.com;
s=default; t=1729884715;
bh=Dvx78qGIcltzy9QZQxxAoG33ttm/bmZKBdcgo9HLIjk=;
h=From:To:Cc:Subject:Date:In-Reply-To:References:From;
b=KeB8aIkLuEyBwn7fLkgg55uBi7c3Abn6XpNFzzi18aPO/ZhUUTCo7J/7NurSJ505f
GkJUSTBLCNOcgSC94FdlPie5NidOQXnkaANSvnyK657Bm0ZLhx3Nu3R2DvOnon376O
+6lsRqEFnpI3LQRu8nS26c1AmhC739gj5AJLIYAY=
From: Andre Muezerie <andremue@linux.microsoft.com>
To: dev@dpdk.org
Cc: Andre Muezerie <andremue@linux.microsoft.com>
Subject: [PATCH v2 1/2] doc: enhanced build instructions on Windows
Date: Fri, 25 Oct 2024 12:30:58 -0700
Message-Id: <1729884659-2480-2-git-send-email-andremue@linux.microsoft.com>
X-Mailer: git-send-email 1.8.3.1
In-Reply-To: <1729884659-2480-1-git-send-email-andremue@linux.microsoft.com>
References: <1857976.G7SD5HZVK5@thomas>
<1729884659-2480-1-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 <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
<mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
<mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Signed-off-by: Andre Muezerie <andremue@linux.microsoft.com>
---
.mailmap | 1 +
doc/guides/windows_gsg/build_dpdk.rst | 16 +++++++++++-----
2 files changed, 12 insertions(+), 5 deletions(-)
diff --git a/.mailmap b/.mailmap
index 5290420..60db768 100644
--- a/.mailmap
+++ b/.mailmap
@@ -98,6 +98,7 @@ Anatolii Gerasymenko <anatolii.gerasymenko@intel.com>
Anatoly Burakov <anatoly.burakov@intel.com>
Anbarasan Murugesan <anbarasanx.murugesan@intel.com>
Anders Roxell <anders.roxell@linaro.org>
+Andre Muezerie <andremue@linux.microsoft.com> <andremue@microsoft.com>
Andrea Arcangeli <aarcange@redhat.com>
Andrea Grandi <andrea.grandi@intel.com>
Andre Richter <andre.o.richter@gmail.com>
diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst
index 708875c..c5fad81 100644
--- a/doc/guides/windows_gsg/build_dpdk.rst
+++ b/doc/guides/windows_gsg/build_dpdk.rst
@@ -72,10 +72,9 @@ 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 <https://github.com/mesonbuild/meson/issues/8981>`_.
+Meson version 0.58 was unusable with LLVM toolchain
+because of an `issue <https://github.com/mesonbuild/meson/issues/8981>`_, but
+more recent versions are working fine.
Install the Backend
@@ -129,13 +128,20 @@ 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'. When doing so, it's recommended
+to specify the Target Architecture (-arch) and the Host Architecture (-host_arch).
The developer prompt will configure the environment
to select the appropriate compiler, linker and SDK paths
required to build with Visual Studio 2022.
.. code-block:: console
+ "C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\Tools\VsDevCmd.bat" -host_arch=amd64 -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
--
1.8.3.1