doc: update kernel version requirement
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
@@ -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
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
@@ -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
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.
Signed-off-by Stephen Hemminger <[email protected]>Acked-by Morten Brørup <[email protected]>---
v2 - better wordingdoc/guides/linux_gsg/sys_reqs.rst | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-)doc/guides/linux_gsg/sys_reqs.rst +0
-1@@ -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,
Thomas Monjalon
Applied21/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.
Signed-off-by Stephen Hemminger <[email protected]>Acked-by Morten Brørup <[email protected]>---
v2 - better wordingdoc/guides/linux_gsg/sys_reqs.rst | 19 ++++++++++++++----- 1 file changed, 14 insertions(+), 5 deletions(-)doc/guides/linux_gsg/sys_reqs.rst +0
-1@@ -105,11 +105,20 @@ System Software **Required:** -* Kernel version >= 4.19doc/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
-0The kernel version in use can be checked using the command::With some minor tweaks,
Acked-by Kevin Traynor <[email protected]>
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.