Skip to contentSkip to conversation

lib: Check minimal supported kernel version

PATCH Applied Andrea Cervesato 6 participants 9 messages Sep 4 – Sep 11 Library code

lore
Share & tools
lore
#0 lore raw

PATCH v2 1/1 lib: Check minimal supported kernel version

From: Andrea Cervesato <[email protected]>

LTP does not support kernels older than 4.4, but this requirement was only documented in static text without automated runtime validation.

Define the minimal supported kernel version in tst_kvercmp.h so that the documentation fetches it dynamically and the core library aborts unsupported kernels with TCONF during test setup.

---
Add a variable to check minimum kernel version before running tests. Until now, the only place we have to verify the minimum kernel is to read the documentation.
---
Changes in v2:
- TWARN when kernel is minimal
- Link to v1: https://lore.kernel.org/[email protected]

---
 doc/conf.py                     | 15 +++++++++++++++
 doc/users/supported_systems.rst |  2 +-
 include/tst_kvercmp.h           |  7 ++++++-
 lib/tst_test.c                  | 17 +++++++++++++++++
 4 files changed, 39 insertions(+), 2 deletions(-)
doc/conf.py +15 -0
index c28db7af1..69ea31b0c 100644
@@ -21,6 +21,21 @@ ltp_repo = 'https://github.com/linux-test-project/ltp'
 ltp_repo_base_url = f"{ltp_repo}/tree/master"
 cve_url = "https://www.cve.org/CVERecord?id="
 
+def _get_min_kernel_version():
+    header_path = os.path.join(os.path.dirname(__file__), '../include/tst_kvercmp.h')
+    with open(header_path, 'r', encoding='utf-8') as f:
+        match = re.search(r'#define\s+TST_MIN_KVER\s+"([^"]+)"', f.read())
+        if match:
+            return match.group(1)
+    raise RuntimeError(f"Could not find TST_MIN_KVER in {header_path}")
+
+min_kernel_version = _get_min_kernel_version()
+
+rst_prolog = f"""
+.. |min_kernel_version| replace:: **{min_kernel_version}**
+.. |min_kernel_version_plain| replace:: {min_kernel_version}
+"""
+
 # -- General configuration ---------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#general-configuration
 
doc/users/supported_systems.rst +1 -1
index b5d792eeb..5765214b0 100644
@@ -14,7 +14,7 @@ branch is build tested in
 Kernel version
 --------------
 
-Minimal supported kernel version is **4.4**.
+Minimal supported kernel version is |min_kernel_version|.
 
 Oldest build tested distributions
 ---------------------------------
include/tst_kvercmp.h +6 -1
index 26e8f8e3c..52267fd2b 100644
@@ -1,12 +1,17 @@
 /* SPDX-License-Identifier: GPL-2.0-or-later
  * Copyright (c) 2000 Silicon Graphics, Inc.  All Rights Reserved.
  * Copyright (c) 2009-2016 Cyril Hrubis [email protected]
- * Copyright (c) Linux Test Project, 2020-2025
+ * Copyright (c) Linux Test Project, 2020-2026
  */
 
 #ifndef TST_KVERCMP_H__
 #define TST_KVERCMP_H__
 
+/**
+ * TST_MIN_KVER - Minimal kernel version supported by LTP.
+ */
+#define TST_MIN_KVER "4.4"
+
 /**
  * tst_kvcmp() - Compare given kernel version with kernel in string.
  *
lib/tst_test.c +17 -0
index 166e0f672..7ec0d1d33 100644
@@ -1087,6 +1087,21 @@ static bool check_kver(const char *min_kver, const int brk_nosupp)
 	return true;
 }
 
+static void check_supported_kver(void)
+{
+	int v1, v2, v3;
+
+	if (tst_parse_kver(TST_MIN_KVER, &v1, &v2, &v3)) {
+		tst_res(TWARN,
+			"Invalid minimal kernel version %s, expected %%d.%%d.%%d",
+			TST_MIN_KVER);
+		return;
+	}
+
+	if (tst_kvercmp(v1, v2, v3) < 0)
+		tst_brk(TWARN, "Kernel is older than minimal supported %s", TST_MIN_KVER);
+}
+
 /*
  * Checks if the struct results values are equal.
  *
@@ -1455,6 +1470,8 @@ static void do_setup(int argc, char *argv[])
 	if (context->tdebug)
 		tst_res(TINFO, "Enabling debug info (level %d)", context->tdebug);
 
+	check_supported_kver();
+
 	if (tst_test->needs_kconfigs && tst_kconfig_check(tst_test->needs_kconfigs))
 		tst_brk(TCONF, "Aborting due to unsuitable kernel config, see above!");
 

---
base-commit: 8de2c6f07037f600d1ee6c45f489ab4998feea0c
change-id: 20260904-min_kernel-22066a2e046c

Best regards,

Signature · 5 lines
Andrea Cervesato <[email protected]>


-- 
Mailing list info: https://lists.linux.it/listinfo/ltp
#1 lore raw
Quoted 3 lines

Define the minimal supported kernel version in tst_kvercmp.h so that the documentation fetches it dynamically and the core library aborts unsupported kernels with TCONF during test setup.

The description doesn't match the code.
Other than that, it looks good to me.

Signature · 5 lines
Regards,
Li Wang

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp
#3 lore raw
In reply to Andrea Cervesato

Hi Andrea,

lib/tst_test.c static bool check_kver(const char *min_kver, const int brk_nosupp) · line 1102

Quoted 4 lines · Andrea Cervesato

lib: Check minimal supported kernel version

lib/tst_test.c +2 -0
+	if (tst_kvercmp(v1, v2, v3) < 0)
+		tst_brk(TWARN, "Kernel is older than minimal supported %s", TST_MIN_KVER);

This exits with TWARN, contrary to the commit message's stated TCONF behavior. Use tst_brk(TCONF, ...) so unsupported kernels are reported as skipped configurations.

Verdict - Needs revision

---
Note:

The agent can sometimes produce false positives although often its findings are genuine. If you find issues with the review, please comment this email or ignore the suggestions.

Regards,
LTP AI Reviewer

Signature · 1 line
Mailing list info: https://lists.linux.it/listinfo/ltp
#4 lore raw
Quoted 3 lines

This exits with TWARN, contrary to the commit message's stated TCONF behavior. Use tst_brk(TCONF, ...) so unsupported kernels are reported as skipped configurations.

@Petr @Cyril @Li This can be fixed before merge if you agree with it.

--
Andrea Cervesato
SUSE QE Automation Engineer Linux
[email protected]

Signature · 1 line
Mailing list info: https://lists.linux.it/listinfo/ltp
Reviewed-by
#2 lore raw
In reply to Li Wang

Hi!

Quoted 6 lines
Quoted 3 lines

Define the minimal supported kernel version in tst_kvercmp.h so that the documentation fetches it dynamically and the core library aborts unsupported kernels with TCONF during test setup.

The description doesn't match the code.
Other than that, it looks good to me.

Indeed. Feel free to add my reviewed by with this description adjusted.

Signature · 5 lines
Cyril Hrubis
[email protected]

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp
#5 lore raw
In reply to Andrea Cervesato

Hi,

lib/tst_test.c static bool check_kver(const char *min_kver, const int brk_nosupp) · line 1103

Quoted 4 lines
lib/tst_test.c +4 -0
+
+	if (tst_kvercmp(v1, v2, v3) < 0)
+		tst_brk(TWARN, "Kernel is older than minimal supported %s", TST_MIN_KVER);
+}

@Cyril @Petr I'm wondering if this should be tst_res(TWARN, ..) instead.

--
Andrea Cervesato
SUSE QE Automation Engineer Linux
[email protected]

Signature · 1 line
Mailing list info: https://lists.linux.it/listinfo/ltp
#6 lore raw

Hi!

Quoted 6 lines

lib/tst_test.c static bool check_kver(const char *min_kver, const int brk_nosupp) · line 1103

Quoted 4 lines
lib/tst_test.c +4 -0
+
+	if (tst_kvercmp(v1, v2, v3) < 0)
+		tst_brk(TWARN, "Kernel is older than minimal supported %s", TST_MIN_KVER);
+}

@Cyril @Petr I'm wondering if this should be tst_res(TWARN, ..) instead.

Sorry missed that, yes, that was the point I was trying to make, that this shouldn't exit the test. Only produce a message.

Signature · 5 lines
Cyril Hrubis
[email protected]

-- 
Mailing list info: https://lists.linux.it/listinfo/ltp
#7 lore raw
In reply to Cyril Hrubis
Quoted 10 lines

Hi!

Quoted 6 lines

lib/tst_test.c static bool check_kver(const char *min_kver, const int brk_nosupp) · line 1103

Quoted 4 lines
lib/tst_test.c +4 -0
+
+	if (tst_kvercmp(v1, v2, v3) < 0)
+		tst_brk(TWARN, "Kernel is older than minimal supported %s", TST_MIN_KVER);
+}

@Cyril @Petr I'm wondering if this should be tst_res(TWARN, ..) instead.

Sorry missed that, yes, that was the point I was trying to make, that this shouldn't exit the test. Only produce a message.

As I pointed in v1 even tst_res(TWARN) might be too aggressive as it makes all tests exit with 4 (=> non-zero) due TWARN.

tst_res(TINFO, "WARNING: ...") would not do that and still warn users.

But since we at SUSE are probably the users of the oldest kernels we don't have to worry that much. (+ I know it's already merged.)

Kind regards,
Petr

Signature · 1 line
Mailing list info: https://lists.linux.it/listinfo/ltp