Skip to contentSkip to conversation

doc: update kernel version requirement

PATCH Superseded Stephen Hemminger 3 participants 4 messages Apr 9, 2025 – Jul 21, 2025

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 doc: update kernel version requirement

The 4.19 kernel version was end of life in December 2024. Update to 5.4 and also add better description of what "not supported" means in this case.

---
 doc/guides/linux_gsg/sys_reqs.rst | 17 ++++++++++++-----
 1 file changed, 12 insertions(+), 5 deletions(-)
doc/guides/linux_gsg/sys_reqs.rst +12 -5
index 5a7d9e4a43..cab198134b 100644
@@ -105,11 +105,18 @@ System Software
 
 **Required:**
 
-*   Kernel version >= 4.19
-
-    The kernel version required is based on the oldest long term stable kernel available
-    at kernel.org when the DPDK version is in development.
-    Compatibility for recent distribution kernels will be kept, notably RHEL/CentOS 7.
+*   Kernel version >= 5.4
+
+    The Linux userspace API is compatible across releases but there are some
+    restrictions. The oldest kernel tested by the DPDK testing infrastructure
+    is the oldest maintained Long Term Stable (LTS) at time of release.
+    The DPDK is likely to still work with older releases but it is not guaranteed.
+    Compatibility for recent distribution kernels will be kept, notably RHEL, and Ubuntu.
+    It may work on older distributions, past End Of Life (EOL) like RHEL7
+    but this is no longer tested or guaranteed to work.
+
+    Some drivers and hardware support may require more recent kernels, check the
+    documentation (e.g. :doc:`../nics/index`)
 
     The kernel version in use can be checked using the command::
 
Signature · 1 line
2.47.2
#1 lore raw

PATCH v2 1/1 doc: update kernel version requirement

The 4.19 kernel version was end of life in December 2024. Update to 5.4 and also add better description of what "not supported" means in this case.

---
v2 - better wording

 doc/guides/linux_gsg/sys_reqs.rst | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)
doc/guides/linux_gsg/sys_reqs.rst +14 -5
index 5a7d9e4a43..ba48b8afc0 100644
@@ -105,11 +105,20 @@ System Software
 
 **Required:**
 
-*   Kernel version >= 4.19
-
-    The kernel version required is based on the oldest long term stable kernel available
-    at kernel.org when the DPDK version is in development.
-    Compatibility for recent distribution kernels will be kept, notably RHEL/CentOS 7.
+*   Kernel version >= 5.4
+
+    The Linux userspace API is compatible across releases but there are some
+    restrictions. The oldest kernel tested by the DPDK testing infrastructure
+    is the oldest maintained Long Term Stable (LTS) at time of release.
+    The DPDK is likely to still work with older releases but it is not guaranteed.
+    Compatibility for recent distribution kernels will be kept, notably RHEL, and Ubuntu.
+    It may work on older distributions, that are no longer under standard period
+    but this is no longer but this is no longer tested or guaranteed to work.
+    The following are outside the current support window: RHEL 7, SLES 15.5, Ubuntu 20.04
+    and earlier.
+
+    Some drivers and hardware support may require more recent kernels, check the
+    documentation (e.g. :doc:`../nics/index`)
 
     The kernel version in use can be checked using the command::
 
Signature · 1 line
2.47.2
Acked-by on v2 1/1
#2 lore raw
Quoted 21 lines · Stephen Hemminger

The 4.19 kernel version was end of life in December 2024. Update to 5.4 and also add better description of what "not supported" means in this case.

---
v2 - better wording

 doc/guides/linux_gsg/sys_reqs.rst | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)
doc/guides/linux_gsg/sys_reqs.rst +0 -1
index 5a7d9e4a43..ba48b8afc0 100644
@@ -105,11 +105,20 @@ System Software
 
 **Required:**
 
-*   Kernel version >= 4.19

doc/guides/linux_gsg/sys_reqs.rst System Software · line 113

Quoted 10 lines
doc/guides/linux_gsg/sys_reqs.rst +6 -4
-
-    The kernel version required is based on the oldest long term stable kernel available
-    at kernel.org when the DPDK version is in development.
-    Compatibility for recent distribution kernels will be kept, notably RHEL/CentOS 7.
+*   Kernel version >= 5.4
+
+    The Linux userspace API is compatible across releases but there are some
+    restrictions. The oldest kernel tested by the DPDK testing infrastructure
+    is the oldest maintained Long Term Stable (LTS) at time of release.
+    The DPDK is likely to still work with older releases but it is not guaranteed.

It's just word semantics, but I mentioned before, I don't like the use of "guarantee" that is is implied for newer kernels.

We can simply say that older kernels are not tested with and/or that DPDK is not maintained to keep compatibility with them etc.

doc/guides/linux_gsg/sys_reqs.rst System Software · line 116

Quoted 3 lines
doc/guides/linux_gsg/sys_reqs.rst +3 -0
+    Compatibility for recent distribution kernels will be kept, notably RHEL, and Ubuntu.
+    It may work on older distributions, that are no longer under standard period
+    but this is no longer but this is no longer tested or guaranteed to work.

"but this is no longer" is repeated

Again, it is implying there are "guarantees" for newer kernels

doc/guides/linux_gsg/sys_reqs.rst System Software · line 124

Quoted 8 lines
doc/guides/linux_gsg/sys_reqs.rst +5 -0
+    The following are outside the current support window: RHEL 7, SLES 15.5, Ubuntu 20.04
+    and earlier.
+
+    Some drivers and hardware support may require more recent kernels, check the
+    documentation (e.g. :doc:`../nics/index`)
 
     The kernel version in use can be checked using the command::
 

With some minor tweaks,

#3 lore raw

21/07/2025 12:45, Kevin Traynor:

Quoted 53 lines · Stephen Hemminger
Quoted 21 lines

The 4.19 kernel version was end of life in December 2024. Update to 5.4 and also add better description of what "not supported" means in this case.

---
v2 - better wording

 doc/guides/linux_gsg/sys_reqs.rst | 19 ++++++++++++++-----
 1 file changed, 14 insertions(+), 5 deletions(-)
doc/guides/linux_gsg/sys_reqs.rst +0 -1
index 5a7d9e4a43..ba48b8afc0 100644
@@ -105,11 +105,20 @@ System Software
 
 **Required:**
 
-*   Kernel version >= 4.19

doc/guides/linux_gsg/sys_reqs.rst System Software · line 113

Quoted 10 lines
doc/guides/linux_gsg/sys_reqs.rst +6 -4
-
-    The kernel version required is based on the oldest long term stable kernel available
-    at kernel.org when the DPDK version is in development.
-    Compatibility for recent distribution kernels will be kept, notably RHEL/CentOS 7.
+*   Kernel version >= 5.4
+
+    The Linux userspace API is compatible across releases but there are some
+    restrictions. The oldest kernel tested by the DPDK testing infrastructure
+    is the oldest maintained Long Term Stable (LTS) at time of release.
+    The DPDK is likely to still work with older releases but it is not guaranteed.

It's just word semantics, but I mentioned before, I don't like the use of "guarantee" that is is implied for newer kernels.

We can simply say that older kernels are not tested with and/or that DPDK is not maintained to keep compatibility with them etc.

doc/guides/linux_gsg/sys_reqs.rst System Software · line 116

Quoted 3 lines
doc/guides/linux_gsg/sys_reqs.rst +3 -0
+    Compatibility for recent distribution kernels will be kept, notably RHEL, and Ubuntu.
+    It may work on older distributions, that are no longer under standard period
+    but this is no longer but this is no longer tested or guaranteed to work.

"but this is no longer" is repeated

Again, it is implying there are "guarantees" for newer kernels

Quoted 6 lines
doc/guides/linux_gsg/sys_reqs.rst +5 -0
+    The following are outside the current support window: RHEL 7, SLES 15.5, Ubuntu 20.04
+    and earlier.
+
+    Some drivers and hardware support may require more recent kernels, check the
+    documentation (e.g. :doc:`../nics/index`)
 
Quoted 7 lines

doc/guides/linux_gsg/sys_reqs.rst System Software · line 124

Quoted 2 lines
doc/guides/linux_gsg/sys_reqs.rst +0 -0
     The kernel version in use can be checked using the command::
 

With some minor tweaks,

Keeping only the non-controversial parts, not mentioning any distro or version:

* Kernel version >= 5.4

The Linux userspace API is compatible across releases but there are some restrictions.
The oldest kernel tested by the DPDK testing infrastructure is the oldest maintained Long Term Stable (LTS) at time of release.

Some drivers and hardware support may require more recent kernels, check the documentation.

Applied as minimal change.