1# SPDX-License-Identifier: GPL-2.0-only 2config HAVE_GCC_PLUGINS 3 bool 4 help 5 An arch should select this symbol if it supports building with 6 GCC plugins. 7 8menuconfig GCC_PLUGINS 9 bool "GCC plugins" 10 depends on HAVE_GCC_PLUGINS 11 depends on CC_IS_GCC 12 depends on $(success,test -e $(shell,$(CC) -print-file-name=plugin)/include/plugin-version.h) 13 default y 14 help 15 GCC plugins are loadable modules that provide extra features to the 16 compiler. They are useful for runtime instrumentation and static analysis. 17 18 See Documentation/kbuild/gcc-plugins.rst for details. 19 20if GCC_PLUGINS 21 22config GCC_PLUGIN_CYC_COMPLEXITY 23 bool "Compute the cyclomatic complexity of a function" if EXPERT 24 depends on !COMPILE_TEST # too noisy 25 help 26 The complexity M of a function's control flow graph is defined as: 27 M = E - N + 2P 28 where 29 30 E = the number of edges 31 N = the number of nodes 32 P = the number of connected components (exit nodes). 33 34 Enabling this plugin reports the complexity to stderr during the 35 build. It mainly serves as a simple example of how to create a 36 gcc plugin for the kernel. 37 38config GCC_PLUGIN_SANCOV 39 bool 40 # Plugin can be removed once the kernel only supports GCC 6+ 41 depends on !CC_HAS_SANCOV_TRACE_PC 42 help 43 This plugin inserts a __sanitizer_cov_trace_pc() call at the start of 44 basic blocks. It supports all gcc versions with plugin support (from 45 gcc-4.5 on). It is based on the commit "Add fuzzing coverage support" 46 by Dmitry Vyukov <[email protected]>. 47 48config GCC_PLUGIN_LATENT_ENTROPY 49 bool "Generate some entropy during boot and runtime" 50 help 51 By saying Y here the kernel will instrument some kernel code to 52 extract some entropy from both original and artificially created 53 program state. This will help especially embedded systems where 54 there is little 'natural' source of entropy normally. The cost 55 is some slowdown of the boot process (about 0.5%) and fork and 56 irq processing. 57 58 Note that entropy extracted this way is not cryptographically 59 secure! 60 61 This plugin was ported from grsecurity/PaX. More information at: 62 * https://grsecurity.net/ 63 * https://pax.grsecurity.net/ 64 65config GCC_PLUGIN_RANDSTRUCT 66 bool "Randomize layout of sensitive kernel structures" 67 select MODVERSIONS if MODULES 68 help 69 If you say Y here, the layouts of structures that are entirely 70 function pointers (and have not been manually annotated with 71 __no_randomize_layout), or structures that have been explicitly 72 marked with __randomize_layout, will be randomized at compile-time. 73 This can introduce the requirement of an additional information 74 exposure vulnerability for exploits targeting these structure 75 types. 76 77 Enabling this feature will introduce some performance impact, 78 slightly increase memory usage, and prevent the use of forensic 79 tools like Volatility against the system (unless the kernel 80 source tree isn't cleaned after kernel installation). 81 82 The seed used for compilation is located at 83 scripts/gcc-plugins/randomize_layout_seed.h. It remains after 84 a make clean to allow for external modules to be compiled with 85 the existing seed and will be removed by a make mrproper or 86 make distclean. 87 88 This plugin was ported from grsecurity/PaX. More information at: 89 * https://grsecurity.net/ 90 * https://pax.grsecurity.net/ 91 92config GCC_PLUGIN_RANDSTRUCT_PERFORMANCE 93 bool "Use cacheline-aware structure randomization" 94 depends on GCC_PLUGIN_RANDSTRUCT 95 depends on !COMPILE_TEST # do not reduce test coverage 96 help 97 If you say Y here, the RANDSTRUCT randomization will make a 98 best effort at restricting randomization to cacheline-sized 99 groups of elements. It will further not randomize bitfields 100 in structures. This reduces the performance hit of RANDSTRUCT 101 at the cost of weakened randomization. 102 103config GCC_PLUGIN_ARM_SSP_PER_TASK 104 bool 105 depends on GCC_PLUGINS && ARM 106 107endif 108