doc: add instructions for building 32-bit DPDK
diff mbox series

Message ID 20201016150955.2765-1-bruce.richardson@intel.com
State Accepted
Delegated to: Thomas Monjalon
Headers show
Series
  • doc: add instructions for building 32-bit DPDK
Related show

Checks

Context Check Description
ci/Intel-compilation success Compilation OK
ci/checkpatch success coding style OK

Commit Message

Bruce Richardson Oct. 16, 2020, 3:09 p.m. UTC
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>
---
 doc/guides/linux_gsg/build_dpdk.rst | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

Comments

Luca Boccassi Oct. 16, 2020, 5:25 p.m. UTC | #1
On Fri, 2020-10-16 at 16:09 +0100, Bruce Richardson wrote:
> 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>
> ---
>  doc/guides/linux_gsg/build_dpdk.rst | 25 +++++++++++++++++++++++++
>  1 file changed, 25 insertions(+)

Acked-by: Luca Boccassi <bluca@debian.org>
Thomas Monjalon Nov. 6, 2020, 5:47 p.m. UTC | #2
16/10/2020 19:25, Luca Boccassi:
> On Fri, 2020-10-16 at 16:09 +0100, Bruce Richardson wrote:
> > 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>
> > ---
> >  doc/guides/linux_gsg/build_dpdk.rst | 25 +++++++++++++++++++++++++
> >  1 file changed, 25 insertions(+)
> 
> Acked-by: Luca Boccassi <bluca@debian.org>

Applied with few adjustments in line wrapping to limit line length < 100.

Patch
diff mbox series

diff --git a/doc/guides/linux_gsg/build_dpdk.rst b/doc/guides/linux_gsg/build_dpdk.rst
index 1d867dedf..e76642efc 100644
--- a/doc/guides/linux_gsg/build_dpdk.rst
+++ b/doc/guides/linux_gsg/build_dpdk.rst
@@ -113,6 +113,31 @@  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