d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: add instructions for building 32-bit DPDK

Browse Source 
For users with 32-bit applications who wish to use DPDK we need to provide
instructions on creating a 32-bit build of DPDK with meson. Therefore add a
section with this information to the GSG.

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Acked-by: Luca Boccassi <bluca@debian.org>
This commit is contained in:
Bruce Richardson 2020-10-16 16:09:55 +01:00 committed by Thomas Monjalon
parent 9b83106d87
commit a8adac0bc0
1 changed files with 29 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
doc/guides/linux_gsg/build_dpdk.rst
View File

@ -113,6 +113,35 @@ dependencies are met on the current system are built.
When `-Dexamples=all` is set as a meson option, meson will check each example application to see if it can be built,
and add all which can be built to the list of tasks in the ninja build configuration file.
Building 32-bit DPDK on 64-bit Systems
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
To build a 32-bit copy of DPDK on a 64-bit OS,
the ``-m32`` flag should be passed to the compiler and linker
to force the generation of 32-bit objects and binaries.
This can be done either by setting ``CFLAGS`` and ``LDFLAGS`` in the environment,
or by passing the value to meson using ``-Dc_args=-m32`` and ``-Dc_link_args=-m32``.
For correctly identifying and using any dependency packages,
the ``pkg-config`` tool must also be configured
to look in the appropriate directory for .pc files for 32-bit libraries.
This is done by setting ``PKG_CONFIG_LIBDIR`` to the appropriate path.
The following meson command can be used on RHEL/Fedora systems to configure a 32-bit build,
assuming the relevant 32-bit development packages, such as a 32-bit libc, are installed::
PKG_CONFIG_LIBDIR=/usr/lib/pkgconfig \
meson -Dc_args='-m32' -Dc_link_args='-m32' build
For Debian/Ubuntu systems, the equivalent command is::
PKG_CONFIG_LIBDIR=/usr/lib/i386-linux-gnu/pkgconfig \
meson -Dc_args='-m32' -Dc_link_args='-m32' build
Once the build directory has been configured,
DPDK can be compiled using ``ninja`` as described above.
.. _building_app_using_installed_dpdk:
Building Applications Using Installed DPDK