]> git.ipfire.org Git - thirdparty/linux.git/blame - lib/Kconfig.ubsan
ARM: tegra: Reuse I2C3 for NVEC
[thirdparty/linux.git] / lib / Kconfig.ubsan
CommitLineData
ec8f24b7 1# SPDX-License-Identifier: GPL-2.0-only
c6d30853
AR
2config ARCH_HAS_UBSAN_SANITIZE_ALL
3 bool
4
277a1085 5menuconfig UBSAN
c6d30853
AR
6 bool "Undefined behaviour sanity checker"
7 help
0887a7eb 8 This option enables the Undefined Behaviour sanity checker.
c6d30853 9 Compile-time instrumentation is used to detect various undefined
0887a7eb
KC
10 behaviours at runtime. For more details, see:
11 Documentation/dev-tools/ubsan.rst
12
277a1085
KC
13if UBSAN
14
0887a7eb
KC
15config UBSAN_TRAP
16 bool "On Sanitizer warnings, abort the running kernel code"
79791378 17 depends on !COMPILE_TEST
0887a7eb
KC
18 help
19 Building kernels with Sanitizer features enabled tends to grow
20 the kernel size by around 5%, due to adding all the debugging
21 text on failure paths. To avoid this, Sanitizer instrumentation
22 can just issue a trap. This reduces the kernel size overhead but
23 turns all warnings (including potentially harmless conditions)
24 into full exceptions that abort the running kernel code
25 (regardless of context, locks held, etc), which may destabilize
26 the system. For some system builders this is an acceptable
27 trade-off.
c6d30853 28
2d47c695
KC
29config CC_HAS_UBSAN_BOUNDS_STRICT
30 def_bool $(cc-option,-fsanitize=bounds-strict)
31 help
32 The -fsanitize=bounds-strict option is only available on GCC,
33 but uses the more strict handling of arrays that includes knowledge
34 of flexible arrays, which is comparable to Clang's regular
35 -fsanitize=bounds.
cdf8a76f
KC
36
37config CC_HAS_UBSAN_ARRAY_BOUNDS
38 def_bool $(cc-option,-fsanitize=array-bounds)
2d47c695
KC
39 help
40 Under Clang, the -fsanitize=bounds option is actually composed
41 of two more specific options, -fsanitize=array-bounds and
42 -fsanitize=local-bounds. However, -fsanitize=local-bounds can
43 only be used when trap mode is enabled. (See also the help for
44 CONFIG_LOCAL_BOUNDS.) Explicitly check for -fsanitize=array-bounds
45 so that we can build up the options needed for UBSAN_BOUNDS
46 with or without UBSAN_TRAP.
cdf8a76f 47
277a1085
KC
48config UBSAN_BOUNDS
49 bool "Perform array index bounds checking"
50 default UBSAN
2d47c695 51 depends on CC_HAS_UBSAN_ARRAY_BOUNDS || CC_HAS_UBSAN_BOUNDS_STRICT
277a1085
KC
52 help
53 This option enables detection of directly indexed out of bounds
54 array accesses, where the array size is known at compile time.
55 Note that this does not protect array overflows via bad calls
56 to the {str,mem}*cpy() family of functions (that is addressed
57 by CONFIG_FORTIFY_SOURCE).
58
2d47c695
KC
59config UBSAN_BOUNDS_STRICT
60 def_bool UBSAN_BOUNDS && CC_HAS_UBSAN_BOUNDS_STRICT
cdf8a76f 61 help
2d47c695
KC
62 GCC's bounds sanitizer. This option is used to select the
63 correct options in Makefile.ubsan.
cdf8a76f
KC
64
65config UBSAN_ARRAY_BOUNDS
2d47c695
KC
66 def_bool UBSAN_BOUNDS && CC_HAS_UBSAN_ARRAY_BOUNDS
67 help
68 Clang's array bounds sanitizer. This option is used to select
69 the correct options in Makefile.ubsan.
cdf8a76f 70
6a6155f6 71config UBSAN_LOCAL_BOUNDS
2d47c695 72 def_bool UBSAN_ARRAY_BOUNDS && UBSAN_TRAP
6a6155f6 73 help
2d47c695
KC
74 This option enables Clang's -fsanitize=local-bounds which traps
75 when an access through a pointer that is derived from an object
76 of a statically-known size, where an added offset (which may not
77 be known statically) is out-of-bounds. Since this option is
78 trap-only, it depends on CONFIG_UBSAN_TRAP.
6a6155f6 79
cdf8a76f 80config UBSAN_SHIFT
c637693b
KC
81 bool "Perform checking for bit-shift overflows"
82 default UBSAN
cdf8a76f 83 depends on $(cc-option,-fsanitize=shift)
c637693b
KC
84 help
85 This option enables -fsanitize=shift which checks for bit-shift
86 operations that overflow to the left or go switch to negative
87 for signed types.
cdf8a76f
KC
88
89config UBSAN_DIV_ZERO
c637693b 90 bool "Perform checking for integer divide-by-zero"
cdf8a76f 91 depends on $(cc-option,-fsanitize=integer-divide-by-zero)
e5d523f1
ND
92 # https://github.com/ClangBuiltLinux/linux/issues/1657
93 # https://github.com/llvm/llvm-project/issues/56289
94 depends on !CC_IS_CLANG
c637693b
KC
95 help
96 This option enables -fsanitize=integer-divide-by-zero which checks
97 for integer division by zero. This is effectively redundant with the
98 kernel's existing exception handling, though it can provide greater
99 debugging information under CONFIG_UBSAN_REPORT_FULL.
cdf8a76f
KC
100
101config UBSAN_UNREACHABLE
c637693b
KC
102 bool "Perform checking for unreachable code"
103 # objtool already handles unreachable checking and gets angry about
104 # seeing UBSan instrumentation located in unreachable places.
c2f75a43 105 depends on !(OBJTOOL && (STACK_VALIDATION || UNWINDER_ORC || HAVE_UACCESS_VALIDATION))
cdf8a76f 106 depends on $(cc-option,-fsanitize=unreachable)
c637693b
KC
107 help
108 This option enables -fsanitize=unreachable which checks for control
109 flow reaching an expected-to-be-unreachable position.
cdf8a76f 110
cdf8a76f 111config UBSAN_BOOL
c637693b
KC
112 bool "Perform checking for non-boolean values used as boolean"
113 default UBSAN
cdf8a76f 114 depends on $(cc-option,-fsanitize=bool)
c637693b
KC
115 help
116 This option enables -fsanitize=bool which checks for boolean values being
117 loaded that are neither 0 nor 1.
cdf8a76f
KC
118
119config UBSAN_ENUM
c637693b
KC
120 bool "Perform checking for out of bounds enum values"
121 default UBSAN
cdf8a76f 122 depends on $(cc-option,-fsanitize=enum)
c637693b
KC
123 help
124 This option enables -fsanitize=enum which checks for values being loaded
125 into an enum that are outside the range of given values for the given enum.
126
127config UBSAN_ALIGNMENT
128 bool "Perform checking for misaligned pointer usage"
129 default !HAVE_EFFICIENT_UNALIGNED_ACCESS
130 depends on !UBSAN_TRAP && !COMPILE_TEST
131 depends on $(cc-option,-fsanitize=alignment)
132 help
133 This option enables the check of unaligned memory accesses.
134 Enabling this option on architectures that support unaligned
135 accesses may produce a lot of false positives.
cdf8a76f 136
c6d30853
AR
137config UBSAN_SANITIZE_ALL
138 bool "Enable instrumentation for the entire kernel"
c6d30853
AR
139 depends on ARCH_HAS_UBSAN_SANITIZE_ALL
140 default y
141 help
142 This option activates instrumentation for the entire kernel.
143 If you don't enable this option, you have to explicitly specify
144 UBSAN_SANITIZE := y for the files/directories you want to check for UB.
7707535a
YS
145 Enabling this option will get kernel image size increased
146 significantly.
c6d30853 147
854686f4
JP
148config TEST_UBSAN
149 tristate "Module for testing for undefined behavior detection"
277a1085 150 depends on m
854686f4
JP
151 help
152 This is a test module for UBSAN.
153 It triggers various undefined behavior, and detect it.
277a1085
KC
154
155endif # if UBSAN