path: root/doc/guides/nics/mlx5.rst
diff options
authorThomas Monjalon <>2019-01-09 15:23:19 +0100
committerFerruh Yigit <>2019-01-14 17:44:29 +0100
commit2c0dd7b69fb00fc3e422a6058ff8429edc869f68 (patch)
treefeeb13844b171079eaf058825c1fca2cfecb4b5c /doc/guides/nics/mlx5.rst
parent72b934adce8f5f9ed035c04ebed8b386243e5a2e (diff)
config: add static linkage of mlx dependency
The libraries provided by rdma-core may be statically linked if enabling CONFIG_RTE_IBVERBS_LINK_STATIC in the make-based build. If CONFIG_RTE_BUILD_SHARED_LIB is disabled, the applications will embed the mlx PMDs with ibverbs and the mlx libraries. If CONFIG_RTE_BUILD_SHARED_LIB is enabled, the mlx PMDs will embed ibverbs and the mlx libraries. Support with meson may be added later. Signed-off-by: Thomas Monjalon <> Acked-by: Shahaf Shuler <>
Diffstat (limited to 'doc/guides/nics/mlx5.rst')
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 749acd2..5ddca44 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -210,6 +210,11 @@ These options can be modified in the ``.config`` file.
This option has no performance impact.
+- ``CONFIG_RTE_IBVERBS_LINK_STATIC`` (default **n**)
+ Embed static flavour of the dependencies **libibverbs** and **libmlx5**
+ in the PMD shared library or the executable static binary.
- ``CONFIG_RTE_LIBRTE_MLX5_DEBUG`` (default **n**)
Toggle debugging code and stricter compilation flags. Enabling this option
@@ -577,9 +582,22 @@ RMDA Core with Linux Kernel
- rdma-core version 18.0 or above built with 32bit support.
- Kernel version 4.14.41 or above.
+- Starting with rdma-core v21, static libraries can be built::
+ cd build
+ ninja
.. _`Linux installation documentation`:
.. _`RDMA Core installation documentation`:
+If rdma-core libraries are built but not installed, DPDK makefile can link them,
+thanks to these environment variables:
+ - ``EXTRA_CFLAGS=-I/path/to/rdma-core/build/include``
+ - ``EXTRA_LDFLAGS=-L/path/to/rdma-core/build/lib``
+ - ``PKG_CONFIG_PATH=/path/to/rdma-core/build/lib/pkgconfig``
Mellanox OFED