* [PATCH] doc: update instructions for Windows builds
@ 2025-11-12 2:41 Andre Muezerie
0 siblings, 0 replies; only message in thread
From: Andre Muezerie @ 2025-11-12 2:41 UTC (permalink / raw)
To: Dmitry Kozlyuk, Tyler Retzlaff; +Cc: dev, Andre Muezerie
Updated some external links and removed a note which does not
apply to MSVC builds anymore.
Also reworded a sentence clarifying how to open a Visual Studio
Developer Command Prompt from CMD and Powershell, as the
original text could induce people to run VsDevCmd.bat from
a Powershell prompt, which does not work.
Signed-off-by: Andre Muezerie <andremue@linux.microsoft.com>
---
doc/guides/windows_gsg/build_dpdk.rst | 25 ++++++++++++++-----------
1 file changed, 14 insertions(+), 11 deletions(-)
diff --git a/doc/guides/windows_gsg/build_dpdk.rst b/doc/guides/windows_gsg/build_dpdk.rst
index 48241f7091..4fec5934b3 100644
--- a/doc/guides/windows_gsg/build_dpdk.rst
+++ b/doc/guides/windows_gsg/build_dpdk.rst
@@ -14,10 +14,6 @@ environments:
* The MinGW-w64 10.0 (or later) toolchain (either native or cross).
* Microsoft Visual Studio 2022 (any edition).
- - note Microsoft Visual Studio 2022 does not currently build enough
- of DPDK to produce a working DPDK application
- but may be used to validate that changes are portable between toolchains.
-
The Meson Build system is used to prepare the sources for compilation
with the Ninja backend.
The installation of these tools is covered in this section.
@@ -30,10 +26,10 @@ Install the Compiler
~~~~~~~~~~~~~~~~~~~~
Download and install the clang compiler from
-`LLVM website <http://releases.llvm.org/download.html>`_.
+`LLVM website <https://releases.llvm.org>`_.
For example, Clang-LLVM direct download link::
- http://releases.llvm.org/7.0.1/LLVM-7.0.1-win64.exe
+ https://github.com/llvm/llvm-project/releases/download/llvmorg-19.1.0/LLVM-19.1.0-win64.exe
Install the Linker
@@ -49,7 +45,7 @@ and ensure the Windows SDK is selected.
Option 2. MinGW-w64 Toolchain
-----------------------------
-On Windows, obtain the latest version installer from
+On Windows, obtain the latest installer version from
`MinGW-w64 repository <https://sourceforge.net/projects/mingw-w64/files/>`_.
Any thread model (POSIX or Win32) can be chosen, DPDK does not rely on it.
Install to a folder without spaces in its name, like ``C:\MinGW``.
@@ -70,7 +66,7 @@ Download and install the build system from
`Meson website <http://mesonbuild.com/Getting-meson.html>`_.
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
+ http://mesonbuild.com/Getting-meson.html#installing-meson-and-ninja-with-the-msi-installer
The minimal Meson supported version is 1.5.2.
@@ -134,14 +130,21 @@ 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
-<https://learn.microsoft.com/en-us/visualstudio/ide/reference/command-prompt-powershell?view=vs-2022>`_.
+
+The command below opens a 'Visual Studio Developer Command Prompt' when invoked
+from a Windows Command Prompt.
.. code-block:: console
"C:\Program Files\Microsoft Visual Studio\2022\Enterprise\Common7\Tools\VsDevCmd.bat" -arch=amd64
+.. note::
+
+ To open a Developer Prompt from PowerShell, and for more details about the options
+ available, look at the
+ `Visual Studio Developer Command Prompt and Developer PowerShell
+ <https://learn.microsoft.com/en-us/visualstudio/ide/reference/command-prompt-powershell?view=vs-2022>`_.
+
Compile the code from the developer prompt.
.. code-block:: console
--
2.51.2.vfs.0.0
^ permalink raw reply [flat|nested] only message in thread
only message in thread, other threads:[~2025-11-12 2:42 UTC | newest]
Thread overview: (only message) (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2025-11-12 2:41 [PATCH] doc: update instructions for Windows builds Andre Muezerie
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).