1 // SPDX-License-Identifier: GPL-2.0
3 #include <linux/reboot.h>
4 #include <kunit/test.h>
5 #include <linux/glob.h>
6 #include <linux/moduleparam.h>
9 * These symbols point to the .kunit_test_suites section and are defined in
10 * include/asm-generic/vmlinux.lds.h, and consequently must be extern.
12 extern struct kunit_suite * const __kunit_suites_start[];
13 extern struct kunit_suite * const __kunit_suites_end[];
15 #if IS_BUILTIN(CONFIG_KUNIT)
17 static char *filter_glob_param;
18 static char *action_param;
20 module_param_named(filter_glob, filter_glob_param, charp, 0);
21 MODULE_PARM_DESC(filter_glob,
22 "Filter which KUnit test suites/tests run at boot-time, e.g. list* or list*.*del_test");
23 module_param_named(action, action_param, charp, 0);
24 MODULE_PARM_DESC(action,
25 "Changes KUnit executor behavior, valid values are:\n"
26 "<none>: run the tests like normal\n"
27 "'list' to list test names instead of running them.\n");
29 /* glob_match() needs NULL terminated strings, so we need a copy of filter_glob_param. */
30 struct kunit_test_filter {
35 /* Split "suite_glob.test_glob" into two. Assumes filter_glob is not empty. */
36 static void kunit_parse_filter_glob(struct kunit_test_filter *parsed,
37 const char *filter_glob)
39 const int len = strlen(filter_glob);
40 const char *period = strchr(filter_glob, '.');
43 parsed->suite_glob = kzalloc(len + 1, GFP_KERNEL);
44 parsed->test_glob = NULL;
45 strcpy(parsed->suite_glob, filter_glob);
49 parsed->suite_glob = kzalloc(period - filter_glob + 1, GFP_KERNEL);
50 parsed->test_glob = kzalloc(len - (period - filter_glob) + 1, GFP_KERNEL);
52 strncpy(parsed->suite_glob, filter_glob, period - filter_glob);
53 strncpy(parsed->test_glob, period + 1, len - (period - filter_glob));
56 /* Create a copy of suite with only tests that match test_glob. */
57 static struct kunit_suite *
58 kunit_filter_tests(const struct kunit_suite *const suite, const char *test_glob)
61 struct kunit_case *filtered, *test_case;
62 struct kunit_suite *copy;
64 kunit_suite_for_each_test_case(suite, test_case) {
65 if (!test_glob || glob_match(test_glob, test_case->name))
72 copy = kmemdup(suite, sizeof(*copy), GFP_KERNEL);
74 return ERR_PTR(-ENOMEM);
76 filtered = kcalloc(n + 1, sizeof(*filtered), GFP_KERNEL);
78 return ERR_PTR(-ENOMEM);
81 kunit_suite_for_each_test_case(suite, test_case) {
82 if (!test_glob || glob_match(test_glob, test_case->name))
83 filtered[n++] = *test_case;
86 copy->test_cases = filtered;
90 static char *kunit_shutdown;
91 core_param(kunit_shutdown, kunit_shutdown, charp, 0644);
93 /* Stores an array of suites, end points one past the end */
95 struct kunit_suite * const *start;
96 struct kunit_suite * const *end;
99 static void kunit_free_suite_set(struct suite_set suite_set)
101 struct kunit_suite * const *suites;
103 for (suites = suite_set.start; suites < suite_set.end; suites++)
105 kfree(suite_set.start);
108 static struct suite_set kunit_filter_suites(const struct suite_set *suite_set,
109 const char *filter_glob,
113 struct kunit_suite **copy, *filtered_suite;
114 struct suite_set filtered;
115 struct kunit_test_filter filter;
117 const size_t max = suite_set->end - suite_set->start;
119 copy = kmalloc_array(max, sizeof(*filtered.start), GFP_KERNEL);
120 filtered.start = copy;
121 if (!copy) { /* won't be able to run anything, return an empty set */
126 kunit_parse_filter_glob(&filter, filter_glob);
128 for (i = 0; &suite_set->start[i] != suite_set->end; i++) {
129 if (!glob_match(filter.suite_glob, suite_set->start[i]->name))
132 filtered_suite = kunit_filter_tests(suite_set->start[i], filter.test_glob);
133 if (IS_ERR(filtered_suite)) {
134 *err = PTR_ERR(filtered_suite);
140 *copy++ = filtered_suite;
144 kfree(filter.suite_glob);
145 kfree(filter.test_glob);
149 static void kunit_handle_shutdown(void)
154 if (!strcmp(kunit_shutdown, "poweroff"))
156 else if (!strcmp(kunit_shutdown, "halt"))
158 else if (!strcmp(kunit_shutdown, "reboot"))
159 kernel_restart(NULL);
163 static void kunit_exec_run_tests(struct suite_set *suite_set)
165 size_t num_suites = suite_set->end - suite_set->start;
167 pr_info("TAP version 14\n");
168 pr_info("1..%zu\n", num_suites);
170 __kunit_test_suites_init(suite_set->start, num_suites);
173 static void kunit_exec_list_tests(struct suite_set *suite_set)
175 struct kunit_suite * const *suites;
176 struct kunit_case *test_case;
178 /* Hack: print a tap header so kunit.py can find the start of KUnit output. */
179 pr_info("TAP version 14\n");
181 for (suites = suite_set->start; suites < suite_set->end; suites++)
182 kunit_suite_for_each_test_case((*suites), test_case) {
183 pr_info("%s.%s\n", (*suites)->name, test_case->name);
187 int kunit_run_all_tests(void)
189 struct suite_set suite_set = {__kunit_suites_start, __kunit_suites_end};
192 if (filter_glob_param) {
193 suite_set = kunit_filter_suites(&suite_set, filter_glob_param, &err);
195 pr_err("kunit executor: error filtering suites: %d\n", err);
201 kunit_exec_run_tests(&suite_set);
202 else if (strcmp(action_param, "list") == 0)
203 kunit_exec_list_tests(&suite_set);
205 pr_err("kunit executor: unknown action '%s'\n", action_param);
207 if (filter_glob_param) { /* a copy was made of each suite */
208 kunit_free_suite_set(suite_set);
212 kunit_handle_shutdown();
216 #if IS_BUILTIN(CONFIG_KUNIT_TEST)
217 #include "executor_test.c"
220 #endif /* IS_BUILTIN(CONFIG_KUNIT) */