Skip to contentSkip to conversation

doc/linux_gsg: update recommended compiler versions

PATCH Superseded Bruce Richardson 3 participants 5 messages Apr 8, 2025 – Jun 27, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc/linux_gsg: update recommended compiler versions

Rather than specifying a minimum compiler version, update the docs to recommend a particular compiler version. In other words, earlier versions may work, but are not officially supported, or may give reduced functionality.

---
 doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
doc/guides/linux_gsg/sys_reqs.rst +2 -1
index 4c9d0c55c0..0acd26f260 100644
@@ -28,7 +28,8 @@ Compilation of the DPDK
     For details on Linux distributions and the versions tested, please consult the DPDK Release Notes.
 
 *   General development tools including a C compiler supporting the C11 standard,
-    including standard atomics, for example: GCC (version 5.0+) or Clang (version 3.6+),
+    including standard atomics, for example:
+    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
     and ``pkg-config`` or ``pkgconf`` to be used when building end-user binaries against DPDK.
 
     * For RHEL/Fedora systems these can be installed using ``dnf groupinstall "Development Tools"``
Signature · 1 line
2.45.2
Acked-by on v1 1/1
#1 lore raw
Quoted 32 lines

From: Bruce Richardson [mailto:[email protected]]
Sent: Tuesday, 8 April 2025 19.19

Rather than specifying a minimum compiler version, update the docs to recommend a particular compiler version. In other words, earlier versions may work, but are not officially supported, or may give reduced
functionality.

---
 doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
doc/guides/linux_gsg/sys_reqs.rst +0 -0
index 4c9d0c55c0..0acd26f260 100644
@@ -28,7 +28,8 @@ Compilation of the DPDK
     For details on Linux distributions and the versions tested, please

consult the DPDK Release Notes.

* General development tools including a C compiler supporting the
C11 standard,
- including standard atomics, for example: GCC (version 5.0+) or
Clang (version 3.6+),

doc/guides/linux_gsg/sys_reqs.rst +2 -0
+    including standard atomics, for example:
+    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
     and ``pkg-config`` or ``pkgconf`` to be used when building end-

user binaries against DPDK.

Quoted 4 lines

* For RHEL/Fedora systems these can be installed using ``dnf
groupinstall "Development Tools"``
--
2.45.2

#2 lore raw
In reply to Bruce Richardson

08/04/2025 19:18, Bruce Richardson:

Quoted 4 lines

Rather than specifying a minimum compiler version, update the docs to recommend a particular compiler version. In other words, earlier versions may work, but are not officially supported, or may give reduced functionality.

[...]

Quoted 1 line

+ GCC (version 8.0+ recommended) or Clang (version 7+ recommended),

Please could you explain in the commit log why these versions are recommended?

#3 lore raw

PATCH v2 1/1 doc/linux_gsg: update recommended compiler versions

In reply to Bruce Richardson

Rather than specifying a minimum compiler version, update the docs to recommend a particular compiler version. In other words, earlier versions may work, but are not officially supported, or may give reduced functionality.

Since we don't require that many version-specific features, recommend the compiler verions included in our oldest officially-supported distro. Those versions (GCC 8 & Clang 7) provide all needed functionality.

---
 doc/guides/linux_gsg/sys_reqs.rst | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)
doc/guides/linux_gsg/sys_reqs.rst +2 -1
index 4c9d0c55c0..0acd26f260 100644
@@ -28,7 +28,8 @@ Compilation of the DPDK
     For details on Linux distributions and the versions tested, please consult the DPDK Release Notes.
 
 *   General development tools including a C compiler supporting the C11 standard,
-    including standard atomics, for example: GCC (version 5.0+) or Clang (version 3.6+),
+    including standard atomics, for example:
+    GCC (version 8.0+ recommended) or Clang (version 7+ recommended),
     and ``pkg-config`` or ``pkgconf`` to be used when building end-user binaries against DPDK.
 
     * For RHEL/Fedora systems these can be installed using ``dnf groupinstall "Development Tools"``
Signature · 1 line
2.48.1
#4 lore raw

10/06/2025 11:33, Bruce Richardson:

Quoted 11 lines

Rather than specifying a minimum compiler version, update the docs to recommend a particular compiler version. In other words, earlier versions may work, but are not officially supported, or may give reduced functionality.

Since we don't require that many version-specific features, recommend the compiler verions included in our oldest officially-supported distro. Those versions (GCC 8 & Clang 7) provide all needed functionality.

Applied, thanks.