root/tools/testing/selftests/kselftest_module.h
/* SPDX-License-Identifier: GPL-2.0+ */
#ifndef __KSELFTEST_MODULE_H
#define __KSELFTEST_MODULE_H

#include <linux/module.h>
#include <linux/panic.h>

/*
 * Test framework for writing test modules to be loaded by kselftest.
 * See Documentation/dev-tools/kselftest.rst for an example test module.
 */

#define KSTM_MODULE_GLOBALS()                   \
static unsigned int total_tests __initdata;     \
static unsigned int failed_tests __initdata;    \
static unsigned int skipped_tests __initdata

#define KSTM_CHECK_ZERO(x) do {                                         \
        total_tests++;                                                  \
        if (x) {                                                        \
                pr_warn("TC failed at %s:%d\n", __func__, __LINE__);    \
                failed_tests++;                                         \
        }                                                               \
} while (0)

static inline int kstm_report(unsigned int total_tests, unsigned int failed_tests,
                              unsigned int skipped_tests)
{
        if (failed_tests == 0) {
                if (skipped_tests) {
                        pr_info("skipped %u tests\n", skipped_tests);
                        pr_info("remaining %u tests passed\n", total_tests);
                } else
                        pr_info("all %u tests passed\n", total_tests);
        } else
                pr_warn("failed %u out of %u tests\n", failed_tests, total_tests);

        return failed_tests ? -EINVAL : 0;
}

#define KSTM_MODULE_LOADERS(__module)                   \
static int __init __module##_init(void)                 \
{                                                       \
        pr_info("loaded.\n");                           \
        add_taint(TAINT_TEST, LOCKDEP_STILL_OK);        \
        selftest();                                     \
        return kstm_report(total_tests, failed_tests, skipped_tests);   \
}                                                       \
static void __exit __module##_exit(void)                \
{                                                       \
        pr_info("unloaded.\n");                         \
}                                                       \
module_init(__module##_init);                           \
module_exit(__module##_exit)

MODULE_INFO(test, "Y");

#endif  /* __KSELFTEST_MODULE_H */