1 # 1 #
2 # KUnit base configuration 2 # KUnit base configuration
3 # 3 #
4 4
5 menuconfig KUNIT 5 menuconfig KUNIT
6 tristate "KUnit - Enable support for u 6 tristate "KUnit - Enable support for unit tests"
7 select GLOB 7 select GLOB
8 help 8 help
9 Enables support for kernel unit test 9 Enables support for kernel unit tests (KUnit), a lightweight unit
10 testing and mocking framework for th 10 testing and mocking framework for the Linux kernel. These tests are
11 able to be run locally on a develope 11 able to be run locally on a developer's workstation without a VM or
12 special hardware when using UML. Can 12 special hardware when using UML. Can also be used on most other
13 architectures. For more information, 13 architectures. For more information, please see
14 Documentation/dev-tools/kunit/. 14 Documentation/dev-tools/kunit/.
15 15
16 if KUNIT 16 if KUNIT
17 17
18 config KUNIT_DEBUGFS 18 config KUNIT_DEBUGFS
19 bool "KUnit - Enable /sys/kernel/debug 19 bool "KUnit - Enable /sys/kernel/debug/kunit debugfs representation" if !KUNIT_ALL_TESTS
20 default KUNIT_ALL_TESTS 20 default KUNIT_ALL_TESTS
21 help 21 help
22 Enable debugfs representation for ku 22 Enable debugfs representation for kunit. Currently this consists
23 of /sys/kernel/debug/kunit/<test_sui 23 of /sys/kernel/debug/kunit/<test_suite>/results files for each
24 test suite, which allow users to see 24 test suite, which allow users to see results of the last test suite
25 run that occurred. 25 run that occurred.
26 26
27 config KUNIT_FAULT_TEST <<
28 bool "Enable KUnit tests which print B <<
29 depends on KUNIT_TEST <<
30 depends on !UML <<
31 default y <<
32 help <<
33 Enables fault handling tests for the <<
34 trigger a kernel BUG(), and the asso <<
35 pass. If this conflicts with your te <<
36 or annoying), they can be disabled b <<
37 <<
38 config KUNIT_TEST 27 config KUNIT_TEST
39 tristate "KUnit test for KUnit" if !KU 28 tristate "KUnit test for KUnit" if !KUNIT_ALL_TESTS
40 default KUNIT_ALL_TESTS 29 default KUNIT_ALL_TESTS
41 help 30 help
42 Enables the unit tests for the KUnit 31 Enables the unit tests for the KUnit test framework. These tests test
43 the KUnit test framework itself; the 32 the KUnit test framework itself; the tests are both written using
44 KUnit and test KUnit. This option sh 33 KUnit and test KUnit. This option should only be enabled for testing
45 purposes by developers interested in 34 purposes by developers interested in testing that KUnit works as
46 expected. 35 expected.
47 36
48 config KUNIT_EXAMPLE_TEST 37 config KUNIT_EXAMPLE_TEST
49 tristate "Example test for KUnit" if ! 38 tristate "Example test for KUnit" if !KUNIT_ALL_TESTS
50 default KUNIT_ALL_TESTS 39 default KUNIT_ALL_TESTS
51 help 40 help
52 Enables an example unit test that il 41 Enables an example unit test that illustrates some of the basic
53 features of KUnit. This test only ex 42 features of KUnit. This test only exists to help new users understand
54 what KUnit is and how it is used. Pl 43 what KUnit is and how it is used. Please refer to the example test
55 itself, lib/kunit/example-test.c, fo 44 itself, lib/kunit/example-test.c, for more information. This option
56 is intended for curious hackers who 45 is intended for curious hackers who would like to understand how to
57 use KUnit for kernel development. 46 use KUnit for kernel development.
58 47
59 config KUNIT_ALL_TESTS 48 config KUNIT_ALL_TESTS
60 tristate "All KUnit tests with satisfi 49 tristate "All KUnit tests with satisfied dependencies"
61 help 50 help
62 Enables all KUnit tests, if they can 51 Enables all KUnit tests, if they can be enabled.
63 KUnit tests run during boot and outp 52 KUnit tests run during boot and output the results to the debug log
64 in TAP format (http://testanything.o 53 in TAP format (http://testanything.org/). Only useful for kernel devs
65 running the KUnit test harness, and 54 running the KUnit test harness, and not intended for inclusion into a
66 production build. 55 production build.
67 56
68 For more information on KUnit and un 57 For more information on KUnit and unit tests in general please refer
69 to the KUnit documentation in Docume 58 to the KUnit documentation in Documentation/dev-tools/kunit/.
70 59
71 If unsure, say N. 60 If unsure, say N.
72 61
73 config KUNIT_DEFAULT_ENABLED 62 config KUNIT_DEFAULT_ENABLED
74 bool "Default value of kunit.enable" 63 bool "Default value of kunit.enable"
75 default y 64 default y
76 help 65 help
77 Sets the default value of kunit.enab 66 Sets the default value of kunit.enable. If set to N then KUnit
78 tests will not execute unless kunit. 67 tests will not execute unless kunit.enable=1 is passed to the
79 kernel command line. 68 kernel command line.
80 69
81 In most cases this should be left as 70 In most cases this should be left as Y. Only if additional opt-in
82 behavior is needed should this be se 71 behavior is needed should this be set to N.
83 72
84 endif # KUNIT 73 endif # KUNIT
Linux® is a registered trademark of Linus Torvalds in the United States and other countries.
TOMOYO® is a registered trademark of NTT DATA CORPORATION.