[PATCH RFC 1/4] selftests: harness: Move metadata structs to separate header file
From: Ackerley Tng
Date: Tue Apr 14 2026 - 14:08:27 EST
Move metadata structs to separate header file so that the structs can be
referenced without importing all the static functions, such as
test_harness_run.
Signed-off-by: Ackerley Tng <ackerleytng@xxxxxxxxxx>
---
tools/testing/selftests/kselftest_harness.h | 47 +------------------
.../testing/selftests/kselftest_harness_structs.h | 53 ++++++++++++++++++++++
2 files changed, 55 insertions(+), 45 deletions(-)
diff --git a/tools/testing/selftests/kselftest_harness.h b/tools/testing/selftests/kselftest_harness.h
index 4afaef01c22e9..68cde1556ac41 100644
--- a/tools/testing/selftests/kselftest_harness.h
+++ b/tools/testing/selftests/kselftest_harness.h
@@ -68,6 +68,7 @@
#include <sys/wait.h>
#include <unistd.h>
+#include "kselftest_harness_structs.h"
#include "kselftest.h"
static inline void __kselftest_memset_safe(void *s, int c, size_t n)
@@ -845,27 +846,11 @@ struct __test_results {
char reason[1024]; /* Reason for test result */
};
-struct __test_metadata;
-struct __fixture_variant_metadata;
-
-/* Contains all the information about a fixture. */
-struct __fixture_metadata {
- const char *name;
- struct __test_metadata *tests;
- struct __fixture_variant_metadata *variant;
- struct __fixture_metadata *prev, *next;
-} _fixture_global __attribute__((unused)) = {
+struct __fixture_metadata _fixture_global __attribute__((unused)) = {
.name = "global",
.prev = &_fixture_global,
};
-struct __test_xfail {
- struct __fixture_metadata *fixture;
- struct __fixture_variant_metadata *variant;
- struct __test_metadata *test;
- struct __test_xfail *prev, *next;
-};
-
/**
* XFAIL_ADD() - mark variant + test case combination as expected to fail
* @fixture_name: name of the fixture
@@ -899,13 +884,6 @@ static inline void __register_fixture(struct __fixture_metadata *f)
__LIST_APPEND(__fixture_list, f);
}
-struct __fixture_variant_metadata {
- const char *name;
- const void *data;
- struct __test_xfail *xfails;
- struct __fixture_variant_metadata *prev, *next;
-};
-
static inline void
__register_fixture_variant(struct __fixture_metadata *f,
struct __fixture_variant_metadata *variant)
@@ -913,27 +891,6 @@ __register_fixture_variant(struct __fixture_metadata *f,
__LIST_APPEND(f->variant, variant);
}
-/* Contains all the information for test execution and status checking. */
-struct __test_metadata {
- const char *name;
- void (*fn)(struct __test_metadata *,
- struct __fixture_variant_metadata *);
- pid_t pid; /* pid of test when being run */
- struct __fixture_metadata *fixture;
- void (*teardown_fn)(bool in_parent, struct __test_metadata *_metadata,
- void *self, const void *variant);
- int termsig;
- int exit_code;
- int trigger; /* extra handler after the evaluation */
- int timeout; /* seconds to wait for test timeout */
- bool aborted; /* stopped test due to failed ASSERT */
- bool *no_teardown; /* fixture needs teardown */
- void *self;
- const void *variant;
- struct __test_results *results;
- struct __test_metadata *prev, *next;
-};
-
static inline bool __test_passed(struct __test_metadata *metadata)
{
return metadata->exit_code != KSFT_FAIL &&
diff --git a/tools/testing/selftests/kselftest_harness_structs.h b/tools/testing/selftests/kselftest_harness_structs.h
new file mode 100644
index 0000000000000..cf9d15ad3de0c
--- /dev/null
+++ b/tools/testing/selftests/kselftest_harness_structs.h
@@ -0,0 +1,53 @@
+#ifndef __KSELFTEST_HARNESS_STRUCTS_H
+#define __KSELFTEST_HARNESS_STRUCTS_H
+
+#include <stdbool.h>
+#include <sys/types.h>
+
+struct __test_metadata;
+struct __fixture_variant_metadata;
+
+/* Contains all the information about a fixture. */
+struct __fixture_metadata {
+ const char *name;
+ struct __test_metadata *tests;
+ struct __fixture_variant_metadata *variant;
+ struct __fixture_metadata *prev, *next;
+};
+
+struct __test_xfail {
+ struct __fixture_metadata *fixture;
+ struct __fixture_variant_metadata *variant;
+ struct __test_metadata *test;
+ struct __test_xfail *prev, *next;
+};
+
+struct __fixture_variant_metadata {
+ const char *name;
+ const void *data;
+ struct __test_xfail *xfails;
+ struct __fixture_variant_metadata *prev, *next;
+};
+
+/* Contains all the information for test execution and status checking. */
+struct __test_metadata {
+ const char *name;
+ void (*fn)(struct __test_metadata *,
+ struct __fixture_variant_metadata *);
+ pid_t pid; /* pid of test when being run */
+ struct __fixture_metadata *fixture;
+ void (*teardown_fn)(bool in_parent, struct __test_metadata *_metadata,
+ void *self, const void *variant);
+ int termsig;
+ int exit_code;
+ int trigger; /* extra handler after the evaluation */
+ int timeout; /* seconds to wait for test timeout */
+ bool aborted; /* stopped test due to failed ASSERT */
+ bool *no_teardown; /* fixture needs teardown */
+ void *self;
+ const void *variant;
+ struct __test_results *results;
+ struct __test_metadata *prev, *next;
+};
+
+#endif
--
2.54.0.rc0.605.g598a273b03-goog