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 632f7ab126SMiguel Ojedaconfig RUST_IS_AVAILABLE 642f7ab126SMiguel Ojeda def_bool $(success,$(srctree)/scripts/rust_is_available.sh) 652f7ab126SMiguel Ojeda help 662f7ab126SMiguel Ojeda This shows whether a suitable Rust toolchain is available (found). 672f7ab126SMiguel Ojeda 682f7ab126SMiguel Ojeda Please see Documentation/rust/quick-start.rst for instructions on how 69eacf96d2SColin Ian King to satisfy the build requirements of Rust support. 702f7ab126SMiguel Ojeda 712f7ab126SMiguel Ojeda In particular, the Makefile target 'rustavailable' is useful to check 722f7ab126SMiguel Ojeda why the Rust toolchain is not being detected. 732f7ab126SMiguel Ojeda 741a927fd3SMasahiro Yamadaconfig CC_CAN_LINK 759371f86eSMasahiro Yamada bool 76f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag)) if 64BIT 77f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag)) 781a927fd3SMasahiro Yamada 79b1183b6dSMasahiro Yamadaconfig CC_CAN_LINK_STATIC 80b1183b6dSMasahiro Yamada bool 81f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag) -static) if 64BIT 82f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag) -static) 83c65eacbeSAndy Lutomirski 84587f1701SNick Desaulniersconfig CC_HAS_ASM_GOTO_OUTPUT 85587f1701SNick 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) 86587f1701SNick Desaulniers 871aa0e8b1SSean Christophersonconfig CC_HAS_ASM_GOTO_TIED_OUTPUT 881aa0e8b1SSean Christopherson depends on CC_HAS_ASM_GOTO_OUTPUT 891aa0e8b1SSean Christopherson # Detect buggy gcc and clang, fixed in gcc-11 clang-14. 90534bd703SAlexandre Belloni def_bool $(success,echo 'int foo(int *x) { asm goto (".long (%l[bar]) - .": "+m"(*x) ::: bar); return *x; bar: return 0; }' | $CC -x c - -c -o /dev/null) 911aa0e8b1SSean Christopherson 925cf896fbSPeter Collingbourneconfig TOOLS_SUPPORT_RELR 932d122942SWill Deacon def_bool $(success,env "CC=$(CC)" "LD=$(LD)" "NM=$(NM)" "OBJCOPY=$(OBJCOPY)" $(srctree)/scripts/tools-support-relr.sh) 945cf896fbSPeter Collingbourne 95eb111869SRasmus Villemoesconfig CC_HAS_ASM_INLINE 96eb111869SRasmus Villemoes def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null) 97eb111869SRasmus Villemoes 9851c2ee6dSNick Desaulniersconfig CC_HAS_NO_PROFILE_FN_ATTR 9951c2ee6dSNick Desaulniers def_bool $(success,echo '__attribute__((no_profile_instrument_function)) int x();' | $(CC) -x c - -c -o /dev/null -Werror) 10051c2ee6dSNick Desaulniers 101613fe169SNathan Chancellorconfig PAHOLE_VERSION 102613fe169SNathan Chancellor int 103613fe169SNathan Chancellor default $(shell,$(srctree)/scripts/pahole-version.sh $(PAHOLE)) 104613fe169SNathan Chancellor 105b99b87f7SPeter Oberparleiterconfig CONSTRUCTORS 106b99b87f7SPeter Oberparleiter bool 107b99b87f7SPeter Oberparleiter 108e360adbeSPeter Zijlstraconfig IRQ_WORK 109e360adbeSPeter Zijlstra bool 110e360adbeSPeter Zijlstra 11110916706SShile Zhangconfig BUILDTIME_TABLE_SORT 1121dbdc6f1SDavid Daney bool 1131dbdc6f1SDavid Daney 114c65eacbeSAndy Lutomirskiconfig THREAD_INFO_IN_TASK 115c65eacbeSAndy Lutomirski bool 116c65eacbeSAndy Lutomirski help 117c65eacbeSAndy Lutomirski Select this to move thread_info off the stack into task_struct. To 118c65eacbeSAndy Lutomirski make this work, an arch will need to remove all thread_info fields 119c65eacbeSAndy Lutomirski except flags and fix any runtime bugs. 120c65eacbeSAndy Lutomirski 121c6c314a6SAndy Lutomirski One subtle change that will be needed is to use try_get_task_stack() 122c6c314a6SAndy Lutomirski and put_task_stack() in save_thread_stack_tsk() and get_wchan(). 123c6c314a6SAndy Lutomirski 124ff0cfc66SAl Boldimenu "General setup" 1251da177e4SLinus Torvalds 1261da177e4SLinus Torvaldsconfig BROKEN 1271da177e4SLinus Torvalds bool 1281da177e4SLinus Torvalds 1291da177e4SLinus Torvaldsconfig BROKEN_ON_SMP 1301da177e4SLinus Torvalds bool 1311da177e4SLinus Torvalds depends on BROKEN || !SMP 1321da177e4SLinus Torvalds default y 1331da177e4SLinus Torvalds 1341da177e4SLinus Torvaldsconfig INIT_ENV_ARG_LIMIT 1351da177e4SLinus Torvalds int 136dd673bcaSAdrian Bunk default 32 if !UML 137dd673bcaSAdrian Bunk default 128 if UML 1381da177e4SLinus Torvalds help 13934ad92c2SRandy Dunlap Maximum of each of the number of arguments and environment 14034ad92c2SRandy Dunlap variables passed to init from the kernel command line. 1411da177e4SLinus Torvalds 1424bb16672SJiri Slabyconfig COMPILE_TEST 1434bb16672SJiri Slaby bool "Compile also drivers which will not load" 144ea29b20aSMasahiro Yamada depends on HAS_IOMEM 1454bb16672SJiri Slaby help 1464bb16672SJiri Slaby Some drivers can be compiled on a different platform than they are 1474bb16672SJiri Slaby intended to be run on. Despite they cannot be loaded there (or even 1484bb16672SJiri Slaby when they load they cannot be used due to missing HW support), 1494bb16672SJiri Slaby developers still, opposing to distributors, might want to build such 1504bb16672SJiri Slaby drivers to compile-test them. 1514bb16672SJiri Slaby 1524bb16672SJiri Slaby If you are a developer and want to build everything available, say Y 1534bb16672SJiri Slaby here. If you are a user/distributor, say N here to exclude useless 1544bb16672SJiri Slaby drivers to be distributed. 1554bb16672SJiri Slaby 1563fe617ccSLinus Torvaldsconfig WERROR 1573fe617ccSLinus Torvalds bool "Compile the kernel with warnings as errors" 158b339ec9cSMarco Elver default COMPILE_TEST 1593fe617ccSLinus Torvalds help 1603fe617ccSLinus Torvalds A kernel build should not cause any compiler warnings, and this 1612f7ab126SMiguel Ojeda enables the '-Werror' (for C) and '-Dwarnings' (for Rust) flags 162e1789d7cSXin Li to enforce that rule by default. Certain warnings from other tools 163e1789d7cSXin Li such as the linker may be upgraded to errors with this option as 164e1789d7cSXin Li well. 1653fe617ccSLinus Torvalds 166e1789d7cSXin Li However, if you have a new (or very old) compiler or linker with odd 167e1789d7cSXin Li and unusual warnings, or you have some architecture with problems, 1683fe617ccSLinus Torvalds you may need to disable this config option in order to 1693fe617ccSLinus Torvalds successfully build the kernel. 1703fe617ccSLinus Torvalds 1713fe617ccSLinus Torvalds If in doubt, say Y. 1723fe617ccSLinus Torvalds 173d6fc9fcbSMasahiro Yamadaconfig UAPI_HEADER_TEST 174d6fc9fcbSMasahiro Yamada bool "Compile test UAPI headers" 175fcbb8461SMasahiro Yamada depends on HEADERS_INSTALL && CC_CAN_LINK 176d6fc9fcbSMasahiro Yamada help 177d6fc9fcbSMasahiro Yamada Compile test headers exported to user-space to ensure they are 178d6fc9fcbSMasahiro Yamada self-contained, i.e. compilable as standalone units. 179d6fc9fcbSMasahiro Yamada 180d6fc9fcbSMasahiro Yamada If you are a developer or tester and want to ensure the exported 181d6fc9fcbSMasahiro Yamada headers are self-contained, say Y here. Otherwise, choose N. 182d6fc9fcbSMasahiro Yamada 1831da177e4SLinus Torvaldsconfig LOCALVERSION 1841da177e4SLinus Torvalds string "Local version - append to kernel release" 1851da177e4SLinus Torvalds help 1861da177e4SLinus Torvalds Append an extra string to the end of your kernel version. 1871da177e4SLinus Torvalds This will show up when you type uname, for example. 1881da177e4SLinus Torvalds The string you set here will be appended after the contents of 1891da177e4SLinus Torvalds any files with a filename matching localversion* in your 1901da177e4SLinus Torvalds object and source tree, in that order. Your total string can 1911da177e4SLinus Torvalds be a maximum of 64 characters. 1921da177e4SLinus Torvalds 193aaebf433SRyan Andersonconfig LOCALVERSION_AUTO 194aaebf433SRyan Anderson bool "Automatically append version information to the version string" 195aaebf433SRyan Anderson default y 196ac3339baSAlexey Dobriyan depends on !COMPILE_TEST 197aaebf433SRyan Anderson help 198aaebf433SRyan Anderson This will try to automatically determine if the current tree is a 1996e5a5420SRobert P. J. Day release tree by looking for git tags that belong to the current 2006e5a5420SRobert P. J. Day top of tree revision. 201aaebf433SRyan Anderson 202aaebf433SRyan Anderson A string of the format -gxxxxxxxx will be added to the localversion 2036e5a5420SRobert P. J. Day if a git-based tree is found. The string generated by this will be 204aaebf433SRyan Anderson appended after any matching localversion* files, and after the value 2056e5a5420SRobert P. J. Day set in CONFIG_LOCALVERSION. 206aaebf433SRyan Anderson 2070f9c608dSRasmus Villemoes (The actual string used here is the first 12 characters produced 2086e5a5420SRobert P. J. Day by running the command: 2096e5a5420SRobert P. J. Day 2106e5a5420SRobert P. J. Day $ git rev-parse --verify HEAD 2116e5a5420SRobert P. J. Day 2126e5a5420SRobert P. J. Day which is done within the script "scripts/setlocalversion".) 213aaebf433SRyan Anderson 2149afb719eSLaura Abbottconfig BUILD_SALT 2159afb719eSLaura Abbott string "Build ID Salt" 2169afb719eSLaura Abbott default "" 2179afb719eSLaura Abbott help 2189afb719eSLaura Abbott The build ID is used to link binaries and their debug info. Setting 2199afb719eSLaura Abbott this option will use the value in the calculation of the build id. 2209afb719eSLaura Abbott This is mostly useful for distributions which want to ensure the 2219afb719eSLaura Abbott build is unique between builds. It's safe to leave the default. 2229afb719eSLaura Abbott 2232e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_GZIP 2242e9f3bddSH. Peter Anvin bool 2252e9f3bddSH. Peter Anvin 2262e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_BZIP2 2272e9f3bddSH. Peter Anvin bool 2282e9f3bddSH. Peter Anvin 2292e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_LZMA 2302e9f3bddSH. Peter Anvin bool 2312e9f3bddSH. Peter Anvin 2323ebe1243SLasse Collinconfig HAVE_KERNEL_XZ 2333ebe1243SLasse Collin bool 2343ebe1243SLasse Collin 2357dd65febSAlbin Tonnerreconfig HAVE_KERNEL_LZO 2367dd65febSAlbin Tonnerre bool 2377dd65febSAlbin Tonnerre 238e76e1fdfSKyungsik Leeconfig HAVE_KERNEL_LZ4 239e76e1fdfSKyungsik Lee bool 240e76e1fdfSKyungsik Lee 24148f7ddf7SNick Terrellconfig HAVE_KERNEL_ZSTD 24248f7ddf7SNick Terrell bool 24348f7ddf7SNick Terrell 244f16466afSVasily Gorbikconfig HAVE_KERNEL_UNCOMPRESSED 245f16466afSVasily Gorbik bool 246f16466afSVasily Gorbik 24730d65dbfSAlain Knaffchoice 24830d65dbfSAlain Knaff prompt "Kernel compression mode" 24930d65dbfSAlain Knaff default KERNEL_GZIP 25048f7ddf7SNick 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 25130d65dbfSAlain Knaff help 25230d65dbfSAlain Knaff The linux kernel is a kind of self-extracting executable. 25330d65dbfSAlain Knaff Several compression algorithms are available, which differ 25430d65dbfSAlain Knaff in efficiency, compression and decompression speed. 25530d65dbfSAlain Knaff Compression speed is only relevant when building a kernel. 25630d65dbfSAlain Knaff Decompression speed is relevant at each boot. 25730d65dbfSAlain Knaff 25830d65dbfSAlain Knaff If you have any problems with bzip2 or lzma compressed 25930d65dbfSAlain Knaff kernels, mail me (Alain Knaff) <alain@knaff.lu>. (An older 26030d65dbfSAlain Knaff version of this functionality (bzip2 only), for 2.4, was 26130d65dbfSAlain Knaff supplied by Christian Ludwig) 26230d65dbfSAlain Knaff 26330d65dbfSAlain Knaff High compression options are mostly useful for users, who 26430d65dbfSAlain Knaff are low on disk space (embedded systems), but for whom ram 26530d65dbfSAlain Knaff size matters less. 26630d65dbfSAlain Knaff 26730d65dbfSAlain Knaff If in doubt, select 'gzip' 26830d65dbfSAlain Knaff 26930d65dbfSAlain Knaffconfig KERNEL_GZIP 27030d65dbfSAlain Knaff bool "Gzip" 2712e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_GZIP 27230d65dbfSAlain Knaff help 2737dd65febSAlbin Tonnerre The old and tried gzip compression. It provides a good balance 2747dd65febSAlbin Tonnerre between compression ratio and decompression speed. 27530d65dbfSAlain Knaff 27630d65dbfSAlain Knaffconfig KERNEL_BZIP2 27730d65dbfSAlain Knaff bool "Bzip2" 2782e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_BZIP2 27930d65dbfSAlain Knaff help 28030d65dbfSAlain Knaff Its compression ratio and speed is intermediate. 2810a4dd35cSRandy Dunlap Decompression speed is slowest among the choices. The kernel 2822e9f3bddSH. Peter Anvin size is about 10% smaller with bzip2, in comparison to gzip. 2832e9f3bddSH. Peter Anvin Bzip2 uses a large amount of memory. For modern kernels you 2842e9f3bddSH. Peter Anvin will need at least 8MB RAM or more for booting. 28530d65dbfSAlain Knaff 28630d65dbfSAlain Knaffconfig KERNEL_LZMA 28730d65dbfSAlain Knaff bool "LZMA" 2882e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_LZMA 28930d65dbfSAlain Knaff help 2900a4dd35cSRandy Dunlap This compression algorithm's ratio is best. Decompression speed 2910a4dd35cSRandy Dunlap is between gzip and bzip2. Compression is slowest. 2920a4dd35cSRandy Dunlap The kernel size is about 33% smaller with LZMA in comparison to gzip. 29330d65dbfSAlain Knaff 2943ebe1243SLasse Collinconfig KERNEL_XZ 2953ebe1243SLasse Collin bool "XZ" 2963ebe1243SLasse Collin depends on HAVE_KERNEL_XZ 2973ebe1243SLasse Collin help 2983ebe1243SLasse Collin XZ uses the LZMA2 algorithm and instruction set specific 2993ebe1243SLasse Collin BCJ filters which can improve compression ratio of executable 3003ebe1243SLasse Collin code. The size of the kernel is about 30% smaller with XZ in 3013ebe1243SLasse Collin comparison to gzip. On architectures for which there is a BCJ 3023ebe1243SLasse Collin filter (i386, x86_64, ARM, IA-64, PowerPC, and SPARC), XZ 3033ebe1243SLasse Collin will create a few percent smaller kernel than plain LZMA. 3043ebe1243SLasse Collin 3053ebe1243SLasse Collin The speed is about the same as with LZMA: The decompression 3063ebe1243SLasse Collin speed of XZ is better than that of bzip2 but worse than gzip 3073ebe1243SLasse Collin and LZO. Compression is slow. 3083ebe1243SLasse Collin 3097dd65febSAlbin Tonnerreconfig KERNEL_LZO 3107dd65febSAlbin Tonnerre bool "LZO" 3117dd65febSAlbin Tonnerre depends on HAVE_KERNEL_LZO 3127dd65febSAlbin Tonnerre help 3130a4dd35cSRandy Dunlap Its compression ratio is the poorest among the choices. The kernel 314681b3049SStephan Sperber size is about 10% bigger than gzip; however its speed 3157dd65febSAlbin Tonnerre (both compression and decompression) is the fastest. 3167dd65febSAlbin Tonnerre 317e76e1fdfSKyungsik Leeconfig KERNEL_LZ4 318e76e1fdfSKyungsik Lee bool "LZ4" 319e76e1fdfSKyungsik Lee depends on HAVE_KERNEL_LZ4 320e76e1fdfSKyungsik Lee help 321e76e1fdfSKyungsik Lee LZ4 is an LZ77-type compressor with a fixed, byte-oriented encoding. 322e76e1fdfSKyungsik Lee A preliminary version of LZ4 de/compression tool is available at 323e76e1fdfSKyungsik Lee <https://code.google.com/p/lz4/>. 324e76e1fdfSKyungsik Lee 325e76e1fdfSKyungsik Lee Its compression ratio is worse than LZO. The size of the kernel 326e76e1fdfSKyungsik Lee is about 8% bigger than LZO. But the decompression speed is 327e76e1fdfSKyungsik Lee faster than LZO. 328e76e1fdfSKyungsik Lee 32948f7ddf7SNick Terrellconfig KERNEL_ZSTD 33048f7ddf7SNick Terrell bool "ZSTD" 33148f7ddf7SNick Terrell depends on HAVE_KERNEL_ZSTD 33248f7ddf7SNick Terrell help 33348f7ddf7SNick Terrell ZSTD is a compression algorithm targeting intermediate compression 33448f7ddf7SNick Terrell with fast decompression speed. It will compress better than GZIP and 33548f7ddf7SNick Terrell decompress around the same speed as LZO, but slower than LZ4. You 33648f7ddf7SNick Terrell will need at least 192 KB RAM or more for booting. The zstd command 33748f7ddf7SNick Terrell line tool is required for compression. 33848f7ddf7SNick Terrell 339f16466afSVasily Gorbikconfig KERNEL_UNCOMPRESSED 340f16466afSVasily Gorbik bool "None" 341f16466afSVasily Gorbik depends on HAVE_KERNEL_UNCOMPRESSED 342f16466afSVasily Gorbik help 343f16466afSVasily Gorbik Produce uncompressed kernel image. This option is usually not what 344f16466afSVasily Gorbik you want. It is useful for debugging the kernel in slow simulation 345f16466afSVasily Gorbik environments, where decompressing and moving the kernel is awfully 346f16466afSVasily Gorbik slow. This option allows early boot code to skip the decompressor 347f16466afSVasily Gorbik and jump right at uncompressed kernel image. 348f16466afSVasily Gorbik 34930d65dbfSAlain Knaffendchoice 35030d65dbfSAlain Knaff 351ada4ab7aSChris Downconfig DEFAULT_INIT 352ada4ab7aSChris Down string "Default init path" 353ada4ab7aSChris Down default "" 354ada4ab7aSChris Down help 355ada4ab7aSChris Down This option determines the default init for the system if no init= 356ada4ab7aSChris Down option is passed on the kernel command line. If the requested path is 357ada4ab7aSChris Down not present, we will still then move on to attempting further 358ada4ab7aSChris Down locations (e.g. /sbin/init, etc). If this is empty, we will just use 359ada4ab7aSChris Down the fallback list when init= is not passed. 360ada4ab7aSChris Down 361bd5dc17bSJosh Triplettconfig DEFAULT_HOSTNAME 362bd5dc17bSJosh Triplett string "Default hostname" 363bd5dc17bSJosh Triplett default "(none)" 364bd5dc17bSJosh Triplett help 365bd5dc17bSJosh Triplett This option determines the default system hostname before userspace 366bd5dc17bSJosh Triplett calls sethostname(2). The kernel traditionally uses "(none)" here, 367bd5dc17bSJosh Triplett but you may wish to use a different default here to make a minimal 368bd5dc17bSJosh Triplett system more usable with less configuration. 369bd5dc17bSJosh Triplett 3701da177e4SLinus Torvaldsconfig SYSVIPC 3711da177e4SLinus Torvalds bool "System V IPC" 372a7f7f624SMasahiro Yamada help 3731da177e4SLinus Torvalds Inter Process Communication is a suite of library functions and 3741da177e4SLinus Torvalds system calls which let processes (running programs) synchronize and 3751da177e4SLinus Torvalds exchange information. It is generally considered to be a good thing, 3761da177e4SLinus Torvalds and some programs won't run unless you say Y here. In particular, if 3771da177e4SLinus Torvalds you want to run the DOS emulator dosemu under Linux (read the 3781da177e4SLinus Torvalds DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>), 3791da177e4SLinus Torvalds you'll need to say Y here. 3801da177e4SLinus Torvalds 3811da177e4SLinus Torvalds You can find documentation about IPC with "info ipc" and also in 3821da177e4SLinus Torvalds section 6.4 of the Linux Programmer's Guide, available from 3831da177e4SLinus Torvalds <http://www.tldp.org/guides.html>. 3841da177e4SLinus Torvalds 385a5494dcdSEric W. Biedermanconfig SYSVIPC_SYSCTL 386a5494dcdSEric W. Biederman bool 387a5494dcdSEric W. Biederman depends on SYSVIPC 388a5494dcdSEric W. Biederman depends on SYSCTL 389a5494dcdSEric W. Biederman default y 390a5494dcdSEric W. Biederman 3910cbed0eeSGuo Renconfig SYSVIPC_COMPAT 3920cbed0eeSGuo Ren def_bool y 3930cbed0eeSGuo Ren depends on COMPAT && SYSVIPC 3940cbed0eeSGuo Ren 3951da177e4SLinus Torvaldsconfig POSIX_MQUEUE 3961da177e4SLinus Torvalds bool "POSIX Message Queues" 39719c92399SKees Cook depends on NET 398a7f7f624SMasahiro Yamada help 3991da177e4SLinus Torvalds POSIX variant of message queues is a part of IPC. In POSIX message 4001da177e4SLinus Torvalds queues every message has a priority which decides about succession 4011da177e4SLinus Torvalds of receiving it by a process. If you want to compile and run 4021da177e4SLinus Torvalds programs written e.g. for Solaris with use of its POSIX message 403b0e37650SRobert P. J. Day queues (functions mq_*) say Y here. 4041da177e4SLinus Torvalds 4051da177e4SLinus Torvalds POSIX message queues are visible as a filesystem called 'mqueue' 4061da177e4SLinus Torvalds and can be mounted somewhere if you want to do filesystem 4071da177e4SLinus Torvalds operations on message queues. 4081da177e4SLinus Torvalds 4091da177e4SLinus Torvalds If unsure, say Y. 4101da177e4SLinus Torvalds 411bdc8e5f8SSerge E. Hallynconfig POSIX_MQUEUE_SYSCTL 412bdc8e5f8SSerge E. Hallyn bool 413bdc8e5f8SSerge E. Hallyn depends on POSIX_MQUEUE 414bdc8e5f8SSerge E. Hallyn depends on SYSCTL 415bdc8e5f8SSerge E. Hallyn default y 416bdc8e5f8SSerge E. Hallyn 417c73be61cSDavid Howellsconfig WATCH_QUEUE 418c73be61cSDavid Howells bool "General notification queue" 419c73be61cSDavid Howells default n 420c73be61cSDavid Howells help 421c73be61cSDavid Howells 422c73be61cSDavid Howells This is a general notification queue for the kernel to pass events to 423c73be61cSDavid Howells userspace by splicing them into pipes. It can be used in conjunction 424c73be61cSDavid Howells with watches for key/keyring change notifications and device 425c73be61cSDavid Howells notifications. 426c73be61cSDavid Howells 427c02b872aSMauro Carvalho Chehab See Documentation/core-api/watch_queue.rst 428c73be61cSDavid Howells 429226b4ccdSKonstantin Khlebnikovconfig CROSS_MEMORY_ATTACH 430226b4ccdSKonstantin Khlebnikov bool "Enable process_vm_readv/writev syscalls" 431226b4ccdSKonstantin Khlebnikov depends on MMU 432226b4ccdSKonstantin Khlebnikov default y 433226b4ccdSKonstantin Khlebnikov help 434226b4ccdSKonstantin Khlebnikov Enabling this option adds the system calls process_vm_readv and 435226b4ccdSKonstantin Khlebnikov process_vm_writev which allow a process with the correct privileges 436a2a368d9SGeert Uytterhoeven to directly read from or write to another process' address space. 437226b4ccdSKonstantin Khlebnikov See the man page for more details. 438226b4ccdSKonstantin Khlebnikov 43969369a70SJosh Triplettconfig USELIB 4407374fa33SKees Cook bool "uselib syscall (for libc5 and earlier)" 4417374fa33SKees Cook default ALPHA || M68K || SPARC 44269369a70SJosh Triplett help 44369369a70SJosh Triplett This option enables the uselib syscall, a system call used in the 44469369a70SJosh Triplett dynamic linker from libc5 and earlier. glibc does not use this 44569369a70SJosh Triplett system call. If you intend to run programs built on libc5 or 44669369a70SJosh Triplett earlier, you may need to enable this syscall. Current systems 44769369a70SJosh Triplett running glibc can safely disable this. 44869369a70SJosh Triplett 4491da177e4SLinus Torvaldsconfig AUDIT 4501da177e4SLinus Torvalds bool "Auditing support" 451804a6a49SChris Wright depends on NET 4521da177e4SLinus Torvalds help 4531da177e4SLinus Torvalds Enable auditing infrastructure that can be used with another 4541da177e4SLinus Torvalds kernel subsystem, such as SELinux (which requires this for 455cb74ed27SPaul Moore logging of avc messages output). System call auditing is included 456cb74ed27SPaul Moore on architectures which support it. 4571da177e4SLinus Torvalds 4587a017721SAKASHI Takahiroconfig HAVE_ARCH_AUDITSYSCALL 4597a017721SAKASHI Takahiro bool 4607a017721SAKASHI Takahiro 4611da177e4SLinus Torvaldsconfig AUDITSYSCALL 462cb74ed27SPaul Moore def_bool y 4637a017721SAKASHI Takahiro depends on AUDIT && HAVE_ARCH_AUDITSYSCALL 46428a3a7ebSEric Paris select FSNOTIFY 46574c3cbe3SAl Viro 466d9817ebeSThomas Gleixnersource "kernel/irq/Kconfig" 467764e0da1SThomas Gleixnersource "kernel/time/Kconfig" 468b24abcffSDaniel Borkmannsource "kernel/bpf/Kconfig" 46987a4c375SChristoph Hellwigsource "kernel/Kconfig.preempt" 470d9817ebeSThomas Gleixner 471391dc69cSFrederic Weisbeckermenu "CPU/Task time and stats accounting" 472391dc69cSFrederic Weisbecker 473abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING 474abf917cdSFrederic Weisbecker bool 475abf917cdSFrederic Weisbecker 476fdf9c356SFrederic Weisbeckerchoice 477fdf9c356SFrederic Weisbecker prompt "Cputime accounting" 47802382affSNicholas Piggin default TICK_CPU_ACCOUNTING 479fdf9c356SFrederic Weisbecker 480fdf9c356SFrederic Weisbecker# Kind of a stub config for the pure tick based cputime accounting 481fdf9c356SFrederic Weisbeckerconfig TICK_CPU_ACCOUNTING 482fdf9c356SFrederic Weisbecker bool "Simple tick based cputime accounting" 483c58b0df1SFrederic Weisbecker depends on !S390 && !NO_HZ_FULL 484fdf9c356SFrederic Weisbecker help 485fdf9c356SFrederic Weisbecker This is the basic tick based cputime accounting that maintains 486fdf9c356SFrederic Weisbecker statistics about user, system and idle time spent on per jiffies 487fdf9c356SFrederic Weisbecker granularity. 488fdf9c356SFrederic Weisbecker 489fdf9c356SFrederic Weisbecker If unsure, say Y. 490fdf9c356SFrederic Weisbecker 491abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_NATIVE 492391dc69cSFrederic Weisbecker bool "Deterministic task and CPU time accounting" 493c58b0df1SFrederic Weisbecker depends on HAVE_VIRT_CPU_ACCOUNTING && !NO_HZ_FULL 494abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 495391dc69cSFrederic Weisbecker help 496391dc69cSFrederic Weisbecker Select this option to enable more accurate task and CPU time 497391dc69cSFrederic Weisbecker accounting. This is done by reading a CPU counter on each 498391dc69cSFrederic Weisbecker kernel entry and exit and on transitions within the kernel 499391dc69cSFrederic Weisbecker between system, softirq and hardirq state, so there is a 500391dc69cSFrederic Weisbecker small performance impact. In the case of s390 or IBM POWER > 5, 501391dc69cSFrederic Weisbecker this also enables accounting of stolen time on logically-partitioned 502391dc69cSFrederic Weisbecker systems. 503391dc69cSFrederic Weisbecker 504abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_GEN 505abf917cdSFrederic Weisbecker bool "Full dynticks CPU time accounting" 50624a9c541SFrederic Weisbecker depends on HAVE_CONTEXT_TRACKING_USER 507554b0004SKevin Hilman depends on HAVE_VIRT_CPU_ACCOUNTING_GEN 508041a1574SArnd Bergmann depends on GENERIC_CLOCKEVENTS 509abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 51024a9c541SFrederic Weisbecker select CONTEXT_TRACKING_USER 511abf917cdSFrederic Weisbecker help 512abf917cdSFrederic Weisbecker Select this option to enable task and CPU time accounting on full 513abf917cdSFrederic Weisbecker dynticks systems. This accounting is implemented by watching every 514abf917cdSFrederic Weisbecker kernel-user boundaries using the context tracking subsystem. 515abf917cdSFrederic Weisbecker The accounting is thus performed at the expense of some significant 516abf917cdSFrederic Weisbecker overhead. 517abf917cdSFrederic Weisbecker 518abf917cdSFrederic Weisbecker For now this is only useful if you are working on the full 519abf917cdSFrederic Weisbecker dynticks subsystem development. 520abf917cdSFrederic Weisbecker 521abf917cdSFrederic Weisbecker If unsure, say N. 522abf917cdSFrederic Weisbecker 523b58c3584SRik van Rielendchoice 524b58c3584SRik van Riel 525fdf9c356SFrederic Weisbeckerconfig IRQ_TIME_ACCOUNTING 526fdf9c356SFrederic Weisbecker bool "Fine granularity task level IRQ time accounting" 527b58c3584SRik van Riel depends on HAVE_IRQ_TIME_ACCOUNTING && !VIRT_CPU_ACCOUNTING_NATIVE 528fdf9c356SFrederic Weisbecker help 529fdf9c356SFrederic Weisbecker Select this option to enable fine granularity task irq time 530fdf9c356SFrederic Weisbecker accounting. This is done by reading a timestamp on each 531fdf9c356SFrederic Weisbecker transitions between softirq and hardirq state, so there can be a 532fdf9c356SFrederic Weisbecker small performance impact. 533fdf9c356SFrederic Weisbecker 534fdf9c356SFrederic Weisbecker If in doubt, say N here. 535fdf9c356SFrederic Weisbecker 53611d4afd4SVincent Guittotconfig HAVE_SCHED_AVG_IRQ 53711d4afd4SVincent Guittot def_bool y 53811d4afd4SVincent Guittot depends on IRQ_TIME_ACCOUNTING || PARAVIRT_TIME_ACCOUNTING 53911d4afd4SVincent Guittot depends on SMP 54011d4afd4SVincent Guittot 54176504793SThara Gopinathconfig SCHED_THERMAL_PRESSURE 54298eb401dSValentin Schneider bool 543fcd7c9c3SValentin Schneider default y if ARM && ARM_CPU_TOPOLOGY 544fcd7c9c3SValentin Schneider default y if ARM64 54576504793SThara Gopinath depends on SMP 54698eb401dSValentin Schneider depends on CPU_FREQ_THERMAL 54798eb401dSValentin Schneider help 54898eb401dSValentin Schneider Select this option to enable thermal pressure accounting in the 54998eb401dSValentin Schneider scheduler. Thermal pressure is the value conveyed to the scheduler 55098eb401dSValentin Schneider that reflects the reduction in CPU compute capacity resulted from 55198eb401dSValentin Schneider thermal throttling. Thermal throttling occurs when the performance of 55298eb401dSValentin Schneider a CPU is capped due to high operating temperatures. 55398eb401dSValentin Schneider 55498eb401dSValentin Schneider If selected, the scheduler will be able to balance tasks accordingly, 55598eb401dSValentin Schneider i.e. put less load on throttled CPUs than on non/less throttled ones. 55698eb401dSValentin Schneider 55798eb401dSValentin Schneider This requires the architecture to implement 5587e97b3dcSLukasz Luba arch_update_thermal_pressure() and arch_scale_thermal_pressure(). 55976504793SThara Gopinath 560391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT 561391dc69cSFrederic Weisbecker bool "BSD Process Accounting" 5622813893fSIulia Manda depends on MULTIUSER 563391dc69cSFrederic Weisbecker help 564391dc69cSFrederic Weisbecker If you say Y here, a user level program will be able to instruct the 565391dc69cSFrederic Weisbecker kernel (via a special system call) to write process accounting 566391dc69cSFrederic Weisbecker information to a file: whenever a process exits, information about 567391dc69cSFrederic Weisbecker that process will be appended to the file by the kernel. The 568391dc69cSFrederic Weisbecker information includes things such as creation time, owning user, 569391dc69cSFrederic Weisbecker command name, memory usage, controlling terminal etc. (the complete 570391dc69cSFrederic Weisbecker list is in the struct acct in <file:include/linux/acct.h>). It is 571391dc69cSFrederic Weisbecker up to the user level program to do useful things with this 572391dc69cSFrederic Weisbecker information. This is generally a good idea, so say Y. 573391dc69cSFrederic Weisbecker 574391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT_V3 575391dc69cSFrederic Weisbecker bool "BSD Process Accounting version 3 file format" 576391dc69cSFrederic Weisbecker depends on BSD_PROCESS_ACCT 577391dc69cSFrederic Weisbecker default n 578391dc69cSFrederic Weisbecker help 579391dc69cSFrederic Weisbecker If you say Y here, the process accounting information is written 580391dc69cSFrederic Weisbecker in a new file format that also logs the process IDs of each 5813903bf94SRandy Dunlap process and its parent. Note that this file format is incompatible 582391dc69cSFrederic Weisbecker with previous v0/v1/v2 file formats, so you will need updated tools 583391dc69cSFrederic Weisbecker for processing it. A preliminary version of these tools is available 584391dc69cSFrederic Weisbecker at <http://www.gnu.org/software/acct/>. 585391dc69cSFrederic Weisbecker 586391dc69cSFrederic Weisbeckerconfig TASKSTATS 58719c92399SKees Cook bool "Export task/process statistics through netlink" 588391dc69cSFrederic Weisbecker depends on NET 5892813893fSIulia Manda depends on MULTIUSER 590391dc69cSFrederic Weisbecker default n 591391dc69cSFrederic Weisbecker help 592391dc69cSFrederic Weisbecker Export selected statistics for tasks/processes through the 593391dc69cSFrederic Weisbecker generic netlink interface. Unlike BSD process accounting, the 594391dc69cSFrederic Weisbecker statistics are available during the lifetime of tasks/processes as 595391dc69cSFrederic Weisbecker responses to commands. Like BSD accounting, they are sent to user 596391dc69cSFrederic Weisbecker space on task exit. 597391dc69cSFrederic Weisbecker 598391dc69cSFrederic Weisbecker Say N if unsure. 599391dc69cSFrederic Weisbecker 600391dc69cSFrederic Weisbeckerconfig TASK_DELAY_ACCT 60119c92399SKees Cook bool "Enable per-task delay accounting" 602391dc69cSFrederic Weisbecker depends on TASKSTATS 603f6db8347SNaveen N. Rao select SCHED_INFO 604391dc69cSFrederic Weisbecker help 605391dc69cSFrederic Weisbecker Collect information on time spent by a task waiting for system 606391dc69cSFrederic Weisbecker resources like cpu, synchronous block I/O completion and swapping 607391dc69cSFrederic Weisbecker in pages. Such statistics can help in setting a task's priorities 608391dc69cSFrederic Weisbecker relative to other tasks for cpu, io, rss limits etc. 609391dc69cSFrederic Weisbecker 610391dc69cSFrederic Weisbecker Say N if unsure. 611391dc69cSFrederic Weisbecker 612391dc69cSFrederic Weisbeckerconfig TASK_XACCT 61319c92399SKees Cook bool "Enable extended accounting over taskstats" 614391dc69cSFrederic Weisbecker depends on TASKSTATS 615391dc69cSFrederic Weisbecker help 616391dc69cSFrederic Weisbecker Collect extended task accounting data and send the data 617391dc69cSFrederic Weisbecker to userland for processing over the taskstats interface. 618391dc69cSFrederic Weisbecker 619391dc69cSFrederic Weisbecker Say N if unsure. 620391dc69cSFrederic Weisbecker 621391dc69cSFrederic Weisbeckerconfig TASK_IO_ACCOUNTING 62219c92399SKees Cook bool "Enable per-task storage I/O accounting" 623391dc69cSFrederic Weisbecker depends on TASK_XACCT 624391dc69cSFrederic Weisbecker help 625391dc69cSFrederic Weisbecker Collect information on the number of bytes of storage I/O which this 626391dc69cSFrederic Weisbecker task has caused. 627391dc69cSFrederic Weisbecker 628391dc69cSFrederic Weisbecker Say N if unsure. 629391dc69cSFrederic Weisbecker 630eb414681SJohannes Weinerconfig PSI 631eb414681SJohannes Weiner bool "Pressure stall information tracking" 632eb414681SJohannes Weiner help 633eb414681SJohannes Weiner Collect metrics that indicate how overcommitted the CPU, memory, 634eb414681SJohannes Weiner and IO capacity are in the system. 635eb414681SJohannes Weiner 636eb414681SJohannes Weiner If you say Y here, the kernel will create /proc/pressure/ with the 637eb414681SJohannes Weiner pressure statistics files cpu, memory, and io. These will indicate 638eb414681SJohannes Weiner the share of walltime in which some or all tasks in the system are 639eb414681SJohannes Weiner delayed due to contention of the respective resource. 640eb414681SJohannes Weiner 6412ce7135aSJohannes Weiner In kernels with cgroup support, cgroups (cgroup2 only) will 6422ce7135aSJohannes Weiner have cpu.pressure, memory.pressure, and io.pressure files, 6432ce7135aSJohannes Weiner which aggregate pressure stalls for the grouped tasks only. 6442ce7135aSJohannes Weiner 645c3123552SMauro Carvalho Chehab For more details see Documentation/accounting/psi.rst. 646eb414681SJohannes Weiner 647eb414681SJohannes Weiner Say N if unsure. 648eb414681SJohannes Weiner 649e0c27447SJohannes Weinerconfig PSI_DEFAULT_DISABLED 650e0c27447SJohannes Weiner bool "Require boot parameter to enable pressure stall information tracking" 651e0c27447SJohannes Weiner default n 652e0c27447SJohannes Weiner depends on PSI 653e0c27447SJohannes Weiner help 654e0c27447SJohannes Weiner If set, pressure stall information tracking will be disabled 655428a1cb4SBaruch Siach per default but can be enabled through passing psi=1 on the 656428a1cb4SBaruch Siach kernel commandline during boot. 657e0c27447SJohannes Weiner 6587b2489d3SJohannes Weiner This feature adds some code to the task wakeup and sleep 6597b2489d3SJohannes Weiner paths of the scheduler. The overhead is too low to affect 6607b2489d3SJohannes Weiner common scheduling-intense workloads in practice (such as 6617b2489d3SJohannes Weiner webservers, memcache), but it does show up in artificial 6627b2489d3SJohannes Weiner scheduler stress tests, such as hackbench. 6637b2489d3SJohannes Weiner 6647b2489d3SJohannes Weiner If you are paranoid and not sure what the kernel will be 6657b2489d3SJohannes Weiner used for, say Y. 6667b2489d3SJohannes Weiner 6677b2489d3SJohannes Weiner Say N if unsure. 6687b2489d3SJohannes Weiner 669391dc69cSFrederic Weisbeckerendmenu # "CPU/Task time and stats accounting" 670391dc69cSFrederic Weisbecker 6715c4991e2SFrederic Weisbeckerconfig CPU_ISOLATION 6725c4991e2SFrederic Weisbecker bool "CPU isolation" 673414a2dc1SGeert Uytterhoeven depends on SMP || COMPILE_TEST 6742c43838cSFrederic Weisbecker default y 6755c4991e2SFrederic Weisbecker help 6765c4991e2SFrederic Weisbecker Make sure that CPUs running critical tasks are not disturbed by 6775c4991e2SFrederic Weisbecker any source of "noise" such as unbound workqueues, timers, kthreads... 6782c43838cSFrederic Weisbecker Unbound jobs get offloaded to housekeeping CPUs. This is driven by 6792c43838cSFrederic Weisbecker the "isolcpus=" boot parameter. 6802c43838cSFrederic Weisbecker 6812c43838cSFrederic Weisbecker Say Y if unsure. 6825c4991e2SFrederic Weisbecker 6830af92d46SPaul E. McKenneysource "kernel/rcu/Kconfig" 684c903ff83SMike Travis 685de5b56baSVivek Goyalconfig BUILD_BIN2C 686de5b56baSVivek Goyal bool 687de5b56baSVivek Goyal default n 688de5b56baSVivek Goyal 6891da177e4SLinus Torvaldsconfig IKCONFIG 690f2443ab6SRoss Biro tristate "Kernel .config support" 691a7f7f624SMasahiro Yamada help 6921da177e4SLinus Torvalds This option enables the complete Linux kernel ".config" file 6931da177e4SLinus Torvalds contents to be saved in the kernel. It provides documentation 6941da177e4SLinus Torvalds of which kernel options are used in a running kernel or in an 6951da177e4SLinus Torvalds on-disk kernel. This information can be extracted from the kernel 6961da177e4SLinus Torvalds image file with the script scripts/extract-ikconfig and used as 6971da177e4SLinus Torvalds input to rebuild the current kernel or to build another kernel. 6981da177e4SLinus Torvalds It can also be extracted from a running kernel by reading 6991da177e4SLinus Torvalds /proc/config.gz if enabled (below). 7001da177e4SLinus Torvalds 7011da177e4SLinus Torvaldsconfig IKCONFIG_PROC 7021da177e4SLinus Torvalds bool "Enable access to .config through /proc/config.gz" 7031da177e4SLinus Torvalds depends on IKCONFIG && PROC_FS 704a7f7f624SMasahiro Yamada help 7051da177e4SLinus Torvalds This option enables access to the kernel configuration file 7061da177e4SLinus Torvalds through /proc/config.gz. 7071da177e4SLinus Torvalds 708f7b101d3SJoel Fernandes (Google)config IKHEADERS 709f7b101d3SJoel Fernandes (Google) tristate "Enable kernel headers through /sys/kernel/kheaders.tar.xz" 710f7b101d3SJoel Fernandes (Google) depends on SYSFS 71143d8ce9dSJoel Fernandes (Google) help 712f7b101d3SJoel Fernandes (Google) This option enables access to the in-kernel headers that are generated during 713f7b101d3SJoel Fernandes (Google) the build process. These can be used to build eBPF tracing programs, 714f7b101d3SJoel Fernandes (Google) or similar programs. If you build the headers as a module, a module called 715f7b101d3SJoel Fernandes (Google) kheaders.ko is built which can be loaded on-demand to get access to headers. 71643d8ce9dSJoel Fernandes (Google) 717794543a2SAlistair John Strachanconfig LOG_BUF_SHIFT 718794543a2SAlistair John Strachan int "Kernel log buffer size (16 => 64KB, 17 => 128KB)" 7191c4b5ecbSChristoph Hellwig range 12 25 720f17a32e9SAdrian Bunk default 17 721361e9dfbSJosh Triplett depends on PRINTK 722794543a2SAlistair John Strachan help 72323b2899fSLuis R. Rodriguez Select the minimal kernel log buffer size as a power of 2. 72423b2899fSLuis R. Rodriguez The final size is affected by LOG_CPU_MAX_BUF_SHIFT config 72523b2899fSLuis R. Rodriguez parameter, see below. Any higher size also might be forced 72623b2899fSLuis R. Rodriguez by "log_buf_len" boot parameter. 72723b2899fSLuis R. Rodriguez 728f17a32e9SAdrian Bunk Examples: 729f17a32e9SAdrian Bunk 17 => 128 KB 730f17a32e9SAdrian Bunk 16 => 64 KB 731f17a32e9SAdrian Bunk 15 => 32 KB 732f17a32e9SAdrian Bunk 14 => 16 KB 733794543a2SAlistair John Strachan 13 => 8 KB 734794543a2SAlistair John Strachan 12 => 4 KB 735794543a2SAlistair John Strachan 73623b2899fSLuis R. Rodriguezconfig LOG_CPU_MAX_BUF_SHIFT 73723b2899fSLuis R. Rodriguez int "CPU kernel log buffer size contribution (13 => 8 KB, 17 => 128KB)" 7382240a31dSGeert Uytterhoeven depends on SMP 73923b2899fSLuis R. Rodriguez range 0 21 74023b2899fSLuis R. Rodriguez default 12 if !BASE_SMALL 74123b2899fSLuis R. Rodriguez default 0 if BASE_SMALL 742361e9dfbSJosh Triplett depends on PRINTK 74323b2899fSLuis R. Rodriguez help 74423b2899fSLuis R. Rodriguez This option allows to increase the default ring buffer size 74523b2899fSLuis R. Rodriguez according to the number of CPUs. The value defines the contribution 74623b2899fSLuis R. Rodriguez of each CPU as a power of 2. The used space is typically only few 74723b2899fSLuis R. Rodriguez lines however it might be much more when problems are reported, 74823b2899fSLuis R. Rodriguez e.g. backtraces. 74923b2899fSLuis R. Rodriguez 75023b2899fSLuis R. Rodriguez The increased size means that a new buffer has to be allocated and 75123b2899fSLuis R. Rodriguez the original static one is unused. It makes sense only on systems 75223b2899fSLuis R. Rodriguez with more CPUs. Therefore this value is used only when the sum of 75323b2899fSLuis R. Rodriguez contributions is greater than the half of the default kernel ring 75423b2899fSLuis R. Rodriguez buffer as defined by LOG_BUF_SHIFT. The default values are set 7550f7636e1SPaul Menzel so that more than 16 CPUs are needed to trigger the allocation. 75623b2899fSLuis R. Rodriguez 75723b2899fSLuis R. Rodriguez Also this option is ignored when "log_buf_len" kernel parameter is 75823b2899fSLuis R. Rodriguez used as it forces an exact (power of two) size of the ring buffer. 75923b2899fSLuis R. Rodriguez 76023b2899fSLuis R. Rodriguez The number of possible CPUs is used for this computation ignoring 7615e0d8d59SGeert Uytterhoeven hotplugging making the computation optimal for the worst case 7625e0d8d59SGeert Uytterhoeven scenario while allowing a simple algorithm to be used from bootup. 76323b2899fSLuis R. Rodriguez 76423b2899fSLuis R. Rodriguez Examples shift values and their meaning: 76523b2899fSLuis R. Rodriguez 17 => 128 KB for each CPU 76623b2899fSLuis R. Rodriguez 16 => 64 KB for each CPU 76723b2899fSLuis R. Rodriguez 15 => 32 KB for each CPU 76823b2899fSLuis R. Rodriguez 14 => 16 KB for each CPU 76923b2899fSLuis R. Rodriguez 13 => 8 KB for each CPU 77023b2899fSLuis R. Rodriguez 12 => 4 KB for each CPU 77123b2899fSLuis R. Rodriguez 772f92bac3bSSergey Senozhatskyconfig PRINTK_SAFE_LOG_BUF_SHIFT 773f92bac3bSSergey Senozhatsky int "Temporary per-CPU printk log buffer size (12 => 4KB, 13 => 8KB)" 774427934b8SPetr Mladek range 10 21 775427934b8SPetr Mladek default 13 776f92bac3bSSergey Senozhatsky depends on PRINTK 777427934b8SPetr Mladek help 778f92bac3bSSergey Senozhatsky Select the size of an alternate printk per-CPU buffer where messages 77919fa92fbSLizzy Fleckenstein printed from unsafe contexts are temporary stored. One example would 780f92bac3bSSergey Senozhatsky be NMI messages, another one - printk recursion. The messages are 781f92bac3bSSergey Senozhatsky copied to the main log buffer in a safe context to avoid a deadlock. 782f92bac3bSSergey Senozhatsky The value defines the size as a power of 2. 783427934b8SPetr Mladek 784f92bac3bSSergey Senozhatsky Those messages are rare and limited. The largest one is when 785427934b8SPetr Mladek a backtrace is printed. It usually fits into 4KB. Select 786427934b8SPetr Mladek 8KB if you want to be on the safe side. 787427934b8SPetr Mladek 788427934b8SPetr Mladek Examples: 789427934b8SPetr Mladek 17 => 128 KB for each CPU 790427934b8SPetr Mladek 16 => 64 KB for each CPU 791427934b8SPetr Mladek 15 => 32 KB for each CPU 792427934b8SPetr Mladek 14 => 16 KB for each CPU 793427934b8SPetr Mladek 13 => 8 KB for each CPU 794427934b8SPetr Mladek 12 => 4 KB for each CPU 795427934b8SPetr Mladek 79633701557SChris Downconfig PRINTK_INDEX 79733701557SChris Down bool "Printk indexing debugfs interface" 79833701557SChris Down depends on PRINTK && DEBUG_FS 79933701557SChris Down help 80033701557SChris Down Add support for indexing of all printk formats known at compile time 80133701557SChris Down at <debugfs>/printk/index/<module>. 80233701557SChris Down 80333701557SChris Down This can be used as part of maintaining daemons which monitor 80433701557SChris Down /dev/kmsg, as it permits auditing the printk formats present in a 80533701557SChris Down kernel, allowing detection of cases where monitored printks are 80633701557SChris Down changed or no longer present. 80733701557SChris Down 80833701557SChris Down There is no additional runtime cost to printk with this enabled. 80933701557SChris Down 8105cdc38f9SKAMEZAWA Hiroyuki# 8115cdc38f9SKAMEZAWA Hiroyuki# Architectures with an unreliable sched_clock() should select this: 8125cdc38f9SKAMEZAWA Hiroyuki# 8135cdc38f9SKAMEZAWA Hiroyukiconfig HAVE_UNSTABLE_SCHED_CLOCK 8145cdc38f9SKAMEZAWA Hiroyuki bool 8155cdc38f9SKAMEZAWA Hiroyuki 81638ff87f7SStephen Boydconfig GENERIC_SCHED_CLOCK 81738ff87f7SStephen Boyd bool 81838ff87f7SStephen Boyd 81969842cbaSPatrick Bellasimenu "Scheduler features" 82069842cbaSPatrick Bellasi 82169842cbaSPatrick Bellasiconfig UCLAMP_TASK 82269842cbaSPatrick Bellasi bool "Enable utilization clamping for RT/FAIR tasks" 82369842cbaSPatrick Bellasi depends on CPU_FREQ_GOV_SCHEDUTIL 82469842cbaSPatrick Bellasi help 82569842cbaSPatrick Bellasi This feature enables the scheduler to track the clamped utilization 82669842cbaSPatrick Bellasi of each CPU based on RUNNABLE tasks scheduled on that CPU. 82769842cbaSPatrick Bellasi 82869842cbaSPatrick Bellasi With this option, the user can specify the min and max CPU 82969842cbaSPatrick Bellasi utilization allowed for RUNNABLE tasks. The max utilization defines 83069842cbaSPatrick Bellasi the maximum frequency a task should use while the min utilization 83169842cbaSPatrick Bellasi defines the minimum frequency it should use. 83269842cbaSPatrick Bellasi 83369842cbaSPatrick Bellasi Both min and max utilization clamp values are hints to the scheduler, 83469842cbaSPatrick Bellasi aiming at improving its frequency selection policy, but they do not 83569842cbaSPatrick Bellasi enforce or grant any specific bandwidth for tasks. 83669842cbaSPatrick Bellasi 83769842cbaSPatrick Bellasi If in doubt, say N. 83869842cbaSPatrick Bellasi 83969842cbaSPatrick Bellasiconfig UCLAMP_BUCKETS_COUNT 84069842cbaSPatrick Bellasi int "Number of supported utilization clamp buckets" 84169842cbaSPatrick Bellasi range 5 20 84269842cbaSPatrick Bellasi default 5 84369842cbaSPatrick Bellasi depends on UCLAMP_TASK 84469842cbaSPatrick Bellasi help 84569842cbaSPatrick Bellasi Defines the number of clamp buckets to use. The range of each bucket 84669842cbaSPatrick Bellasi will be SCHED_CAPACITY_SCALE/UCLAMP_BUCKETS_COUNT. The higher the 84769842cbaSPatrick Bellasi number of clamp buckets the finer their granularity and the higher 84869842cbaSPatrick Bellasi the precision of clamping aggregation and tracking at run-time. 84969842cbaSPatrick Bellasi 85069842cbaSPatrick Bellasi For example, with the minimum configuration value we will have 5 85169842cbaSPatrick Bellasi clamp buckets tracking 20% utilization each. A 25% boosted tasks will 85269842cbaSPatrick Bellasi be refcounted in the [20..39]% bucket and will set the bucket clamp 85369842cbaSPatrick Bellasi effective value to 25%. 85469842cbaSPatrick Bellasi If a second 30% boosted task should be co-scheduled on the same CPU, 85569842cbaSPatrick Bellasi that task will be refcounted in the same bucket of the first task and 85669842cbaSPatrick Bellasi it will boost the bucket clamp effective value to 30%. 85769842cbaSPatrick Bellasi The clamp effective value of a bucket is reset to its nominal value 85869842cbaSPatrick Bellasi (20% in the example above) when there are no more tasks refcounted in 85969842cbaSPatrick Bellasi that bucket. 86069842cbaSPatrick Bellasi 86169842cbaSPatrick Bellasi An additional boost/capping margin can be added to some tasks. In the 86269842cbaSPatrick Bellasi example above the 25% task will be boosted to 30% until it exits the 86369842cbaSPatrick Bellasi CPU. If that should be considered not acceptable on certain systems, 86469842cbaSPatrick Bellasi it's always possible to reduce the margin by increasing the number of 86569842cbaSPatrick Bellasi clamp buckets to trade off used memory for run-time tracking 86669842cbaSPatrick Bellasi precision. 86769842cbaSPatrick Bellasi 86869842cbaSPatrick Bellasi If in doubt, use the default value. 86969842cbaSPatrick Bellasi 87069842cbaSPatrick Bellasiendmenu 87169842cbaSPatrick Bellasi 872be3a7284SAndrea Arcangeli# 873be3a7284SAndrea Arcangeli# For architectures that want to enable the support for NUMA-affine scheduler 874be3a7284SAndrea Arcangeli# balancing logic: 875be3a7284SAndrea Arcangeli# 876be3a7284SAndrea Arcangeliconfig ARCH_SUPPORTS_NUMA_BALANCING 877be3a7284SAndrea Arcangeli bool 878be3a7284SAndrea Arcangeli 879be5e610cSPeter Zijlstra# 88072b252aeSMel Gorman# For architectures that prefer to flush all TLBs after a number of pages 88172b252aeSMel Gorman# are unmapped instead of sending one IPI per page to flush. The architecture 88272b252aeSMel Gorman# must provide guarantees on what happens if a clean TLB cache entry is 88372b252aeSMel Gorman# written after the unmap. Details are in mm/rmap.c near the check for 88472b252aeSMel Gorman# should_defer_flush. The architecture should also consider if the full flush 88572b252aeSMel Gorman# and the refill costs are offset by the savings of sending fewer IPIs. 88672b252aeSMel Gormanconfig ARCH_WANT_BATCHED_UNMAP_TLB_FLUSH 88772b252aeSMel Gorman bool 88872b252aeSMel Gorman 889c12d3362SArd Biesheuvelconfig CC_HAS_INT128 8903a7c7331SMasahiro Yamada def_bool !$(cc-option,$(m64-flag) -D__SIZEOF_INT128__=0) && 64BIT 891c12d3362SArd Biesheuvel 892dee2b702SGustavo A. R. Silvaconfig CC_IMPLICIT_FALLTHROUGH 893dee2b702SGustavo A. R. Silva string 894158ea2d2SGustavo A. R. Silva default "-Wimplicit-fallthrough=5" if CC_IS_GCC && $(cc-option,-Wimplicit-fallthrough=5) 895dee2b702SGustavo A. R. Silva default "-Wimplicit-fallthrough" if CC_IS_CLANG && $(cc-option,-Wunreachable-code-fallthrough) 896dee2b702SGustavo A. R. Silva 8975a41237aSLinus Torvalds# Currently, disable gcc-11,12 array-bounds globally. 898f0be87c4SLinus Torvalds# We may want to target only particular configurations some day. 8995a41237aSLinus Torvaldsconfig GCC11_NO_ARRAY_BOUNDS 9005a41237aSLinus Torvalds def_bool y 9015a41237aSLinus Torvalds 902f0be87c4SLinus Torvaldsconfig GCC12_NO_ARRAY_BOUNDS 903f0be87c4SLinus Torvalds def_bool y 904f0be87c4SLinus Torvalds 905f0be87c4SLinus Torvaldsconfig CC_NO_ARRAY_BOUNDS 906f0be87c4SLinus Torvalds bool 9075a41237aSLinus Torvalds default y if CC_IS_GCC && GCC_VERSION >= 110000 && GCC_VERSION < 120000 && GCC11_NO_ARRAY_BOUNDS 908f0be87c4SLinus Torvalds default y if CC_IS_GCC && GCC_VERSION >= 120000 && GCC_VERSION < 130000 && GCC12_NO_ARRAY_BOUNDS 909f0be87c4SLinus Torvalds 91072b252aeSMel Gorman# 911be5e610cSPeter Zijlstra# For architectures that know their GCC __int128 support is sound 912be5e610cSPeter Zijlstra# 913be5e610cSPeter Zijlstraconfig ARCH_SUPPORTS_INT128 914be5e610cSPeter Zijlstra bool 915be5e610cSPeter Zijlstra 916be3a7284SAndrea Arcangeli# For architectures that (ab)use NUMA to represent different memory regions 917be3a7284SAndrea Arcangeli# all cpu-local but of different latencies, such as SuperH. 918be3a7284SAndrea Arcangeli# 919be3a7284SAndrea Arcangeliconfig ARCH_WANT_NUMA_VARIABLE_LOCALITY 920be3a7284SAndrea Arcangeli bool 921be3a7284SAndrea Arcangeli 922be3a7284SAndrea Arcangeliconfig NUMA_BALANCING 923be3a7284SAndrea Arcangeli bool "Memory placement aware NUMA scheduler" 924be3a7284SAndrea Arcangeli depends on ARCH_SUPPORTS_NUMA_BALANCING 925be3a7284SAndrea Arcangeli depends on !ARCH_WANT_NUMA_VARIABLE_LOCALITY 926554b0f3cSSebastian Andrzej Siewior depends on SMP && NUMA && MIGRATION && !PREEMPT_RT 927be3a7284SAndrea Arcangeli help 928be3a7284SAndrea Arcangeli This option adds support for automatic NUMA aware memory/task placement. 929be3a7284SAndrea Arcangeli The mechanism is quite primitive and is based on migrating memory when 9306d56a410SPaul Gortmaker it has references to the node the task is running on. 931be3a7284SAndrea Arcangeli 932be3a7284SAndrea Arcangeli This system will be inactive on UMA systems. 933be3a7284SAndrea Arcangeli 9346f7c97e8SAneesh Kumar K.Vconfig NUMA_BALANCING_DEFAULT_ENABLED 9356f7c97e8SAneesh Kumar K.V bool "Automatically enable NUMA aware memory/task placement" 9366f7c97e8SAneesh Kumar K.V default y 9376f7c97e8SAneesh Kumar K.V depends on NUMA_BALANCING 9386f7c97e8SAneesh Kumar K.V help 9396f7c97e8SAneesh Kumar K.V If set, automatic NUMA balancing will be enabled if running on a NUMA 9406f7c97e8SAneesh Kumar K.V machine. 9416f7c97e8SAneesh Kumar K.V 94223964d2dSLi Zefanmenuconfig CGROUPS 9436341e62bSChristoph Jaeger bool "Control Group support" 9442bd59d48STejun Heo select KERNFS 945ddbcc7e8SPaul Menage help 94623964d2dSLi Zefan This option adds support for grouping sets of processes together, for 9475cdc38f9SKAMEZAWA Hiroyuki use with process control subsystems such as Cpusets, CFS, memory 9485cdc38f9SKAMEZAWA Hiroyuki controls or device isolation. 9495cdc38f9SKAMEZAWA Hiroyuki See 950d6a3b247SMauro Carvalho Chehab - Documentation/scheduler/sched-design-CFS.rst (CFS) 951da82c92fSMauro Carvalho Chehab - Documentation/admin-guide/cgroup-v1/ (features for grouping, isolation 95245ce80fbSLi Zefan and resource control) 953ddbcc7e8SPaul Menage 954ddbcc7e8SPaul Menage Say N if unsure. 955ddbcc7e8SPaul Menage 95623964d2dSLi Zefanif CGROUPS 95723964d2dSLi Zefan 9583e32cb2eSJohannes Weinerconfig PAGE_COUNTER 9593e32cb2eSJohannes Weiner bool 9603e32cb2eSJohannes Weiner 9616a010a49STejun Heoconfig CGROUP_FAVOR_DYNMODS 9626a010a49STejun Heo bool "Favor dynamic modification latency reduction by default" 9636a010a49STejun Heo help 9646a010a49STejun Heo This option enables the "favordynmods" mount option by default 9656a010a49STejun Heo which reduces the latencies of dynamic cgroup modifications such 9666a010a49STejun Heo as task migrations and controller on/offs at the cost of making 9676a010a49STejun Heo hot path operations such as forks and exits more expensive. 9686a010a49STejun Heo 9696a010a49STejun Heo Say N if unsure. 9706a010a49STejun Heo 971c255a458SAndrew Mortonconfig MEMCG 972a0166ec4SJohannes Weiner bool "Memory controller" 9733e32cb2eSJohannes Weiner select PAGE_COUNTER 97479bd9814STejun Heo select EVENTFD 97500f0b825SBalbir Singh help 976a0166ec4SJohannes Weiner Provides control over the memory footprint of tasks in a cgroup. 97700f0b825SBalbir Singh 97884c07d11SKirill Tkhaiconfig MEMCG_KMEM 97984c07d11SKirill Tkhai bool 98084c07d11SKirill Tkhai depends on MEMCG && !SLOB 98184c07d11SKirill Tkhai default y 98284c07d11SKirill Tkhai 9836bf024e6SJohannes Weinerconfig BLK_CGROUP 9846bf024e6SJohannes Weiner bool "IO controller" 9856bf024e6SJohannes Weiner depends on BLOCK 9862bc64a20SAneesh Kumar K.V default n 987a7f7f624SMasahiro Yamada help 9886bf024e6SJohannes Weiner Generic block IO controller cgroup interface. This is the common 9896bf024e6SJohannes Weiner cgroup interface which should be used by various IO controlling 9906bf024e6SJohannes Weiner policies. 9912bc64a20SAneesh Kumar K.V 9926bf024e6SJohannes Weiner Currently, CFQ IO scheduler uses it to recognize task groups and 9936bf024e6SJohannes Weiner control disk bandwidth allocation (proportional time slice allocation) 9946bf024e6SJohannes Weiner to such task groups. It is also used by bio throttling logic in 9956bf024e6SJohannes Weiner block layer to implement upper limit in IO rates on a device. 996e5d1367fSStephane Eranian 9976bf024e6SJohannes Weiner This option only enables generic Block IO controller infrastructure. 9986bf024e6SJohannes Weiner One needs to also enable actual IO controlling logic/policy. For 9996bf024e6SJohannes Weiner enabling proportional weight division of disk bandwidth in CFQ, set 10007baf2199SKrzysztof Kozlowski CONFIG_BFQ_GROUP_IOSCHED=y; for enabling throttling policy, set 10016bf024e6SJohannes Weiner CONFIG_BLK_DEV_THROTTLING=y. 10026bf024e6SJohannes Weiner 1003da82c92fSMauro Carvalho Chehab See Documentation/admin-guide/cgroup-v1/blkio-controller.rst for more information. 10046bf024e6SJohannes Weiner 10056bf024e6SJohannes Weinerconfig CGROUP_WRITEBACK 10066bf024e6SJohannes Weiner bool 10076bf024e6SJohannes Weiner depends on MEMCG && BLK_CGROUP 10086bf024e6SJohannes Weiner default y 1009e5d1367fSStephane Eranian 10107c941438SDhaval Gianimenuconfig CGROUP_SCHED 1011a0166ec4SJohannes Weiner bool "CPU controller" 10127c941438SDhaval Giani default n 10137c941438SDhaval Giani help 10147c941438SDhaval Giani This feature lets CPU scheduler recognize task groups and control CPU 10157c941438SDhaval Giani bandwidth allocation to such task groups. It uses cgroups to group 10167c941438SDhaval Giani tasks. 10177c941438SDhaval Giani 10187c941438SDhaval Gianiif CGROUP_SCHED 10197c941438SDhaval Gianiconfig FAIR_GROUP_SCHED 10207c941438SDhaval Giani bool "Group scheduling for SCHED_OTHER" 10217c941438SDhaval Giani depends on CGROUP_SCHED 10227c941438SDhaval Giani default CGROUP_SCHED 10237c941438SDhaval Giani 1024ab84d31eSPaul Turnerconfig CFS_BANDWIDTH 1025ab84d31eSPaul Turner bool "CPU bandwidth provisioning for FAIR_GROUP_SCHED" 1026ab84d31eSPaul Turner depends on FAIR_GROUP_SCHED 1027ab84d31eSPaul Turner default n 1028ab84d31eSPaul Turner help 1029ab84d31eSPaul Turner This option allows users to define CPU bandwidth rates (limits) for 1030ab84d31eSPaul Turner tasks running within the fair group scheduler. Groups with no limit 1031ab84d31eSPaul Turner set are considered to be unconstrained and will run with no 1032ab84d31eSPaul Turner restriction. 1033d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-bwc.rst for more information. 1034ab84d31eSPaul Turner 10357c941438SDhaval Gianiconfig RT_GROUP_SCHED 10367c941438SDhaval Giani bool "Group scheduling for SCHED_RR/FIFO" 10377c941438SDhaval Giani depends on CGROUP_SCHED 10387c941438SDhaval Giani default n 10397c941438SDhaval Giani help 10407c941438SDhaval Giani This feature lets you explicitly allocate real CPU bandwidth 104132bd7eb5SLi Zefan to task groups. If enabled, it will also make it impossible to 10427c941438SDhaval Giani schedule realtime tasks for non-root users until you allocate 10437c941438SDhaval Giani realtime bandwidth for them. 1044d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-rt-group.rst for more information. 10457c941438SDhaval Giani 10467c941438SDhaval Gianiendif #CGROUP_SCHED 10477c941438SDhaval Giani 10482480c093SPatrick Bellasiconfig UCLAMP_TASK_GROUP 10492480c093SPatrick Bellasi bool "Utilization clamping per group of tasks" 10502480c093SPatrick Bellasi depends on CGROUP_SCHED 10512480c093SPatrick Bellasi depends on UCLAMP_TASK 10522480c093SPatrick Bellasi default n 10532480c093SPatrick Bellasi help 10542480c093SPatrick Bellasi This feature enables the scheduler to track the clamped utilization 10552480c093SPatrick Bellasi of each CPU based on RUNNABLE tasks currently scheduled on that CPU. 10562480c093SPatrick Bellasi 10572480c093SPatrick Bellasi When this option is enabled, the user can specify a min and max 10582480c093SPatrick Bellasi CPU bandwidth which is allowed for each single task in a group. 10592480c093SPatrick Bellasi The max bandwidth allows to clamp the maximum frequency a task 10602480c093SPatrick Bellasi can use, while the min bandwidth allows to define a minimum 10612480c093SPatrick Bellasi frequency a task will always use. 10622480c093SPatrick Bellasi 10632480c093SPatrick Bellasi When task group based utilization clamping is enabled, an eventually 10642480c093SPatrick Bellasi specified task-specific clamp value is constrained by the cgroup 10652480c093SPatrick Bellasi specified clamp value. Both minimum and maximum task clamping cannot 10662480c093SPatrick Bellasi be bigger than the corresponding clamping defined at task group level. 10672480c093SPatrick Bellasi 10682480c093SPatrick Bellasi If in doubt, say N. 10692480c093SPatrick Bellasi 10706bf024e6SJohannes Weinerconfig CGROUP_PIDS 10716bf024e6SJohannes Weiner bool "PIDs controller" 10726bf024e6SJohannes Weiner help 10736bf024e6SJohannes Weiner Provides enforcement of process number limits in the scope of a 10746bf024e6SJohannes Weiner cgroup. Any attempt to fork more processes than is allowed in the 10756bf024e6SJohannes Weiner cgroup will fail. PIDs are fundamentally a global resource because it 10766bf024e6SJohannes Weiner is fairly trivial to reach PID exhaustion before you reach even a 10776bf024e6SJohannes Weiner conservative kmemcg limit. As a result, it is possible to grind a 10786bf024e6SJohannes Weiner system to halt without being limited by other cgroup policies. The 10796cc578dfSParav Pandit PIDs controller is designed to stop this from happening. 10806bf024e6SJohannes Weiner 10816bf024e6SJohannes Weiner It should be noted that organisational operations (such as attaching 108298076833SJonathan Neuschäfer to a cgroup hierarchy) will *not* be blocked by the PIDs controller, 10836bf024e6SJohannes Weiner since the PIDs limit only affects a process's ability to fork, not to 10846bf024e6SJohannes Weiner attach to a cgroup. 10856bf024e6SJohannes Weiner 108639d3e758SParav Panditconfig CGROUP_RDMA 108739d3e758SParav Pandit bool "RDMA controller" 108839d3e758SParav Pandit help 108939d3e758SParav Pandit Provides enforcement of RDMA resources defined by IB stack. 109039d3e758SParav Pandit It is fairly easy for consumers to exhaust RDMA resources, which 109139d3e758SParav Pandit can result into resource unavailability to other consumers. 109239d3e758SParav Pandit RDMA controller is designed to stop this from happening. 109339d3e758SParav Pandit Attaching processes with active RDMA resources to the cgroup 109439d3e758SParav Pandit hierarchy is allowed even if can cross the hierarchy's limit. 109539d3e758SParav Pandit 10966bf024e6SJohannes Weinerconfig CGROUP_FREEZER 10976bf024e6SJohannes Weiner bool "Freezer controller" 10986bf024e6SJohannes Weiner help 10996bf024e6SJohannes Weiner Provides a way to freeze and unfreeze all tasks in a 11006bf024e6SJohannes Weiner cgroup. 11016bf024e6SJohannes Weiner 1102489c2a20SJohannes Weiner This option affects the ORIGINAL cgroup interface. The cgroup2 memory 1103489c2a20SJohannes Weiner controller includes important in-kernel memory consumers per default. 1104489c2a20SJohannes Weiner 1105489c2a20SJohannes Weiner If you're using cgroup2, say N. 1106489c2a20SJohannes Weiner 11076bf024e6SJohannes Weinerconfig CGROUP_HUGETLB 11086bf024e6SJohannes Weiner bool "HugeTLB controller" 11096bf024e6SJohannes Weiner depends on HUGETLB_PAGE 11106bf024e6SJohannes Weiner select PAGE_COUNTER 1111afc24d49SVivek Goyal default n 11126bf024e6SJohannes Weiner help 11136bf024e6SJohannes Weiner Provides a cgroup controller for HugeTLB pages. 11146bf024e6SJohannes Weiner When you enable this, you can put a per cgroup limit on HugeTLB usage. 11156bf024e6SJohannes Weiner The limit is enforced during page fault. Since HugeTLB doesn't 11166bf024e6SJohannes Weiner support page reclaim, enforcing the limit at page fault time implies 11176bf024e6SJohannes Weiner that, the application will get SIGBUS signal if it tries to access 11186bf024e6SJohannes Weiner HugeTLB pages beyond its limit. This requires the application to know 11196bf024e6SJohannes Weiner beforehand how much HugeTLB pages it would require for its use. The 11206bf024e6SJohannes Weiner control group is tracked in the third page lru pointer. This means 11216bf024e6SJohannes Weiner that we cannot use the controller with huge page less than 3 pages. 1122afc24d49SVivek Goyal 11236bf024e6SJohannes Weinerconfig CPUSETS 11246bf024e6SJohannes Weiner bool "Cpuset controller" 1125e1d4eeecSNicolas Pitre depends on SMP 11266bf024e6SJohannes Weiner help 11276bf024e6SJohannes Weiner This option will let you create and manage CPUSETs which 11286bf024e6SJohannes Weiner allow dynamically partitioning a system into sets of CPUs and 11296bf024e6SJohannes Weiner Memory Nodes and assigning tasks to run only within those sets. 11306bf024e6SJohannes Weiner This is primarily useful on large SMP or NUMA systems. 1131afc24d49SVivek Goyal 11326bf024e6SJohannes Weiner Say N if unsure. 1133afc24d49SVivek Goyal 11346bf024e6SJohannes Weinerconfig PROC_PID_CPUSET 11356bf024e6SJohannes Weiner bool "Include legacy /proc/<pid>/cpuset file" 11366bf024e6SJohannes Weiner depends on CPUSETS 113789e9b9e0STejun Heo default y 113889e9b9e0STejun Heo 11396bf024e6SJohannes Weinerconfig CGROUP_DEVICE 11406bf024e6SJohannes Weiner bool "Device controller" 11416bf024e6SJohannes Weiner help 11426bf024e6SJohannes Weiner Provides a cgroup controller implementing whitelists for 11436bf024e6SJohannes Weiner devices which a process in the cgroup can mknod or open. 11446bf024e6SJohannes Weiner 11456bf024e6SJohannes Weinerconfig CGROUP_CPUACCT 11466bf024e6SJohannes Weiner bool "Simple CPU accounting controller" 11476bf024e6SJohannes Weiner help 11486bf024e6SJohannes Weiner Provides a simple controller for monitoring the 11496bf024e6SJohannes Weiner total CPU consumed by the tasks in a cgroup. 11506bf024e6SJohannes Weiner 11516bf024e6SJohannes Weinerconfig CGROUP_PERF 11526bf024e6SJohannes Weiner bool "Perf controller" 11536bf024e6SJohannes Weiner depends on PERF_EVENTS 11546bf024e6SJohannes Weiner help 11556bf024e6SJohannes Weiner This option extends the perf per-cpu mode to restrict monitoring 11566bf024e6SJohannes Weiner to threads which belong to the cgroup specified and run on the 11576546b19fSNamhyung Kim designated cpu. Or this can be used to have cgroup ID in samples 11586546b19fSNamhyung Kim so that it can monitor performance events among cgroups. 11596bf024e6SJohannes Weiner 11606bf024e6SJohannes Weiner Say N if unsure. 11616bf024e6SJohannes Weiner 116230070984SDaniel Mackconfig CGROUP_BPF 116330070984SDaniel Mack bool "Support for eBPF programs attached to cgroups" 1164483c4933SAndy Lutomirski depends on BPF_SYSCALL 1165483c4933SAndy Lutomirski select SOCK_CGROUP_DATA 116630070984SDaniel Mack help 116730070984SDaniel Mack Allow attaching eBPF programs to a cgroup using the bpf(2) 116830070984SDaniel Mack syscall command BPF_PROG_ATTACH. 116930070984SDaniel Mack 117030070984SDaniel Mack In which context these programs are accessed depends on the type 117130070984SDaniel Mack of attachment. For instance, programs that are attached using 117230070984SDaniel Mack BPF_CGROUP_INET_INGRESS will be executed on the ingress path of 117330070984SDaniel Mack inet sockets. 117430070984SDaniel Mack 1175a72232eaSVipin Sharmaconfig CGROUP_MISC 1176a72232eaSVipin Sharma bool "Misc resource controller" 1177a72232eaSVipin Sharma default n 1178a72232eaSVipin Sharma help 1179a72232eaSVipin Sharma Provides a controller for miscellaneous resources on a host. 1180a72232eaSVipin Sharma 1181a72232eaSVipin Sharma Miscellaneous scalar resources are the resources on the host system 1182a72232eaSVipin Sharma which cannot be abstracted like the other cgroups. This controller 1183a72232eaSVipin Sharma tracks and limits the miscellaneous resources used by a process 1184a72232eaSVipin Sharma attached to a cgroup hierarchy. 1185a72232eaSVipin Sharma 1186a72232eaSVipin Sharma For more information, please check misc cgroup section in 1187a72232eaSVipin Sharma /Documentation/admin-guide/cgroup-v2.rst. 1188a72232eaSVipin Sharma 11896bf024e6SJohannes Weinerconfig CGROUP_DEBUG 119023b0be48SWaiman Long bool "Debug controller" 11916bf024e6SJohannes Weiner default n 119223b0be48SWaiman Long depends on DEBUG_KERNEL 11936bf024e6SJohannes Weiner help 11946bf024e6SJohannes Weiner This option enables a simple controller that exports 119523b0be48SWaiman Long debugging information about the cgroups framework. This 119623b0be48SWaiman Long controller is for control cgroup debugging only. Its 119723b0be48SWaiman Long interfaces are not stable. 11986bf024e6SJohannes Weiner 11996bf024e6SJohannes Weiner Say N. 12006bf024e6SJohannes Weiner 120173b35147SArnd Bergmannconfig SOCK_CGROUP_DATA 120273b35147SArnd Bergmann bool 120373b35147SArnd Bergmann default n 120473b35147SArnd Bergmann 120523964d2dSLi Zefanendif # CGROUPS 1206c077719bSKAMEZAWA Hiroyuki 12078dd2a82cSDaniel Lezcanomenuconfig NAMESPACES 12086a108a14SDavid Rientjes bool "Namespaces support" if EXPERT 12092813893fSIulia Manda depends on MULTIUSER 12106a108a14SDavid Rientjes default !EXPERT 1211c5289a69SPavel Emelyanov help 1212c5289a69SPavel Emelyanov Provides the way to make tasks work with different objects using 1213c5289a69SPavel Emelyanov the same id. For example same IPC id may refer to different objects 1214c5289a69SPavel Emelyanov or same user id or pid may refer to different tasks when used in 1215c5289a69SPavel Emelyanov different namespaces. 1216c5289a69SPavel Emelyanov 12178dd2a82cSDaniel Lezcanoif NAMESPACES 12188dd2a82cSDaniel Lezcano 121958bfdd6dSPavel Emelyanovconfig UTS_NS 122058bfdd6dSPavel Emelyanov bool "UTS namespace" 122117a6d441SDaniel Lezcano default y 122258bfdd6dSPavel Emelyanov help 122358bfdd6dSPavel Emelyanov In this namespace tasks see different info provided with the 122458bfdd6dSPavel Emelyanov uname() system call 122558bfdd6dSPavel Emelyanov 1226769071acSAndrei Vaginconfig TIME_NS 1227769071acSAndrei Vagin bool "TIME namespace" 1228660fd04fSThomas Gleixner depends on GENERIC_VDSO_TIME_NS 1229769071acSAndrei Vagin default y 1230769071acSAndrei Vagin help 1231769071acSAndrei Vagin In this namespace boottime and monotonic clocks can be set. 1232769071acSAndrei Vagin The time will keep going with the same pace. 1233769071acSAndrei Vagin 1234ae5e1b22SPavel Emelyanovconfig IPC_NS 1235ae5e1b22SPavel Emelyanov bool "IPC namespace" 12368dd2a82cSDaniel Lezcano depends on (SYSVIPC || POSIX_MQUEUE) 123717a6d441SDaniel Lezcano default y 1238ae5e1b22SPavel Emelyanov help 1239ae5e1b22SPavel Emelyanov In this namespace tasks work with IPC ids which correspond to 1240614b84cfSSerge E. Hallyn different IPC objects in different namespaces. 1241ae5e1b22SPavel Emelyanov 1242aee16ce7SPavel Emelyanovconfig USER_NS 124319c92399SKees Cook bool "User namespace" 12445673a94cSEric W. Biederman default n 1245aee16ce7SPavel Emelyanov help 1246aee16ce7SPavel Emelyanov This allows containers, i.e. vservers, to use user namespaces 1247aee16ce7SPavel Emelyanov to provide different user info for different servers. 1248e11f0ae3SEric W. Biederman 1249e11f0ae3SEric W. Biederman When user namespaces are enabled in the kernel it is 1250d886f4e4SJohannes Weiner recommended that the MEMCG option also be enabled and that 1251d886f4e4SJohannes Weiner user-space use the memory control groups to limit the amount 1252d886f4e4SJohannes Weiner of memory a memory unprivileged users can use. 1253e11f0ae3SEric W. Biederman 1254aee16ce7SPavel Emelyanov If unsure, say N. 1255aee16ce7SPavel Emelyanov 125674bd59bbSPavel Emelyanovconfig PID_NS 12579bd38c2cSDaniel Lezcano bool "PID Namespaces" 125817a6d441SDaniel Lezcano default y 125974bd59bbSPavel Emelyanov help 126012d2b8f9SHeikki Orsila Support process id namespaces. This allows having multiple 1261692105b8SMatt LaPlante processes with the same pid as long as they are in different 126274bd59bbSPavel Emelyanov pid namespaces. This is a building block of containers. 126374bd59bbSPavel Emelyanov 1264d6eb633fSMatt Helsleyconfig NET_NS 1265d6eb633fSMatt Helsley bool "Network namespace" 12668dd2a82cSDaniel Lezcano depends on NET 126717a6d441SDaniel Lezcano default y 1268d6eb633fSMatt Helsley help 1269d6eb633fSMatt Helsley Allow user space to create what appear to be multiple instances 1270d6eb633fSMatt Helsley of the network stack. 1271d6eb633fSMatt Helsley 12728dd2a82cSDaniel Lezcanoendif # NAMESPACES 12738dd2a82cSDaniel Lezcano 12745cb366bbSAdrian Reberconfig CHECKPOINT_RESTORE 12755cb366bbSAdrian Reber bool "Checkpoint/restore support" 127630341ec9SRen Zhijie depends on PROC_FS 12775cb366bbSAdrian Reber select PROC_CHILDREN 1278bfe3911aSChris Wilson select KCMP 12795cb366bbSAdrian Reber default n 12805cb366bbSAdrian Reber help 12815cb366bbSAdrian Reber Enables additional kernel features in a sake of checkpoint/restore. 12825cb366bbSAdrian Reber In particular it adds auxiliary prctl codes to setup process text, 12835cb366bbSAdrian Reber data and heap segment sizes, and a few additional /proc filesystem 12845cb366bbSAdrian Reber entries. 12855cb366bbSAdrian Reber 12865cb366bbSAdrian Reber If unsure, say N here. 12875cb366bbSAdrian Reber 12885091faa4SMike Galbraithconfig SCHED_AUTOGROUP 12895091faa4SMike Galbraith bool "Automatic process group scheduling" 12905091faa4SMike Galbraith select CGROUPS 12915091faa4SMike Galbraith select CGROUP_SCHED 12925091faa4SMike Galbraith select FAIR_GROUP_SCHED 12935091faa4SMike Galbraith help 12945091faa4SMike Galbraith This option optimizes the scheduler for common desktop workloads by 12955091faa4SMike Galbraith automatically creating and populating task groups. This separation 12965091faa4SMike Galbraith of workloads isolates aggressive CPU burners (like build jobs) from 12975091faa4SMike Galbraith desktop applications. Task group autogeneration is currently based 12985091faa4SMike Galbraith upon task session. 12995091faa4SMike Galbraith 13007af37becSDaniel Lezcanoconfig SYSFS_DEPRECATED 13015d6a4ea5SFerenc Wagner bool "Enable deprecated sysfs features to support old userspace tools" 13027af37becSDaniel Lezcano depends on SYSFS 13037af37becSDaniel Lezcano default n 13047af37becSDaniel Lezcano help 13057af37becSDaniel Lezcano This option adds code that switches the layout of the "block" class 13067af37becSDaniel Lezcano devices, to not show up in /sys/class/block/, but only in 13077af37becSDaniel Lezcano /sys/block/. 13087af37becSDaniel Lezcano 13097af37becSDaniel Lezcano This switch is only active when the sysfs.deprecated=1 boot option is 13107af37becSDaniel Lezcano passed or the SYSFS_DEPRECATED_V2 option is set. 13117af37becSDaniel Lezcano 13127af37becSDaniel Lezcano This option allows new kernels to run on old distributions and tools, 13137af37becSDaniel Lezcano which might get confused by /sys/class/block/. Since 2007/2008 all 13147af37becSDaniel Lezcano major distributions and tools handle this just fine. 13157af37becSDaniel Lezcano 13167af37becSDaniel Lezcano Recent distributions and userspace tools after 2009/2010 depend on 13177af37becSDaniel Lezcano the existence of /sys/class/block/, and will not work with this 13187af37becSDaniel Lezcano option enabled. 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. 13227af37becSDaniel Lezcano 13237af37becSDaniel Lezcanoconfig SYSFS_DEPRECATED_V2 13245d6a4ea5SFerenc Wagner bool "Enable deprecated sysfs features by default" 13257af37becSDaniel Lezcano default n 13267af37becSDaniel Lezcano depends on SYSFS 13277af37becSDaniel Lezcano depends on SYSFS_DEPRECATED 13287af37becSDaniel Lezcano help 13297af37becSDaniel Lezcano Enable deprecated sysfs by default. 13307af37becSDaniel Lezcano 13317af37becSDaniel Lezcano See the CONFIG_SYSFS_DEPRECATED option for more details about this 13327af37becSDaniel Lezcano option. 13337af37becSDaniel Lezcano 13347af37becSDaniel Lezcano Only if you are using a new kernel on an old distribution, you might 13357af37becSDaniel Lezcano need to say Y here. Even then, odds are you would not need it 13367af37becSDaniel Lezcano enabled, you can always pass the boot option if absolutely necessary. 13377af37becSDaniel Lezcano 13387af37becSDaniel Lezcanoconfig RELAY 13397af37becSDaniel Lezcano bool "Kernel->user space relay support (formerly relayfs)" 134026b5679eSPeter Zijlstra select IRQ_WORK 13417af37becSDaniel Lezcano help 13427af37becSDaniel Lezcano This option enables support for relay interface support in 13437af37becSDaniel Lezcano certain file systems (such as debugfs). 13447af37becSDaniel Lezcano It is designed to provide an efficient mechanism for tools and 13457af37becSDaniel Lezcano facilities to relay large amounts of data from kernel space to 13467af37becSDaniel Lezcano user space. 13477af37becSDaniel Lezcano 13487af37becSDaniel Lezcano If unsure, say N. 13497af37becSDaniel Lezcano 1350f991633dSDimitri Gorokhovikconfig BLK_DEV_INITRD 1351f991633dSDimitri Gorokhovik bool "Initial RAM filesystem and RAM disk (initramfs/initrd) support" 1352f991633dSDimitri Gorokhovik help 1353f991633dSDimitri Gorokhovik The initial RAM filesystem is a ramfs which is loaded by the 1354f991633dSDimitri Gorokhovik boot loader (loadlin or lilo) and that is mounted as root 1355f991633dSDimitri Gorokhovik before the normal boot procedure. It is typically used to 1356f991633dSDimitri Gorokhovik load modules needed to mount the "real" root file system, 13578c27ceffSMauro Carvalho Chehab etc. See <file:Documentation/admin-guide/initrd.rst> for details. 1358f991633dSDimitri Gorokhovik 1359f991633dSDimitri Gorokhovik If RAM disk support (BLK_DEV_RAM) is also included, this 1360f991633dSDimitri Gorokhovik also enables initial RAM disk (initrd) support and adds 1361f991633dSDimitri Gorokhovik 15 Kbytes (more on some other architectures) to the kernel size. 1362f991633dSDimitri Gorokhovik 1363f991633dSDimitri Gorokhovik If unsure say Y. 1364f991633dSDimitri Gorokhovik 1365c33df4eaSJean-Paul Samanif BLK_DEV_INITRD 1366c33df4eaSJean-Paul Saman 1367dbec4866SSam Ravnborgsource "usr/Kconfig" 1368dbec4866SSam Ravnborg 1369c33df4eaSJean-Paul Samanendif 1370c33df4eaSJean-Paul Saman 137176db5a27SMasami Hiramatsuconfig BOOT_CONFIG 137276db5a27SMasami Hiramatsu bool "Boot config support" 1373a2a9d67aSMasami Hiramatsu select BLK_DEV_INITRD if !BOOT_CONFIG_EMBED 137476db5a27SMasami Hiramatsu help 137576db5a27SMasami Hiramatsu Extra boot config allows system admin to pass a config file as 137676db5a27SMasami Hiramatsu complemental extension of kernel cmdline when booting. 13770947db01SMasami Hiramatsu The boot config file must be attached at the end of initramfs 137885c46b78SMasami Hiramatsu with checksum, size and magic word. 13790947db01SMasami Hiramatsu See <file:Documentation/admin-guide/bootconfig.rst> for details. 138076db5a27SMasami Hiramatsu 138176db5a27SMasami Hiramatsu If unsure, say Y. 138276db5a27SMasami Hiramatsu 1383b743852cSPaul E. McKenneyconfig BOOT_CONFIG_FORCE 1384b743852cSPaul E. McKenney bool "Force unconditional bootconfig processing" 1385b743852cSPaul E. McKenney depends on BOOT_CONFIG 1386*6ded8a28SPaul E. McKenney default y if BOOT_CONFIG_EMBED 1387b743852cSPaul E. McKenney help 1388b743852cSPaul E. McKenney With this Kconfig option set, BOOT_CONFIG processing is carried 1389b743852cSPaul E. McKenney out even when the "bootconfig" kernel-boot parameter is omitted. 1390b743852cSPaul E. McKenney In fact, with this Kconfig option set, there is no way to 1391b743852cSPaul E. McKenney make the kernel ignore the BOOT_CONFIG-supplied kernel-boot 1392b743852cSPaul E. McKenney parameters. 1393b743852cSPaul E. McKenney 1394b743852cSPaul E. McKenney If unsure, say N. 1395b743852cSPaul E. McKenney 1396a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED 1397a2a9d67aSMasami Hiramatsu bool "Embed bootconfig file in the kernel" 1398a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG 1399a2a9d67aSMasami Hiramatsu help 1400a2a9d67aSMasami Hiramatsu Embed a bootconfig file given by BOOT_CONFIG_EMBED_FILE in the 1401a2a9d67aSMasami Hiramatsu kernel. Usually, the bootconfig file is loaded with the initrd 1402a2a9d67aSMasami Hiramatsu image. But if the system doesn't support initrd, this option will 1403a2a9d67aSMasami Hiramatsu help you by embedding a bootconfig file while building the kernel. 1404a2a9d67aSMasami Hiramatsu 1405a2a9d67aSMasami Hiramatsu If unsure, say N. 1406a2a9d67aSMasami Hiramatsu 1407a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED_FILE 1408a2a9d67aSMasami Hiramatsu string "Embedded bootconfig file path" 1409a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG_EMBED 1410a2a9d67aSMasami Hiramatsu help 1411a2a9d67aSMasami Hiramatsu Specify a bootconfig file which will be embedded to the kernel. 1412a2a9d67aSMasami Hiramatsu This bootconfig will be used if there is no initrd or no other 1413a2a9d67aSMasami Hiramatsu bootconfig in the initrd. 1414a2a9d67aSMasami Hiramatsu 14151274aea1SDavid Disseldorpconfig INITRAMFS_PRESERVE_MTIME 14161274aea1SDavid Disseldorp bool "Preserve cpio archive mtimes in initramfs" 14171274aea1SDavid Disseldorp default y 14181274aea1SDavid Disseldorp help 14191274aea1SDavid Disseldorp Each entry in an initramfs cpio archive carries an mtime value. When 14201274aea1SDavid Disseldorp enabled, extracted cpio items take this mtime, with directory mtime 14211274aea1SDavid Disseldorp setting deferred until after creation of any child entries. 14221274aea1SDavid Disseldorp 14231274aea1SDavid Disseldorp If unsure, say Y. 14241274aea1SDavid Disseldorp 1425877417e6SArnd Bergmannchoice 1426877417e6SArnd Bergmann prompt "Compiler optimization level" 14272cc3ce24SUlf Magnusson default CC_OPTIMIZE_FOR_PERFORMANCE 1428877417e6SArnd Bergmann 1429877417e6SArnd Bergmannconfig CC_OPTIMIZE_FOR_PERFORMANCE 143015f5db60SMasahiro Yamada bool "Optimize for performance (-O2)" 1431877417e6SArnd Bergmann help 1432877417e6SArnd Bergmann This is the default optimization level for the kernel, building 1433877417e6SArnd Bergmann with the "-O2" compiler flag for best performance and most 1434877417e6SArnd Bergmann helpful compile-time warnings. 1435877417e6SArnd Bergmann 1436c45b4f1fSLinus Torvaldsconfig CC_OPTIMIZE_FOR_SIZE 143715f5db60SMasahiro Yamada bool "Optimize for size (-Os)" 1438c45b4f1fSLinus Torvalds help 1439ce3b487fSMasahiro Yamada Choosing this option will pass "-Os" to your compiler resulting 1440ce3b487fSMasahiro Yamada in a smaller kernel. 1441c45b4f1fSLinus Torvalds 1442877417e6SArnd Bergmannendchoice 1443877417e6SArnd Bergmann 14445d20ee31SNicholas Pigginconfig HAVE_LD_DEAD_CODE_DATA_ELIMINATION 14455d20ee31SNicholas Piggin bool 14465d20ee31SNicholas Piggin help 14475d20ee31SNicholas Piggin This requires that the arch annotates or otherwise protects 14485d20ee31SNicholas Piggin its external entry points from being discarded. Linker scripts 14495d20ee31SNicholas Piggin must also merge .text.*, .data.*, and .bss.* correctly into 14505d20ee31SNicholas Piggin output sections. Care must be taken not to pull in unrelated 14515d20ee31SNicholas Piggin sections (e.g., '.text.init'). Typically '.' in section names 14525d20ee31SNicholas Piggin is used to distinguish them from label names / C identifiers. 14535d20ee31SNicholas Piggin 14545d20ee31SNicholas Pigginconfig LD_DEAD_CODE_DATA_ELIMINATION 14555d20ee31SNicholas Piggin bool "Dead code and data elimination (EXPERIMENTAL)" 14565d20ee31SNicholas Piggin depends on HAVE_LD_DEAD_CODE_DATA_ELIMINATION 14575d20ee31SNicholas Piggin depends on EXPERT 1458e85d1d65SMasahiro Yamada depends on $(cc-option,-ffunction-sections -fdata-sections) 1459e85d1d65SMasahiro Yamada depends on $(ld-option,--gc-sections) 14605d20ee31SNicholas Piggin help 14618b9d2712SMasahiro Yamada Enable this if you want to do dead code and data elimination with 14628b9d2712SMasahiro Yamada the linker by compiling with -ffunction-sections -fdata-sections, 14638b9d2712SMasahiro Yamada and linking with --gc-sections. 14645d20ee31SNicholas Piggin 14655d20ee31SNicholas Piggin This can reduce on disk and in-memory size of the kernel 14665d20ee31SNicholas Piggin code and static data, particularly for small configs and 14675d20ee31SNicholas Piggin on small systems. This has the possibility of introducing 14685d20ee31SNicholas Piggin silently broken kernel if the required annotations are not 14695d20ee31SNicholas Piggin present. This option is not well tested yet, so use at your 14705d20ee31SNicholas Piggin own risk. 14715d20ee31SNicholas Piggin 147259612b24SNathan Chancellorconfig LD_ORPHAN_WARN 147359612b24SNathan Chancellor def_bool y 147459612b24SNathan Chancellor depends on ARCH_WANT_LD_ORPHAN_WARN 147559612b24SNathan Chancellor depends on $(ld-option,--orphan-handling=warn) 1476e1789d7cSXin Li depends on $(ld-option,--orphan-handling=error) 1477e1789d7cSXin Li 1478e1789d7cSXin Liconfig LD_ORPHAN_WARN_LEVEL 1479e1789d7cSXin Li string 1480e1789d7cSXin Li depends on LD_ORPHAN_WARN 1481e1789d7cSXin Li default "error" if WERROR 1482e1789d7cSXin Li default "warn" 148359612b24SNathan Chancellor 14840847062aSRandy Dunlapconfig SYSCTL 14850847062aSRandy Dunlap bool 14860847062aSRandy Dunlap 1487657a5209SMike Frysingerconfig HAVE_UID16 1488657a5209SMike Frysinger bool 1489657a5209SMike Frysinger 1490657a5209SMike Frysingerconfig SYSCTL_EXCEPTION_TRACE 1491657a5209SMike Frysinger bool 1492657a5209SMike Frysinger help 1493657a5209SMike Frysinger Enable support for /proc/sys/debug/exception-trace. 1494657a5209SMike Frysinger 1495657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_NO_WARN 1496657a5209SMike Frysinger bool 1497657a5209SMike Frysinger help 1498657a5209SMike Frysinger Enable support for /proc/sys/kernel/ignore-unaligned-usertrap 1499657a5209SMike Frysinger Allows arch to define/use @no_unaligned_warning to possibly warn 1500657a5209SMike Frysinger about unaligned access emulation going on under the hood. 1501657a5209SMike Frysinger 1502657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_ALLOW 1503657a5209SMike Frysinger bool 1504657a5209SMike Frysinger help 1505657a5209SMike Frysinger Enable support for /proc/sys/kernel/unaligned-trap 1506657a5209SMike Frysinger Allows arches to define/use @unaligned_enabled to runtime toggle 1507657a5209SMike Frysinger the unaligned access emulation. 1508657a5209SMike Frysinger see arch/parisc/kernel/unaligned.c for reference 1509657a5209SMike Frysinger 1510657a5209SMike Frysingerconfig HAVE_PCSPKR_PLATFORM 1511657a5209SMike Frysinger bool 1512657a5209SMike Frysinger 1513f89b7755SAlexei Starovoitov# interpreter that classic socket filters depend on 1514f89b7755SAlexei Starovoitovconfig BPF 1515f89b7755SAlexei Starovoitov bool 1516ec8f7f48SEric Biggers select CRYPTO_LIB_SHA1 1517f89b7755SAlexei Starovoitov 15186a108a14SDavid Rientjesmenuconfig EXPERT 15196a108a14SDavid Rientjes bool "Configure standard kernel features (expert users)" 1520f505c553SJosh Triplett # Unhide debug options, to make the on-by-default options visible 1521f505c553SJosh Triplett select DEBUG_KERNEL 15221da177e4SLinus Torvalds help 15231da177e4SLinus Torvalds This option allows certain base kernel options and settings 15241da177e4SLinus Torvalds to be disabled or tweaked. This is for specialized 15251da177e4SLinus Torvalds environments which can tolerate a "non-standard" kernel. 15261da177e4SLinus Torvalds Only use this if you really know what you are doing. 15271da177e4SLinus Torvalds 1528ae81f9e3SChuck Ebbertconfig UID16 15296a108a14SDavid Rientjes bool "Enable 16-bit UID system calls" if EXPERT 15302813893fSIulia Manda depends on HAVE_UID16 && MULTIUSER 1531ae81f9e3SChuck Ebbert default y 1532ae81f9e3SChuck Ebbert help 1533ae81f9e3SChuck Ebbert This enables the legacy 16-bit UID syscall wrappers. 1534ae81f9e3SChuck Ebbert 15352813893fSIulia Mandaconfig MULTIUSER 15362813893fSIulia Manda bool "Multiple users, groups and capabilities support" if EXPERT 15372813893fSIulia Manda default y 15382813893fSIulia Manda help 15392813893fSIulia Manda This option enables support for non-root users, groups and 15402813893fSIulia Manda capabilities. 15412813893fSIulia Manda 15422813893fSIulia Manda If you say N here, all processes will run with UID 0, GID 0, and all 15432813893fSIulia Manda possible capabilities. Saying N here also compiles out support for 15442813893fSIulia Manda system calls related to UIDs, GIDs, and capabilities, such as setuid, 15452813893fSIulia Manda setgid, and capset. 15462813893fSIulia Manda 15472813893fSIulia Manda If unsure, say Y here. 15482813893fSIulia Manda 1549f6187769SFabian Frederickconfig SGETMASK_SYSCALL 1550f6187769SFabian Frederick bool "sgetmask/ssetmask syscalls support" if EXPERT 1551a687a533SArnd Bergmann def_bool PARISC || M68K || PPC || MIPS || X86 || SPARC || MICROBLAZE || SUPERH 1552a7f7f624SMasahiro Yamada help 1553f6187769SFabian Frederick sys_sgetmask and sys_ssetmask are obsolete system calls 1554f6187769SFabian Frederick no longer supported in libc but still enabled by default in some 1555f6187769SFabian Frederick architectures. 1556f6187769SFabian Frederick 1557f6187769SFabian Frederick If unsure, leave the default option here. 1558f6187769SFabian Frederick 15596af9f7bfSFabian Frederickconfig SYSFS_SYSCALL 15606af9f7bfSFabian Frederick bool "Sysfs syscall support" if EXPERT 15616af9f7bfSFabian Frederick default y 1562a7f7f624SMasahiro Yamada help 15636af9f7bfSFabian Frederick sys_sysfs is an obsolete system call no longer supported in libc. 15646af9f7bfSFabian Frederick Note that disabling this option is more secure but might break 15656af9f7bfSFabian Frederick compatibility with some systems. 15666af9f7bfSFabian Frederick 15676af9f7bfSFabian Frederick If unsure say Y here. 15686af9f7bfSFabian Frederick 1569d1b069f5SRandy Dunlapconfig FHANDLE 1570d1b069f5SRandy Dunlap bool "open by fhandle syscalls" if EXPERT 1571d1b069f5SRandy Dunlap select EXPORTFS 1572d1b069f5SRandy Dunlap default y 1573d1b069f5SRandy Dunlap help 1574d1b069f5SRandy Dunlap If you say Y here, a user level program will be able to map 1575d1b069f5SRandy Dunlap file names to handle and then later use the handle for 1576d1b069f5SRandy Dunlap different file system operations. This is useful in implementing 1577d1b069f5SRandy Dunlap userspace file servers, which now track files using handles instead 1578d1b069f5SRandy Dunlap of names. The handle would remain the same even if file names 1579d1b069f5SRandy Dunlap get renamed. Enables open_by_handle_at(2) and name_to_handle_at(2) 1580d1b069f5SRandy Dunlap syscalls. 1581d1b069f5SRandy Dunlap 1582baa73d9eSNicolas Pitreconfig POSIX_TIMERS 1583baa73d9eSNicolas Pitre bool "Posix Clocks & timers" if EXPERT 1584baa73d9eSNicolas Pitre default y 1585baa73d9eSNicolas Pitre help 1586baa73d9eSNicolas Pitre This includes native support for POSIX timers to the kernel. 1587baa73d9eSNicolas Pitre Some embedded systems have no use for them and therefore they 1588baa73d9eSNicolas Pitre can be configured out to reduce the size of the kernel image. 1589baa73d9eSNicolas Pitre 1590baa73d9eSNicolas Pitre When this option is disabled, the following syscalls won't be 1591baa73d9eSNicolas Pitre available: timer_create, timer_gettime: timer_getoverrun, 1592baa73d9eSNicolas Pitre timer_settime, timer_delete, clock_adjtime, getitimer, 1593baa73d9eSNicolas Pitre setitimer, alarm. Furthermore, the clock_settime, clock_gettime, 1594baa73d9eSNicolas Pitre clock_getres and clock_nanosleep syscalls will be limited to 1595baa73d9eSNicolas Pitre CLOCK_REALTIME, CLOCK_MONOTONIC and CLOCK_BOOTTIME only. 1596baa73d9eSNicolas Pitre 1597baa73d9eSNicolas Pitre If unsure say y. 1598baa73d9eSNicolas Pitre 1599d59745ceSMatt Mackallconfig PRINTK 1600d59745ceSMatt Mackall default y 16016a108a14SDavid Rientjes bool "Enable support for printk" if EXPERT 160274876a98SFrederic Weisbecker select IRQ_WORK 1603d59745ceSMatt Mackall help 1604d59745ceSMatt Mackall This option enables normal printk support. Removing it 1605d59745ceSMatt Mackall eliminates most of the message strings from the kernel image 1606d59745ceSMatt Mackall and makes the kernel more or less silent. As this makes it 1607d59745ceSMatt Mackall very difficult to diagnose system problems, saying N here is 1608d59745ceSMatt Mackall strongly discouraged. 1609d59745ceSMatt Mackall 1610c8538a7aSMatt Mackallconfig BUG 16116a108a14SDavid Rientjes bool "BUG() support" if EXPERT 1612c8538a7aSMatt Mackall default y 1613c8538a7aSMatt Mackall help 1614c8538a7aSMatt Mackall Disabling this option eliminates support for BUG and WARN, reducing 1615c8538a7aSMatt Mackall the size of your kernel image and potentially quietly ignoring 1616c8538a7aSMatt Mackall numerous fatal conditions. You should only consider disabling this 1617c8538a7aSMatt Mackall option for embedded systems with no facilities for reporting errors. 1618c8538a7aSMatt Mackall Just say Y. 1619c8538a7aSMatt Mackall 1620708e9a79SMatt Mackallconfig ELF_CORE 1621046d662fSAlex Kelly depends on COREDUMP 1622708e9a79SMatt Mackall default y 16236a108a14SDavid Rientjes bool "Enable ELF core dumps" if EXPERT 1624708e9a79SMatt Mackall help 1625708e9a79SMatt Mackall Enable support for generating core dumps. Disabling saves about 4k. 1626708e9a79SMatt Mackall 16278761f1abSRalf Baechle 1628e5e1d3cbSStas Sergeevconfig PCSPKR_PLATFORM 16296a108a14SDavid Rientjes bool "Enable PC-Speaker support" if EXPERT 16308761f1abSRalf Baechle depends on HAVE_PCSPKR_PLATFORM 163115f304b6SRalf Baechle select I8253_LOCK 1632e5e1d3cbSStas Sergeev default y 1633e5e1d3cbSStas Sergeev help 1634e5e1d3cbSStas Sergeev This option allows to disable the internal PC-Speaker 1635e5e1d3cbSStas Sergeev support, saving some memory. 1636e5e1d3cbSStas Sergeev 16371da177e4SLinus Torvaldsconfig BASE_FULL 16381da177e4SLinus Torvalds default y 16396a108a14SDavid Rientjes bool "Enable full-sized data structures for core" if EXPERT 16401da177e4SLinus Torvalds help 16411da177e4SLinus Torvalds Disabling this option reduces the size of miscellaneous core 16421da177e4SLinus Torvalds kernel data structures. This saves memory on small machines, 16431da177e4SLinus Torvalds but may reduce performance. 16441da177e4SLinus Torvalds 16451da177e4SLinus Torvaldsconfig FUTEX 16466a108a14SDavid Rientjes bool "Enable futex support" if EXPERT 16473f2bedabSArnd Bergmann depends on !(SPARC32 && SMP) 16481da177e4SLinus Torvalds default y 1649bc2eecd7SNicolas Pitre imply RT_MUTEXES 16501da177e4SLinus Torvalds help 16511da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 16521da177e4SLinus Torvalds support for "fast userspace mutexes". The resulting kernel may not 16531da177e4SLinus Torvalds run glibc-based applications correctly. 16541da177e4SLinus Torvalds 1655bc2eecd7SNicolas Pitreconfig FUTEX_PI 1656bc2eecd7SNicolas Pitre bool 1657bc2eecd7SNicolas Pitre depends on FUTEX && RT_MUTEXES 1658bc2eecd7SNicolas Pitre default y 1659bc2eecd7SNicolas Pitre 16601da177e4SLinus Torvaldsconfig EPOLL 16616a108a14SDavid Rientjes bool "Enable eventpoll support" if EXPERT 16621da177e4SLinus Torvalds default y 16631da177e4SLinus Torvalds help 16641da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 16651da177e4SLinus Torvalds support for epoll family of system calls. 16661da177e4SLinus Torvalds 1667fba2afaaSDavide Libenziconfig SIGNALFD 16686a108a14SDavid Rientjes bool "Enable signalfd() system call" if EXPERT 1669fba2afaaSDavide Libenzi default y 1670fba2afaaSDavide Libenzi help 1671fba2afaaSDavide Libenzi Enable the signalfd() system call that allows to receive signals 1672fba2afaaSDavide Libenzi on a file descriptor. 1673fba2afaaSDavide Libenzi 1674fba2afaaSDavide Libenzi If unsure, say Y. 1675fba2afaaSDavide Libenzi 1676b215e283SDavide Libenziconfig TIMERFD 16776a108a14SDavid Rientjes bool "Enable timerfd() system call" if EXPERT 1678b215e283SDavide Libenzi default y 1679b215e283SDavide Libenzi help 1680b215e283SDavide Libenzi Enable the timerfd() system call that allows to receive timer 1681b215e283SDavide Libenzi events on a file descriptor. 1682b215e283SDavide Libenzi 1683b215e283SDavide Libenzi If unsure, say Y. 1684b215e283SDavide Libenzi 1685e1ad7468SDavide Libenziconfig EVENTFD 16866a108a14SDavid Rientjes bool "Enable eventfd() system call" if EXPERT 1687e1ad7468SDavide Libenzi default y 1688e1ad7468SDavide Libenzi help 1689e1ad7468SDavide Libenzi Enable the eventfd() system call that allows to receive both 1690e1ad7468SDavide Libenzi kernel notification (ie. KAIO) or userspace notifications. 1691e1ad7468SDavide Libenzi 1692e1ad7468SDavide Libenzi If unsure, say Y. 1693e1ad7468SDavide Libenzi 16941da177e4SLinus Torvaldsconfig SHMEM 16956a108a14SDavid Rientjes bool "Use full shmem filesystem" if EXPERT 16961da177e4SLinus Torvalds default y 16971da177e4SLinus Torvalds depends on MMU 16981da177e4SLinus Torvalds help 16991da177e4SLinus Torvalds The shmem is an internal filesystem used to manage shared memory. 17001da177e4SLinus Torvalds It is backed by swap and manages resource limits. It is also exported 17011da177e4SLinus Torvalds to userspace as tmpfs if TMPFS is enabled. Disabling this 17021da177e4SLinus Torvalds option replaces shmem and tmpfs with the much simpler ramfs code, 17031da177e4SLinus Torvalds which may be appropriate on small systems without swap. 17041da177e4SLinus Torvalds 1705ebf3f09cSThomas Petazzoniconfig AIO 17066a108a14SDavid Rientjes bool "Enable AIO support" if EXPERT 1707ebf3f09cSThomas Petazzoni default y 1708ebf3f09cSThomas Petazzoni help 1709ebf3f09cSThomas Petazzoni This option enables POSIX asynchronous I/O which may by used 1710ebf3f09cSThomas Petazzoni by some high performance threaded applications. Disabling 1711ebf3f09cSThomas Petazzoni this option saves about 7k. 1712ebf3f09cSThomas Petazzoni 17132b188cc1SJens Axboeconfig IO_URING 17142b188cc1SJens Axboe bool "Enable IO uring support" if EXPERT 1715561fb04aSJens Axboe select IO_WQ 17162b188cc1SJens Axboe default y 17172b188cc1SJens Axboe help 17182b188cc1SJens Axboe This option enables support for the io_uring interface, enabling 17192b188cc1SJens Axboe applications to submit and complete IO through submission and 17202b188cc1SJens Axboe completion rings that are shared between the kernel and application. 17212b188cc1SJens Axboe 1722d3ac21caSJosh Triplettconfig ADVISE_SYSCALLS 1723d3ac21caSJosh Triplett bool "Enable madvise/fadvise syscalls" if EXPERT 1724d3ac21caSJosh Triplett default y 1725d3ac21caSJosh Triplett help 1726d3ac21caSJosh Triplett This option enables the madvise and fadvise syscalls, used by 1727d3ac21caSJosh Triplett applications to advise the kernel about their future memory or file 1728d3ac21caSJosh Triplett usage, improving performance. If building an embedded system where no 1729d3ac21caSJosh Triplett applications use these syscalls, you can disable this option to save 1730d3ac21caSJosh Triplett space. 1731d3ac21caSJosh Triplett 17325b25b13aSMathieu Desnoyersconfig MEMBARRIER 17335b25b13aSMathieu Desnoyers bool "Enable membarrier() system call" if EXPERT 17345b25b13aSMathieu Desnoyers default y 17355b25b13aSMathieu Desnoyers help 17365b25b13aSMathieu Desnoyers Enable the membarrier() system call that allows issuing memory 17375b25b13aSMathieu Desnoyers barriers across all running threads, which can be used to distribute 17385b25b13aSMathieu Desnoyers the cost of user-space memory barriers asymmetrically by transforming 17395b25b13aSMathieu Desnoyers pairs of memory barriers into pairs consisting of membarrier() and a 17405b25b13aSMathieu Desnoyers compiler barrier. 17415b25b13aSMathieu Desnoyers 17425b25b13aSMathieu Desnoyers If unsure, say Y. 17435b25b13aSMathieu Desnoyers 1744d1b069f5SRandy Dunlapconfig KALLSYMS 1745d1b069f5SRandy Dunlap bool "Load all symbols for debugging/ksymoops" if EXPERT 1746d1b069f5SRandy Dunlap default y 1747d1b069f5SRandy Dunlap help 1748d1b069f5SRandy Dunlap Say Y here to let the kernel print out symbolic crash information and 1749d1b069f5SRandy Dunlap symbolic stack backtraces. This increases the size of the kernel 1750d1b069f5SRandy Dunlap somewhat, as all symbols have to be loaded into the kernel image. 1751d1b069f5SRandy Dunlap 175230f3bb09SZhen Leiconfig KALLSYMS_SELFTEST 175330f3bb09SZhen Lei bool "Test the basic functions and performance of kallsyms" 175430f3bb09SZhen Lei depends on KALLSYMS 175530f3bb09SZhen Lei default n 175630f3bb09SZhen Lei help 175730f3bb09SZhen Lei Test the basic functions and performance of some interfaces, such as 175830f3bb09SZhen Lei kallsyms_lookup_name. It also calculates the compression rate of the 175930f3bb09SZhen Lei kallsyms compression algorithm for the current symbol set. 176030f3bb09SZhen Lei 176130f3bb09SZhen Lei Start self-test automatically after system startup. Suggest executing 176230f3bb09SZhen Lei "dmesg | grep kallsyms_selftest" to collect test results. "finish" is 176330f3bb09SZhen Lei displayed in the last line, indicating that the test is complete. 176430f3bb09SZhen Lei 1765d1b069f5SRandy Dunlapconfig KALLSYMS_ALL 1766d1b069f5SRandy Dunlap bool "Include all symbols in kallsyms" 1767d1b069f5SRandy Dunlap depends on DEBUG_KERNEL && KALLSYMS 1768d1b069f5SRandy Dunlap help 1769d1b069f5SRandy Dunlap Normally kallsyms only contains the symbols of functions for nicer 1770d1b069f5SRandy Dunlap OOPS messages and backtraces (i.e., symbols from the text and inittext 1771bdf0fe33SBaruch Siach sections). This is sufficient for most cases. And only if you want to 1772bdf0fe33SBaruch Siach enable kernel live patching, or other less common use cases (e.g., 1773bdf0fe33SBaruch Siach when a debugger is used) all symbols are required (i.e., names of 1774bdf0fe33SBaruch Siach variables from the data sections, etc). 1775d1b069f5SRandy Dunlap 1776d1b069f5SRandy Dunlap This option makes sure that all symbols are loaded into the kernel 1777d1b069f5SRandy Dunlap image (i.e., symbols from all sections) in cost of increased kernel 1778d1b069f5SRandy Dunlap size (depending on the kernel configuration, it may be 300KiB or 1779d1b069f5SRandy Dunlap something like this). 1780d1b069f5SRandy Dunlap 1781bdf0fe33SBaruch Siach Say N unless you really need all symbols, or kernel live patching. 1782d1b069f5SRandy Dunlap 1783d1b069f5SRandy Dunlapconfig KALLSYMS_ABSOLUTE_PERCPU 1784d1b069f5SRandy Dunlap bool 1785d1b069f5SRandy Dunlap depends on KALLSYMS 1786d1b069f5SRandy Dunlap default X86_64 && SMP 1787d1b069f5SRandy Dunlap 1788d1b069f5SRandy Dunlapconfig KALLSYMS_BASE_RELATIVE 1789d1b069f5SRandy Dunlap bool 1790d1b069f5SRandy Dunlap depends on KALLSYMS 1791a687a533SArnd Bergmann default !IA64 1792d1b069f5SRandy Dunlap help 1793d1b069f5SRandy Dunlap Instead of emitting them as absolute values in the native word size, 1794d1b069f5SRandy Dunlap emit the symbol references in the kallsyms table as 32-bit entries, 1795d1b069f5SRandy Dunlap each containing a relative value in the range [base, base + U32_MAX] 1796d1b069f5SRandy Dunlap or, when KALLSYMS_ABSOLUTE_PERCPU is in effect, each containing either 1797d1b069f5SRandy Dunlap an absolute value in the range [0, S32_MAX] or a relative value in the 1798d1b069f5SRandy Dunlap range [base, base + S32_MAX], where base is the lowest relative symbol 1799d1b069f5SRandy Dunlap address encountered in the image. 1800d1b069f5SRandy Dunlap 1801d1b069f5SRandy Dunlap On 64-bit builds, this reduces the size of the address table by 50%, 1802d1b069f5SRandy Dunlap but more importantly, it results in entries whose values are build 1803d1b069f5SRandy Dunlap time constants, and no relocation pass is required at runtime to fix 1804d1b069f5SRandy Dunlap up the entries based on the runtime load address of the kernel. 1805d1b069f5SRandy Dunlap 1806d1b069f5SRandy Dunlap# end of the "standard kernel features (expert users)" menu 1807d1b069f5SRandy Dunlap 1808d1b069f5SRandy Dunlap# syscall, maps, verifier 1809fc611f47SKP Singh 18103ccfebedSMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_CALLBACKS 18113ccfebedSMathieu Desnoyers bool 18123ccfebedSMathieu Desnoyers 181370216e18SMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_SYNC_CORE 181470216e18SMathieu Desnoyers bool 181570216e18SMathieu Desnoyers 1816bfe3911aSChris Wilsonconfig KCMP 1817bfe3911aSChris Wilson bool "Enable kcmp() system call" if EXPERT 1818bfe3911aSChris Wilson help 1819bfe3911aSChris Wilson Enable the kernel resource comparison system call. It provides 1820bfe3911aSChris Wilson user-space with the ability to compare two processes to see if they 1821bfe3911aSChris Wilson share a common resource, such as a file descriptor or even virtual 1822bfe3911aSChris Wilson memory space. 1823bfe3911aSChris Wilson 1824bfe3911aSChris Wilson If unsure, say N. 1825bfe3911aSChris Wilson 1826d7822b1eSMathieu Desnoyersconfig RSEQ 1827d7822b1eSMathieu Desnoyers bool "Enable rseq() system call" if EXPERT 1828d7822b1eSMathieu Desnoyers default y 1829d7822b1eSMathieu Desnoyers depends on HAVE_RSEQ 1830d7822b1eSMathieu Desnoyers select MEMBARRIER 1831d7822b1eSMathieu Desnoyers help 1832d7822b1eSMathieu Desnoyers Enable the restartable sequences system call. It provides a 1833d7822b1eSMathieu Desnoyers user-space cache for the current CPU number value, which 1834d7822b1eSMathieu Desnoyers speeds up getting the current CPU number from user-space, 1835d7822b1eSMathieu Desnoyers as well as an ABI to speed up user-space operations on 1836d7822b1eSMathieu Desnoyers per-CPU data. 1837d7822b1eSMathieu Desnoyers 1838d7822b1eSMathieu Desnoyers If unsure, say Y. 1839d7822b1eSMathieu Desnoyers 1840d7822b1eSMathieu Desnoyersconfig DEBUG_RSEQ 1841d7822b1eSMathieu Desnoyers default n 1842d7822b1eSMathieu Desnoyers bool "Enabled debugging of rseq() system call" if EXPERT 1843d7822b1eSMathieu Desnoyers depends on RSEQ && DEBUG_KERNEL 1844d7822b1eSMathieu Desnoyers help 1845d7822b1eSMathieu Desnoyers Enable extra debugging checks for the rseq system call. 1846d7822b1eSMathieu Desnoyers 1847d7822b1eSMathieu Desnoyers If unsure, say N. 1848d7822b1eSMathieu Desnoyers 18496befe5f6SRandy Dunlapconfig EMBEDDED 18506befe5f6SRandy Dunlap bool "Embedded system" 18516befe5f6SRandy Dunlap select EXPERT 18526befe5f6SRandy Dunlap help 18536befe5f6SRandy Dunlap This option should be enabled if compiling the kernel for 18546befe5f6SRandy Dunlap an embedded system so certain expert options are available 18556befe5f6SRandy Dunlap for configuration. 18566befe5f6SRandy Dunlap 1857cdd6c482SIngo Molnarconfig HAVE_PERF_EVENTS 18580793a61dSThomas Gleixner bool 1859018df72dSMike Frysinger help 1860018df72dSMike Frysinger See tools/perf/design.txt for details. 18610793a61dSThomas Gleixner 18622aef6f30SSean Christophersonconfig GUEST_PERF_EVENTS 18632aef6f30SSean Christopherson bool 18642aef6f30SSean Christopherson depends on HAVE_PERF_EVENTS 18652aef6f30SSean Christopherson 1866906010b2SPeter Zijlstraconfig PERF_USE_VMALLOC 1867906010b2SPeter Zijlstra bool 1868906010b2SPeter Zijlstra help 1869906010b2SPeter Zijlstra See tools/perf/design.txt for details 1870906010b2SPeter Zijlstra 1871ad90a3deSWilliam Breathitt Grayconfig PC104 1872424529fbSWilliam Breathitt Gray bool "PC/104 support" if EXPERT 1873ad90a3deSWilliam Breathitt Gray help 1874ad90a3deSWilliam Breathitt Gray Expose PC/104 form factor device drivers and options available for 1875ad90a3deSWilliam Breathitt Gray selection and configuration. Enable this option if your target 1876ad90a3deSWilliam Breathitt Gray machine has a PC/104 bus. 1877ad90a3deSWilliam Breathitt Gray 187857c0c15bSIngo Molnarmenu "Kernel Performance Events And Counters" 18790793a61dSThomas Gleixner 1880cdd6c482SIngo Molnarconfig PERF_EVENTS 188157c0c15bSIngo Molnar bool "Kernel performance events and counters" 1882392d65a9SRobert Richter default y if PROFILING 1883cdd6c482SIngo Molnar depends on HAVE_PERF_EVENTS 1884e360adbeSPeter Zijlstra select IRQ_WORK 188583fe27eaSPranith Kumar select SRCU 18860793a61dSThomas Gleixner help 188757c0c15bSIngo Molnar Enable kernel support for various performance events provided 188857c0c15bSIngo Molnar by software and hardware. 18890793a61dSThomas Gleixner 1890dd77038dSThadeu Lima de Souza Cascardo Software events are supported either built-in or via the 189157c0c15bSIngo Molnar use of generic tracepoints. 189257c0c15bSIngo Molnar 189357c0c15bSIngo Molnar Most modern CPUs support performance events via performance 189457c0c15bSIngo Molnar counter registers. These registers count the number of certain 18950793a61dSThomas Gleixner types of hw events: such as instructions executed, cachemisses 18960793a61dSThomas Gleixner suffered, or branches mis-predicted - without slowing down the 18970793a61dSThomas Gleixner kernel or applications. These registers can also trigger interrupts 18980793a61dSThomas Gleixner when a threshold number of events have passed - and can thus be 18990793a61dSThomas Gleixner used to profile the code that runs on that CPU. 19000793a61dSThomas Gleixner 190157c0c15bSIngo Molnar The Linux Performance Event subsystem provides an abstraction of 1902dd77038dSThadeu Lima de Souza Cascardo these software and hardware event capabilities, available via a 190357c0c15bSIngo Molnar system call and used by the "perf" utility in tools/perf/. It 19040793a61dSThomas Gleixner provides per task and per CPU counters, and it provides event 19050793a61dSThomas Gleixner capabilities on top of those. 19060793a61dSThomas Gleixner 19070793a61dSThomas Gleixner Say Y if unsure. 19080793a61dSThomas Gleixner 1909906010b2SPeter Zijlstraconfig DEBUG_PERF_USE_VMALLOC 1910906010b2SPeter Zijlstra default n 1911906010b2SPeter Zijlstra bool "Debug: use vmalloc to back perf mmap() buffers" 1912cb307113SMichael Ellerman depends on PERF_EVENTS && DEBUG_KERNEL && !PPC 1913906010b2SPeter Zijlstra select PERF_USE_VMALLOC 1914906010b2SPeter Zijlstra help 1915906010b2SPeter Zijlstra Use vmalloc memory to back perf mmap() buffers. 1916906010b2SPeter Zijlstra 1917906010b2SPeter Zijlstra Mostly useful for debugging the vmalloc code on platforms 1918906010b2SPeter Zijlstra that don't require it. 1919906010b2SPeter Zijlstra 1920906010b2SPeter Zijlstra Say N if unsure. 1921906010b2SPeter Zijlstra 19220793a61dSThomas Gleixnerendmenu 19230793a61dSThomas Gleixner 1924091f6e26SDavid Howellsconfig SYSTEM_DATA_VERIFICATION 1925091f6e26SDavid Howells def_bool n 1926091f6e26SDavid Howells select SYSTEM_TRUSTED_KEYRING 1927091f6e26SDavid Howells select KEYS 1928091f6e26SDavid Howells select CRYPTO 1929d43de6c7SDavid Howells select CRYPTO_RSA 1930091f6e26SDavid Howells select ASYMMETRIC_KEY_TYPE 1931091f6e26SDavid Howells select ASYMMETRIC_PUBLIC_KEY_SUBTYPE 1932091f6e26SDavid Howells select ASN1 1933091f6e26SDavid Howells select OID_REGISTRY 1934091f6e26SDavid Howells select X509_CERTIFICATE_PARSER 1935091f6e26SDavid Howells select PKCS7_MESSAGE_PARSER 193682c04ff8SPeter Foley help 1937091f6e26SDavid Howells Provide PKCS#7 message verification using the contents of the system 1938091f6e26SDavid Howells trusted keyring to provide public keys. This then can be used for 1939091f6e26SDavid Howells module verification, kexec image verification and firmware blob 1940091f6e26SDavid Howells verification. 194182c04ff8SPeter Foley 1942125e5645SMathieu Desnoyersconfig PROFILING 1943b309a294SRobert Richter bool "Profiling support" 1944125e5645SMathieu Desnoyers help 1945125e5645SMathieu Desnoyers Say Y here to enable the extended profiling support mechanisms used 1946f8408264SViresh Kumar by profilers. 1947125e5645SMathieu Desnoyers 19482f7ab126SMiguel Ojedaconfig RUST 19492f7ab126SMiguel Ojeda bool "Rust support" 19502f7ab126SMiguel Ojeda depends on HAVE_RUST 19512f7ab126SMiguel Ojeda depends on RUST_IS_AVAILABLE 19522f7ab126SMiguel Ojeda depends on !MODVERSIONS 19532f7ab126SMiguel Ojeda depends on !GCC_PLUGINS 19542f7ab126SMiguel Ojeda depends on !RANDSTRUCT 19552f7ab126SMiguel Ojeda depends on !DEBUG_INFO_BTF 19562f7ab126SMiguel Ojeda select CONSTRUCTORS 19572f7ab126SMiguel Ojeda help 19582f7ab126SMiguel Ojeda Enables Rust support in the kernel. 19592f7ab126SMiguel Ojeda 19602f7ab126SMiguel Ojeda This allows other Rust-related options, like drivers written in Rust, 19612f7ab126SMiguel Ojeda to be selected. 19622f7ab126SMiguel Ojeda 19632f7ab126SMiguel Ojeda It is also required to be able to load external kernel modules 19642f7ab126SMiguel Ojeda written in Rust. 19652f7ab126SMiguel Ojeda 19662f7ab126SMiguel Ojeda See Documentation/rust/ for more information. 19672f7ab126SMiguel Ojeda 19682f7ab126SMiguel Ojeda If unsure, say N. 19692f7ab126SMiguel Ojeda 19702f7ab126SMiguel Ojedaconfig RUSTC_VERSION_TEXT 19712f7ab126SMiguel Ojeda string 19722f7ab126SMiguel Ojeda depends on RUST 19732f7ab126SMiguel Ojeda default $(shell,command -v $(RUSTC) >/dev/null 2>&1 && $(RUSTC) --version || echo n) 19742f7ab126SMiguel Ojeda 19752f7ab126SMiguel Ojedaconfig BINDGEN_VERSION_TEXT 19762f7ab126SMiguel Ojeda string 19772f7ab126SMiguel Ojeda depends on RUST 19782f7ab126SMiguel Ojeda default $(shell,command -v $(BINDGEN) >/dev/null 2>&1 && $(BINDGEN) --version || echo n) 19792f7ab126SMiguel Ojeda 19805f87f112SIngo Molnar# 19815f87f112SIngo Molnar# Place an empty function call at each tracepoint site. Can be 19825f87f112SIngo Molnar# dynamically changed for a probe function. 19835f87f112SIngo Molnar# 198497e1c18eSMathieu Desnoyersconfig TRACEPOINTS 19855f87f112SIngo Molnar bool 198697e1c18eSMathieu Desnoyers 19871da177e4SLinus Torvaldsendmenu # General setup 19881da177e4SLinus Torvalds 19891572497cSChristoph Hellwigsource "arch/Kconfig" 19901572497cSChristoph Hellwig 1991ae81f9e3SChuck Ebbertconfig RT_MUTEXES 19926341e62bSChristoph Jaeger bool 19931c6f9ec0SSebastian Andrzej Siewior default y if PREEMPT_RT 1994ae81f9e3SChuck Ebbert 19951da177e4SLinus Torvaldsconfig BASE_SMALL 19961da177e4SLinus Torvalds int 19971da177e4SLinus Torvalds default 0 if BASE_FULL 19981da177e4SLinus Torvalds default 1 if !BASE_FULL 19991da177e4SLinus Torvalds 2000c8424e77SThiago Jung Bauermannconfig MODULE_SIG_FORMAT 2001c8424e77SThiago Jung Bauermann def_bool n 2002c8424e77SThiago Jung Bauermann select SYSTEM_DATA_VERIFICATION 2003c8424e77SThiago Jung Bauermann 200473b4fc92SChristophe Leroysource "kernel/module/Kconfig" 20056c9692e2SPeter Zijlstra 200698a79d6aSRusty Russellconfig INIT_ALL_POSSIBLE 200798a79d6aSRusty Russell bool 200898a79d6aSRusty Russell help 20095f054e31SRusty Russell Back when each arch used to define their own cpu_online_mask and 20105f054e31SRusty Russell cpu_possible_mask, some of them chose to initialize cpu_possible_mask 201198a79d6aSRusty Russell with all 1s, and others with all 0s. When they were centralised, 201298a79d6aSRusty Russell it was better to provide this option than to break all the archs 2013692105b8SMatt LaPlante and have several arch maintainers pursuing me down dark alleys. 201498a79d6aSRusty Russell 20153a65dfe8SJens Axboesource "block/Kconfig" 2016e98c3202SAvi Kivity 2017e98c3202SAvi Kivityconfig PREEMPT_NOTIFIERS 2018e98c3202SAvi Kivity bool 2019e260be67SPaul E. McKenney 202016295becSSteffen Klassertconfig PADATA 202116295becSSteffen Klassert depends on SMP 202216295becSSteffen Klassert bool 202316295becSSteffen Klassert 20244520c6a4SDavid Howellsconfig ASN1 20254520c6a4SDavid Howells tristate 20264520c6a4SDavid Howells help 20274520c6a4SDavid Howells Build a simple ASN.1 grammar compiler that produces a bytecode output 20284520c6a4SDavid Howells that can be interpreted by the ASN.1 stream decoder and used to 20294520c6a4SDavid Howells inform it as to what tags are to be expected in a stream and what 20304520c6a4SDavid Howells functions to call on what tags. 20314520c6a4SDavid Howells 20326beb0009SThomas Gleixnersource "kernel/Kconfig.locks" 2033e61938a9SMathieu Desnoyers 20340ebeea8cSDaniel Borkmannconfig ARCH_HAS_NON_OVERLAPPING_ADDRESS_SPACE 20350ebeea8cSDaniel Borkmann bool 20360ebeea8cSDaniel Borkmann 2037e61938a9SMathieu Desnoyersconfig ARCH_HAS_SYNC_CORE_BEFORE_USERMODE 2038e61938a9SMathieu Desnoyers bool 20391bd21c6cSDominik Brodowski 20401bd21c6cSDominik Brodowski# It may be useful for an architecture to override the definitions of the 20417303e30eSDominik Brodowski# SYSCALL_DEFINE() and __SYSCALL_DEFINEx() macros in <linux/syscalls.h> 20427303e30eSDominik Brodowski# and the COMPAT_ variants in <linux/compat.h>, in particular to use a 20437303e30eSDominik Brodowski# different calling convention for syscalls. They can also override the 20447303e30eSDominik Brodowski# macros for not-implemented syscalls in kernel/sys_ni.c and 20457303e30eSDominik Brodowski# kernel/time/posix-stubs.c. All these overrides need to be available in 20467303e30eSDominik Brodowski# <asm/syscall_wrapper.h>. 20471bd21c6cSDominik Brodowskiconfig ARCH_HAS_SYSCALL_WRAPPER 20481bd21c6cSDominik Brodowski def_bool n 2049