[PATCH v2] doc: update parameters to use for mlx5 on Windows

[Patrick Robb]

+ci at dpdk.org <ci at dpdk.org>
+Manit Mahajan <mmahajan at iol.unh.edu>
+Andrew Bailey <abailey at iol.unh.edu>

Thank you for this we will modify our Clang and MSVC build pipelines at UNH.

Acked-by: Patrick Robb <probb at iol.unh.edu>

On Tue, Jul 15, 2025 at 10:14 AM Andre Muezerie <
andremue at linux.microsoft.com> wrote:

> The linker parameters to use with MSVC and Clang differ.
> Showing explicitly what to use with each in the documentation.
>
> Signed-off-by: Andre Muezerie <andremue at linux.microsoft.com>
> ---
>  doc/guides/platform/mlx5.rst | 27 +++++++++++++++++++++++----
>  1 file changed, 23 insertions(+), 4 deletions(-)
>
> diff --git a/doc/guides/platform/mlx5.rst b/doc/guides/platform/mlx5.rst
> index ab3107209a..94ed59b170 100644
> --- a/doc/guides/platform/mlx5.rst
> +++ b/doc/guides/platform/mlx5.rst
> @@ -268,14 +268,33 @@ configured by the ``ibverbs_link`` build option:
>  Compilation on Windows
>  ~~~~~~~~~~~~~~~~~~~~~~
>
> -The DevX SDK location must be set through CFLAGS/LDFLAGS,
> -either::
> +The DevX SDK location must be set through CFLAGS/LDFLAGS.
> +When compiling with MSVC, use either::
>
> -   meson.exe setup "-Dc_args=-I\"%DEVX_INC_PATH%\""
> "-Dc_link_args=-L\"%DEVX_LIB_PATH%\"" ...
> +   meson.exe setup ^
> +       "-Dc_args=-I\"%DEVX_INC_PATH%\"" ^
> +       "-Dc_link_args=-LIBPATH:\"%DEVX_LIB_PATH%\"" ^
> +       -Denable_stdatomic=true ^
> +       ...
>
>  or::
>
> -   set CFLAGS=-I"%DEVX_INC_PATH%" && set LDFLAGS=-L"%DEVX_LIB_PATH%" &&
> meson.exe setup ...
> +   set CFLAGS=-I"%DEVX_INC_PATH%"
> +   set LDFLAGS=-LIBPATH:"%DEVX_LIB_PATH%"
> +   meson.exe setup -Denable_stdatomic=true ...
> +
> +When compiling with Clang, use either::
> +
> +   meson.exe setup ^
> +       "-Dc_args=-I\"%DEVX_INC_PATH%\"" ^
> +       "-Dc_link_args=-Wl,-LIBPATH:\"%DEVX_LIB_PATH%\"" ^
> +       ...
> +
> +or::
> +
> +   set CFLAGS=-I"%DEVX_INC_PATH%"
> +   set LDFLAGS=-Wl,-LIBPATH:"%DEVX_LIB_PATH%"
> +   meson.exe setup ...
>
>
>  .. _mlx5_common_env:
> --
> 2.50.1.vfs.0.0
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mails.dpdk.org/archives/dev/attachments/20250715/f6bb0857/attachment.htm>