Skip to content

Commit

Permalink
build: prevent accidentally building without NUMA support
Browse files Browse the repository at this point in the history
When libnuma development package is missing on a system, DPDK can still
be built but will be missing much-needed support for NUMA memory
management. This may later cause issues at runtime if the resulting
binary is run on a NUMA system.

We can reduce the incidence of such runtime errors by ensuring that, for
native builds*, libnuma is present - unless the user actually specifies
via "max_numa_nodes" that they don't require NUMA support. Having this
as an error condition is also in keeping with what is documented in the
Linux GSG doc, where libnuma is listed as a requirement for building
DPDK [1].

* NOTE: cross-compilation builds have a different logic set, with a
  separate "numa" value indicating if numa support is necessary.

[1] https://doc.dpdk.org/guides-23.03/linux_gsg/sys_reqs.html

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
Signed-off-by: David Marchand <david.marchand@redhat.com>
  • Loading branch information
bruce-richardson authored and tmonjalo committed Jul 3, 2023
1 parent 057fa57 commit 5afed69
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 1 deletion.
5 changes: 4 additions & 1 deletion .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -92,6 +92,9 @@ jobs:
with:
path: reference
key: ${{ steps.get_ref_keys.outputs.abi }}
- name: Configure i386 architecture
if: env.BUILD_32BIT == 'true'
run: sudo dpkg --add-architecture i386
- name: Update APT cache
run: sudo apt update || true
- name: Install packages
Expand All @@ -104,7 +107,7 @@ jobs:
run: sudo apt install -y autoconf automake libdw-dev libtool libxml2-dev
- name: Install i386 cross compiling packages
if: env.BUILD_32BIT == 'true'
run: sudo apt install -y gcc-multilib g++-multilib
run: sudo apt install -y gcc-multilib g++-multilib libnuma-dev:i386
- name: Install aarch64 cross compiling packages
if: env.AARCH64 == 'true'
run: sudo apt install -y crossbuild-essential-arm64
Expand Down
9 changes: 9 additions & 0 deletions config/meson.build
Original file line number Diff line number Diff line change
Expand Up @@ -381,6 +381,15 @@ endif
if not dpdk_conf.has('RTE_MAX_NUMA_NODES')
error('Number of NUMA nodes not specified.')
endif
if (is_linux and
dpdk_conf.get('RTE_MAX_NUMA_NODES') > 1 and
not meson.is_cross_build() and
not has_libnuma)
error('''
No NUMA library (development package) found, yet DPDK configured for multiple NUMA nodes.
Please install libnuma, or set 'max_numa_nodes' option to '1' to build without NUMA support.
''')
endif

# set the install path for the drivers
dpdk_conf.set_quoted('RTE_EAL_PMD_PATH', eal_pmd_path)
Expand Down

0 comments on commit 5afed69

Please sign in to comment.