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 <[email protected]> --- 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
