1ec8f24b7SThomas Gleixner# SPDX-License-Identifier: GPL-2.0-only 28b59cd81SMasahiro Yamadaconfig CC_VERSION_TEXT 38b59cd81SMasahiro Yamada string 48b59cd81SMasahiro Yamada default "$(CC_VERSION_TEXT)" 58b59cd81SMasahiro Yamada help 68b59cd81SMasahiro Yamada This is used in unclear ways: 78b59cd81SMasahiro Yamada 88b59cd81SMasahiro Yamada - Re-run Kconfig when the compiler is updated 98b59cd81SMasahiro Yamada The 'default' property references the environment variable, 108b59cd81SMasahiro Yamada CC_VERSION_TEXT so it is recorded in include/config/auto.conf.cmd. 118b59cd81SMasahiro Yamada When the compiler is updated, Kconfig will be invoked. 128b59cd81SMasahiro Yamada 13f9c8bc46SBhaskar Chowdhury - Ensure full rebuild when the compiler is updated 14ce6ed1c4SMasahiro Yamada include/linux/compiler-version.h contains this option in the comment 150e0345b7SAlexey Dobriyan line so fixdep adds include/config/CC_VERSION_TEXT into the 16ce6ed1c4SMasahiro Yamada auto-generated dependency. When the compiler is updated, syncconfig 17ce6ed1c4SMasahiro Yamada will touch it and then every file will be rebuilt. 188b59cd81SMasahiro Yamada 19a4353898SMasahiro Yamadaconfig CC_IS_GCC 20aec6c60aSMasahiro Yamada def_bool $(success,test "$(cc-name)" = GCC) 21a4353898SMasahiro Yamada 22a4353898SMasahiro Yamadaconfig GCC_VERSION 23a4353898SMasahiro Yamada int 24aec6c60aSMasahiro Yamada default $(cc-version) if CC_IS_GCC 25a4353898SMasahiro Yamada default 0 26a4353898SMasahiro Yamada 27469cb737SMasahiro Yamadaconfig CC_IS_CLANG 28aec6c60aSMasahiro Yamada def_bool $(success,test "$(cc-name)" = Clang) 29b744b43fSSami Tolvanen 30469cb737SMasahiro Yamadaconfig CLANG_VERSION 31469cb737SMasahiro Yamada int 32aec6c60aSMasahiro Yamada default $(cc-version) if CC_IS_CLANG 33aec6c60aSMasahiro Yamada default 0 34469cb737SMasahiro Yamada 35ba64beb1SMasahiro Yamadaconfig AS_IS_GNU 36ba64beb1SMasahiro Yamada def_bool $(success,test "$(as-name)" = GNU) 37ba64beb1SMasahiro Yamada 38ba64beb1SMasahiro Yamadaconfig AS_IS_LLVM 39ba64beb1SMasahiro Yamada def_bool $(success,test "$(as-name)" = LLVM) 40ba64beb1SMasahiro Yamada 41ba64beb1SMasahiro Yamadaconfig AS_VERSION 42ba64beb1SMasahiro Yamada int 43ba64beb1SMasahiro Yamada # Use clang version if this is the integrated assembler 44ba64beb1SMasahiro Yamada default CLANG_VERSION if AS_IS_LLVM 45ba64beb1SMasahiro Yamada default $(as-version) 46ba64beb1SMasahiro Yamada 4702aff859SMasahiro Yamadaconfig LD_IS_BFD 4802aff859SMasahiro Yamada def_bool $(success,test "$(ld-name)" = BFD) 4902aff859SMasahiro Yamada 5002aff859SMasahiro Yamadaconfig LD_VERSION 5102aff859SMasahiro Yamada int 5202aff859SMasahiro Yamada default $(ld-version) if LD_IS_BFD 5302aff859SMasahiro Yamada default 0 5402aff859SMasahiro Yamada 5502aff859SMasahiro Yamadaconfig LD_IS_LLD 5602aff859SMasahiro Yamada def_bool $(success,test "$(ld-name)" = LLD) 57c65eacbeSAndy Lutomirski 58d5750cd3SNathan Chancellorconfig LLD_VERSION 59d5750cd3SNathan Chancellor int 6002aff859SMasahiro Yamada default $(ld-version) if LD_IS_LLD 6102aff859SMasahiro Yamada default 0 62d5750cd3SNathan Chancellor 631a927fd3SMasahiro Yamadaconfig CC_CAN_LINK 649371f86eSMasahiro Yamada bool 65f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag)) if 64BIT 66f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag)) 671a927fd3SMasahiro Yamada 68b1183b6dSMasahiro Yamadaconfig CC_CAN_LINK_STATIC 69b1183b6dSMasahiro Yamada bool 70f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag) -static) if 64BIT 71f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag) -static) 72c65eacbeSAndy Lutomirski 73e9666d10SMasahiro Yamadaconfig CC_HAS_ASM_GOTO 74e9666d10SMasahiro Yamada def_bool $(success,$(srctree)/scripts/gcc-goto.sh $(CC)) 75e9666d10SMasahiro Yamada 76587f1701SNick Desaulniersconfig CC_HAS_ASM_GOTO_OUTPUT 77587f1701SNick Desaulniers depends on CC_HAS_ASM_GOTO 78587f1701SNick Desaulniers def_bool $(success,echo 'int foo(int x) { asm goto ("": "=r"(x) ::: bar); return x; bar: return 0; }' | $(CC) -x c - -c -o /dev/null) 79587f1701SNick Desaulniers 80*1aa0e8b1SSean Christophersonconfig CC_HAS_ASM_GOTO_TIED_OUTPUT 81*1aa0e8b1SSean Christopherson depends on CC_HAS_ASM_GOTO_OUTPUT 82*1aa0e8b1SSean Christopherson # Detect buggy gcc and clang, fixed in gcc-11 clang-14. 83*1aa0e8b1SSean Christopherson def_bool $(success,echo 'int foo(int *x) { asm goto (".long (%l[bar]) - .\n": "+m"(*x) ::: bar); return *x; bar: return 0; }' | $CC -x c - -c -o /dev/null) 84*1aa0e8b1SSean Christopherson 855cf896fbSPeter Collingbourneconfig TOOLS_SUPPORT_RELR 862d122942SWill Deacon def_bool $(success,env "CC=$(CC)" "LD=$(LD)" "NM=$(NM)" "OBJCOPY=$(OBJCOPY)" $(srctree)/scripts/tools-support-relr.sh) 875cf896fbSPeter Collingbourne 88eb111869SRasmus Villemoesconfig CC_HAS_ASM_INLINE 89eb111869SRasmus Villemoes def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null) 90eb111869SRasmus Villemoes 9151c2ee6dSNick Desaulniersconfig CC_HAS_NO_PROFILE_FN_ATTR 9251c2ee6dSNick Desaulniers def_bool $(success,echo '__attribute__((no_profile_instrument_function)) int x();' | $(CC) -x c - -c -o /dev/null -Werror) 9351c2ee6dSNick Desaulniers 94613fe169SNathan Chancellorconfig PAHOLE_VERSION 95613fe169SNathan Chancellor int 96613fe169SNathan Chancellor default $(shell,$(srctree)/scripts/pahole-version.sh $(PAHOLE)) 97613fe169SNathan Chancellor 98b99b87f7SPeter Oberparleiterconfig CONSTRUCTORS 99b99b87f7SPeter Oberparleiter bool 100b99b87f7SPeter Oberparleiter 101e360adbeSPeter Zijlstraconfig IRQ_WORK 102e360adbeSPeter Zijlstra bool 103e360adbeSPeter Zijlstra 10410916706SShile Zhangconfig BUILDTIME_TABLE_SORT 1051dbdc6f1SDavid Daney bool 1061dbdc6f1SDavid Daney 107c65eacbeSAndy Lutomirskiconfig THREAD_INFO_IN_TASK 108c65eacbeSAndy Lutomirski bool 109c65eacbeSAndy Lutomirski help 110c65eacbeSAndy Lutomirski Select this to move thread_info off the stack into task_struct. To 111c65eacbeSAndy Lutomirski make this work, an arch will need to remove all thread_info fields 112c65eacbeSAndy Lutomirski except flags and fix any runtime bugs. 113c65eacbeSAndy Lutomirski 114c6c314a6SAndy Lutomirski One subtle change that will be needed is to use try_get_task_stack() 115c6c314a6SAndy Lutomirski and put_task_stack() in save_thread_stack_tsk() and get_wchan(). 116c6c314a6SAndy Lutomirski 117ff0cfc66SAl Boldimenu "General setup" 1181da177e4SLinus Torvalds 1191da177e4SLinus Torvaldsconfig BROKEN 1201da177e4SLinus Torvalds bool 1211da177e4SLinus Torvalds 1221da177e4SLinus Torvaldsconfig BROKEN_ON_SMP 1231da177e4SLinus Torvalds bool 1241da177e4SLinus Torvalds depends on BROKEN || !SMP 1251da177e4SLinus Torvalds default y 1261da177e4SLinus Torvalds 1271da177e4SLinus Torvaldsconfig INIT_ENV_ARG_LIMIT 1281da177e4SLinus Torvalds int 129dd673bcaSAdrian Bunk default 32 if !UML 130dd673bcaSAdrian Bunk default 128 if UML 1311da177e4SLinus Torvalds help 13234ad92c2SRandy Dunlap Maximum of each of the number of arguments and environment 13334ad92c2SRandy Dunlap variables passed to init from the kernel command line. 1341da177e4SLinus Torvalds 1354bb16672SJiri Slabyconfig COMPILE_TEST 1364bb16672SJiri Slaby bool "Compile also drivers which will not load" 137ea29b20aSMasahiro Yamada depends on HAS_IOMEM 1384bb16672SJiri Slaby help 1394bb16672SJiri Slaby Some drivers can be compiled on a different platform than they are 1404bb16672SJiri Slaby intended to be run on. Despite they cannot be loaded there (or even 1414bb16672SJiri Slaby when they load they cannot be used due to missing HW support), 1424bb16672SJiri Slaby developers still, opposing to distributors, might want to build such 1434bb16672SJiri Slaby drivers to compile-test them. 1444bb16672SJiri Slaby 1454bb16672SJiri Slaby If you are a developer and want to build everything available, say Y 1464bb16672SJiri Slaby here. If you are a user/distributor, say N here to exclude useless 1474bb16672SJiri Slaby drivers to be distributed. 1484bb16672SJiri Slaby 1493fe617ccSLinus Torvaldsconfig WERROR 1503fe617ccSLinus Torvalds bool "Compile the kernel with warnings as errors" 151b339ec9cSMarco Elver default COMPILE_TEST 1523fe617ccSLinus Torvalds help 1533fe617ccSLinus Torvalds A kernel build should not cause any compiler warnings, and this 1543fe617ccSLinus Torvalds enables the '-Werror' flag to enforce that rule by default. 1553fe617ccSLinus Torvalds 1563fe617ccSLinus Torvalds However, if you have a new (or very old) compiler with odd and 1573fe617ccSLinus Torvalds unusual warnings, or you have some architecture with problems, 1583fe617ccSLinus Torvalds you may need to disable this config option in order to 1593fe617ccSLinus Torvalds successfully build the kernel. 1603fe617ccSLinus Torvalds 1613fe617ccSLinus Torvalds If in doubt, say Y. 1623fe617ccSLinus Torvalds 163d6fc9fcbSMasahiro Yamadaconfig UAPI_HEADER_TEST 164d6fc9fcbSMasahiro Yamada bool "Compile test UAPI headers" 165fcbb8461SMasahiro Yamada depends on HEADERS_INSTALL && CC_CAN_LINK 166d6fc9fcbSMasahiro Yamada help 167d6fc9fcbSMasahiro Yamada Compile test headers exported to user-space to ensure they are 168d6fc9fcbSMasahiro Yamada self-contained, i.e. compilable as standalone units. 169d6fc9fcbSMasahiro Yamada 170d6fc9fcbSMasahiro Yamada If you are a developer or tester and want to ensure the exported 171d6fc9fcbSMasahiro Yamada headers are self-contained, say Y here. Otherwise, choose N. 172d6fc9fcbSMasahiro Yamada 1731da177e4SLinus Torvaldsconfig LOCALVERSION 1741da177e4SLinus Torvalds string "Local version - append to kernel release" 1751da177e4SLinus Torvalds help 1761da177e4SLinus Torvalds Append an extra string to the end of your kernel version. 1771da177e4SLinus Torvalds This will show up when you type uname, for example. 1781da177e4SLinus Torvalds The string you set here will be appended after the contents of 1791da177e4SLinus Torvalds any files with a filename matching localversion* in your 1801da177e4SLinus Torvalds object and source tree, in that order. Your total string can 1811da177e4SLinus Torvalds be a maximum of 64 characters. 1821da177e4SLinus Torvalds 183aaebf433SRyan Andersonconfig LOCALVERSION_AUTO 184aaebf433SRyan Anderson bool "Automatically append version information to the version string" 185aaebf433SRyan Anderson default y 186ac3339baSAlexey Dobriyan depends on !COMPILE_TEST 187aaebf433SRyan Anderson help 188aaebf433SRyan Anderson This will try to automatically determine if the current tree is a 1896e5a5420SRobert P. J. Day release tree by looking for git tags that belong to the current 1906e5a5420SRobert P. J. Day top of tree revision. 191aaebf433SRyan Anderson 192aaebf433SRyan Anderson A string of the format -gxxxxxxxx will be added to the localversion 1936e5a5420SRobert P. J. Day if a git-based tree is found. The string generated by this will be 194aaebf433SRyan Anderson appended after any matching localversion* files, and after the value 1956e5a5420SRobert P. J. Day set in CONFIG_LOCALVERSION. 196aaebf433SRyan Anderson 1976e5a5420SRobert P. J. Day (The actual string used here is the first eight characters produced 1986e5a5420SRobert P. J. Day by running the command: 1996e5a5420SRobert P. J. Day 2006e5a5420SRobert P. J. Day $ git rev-parse --verify HEAD 2016e5a5420SRobert P. J. Day 2026e5a5420SRobert P. J. Day which is done within the script "scripts/setlocalversion".) 203aaebf433SRyan Anderson 2049afb719eSLaura Abbottconfig BUILD_SALT 2059afb719eSLaura Abbott string "Build ID Salt" 2069afb719eSLaura Abbott default "" 2079afb719eSLaura Abbott help 2089afb719eSLaura Abbott The build ID is used to link binaries and their debug info. Setting 2099afb719eSLaura Abbott this option will use the value in the calculation of the build id. 2109afb719eSLaura Abbott This is mostly useful for distributions which want to ensure the 2119afb719eSLaura Abbott build is unique between builds. It's safe to leave the default. 2129afb719eSLaura Abbott 2132e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_GZIP 2142e9f3bddSH. Peter Anvin bool 2152e9f3bddSH. Peter Anvin 2162e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_BZIP2 2172e9f3bddSH. Peter Anvin bool 2182e9f3bddSH. Peter Anvin 2192e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_LZMA 2202e9f3bddSH. Peter Anvin bool 2212e9f3bddSH. Peter Anvin 2223ebe1243SLasse Collinconfig HAVE_KERNEL_XZ 2233ebe1243SLasse Collin bool 2243ebe1243SLasse Collin 2257dd65febSAlbin Tonnerreconfig HAVE_KERNEL_LZO 2267dd65febSAlbin Tonnerre bool 2277dd65febSAlbin Tonnerre 228e76e1fdfSKyungsik Leeconfig HAVE_KERNEL_LZ4 229e76e1fdfSKyungsik Lee bool 230e76e1fdfSKyungsik Lee 23148f7ddf7SNick Terrellconfig HAVE_KERNEL_ZSTD 23248f7ddf7SNick Terrell bool 23348f7ddf7SNick Terrell 234f16466afSVasily Gorbikconfig HAVE_KERNEL_UNCOMPRESSED 235f16466afSVasily Gorbik bool 236f16466afSVasily Gorbik 23730d65dbfSAlain Knaffchoice 23830d65dbfSAlain Knaff prompt "Kernel compression mode" 23930d65dbfSAlain Knaff default KERNEL_GZIP 24048f7ddf7SNick Terrell depends on HAVE_KERNEL_GZIP || HAVE_KERNEL_BZIP2 || HAVE_KERNEL_LZMA || HAVE_KERNEL_XZ || HAVE_KERNEL_LZO || HAVE_KERNEL_LZ4 || HAVE_KERNEL_ZSTD || HAVE_KERNEL_UNCOMPRESSED 24130d65dbfSAlain Knaff help 24230d65dbfSAlain Knaff The linux kernel is a kind of self-extracting executable. 24330d65dbfSAlain Knaff Several compression algorithms are available, which differ 24430d65dbfSAlain Knaff in efficiency, compression and decompression speed. 24530d65dbfSAlain Knaff Compression speed is only relevant when building a kernel. 24630d65dbfSAlain Knaff Decompression speed is relevant at each boot. 24730d65dbfSAlain Knaff 24830d65dbfSAlain Knaff If you have any problems with bzip2 or lzma compressed 24930d65dbfSAlain Knaff kernels, mail me (Alain Knaff) <alain@knaff.lu>. (An older 25030d65dbfSAlain Knaff version of this functionality (bzip2 only), for 2.4, was 25130d65dbfSAlain Knaff supplied by Christian Ludwig) 25230d65dbfSAlain Knaff 25330d65dbfSAlain Knaff High compression options are mostly useful for users, who 25430d65dbfSAlain Knaff are low on disk space (embedded systems), but for whom ram 25530d65dbfSAlain Knaff size matters less. 25630d65dbfSAlain Knaff 25730d65dbfSAlain Knaff If in doubt, select 'gzip' 25830d65dbfSAlain Knaff 25930d65dbfSAlain Knaffconfig KERNEL_GZIP 26030d65dbfSAlain Knaff bool "Gzip" 2612e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_GZIP 26230d65dbfSAlain Knaff help 2637dd65febSAlbin Tonnerre The old and tried gzip compression. It provides a good balance 2647dd65febSAlbin Tonnerre between compression ratio and decompression speed. 26530d65dbfSAlain Knaff 26630d65dbfSAlain Knaffconfig KERNEL_BZIP2 26730d65dbfSAlain Knaff bool "Bzip2" 2682e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_BZIP2 26930d65dbfSAlain Knaff help 27030d65dbfSAlain Knaff Its compression ratio and speed is intermediate. 2710a4dd35cSRandy Dunlap Decompression speed is slowest among the choices. The kernel 2722e9f3bddSH. Peter Anvin size is about 10% smaller with bzip2, in comparison to gzip. 2732e9f3bddSH. Peter Anvin Bzip2 uses a large amount of memory. For modern kernels you 2742e9f3bddSH. Peter Anvin will need at least 8MB RAM or more for booting. 27530d65dbfSAlain Knaff 27630d65dbfSAlain Knaffconfig KERNEL_LZMA 27730d65dbfSAlain Knaff bool "LZMA" 2782e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_LZMA 27930d65dbfSAlain Knaff help 2800a4dd35cSRandy Dunlap This compression algorithm's ratio is best. Decompression speed 2810a4dd35cSRandy Dunlap is between gzip and bzip2. Compression is slowest. 2820a4dd35cSRandy Dunlap The kernel size is about 33% smaller with LZMA in comparison to gzip. 28330d65dbfSAlain Knaff 2843ebe1243SLasse Collinconfig KERNEL_XZ 2853ebe1243SLasse Collin bool "XZ" 2863ebe1243SLasse Collin depends on HAVE_KERNEL_XZ 2873ebe1243SLasse Collin help 2883ebe1243SLasse Collin XZ uses the LZMA2 algorithm and instruction set specific 2893ebe1243SLasse Collin BCJ filters which can improve compression ratio of executable 2903ebe1243SLasse Collin code. The size of the kernel is about 30% smaller with XZ in 2913ebe1243SLasse Collin comparison to gzip. On architectures for which there is a BCJ 2923ebe1243SLasse Collin filter (i386, x86_64, ARM, IA-64, PowerPC, and SPARC), XZ 2933ebe1243SLasse Collin will create a few percent smaller kernel than plain LZMA. 2943ebe1243SLasse Collin 2953ebe1243SLasse Collin The speed is about the same as with LZMA: The decompression 2963ebe1243SLasse Collin speed of XZ is better than that of bzip2 but worse than gzip 2973ebe1243SLasse Collin and LZO. Compression is slow. 2983ebe1243SLasse Collin 2997dd65febSAlbin Tonnerreconfig KERNEL_LZO 3007dd65febSAlbin Tonnerre bool "LZO" 3017dd65febSAlbin Tonnerre depends on HAVE_KERNEL_LZO 3027dd65febSAlbin Tonnerre help 3030a4dd35cSRandy Dunlap Its compression ratio is the poorest among the choices. The kernel 304681b3049SStephan Sperber size is about 10% bigger than gzip; however its speed 3057dd65febSAlbin Tonnerre (both compression and decompression) is the fastest. 3067dd65febSAlbin Tonnerre 307e76e1fdfSKyungsik Leeconfig KERNEL_LZ4 308e76e1fdfSKyungsik Lee bool "LZ4" 309e76e1fdfSKyungsik Lee depends on HAVE_KERNEL_LZ4 310e76e1fdfSKyungsik Lee help 311e76e1fdfSKyungsik Lee LZ4 is an LZ77-type compressor with a fixed, byte-oriented encoding. 312e76e1fdfSKyungsik Lee A preliminary version of LZ4 de/compression tool is available at 313e76e1fdfSKyungsik Lee <https://code.google.com/p/lz4/>. 314e76e1fdfSKyungsik Lee 315e76e1fdfSKyungsik Lee Its compression ratio is worse than LZO. The size of the kernel 316e76e1fdfSKyungsik Lee is about 8% bigger than LZO. But the decompression speed is 317e76e1fdfSKyungsik Lee faster than LZO. 318e76e1fdfSKyungsik Lee 31948f7ddf7SNick Terrellconfig KERNEL_ZSTD 32048f7ddf7SNick Terrell bool "ZSTD" 32148f7ddf7SNick Terrell depends on HAVE_KERNEL_ZSTD 32248f7ddf7SNick Terrell help 32348f7ddf7SNick Terrell ZSTD is a compression algorithm targeting intermediate compression 32448f7ddf7SNick Terrell with fast decompression speed. It will compress better than GZIP and 32548f7ddf7SNick Terrell decompress around the same speed as LZO, but slower than LZ4. You 32648f7ddf7SNick Terrell will need at least 192 KB RAM or more for booting. The zstd command 32748f7ddf7SNick Terrell line tool is required for compression. 32848f7ddf7SNick Terrell 329f16466afSVasily Gorbikconfig KERNEL_UNCOMPRESSED 330f16466afSVasily Gorbik bool "None" 331f16466afSVasily Gorbik depends on HAVE_KERNEL_UNCOMPRESSED 332f16466afSVasily Gorbik help 333f16466afSVasily Gorbik Produce uncompressed kernel image. This option is usually not what 334f16466afSVasily Gorbik you want. It is useful for debugging the kernel in slow simulation 335f16466afSVasily Gorbik environments, where decompressing and moving the kernel is awfully 336f16466afSVasily Gorbik slow. This option allows early boot code to skip the decompressor 337f16466afSVasily Gorbik and jump right at uncompressed kernel image. 338f16466afSVasily Gorbik 33930d65dbfSAlain Knaffendchoice 34030d65dbfSAlain Knaff 341ada4ab7aSChris Downconfig DEFAULT_INIT 342ada4ab7aSChris Down string "Default init path" 343ada4ab7aSChris Down default "" 344ada4ab7aSChris Down help 345ada4ab7aSChris Down This option determines the default init for the system if no init= 346ada4ab7aSChris Down option is passed on the kernel command line. If the requested path is 347ada4ab7aSChris Down not present, we will still then move on to attempting further 348ada4ab7aSChris Down locations (e.g. /sbin/init, etc). If this is empty, we will just use 349ada4ab7aSChris Down the fallback list when init= is not passed. 350ada4ab7aSChris Down 351bd5dc17bSJosh Triplettconfig DEFAULT_HOSTNAME 352bd5dc17bSJosh Triplett string "Default hostname" 353bd5dc17bSJosh Triplett default "(none)" 354bd5dc17bSJosh Triplett help 355bd5dc17bSJosh Triplett This option determines the default system hostname before userspace 356bd5dc17bSJosh Triplett calls sethostname(2). The kernel traditionally uses "(none)" here, 357bd5dc17bSJosh Triplett but you may wish to use a different default here to make a minimal 358bd5dc17bSJosh Triplett system more usable with less configuration. 359bd5dc17bSJosh Triplett 36017c46a6aSChristoph Hellwig# 36117c46a6aSChristoph Hellwig# For some reason microblaze and nios2 hard code SWAP=n. Hopefully we can 36217c46a6aSChristoph Hellwig# add proper SWAP support to them, in which case this can be remove. 36317c46a6aSChristoph Hellwig# 36417c46a6aSChristoph Hellwigconfig ARCH_NO_SWAP 36517c46a6aSChristoph Hellwig bool 36617c46a6aSChristoph Hellwig 3671da177e4SLinus Torvaldsconfig SWAP 3681da177e4SLinus Torvalds bool "Support for paging of anonymous memory (swap)" 36917c46a6aSChristoph Hellwig depends on MMU && BLOCK && !ARCH_NO_SWAP 3701da177e4SLinus Torvalds default y 3711da177e4SLinus Torvalds help 3721da177e4SLinus Torvalds This option allows you to choose whether you want to have support 3731da177e4SLinus Torvalds for so called swap devices or swap files in your kernel that are 3741da177e4SLinus Torvalds used to provide more virtual memory than the actual RAM present 3751da177e4SLinus Torvalds in your computer. If unsure say Y. 3761da177e4SLinus Torvalds 3771da177e4SLinus Torvaldsconfig SYSVIPC 3781da177e4SLinus Torvalds bool "System V IPC" 379a7f7f624SMasahiro Yamada help 3801da177e4SLinus Torvalds Inter Process Communication is a suite of library functions and 3811da177e4SLinus Torvalds system calls which let processes (running programs) synchronize and 3821da177e4SLinus Torvalds exchange information. It is generally considered to be a good thing, 3831da177e4SLinus Torvalds and some programs won't run unless you say Y here. In particular, if 3841da177e4SLinus Torvalds you want to run the DOS emulator dosemu under Linux (read the 3851da177e4SLinus Torvalds DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>), 3861da177e4SLinus Torvalds you'll need to say Y here. 3871da177e4SLinus Torvalds 3881da177e4SLinus Torvalds You can find documentation about IPC with "info ipc" and also in 3891da177e4SLinus Torvalds section 6.4 of the Linux Programmer's Guide, available from 3901da177e4SLinus Torvalds <http://www.tldp.org/guides.html>. 3911da177e4SLinus Torvalds 392a5494dcdSEric W. Biedermanconfig SYSVIPC_SYSCTL 393a5494dcdSEric W. Biederman bool 394a5494dcdSEric W. Biederman depends on SYSVIPC 395a5494dcdSEric W. Biederman depends on SYSCTL 396a5494dcdSEric W. Biederman default y 397a5494dcdSEric W. Biederman 3981da177e4SLinus Torvaldsconfig POSIX_MQUEUE 3991da177e4SLinus Torvalds bool "POSIX Message Queues" 40019c92399SKees Cook depends on NET 401a7f7f624SMasahiro Yamada help 4021da177e4SLinus Torvalds POSIX variant of message queues is a part of IPC. In POSIX message 4031da177e4SLinus Torvalds queues every message has a priority which decides about succession 4041da177e4SLinus Torvalds of receiving it by a process. If you want to compile and run 4051da177e4SLinus Torvalds programs written e.g. for Solaris with use of its POSIX message 406b0e37650SRobert P. J. Day queues (functions mq_*) say Y here. 4071da177e4SLinus Torvalds 4081da177e4SLinus Torvalds POSIX message queues are visible as a filesystem called 'mqueue' 4091da177e4SLinus Torvalds and can be mounted somewhere if you want to do filesystem 4101da177e4SLinus Torvalds operations on message queues. 4111da177e4SLinus Torvalds 4121da177e4SLinus Torvalds If unsure, say Y. 4131da177e4SLinus Torvalds 414bdc8e5f8SSerge E. Hallynconfig POSIX_MQUEUE_SYSCTL 415bdc8e5f8SSerge E. Hallyn bool 416bdc8e5f8SSerge E. Hallyn depends on POSIX_MQUEUE 417bdc8e5f8SSerge E. Hallyn depends on SYSCTL 418bdc8e5f8SSerge E. Hallyn default y 419bdc8e5f8SSerge E. Hallyn 420c73be61cSDavid Howellsconfig WATCH_QUEUE 421c73be61cSDavid Howells bool "General notification queue" 422c73be61cSDavid Howells default n 423c73be61cSDavid Howells help 424c73be61cSDavid Howells 425c73be61cSDavid Howells This is a general notification queue for the kernel to pass events to 426c73be61cSDavid Howells userspace by splicing them into pipes. It can be used in conjunction 427c73be61cSDavid Howells with watches for key/keyring change notifications and device 428c73be61cSDavid Howells notifications. 429c73be61cSDavid Howells 430c73be61cSDavid Howells See Documentation/watch_queue.rst 431c73be61cSDavid Howells 432226b4ccdSKonstantin Khlebnikovconfig CROSS_MEMORY_ATTACH 433226b4ccdSKonstantin Khlebnikov bool "Enable process_vm_readv/writev syscalls" 434226b4ccdSKonstantin Khlebnikov depends on MMU 435226b4ccdSKonstantin Khlebnikov default y 436226b4ccdSKonstantin Khlebnikov help 437226b4ccdSKonstantin Khlebnikov Enabling this option adds the system calls process_vm_readv and 438226b4ccdSKonstantin Khlebnikov process_vm_writev which allow a process with the correct privileges 439a2a368d9SGeert Uytterhoeven to directly read from or write to another process' address space. 440226b4ccdSKonstantin Khlebnikov See the man page for more details. 441226b4ccdSKonstantin Khlebnikov 44269369a70SJosh Triplettconfig USELIB 44369369a70SJosh Triplett bool "uselib syscall" 444b2113a41SRiku Voipio def_bool ALPHA || M68K || SPARC || X86_32 || IA32_EMULATION 44569369a70SJosh Triplett help 44669369a70SJosh Triplett This option enables the uselib syscall, a system call used in the 44769369a70SJosh Triplett dynamic linker from libc5 and earlier. glibc does not use this 44869369a70SJosh Triplett system call. If you intend to run programs built on libc5 or 44969369a70SJosh Triplett earlier, you may need to enable this syscall. Current systems 45069369a70SJosh Triplett running glibc can safely disable this. 45169369a70SJosh Triplett 4521da177e4SLinus Torvaldsconfig AUDIT 4531da177e4SLinus Torvalds bool "Auditing support" 454804a6a49SChris Wright depends on NET 4551da177e4SLinus Torvalds help 4561da177e4SLinus Torvalds Enable auditing infrastructure that can be used with another 4571da177e4SLinus Torvalds kernel subsystem, such as SELinux (which requires this for 458cb74ed27SPaul Moore logging of avc messages output). System call auditing is included 459cb74ed27SPaul Moore on architectures which support it. 4601da177e4SLinus Torvalds 4617a017721SAKASHI Takahiroconfig HAVE_ARCH_AUDITSYSCALL 4627a017721SAKASHI Takahiro bool 4637a017721SAKASHI Takahiro 4641da177e4SLinus Torvaldsconfig AUDITSYSCALL 465cb74ed27SPaul Moore def_bool y 4667a017721SAKASHI Takahiro depends on AUDIT && HAVE_ARCH_AUDITSYSCALL 46728a3a7ebSEric Paris select FSNOTIFY 46874c3cbe3SAl Viro 469d9817ebeSThomas Gleixnersource "kernel/irq/Kconfig" 470764e0da1SThomas Gleixnersource "kernel/time/Kconfig" 471b24abcffSDaniel Borkmannsource "kernel/bpf/Kconfig" 47287a4c375SChristoph Hellwigsource "kernel/Kconfig.preempt" 473d9817ebeSThomas Gleixner 474391dc69cSFrederic Weisbeckermenu "CPU/Task time and stats accounting" 475391dc69cSFrederic Weisbecker 476abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING 477abf917cdSFrederic Weisbecker bool 478abf917cdSFrederic Weisbecker 479fdf9c356SFrederic Weisbeckerchoice 480fdf9c356SFrederic Weisbecker prompt "Cputime accounting" 481fdf9c356SFrederic Weisbecker default TICK_CPU_ACCOUNTING if !PPC64 48202fc8d37SStephen Rothwell default VIRT_CPU_ACCOUNTING_NATIVE if PPC64 483fdf9c356SFrederic Weisbecker 484fdf9c356SFrederic Weisbecker# Kind of a stub config for the pure tick based cputime accounting 485fdf9c356SFrederic Weisbeckerconfig TICK_CPU_ACCOUNTING 486fdf9c356SFrederic Weisbecker bool "Simple tick based cputime accounting" 487c58b0df1SFrederic Weisbecker depends on !S390 && !NO_HZ_FULL 488fdf9c356SFrederic Weisbecker help 489fdf9c356SFrederic Weisbecker This is the basic tick based cputime accounting that maintains 490fdf9c356SFrederic Weisbecker statistics about user, system and idle time spent on per jiffies 491fdf9c356SFrederic Weisbecker granularity. 492fdf9c356SFrederic Weisbecker 493fdf9c356SFrederic Weisbecker If unsure, say Y. 494fdf9c356SFrederic Weisbecker 495abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_NATIVE 496391dc69cSFrederic Weisbecker bool "Deterministic task and CPU time accounting" 497c58b0df1SFrederic Weisbecker depends on HAVE_VIRT_CPU_ACCOUNTING && !NO_HZ_FULL 498abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 499391dc69cSFrederic Weisbecker help 500391dc69cSFrederic Weisbecker Select this option to enable more accurate task and CPU time 501391dc69cSFrederic Weisbecker accounting. This is done by reading a CPU counter on each 502391dc69cSFrederic Weisbecker kernel entry and exit and on transitions within the kernel 503391dc69cSFrederic Weisbecker between system, softirq and hardirq state, so there is a 504391dc69cSFrederic Weisbecker small performance impact. In the case of s390 or IBM POWER > 5, 505391dc69cSFrederic Weisbecker this also enables accounting of stolen time on logically-partitioned 506391dc69cSFrederic Weisbecker systems. 507391dc69cSFrederic Weisbecker 508abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_GEN 509abf917cdSFrederic Weisbecker bool "Full dynticks CPU time accounting" 510ff3fb254SKevin Hilman depends on HAVE_CONTEXT_TRACKING 511554b0004SKevin Hilman depends on HAVE_VIRT_CPU_ACCOUNTING_GEN 512041a1574SArnd Bergmann depends on GENERIC_CLOCKEVENTS 513abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 514abf917cdSFrederic Weisbecker select CONTEXT_TRACKING 515abf917cdSFrederic Weisbecker help 516abf917cdSFrederic Weisbecker Select this option to enable task and CPU time accounting on full 517abf917cdSFrederic Weisbecker dynticks systems. This accounting is implemented by watching every 518abf917cdSFrederic Weisbecker kernel-user boundaries using the context tracking subsystem. 519abf917cdSFrederic Weisbecker The accounting is thus performed at the expense of some significant 520abf917cdSFrederic Weisbecker overhead. 521abf917cdSFrederic Weisbecker 522abf917cdSFrederic Weisbecker For now this is only useful if you are working on the full 523abf917cdSFrederic Weisbecker dynticks subsystem development. 524abf917cdSFrederic Weisbecker 525abf917cdSFrederic Weisbecker If unsure, say N. 526abf917cdSFrederic Weisbecker 527b58c3584SRik van Rielendchoice 528b58c3584SRik van Riel 529fdf9c356SFrederic Weisbeckerconfig IRQ_TIME_ACCOUNTING 530fdf9c356SFrederic Weisbecker bool "Fine granularity task level IRQ time accounting" 531b58c3584SRik van Riel depends on HAVE_IRQ_TIME_ACCOUNTING && !VIRT_CPU_ACCOUNTING_NATIVE 532fdf9c356SFrederic Weisbecker help 533fdf9c356SFrederic Weisbecker Select this option to enable fine granularity task irq time 534fdf9c356SFrederic Weisbecker accounting. This is done by reading a timestamp on each 535fdf9c356SFrederic Weisbecker transitions between softirq and hardirq state, so there can be a 536fdf9c356SFrederic Weisbecker small performance impact. 537fdf9c356SFrederic Weisbecker 538fdf9c356SFrederic Weisbecker If in doubt, say N here. 539fdf9c356SFrederic Weisbecker 54011d4afd4SVincent Guittotconfig HAVE_SCHED_AVG_IRQ 54111d4afd4SVincent Guittot def_bool y 54211d4afd4SVincent Guittot depends on IRQ_TIME_ACCOUNTING || PARAVIRT_TIME_ACCOUNTING 54311d4afd4SVincent Guittot depends on SMP 54411d4afd4SVincent Guittot 54576504793SThara Gopinathconfig SCHED_THERMAL_PRESSURE 54698eb401dSValentin Schneider bool 547fcd7c9c3SValentin Schneider default y if ARM && ARM_CPU_TOPOLOGY 548fcd7c9c3SValentin Schneider default y if ARM64 54976504793SThara Gopinath depends on SMP 55098eb401dSValentin Schneider depends on CPU_FREQ_THERMAL 55198eb401dSValentin Schneider help 55298eb401dSValentin Schneider Select this option to enable thermal pressure accounting in the 55398eb401dSValentin Schneider scheduler. Thermal pressure is the value conveyed to the scheduler 55498eb401dSValentin Schneider that reflects the reduction in CPU compute capacity resulted from 55598eb401dSValentin Schneider thermal throttling. Thermal throttling occurs when the performance of 55698eb401dSValentin Schneider a CPU is capped due to high operating temperatures. 55798eb401dSValentin Schneider 55898eb401dSValentin Schneider If selected, the scheduler will be able to balance tasks accordingly, 55998eb401dSValentin Schneider i.e. put less load on throttled CPUs than on non/less throttled ones. 56098eb401dSValentin Schneider 56198eb401dSValentin Schneider This requires the architecture to implement 5627e97b3dcSLukasz Luba arch_update_thermal_pressure() and arch_scale_thermal_pressure(). 56376504793SThara Gopinath 564391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT 565391dc69cSFrederic Weisbecker bool "BSD Process Accounting" 5662813893fSIulia Manda depends on MULTIUSER 567391dc69cSFrederic Weisbecker help 568391dc69cSFrederic Weisbecker If you say Y here, a user level program will be able to instruct the 569391dc69cSFrederic Weisbecker kernel (via a special system call) to write process accounting 570391dc69cSFrederic Weisbecker information to a file: whenever a process exits, information about 571391dc69cSFrederic Weisbecker that process will be appended to the file by the kernel. The 572391dc69cSFrederic Weisbecker information includes things such as creation time, owning user, 573391dc69cSFrederic Weisbecker command name, memory usage, controlling terminal etc. (the complete 574391dc69cSFrederic Weisbecker list is in the struct acct in <file:include/linux/acct.h>). It is 575391dc69cSFrederic Weisbecker up to the user level program to do useful things with this 576391dc69cSFrederic Weisbecker information. This is generally a good idea, so say Y. 577391dc69cSFrederic Weisbecker 578391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT_V3 579391dc69cSFrederic Weisbecker bool "BSD Process Accounting version 3 file format" 580391dc69cSFrederic Weisbecker depends on BSD_PROCESS_ACCT 581391dc69cSFrederic Weisbecker default n 582391dc69cSFrederic Weisbecker help 583391dc69cSFrederic Weisbecker If you say Y here, the process accounting information is written 584391dc69cSFrederic Weisbecker in a new file format that also logs the process IDs of each 5853903bf94SRandy Dunlap process and its parent. Note that this file format is incompatible 586391dc69cSFrederic Weisbecker with previous v0/v1/v2 file formats, so you will need updated tools 587391dc69cSFrederic Weisbecker for processing it. A preliminary version of these tools is available 588391dc69cSFrederic Weisbecker at <http://www.gnu.org/software/acct/>. 589391dc69cSFrederic Weisbecker 590391dc69cSFrederic Weisbeckerconfig TASKSTATS 59119c92399SKees Cook bool "Export task/process statistics through netlink" 592391dc69cSFrederic Weisbecker depends on NET 5932813893fSIulia Manda depends on MULTIUSER 594391dc69cSFrederic Weisbecker default n 595391dc69cSFrederic Weisbecker help 596391dc69cSFrederic Weisbecker Export selected statistics for tasks/processes through the 597391dc69cSFrederic Weisbecker generic netlink interface. Unlike BSD process accounting, the 598391dc69cSFrederic Weisbecker statistics are available during the lifetime of tasks/processes as 599391dc69cSFrederic Weisbecker responses to commands. Like BSD accounting, they are sent to user 600391dc69cSFrederic Weisbecker space on task exit. 601391dc69cSFrederic Weisbecker 602391dc69cSFrederic Weisbecker Say N if unsure. 603391dc69cSFrederic Weisbecker 604391dc69cSFrederic Weisbeckerconfig TASK_DELAY_ACCT 60519c92399SKees Cook bool "Enable per-task delay accounting" 606391dc69cSFrederic Weisbecker depends on TASKSTATS 607f6db8347SNaveen N. Rao select SCHED_INFO 608391dc69cSFrederic Weisbecker help 609391dc69cSFrederic Weisbecker Collect information on time spent by a task waiting for system 610391dc69cSFrederic Weisbecker resources like cpu, synchronous block I/O completion and swapping 611391dc69cSFrederic Weisbecker in pages. Such statistics can help in setting a task's priorities 612391dc69cSFrederic Weisbecker relative to other tasks for cpu, io, rss limits etc. 613391dc69cSFrederic Weisbecker 614391dc69cSFrederic Weisbecker Say N if unsure. 615391dc69cSFrederic Weisbecker 616391dc69cSFrederic Weisbeckerconfig TASK_XACCT 61719c92399SKees Cook bool "Enable extended accounting over taskstats" 618391dc69cSFrederic Weisbecker depends on TASKSTATS 619391dc69cSFrederic Weisbecker help 620391dc69cSFrederic Weisbecker Collect extended task accounting data and send the data 621391dc69cSFrederic Weisbecker to userland for processing over the taskstats interface. 622391dc69cSFrederic Weisbecker 623391dc69cSFrederic Weisbecker Say N if unsure. 624391dc69cSFrederic Weisbecker 625391dc69cSFrederic Weisbeckerconfig TASK_IO_ACCOUNTING 62619c92399SKees Cook bool "Enable per-task storage I/O accounting" 627391dc69cSFrederic Weisbecker depends on TASK_XACCT 628391dc69cSFrederic Weisbecker help 629391dc69cSFrederic Weisbecker Collect information on the number of bytes of storage I/O which this 630391dc69cSFrederic Weisbecker task has caused. 631391dc69cSFrederic Weisbecker 632391dc69cSFrederic Weisbecker Say N if unsure. 633391dc69cSFrederic Weisbecker 634eb414681SJohannes Weinerconfig PSI 635eb414681SJohannes Weiner bool "Pressure stall information tracking" 636eb414681SJohannes Weiner help 637eb414681SJohannes Weiner Collect metrics that indicate how overcommitted the CPU, memory, 638eb414681SJohannes Weiner and IO capacity are in the system. 639eb414681SJohannes Weiner 640eb414681SJohannes Weiner If you say Y here, the kernel will create /proc/pressure/ with the 641eb414681SJohannes Weiner pressure statistics files cpu, memory, and io. These will indicate 642eb414681SJohannes Weiner the share of walltime in which some or all tasks in the system are 643eb414681SJohannes Weiner delayed due to contention of the respective resource. 644eb414681SJohannes Weiner 6452ce7135aSJohannes Weiner In kernels with cgroup support, cgroups (cgroup2 only) will 6462ce7135aSJohannes Weiner have cpu.pressure, memory.pressure, and io.pressure files, 6472ce7135aSJohannes Weiner which aggregate pressure stalls for the grouped tasks only. 6482ce7135aSJohannes Weiner 649c3123552SMauro Carvalho Chehab For more details see Documentation/accounting/psi.rst. 650eb414681SJohannes Weiner 651eb414681SJohannes Weiner Say N if unsure. 652eb414681SJohannes Weiner 653e0c27447SJohannes Weinerconfig PSI_DEFAULT_DISABLED 654e0c27447SJohannes Weiner bool "Require boot parameter to enable pressure stall information tracking" 655e0c27447SJohannes Weiner default n 656e0c27447SJohannes Weiner depends on PSI 657e0c27447SJohannes Weiner help 658e0c27447SJohannes Weiner If set, pressure stall information tracking will be disabled 659428a1cb4SBaruch Siach per default but can be enabled through passing psi=1 on the 660428a1cb4SBaruch Siach kernel commandline during boot. 661e0c27447SJohannes Weiner 6627b2489d3SJohannes Weiner This feature adds some code to the task wakeup and sleep 6637b2489d3SJohannes Weiner paths of the scheduler. The overhead is too low to affect 6647b2489d3SJohannes Weiner common scheduling-intense workloads in practice (such as 6657b2489d3SJohannes Weiner webservers, memcache), but it does show up in artificial 6667b2489d3SJohannes Weiner scheduler stress tests, such as hackbench. 6677b2489d3SJohannes Weiner 6687b2489d3SJohannes Weiner If you are paranoid and not sure what the kernel will be 6697b2489d3SJohannes Weiner used for, say Y. 6707b2489d3SJohannes Weiner 6717b2489d3SJohannes Weiner Say N if unsure. 6727b2489d3SJohannes Weiner 673391dc69cSFrederic Weisbeckerendmenu # "CPU/Task time and stats accounting" 674391dc69cSFrederic Weisbecker 6755c4991e2SFrederic Weisbeckerconfig CPU_ISOLATION 6765c4991e2SFrederic Weisbecker bool "CPU isolation" 677414a2dc1SGeert Uytterhoeven depends on SMP || COMPILE_TEST 6782c43838cSFrederic Weisbecker default y 6795c4991e2SFrederic Weisbecker help 6805c4991e2SFrederic Weisbecker Make sure that CPUs running critical tasks are not disturbed by 6815c4991e2SFrederic Weisbecker any source of "noise" such as unbound workqueues, timers, kthreads... 6822c43838cSFrederic Weisbecker Unbound jobs get offloaded to housekeeping CPUs. This is driven by 6832c43838cSFrederic Weisbecker the "isolcpus=" boot parameter. 6842c43838cSFrederic Weisbecker 6852c43838cSFrederic Weisbecker Say Y if unsure. 6865c4991e2SFrederic Weisbecker 6870af92d46SPaul E. McKenneysource "kernel/rcu/Kconfig" 688c903ff83SMike Travis 689de5b56baSVivek Goyalconfig BUILD_BIN2C 690de5b56baSVivek Goyal bool 691de5b56baSVivek Goyal default n 692de5b56baSVivek Goyal 6931da177e4SLinus Torvaldsconfig IKCONFIG 694f2443ab6SRoss Biro tristate "Kernel .config support" 695a7f7f624SMasahiro Yamada help 6961da177e4SLinus Torvalds This option enables the complete Linux kernel ".config" file 6971da177e4SLinus Torvalds contents to be saved in the kernel. It provides documentation 6981da177e4SLinus Torvalds of which kernel options are used in a running kernel or in an 6991da177e4SLinus Torvalds on-disk kernel. This information can be extracted from the kernel 7001da177e4SLinus Torvalds image file with the script scripts/extract-ikconfig and used as 7011da177e4SLinus Torvalds input to rebuild the current kernel or to build another kernel. 7021da177e4SLinus Torvalds It can also be extracted from a running kernel by reading 7031da177e4SLinus Torvalds /proc/config.gz if enabled (below). 7041da177e4SLinus Torvalds 7051da177e4SLinus Torvaldsconfig IKCONFIG_PROC 7061da177e4SLinus Torvalds bool "Enable access to .config through /proc/config.gz" 7071da177e4SLinus Torvalds depends on IKCONFIG && PROC_FS 708a7f7f624SMasahiro Yamada help 7091da177e4SLinus Torvalds This option enables access to the kernel configuration file 7101da177e4SLinus Torvalds through /proc/config.gz. 7111da177e4SLinus Torvalds 712f7b101d3SJoel Fernandes (Google)config IKHEADERS 713f7b101d3SJoel Fernandes (Google) tristate "Enable kernel headers through /sys/kernel/kheaders.tar.xz" 714f7b101d3SJoel Fernandes (Google) depends on SYSFS 71543d8ce9dSJoel Fernandes (Google) help 716f7b101d3SJoel Fernandes (Google) This option enables access to the in-kernel headers that are generated during 717f7b101d3SJoel Fernandes (Google) the build process. These can be used to build eBPF tracing programs, 718f7b101d3SJoel Fernandes (Google) or similar programs. If you build the headers as a module, a module called 719f7b101d3SJoel Fernandes (Google) kheaders.ko is built which can be loaded on-demand to get access to headers. 72043d8ce9dSJoel Fernandes (Google) 721794543a2SAlistair John Strachanconfig LOG_BUF_SHIFT 722794543a2SAlistair John Strachan int "Kernel log buffer size (16 => 64KB, 17 => 128KB)" 723550c10d2SJohn Ogness range 12 25 if !H8300 724550c10d2SJohn Ogness range 12 19 if H8300 725f17a32e9SAdrian Bunk default 17 726361e9dfbSJosh Triplett depends on PRINTK 727794543a2SAlistair John Strachan help 72823b2899fSLuis R. Rodriguez Select the minimal kernel log buffer size as a power of 2. 72923b2899fSLuis R. Rodriguez The final size is affected by LOG_CPU_MAX_BUF_SHIFT config 73023b2899fSLuis R. Rodriguez parameter, see below. Any higher size also might be forced 73123b2899fSLuis R. Rodriguez by "log_buf_len" boot parameter. 73223b2899fSLuis R. Rodriguez 733f17a32e9SAdrian Bunk Examples: 734f17a32e9SAdrian Bunk 17 => 128 KB 735f17a32e9SAdrian Bunk 16 => 64 KB 736f17a32e9SAdrian Bunk 15 => 32 KB 737f17a32e9SAdrian Bunk 14 => 16 KB 738794543a2SAlistair John Strachan 13 => 8 KB 739794543a2SAlistair John Strachan 12 => 4 KB 740794543a2SAlistair John Strachan 74123b2899fSLuis R. Rodriguezconfig LOG_CPU_MAX_BUF_SHIFT 74223b2899fSLuis R. Rodriguez int "CPU kernel log buffer size contribution (13 => 8 KB, 17 => 128KB)" 7432240a31dSGeert Uytterhoeven depends on SMP 74423b2899fSLuis R. Rodriguez range 0 21 74523b2899fSLuis R. Rodriguez default 12 if !BASE_SMALL 74623b2899fSLuis R. Rodriguez default 0 if BASE_SMALL 747361e9dfbSJosh Triplett depends on PRINTK 74823b2899fSLuis R. Rodriguez help 74923b2899fSLuis R. Rodriguez This option allows to increase the default ring buffer size 75023b2899fSLuis R. Rodriguez according to the number of CPUs. The value defines the contribution 75123b2899fSLuis R. Rodriguez of each CPU as a power of 2. The used space is typically only few 75223b2899fSLuis R. Rodriguez lines however it might be much more when problems are reported, 75323b2899fSLuis R. Rodriguez e.g. backtraces. 75423b2899fSLuis R. Rodriguez 75523b2899fSLuis R. Rodriguez The increased size means that a new buffer has to be allocated and 75623b2899fSLuis R. Rodriguez the original static one is unused. It makes sense only on systems 75723b2899fSLuis R. Rodriguez with more CPUs. Therefore this value is used only when the sum of 75823b2899fSLuis R. Rodriguez contributions is greater than the half of the default kernel ring 75923b2899fSLuis R. Rodriguez buffer as defined by LOG_BUF_SHIFT. The default values are set 7600f7636e1SPaul Menzel so that more than 16 CPUs are needed to trigger the allocation. 76123b2899fSLuis R. Rodriguez 76223b2899fSLuis R. Rodriguez Also this option is ignored when "log_buf_len" kernel parameter is 76323b2899fSLuis R. Rodriguez used as it forces an exact (power of two) size of the ring buffer. 76423b2899fSLuis R. Rodriguez 76523b2899fSLuis R. Rodriguez The number of possible CPUs is used for this computation ignoring 7665e0d8d59SGeert Uytterhoeven hotplugging making the computation optimal for the worst case 7675e0d8d59SGeert Uytterhoeven scenario while allowing a simple algorithm to be used from bootup. 76823b2899fSLuis R. Rodriguez 76923b2899fSLuis R. Rodriguez Examples shift values and their meaning: 77023b2899fSLuis R. Rodriguez 17 => 128 KB for each CPU 77123b2899fSLuis R. Rodriguez 16 => 64 KB for each CPU 77223b2899fSLuis R. Rodriguez 15 => 32 KB for each CPU 77323b2899fSLuis R. Rodriguez 14 => 16 KB for each CPU 77423b2899fSLuis R. Rodriguez 13 => 8 KB for each CPU 77523b2899fSLuis R. Rodriguez 12 => 4 KB for each CPU 77623b2899fSLuis R. Rodriguez 777f92bac3bSSergey Senozhatskyconfig PRINTK_SAFE_LOG_BUF_SHIFT 778f92bac3bSSergey Senozhatsky int "Temporary per-CPU printk log buffer size (12 => 4KB, 13 => 8KB)" 779427934b8SPetr Mladek range 10 21 780427934b8SPetr Mladek default 13 781f92bac3bSSergey Senozhatsky depends on PRINTK 782427934b8SPetr Mladek help 783f92bac3bSSergey Senozhatsky Select the size of an alternate printk per-CPU buffer where messages 784f92bac3bSSergey Senozhatsky printed from usafe contexts are temporary stored. One example would 785f92bac3bSSergey Senozhatsky be NMI messages, another one - printk recursion. The messages are 786f92bac3bSSergey Senozhatsky copied to the main log buffer in a safe context to avoid a deadlock. 787f92bac3bSSergey Senozhatsky The value defines the size as a power of 2. 788427934b8SPetr Mladek 789f92bac3bSSergey Senozhatsky Those messages are rare and limited. The largest one is when 790427934b8SPetr Mladek a backtrace is printed. It usually fits into 4KB. Select 791427934b8SPetr Mladek 8KB if you want to be on the safe side. 792427934b8SPetr Mladek 793427934b8SPetr Mladek Examples: 794427934b8SPetr Mladek 17 => 128 KB for each CPU 795427934b8SPetr Mladek 16 => 64 KB for each CPU 796427934b8SPetr Mladek 15 => 32 KB for each CPU 797427934b8SPetr Mladek 14 => 16 KB for each CPU 798427934b8SPetr Mladek 13 => 8 KB for each CPU 799427934b8SPetr Mladek 12 => 4 KB for each CPU 800427934b8SPetr Mladek 80133701557SChris Downconfig PRINTK_INDEX 80233701557SChris Down bool "Printk indexing debugfs interface" 80333701557SChris Down depends on PRINTK && DEBUG_FS 80433701557SChris Down help 80533701557SChris Down Add support for indexing of all printk formats known at compile time 80633701557SChris Down at <debugfs>/printk/index/<module>. 80733701557SChris Down 80833701557SChris Down This can be used as part of maintaining daemons which monitor 80933701557SChris Down /dev/kmsg, as it permits auditing the printk formats present in a 81033701557SChris Down kernel, allowing detection of cases where monitored printks are 81133701557SChris Down changed or no longer present. 81233701557SChris Down 81333701557SChris Down There is no additional runtime cost to printk with this enabled. 81433701557SChris Down 8155cdc38f9SKAMEZAWA Hiroyuki# 8165cdc38f9SKAMEZAWA Hiroyuki# Architectures with an unreliable sched_clock() should select this: 8175cdc38f9SKAMEZAWA Hiroyuki# 8185cdc38f9SKAMEZAWA Hiroyukiconfig HAVE_UNSTABLE_SCHED_CLOCK 8195cdc38f9SKAMEZAWA Hiroyuki bool 8205cdc38f9SKAMEZAWA Hiroyuki 82138ff87f7SStephen Boydconfig GENERIC_SCHED_CLOCK 82238ff87f7SStephen Boyd bool 82338ff87f7SStephen Boyd 82469842cbaSPatrick Bellasimenu "Scheduler features" 82569842cbaSPatrick Bellasi 82669842cbaSPatrick Bellasiconfig UCLAMP_TASK 82769842cbaSPatrick Bellasi bool "Enable utilization clamping for RT/FAIR tasks" 82869842cbaSPatrick Bellasi depends on CPU_FREQ_GOV_SCHEDUTIL 82969842cbaSPatrick Bellasi help 83069842cbaSPatrick Bellasi This feature enables the scheduler to track the clamped utilization 83169842cbaSPatrick Bellasi of each CPU based on RUNNABLE tasks scheduled on that CPU. 83269842cbaSPatrick Bellasi 83369842cbaSPatrick Bellasi With this option, the user can specify the min and max CPU 83469842cbaSPatrick Bellasi utilization allowed for RUNNABLE tasks. The max utilization defines 83569842cbaSPatrick Bellasi the maximum frequency a task should use while the min utilization 83669842cbaSPatrick Bellasi defines the minimum frequency it should use. 83769842cbaSPatrick Bellasi 83869842cbaSPatrick Bellasi Both min and max utilization clamp values are hints to the scheduler, 83969842cbaSPatrick Bellasi aiming at improving its frequency selection policy, but they do not 84069842cbaSPatrick Bellasi enforce or grant any specific bandwidth for tasks. 84169842cbaSPatrick Bellasi 84269842cbaSPatrick Bellasi If in doubt, say N. 84369842cbaSPatrick Bellasi 84469842cbaSPatrick Bellasiconfig UCLAMP_BUCKETS_COUNT 84569842cbaSPatrick Bellasi int "Number of supported utilization clamp buckets" 84669842cbaSPatrick Bellasi range 5 20 84769842cbaSPatrick Bellasi default 5 84869842cbaSPatrick Bellasi depends on UCLAMP_TASK 84969842cbaSPatrick Bellasi help 85069842cbaSPatrick Bellasi Defines the number of clamp buckets to use. The range of each bucket 85169842cbaSPatrick Bellasi will be SCHED_CAPACITY_SCALE/UCLAMP_BUCKETS_COUNT. The higher the 85269842cbaSPatrick Bellasi number of clamp buckets the finer their granularity and the higher 85369842cbaSPatrick Bellasi the precision of clamping aggregation and tracking at run-time. 85469842cbaSPatrick Bellasi 85569842cbaSPatrick Bellasi For example, with the minimum configuration value we will have 5 85669842cbaSPatrick Bellasi clamp buckets tracking 20% utilization each. A 25% boosted tasks will 85769842cbaSPatrick Bellasi be refcounted in the [20..39]% bucket and will set the bucket clamp 85869842cbaSPatrick Bellasi effective value to 25%. 85969842cbaSPatrick Bellasi If a second 30% boosted task should be co-scheduled on the same CPU, 86069842cbaSPatrick Bellasi that task will be refcounted in the same bucket of the first task and 86169842cbaSPatrick Bellasi it will boost the bucket clamp effective value to 30%. 86269842cbaSPatrick Bellasi The clamp effective value of a bucket is reset to its nominal value 86369842cbaSPatrick Bellasi (20% in the example above) when there are no more tasks refcounted in 86469842cbaSPatrick Bellasi that bucket. 86569842cbaSPatrick Bellasi 86669842cbaSPatrick Bellasi An additional boost/capping margin can be added to some tasks. In the 86769842cbaSPatrick Bellasi example above the 25% task will be boosted to 30% until it exits the 86869842cbaSPatrick Bellasi CPU. If that should be considered not acceptable on certain systems, 86969842cbaSPatrick Bellasi it's always possible to reduce the margin by increasing the number of 87069842cbaSPatrick Bellasi clamp buckets to trade off used memory for run-time tracking 87169842cbaSPatrick Bellasi precision. 87269842cbaSPatrick Bellasi 87369842cbaSPatrick Bellasi If in doubt, use the default value. 87469842cbaSPatrick Bellasi 87569842cbaSPatrick Bellasiendmenu 87669842cbaSPatrick Bellasi 877be3a7284SAndrea Arcangeli# 878be3a7284SAndrea Arcangeli# For architectures that want to enable the support for NUMA-affine scheduler 879be3a7284SAndrea Arcangeli# balancing logic: 880be3a7284SAndrea Arcangeli# 881be3a7284SAndrea Arcangeliconfig ARCH_SUPPORTS_NUMA_BALANCING 882be3a7284SAndrea Arcangeli bool 883be3a7284SAndrea Arcangeli 884be5e610cSPeter Zijlstra# 88572b252aeSMel Gorman# For architectures that prefer to flush all TLBs after a number of pages 88672b252aeSMel Gorman# are unmapped instead of sending one IPI per page to flush. The architecture 88772b252aeSMel Gorman# must provide guarantees on what happens if a clean TLB cache entry is 88872b252aeSMel Gorman# written after the unmap. Details are in mm/rmap.c near the check for 88972b252aeSMel Gorman# should_defer_flush. The architecture should also consider if the full flush 89072b252aeSMel Gorman# and the refill costs are offset by the savings of sending fewer IPIs. 89172b252aeSMel Gormanconfig ARCH_WANT_BATCHED_UNMAP_TLB_FLUSH 89272b252aeSMel Gorman bool 89372b252aeSMel Gorman 894c12d3362SArd Biesheuvelconfig CC_HAS_INT128 8953a7c7331SMasahiro Yamada def_bool !$(cc-option,$(m64-flag) -D__SIZEOF_INT128__=0) && 64BIT 896c12d3362SArd Biesheuvel 897dee2b702SGustavo A. R. Silvaconfig CC_IMPLICIT_FALLTHROUGH 898dee2b702SGustavo A. R. Silva string 899158ea2d2SGustavo A. R. Silva default "-Wimplicit-fallthrough=5" if CC_IS_GCC && $(cc-option,-Wimplicit-fallthrough=5) 900dee2b702SGustavo A. R. Silva default "-Wimplicit-fallthrough" if CC_IS_CLANG && $(cc-option,-Wunreachable-code-fallthrough) 901dee2b702SGustavo A. R. Silva 90272b252aeSMel Gorman# 903be5e610cSPeter Zijlstra# For architectures that know their GCC __int128 support is sound 904be5e610cSPeter Zijlstra# 905be5e610cSPeter Zijlstraconfig ARCH_SUPPORTS_INT128 906be5e610cSPeter Zijlstra bool 907be5e610cSPeter Zijlstra 908be3a7284SAndrea Arcangeli# For architectures that (ab)use NUMA to represent different memory regions 909be3a7284SAndrea Arcangeli# all cpu-local but of different latencies, such as SuperH. 910be3a7284SAndrea Arcangeli# 911be3a7284SAndrea Arcangeliconfig ARCH_WANT_NUMA_VARIABLE_LOCALITY 912be3a7284SAndrea Arcangeli bool 913be3a7284SAndrea Arcangeli 914be3a7284SAndrea Arcangeliconfig NUMA_BALANCING 915be3a7284SAndrea Arcangeli bool "Memory placement aware NUMA scheduler" 916be3a7284SAndrea Arcangeli depends on ARCH_SUPPORTS_NUMA_BALANCING 917be3a7284SAndrea Arcangeli depends on !ARCH_WANT_NUMA_VARIABLE_LOCALITY 918554b0f3cSSebastian Andrzej Siewior depends on SMP && NUMA && MIGRATION && !PREEMPT_RT 919be3a7284SAndrea Arcangeli help 920be3a7284SAndrea Arcangeli This option adds support for automatic NUMA aware memory/task placement. 921be3a7284SAndrea Arcangeli The mechanism is quite primitive and is based on migrating memory when 9226d56a410SPaul Gortmaker it has references to the node the task is running on. 923be3a7284SAndrea Arcangeli 924be3a7284SAndrea Arcangeli This system will be inactive on UMA systems. 925be3a7284SAndrea Arcangeli 9266f7c97e8SAneesh Kumar K.Vconfig NUMA_BALANCING_DEFAULT_ENABLED 9276f7c97e8SAneesh Kumar K.V bool "Automatically enable NUMA aware memory/task placement" 9286f7c97e8SAneesh Kumar K.V default y 9296f7c97e8SAneesh Kumar K.V depends on NUMA_BALANCING 9306f7c97e8SAneesh Kumar K.V help 9316f7c97e8SAneesh Kumar K.V If set, automatic NUMA balancing will be enabled if running on a NUMA 9326f7c97e8SAneesh Kumar K.V machine. 9336f7c97e8SAneesh Kumar K.V 93423964d2dSLi Zefanmenuconfig CGROUPS 9356341e62bSChristoph Jaeger bool "Control Group support" 9362bd59d48STejun Heo select KERNFS 937ddbcc7e8SPaul Menage help 93823964d2dSLi Zefan This option adds support for grouping sets of processes together, for 9395cdc38f9SKAMEZAWA Hiroyuki use with process control subsystems such as Cpusets, CFS, memory 9405cdc38f9SKAMEZAWA Hiroyuki controls or device isolation. 9415cdc38f9SKAMEZAWA Hiroyuki See 942d6a3b247SMauro Carvalho Chehab - Documentation/scheduler/sched-design-CFS.rst (CFS) 943da82c92fSMauro Carvalho Chehab - Documentation/admin-guide/cgroup-v1/ (features for grouping, isolation 94445ce80fbSLi Zefan and resource control) 945ddbcc7e8SPaul Menage 946ddbcc7e8SPaul Menage Say N if unsure. 947ddbcc7e8SPaul Menage 94823964d2dSLi Zefanif CGROUPS 94923964d2dSLi Zefan 9503e32cb2eSJohannes Weinerconfig PAGE_COUNTER 9513e32cb2eSJohannes Weiner bool 9523e32cb2eSJohannes Weiner 953c255a458SAndrew Mortonconfig MEMCG 954a0166ec4SJohannes Weiner bool "Memory controller" 9553e32cb2eSJohannes Weiner select PAGE_COUNTER 95679bd9814STejun Heo select EVENTFD 95700f0b825SBalbir Singh help 958a0166ec4SJohannes Weiner Provides control over the memory footprint of tasks in a cgroup. 95900f0b825SBalbir Singh 960c255a458SAndrew Mortonconfig MEMCG_SWAP 9612d1c4980SJohannes Weiner bool 962c255a458SAndrew Morton depends on MEMCG && SWAP 963a42c390cSMichal Hocko default y 964c077719bSKAMEZAWA Hiroyuki 96584c07d11SKirill Tkhaiconfig MEMCG_KMEM 96684c07d11SKirill Tkhai bool 96784c07d11SKirill Tkhai depends on MEMCG && !SLOB 96884c07d11SKirill Tkhai default y 96984c07d11SKirill Tkhai 9706bf024e6SJohannes Weinerconfig BLK_CGROUP 9716bf024e6SJohannes Weiner bool "IO controller" 9726bf024e6SJohannes Weiner depends on BLOCK 9732bc64a20SAneesh Kumar K.V default n 974a7f7f624SMasahiro Yamada help 9756bf024e6SJohannes Weiner Generic block IO controller cgroup interface. This is the common 9766bf024e6SJohannes Weiner cgroup interface which should be used by various IO controlling 9776bf024e6SJohannes Weiner policies. 9782bc64a20SAneesh Kumar K.V 9796bf024e6SJohannes Weiner Currently, CFQ IO scheduler uses it to recognize task groups and 9806bf024e6SJohannes Weiner control disk bandwidth allocation (proportional time slice allocation) 9816bf024e6SJohannes Weiner to such task groups. It is also used by bio throttling logic in 9826bf024e6SJohannes Weiner block layer to implement upper limit in IO rates on a device. 983e5d1367fSStephane Eranian 9846bf024e6SJohannes Weiner This option only enables generic Block IO controller infrastructure. 9856bf024e6SJohannes Weiner One needs to also enable actual IO controlling logic/policy. For 9866bf024e6SJohannes Weiner enabling proportional weight division of disk bandwidth in CFQ, set 9877baf2199SKrzysztof Kozlowski CONFIG_BFQ_GROUP_IOSCHED=y; for enabling throttling policy, set 9886bf024e6SJohannes Weiner CONFIG_BLK_DEV_THROTTLING=y. 9896bf024e6SJohannes Weiner 990da82c92fSMauro Carvalho Chehab See Documentation/admin-guide/cgroup-v1/blkio-controller.rst for more information. 9916bf024e6SJohannes Weiner 9926bf024e6SJohannes Weinerconfig CGROUP_WRITEBACK 9936bf024e6SJohannes Weiner bool 9946bf024e6SJohannes Weiner depends on MEMCG && BLK_CGROUP 9956bf024e6SJohannes Weiner default y 996e5d1367fSStephane Eranian 9977c941438SDhaval Gianimenuconfig CGROUP_SCHED 998a0166ec4SJohannes Weiner bool "CPU controller" 9997c941438SDhaval Giani default n 10007c941438SDhaval Giani help 10017c941438SDhaval Giani This feature lets CPU scheduler recognize task groups and control CPU 10027c941438SDhaval Giani bandwidth allocation to such task groups. It uses cgroups to group 10037c941438SDhaval Giani tasks. 10047c941438SDhaval Giani 10057c941438SDhaval Gianiif CGROUP_SCHED 10067c941438SDhaval Gianiconfig FAIR_GROUP_SCHED 10077c941438SDhaval Giani bool "Group scheduling for SCHED_OTHER" 10087c941438SDhaval Giani depends on CGROUP_SCHED 10097c941438SDhaval Giani default CGROUP_SCHED 10107c941438SDhaval Giani 1011ab84d31eSPaul Turnerconfig CFS_BANDWIDTH 1012ab84d31eSPaul Turner bool "CPU bandwidth provisioning for FAIR_GROUP_SCHED" 1013ab84d31eSPaul Turner depends on FAIR_GROUP_SCHED 1014ab84d31eSPaul Turner default n 1015ab84d31eSPaul Turner help 1016ab84d31eSPaul Turner This option allows users to define CPU bandwidth rates (limits) for 1017ab84d31eSPaul Turner tasks running within the fair group scheduler. Groups with no limit 1018ab84d31eSPaul Turner set are considered to be unconstrained and will run with no 1019ab84d31eSPaul Turner restriction. 1020d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-bwc.rst for more information. 1021ab84d31eSPaul Turner 10227c941438SDhaval Gianiconfig RT_GROUP_SCHED 10237c941438SDhaval Giani bool "Group scheduling for SCHED_RR/FIFO" 10247c941438SDhaval Giani depends on CGROUP_SCHED 10257c941438SDhaval Giani default n 10267c941438SDhaval Giani help 10277c941438SDhaval Giani This feature lets you explicitly allocate real CPU bandwidth 102832bd7eb5SLi Zefan to task groups. If enabled, it will also make it impossible to 10297c941438SDhaval Giani schedule realtime tasks for non-root users until you allocate 10307c941438SDhaval Giani realtime bandwidth for them. 1031d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-rt-group.rst for more information. 10327c941438SDhaval Giani 10337c941438SDhaval Gianiendif #CGROUP_SCHED 10347c941438SDhaval Giani 10352480c093SPatrick Bellasiconfig UCLAMP_TASK_GROUP 10362480c093SPatrick Bellasi bool "Utilization clamping per group of tasks" 10372480c093SPatrick Bellasi depends on CGROUP_SCHED 10382480c093SPatrick Bellasi depends on UCLAMP_TASK 10392480c093SPatrick Bellasi default n 10402480c093SPatrick Bellasi help 10412480c093SPatrick Bellasi This feature enables the scheduler to track the clamped utilization 10422480c093SPatrick Bellasi of each CPU based on RUNNABLE tasks currently scheduled on that CPU. 10432480c093SPatrick Bellasi 10442480c093SPatrick Bellasi When this option is enabled, the user can specify a min and max 10452480c093SPatrick Bellasi CPU bandwidth which is allowed for each single task in a group. 10462480c093SPatrick Bellasi The max bandwidth allows to clamp the maximum frequency a task 10472480c093SPatrick Bellasi can use, while the min bandwidth allows to define a minimum 10482480c093SPatrick Bellasi frequency a task will always use. 10492480c093SPatrick Bellasi 10502480c093SPatrick Bellasi When task group based utilization clamping is enabled, an eventually 10512480c093SPatrick Bellasi specified task-specific clamp value is constrained by the cgroup 10522480c093SPatrick Bellasi specified clamp value. Both minimum and maximum task clamping cannot 10532480c093SPatrick Bellasi be bigger than the corresponding clamping defined at task group level. 10542480c093SPatrick Bellasi 10552480c093SPatrick Bellasi If in doubt, say N. 10562480c093SPatrick Bellasi 10576bf024e6SJohannes Weinerconfig CGROUP_PIDS 10586bf024e6SJohannes Weiner bool "PIDs controller" 10596bf024e6SJohannes Weiner help 10606bf024e6SJohannes Weiner Provides enforcement of process number limits in the scope of a 10616bf024e6SJohannes Weiner cgroup. Any attempt to fork more processes than is allowed in the 10626bf024e6SJohannes Weiner cgroup will fail. PIDs are fundamentally a global resource because it 10636bf024e6SJohannes Weiner is fairly trivial to reach PID exhaustion before you reach even a 10646bf024e6SJohannes Weiner conservative kmemcg limit. As a result, it is possible to grind a 10656bf024e6SJohannes Weiner system to halt without being limited by other cgroup policies. The 10666cc578dfSParav Pandit PIDs controller is designed to stop this from happening. 10676bf024e6SJohannes Weiner 10686bf024e6SJohannes Weiner It should be noted that organisational operations (such as attaching 106998076833SJonathan Neuschäfer to a cgroup hierarchy) will *not* be blocked by the PIDs controller, 10706bf024e6SJohannes Weiner since the PIDs limit only affects a process's ability to fork, not to 10716bf024e6SJohannes Weiner attach to a cgroup. 10726bf024e6SJohannes Weiner 107339d3e758SParav Panditconfig CGROUP_RDMA 107439d3e758SParav Pandit bool "RDMA controller" 107539d3e758SParav Pandit help 107639d3e758SParav Pandit Provides enforcement of RDMA resources defined by IB stack. 107739d3e758SParav Pandit It is fairly easy for consumers to exhaust RDMA resources, which 107839d3e758SParav Pandit can result into resource unavailability to other consumers. 107939d3e758SParav Pandit RDMA controller is designed to stop this from happening. 108039d3e758SParav Pandit Attaching processes with active RDMA resources to the cgroup 108139d3e758SParav Pandit hierarchy is allowed even if can cross the hierarchy's limit. 108239d3e758SParav Pandit 10836bf024e6SJohannes Weinerconfig CGROUP_FREEZER 10846bf024e6SJohannes Weiner bool "Freezer controller" 10856bf024e6SJohannes Weiner help 10866bf024e6SJohannes Weiner Provides a way to freeze and unfreeze all tasks in a 10876bf024e6SJohannes Weiner cgroup. 10886bf024e6SJohannes Weiner 1089489c2a20SJohannes Weiner This option affects the ORIGINAL cgroup interface. The cgroup2 memory 1090489c2a20SJohannes Weiner controller includes important in-kernel memory consumers per default. 1091489c2a20SJohannes Weiner 1092489c2a20SJohannes Weiner If you're using cgroup2, say N. 1093489c2a20SJohannes Weiner 10946bf024e6SJohannes Weinerconfig CGROUP_HUGETLB 10956bf024e6SJohannes Weiner bool "HugeTLB controller" 10966bf024e6SJohannes Weiner depends on HUGETLB_PAGE 10976bf024e6SJohannes Weiner select PAGE_COUNTER 1098afc24d49SVivek Goyal default n 10996bf024e6SJohannes Weiner help 11006bf024e6SJohannes Weiner Provides a cgroup controller for HugeTLB pages. 11016bf024e6SJohannes Weiner When you enable this, you can put a per cgroup limit on HugeTLB usage. 11026bf024e6SJohannes Weiner The limit is enforced during page fault. Since HugeTLB doesn't 11036bf024e6SJohannes Weiner support page reclaim, enforcing the limit at page fault time implies 11046bf024e6SJohannes Weiner that, the application will get SIGBUS signal if it tries to access 11056bf024e6SJohannes Weiner HugeTLB pages beyond its limit. This requires the application to know 11066bf024e6SJohannes Weiner beforehand how much HugeTLB pages it would require for its use. The 11076bf024e6SJohannes Weiner control group is tracked in the third page lru pointer. This means 11086bf024e6SJohannes Weiner that we cannot use the controller with huge page less than 3 pages. 1109afc24d49SVivek Goyal 11106bf024e6SJohannes Weinerconfig CPUSETS 11116bf024e6SJohannes Weiner bool "Cpuset controller" 1112e1d4eeecSNicolas Pitre depends on SMP 11136bf024e6SJohannes Weiner help 11146bf024e6SJohannes Weiner This option will let you create and manage CPUSETs which 11156bf024e6SJohannes Weiner allow dynamically partitioning a system into sets of CPUs and 11166bf024e6SJohannes Weiner Memory Nodes and assigning tasks to run only within those sets. 11176bf024e6SJohannes Weiner This is primarily useful on large SMP or NUMA systems. 1118afc24d49SVivek Goyal 11196bf024e6SJohannes Weiner Say N if unsure. 1120afc24d49SVivek Goyal 11216bf024e6SJohannes Weinerconfig PROC_PID_CPUSET 11226bf024e6SJohannes Weiner bool "Include legacy /proc/<pid>/cpuset file" 11236bf024e6SJohannes Weiner depends on CPUSETS 112489e9b9e0STejun Heo default y 112589e9b9e0STejun Heo 11266bf024e6SJohannes Weinerconfig CGROUP_DEVICE 11276bf024e6SJohannes Weiner bool "Device controller" 11286bf024e6SJohannes Weiner help 11296bf024e6SJohannes Weiner Provides a cgroup controller implementing whitelists for 11306bf024e6SJohannes Weiner devices which a process in the cgroup can mknod or open. 11316bf024e6SJohannes Weiner 11326bf024e6SJohannes Weinerconfig CGROUP_CPUACCT 11336bf024e6SJohannes Weiner bool "Simple CPU accounting controller" 11346bf024e6SJohannes Weiner help 11356bf024e6SJohannes Weiner Provides a simple controller for monitoring the 11366bf024e6SJohannes Weiner total CPU consumed by the tasks in a cgroup. 11376bf024e6SJohannes Weiner 11386bf024e6SJohannes Weinerconfig CGROUP_PERF 11396bf024e6SJohannes Weiner bool "Perf controller" 11406bf024e6SJohannes Weiner depends on PERF_EVENTS 11416bf024e6SJohannes Weiner help 11426bf024e6SJohannes Weiner This option extends the perf per-cpu mode to restrict monitoring 11436bf024e6SJohannes Weiner to threads which belong to the cgroup specified and run on the 11446546b19fSNamhyung Kim designated cpu. Or this can be used to have cgroup ID in samples 11456546b19fSNamhyung Kim so that it can monitor performance events among cgroups. 11466bf024e6SJohannes Weiner 11476bf024e6SJohannes Weiner Say N if unsure. 11486bf024e6SJohannes Weiner 114930070984SDaniel Mackconfig CGROUP_BPF 115030070984SDaniel Mack bool "Support for eBPF programs attached to cgroups" 1151483c4933SAndy Lutomirski depends on BPF_SYSCALL 1152483c4933SAndy Lutomirski select SOCK_CGROUP_DATA 115330070984SDaniel Mack help 115430070984SDaniel Mack Allow attaching eBPF programs to a cgroup using the bpf(2) 115530070984SDaniel Mack syscall command BPF_PROG_ATTACH. 115630070984SDaniel Mack 115730070984SDaniel Mack In which context these programs are accessed depends on the type 115830070984SDaniel Mack of attachment. For instance, programs that are attached using 115930070984SDaniel Mack BPF_CGROUP_INET_INGRESS will be executed on the ingress path of 116030070984SDaniel Mack inet sockets. 116130070984SDaniel Mack 1162a72232eaSVipin Sharmaconfig CGROUP_MISC 1163a72232eaSVipin Sharma bool "Misc resource controller" 1164a72232eaSVipin Sharma default n 1165a72232eaSVipin Sharma help 1166a72232eaSVipin Sharma Provides a controller for miscellaneous resources on a host. 1167a72232eaSVipin Sharma 1168a72232eaSVipin Sharma Miscellaneous scalar resources are the resources on the host system 1169a72232eaSVipin Sharma which cannot be abstracted like the other cgroups. This controller 1170a72232eaSVipin Sharma tracks and limits the miscellaneous resources used by a process 1171a72232eaSVipin Sharma attached to a cgroup hierarchy. 1172a72232eaSVipin Sharma 1173a72232eaSVipin Sharma For more information, please check misc cgroup section in 1174a72232eaSVipin Sharma /Documentation/admin-guide/cgroup-v2.rst. 1175a72232eaSVipin Sharma 11766bf024e6SJohannes Weinerconfig CGROUP_DEBUG 117723b0be48SWaiman Long bool "Debug controller" 11786bf024e6SJohannes Weiner default n 117923b0be48SWaiman Long depends on DEBUG_KERNEL 11806bf024e6SJohannes Weiner help 11816bf024e6SJohannes Weiner This option enables a simple controller that exports 118223b0be48SWaiman Long debugging information about the cgroups framework. This 118323b0be48SWaiman Long controller is for control cgroup debugging only. Its 118423b0be48SWaiman Long interfaces are not stable. 11856bf024e6SJohannes Weiner 11866bf024e6SJohannes Weiner Say N. 11876bf024e6SJohannes Weiner 118873b35147SArnd Bergmannconfig SOCK_CGROUP_DATA 118973b35147SArnd Bergmann bool 119073b35147SArnd Bergmann default n 119173b35147SArnd Bergmann 119223964d2dSLi Zefanendif # CGROUPS 1193c077719bSKAMEZAWA Hiroyuki 11948dd2a82cSDaniel Lezcanomenuconfig NAMESPACES 11956a108a14SDavid Rientjes bool "Namespaces support" if EXPERT 11962813893fSIulia Manda depends on MULTIUSER 11976a108a14SDavid Rientjes default !EXPERT 1198c5289a69SPavel Emelyanov help 1199c5289a69SPavel Emelyanov Provides the way to make tasks work with different objects using 1200c5289a69SPavel Emelyanov the same id. For example same IPC id may refer to different objects 1201c5289a69SPavel Emelyanov or same user id or pid may refer to different tasks when used in 1202c5289a69SPavel Emelyanov different namespaces. 1203c5289a69SPavel Emelyanov 12048dd2a82cSDaniel Lezcanoif NAMESPACES 12058dd2a82cSDaniel Lezcano 120658bfdd6dSPavel Emelyanovconfig UTS_NS 120758bfdd6dSPavel Emelyanov bool "UTS namespace" 120817a6d441SDaniel Lezcano default y 120958bfdd6dSPavel Emelyanov help 121058bfdd6dSPavel Emelyanov In this namespace tasks see different info provided with the 121158bfdd6dSPavel Emelyanov uname() system call 121258bfdd6dSPavel Emelyanov 1213769071acSAndrei Vaginconfig TIME_NS 1214769071acSAndrei Vagin bool "TIME namespace" 1215660fd04fSThomas Gleixner depends on GENERIC_VDSO_TIME_NS 1216769071acSAndrei Vagin default y 1217769071acSAndrei Vagin help 1218769071acSAndrei Vagin In this namespace boottime and monotonic clocks can be set. 1219769071acSAndrei Vagin The time will keep going with the same pace. 1220769071acSAndrei Vagin 1221ae5e1b22SPavel Emelyanovconfig IPC_NS 1222ae5e1b22SPavel Emelyanov bool "IPC namespace" 12238dd2a82cSDaniel Lezcano depends on (SYSVIPC || POSIX_MQUEUE) 122417a6d441SDaniel Lezcano default y 1225ae5e1b22SPavel Emelyanov help 1226ae5e1b22SPavel Emelyanov In this namespace tasks work with IPC ids which correspond to 1227614b84cfSSerge E. Hallyn different IPC objects in different namespaces. 1228ae5e1b22SPavel Emelyanov 1229aee16ce7SPavel Emelyanovconfig USER_NS 123019c92399SKees Cook bool "User namespace" 12315673a94cSEric W. Biederman default n 1232aee16ce7SPavel Emelyanov help 1233aee16ce7SPavel Emelyanov This allows containers, i.e. vservers, to use user namespaces 1234aee16ce7SPavel Emelyanov to provide different user info for different servers. 1235e11f0ae3SEric W. Biederman 1236e11f0ae3SEric W. Biederman When user namespaces are enabled in the kernel it is 1237d886f4e4SJohannes Weiner recommended that the MEMCG option also be enabled and that 1238d886f4e4SJohannes Weiner user-space use the memory control groups to limit the amount 1239d886f4e4SJohannes Weiner of memory a memory unprivileged users can use. 1240e11f0ae3SEric W. Biederman 1241aee16ce7SPavel Emelyanov If unsure, say N. 1242aee16ce7SPavel Emelyanov 124374bd59bbSPavel Emelyanovconfig PID_NS 12449bd38c2cSDaniel Lezcano bool "PID Namespaces" 124517a6d441SDaniel Lezcano default y 124674bd59bbSPavel Emelyanov help 124712d2b8f9SHeikki Orsila Support process id namespaces. This allows having multiple 1248692105b8SMatt LaPlante processes with the same pid as long as they are in different 124974bd59bbSPavel Emelyanov pid namespaces. This is a building block of containers. 125074bd59bbSPavel Emelyanov 1251d6eb633fSMatt Helsleyconfig NET_NS 1252d6eb633fSMatt Helsley bool "Network namespace" 12538dd2a82cSDaniel Lezcano depends on NET 125417a6d441SDaniel Lezcano default y 1255d6eb633fSMatt Helsley help 1256d6eb633fSMatt Helsley Allow user space to create what appear to be multiple instances 1257d6eb633fSMatt Helsley of the network stack. 1258d6eb633fSMatt Helsley 12598dd2a82cSDaniel Lezcanoendif # NAMESPACES 12608dd2a82cSDaniel Lezcano 12615cb366bbSAdrian Reberconfig CHECKPOINT_RESTORE 12625cb366bbSAdrian Reber bool "Checkpoint/restore support" 12635cb366bbSAdrian Reber select PROC_CHILDREN 1264bfe3911aSChris Wilson select KCMP 12655cb366bbSAdrian Reber default n 12665cb366bbSAdrian Reber help 12675cb366bbSAdrian Reber Enables additional kernel features in a sake of checkpoint/restore. 12685cb366bbSAdrian Reber In particular it adds auxiliary prctl codes to setup process text, 12695cb366bbSAdrian Reber data and heap segment sizes, and a few additional /proc filesystem 12705cb366bbSAdrian Reber entries. 12715cb366bbSAdrian Reber 12725cb366bbSAdrian Reber If unsure, say N here. 12735cb366bbSAdrian Reber 12745091faa4SMike Galbraithconfig SCHED_AUTOGROUP 12755091faa4SMike Galbraith bool "Automatic process group scheduling" 12765091faa4SMike Galbraith select CGROUPS 12775091faa4SMike Galbraith select CGROUP_SCHED 12785091faa4SMike Galbraith select FAIR_GROUP_SCHED 12795091faa4SMike Galbraith help 12805091faa4SMike Galbraith This option optimizes the scheduler for common desktop workloads by 12815091faa4SMike Galbraith automatically creating and populating task groups. This separation 12825091faa4SMike Galbraith of workloads isolates aggressive CPU burners (like build jobs) from 12835091faa4SMike Galbraith desktop applications. Task group autogeneration is currently based 12845091faa4SMike Galbraith upon task session. 12855091faa4SMike Galbraith 12867af37becSDaniel Lezcanoconfig SYSFS_DEPRECATED 12875d6a4ea5SFerenc Wagner bool "Enable deprecated sysfs features to support old userspace tools" 12887af37becSDaniel Lezcano depends on SYSFS 12897af37becSDaniel Lezcano default n 12907af37becSDaniel Lezcano help 12917af37becSDaniel Lezcano This option adds code that switches the layout of the "block" class 12927af37becSDaniel Lezcano devices, to not show up in /sys/class/block/, but only in 12937af37becSDaniel Lezcano /sys/block/. 12947af37becSDaniel Lezcano 12957af37becSDaniel Lezcano This switch is only active when the sysfs.deprecated=1 boot option is 12967af37becSDaniel Lezcano passed or the SYSFS_DEPRECATED_V2 option is set. 12977af37becSDaniel Lezcano 12987af37becSDaniel Lezcano This option allows new kernels to run on old distributions and tools, 12997af37becSDaniel Lezcano which might get confused by /sys/class/block/. Since 2007/2008 all 13007af37becSDaniel Lezcano major distributions and tools handle this just fine. 13017af37becSDaniel Lezcano 13027af37becSDaniel Lezcano Recent distributions and userspace tools after 2009/2010 depend on 13037af37becSDaniel Lezcano the existence of /sys/class/block/, and will not work with this 13047af37becSDaniel Lezcano option enabled. 13057af37becSDaniel Lezcano 13067af37becSDaniel Lezcano Only if you are using a new kernel on an old distribution, you might 13077af37becSDaniel Lezcano need to say Y here. 13087af37becSDaniel Lezcano 13097af37becSDaniel Lezcanoconfig SYSFS_DEPRECATED_V2 13105d6a4ea5SFerenc Wagner bool "Enable deprecated sysfs features by default" 13117af37becSDaniel Lezcano default n 13127af37becSDaniel Lezcano depends on SYSFS 13137af37becSDaniel Lezcano depends on SYSFS_DEPRECATED 13147af37becSDaniel Lezcano help 13157af37becSDaniel Lezcano Enable deprecated sysfs by default. 13167af37becSDaniel Lezcano 13177af37becSDaniel Lezcano See the CONFIG_SYSFS_DEPRECATED option for more details about this 13187af37becSDaniel Lezcano option. 13197af37becSDaniel Lezcano 13207af37becSDaniel Lezcano Only if you are using a new kernel on an old distribution, you might 13217af37becSDaniel Lezcano need to say Y here. Even then, odds are you would not need it 13227af37becSDaniel Lezcano enabled, you can always pass the boot option if absolutely necessary. 13237af37becSDaniel Lezcano 13247af37becSDaniel Lezcanoconfig RELAY 13257af37becSDaniel Lezcano bool "Kernel->user space relay support (formerly relayfs)" 132626b5679eSPeter Zijlstra select IRQ_WORK 13277af37becSDaniel Lezcano help 13287af37becSDaniel Lezcano This option enables support for relay interface support in 13297af37becSDaniel Lezcano certain file systems (such as debugfs). 13307af37becSDaniel Lezcano It is designed to provide an efficient mechanism for tools and 13317af37becSDaniel Lezcano facilities to relay large amounts of data from kernel space to 13327af37becSDaniel Lezcano user space. 13337af37becSDaniel Lezcano 13347af37becSDaniel Lezcano If unsure, say N. 13357af37becSDaniel Lezcano 1336f991633dSDimitri Gorokhovikconfig BLK_DEV_INITRD 1337f991633dSDimitri Gorokhovik bool "Initial RAM filesystem and RAM disk (initramfs/initrd) support" 1338f991633dSDimitri Gorokhovik help 1339f991633dSDimitri Gorokhovik The initial RAM filesystem is a ramfs which is loaded by the 1340f991633dSDimitri Gorokhovik boot loader (loadlin or lilo) and that is mounted as root 1341f991633dSDimitri Gorokhovik before the normal boot procedure. It is typically used to 1342f991633dSDimitri Gorokhovik load modules needed to mount the "real" root file system, 13438c27ceffSMauro Carvalho Chehab etc. See <file:Documentation/admin-guide/initrd.rst> for details. 1344f991633dSDimitri Gorokhovik 1345f991633dSDimitri Gorokhovik If RAM disk support (BLK_DEV_RAM) is also included, this 1346f991633dSDimitri Gorokhovik also enables initial RAM disk (initrd) support and adds 1347f991633dSDimitri Gorokhovik 15 Kbytes (more on some other architectures) to the kernel size. 1348f991633dSDimitri Gorokhovik 1349f991633dSDimitri Gorokhovik If unsure say Y. 1350f991633dSDimitri Gorokhovik 1351c33df4eaSJean-Paul Samanif BLK_DEV_INITRD 1352c33df4eaSJean-Paul Saman 1353dbec4866SSam Ravnborgsource "usr/Kconfig" 1354dbec4866SSam Ravnborg 1355c33df4eaSJean-Paul Samanendif 1356c33df4eaSJean-Paul Saman 135776db5a27SMasami Hiramatsuconfig BOOT_CONFIG 135876db5a27SMasami Hiramatsu bool "Boot config support" 13592910b5aaSMasami Hiramatsu select BLK_DEV_INITRD 136076db5a27SMasami Hiramatsu help 136176db5a27SMasami Hiramatsu Extra boot config allows system admin to pass a config file as 136276db5a27SMasami Hiramatsu complemental extension of kernel cmdline when booting. 13630947db01SMasami Hiramatsu The boot config file must be attached at the end of initramfs 136485c46b78SMasami Hiramatsu with checksum, size and magic word. 13650947db01SMasami Hiramatsu See <file:Documentation/admin-guide/bootconfig.rst> for details. 136676db5a27SMasami Hiramatsu 136776db5a27SMasami Hiramatsu If unsure, say Y. 136876db5a27SMasami Hiramatsu 1369877417e6SArnd Bergmannchoice 1370877417e6SArnd Bergmann prompt "Compiler optimization level" 13712cc3ce24SUlf Magnusson default CC_OPTIMIZE_FOR_PERFORMANCE 1372877417e6SArnd Bergmann 1373877417e6SArnd Bergmannconfig CC_OPTIMIZE_FOR_PERFORMANCE 137415f5db60SMasahiro Yamada bool "Optimize for performance (-O2)" 1375877417e6SArnd Bergmann help 1376877417e6SArnd Bergmann This is the default optimization level for the kernel, building 1377877417e6SArnd Bergmann with the "-O2" compiler flag for best performance and most 1378877417e6SArnd Bergmann helpful compile-time warnings. 1379877417e6SArnd Bergmann 138015f5db60SMasahiro Yamadaconfig CC_OPTIMIZE_FOR_PERFORMANCE_O3 138115f5db60SMasahiro Yamada bool "Optimize more for performance (-O3)" 138215f5db60SMasahiro Yamada depends on ARC 1383c45b4f1fSLinus Torvalds help 138415f5db60SMasahiro Yamada Choosing this option will pass "-O3" to your compiler to optimize 138515f5db60SMasahiro Yamada the kernel yet more for performance. 1386c45b4f1fSLinus Torvalds 13875d20ee31SNicholas Pigginconfig CC_OPTIMIZE_FOR_SIZE 138815f5db60SMasahiro Yamada bool "Optimize for size (-Os)" 1389c45b4f1fSLinus Torvalds help 1390ce3b487fSMasahiro Yamada Choosing this option will pass "-Os" to your compiler resulting 1391ce3b487fSMasahiro Yamada in a smaller kernel. 1392c45b4f1fSLinus Torvalds 1393877417e6SArnd Bergmannendchoice 1394877417e6SArnd Bergmann 13955d20ee31SNicholas Pigginconfig HAVE_LD_DEAD_CODE_DATA_ELIMINATION 13965d20ee31SNicholas Piggin bool 13975d20ee31SNicholas Piggin help 13985d20ee31SNicholas Piggin This requires that the arch annotates or otherwise protects 13995d20ee31SNicholas Piggin its external entry points from being discarded. Linker scripts 14005d20ee31SNicholas Piggin must also merge .text.*, .data.*, and .bss.* correctly into 14015d20ee31SNicholas Piggin output sections. Care must be taken not to pull in unrelated 14025d20ee31SNicholas Piggin sections (e.g., '.text.init'). Typically '.' in section names 14035d20ee31SNicholas Piggin is used to distinguish them from label names / C identifiers. 14045d20ee31SNicholas Piggin 14055d20ee31SNicholas Pigginconfig LD_DEAD_CODE_DATA_ELIMINATION 14065d20ee31SNicholas Piggin bool "Dead code and data elimination (EXPERIMENTAL)" 14075d20ee31SNicholas Piggin depends on HAVE_LD_DEAD_CODE_DATA_ELIMINATION 14085d20ee31SNicholas Piggin depends on EXPERT 1409e85d1d65SMasahiro Yamada depends on $(cc-option,-ffunction-sections -fdata-sections) 1410e85d1d65SMasahiro Yamada depends on $(ld-option,--gc-sections) 14115d20ee31SNicholas Piggin help 14128b9d2712SMasahiro Yamada Enable this if you want to do dead code and data elimination with 14138b9d2712SMasahiro Yamada the linker by compiling with -ffunction-sections -fdata-sections, 14148b9d2712SMasahiro Yamada and linking with --gc-sections. 14155d20ee31SNicholas Piggin 14165d20ee31SNicholas Piggin This can reduce on disk and in-memory size of the kernel 14175d20ee31SNicholas Piggin code and static data, particularly for small configs and 14185d20ee31SNicholas Piggin on small systems. This has the possibility of introducing 14195d20ee31SNicholas Piggin silently broken kernel if the required annotations are not 14205d20ee31SNicholas Piggin present. This option is not well tested yet, so use at your 14215d20ee31SNicholas Piggin own risk. 14225d20ee31SNicholas Piggin 142359612b24SNathan Chancellorconfig LD_ORPHAN_WARN 142459612b24SNathan Chancellor def_bool y 142559612b24SNathan Chancellor depends on ARCH_WANT_LD_ORPHAN_WARN 142659612b24SNathan Chancellor depends on $(ld-option,--orphan-handling=warn) 142759612b24SNathan Chancellor 14280847062aSRandy Dunlapconfig SYSCTL 14290847062aSRandy Dunlap bool 14300847062aSRandy Dunlap 1431657a5209SMike Frysingerconfig HAVE_UID16 1432657a5209SMike Frysinger bool 1433657a5209SMike Frysinger 1434657a5209SMike Frysingerconfig SYSCTL_EXCEPTION_TRACE 1435657a5209SMike Frysinger bool 1436657a5209SMike Frysinger help 1437657a5209SMike Frysinger Enable support for /proc/sys/debug/exception-trace. 1438657a5209SMike Frysinger 1439657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_NO_WARN 1440657a5209SMike Frysinger bool 1441657a5209SMike Frysinger help 1442657a5209SMike Frysinger Enable support for /proc/sys/kernel/ignore-unaligned-usertrap 1443657a5209SMike Frysinger Allows arch to define/use @no_unaligned_warning to possibly warn 1444657a5209SMike Frysinger about unaligned access emulation going on under the hood. 1445657a5209SMike Frysinger 1446657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_ALLOW 1447657a5209SMike Frysinger bool 1448657a5209SMike Frysinger help 1449657a5209SMike Frysinger Enable support for /proc/sys/kernel/unaligned-trap 1450657a5209SMike Frysinger Allows arches to define/use @unaligned_enabled to runtime toggle 1451657a5209SMike Frysinger the unaligned access emulation. 1452657a5209SMike Frysinger see arch/parisc/kernel/unaligned.c for reference 1453657a5209SMike Frysinger 1454657a5209SMike Frysingerconfig HAVE_PCSPKR_PLATFORM 1455657a5209SMike Frysinger bool 1456657a5209SMike Frysinger 1457f89b7755SAlexei Starovoitov# interpreter that classic socket filters depend on 1458f89b7755SAlexei Starovoitovconfig BPF 1459f89b7755SAlexei Starovoitov bool 1460f89b7755SAlexei Starovoitov 14616a108a14SDavid Rientjesmenuconfig EXPERT 14626a108a14SDavid Rientjes bool "Configure standard kernel features (expert users)" 1463f505c553SJosh Triplett # Unhide debug options, to make the on-by-default options visible 1464f505c553SJosh Triplett select DEBUG_KERNEL 14651da177e4SLinus Torvalds help 14661da177e4SLinus Torvalds This option allows certain base kernel options and settings 14671da177e4SLinus Torvalds to be disabled or tweaked. This is for specialized 14681da177e4SLinus Torvalds environments which can tolerate a "non-standard" kernel. 14691da177e4SLinus Torvalds Only use this if you really know what you are doing. 14701da177e4SLinus Torvalds 1471ae81f9e3SChuck Ebbertconfig UID16 14726a108a14SDavid Rientjes bool "Enable 16-bit UID system calls" if EXPERT 14732813893fSIulia Manda depends on HAVE_UID16 && MULTIUSER 1474ae81f9e3SChuck Ebbert default y 1475ae81f9e3SChuck Ebbert help 1476ae81f9e3SChuck Ebbert This enables the legacy 16-bit UID syscall wrappers. 1477ae81f9e3SChuck Ebbert 14782813893fSIulia Mandaconfig MULTIUSER 14792813893fSIulia Manda bool "Multiple users, groups and capabilities support" if EXPERT 14802813893fSIulia Manda default y 14812813893fSIulia Manda help 14822813893fSIulia Manda This option enables support for non-root users, groups and 14832813893fSIulia Manda capabilities. 14842813893fSIulia Manda 14852813893fSIulia Manda If you say N here, all processes will run with UID 0, GID 0, and all 14862813893fSIulia Manda possible capabilities. Saying N here also compiles out support for 14872813893fSIulia Manda system calls related to UIDs, GIDs, and capabilities, such as setuid, 14882813893fSIulia Manda setgid, and capset. 14892813893fSIulia Manda 14902813893fSIulia Manda If unsure, say Y here. 14912813893fSIulia Manda 1492f6187769SFabian Frederickconfig SGETMASK_SYSCALL 1493f6187769SFabian Frederick bool "sgetmask/ssetmask syscalls support" if EXPERT 1494a687a533SArnd Bergmann def_bool PARISC || M68K || PPC || MIPS || X86 || SPARC || MICROBLAZE || SUPERH 1495a7f7f624SMasahiro Yamada help 1496f6187769SFabian Frederick sys_sgetmask and sys_ssetmask are obsolete system calls 1497f6187769SFabian Frederick no longer supported in libc but still enabled by default in some 1498f6187769SFabian Frederick architectures. 1499f6187769SFabian Frederick 1500f6187769SFabian Frederick If unsure, leave the default option here. 1501f6187769SFabian Frederick 15026af9f7bfSFabian Frederickconfig SYSFS_SYSCALL 15036af9f7bfSFabian Frederick bool "Sysfs syscall support" if EXPERT 15046af9f7bfSFabian Frederick default y 1505a7f7f624SMasahiro Yamada help 15066af9f7bfSFabian Frederick sys_sysfs is an obsolete system call no longer supported in libc. 15076af9f7bfSFabian Frederick Note that disabling this option is more secure but might break 15086af9f7bfSFabian Frederick compatibility with some systems. 15096af9f7bfSFabian Frederick 15106af9f7bfSFabian Frederick If unsure say Y here. 15116af9f7bfSFabian Frederick 1512d1b069f5SRandy Dunlapconfig FHANDLE 1513d1b069f5SRandy Dunlap bool "open by fhandle syscalls" if EXPERT 1514d1b069f5SRandy Dunlap select EXPORTFS 1515d1b069f5SRandy Dunlap default y 1516d1b069f5SRandy Dunlap help 1517d1b069f5SRandy Dunlap If you say Y here, a user level program will be able to map 1518d1b069f5SRandy Dunlap file names to handle and then later use the handle for 1519d1b069f5SRandy Dunlap different file system operations. This is useful in implementing 1520d1b069f5SRandy Dunlap userspace file servers, which now track files using handles instead 1521d1b069f5SRandy Dunlap of names. The handle would remain the same even if file names 1522d1b069f5SRandy Dunlap get renamed. Enables open_by_handle_at(2) and name_to_handle_at(2) 1523d1b069f5SRandy Dunlap syscalls. 1524d1b069f5SRandy Dunlap 1525baa73d9eSNicolas Pitreconfig POSIX_TIMERS 1526baa73d9eSNicolas Pitre bool "Posix Clocks & timers" if EXPERT 1527baa73d9eSNicolas Pitre default y 1528baa73d9eSNicolas Pitre help 1529baa73d9eSNicolas Pitre This includes native support for POSIX timers to the kernel. 1530baa73d9eSNicolas Pitre Some embedded systems have no use for them and therefore they 1531baa73d9eSNicolas Pitre can be configured out to reduce the size of the kernel image. 1532baa73d9eSNicolas Pitre 1533baa73d9eSNicolas Pitre When this option is disabled, the following syscalls won't be 1534baa73d9eSNicolas Pitre available: timer_create, timer_gettime: timer_getoverrun, 1535baa73d9eSNicolas Pitre timer_settime, timer_delete, clock_adjtime, getitimer, 1536baa73d9eSNicolas Pitre setitimer, alarm. Furthermore, the clock_settime, clock_gettime, 1537baa73d9eSNicolas Pitre clock_getres and clock_nanosleep syscalls will be limited to 1538baa73d9eSNicolas Pitre CLOCK_REALTIME, CLOCK_MONOTONIC and CLOCK_BOOTTIME only. 1539baa73d9eSNicolas Pitre 1540baa73d9eSNicolas Pitre If unsure say y. 1541baa73d9eSNicolas Pitre 1542d59745ceSMatt Mackallconfig PRINTK 1543d59745ceSMatt Mackall default y 15446a108a14SDavid Rientjes bool "Enable support for printk" if EXPERT 154574876a98SFrederic Weisbecker select IRQ_WORK 1546d59745ceSMatt Mackall help 1547d59745ceSMatt Mackall This option enables normal printk support. Removing it 1548d59745ceSMatt Mackall eliminates most of the message strings from the kernel image 1549d59745ceSMatt Mackall and makes the kernel more or less silent. As this makes it 1550d59745ceSMatt Mackall very difficult to diagnose system problems, saying N here is 1551d59745ceSMatt Mackall strongly discouraged. 1552d59745ceSMatt Mackall 1553c8538a7aSMatt Mackallconfig BUG 15546a108a14SDavid Rientjes bool "BUG() support" if EXPERT 1555c8538a7aSMatt Mackall default y 1556c8538a7aSMatt Mackall help 1557c8538a7aSMatt Mackall Disabling this option eliminates support for BUG and WARN, reducing 1558c8538a7aSMatt Mackall the size of your kernel image and potentially quietly ignoring 1559c8538a7aSMatt Mackall numerous fatal conditions. You should only consider disabling this 1560c8538a7aSMatt Mackall option for embedded systems with no facilities for reporting errors. 1561c8538a7aSMatt Mackall Just say Y. 1562c8538a7aSMatt Mackall 1563708e9a79SMatt Mackallconfig ELF_CORE 1564046d662fSAlex Kelly depends on COREDUMP 1565708e9a79SMatt Mackall default y 15666a108a14SDavid Rientjes bool "Enable ELF core dumps" if EXPERT 1567708e9a79SMatt Mackall help 1568708e9a79SMatt Mackall Enable support for generating core dumps. Disabling saves about 4k. 1569708e9a79SMatt Mackall 15708761f1abSRalf Baechle 1571e5e1d3cbSStas Sergeevconfig PCSPKR_PLATFORM 15726a108a14SDavid Rientjes bool "Enable PC-Speaker support" if EXPERT 15738761f1abSRalf Baechle depends on HAVE_PCSPKR_PLATFORM 157415f304b6SRalf Baechle select I8253_LOCK 1575e5e1d3cbSStas Sergeev default y 1576e5e1d3cbSStas Sergeev help 1577e5e1d3cbSStas Sergeev This option allows to disable the internal PC-Speaker 1578e5e1d3cbSStas Sergeev support, saving some memory. 1579e5e1d3cbSStas Sergeev 15801da177e4SLinus Torvaldsconfig BASE_FULL 15811da177e4SLinus Torvalds default y 15826a108a14SDavid Rientjes bool "Enable full-sized data structures for core" if EXPERT 15831da177e4SLinus Torvalds help 15841da177e4SLinus Torvalds Disabling this option reduces the size of miscellaneous core 15851da177e4SLinus Torvalds kernel data structures. This saves memory on small machines, 15861da177e4SLinus Torvalds but may reduce performance. 15871da177e4SLinus Torvalds 15881da177e4SLinus Torvaldsconfig FUTEX 15896a108a14SDavid Rientjes bool "Enable futex support" if EXPERT 15903f2bedabSArnd Bergmann depends on !(SPARC32 && SMP) 15911da177e4SLinus Torvalds default y 1592bc2eecd7SNicolas Pitre imply RT_MUTEXES 15931da177e4SLinus Torvalds help 15941da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 15951da177e4SLinus Torvalds support for "fast userspace mutexes". The resulting kernel may not 15961da177e4SLinus Torvalds run glibc-based applications correctly. 15971da177e4SLinus Torvalds 1598bc2eecd7SNicolas Pitreconfig FUTEX_PI 1599bc2eecd7SNicolas Pitre bool 1600bc2eecd7SNicolas Pitre depends on FUTEX && RT_MUTEXES 1601bc2eecd7SNicolas Pitre default y 1602bc2eecd7SNicolas Pitre 16031da177e4SLinus Torvaldsconfig EPOLL 16046a108a14SDavid Rientjes bool "Enable eventpoll support" if EXPERT 16051da177e4SLinus Torvalds default y 16061da177e4SLinus Torvalds help 16071da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 16081da177e4SLinus Torvalds support for epoll family of system calls. 16091da177e4SLinus Torvalds 1610fba2afaaSDavide Libenziconfig SIGNALFD 16116a108a14SDavid Rientjes bool "Enable signalfd() system call" if EXPERT 1612fba2afaaSDavide Libenzi default y 1613fba2afaaSDavide Libenzi help 1614fba2afaaSDavide Libenzi Enable the signalfd() system call that allows to receive signals 1615fba2afaaSDavide Libenzi on a file descriptor. 1616fba2afaaSDavide Libenzi 1617fba2afaaSDavide Libenzi If unsure, say Y. 1618fba2afaaSDavide Libenzi 1619b215e283SDavide Libenziconfig TIMERFD 16206a108a14SDavid Rientjes bool "Enable timerfd() system call" if EXPERT 1621b215e283SDavide Libenzi default y 1622b215e283SDavide Libenzi help 1623b215e283SDavide Libenzi Enable the timerfd() system call that allows to receive timer 1624b215e283SDavide Libenzi events on a file descriptor. 1625b215e283SDavide Libenzi 1626b215e283SDavide Libenzi If unsure, say Y. 1627b215e283SDavide Libenzi 1628e1ad7468SDavide Libenziconfig EVENTFD 16296a108a14SDavid Rientjes bool "Enable eventfd() system call" if EXPERT 1630e1ad7468SDavide Libenzi default y 1631e1ad7468SDavide Libenzi help 1632e1ad7468SDavide Libenzi Enable the eventfd() system call that allows to receive both 1633e1ad7468SDavide Libenzi kernel notification (ie. KAIO) or userspace notifications. 1634e1ad7468SDavide Libenzi 1635e1ad7468SDavide Libenzi If unsure, say Y. 1636e1ad7468SDavide Libenzi 16371da177e4SLinus Torvaldsconfig SHMEM 16386a108a14SDavid Rientjes bool "Use full shmem filesystem" if EXPERT 16391da177e4SLinus Torvalds default y 16401da177e4SLinus Torvalds depends on MMU 16411da177e4SLinus Torvalds help 16421da177e4SLinus Torvalds The shmem is an internal filesystem used to manage shared memory. 16431da177e4SLinus Torvalds It is backed by swap and manages resource limits. It is also exported 16441da177e4SLinus Torvalds to userspace as tmpfs if TMPFS is enabled. Disabling this 16451da177e4SLinus Torvalds option replaces shmem and tmpfs with the much simpler ramfs code, 16461da177e4SLinus Torvalds which may be appropriate on small systems without swap. 16471da177e4SLinus Torvalds 1648ebf3f09cSThomas Petazzoniconfig AIO 16496a108a14SDavid Rientjes bool "Enable AIO support" if EXPERT 1650ebf3f09cSThomas Petazzoni default y 1651ebf3f09cSThomas Petazzoni help 1652ebf3f09cSThomas Petazzoni This option enables POSIX asynchronous I/O which may by used 1653ebf3f09cSThomas Petazzoni by some high performance threaded applications. Disabling 1654ebf3f09cSThomas Petazzoni this option saves about 7k. 1655ebf3f09cSThomas Petazzoni 16562b188cc1SJens Axboeconfig IO_URING 16572b188cc1SJens Axboe bool "Enable IO uring support" if EXPERT 1658561fb04aSJens Axboe select IO_WQ 16592b188cc1SJens Axboe default y 16602b188cc1SJens Axboe help 16612b188cc1SJens Axboe This option enables support for the io_uring interface, enabling 16622b188cc1SJens Axboe applications to submit and complete IO through submission and 16632b188cc1SJens Axboe completion rings that are shared between the kernel and application. 16642b188cc1SJens Axboe 1665d3ac21caSJosh Triplettconfig ADVISE_SYSCALLS 1666d3ac21caSJosh Triplett bool "Enable madvise/fadvise syscalls" if EXPERT 1667d3ac21caSJosh Triplett default y 1668d3ac21caSJosh Triplett help 1669d3ac21caSJosh Triplett This option enables the madvise and fadvise syscalls, used by 1670d3ac21caSJosh Triplett applications to advise the kernel about their future memory or file 1671d3ac21caSJosh Triplett usage, improving performance. If building an embedded system where no 1672d3ac21caSJosh Triplett applications use these syscalls, you can disable this option to save 1673d3ac21caSJosh Triplett space. 1674d3ac21caSJosh Triplett 16755a281062SAndrea Arcangeliconfig HAVE_ARCH_USERFAULTFD_WP 16765a281062SAndrea Arcangeli bool 16775a281062SAndrea Arcangeli help 16785a281062SAndrea Arcangeli Arch has userfaultfd write protection support 16795a281062SAndrea Arcangeli 16807677f7fdSAxel Rasmussenconfig HAVE_ARCH_USERFAULTFD_MINOR 16817677f7fdSAxel Rasmussen bool 16827677f7fdSAxel Rasmussen help 16837677f7fdSAxel Rasmussen Arch has userfaultfd minor fault support 16847677f7fdSAxel Rasmussen 16855b25b13aSMathieu Desnoyersconfig MEMBARRIER 16865b25b13aSMathieu Desnoyers bool "Enable membarrier() system call" if EXPERT 16875b25b13aSMathieu Desnoyers default y 16885b25b13aSMathieu Desnoyers help 16895b25b13aSMathieu Desnoyers Enable the membarrier() system call that allows issuing memory 16905b25b13aSMathieu Desnoyers barriers across all running threads, which can be used to distribute 16915b25b13aSMathieu Desnoyers the cost of user-space memory barriers asymmetrically by transforming 16925b25b13aSMathieu Desnoyers pairs of memory barriers into pairs consisting of membarrier() and a 16935b25b13aSMathieu Desnoyers compiler barrier. 16945b25b13aSMathieu Desnoyers 16955b25b13aSMathieu Desnoyers If unsure, say Y. 16965b25b13aSMathieu Desnoyers 1697d1b069f5SRandy Dunlapconfig KALLSYMS 1698d1b069f5SRandy Dunlap bool "Load all symbols for debugging/ksymoops" if EXPERT 1699d1b069f5SRandy Dunlap default y 1700d1b069f5SRandy Dunlap help 1701d1b069f5SRandy Dunlap Say Y here to let the kernel print out symbolic crash information and 1702d1b069f5SRandy Dunlap symbolic stack backtraces. This increases the size of the kernel 1703d1b069f5SRandy Dunlap somewhat, as all symbols have to be loaded into the kernel image. 1704d1b069f5SRandy Dunlap 1705d1b069f5SRandy Dunlapconfig KALLSYMS_ALL 1706d1b069f5SRandy Dunlap bool "Include all symbols in kallsyms" 1707d1b069f5SRandy Dunlap depends on DEBUG_KERNEL && KALLSYMS 1708d1b069f5SRandy Dunlap help 1709d1b069f5SRandy Dunlap Normally kallsyms only contains the symbols of functions for nicer 1710d1b069f5SRandy Dunlap OOPS messages and backtraces (i.e., symbols from the text and inittext 1711d1b069f5SRandy Dunlap sections). This is sufficient for most cases. And only in very rare 1712d1b069f5SRandy Dunlap cases (e.g., when a debugger is used) all symbols are required (e.g., 1713d1b069f5SRandy Dunlap names of variables from the data sections, etc). 1714d1b069f5SRandy Dunlap 1715d1b069f5SRandy Dunlap This option makes sure that all symbols are loaded into the kernel 1716d1b069f5SRandy Dunlap image (i.e., symbols from all sections) in cost of increased kernel 1717d1b069f5SRandy Dunlap size (depending on the kernel configuration, it may be 300KiB or 1718d1b069f5SRandy Dunlap something like this). 1719d1b069f5SRandy Dunlap 1720d1b069f5SRandy Dunlap Say N unless you really need all symbols. 1721d1b069f5SRandy Dunlap 1722d1b069f5SRandy Dunlapconfig KALLSYMS_ABSOLUTE_PERCPU 1723d1b069f5SRandy Dunlap bool 1724d1b069f5SRandy Dunlap depends on KALLSYMS 1725d1b069f5SRandy Dunlap default X86_64 && SMP 1726d1b069f5SRandy Dunlap 1727d1b069f5SRandy Dunlapconfig KALLSYMS_BASE_RELATIVE 1728d1b069f5SRandy Dunlap bool 1729d1b069f5SRandy Dunlap depends on KALLSYMS 1730a687a533SArnd Bergmann default !IA64 1731d1b069f5SRandy Dunlap help 1732d1b069f5SRandy Dunlap Instead of emitting them as absolute values in the native word size, 1733d1b069f5SRandy Dunlap emit the symbol references in the kallsyms table as 32-bit entries, 1734d1b069f5SRandy Dunlap each containing a relative value in the range [base, base + U32_MAX] 1735d1b069f5SRandy Dunlap or, when KALLSYMS_ABSOLUTE_PERCPU is in effect, each containing either 1736d1b069f5SRandy Dunlap an absolute value in the range [0, S32_MAX] or a relative value in the 1737d1b069f5SRandy Dunlap range [base, base + S32_MAX], where base is the lowest relative symbol 1738d1b069f5SRandy Dunlap address encountered in the image. 1739d1b069f5SRandy Dunlap 1740d1b069f5SRandy Dunlap On 64-bit builds, this reduces the size of the address table by 50%, 1741d1b069f5SRandy Dunlap but more importantly, it results in entries whose values are build 1742d1b069f5SRandy Dunlap time constants, and no relocation pass is required at runtime to fix 1743d1b069f5SRandy Dunlap up the entries based on the runtime load address of the kernel. 1744d1b069f5SRandy Dunlap 1745d1b069f5SRandy Dunlap# end of the "standard kernel features (expert users)" menu 1746d1b069f5SRandy Dunlap 1747d1b069f5SRandy Dunlap# syscall, maps, verifier 1748fc611f47SKP Singh 1749d1b069f5SRandy Dunlapconfig USERFAULTFD 1750d1b069f5SRandy Dunlap bool "Enable userfaultfd() system call" 1751d1b069f5SRandy Dunlap depends on MMU 1752d1b069f5SRandy Dunlap help 1753d1b069f5SRandy Dunlap Enable the userfaultfd() system call that allows to intercept and 1754d1b069f5SRandy Dunlap handle page faults in userland. 1755d1b069f5SRandy Dunlap 17563ccfebedSMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_CALLBACKS 17573ccfebedSMathieu Desnoyers bool 17583ccfebedSMathieu Desnoyers 175970216e18SMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_SYNC_CORE 176070216e18SMathieu Desnoyers bool 176170216e18SMathieu Desnoyers 1762bfe3911aSChris Wilsonconfig KCMP 1763bfe3911aSChris Wilson bool "Enable kcmp() system call" if EXPERT 1764bfe3911aSChris Wilson help 1765bfe3911aSChris Wilson Enable the kernel resource comparison system call. It provides 1766bfe3911aSChris Wilson user-space with the ability to compare two processes to see if they 1767bfe3911aSChris Wilson share a common resource, such as a file descriptor or even virtual 1768bfe3911aSChris Wilson memory space. 1769bfe3911aSChris Wilson 1770bfe3911aSChris Wilson If unsure, say N. 1771bfe3911aSChris Wilson 1772d7822b1eSMathieu Desnoyersconfig RSEQ 1773d7822b1eSMathieu Desnoyers bool "Enable rseq() system call" if EXPERT 1774d7822b1eSMathieu Desnoyers default y 1775d7822b1eSMathieu Desnoyers depends on HAVE_RSEQ 1776d7822b1eSMathieu Desnoyers select MEMBARRIER 1777d7822b1eSMathieu Desnoyers help 1778d7822b1eSMathieu Desnoyers Enable the restartable sequences system call. It provides a 1779d7822b1eSMathieu Desnoyers user-space cache for the current CPU number value, which 1780d7822b1eSMathieu Desnoyers speeds up getting the current CPU number from user-space, 1781d7822b1eSMathieu Desnoyers as well as an ABI to speed up user-space operations on 1782d7822b1eSMathieu Desnoyers per-CPU data. 1783d7822b1eSMathieu Desnoyers 1784d7822b1eSMathieu Desnoyers If unsure, say Y. 1785d7822b1eSMathieu Desnoyers 1786d7822b1eSMathieu Desnoyersconfig DEBUG_RSEQ 1787d7822b1eSMathieu Desnoyers default n 1788d7822b1eSMathieu Desnoyers bool "Enabled debugging of rseq() system call" if EXPERT 1789d7822b1eSMathieu Desnoyers depends on RSEQ && DEBUG_KERNEL 1790d7822b1eSMathieu Desnoyers help 1791d7822b1eSMathieu Desnoyers Enable extra debugging checks for the rseq system call. 1792d7822b1eSMathieu Desnoyers 1793d7822b1eSMathieu Desnoyers If unsure, say N. 1794d7822b1eSMathieu Desnoyers 17956befe5f6SRandy Dunlapconfig EMBEDDED 17966befe5f6SRandy Dunlap bool "Embedded system" 17976befe5f6SRandy Dunlap select EXPERT 17986befe5f6SRandy Dunlap help 17996befe5f6SRandy Dunlap This option should be enabled if compiling the kernel for 18006befe5f6SRandy Dunlap an embedded system so certain expert options are available 18016befe5f6SRandy Dunlap for configuration. 18026befe5f6SRandy Dunlap 1803cdd6c482SIngo Molnarconfig HAVE_PERF_EVENTS 18040793a61dSThomas Gleixner bool 1805018df72dSMike Frysinger help 1806018df72dSMike Frysinger See tools/perf/design.txt for details. 18070793a61dSThomas Gleixner 18082aef6f30SSean Christophersonconfig GUEST_PERF_EVENTS 18092aef6f30SSean Christopherson bool 18102aef6f30SSean Christopherson depends on HAVE_PERF_EVENTS 18112aef6f30SSean Christopherson 1812906010b2SPeter Zijlstraconfig PERF_USE_VMALLOC 1813906010b2SPeter Zijlstra bool 1814906010b2SPeter Zijlstra help 1815906010b2SPeter Zijlstra See tools/perf/design.txt for details 1816906010b2SPeter Zijlstra 1817ad90a3deSWilliam Breathitt Grayconfig PC104 1818424529fbSWilliam Breathitt Gray bool "PC/104 support" if EXPERT 1819ad90a3deSWilliam Breathitt Gray help 1820ad90a3deSWilliam Breathitt Gray Expose PC/104 form factor device drivers and options available for 1821ad90a3deSWilliam Breathitt Gray selection and configuration. Enable this option if your target 1822ad90a3deSWilliam Breathitt Gray machine has a PC/104 bus. 1823ad90a3deSWilliam Breathitt Gray 182457c0c15bSIngo Molnarmenu "Kernel Performance Events And Counters" 18250793a61dSThomas Gleixner 1826cdd6c482SIngo Molnarconfig PERF_EVENTS 182757c0c15bSIngo Molnar bool "Kernel performance events and counters" 1828392d65a9SRobert Richter default y if PROFILING 1829cdd6c482SIngo Molnar depends on HAVE_PERF_EVENTS 1830e360adbeSPeter Zijlstra select IRQ_WORK 183183fe27eaSPranith Kumar select SRCU 18320793a61dSThomas Gleixner help 183357c0c15bSIngo Molnar Enable kernel support for various performance events provided 183457c0c15bSIngo Molnar by software and hardware. 18350793a61dSThomas Gleixner 1836dd77038dSThadeu Lima de Souza Cascardo Software events are supported either built-in or via the 183757c0c15bSIngo Molnar use of generic tracepoints. 183857c0c15bSIngo Molnar 183957c0c15bSIngo Molnar Most modern CPUs support performance events via performance 184057c0c15bSIngo Molnar counter registers. These registers count the number of certain 18410793a61dSThomas Gleixner types of hw events: such as instructions executed, cachemisses 18420793a61dSThomas Gleixner suffered, or branches mis-predicted - without slowing down the 18430793a61dSThomas Gleixner kernel or applications. These registers can also trigger interrupts 18440793a61dSThomas Gleixner when a threshold number of events have passed - and can thus be 18450793a61dSThomas Gleixner used to profile the code that runs on that CPU. 18460793a61dSThomas Gleixner 184757c0c15bSIngo Molnar The Linux Performance Event subsystem provides an abstraction of 1848dd77038dSThadeu Lima de Souza Cascardo these software and hardware event capabilities, available via a 184957c0c15bSIngo Molnar system call and used by the "perf" utility in tools/perf/. It 18500793a61dSThomas Gleixner provides per task and per CPU counters, and it provides event 18510793a61dSThomas Gleixner capabilities on top of those. 18520793a61dSThomas Gleixner 18530793a61dSThomas Gleixner Say Y if unsure. 18540793a61dSThomas Gleixner 1855906010b2SPeter Zijlstraconfig DEBUG_PERF_USE_VMALLOC 1856906010b2SPeter Zijlstra default n 1857906010b2SPeter Zijlstra bool "Debug: use vmalloc to back perf mmap() buffers" 1858cb307113SMichael Ellerman depends on PERF_EVENTS && DEBUG_KERNEL && !PPC 1859906010b2SPeter Zijlstra select PERF_USE_VMALLOC 1860906010b2SPeter Zijlstra help 1861906010b2SPeter Zijlstra Use vmalloc memory to back perf mmap() buffers. 1862906010b2SPeter Zijlstra 1863906010b2SPeter Zijlstra Mostly useful for debugging the vmalloc code on platforms 1864906010b2SPeter Zijlstra that don't require it. 1865906010b2SPeter Zijlstra 1866906010b2SPeter Zijlstra Say N if unsure. 1867906010b2SPeter Zijlstra 18680793a61dSThomas Gleixnerendmenu 18690793a61dSThomas Gleixner 1870f8891e5eSChristoph Lameterconfig VM_EVENT_COUNTERS 1871f8891e5eSChristoph Lameter default y 18726a108a14SDavid Rientjes bool "Enable VM event counters for /proc/vmstat" if EXPERT 1873f8891e5eSChristoph Lameter help 18742aea4fb6SPaul Jackson VM event counters are needed for event counts to be shown. 18752aea4fb6SPaul Jackson This option allows the disabling of the VM event counters 18766a108a14SDavid Rientjes on EXPERT systems. /proc/vmstat will only show page counts 18772aea4fb6SPaul Jackson if VM event counters are disabled. 1878f8891e5eSChristoph Lameter 187941ecc55bSChristoph Lameterconfig SLUB_DEBUG 188041ecc55bSChristoph Lameter default y 18816a108a14SDavid Rientjes bool "Enable SLUB debugging support" if EXPERT 1882f6acb635SChristoph Lameter depends on SLUB && SYSFS 188341ecc55bSChristoph Lameter help 188441ecc55bSChristoph Lameter SLUB has extensive debug support features. Disabling these can 188541ecc55bSChristoph Lameter result in significant savings in code size. This also disables 188641ecc55bSChristoph Lameter SLUB sysfs support. /sys/slab will not exist and there will be 188741ecc55bSChristoph Lameter no support for cache validation etc. 188841ecc55bSChristoph Lameter 1889b943c460SRandy Dunlapconfig COMPAT_BRK 1890b943c460SRandy Dunlap bool "Disable heap randomization" 1891b943c460SRandy Dunlap default y 1892b943c460SRandy Dunlap help 1893b943c460SRandy Dunlap Randomizing heap placement makes heap exploits harder, but it 1894b943c460SRandy Dunlap also breaks ancient binaries (including anything libc5 based). 1895b943c460SRandy Dunlap This option changes the bootup default to heap randomization 1896692105b8SMatt LaPlante disabled, and can be overridden at runtime by setting 1897b943c460SRandy Dunlap /proc/sys/kernel/randomize_va_space to 2. 1898b943c460SRandy Dunlap 1899b943c460SRandy Dunlap On non-ancient distros (post-2000 ones) N is usually a safe choice. 1900b943c460SRandy Dunlap 190181819f0fSChristoph Lameterchoice 190281819f0fSChristoph Lameter prompt "Choose SLAB allocator" 1903a0acd820SChristoph Lameter default SLUB 190481819f0fSChristoph Lameter help 190581819f0fSChristoph Lameter This option allows to select a slab allocator. 190681819f0fSChristoph Lameter 190781819f0fSChristoph Lameterconfig SLAB 190881819f0fSChristoph Lameter bool "SLAB" 1909252220daSIngo Molnar depends on !PREEMPT_RT 191004385fc5SKees Cook select HAVE_HARDENED_USERCOPY_ALLOCATOR 191181819f0fSChristoph Lameter help 191281819f0fSChristoph Lameter The regular slab allocator that is established and known to work 191334013886SChristoph Lameter well in all environments. It organizes cache hot objects in 191402f56210SSimon Arlott per cpu and per node queues. 191581819f0fSChristoph Lameter 191681819f0fSChristoph Lameterconfig SLUB 191781819f0fSChristoph Lameter bool "SLUB (Unqueued Allocator)" 1918ed18adc1SKees Cook select HAVE_HARDENED_USERCOPY_ALLOCATOR 191981819f0fSChristoph Lameter help 192081819f0fSChristoph Lameter SLUB is a slab allocator that minimizes cache line usage 192181819f0fSChristoph Lameter instead of managing queues of cached objects (SLAB approach). 192281819f0fSChristoph Lameter Per cpu caching is realized using slabs of objects instead 192381819f0fSChristoph Lameter of queues of objects. SLUB can use memory efficiently 192402f56210SSimon Arlott and has enhanced diagnostics. SLUB is the default choice for 192502f56210SSimon Arlott a slab allocator. 192681819f0fSChristoph Lameter 192781819f0fSChristoph Lameterconfig SLOB 19286a108a14SDavid Rientjes depends on EXPERT 192981819f0fSChristoph Lameter bool "SLOB (Simple Allocator)" 1930252220daSIngo Molnar depends on !PREEMPT_RT 193181819f0fSChristoph Lameter help 193237291458SMatt Mackall SLOB replaces the stock allocator with a drastically simpler 193337291458SMatt Mackall allocator. SLOB is generally more space efficient but 193437291458SMatt Mackall does not perform as well on large systems. 193581819f0fSChristoph Lameter 193681819f0fSChristoph Lameterendchoice 193781819f0fSChristoph Lameter 19387660a6fdSKees Cookconfig SLAB_MERGE_DEFAULT 19397660a6fdSKees Cook bool "Allow slab caches to be merged" 19407660a6fdSKees Cook default y 1941eb52c0fcSHyeonggon Yoo depends on SLAB || SLUB 19427660a6fdSKees Cook help 19437660a6fdSKees Cook For reduced kernel memory fragmentation, slab caches can be 19447660a6fdSKees Cook merged when they share the same size and other characteristics. 19457660a6fdSKees Cook This carries a risk of kernel heap overflows being able to 19467660a6fdSKees Cook overwrite objects from merged caches (and more easily control 19477660a6fdSKees Cook cache layout), which makes such heap attacks easier to exploit 19487660a6fdSKees Cook by attackers. By keeping caches unmerged, these kinds of exploits 19497660a6fdSKees Cook can usually only damage objects in the same cache. To disable 19507660a6fdSKees Cook merging at runtime, "slab_nomerge" can be passed on the kernel 19517660a6fdSKees Cook command line. 19527660a6fdSKees Cook 1953c7ce4f60SThomas Garnierconfig SLAB_FREELIST_RANDOM 19543404be67SKees Cook bool "Randomize slab freelist" 1955210e7a43SThomas Garnier depends on SLAB || SLUB 1956c7ce4f60SThomas Garnier help 1957210e7a43SThomas Garnier Randomizes the freelist order used on creating new pages. This 1958c7ce4f60SThomas Garnier security feature reduces the predictability of the kernel slab 1959c7ce4f60SThomas Garnier allocator against heap overflows. 1960c7ce4f60SThomas Garnier 19612482ddecSKees Cookconfig SLAB_FREELIST_HARDENED 19622482ddecSKees Cook bool "Harden slab freelist metadata" 19633404be67SKees Cook depends on SLAB || SLUB 19642482ddecSKees Cook help 19652482ddecSKees Cook Many kernel heap attacks try to target slab cache metadata and 19662482ddecSKees Cook other infrastructure. This options makes minor performance 196792bae787SKees Cook sacrifices to harden the kernel slab allocator against common 19683404be67SKees Cook freelist exploit methods. Some slab implementations have more 19693404be67SKees Cook sanity-checking than others. This option is most effective with 19703404be67SKees Cook CONFIG_SLUB. 19712482ddecSKees Cook 1972e900a918SDan Williamsconfig SHUFFLE_PAGE_ALLOCATOR 1973e900a918SDan Williams bool "Page allocator randomization" 1974e900a918SDan Williams default SLAB_FREELIST_RANDOM && ACPI_NUMA 1975e900a918SDan Williams help 1976e900a918SDan Williams Randomization of the page allocator improves the average 1977e900a918SDan Williams utilization of a direct-mapped memory-side-cache. See section 1978e900a918SDan Williams 5.2.27 Heterogeneous Memory Attribute Table (HMAT) in the ACPI 1979e900a918SDan Williams 6.2a specification for an example of how a platform advertises 1980e900a918SDan Williams the presence of a memory-side-cache. There are also incidental 1981e900a918SDan Williams security benefits as it reduces the predictability of page 1982e900a918SDan Williams allocations to compliment SLAB_FREELIST_RANDOM, but the 1983e900a918SDan Williams default granularity of shuffling on the "MAX_ORDER - 1" i.e, 1984e900a918SDan Williams 10th order of pages is selected based on cache utilization 1985e900a918SDan Williams benefits on x86. 1986e900a918SDan Williams 1987e900a918SDan Williams While the randomization improves cache utilization it may 1988e900a918SDan Williams negatively impact workloads on platforms without a cache. For 1989e900a918SDan Williams this reason, by default, the randomization is enabled only 1990e900a918SDan Williams after runtime detection of a direct-mapped memory-side-cache. 1991e900a918SDan Williams Otherwise, the randomization may be force enabled with the 1992e900a918SDan Williams 'page_alloc.shuffle' kernel command line parameter. 1993e900a918SDan Williams 1994e900a918SDan Williams Say Y if unsure. 1995e900a918SDan Williams 1996345c905dSJoonsoo Kimconfig SLUB_CPU_PARTIAL 1997345c905dSJoonsoo Kim default y 1998b39ffbf8SUwe Kleine-König depends on SLUB && SMP 1999345c905dSJoonsoo Kim bool "SLUB per cpu partial cache" 2000345c905dSJoonsoo Kim help 200192bae787SKees Cook Per cpu partial caches accelerate objects allocation and freeing 2002345c905dSJoonsoo Kim that is local to a processor at the price of more indeterminism 2003345c905dSJoonsoo Kim in the latency of the free. On overflow these caches will be cleared 2004345c905dSJoonsoo Kim which requires the taking of locks that may cause latency spikes. 2005345c905dSJoonsoo Kim Typically one would choose no for a realtime system. 2006345c905dSJoonsoo Kim 2007ea637639SJie Zhangconfig MMAP_ALLOW_UNINITIALIZED 2008ea637639SJie Zhang bool "Allow mmapped anonymous memory to be uninitialized" 20096a108a14SDavid Rientjes depends on EXPERT && !MMU 2010ea637639SJie Zhang default n 2011ea637639SJie Zhang help 2012ea637639SJie Zhang Normally, and according to the Linux spec, anonymous memory obtained 20133903bf94SRandy Dunlap from mmap() has its contents cleared before it is passed to 2014ea637639SJie Zhang userspace. Enabling this config option allows you to request that 2015ea637639SJie Zhang mmap() skip that if it is given an MAP_UNINITIALIZED flag, thus 2016ea637639SJie Zhang providing a huge performance boost. If this option is not enabled, 2017ea637639SJie Zhang then the flag will be ignored. 2018ea637639SJie Zhang 2019ea637639SJie Zhang This is taken advantage of by uClibc's malloc(), and also by 2020ea637639SJie Zhang ELF-FDPIC binfmt's brk and stack allocator. 2021ea637639SJie Zhang 2022ea637639SJie Zhang Because of the obvious security issues, this option should only be 2023ea637639SJie Zhang enabled on embedded devices where you control what is run in 2024ea637639SJie Zhang userspace. Since that isn't generally a problem on no-MMU systems, 2025ea637639SJie Zhang it is normally safe to say Y here. 2026ea637639SJie Zhang 2027dd19d293SStephen Kitt See Documentation/admin-guide/mm/nommu-mmap.rst for more information. 2028ea637639SJie Zhang 2029091f6e26SDavid Howellsconfig SYSTEM_DATA_VERIFICATION 2030091f6e26SDavid Howells def_bool n 2031091f6e26SDavid Howells select SYSTEM_TRUSTED_KEYRING 2032091f6e26SDavid Howells select KEYS 2033091f6e26SDavid Howells select CRYPTO 2034d43de6c7SDavid Howells select CRYPTO_RSA 2035091f6e26SDavid Howells select ASYMMETRIC_KEY_TYPE 2036091f6e26SDavid Howells select ASYMMETRIC_PUBLIC_KEY_SUBTYPE 2037091f6e26SDavid Howells select ASN1 2038091f6e26SDavid Howells select OID_REGISTRY 2039091f6e26SDavid Howells select X509_CERTIFICATE_PARSER 2040091f6e26SDavid Howells select PKCS7_MESSAGE_PARSER 204182c04ff8SPeter Foley help 2042091f6e26SDavid Howells Provide PKCS#7 message verification using the contents of the system 2043091f6e26SDavid Howells trusted keyring to provide public keys. This then can be used for 2044091f6e26SDavid Howells module verification, kexec image verification and firmware blob 2045091f6e26SDavid Howells verification. 204682c04ff8SPeter Foley 2047125e5645SMathieu Desnoyersconfig PROFILING 2048b309a294SRobert Richter bool "Profiling support" 2049125e5645SMathieu Desnoyers help 2050125e5645SMathieu Desnoyers Say Y here to enable the extended profiling support mechanisms used 2051f8408264SViresh Kumar by profilers. 2052125e5645SMathieu Desnoyers 20535f87f112SIngo Molnar# 20545f87f112SIngo Molnar# Place an empty function call at each tracepoint site. Can be 20555f87f112SIngo Molnar# dynamically changed for a probe function. 20565f87f112SIngo Molnar# 205797e1c18eSMathieu Desnoyersconfig TRACEPOINTS 20585f87f112SIngo Molnar bool 205997e1c18eSMathieu Desnoyers 20601da177e4SLinus Torvaldsendmenu # General setup 20611da177e4SLinus Torvalds 20621572497cSChristoph Hellwigsource "arch/Kconfig" 20631572497cSChristoph Hellwig 2064ae81f9e3SChuck Ebbertconfig RT_MUTEXES 20656341e62bSChristoph Jaeger bool 20661c6f9ec0SSebastian Andrzej Siewior default y if PREEMPT_RT 2067ae81f9e3SChuck Ebbert 20681da177e4SLinus Torvaldsconfig BASE_SMALL 20691da177e4SLinus Torvalds int 20701da177e4SLinus Torvalds default 0 if BASE_FULL 20711da177e4SLinus Torvalds default 1 if !BASE_FULL 20721da177e4SLinus Torvalds 2073c8424e77SThiago Jung Bauermannconfig MODULE_SIG_FORMAT 2074c8424e77SThiago Jung Bauermann def_bool n 2075c8424e77SThiago Jung Bauermann select SYSTEM_DATA_VERIFICATION 2076c8424e77SThiago Jung Bauermann 207766da5733SJan Engelhardtmenuconfig MODULES 20781da177e4SLinus Torvalds bool "Enable loadable module support" 20796dd85ff1SMasahiro Yamada modules 20801da177e4SLinus Torvalds help 20811da177e4SLinus Torvalds Kernel modules are small pieces of compiled code which can 20821da177e4SLinus Torvalds be inserted in the running kernel, rather than being 20831da177e4SLinus Torvalds permanently built into the kernel. You use the "modprobe" 20841da177e4SLinus Torvalds tool to add (and sometimes remove) them. If you say Y here, 20851da177e4SLinus Torvalds many parts of the kernel can be built as modules (by 20861da177e4SLinus Torvalds answering M instead of Y where indicated): this is most 20871da177e4SLinus Torvalds useful for infrequently used options which are not required 20881da177e4SLinus Torvalds for booting. For more information, see the man pages for 20891da177e4SLinus Torvalds modprobe, lsmod, modinfo, insmod and rmmod. 20901da177e4SLinus Torvalds 20911da177e4SLinus Torvalds If you say Y here, you will need to run "make 20921da177e4SLinus Torvalds modules_install" to put the modules under /lib/modules/ 20931da177e4SLinus Torvalds where modprobe can find them (you may need to be root to do 20941da177e4SLinus Torvalds this). 20951da177e4SLinus Torvalds 20961da177e4SLinus Torvalds If unsure, say Y. 20971da177e4SLinus Torvalds 20980b0de144SRobert P. J. Dayif MODULES 20990b0de144SRobert P. J. Day 2100826e4506SLinus Torvaldsconfig MODULE_FORCE_LOAD 2101826e4506SLinus Torvalds bool "Forced module loading" 2102826e4506SLinus Torvalds default n 2103826e4506SLinus Torvalds help 210491e37a79SRusty Russell Allow loading of modules without version information (ie. modprobe 210591e37a79SRusty Russell --force). Forced module loading sets the 'F' (forced) taint flag and 210691e37a79SRusty Russell is usually a really bad idea. 2107826e4506SLinus Torvalds 21081da177e4SLinus Torvaldsconfig MODULE_UNLOAD 21091da177e4SLinus Torvalds bool "Module unloading" 21101da177e4SLinus Torvalds help 21111da177e4SLinus Torvalds Without this option you will not be able to unload any 21121da177e4SLinus Torvalds modules (note that some modules may not be unloadable 2113f7f5b675SDenys Vlasenko anyway), which makes your kernel smaller, faster 2114f7f5b675SDenys Vlasenko and simpler. If unsure, say Y. 21151da177e4SLinus Torvalds 21161da177e4SLinus Torvaldsconfig MODULE_FORCE_UNLOAD 21171da177e4SLinus Torvalds bool "Forced module unloading" 211819c92399SKees Cook depends on MODULE_UNLOAD 21191da177e4SLinus Torvalds help 21201da177e4SLinus Torvalds This option allows you to force a module to unload, even if the 21211da177e4SLinus Torvalds kernel believes it is unsafe: the kernel will remove the module 21221da177e4SLinus Torvalds without waiting for anyone to stop using it (using the -f option to 21231da177e4SLinus Torvalds rmmod). This is mainly for kernel developers and desperate users. 21241da177e4SLinus Torvalds If unsure, say N. 21251da177e4SLinus Torvalds 21261da177e4SLinus Torvaldsconfig MODVERSIONS 21270d541643SSam Ravnborg bool "Module versioning support" 21281da177e4SLinus Torvalds help 21291da177e4SLinus Torvalds Usually, you have to use modules compiled with your kernel. 21301da177e4SLinus Torvalds Saying Y here makes it sometimes possible to use modules 21311da177e4SLinus Torvalds compiled for different kernels, by adding enough information 21321da177e4SLinus Torvalds to the modules to (hopefully) spot any changes which would 21331da177e4SLinus Torvalds make them incompatible with the kernel you are running. If 21341da177e4SLinus Torvalds unsure, say N. 21351da177e4SLinus Torvalds 21362ff2b7ecSMasahiro Yamadaconfig ASM_MODVERSIONS 21372ff2b7ecSMasahiro Yamada bool 21382ff2b7ecSMasahiro Yamada default HAVE_ASM_MODVERSIONS && MODVERSIONS 21392ff2b7ecSMasahiro Yamada help 21402ff2b7ecSMasahiro Yamada This enables module versioning for exported symbols also from 21412ff2b7ecSMasahiro Yamada assembly. This can be enabled only when the target architecture 21422ff2b7ecSMasahiro Yamada supports it. 21432ff2b7ecSMasahiro Yamada 214456067812SArd Biesheuvelconfig MODULE_REL_CRCS 214556067812SArd Biesheuvel bool 214656067812SArd Biesheuvel depends on MODVERSIONS 214756067812SArd Biesheuvel 21481da177e4SLinus Torvaldsconfig MODULE_SRCVERSION_ALL 21491da177e4SLinus Torvalds bool "Source checksum for all modules" 21501da177e4SLinus Torvalds help 21511da177e4SLinus Torvalds Modules which contain a MODULE_VERSION get an extra "srcversion" 21521da177e4SLinus Torvalds field inserted into their modinfo section, which contains a 21531da177e4SLinus Torvalds sum of the source files which made it. This helps maintainers 21541da177e4SLinus Torvalds see exactly which source was used to build a module (since 21551da177e4SLinus Torvalds others sometimes change the module source without updating 21561da177e4SLinus Torvalds the version). With this option, such a "srcversion" field 21571da177e4SLinus Torvalds will be created for all modules. If unsure, say N. 21581da177e4SLinus Torvalds 2159106a4ee2SRusty Russellconfig MODULE_SIG 2160106a4ee2SRusty Russell bool "Module signature verification" 2161c8424e77SThiago Jung Bauermann select MODULE_SIG_FORMAT 2162106a4ee2SRusty Russell help 2163106a4ee2SRusty Russell Check modules for valid signatures upon load: the signature 2164106a4ee2SRusty Russell is simply appended to the module. For more information see 2165cbdc8217SNathan Chancellor <file:Documentation/admin-guide/module-signing.rst>. 2166106a4ee2SRusty Russell 2167228c37ffSDavid Howells Note that this option adds the OpenSSL development packages as a 2168228c37ffSDavid Howells kernel build dependency so that the signing tool can use its crypto 2169228c37ffSDavid Howells library. 2170228c37ffSDavid Howells 217149fcf732SDavid Howells You should enable this option if you wish to use either 217249fcf732SDavid Howells CONFIG_SECURITY_LOCKDOWN_LSM or lockdown functionality imposed via 217349fcf732SDavid Howells another LSM - otherwise unsigned modules will be loadable regardless 217449fcf732SDavid Howells of the lockdown policy. 217549fcf732SDavid Howells 2176ea0b6dcfSDavid Howells !!!WARNING!!! If you enable this option, you MUST make sure that the 2177ea0b6dcfSDavid Howells module DOES NOT get stripped after being signed. This includes the 2178ea0b6dcfSDavid Howells debuginfo strip done by some packagers (such as rpmbuild) and 2179ea0b6dcfSDavid Howells inclusion into an initramfs that wants the module size reduced. 2180ea0b6dcfSDavid Howells 2181106a4ee2SRusty Russellconfig MODULE_SIG_FORCE 2182106a4ee2SRusty Russell bool "Require modules to be validly signed" 2183106a4ee2SRusty Russell depends on MODULE_SIG 2184106a4ee2SRusty Russell help 2185106a4ee2SRusty Russell Reject unsigned modules or signed modules for which we don't have a 2186106a4ee2SRusty Russell key. Without this, such modules will simply taint the kernel. 2187ea0b6dcfSDavid Howells 2188d9d8d7edSMichal Marekconfig MODULE_SIG_ALL 2189d9d8d7edSMichal Marek bool "Automatically sign all modules" 2190d9d8d7edSMichal Marek default y 21910165f4caSNayna Jain depends on MODULE_SIG || IMA_APPRAISE_MODSIG 2192d9d8d7edSMichal Marek help 2193d9d8d7edSMichal Marek Sign all modules during make modules_install. Without this option, 2194d9d8d7edSMichal Marek modules must be signed manually, using the scripts/sign-file tool. 2195d9d8d7edSMichal Marek 2196d9d8d7edSMichal Marekcomment "Do not forget to sign required modules with scripts/sign-file" 2197d9d8d7edSMichal Marek depends on MODULE_SIG_FORCE && !MODULE_SIG_ALL 2198d9d8d7edSMichal Marek 2199ea0b6dcfSDavid Howellschoice 2200ea0b6dcfSDavid Howells prompt "Which hash algorithm should modules be signed with?" 22010165f4caSNayna Jain depends on MODULE_SIG || IMA_APPRAISE_MODSIG 2202ea0b6dcfSDavid Howells help 2203ea0b6dcfSDavid Howells This determines which sort of hashing algorithm will be used during 2204ea0b6dcfSDavid Howells signature generation. This algorithm _must_ be built into the kernel 2205ea0b6dcfSDavid Howells directly so that signature verification can take place. It is not 2206ea0b6dcfSDavid Howells possible to load a signed module containing the algorithm to check 2207ea0b6dcfSDavid Howells the signature on that module. 2208ea0b6dcfSDavid Howells 2209ea0b6dcfSDavid Howellsconfig MODULE_SIG_SHA1 2210ea0b6dcfSDavid Howells bool "Sign modules with SHA-1" 2211ea0b6dcfSDavid Howells select CRYPTO_SHA1 2212ea0b6dcfSDavid Howells 2213ea0b6dcfSDavid Howellsconfig MODULE_SIG_SHA224 2214ea0b6dcfSDavid Howells bool "Sign modules with SHA-224" 2215ea0b6dcfSDavid Howells select CRYPTO_SHA256 2216ea0b6dcfSDavid Howells 2217ea0b6dcfSDavid Howellsconfig MODULE_SIG_SHA256 2218ea0b6dcfSDavid Howells bool "Sign modules with SHA-256" 2219ea0b6dcfSDavid Howells select CRYPTO_SHA256 2220ea0b6dcfSDavid Howells 2221ea0b6dcfSDavid Howellsconfig MODULE_SIG_SHA384 2222ea0b6dcfSDavid Howells bool "Sign modules with SHA-384" 2223ea0b6dcfSDavid Howells select CRYPTO_SHA512 2224ea0b6dcfSDavid Howells 2225ea0b6dcfSDavid Howellsconfig MODULE_SIG_SHA512 2226ea0b6dcfSDavid Howells bool "Sign modules with SHA-512" 2227ea0b6dcfSDavid Howells select CRYPTO_SHA512 2228ea0b6dcfSDavid Howells 2229ea0b6dcfSDavid Howellsendchoice 2230ea0b6dcfSDavid Howells 223122753674SMichal Marekconfig MODULE_SIG_HASH 223222753674SMichal Marek string 22330165f4caSNayna Jain depends on MODULE_SIG || IMA_APPRAISE_MODSIG 223422753674SMichal Marek default "sha1" if MODULE_SIG_SHA1 223522753674SMichal Marek default "sha224" if MODULE_SIG_SHA224 223622753674SMichal Marek default "sha256" if MODULE_SIG_SHA256 223722753674SMichal Marek default "sha384" if MODULE_SIG_SHA384 223822753674SMichal Marek default "sha512" if MODULE_SIG_SHA512 223922753674SMichal Marek 2240beb50df3SBertrand Jacquinchoice 2241d4bbe942SMasahiro Yamada prompt "Module compression mode" 2242beb50df3SBertrand Jacquin help 2243d4bbe942SMasahiro Yamada This option allows you to choose the algorithm which will be used to 2244d4bbe942SMasahiro Yamada compress modules when 'make modules_install' is run. (or, you can 2245d4bbe942SMasahiro Yamada choose to not compress modules at all.) 2246beb50df3SBertrand Jacquin 2247d4bbe942SMasahiro Yamada External modules will also be compressed in the same way during the 2248d4bbe942SMasahiro Yamada installation. 2249d4bbe942SMasahiro Yamada 2250d4bbe942SMasahiro Yamada For modules inside an initrd or initramfs, it's more efficient to 2251d4bbe942SMasahiro Yamada compress the whole initrd or initramfs instead. 2252d4bbe942SMasahiro Yamada 2253d4bbe942SMasahiro Yamada This is fully compatible with signed modules. 2254d4bbe942SMasahiro Yamada 2255d4bbe942SMasahiro Yamada Please note that the tool used to load modules needs to support the 2256d4bbe942SMasahiro Yamada corresponding algorithm. module-init-tools MAY support gzip, and kmod 2257c3d7ef37SPiotr Gorski MAY support gzip, xz and zstd. 2258d4bbe942SMasahiro Yamada 2259d4bbe942SMasahiro Yamada Your build system needs to provide the appropriate compression tool 2260d4bbe942SMasahiro Yamada to compress the modules. 2261d4bbe942SMasahiro Yamada 2262d4bbe942SMasahiro Yamada If in doubt, select 'None'. 2263d4bbe942SMasahiro Yamada 2264d4bbe942SMasahiro Yamadaconfig MODULE_COMPRESS_NONE 2265d4bbe942SMasahiro Yamada bool "None" 2266d4bbe942SMasahiro Yamada help 2267d4bbe942SMasahiro Yamada Do not compress modules. The installed modules are suffixed 2268d4bbe942SMasahiro Yamada with .ko. 2269beb50df3SBertrand Jacquin 2270beb50df3SBertrand Jacquinconfig MODULE_COMPRESS_GZIP 2271beb50df3SBertrand Jacquin bool "GZIP" 2272d4bbe942SMasahiro Yamada help 2273d4bbe942SMasahiro Yamada Compress modules with GZIP. The installed modules are suffixed 2274d4bbe942SMasahiro Yamada with .ko.gz. 2275beb50df3SBertrand Jacquin 2276beb50df3SBertrand Jacquinconfig MODULE_COMPRESS_XZ 2277beb50df3SBertrand Jacquin bool "XZ" 2278d4bbe942SMasahiro Yamada help 2279d4bbe942SMasahiro Yamada Compress modules with XZ. The installed modules are suffixed 2280d4bbe942SMasahiro Yamada with .ko.xz. 2281beb50df3SBertrand Jacquin 2282c3d7ef37SPiotr Gorskiconfig MODULE_COMPRESS_ZSTD 2283c3d7ef37SPiotr Gorski bool "ZSTD" 2284c3d7ef37SPiotr Gorski help 2285c3d7ef37SPiotr Gorski Compress modules with ZSTD. The installed modules are suffixed 2286c3d7ef37SPiotr Gorski with .ko.zst. 2287beb50df3SBertrand Jacquin 2288beb50df3SBertrand Jacquinendchoice 2289beb50df3SBertrand Jacquin 2290b1ae6dc4SDmitry Torokhovconfig MODULE_DECOMPRESS 2291b1ae6dc4SDmitry Torokhov bool "Support in-kernel module decompression" 2292b1ae6dc4SDmitry Torokhov depends on MODULE_COMPRESS_GZIP || MODULE_COMPRESS_XZ 2293b1ae6dc4SDmitry Torokhov select ZLIB_INFLATE if MODULE_COMPRESS_GZIP 2294b1ae6dc4SDmitry Torokhov select XZ_DEC if MODULE_COMPRESS_XZ 2295b1ae6dc4SDmitry Torokhov help 2296b1ae6dc4SDmitry Torokhov 2297b1ae6dc4SDmitry Torokhov Support for decompressing kernel modules by the kernel itself 2298b1ae6dc4SDmitry Torokhov instead of relying on userspace to perform this task. Useful when 2299b1ae6dc4SDmitry Torokhov load pinning security policy is enabled. 2300b1ae6dc4SDmitry Torokhov 2301b1ae6dc4SDmitry Torokhov If unsure, say N. 2302b1ae6dc4SDmitry Torokhov 23033d52ec5eSMatthias Maennichconfig MODULE_ALLOW_MISSING_NAMESPACE_IMPORTS 23043d52ec5eSMatthias Maennich bool "Allow loading of modules with missing namespace imports" 23053d52ec5eSMatthias Maennich help 23063d52ec5eSMatthias Maennich Symbols exported with EXPORT_SYMBOL_NS*() are considered exported in 23073d52ec5eSMatthias Maennich a namespace. A module that makes use of a symbol exported with such a 23083d52ec5eSMatthias Maennich namespace is required to import the namespace via MODULE_IMPORT_NS(). 23093d52ec5eSMatthias Maennich There is no technical reason to enforce correct namespace imports, 23103d52ec5eSMatthias Maennich but it creates consistency between symbols defining namespaces and 23113d52ec5eSMatthias Maennich users importing namespaces they make use of. This option relaxes this 23123d52ec5eSMatthias Maennich requirement and lifts the enforcement when loading a module. 23133d52ec5eSMatthias Maennich 23143d52ec5eSMatthias Maennich If unsure, say N. 23153d52ec5eSMatthias Maennich 231617652f42SRasmus Villemoesconfig MODPROBE_PATH 231717652f42SRasmus Villemoes string "Path to modprobe binary" 231817652f42SRasmus Villemoes default "/sbin/modprobe" 231917652f42SRasmus Villemoes help 232017652f42SRasmus Villemoes When kernel code requests a module, it does so by calling 232117652f42SRasmus Villemoes the "modprobe" userspace utility. This option allows you to 232217652f42SRasmus Villemoes set the path where that binary is found. This can be changed 232317652f42SRasmus Villemoes at runtime via the sysctl file 232417652f42SRasmus Villemoes /proc/sys/kernel/modprobe. Setting this to the empty string 232517652f42SRasmus Villemoes removes the kernel's ability to request modules (but 232617652f42SRasmus Villemoes userspace can still load modules explicitly). 232717652f42SRasmus Villemoes 2328dbacb0efSNicolas Pitreconfig TRIM_UNUSED_KSYMS 2329a555bdd0SLinus Torvalds bool "Trim unused exported kernel symbols" if EXPERT 2330a555bdd0SLinus Torvalds depends on !COMPILE_TEST 2331dbacb0efSNicolas Pitre help 2332dbacb0efSNicolas Pitre The kernel and some modules make many symbols available for 2333dbacb0efSNicolas Pitre other modules to use via EXPORT_SYMBOL() and variants. Depending 2334dbacb0efSNicolas Pitre on the set of modules being selected in your kernel configuration, 2335dbacb0efSNicolas Pitre many of those exported symbols might never be used. 2336dbacb0efSNicolas Pitre 2337dbacb0efSNicolas Pitre This option allows for unused exported symbols to be dropped from 2338dbacb0efSNicolas Pitre the build. In turn, this provides the compiler more opportunities 2339dbacb0efSNicolas Pitre (especially when using LTO) for optimizing the code and reducing 2340dbacb0efSNicolas Pitre binary size. This might have some security advantages as well. 2341dbacb0efSNicolas Pitre 2342f1cb637eSValdis Kletnieks If unsure, or if you need to build out-of-tree modules, say N. 2343dbacb0efSNicolas Pitre 23441518c633SQuentin Perretconfig UNUSED_KSYMS_WHITELIST 23451518c633SQuentin Perret string "Whitelist of symbols to keep in ksymtab" 23461518c633SQuentin Perret depends on TRIM_UNUSED_KSYMS 23471518c633SQuentin Perret help 23481518c633SQuentin Perret By default, all unused exported symbols will be un-exported from the 23491518c633SQuentin Perret build when TRIM_UNUSED_KSYMS is selected. 23501518c633SQuentin Perret 23511518c633SQuentin Perret UNUSED_KSYMS_WHITELIST allows to whitelist symbols that must be kept 23521518c633SQuentin Perret exported at all times, even in absence of in-tree users. The value to 23531518c633SQuentin Perret set here is the path to a text file containing the list of symbols, 23541518c633SQuentin Perret one per line. The path can be absolute, or relative to the kernel 23551518c633SQuentin Perret source tree. 23561518c633SQuentin Perret 23570b0de144SRobert P. J. Dayendif # MODULES 23580b0de144SRobert P. J. Day 23596c9692e2SPeter Zijlstraconfig MODULES_TREE_LOOKUP 23606c9692e2SPeter Zijlstra def_bool y 2361cf68fffbSSami Tolvanen depends on PERF_EVENTS || TRACING || CFI_CLANG 23626c9692e2SPeter Zijlstra 236398a79d6aSRusty Russellconfig INIT_ALL_POSSIBLE 236498a79d6aSRusty Russell bool 236598a79d6aSRusty Russell help 23665f054e31SRusty Russell Back when each arch used to define their own cpu_online_mask and 23675f054e31SRusty Russell cpu_possible_mask, some of them chose to initialize cpu_possible_mask 236898a79d6aSRusty Russell with all 1s, and others with all 0s. When they were centralised, 236998a79d6aSRusty Russell it was better to provide this option than to break all the archs 2370692105b8SMatt LaPlante and have several arch maintainers pursuing me down dark alleys. 237198a79d6aSRusty Russell 23723a65dfe8SJens Axboesource "block/Kconfig" 2373e98c3202SAvi Kivity 2374e98c3202SAvi Kivityconfig PREEMPT_NOTIFIERS 2375e98c3202SAvi Kivity bool 2376e260be67SPaul E. McKenney 237716295becSSteffen Klassertconfig PADATA 237816295becSSteffen Klassert depends on SMP 237916295becSSteffen Klassert bool 238016295becSSteffen Klassert 23814520c6a4SDavid Howellsconfig ASN1 23824520c6a4SDavid Howells tristate 23834520c6a4SDavid Howells help 23844520c6a4SDavid Howells Build a simple ASN.1 grammar compiler that produces a bytecode output 23854520c6a4SDavid Howells that can be interpreted by the ASN.1 stream decoder and used to 23864520c6a4SDavid Howells inform it as to what tags are to be expected in a stream and what 23874520c6a4SDavid Howells functions to call on what tags. 23884520c6a4SDavid Howells 23896beb0009SThomas Gleixnersource "kernel/Kconfig.locks" 2390e61938a9SMathieu Desnoyers 23910ebeea8cSDaniel Borkmannconfig ARCH_HAS_NON_OVERLAPPING_ADDRESS_SPACE 23920ebeea8cSDaniel Borkmann bool 23930ebeea8cSDaniel Borkmann 2394e61938a9SMathieu Desnoyersconfig ARCH_HAS_SYNC_CORE_BEFORE_USERMODE 2395e61938a9SMathieu Desnoyers bool 23961bd21c6cSDominik Brodowski 23971bd21c6cSDominik Brodowski# It may be useful for an architecture to override the definitions of the 23987303e30eSDominik Brodowski# SYSCALL_DEFINE() and __SYSCALL_DEFINEx() macros in <linux/syscalls.h> 23997303e30eSDominik Brodowski# and the COMPAT_ variants in <linux/compat.h>, in particular to use a 24007303e30eSDominik Brodowski# different calling convention for syscalls. They can also override the 24017303e30eSDominik Brodowski# macros for not-implemented syscalls in kernel/sys_ni.c and 24027303e30eSDominik Brodowski# kernel/time/posix-stubs.c. All these overrides need to be available in 24037303e30eSDominik Brodowski# <asm/syscall_wrapper.h>. 24041bd21c6cSDominik Brodowskiconfig ARCH_HAS_SYSCALL_WRAPPER 24051bd21c6cSDominik Brodowski def_bool n 2406