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 636e74c6b5SMiguel Ojedaconfig RUSTC_VERSION 646e74c6b5SMiguel Ojeda int 656e74c6b5SMiguel Ojeda default $(shell,$(srctree)/scripts/rustc-version.sh $(RUSTC)) 666e74c6b5SMiguel Ojeda help 676e74c6b5SMiguel Ojeda It does not depend on `RUST` since that one may need to use the version 686e74c6b5SMiguel Ojeda in a `depends on`. 696e74c6b5SMiguel Ojeda 702f7ab126SMiguel Ojedaconfig RUST_IS_AVAILABLE 712f7ab126SMiguel Ojeda def_bool $(success,$(srctree)/scripts/rust_is_available.sh) 722f7ab126SMiguel Ojeda help 732f7ab126SMiguel Ojeda This shows whether a suitable Rust toolchain is available (found). 742f7ab126SMiguel Ojeda 752f7ab126SMiguel Ojeda Please see Documentation/rust/quick-start.rst for instructions on how 76eacf96d2SColin Ian King to satisfy the build requirements of Rust support. 772f7ab126SMiguel Ojeda 782f7ab126SMiguel Ojeda In particular, the Makefile target 'rustavailable' is useful to check 792f7ab126SMiguel Ojeda why the Rust toolchain is not being detected. 802f7ab126SMiguel Ojeda 811a927fd3SMasahiro Yamadaconfig CC_CAN_LINK 829371f86eSMasahiro Yamada bool 83f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag)) if 64BIT 84f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag)) 851a927fd3SMasahiro Yamada 86b1183b6dSMasahiro Yamadaconfig CC_CAN_LINK_STATIC 87b1183b6dSMasahiro Yamada bool 88f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag) -static) if 64BIT 89f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag) -static) 90c65eacbeSAndy Lutomirski 91f2f6a8e8SMark Rutland# Fixed in GCC 14, 13.3, 12.4 and 11.5 92f2f6a8e8SMark Rutland# https://gcc.gnu.org/bugzilla/show_bug.cgi?id=113921 93f2f6a8e8SMark Rutlandconfig GCC_ASM_GOTO_OUTPUT_BROKEN 94f2f6a8e8SMark Rutland bool 95f2f6a8e8SMark Rutland depends on CC_IS_GCC 96f2f6a8e8SMark Rutland default y if GCC_VERSION < 110500 97f2f6a8e8SMark Rutland default y if GCC_VERSION >= 120000 && GCC_VERSION < 120400 98f2f6a8e8SMark Rutland default y if GCC_VERSION >= 130000 && GCC_VERSION < 130300 99f2f6a8e8SMark Rutland 100587f1701SNick Desaulniersconfig CC_HAS_ASM_GOTO_OUTPUT 101f2f6a8e8SMark Rutland def_bool y 102f2f6a8e8SMark Rutland depends on !GCC_ASM_GOTO_OUTPUT_BROKEN 103f2f6a8e8SMark Rutland depends on $(success,echo 'int foo(int x) { asm goto ("": "=r"(x) ::: bar); return x; bar: return 0; }' | $(CC) -x c - -c -o /dev/null) 104587f1701SNick Desaulniers 1051aa0e8b1SSean Christophersonconfig CC_HAS_ASM_GOTO_TIED_OUTPUT 1061aa0e8b1SSean Christopherson depends on CC_HAS_ASM_GOTO_OUTPUT 1071aa0e8b1SSean Christopherson # Detect buggy gcc and clang, fixed in gcc-11 clang-14. 108534bd703SAlexandre 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) 1091aa0e8b1SSean Christopherson 1105cf896fbSPeter Collingbourneconfig TOOLS_SUPPORT_RELR 1112d122942SWill Deacon def_bool $(success,env "CC=$(CC)" "LD=$(LD)" "NM=$(NM)" "OBJCOPY=$(OBJCOPY)" $(srctree)/scripts/tools-support-relr.sh) 1125cf896fbSPeter Collingbourne 113eb111869SRasmus Villemoesconfig CC_HAS_ASM_INLINE 114eb111869SRasmus Villemoes def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null) 115eb111869SRasmus Villemoes 11651c2ee6dSNick Desaulniersconfig CC_HAS_NO_PROFILE_FN_ATTR 11751c2ee6dSNick Desaulniers def_bool $(success,echo '__attribute__((no_profile_instrument_function)) int x();' | $(CC) -x c - -c -o /dev/null -Werror) 11851c2ee6dSNick Desaulniers 119613fe169SNathan Chancellorconfig PAHOLE_VERSION 120613fe169SNathan Chancellor int 121613fe169SNathan Chancellor default $(shell,$(srctree)/scripts/pahole-version.sh $(PAHOLE)) 122613fe169SNathan Chancellor 123b99b87f7SPeter Oberparleiterconfig CONSTRUCTORS 124b99b87f7SPeter Oberparleiter bool 125b99b87f7SPeter Oberparleiter 126e360adbeSPeter Zijlstraconfig IRQ_WORK 127fd0a68a2STejun Heo def_bool y if SMP 128e360adbeSPeter Zijlstra 12910916706SShile Zhangconfig BUILDTIME_TABLE_SORT 1301dbdc6f1SDavid Daney bool 1311dbdc6f1SDavid Daney 132c65eacbeSAndy Lutomirskiconfig THREAD_INFO_IN_TASK 133c65eacbeSAndy Lutomirski bool 134c65eacbeSAndy Lutomirski help 135c65eacbeSAndy Lutomirski Select this to move thread_info off the stack into task_struct. To 136c65eacbeSAndy Lutomirski make this work, an arch will need to remove all thread_info fields 137c65eacbeSAndy Lutomirski except flags and fix any runtime bugs. 138c65eacbeSAndy Lutomirski 139c6c314a6SAndy Lutomirski One subtle change that will be needed is to use try_get_task_stack() 140c6c314a6SAndy Lutomirski and put_task_stack() in save_thread_stack_tsk() and get_wchan(). 141c6c314a6SAndy Lutomirski 142ff0cfc66SAl Boldimenu "General setup" 1431da177e4SLinus Torvalds 1441da177e4SLinus Torvaldsconfig BROKEN 1451da177e4SLinus Torvalds bool 1461da177e4SLinus Torvalds 1471da177e4SLinus Torvaldsconfig BROKEN_ON_SMP 1481da177e4SLinus Torvalds bool 1491da177e4SLinus Torvalds depends on BROKEN || !SMP 1501da177e4SLinus Torvalds default y 1511da177e4SLinus Torvalds 1521da177e4SLinus Torvaldsconfig INIT_ENV_ARG_LIMIT 1531da177e4SLinus Torvalds int 154dd673bcaSAdrian Bunk default 32 if !UML 155dd673bcaSAdrian Bunk default 128 if UML 1561da177e4SLinus Torvalds help 15734ad92c2SRandy Dunlap Maximum of each of the number of arguments and environment 15834ad92c2SRandy Dunlap variables passed to init from the kernel command line. 1591da177e4SLinus Torvalds 1604bb16672SJiri Slabyconfig COMPILE_TEST 1614bb16672SJiri Slaby bool "Compile also drivers which will not load" 162ea29b20aSMasahiro Yamada depends on HAS_IOMEM 1634bb16672SJiri Slaby help 1644bb16672SJiri Slaby Some drivers can be compiled on a different platform than they are 1654bb16672SJiri Slaby intended to be run on. Despite they cannot be loaded there (or even 1664bb16672SJiri Slaby when they load they cannot be used due to missing HW support), 1674bb16672SJiri Slaby developers still, opposing to distributors, might want to build such 1684bb16672SJiri Slaby drivers to compile-test them. 1694bb16672SJiri Slaby 1704bb16672SJiri Slaby If you are a developer and want to build everything available, say Y 1714bb16672SJiri Slaby here. If you are a user/distributor, say N here to exclude useless 1724bb16672SJiri Slaby drivers to be distributed. 1734bb16672SJiri Slaby 1743fe617ccSLinus Torvaldsconfig WERROR 1753fe617ccSLinus Torvalds bool "Compile the kernel with warnings as errors" 176b339ec9cSMarco Elver default COMPILE_TEST 1773fe617ccSLinus Torvalds help 1783fe617ccSLinus Torvalds A kernel build should not cause any compiler warnings, and this 1792f7ab126SMiguel Ojeda enables the '-Werror' (for C) and '-Dwarnings' (for Rust) flags 180e1789d7cSXin Li to enforce that rule by default. Certain warnings from other tools 181e1789d7cSXin Li such as the linker may be upgraded to errors with this option as 182e1789d7cSXin Li well. 1833fe617ccSLinus Torvalds 184e1789d7cSXin Li However, if you have a new (or very old) compiler or linker with odd 185e1789d7cSXin Li and unusual warnings, or you have some architecture with problems, 1863fe617ccSLinus Torvalds you may need to disable this config option in order to 1873fe617ccSLinus Torvalds successfully build the kernel. 1883fe617ccSLinus Torvalds 1893fe617ccSLinus Torvalds If in doubt, say Y. 1903fe617ccSLinus Torvalds 191d6fc9fcbSMasahiro Yamadaconfig UAPI_HEADER_TEST 192d6fc9fcbSMasahiro Yamada bool "Compile test UAPI headers" 193fcbb8461SMasahiro Yamada depends on HEADERS_INSTALL && CC_CAN_LINK 194d6fc9fcbSMasahiro Yamada help 195d6fc9fcbSMasahiro Yamada Compile test headers exported to user-space to ensure they are 196d6fc9fcbSMasahiro Yamada self-contained, i.e. compilable as standalone units. 197d6fc9fcbSMasahiro Yamada 198d6fc9fcbSMasahiro Yamada If you are a developer or tester and want to ensure the exported 199d6fc9fcbSMasahiro Yamada headers are self-contained, say Y here. Otherwise, choose N. 200d6fc9fcbSMasahiro Yamada 2011da177e4SLinus Torvaldsconfig LOCALVERSION 2021da177e4SLinus Torvalds string "Local version - append to kernel release" 2031da177e4SLinus Torvalds help 2041da177e4SLinus Torvalds Append an extra string to the end of your kernel version. 2051da177e4SLinus Torvalds This will show up when you type uname, for example. 2061da177e4SLinus Torvalds The string you set here will be appended after the contents of 2071da177e4SLinus Torvalds any files with a filename matching localversion* in your 2081da177e4SLinus Torvalds object and source tree, in that order. Your total string can 2091da177e4SLinus Torvalds be a maximum of 64 characters. 2101da177e4SLinus Torvalds 211aaebf433SRyan Andersonconfig LOCALVERSION_AUTO 212aaebf433SRyan Anderson bool "Automatically append version information to the version string" 213aaebf433SRyan Anderson default y 214ac3339baSAlexey Dobriyan depends on !COMPILE_TEST 215aaebf433SRyan Anderson help 216aaebf433SRyan Anderson This will try to automatically determine if the current tree is a 2176e5a5420SRobert P. J. Day release tree by looking for git tags that belong to the current 2186e5a5420SRobert P. J. Day top of tree revision. 219aaebf433SRyan Anderson 220aaebf433SRyan Anderson A string of the format -gxxxxxxxx will be added to the localversion 2216e5a5420SRobert P. J. Day if a git-based tree is found. The string generated by this will be 222aaebf433SRyan Anderson appended after any matching localversion* files, and after the value 2236e5a5420SRobert P. J. Day set in CONFIG_LOCALVERSION. 224aaebf433SRyan Anderson 2250f9c608dSRasmus Villemoes (The actual string used here is the first 12 characters produced 2266e5a5420SRobert P. J. Day by running the command: 2276e5a5420SRobert P. J. Day 2286e5a5420SRobert P. J. Day $ git rev-parse --verify HEAD 2296e5a5420SRobert P. J. Day 2306e5a5420SRobert P. J. Day which is done within the script "scripts/setlocalversion".) 231aaebf433SRyan Anderson 2329afb719eSLaura Abbottconfig BUILD_SALT 2339afb719eSLaura Abbott string "Build ID Salt" 2349afb719eSLaura Abbott default "" 2359afb719eSLaura Abbott help 2369afb719eSLaura Abbott The build ID is used to link binaries and their debug info. Setting 2379afb719eSLaura Abbott this option will use the value in the calculation of the build id. 2389afb719eSLaura Abbott This is mostly useful for distributions which want to ensure the 2399afb719eSLaura Abbott build is unique between builds. It's safe to leave the default. 2409afb719eSLaura Abbott 2412e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_GZIP 2422e9f3bddSH. Peter Anvin bool 2432e9f3bddSH. Peter Anvin 2442e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_BZIP2 2452e9f3bddSH. Peter Anvin bool 2462e9f3bddSH. Peter Anvin 2472e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_LZMA 2482e9f3bddSH. Peter Anvin bool 2492e9f3bddSH. Peter Anvin 2503ebe1243SLasse Collinconfig HAVE_KERNEL_XZ 2513ebe1243SLasse Collin bool 2523ebe1243SLasse Collin 2537dd65febSAlbin Tonnerreconfig HAVE_KERNEL_LZO 2547dd65febSAlbin Tonnerre bool 2557dd65febSAlbin Tonnerre 256e76e1fdfSKyungsik Leeconfig HAVE_KERNEL_LZ4 257e76e1fdfSKyungsik Lee bool 258e76e1fdfSKyungsik Lee 25948f7ddf7SNick Terrellconfig HAVE_KERNEL_ZSTD 26048f7ddf7SNick Terrell bool 26148f7ddf7SNick Terrell 262f16466afSVasily Gorbikconfig HAVE_KERNEL_UNCOMPRESSED 263f16466afSVasily Gorbik bool 264f16466afSVasily Gorbik 26530d65dbfSAlain Knaffchoice 26630d65dbfSAlain Knaff prompt "Kernel compression mode" 26730d65dbfSAlain Knaff default KERNEL_GZIP 26848f7ddf7SNick 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 26930d65dbfSAlain Knaff help 27030d65dbfSAlain Knaff The linux kernel is a kind of self-extracting executable. 27130d65dbfSAlain Knaff Several compression algorithms are available, which differ 27230d65dbfSAlain Knaff in efficiency, compression and decompression speed. 27330d65dbfSAlain Knaff Compression speed is only relevant when building a kernel. 27430d65dbfSAlain Knaff Decompression speed is relevant at each boot. 27530d65dbfSAlain Knaff 27630d65dbfSAlain Knaff If you have any problems with bzip2 or lzma compressed 27730d65dbfSAlain Knaff kernels, mail me (Alain Knaff) <alain@knaff.lu>. (An older 27830d65dbfSAlain Knaff version of this functionality (bzip2 only), for 2.4, was 27930d65dbfSAlain Knaff supplied by Christian Ludwig) 28030d65dbfSAlain Knaff 28130d65dbfSAlain Knaff High compression options are mostly useful for users, who 28230d65dbfSAlain Knaff are low on disk space (embedded systems), but for whom ram 28330d65dbfSAlain Knaff size matters less. 28430d65dbfSAlain Knaff 28530d65dbfSAlain Knaff If in doubt, select 'gzip' 28630d65dbfSAlain Knaff 28730d65dbfSAlain Knaffconfig KERNEL_GZIP 28830d65dbfSAlain Knaff bool "Gzip" 2892e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_GZIP 29030d65dbfSAlain Knaff help 2917dd65febSAlbin Tonnerre The old and tried gzip compression. It provides a good balance 2927dd65febSAlbin Tonnerre between compression ratio and decompression speed. 29330d65dbfSAlain Knaff 29430d65dbfSAlain Knaffconfig KERNEL_BZIP2 29530d65dbfSAlain Knaff bool "Bzip2" 2962e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_BZIP2 29730d65dbfSAlain Knaff help 29830d65dbfSAlain Knaff Its compression ratio and speed is intermediate. 2990a4dd35cSRandy Dunlap Decompression speed is slowest among the choices. The kernel 3002e9f3bddSH. Peter Anvin size is about 10% smaller with bzip2, in comparison to gzip. 3012e9f3bddSH. Peter Anvin Bzip2 uses a large amount of memory. For modern kernels you 3022e9f3bddSH. Peter Anvin will need at least 8MB RAM or more for booting. 30330d65dbfSAlain Knaff 30430d65dbfSAlain Knaffconfig KERNEL_LZMA 30530d65dbfSAlain Knaff bool "LZMA" 3062e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_LZMA 30730d65dbfSAlain Knaff help 3080a4dd35cSRandy Dunlap This compression algorithm's ratio is best. Decompression speed 3090a4dd35cSRandy Dunlap is between gzip and bzip2. Compression is slowest. 3100a4dd35cSRandy Dunlap The kernel size is about 33% smaller with LZMA in comparison to gzip. 31130d65dbfSAlain Knaff 3123ebe1243SLasse Collinconfig KERNEL_XZ 3133ebe1243SLasse Collin bool "XZ" 3143ebe1243SLasse Collin depends on HAVE_KERNEL_XZ 3153ebe1243SLasse Collin help 3163ebe1243SLasse Collin XZ uses the LZMA2 algorithm and instruction set specific 3173ebe1243SLasse Collin BCJ filters which can improve compression ratio of executable 3183ebe1243SLasse Collin code. The size of the kernel is about 30% smaller with XZ in 3193ebe1243SLasse Collin comparison to gzip. On architectures for which there is a BCJ 3203ebe1243SLasse Collin filter (i386, x86_64, ARM, IA-64, PowerPC, and SPARC), XZ 3213ebe1243SLasse Collin will create a few percent smaller kernel than plain LZMA. 3223ebe1243SLasse Collin 3233ebe1243SLasse Collin The speed is about the same as with LZMA: The decompression 3243ebe1243SLasse Collin speed of XZ is better than that of bzip2 but worse than gzip 3253ebe1243SLasse Collin and LZO. Compression is slow. 3263ebe1243SLasse Collin 3277dd65febSAlbin Tonnerreconfig KERNEL_LZO 3287dd65febSAlbin Tonnerre bool "LZO" 3297dd65febSAlbin Tonnerre depends on HAVE_KERNEL_LZO 3307dd65febSAlbin Tonnerre help 3310a4dd35cSRandy Dunlap Its compression ratio is the poorest among the choices. The kernel 332681b3049SStephan Sperber size is about 10% bigger than gzip; however its speed 3337dd65febSAlbin Tonnerre (both compression and decompression) is the fastest. 3347dd65febSAlbin Tonnerre 335e76e1fdfSKyungsik Leeconfig KERNEL_LZ4 336e76e1fdfSKyungsik Lee bool "LZ4" 337e76e1fdfSKyungsik Lee depends on HAVE_KERNEL_LZ4 338e76e1fdfSKyungsik Lee help 339e76e1fdfSKyungsik Lee LZ4 is an LZ77-type compressor with a fixed, byte-oriented encoding. 340e76e1fdfSKyungsik Lee A preliminary version of LZ4 de/compression tool is available at 341e76e1fdfSKyungsik Lee <https://code.google.com/p/lz4/>. 342e76e1fdfSKyungsik Lee 343e76e1fdfSKyungsik Lee Its compression ratio is worse than LZO. The size of the kernel 344e76e1fdfSKyungsik Lee is about 8% bigger than LZO. But the decompression speed is 345e76e1fdfSKyungsik Lee faster than LZO. 346e76e1fdfSKyungsik Lee 34748f7ddf7SNick Terrellconfig KERNEL_ZSTD 34848f7ddf7SNick Terrell bool "ZSTD" 34948f7ddf7SNick Terrell depends on HAVE_KERNEL_ZSTD 35048f7ddf7SNick Terrell help 35148f7ddf7SNick Terrell ZSTD is a compression algorithm targeting intermediate compression 35248f7ddf7SNick Terrell with fast decompression speed. It will compress better than GZIP and 35348f7ddf7SNick Terrell decompress around the same speed as LZO, but slower than LZ4. You 35448f7ddf7SNick Terrell will need at least 192 KB RAM or more for booting. The zstd command 35548f7ddf7SNick Terrell line tool is required for compression. 35648f7ddf7SNick Terrell 357f16466afSVasily Gorbikconfig KERNEL_UNCOMPRESSED 358f16466afSVasily Gorbik bool "None" 359f16466afSVasily Gorbik depends on HAVE_KERNEL_UNCOMPRESSED 360f16466afSVasily Gorbik help 361f16466afSVasily Gorbik Produce uncompressed kernel image. This option is usually not what 362f16466afSVasily Gorbik you want. It is useful for debugging the kernel in slow simulation 363f16466afSVasily Gorbik environments, where decompressing and moving the kernel is awfully 364f16466afSVasily Gorbik slow. This option allows early boot code to skip the decompressor 365f16466afSVasily Gorbik and jump right at uncompressed kernel image. 366f16466afSVasily Gorbik 36730d65dbfSAlain Knaffendchoice 36830d65dbfSAlain Knaff 369ada4ab7aSChris Downconfig DEFAULT_INIT 370ada4ab7aSChris Down string "Default init path" 371ada4ab7aSChris Down default "" 372ada4ab7aSChris Down help 373ada4ab7aSChris Down This option determines the default init for the system if no init= 374ada4ab7aSChris Down option is passed on the kernel command line. If the requested path is 375ada4ab7aSChris Down not present, we will still then move on to attempting further 376ada4ab7aSChris Down locations (e.g. /sbin/init, etc). If this is empty, we will just use 377ada4ab7aSChris Down the fallback list when init= is not passed. 378ada4ab7aSChris Down 379bd5dc17bSJosh Triplettconfig DEFAULT_HOSTNAME 380bd5dc17bSJosh Triplett string "Default hostname" 381bd5dc17bSJosh Triplett default "(none)" 382bd5dc17bSJosh Triplett help 383bd5dc17bSJosh Triplett This option determines the default system hostname before userspace 384bd5dc17bSJosh Triplett calls sethostname(2). The kernel traditionally uses "(none)" here, 385bd5dc17bSJosh Triplett but you may wish to use a different default here to make a minimal 386bd5dc17bSJosh Triplett system more usable with less configuration. 387bd5dc17bSJosh Triplett 3881da177e4SLinus Torvaldsconfig SYSVIPC 3891da177e4SLinus Torvalds bool "System V IPC" 390a7f7f624SMasahiro Yamada help 3911da177e4SLinus Torvalds Inter Process Communication is a suite of library functions and 3921da177e4SLinus Torvalds system calls which let processes (running programs) synchronize and 3931da177e4SLinus Torvalds exchange information. It is generally considered to be a good thing, 3941da177e4SLinus Torvalds and some programs won't run unless you say Y here. In particular, if 3951da177e4SLinus Torvalds you want to run the DOS emulator dosemu under Linux (read the 3961da177e4SLinus Torvalds DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>), 3971da177e4SLinus Torvalds you'll need to say Y here. 3981da177e4SLinus Torvalds 3991da177e4SLinus Torvalds You can find documentation about IPC with "info ipc" and also in 4001da177e4SLinus Torvalds section 6.4 of the Linux Programmer's Guide, available from 4011da177e4SLinus Torvalds <http://www.tldp.org/guides.html>. 4021da177e4SLinus Torvalds 403a5494dcdSEric W. Biedermanconfig SYSVIPC_SYSCTL 404a5494dcdSEric W. Biederman bool 405a5494dcdSEric W. Biederman depends on SYSVIPC 406a5494dcdSEric W. Biederman depends on SYSCTL 407a5494dcdSEric W. Biederman default y 408a5494dcdSEric W. Biederman 4090cbed0eeSGuo Renconfig SYSVIPC_COMPAT 4100cbed0eeSGuo Ren def_bool y 4110cbed0eeSGuo Ren depends on COMPAT && SYSVIPC 4120cbed0eeSGuo Ren 4131da177e4SLinus Torvaldsconfig POSIX_MQUEUE 4141da177e4SLinus Torvalds bool "POSIX Message Queues" 41519c92399SKees Cook depends on NET 416a7f7f624SMasahiro Yamada help 4171da177e4SLinus Torvalds POSIX variant of message queues is a part of IPC. In POSIX message 4181da177e4SLinus Torvalds queues every message has a priority which decides about succession 4191da177e4SLinus Torvalds of receiving it by a process. If you want to compile and run 4201da177e4SLinus Torvalds programs written e.g. for Solaris with use of its POSIX message 421b0e37650SRobert P. J. Day queues (functions mq_*) say Y here. 4221da177e4SLinus Torvalds 4231da177e4SLinus Torvalds POSIX message queues are visible as a filesystem called 'mqueue' 4241da177e4SLinus Torvalds and can be mounted somewhere if you want to do filesystem 4251da177e4SLinus Torvalds operations on message queues. 4261da177e4SLinus Torvalds 4271da177e4SLinus Torvalds If unsure, say Y. 4281da177e4SLinus Torvalds 429bdc8e5f8SSerge E. Hallynconfig POSIX_MQUEUE_SYSCTL 430bdc8e5f8SSerge E. Hallyn bool 431bdc8e5f8SSerge E. Hallyn depends on POSIX_MQUEUE 432bdc8e5f8SSerge E. Hallyn depends on SYSCTL 433bdc8e5f8SSerge E. Hallyn default y 434bdc8e5f8SSerge E. Hallyn 435c73be61cSDavid Howellsconfig WATCH_QUEUE 436c73be61cSDavid Howells bool "General notification queue" 437c73be61cSDavid Howells default n 438c73be61cSDavid Howells help 439c73be61cSDavid Howells 440c73be61cSDavid Howells This is a general notification queue for the kernel to pass events to 441c73be61cSDavid Howells userspace by splicing them into pipes. It can be used in conjunction 442c73be61cSDavid Howells with watches for key/keyring change notifications and device 443c73be61cSDavid Howells notifications. 444c73be61cSDavid Howells 445c02b872aSMauro Carvalho Chehab See Documentation/core-api/watch_queue.rst 446c73be61cSDavid Howells 447226b4ccdSKonstantin Khlebnikovconfig CROSS_MEMORY_ATTACH 448226b4ccdSKonstantin Khlebnikov bool "Enable process_vm_readv/writev syscalls" 449226b4ccdSKonstantin Khlebnikov depends on MMU 450226b4ccdSKonstantin Khlebnikov default y 451226b4ccdSKonstantin Khlebnikov help 452226b4ccdSKonstantin Khlebnikov Enabling this option adds the system calls process_vm_readv and 453226b4ccdSKonstantin Khlebnikov process_vm_writev which allow a process with the correct privileges 454a2a368d9SGeert Uytterhoeven to directly read from or write to another process' address space. 455226b4ccdSKonstantin Khlebnikov See the man page for more details. 456226b4ccdSKonstantin Khlebnikov 45769369a70SJosh Triplettconfig USELIB 4587374fa33SKees Cook bool "uselib syscall (for libc5 and earlier)" 4597374fa33SKees Cook default ALPHA || M68K || SPARC 46069369a70SJosh Triplett help 46169369a70SJosh Triplett This option enables the uselib syscall, a system call used in the 46269369a70SJosh Triplett dynamic linker from libc5 and earlier. glibc does not use this 46369369a70SJosh Triplett system call. If you intend to run programs built on libc5 or 46469369a70SJosh Triplett earlier, you may need to enable this syscall. Current systems 46569369a70SJosh Triplett running glibc can safely disable this. 46669369a70SJosh Triplett 4671da177e4SLinus Torvaldsconfig AUDIT 4681da177e4SLinus Torvalds bool "Auditing support" 469804a6a49SChris Wright depends on NET 4701da177e4SLinus Torvalds help 4711da177e4SLinus Torvalds Enable auditing infrastructure that can be used with another 4721da177e4SLinus Torvalds kernel subsystem, such as SELinux (which requires this for 473cb74ed27SPaul Moore logging of avc messages output). System call auditing is included 474cb74ed27SPaul Moore on architectures which support it. 4751da177e4SLinus Torvalds 4767a017721SAKASHI Takahiroconfig HAVE_ARCH_AUDITSYSCALL 4777a017721SAKASHI Takahiro bool 4787a017721SAKASHI Takahiro 4791da177e4SLinus Torvaldsconfig AUDITSYSCALL 480cb74ed27SPaul Moore def_bool y 4817a017721SAKASHI Takahiro depends on AUDIT && HAVE_ARCH_AUDITSYSCALL 48228a3a7ebSEric Paris select FSNOTIFY 48374c3cbe3SAl Viro 484d9817ebeSThomas Gleixnersource "kernel/irq/Kconfig" 485764e0da1SThomas Gleixnersource "kernel/time/Kconfig" 486b24abcffSDaniel Borkmannsource "kernel/bpf/Kconfig" 48787a4c375SChristoph Hellwigsource "kernel/Kconfig.preempt" 488d9817ebeSThomas Gleixner 489391dc69cSFrederic Weisbeckermenu "CPU/Task time and stats accounting" 490391dc69cSFrederic Weisbecker 491abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING 492abf917cdSFrederic Weisbecker bool 493abf917cdSFrederic Weisbecker 494fdf9c356SFrederic Weisbeckerchoice 495fdf9c356SFrederic Weisbecker prompt "Cputime accounting" 49602382affSNicholas Piggin default TICK_CPU_ACCOUNTING 497fdf9c356SFrederic Weisbecker 498fdf9c356SFrederic Weisbecker# Kind of a stub config for the pure tick based cputime accounting 499fdf9c356SFrederic Weisbeckerconfig TICK_CPU_ACCOUNTING 500fdf9c356SFrederic Weisbecker bool "Simple tick based cputime accounting" 501c58b0df1SFrederic Weisbecker depends on !S390 && !NO_HZ_FULL 502fdf9c356SFrederic Weisbecker help 503fdf9c356SFrederic Weisbecker This is the basic tick based cputime accounting that maintains 504fdf9c356SFrederic Weisbecker statistics about user, system and idle time spent on per jiffies 505fdf9c356SFrederic Weisbecker granularity. 506fdf9c356SFrederic Weisbecker 507fdf9c356SFrederic Weisbecker If unsure, say Y. 508fdf9c356SFrederic Weisbecker 509abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_NATIVE 510391dc69cSFrederic Weisbecker bool "Deterministic task and CPU time accounting" 511c58b0df1SFrederic Weisbecker depends on HAVE_VIRT_CPU_ACCOUNTING && !NO_HZ_FULL 512abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 513391dc69cSFrederic Weisbecker help 514391dc69cSFrederic Weisbecker Select this option to enable more accurate task and CPU time 515391dc69cSFrederic Weisbecker accounting. This is done by reading a CPU counter on each 516391dc69cSFrederic Weisbecker kernel entry and exit and on transitions within the kernel 517391dc69cSFrederic Weisbecker between system, softirq and hardirq state, so there is a 518391dc69cSFrederic Weisbecker small performance impact. In the case of s390 or IBM POWER > 5, 519391dc69cSFrederic Weisbecker this also enables accounting of stolen time on logically-partitioned 520391dc69cSFrederic Weisbecker systems. 521391dc69cSFrederic Weisbecker 522abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_GEN 523abf917cdSFrederic Weisbecker bool "Full dynticks CPU time accounting" 52424a9c541SFrederic Weisbecker depends on HAVE_CONTEXT_TRACKING_USER 525554b0004SKevin Hilman depends on HAVE_VIRT_CPU_ACCOUNTING_GEN 526041a1574SArnd Bergmann depends on GENERIC_CLOCKEVENTS 527abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 52824a9c541SFrederic Weisbecker select CONTEXT_TRACKING_USER 529abf917cdSFrederic Weisbecker help 530abf917cdSFrederic Weisbecker Select this option to enable task and CPU time accounting on full 531abf917cdSFrederic Weisbecker dynticks systems. This accounting is implemented by watching every 532abf917cdSFrederic Weisbecker kernel-user boundaries using the context tracking subsystem. 533abf917cdSFrederic Weisbecker The accounting is thus performed at the expense of some significant 534abf917cdSFrederic Weisbecker overhead. 535abf917cdSFrederic Weisbecker 536abf917cdSFrederic Weisbecker For now this is only useful if you are working on the full 537abf917cdSFrederic Weisbecker dynticks subsystem development. 538abf917cdSFrederic Weisbecker 539abf917cdSFrederic Weisbecker If unsure, say N. 540abf917cdSFrederic Weisbecker 541b58c3584SRik van Rielendchoice 542b58c3584SRik van Riel 543fdf9c356SFrederic Weisbeckerconfig IRQ_TIME_ACCOUNTING 544fdf9c356SFrederic Weisbecker bool "Fine granularity task level IRQ time accounting" 545b58c3584SRik van Riel depends on HAVE_IRQ_TIME_ACCOUNTING && !VIRT_CPU_ACCOUNTING_NATIVE 546fdf9c356SFrederic Weisbecker help 547fdf9c356SFrederic Weisbecker Select this option to enable fine granularity task irq time 548fdf9c356SFrederic Weisbecker accounting. This is done by reading a timestamp on each 549fdf9c356SFrederic Weisbecker transitions between softirq and hardirq state, so there can be a 550fdf9c356SFrederic Weisbecker small performance impact. 551fdf9c356SFrederic Weisbecker 552fdf9c356SFrederic Weisbecker If in doubt, say N here. 553fdf9c356SFrederic Weisbecker 55411d4afd4SVincent Guittotconfig HAVE_SCHED_AVG_IRQ 55511d4afd4SVincent Guittot def_bool y 55611d4afd4SVincent Guittot depends on IRQ_TIME_ACCOUNTING || PARAVIRT_TIME_ACCOUNTING 55711d4afd4SVincent Guittot depends on SMP 55811d4afd4SVincent Guittot 559d4dbc991SVincent Guittotconfig SCHED_HW_PRESSURE 56098eb401dSValentin Schneider bool 561fcd7c9c3SValentin Schneider default y if ARM && ARM_CPU_TOPOLOGY 562fcd7c9c3SValentin Schneider default y if ARM64 56376504793SThara Gopinath depends on SMP 56498eb401dSValentin Schneider depends on CPU_FREQ_THERMAL 56598eb401dSValentin Schneider help 566d4dbc991SVincent Guittot Select this option to enable HW pressure accounting in the 567d4dbc991SVincent Guittot scheduler. HW pressure is the value conveyed to the scheduler 56898eb401dSValentin Schneider that reflects the reduction in CPU compute capacity resulted from 569d4dbc991SVincent Guittot HW throttling. HW throttling occurs when the performance of 570d4dbc991SVincent Guittot a CPU is capped due to high operating temperatures as an example. 57198eb401dSValentin Schneider 57298eb401dSValentin Schneider If selected, the scheduler will be able to balance tasks accordingly, 57398eb401dSValentin Schneider i.e. put less load on throttled CPUs than on non/less throttled ones. 57498eb401dSValentin Schneider 57598eb401dSValentin Schneider This requires the architecture to implement 576d4dbc991SVincent Guittot arch_update_hw_pressure() and arch_scale_thermal_pressure(). 57776504793SThara Gopinath 578391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT 579391dc69cSFrederic Weisbecker bool "BSD Process Accounting" 5802813893fSIulia Manda depends on MULTIUSER 581391dc69cSFrederic Weisbecker help 582391dc69cSFrederic Weisbecker If you say Y here, a user level program will be able to instruct the 583391dc69cSFrederic Weisbecker kernel (via a special system call) to write process accounting 584391dc69cSFrederic Weisbecker information to a file: whenever a process exits, information about 585391dc69cSFrederic Weisbecker that process will be appended to the file by the kernel. The 586391dc69cSFrederic Weisbecker information includes things such as creation time, owning user, 587391dc69cSFrederic Weisbecker command name, memory usage, controlling terminal etc. (the complete 588391dc69cSFrederic Weisbecker list is in the struct acct in <file:include/linux/acct.h>). It is 589391dc69cSFrederic Weisbecker up to the user level program to do useful things with this 590391dc69cSFrederic Weisbecker information. This is generally a good idea, so say Y. 591391dc69cSFrederic Weisbecker 592391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT_V3 593391dc69cSFrederic Weisbecker bool "BSD Process Accounting version 3 file format" 594391dc69cSFrederic Weisbecker depends on BSD_PROCESS_ACCT 595391dc69cSFrederic Weisbecker default n 596391dc69cSFrederic Weisbecker help 597391dc69cSFrederic Weisbecker If you say Y here, the process accounting information is written 598391dc69cSFrederic Weisbecker in a new file format that also logs the process IDs of each 5993903bf94SRandy Dunlap process and its parent. Note that this file format is incompatible 600391dc69cSFrederic Weisbecker with previous v0/v1/v2 file formats, so you will need updated tools 601391dc69cSFrederic Weisbecker for processing it. A preliminary version of these tools is available 602391dc69cSFrederic Weisbecker at <http://www.gnu.org/software/acct/>. 603391dc69cSFrederic Weisbecker 604391dc69cSFrederic Weisbeckerconfig TASKSTATS 60519c92399SKees Cook bool "Export task/process statistics through netlink" 606391dc69cSFrederic Weisbecker depends on NET 6072813893fSIulia Manda depends on MULTIUSER 608391dc69cSFrederic Weisbecker default n 609391dc69cSFrederic Weisbecker help 610391dc69cSFrederic Weisbecker Export selected statistics for tasks/processes through the 611391dc69cSFrederic Weisbecker generic netlink interface. Unlike BSD process accounting, the 612391dc69cSFrederic Weisbecker statistics are available during the lifetime of tasks/processes as 613391dc69cSFrederic Weisbecker responses to commands. Like BSD accounting, they are sent to user 614391dc69cSFrederic Weisbecker space on task exit. 615391dc69cSFrederic Weisbecker 616391dc69cSFrederic Weisbecker Say N if unsure. 617391dc69cSFrederic Weisbecker 618391dc69cSFrederic Weisbeckerconfig TASK_DELAY_ACCT 61919c92399SKees Cook bool "Enable per-task delay accounting" 620391dc69cSFrederic Weisbecker depends on TASKSTATS 621f6db8347SNaveen N. Rao select SCHED_INFO 622391dc69cSFrederic Weisbecker help 623391dc69cSFrederic Weisbecker Collect information on time spent by a task waiting for system 624391dc69cSFrederic Weisbecker resources like cpu, synchronous block I/O completion and swapping 625391dc69cSFrederic Weisbecker in pages. Such statistics can help in setting a task's priorities 626391dc69cSFrederic Weisbecker relative to other tasks for cpu, io, rss limits etc. 627391dc69cSFrederic Weisbecker 628391dc69cSFrederic Weisbecker Say N if unsure. 629391dc69cSFrederic Weisbecker 630391dc69cSFrederic Weisbeckerconfig TASK_XACCT 63119c92399SKees Cook bool "Enable extended accounting over taskstats" 632391dc69cSFrederic Weisbecker depends on TASKSTATS 633391dc69cSFrederic Weisbecker help 634391dc69cSFrederic Weisbecker Collect extended task accounting data and send the data 635391dc69cSFrederic Weisbecker to userland for processing over the taskstats interface. 636391dc69cSFrederic Weisbecker 637391dc69cSFrederic Weisbecker Say N if unsure. 638391dc69cSFrederic Weisbecker 639391dc69cSFrederic Weisbeckerconfig TASK_IO_ACCOUNTING 64019c92399SKees Cook bool "Enable per-task storage I/O accounting" 641391dc69cSFrederic Weisbecker depends on TASK_XACCT 642391dc69cSFrederic Weisbecker help 643391dc69cSFrederic Weisbecker Collect information on the number of bytes of storage I/O which this 644391dc69cSFrederic Weisbecker task has caused. 645391dc69cSFrederic Weisbecker 646391dc69cSFrederic Weisbecker Say N if unsure. 647391dc69cSFrederic Weisbecker 648eb414681SJohannes Weinerconfig PSI 649eb414681SJohannes Weiner bool "Pressure stall information tracking" 65098dfdd9eSRandy Dunlap select KERNFS 651eb414681SJohannes Weiner help 652eb414681SJohannes Weiner Collect metrics that indicate how overcommitted the CPU, memory, 653eb414681SJohannes Weiner and IO capacity are in the system. 654eb414681SJohannes Weiner 655eb414681SJohannes Weiner If you say Y here, the kernel will create /proc/pressure/ with the 656eb414681SJohannes Weiner pressure statistics files cpu, memory, and io. These will indicate 657eb414681SJohannes Weiner the share of walltime in which some or all tasks in the system are 658eb414681SJohannes Weiner delayed due to contention of the respective resource. 659eb414681SJohannes Weiner 6602ce7135aSJohannes Weiner In kernels with cgroup support, cgroups (cgroup2 only) will 6612ce7135aSJohannes Weiner have cpu.pressure, memory.pressure, and io.pressure files, 6622ce7135aSJohannes Weiner which aggregate pressure stalls for the grouped tasks only. 6632ce7135aSJohannes Weiner 664c3123552SMauro Carvalho Chehab For more details see Documentation/accounting/psi.rst. 665eb414681SJohannes Weiner 666eb414681SJohannes Weiner Say N if unsure. 667eb414681SJohannes Weiner 668e0c27447SJohannes Weinerconfig PSI_DEFAULT_DISABLED 669e0c27447SJohannes Weiner bool "Require boot parameter to enable pressure stall information tracking" 670e0c27447SJohannes Weiner default n 671e0c27447SJohannes Weiner depends on PSI 672e0c27447SJohannes Weiner help 673e0c27447SJohannes Weiner If set, pressure stall information tracking will be disabled 674428a1cb4SBaruch Siach per default but can be enabled through passing psi=1 on the 675428a1cb4SBaruch Siach kernel commandline during boot. 676e0c27447SJohannes Weiner 6777b2489d3SJohannes Weiner This feature adds some code to the task wakeup and sleep 6787b2489d3SJohannes Weiner paths of the scheduler. The overhead is too low to affect 6797b2489d3SJohannes Weiner common scheduling-intense workloads in practice (such as 6807b2489d3SJohannes Weiner webservers, memcache), but it does show up in artificial 6817b2489d3SJohannes Weiner scheduler stress tests, such as hackbench. 6827b2489d3SJohannes Weiner 6837b2489d3SJohannes Weiner If you are paranoid and not sure what the kernel will be 6847b2489d3SJohannes Weiner used for, say Y. 6857b2489d3SJohannes Weiner 6867b2489d3SJohannes Weiner Say N if unsure. 6877b2489d3SJohannes Weiner 688391dc69cSFrederic Weisbeckerendmenu # "CPU/Task time and stats accounting" 689391dc69cSFrederic Weisbecker 6905c4991e2SFrederic Weisbeckerconfig CPU_ISOLATION 6915c4991e2SFrederic Weisbecker bool "CPU isolation" 692414a2dc1SGeert Uytterhoeven depends on SMP || COMPILE_TEST 6932c43838cSFrederic Weisbecker default y 6945c4991e2SFrederic Weisbecker help 6955c4991e2SFrederic Weisbecker Make sure that CPUs running critical tasks are not disturbed by 6965c4991e2SFrederic Weisbecker any source of "noise" such as unbound workqueues, timers, kthreads... 6972c43838cSFrederic Weisbecker Unbound jobs get offloaded to housekeeping CPUs. This is driven by 6982c43838cSFrederic Weisbecker the "isolcpus=" boot parameter. 6992c43838cSFrederic Weisbecker 7002c43838cSFrederic Weisbecker Say Y if unsure. 7015c4991e2SFrederic Weisbecker 7020af92d46SPaul E. McKenneysource "kernel/rcu/Kconfig" 703c903ff83SMike Travis 7041da177e4SLinus Torvaldsconfig IKCONFIG 705f2443ab6SRoss Biro tristate "Kernel .config support" 706a7f7f624SMasahiro Yamada help 7071da177e4SLinus Torvalds This option enables the complete Linux kernel ".config" file 7081da177e4SLinus Torvalds contents to be saved in the kernel. It provides documentation 7091da177e4SLinus Torvalds of which kernel options are used in a running kernel or in an 7101da177e4SLinus Torvalds on-disk kernel. This information can be extracted from the kernel 7111da177e4SLinus Torvalds image file with the script scripts/extract-ikconfig and used as 7121da177e4SLinus Torvalds input to rebuild the current kernel or to build another kernel. 7131da177e4SLinus Torvalds It can also be extracted from a running kernel by reading 7141da177e4SLinus Torvalds /proc/config.gz if enabled (below). 7151da177e4SLinus Torvalds 7161da177e4SLinus Torvaldsconfig IKCONFIG_PROC 7171da177e4SLinus Torvalds bool "Enable access to .config through /proc/config.gz" 7181da177e4SLinus Torvalds depends on IKCONFIG && PROC_FS 719a7f7f624SMasahiro Yamada help 7201da177e4SLinus Torvalds This option enables access to the kernel configuration file 7211da177e4SLinus Torvalds through /proc/config.gz. 7221da177e4SLinus Torvalds 723f7b101d3SJoel Fernandes (Google)config IKHEADERS 724f7b101d3SJoel Fernandes (Google) tristate "Enable kernel headers through /sys/kernel/kheaders.tar.xz" 725f7b101d3SJoel Fernandes (Google) depends on SYSFS 72643d8ce9dSJoel Fernandes (Google) help 727f7b101d3SJoel Fernandes (Google) This option enables access to the in-kernel headers that are generated during 728f7b101d3SJoel Fernandes (Google) the build process. These can be used to build eBPF tracing programs, 729f7b101d3SJoel Fernandes (Google) or similar programs. If you build the headers as a module, a module called 730f7b101d3SJoel Fernandes (Google) kheaders.ko is built which can be loaded on-demand to get access to headers. 73143d8ce9dSJoel Fernandes (Google) 732794543a2SAlistair John Strachanconfig LOG_BUF_SHIFT 733794543a2SAlistair John Strachan int "Kernel log buffer size (16 => 64KB, 17 => 128KB)" 7341c4b5ecbSChristoph Hellwig range 12 25 735f17a32e9SAdrian Bunk default 17 736361e9dfbSJosh Triplett depends on PRINTK 737794543a2SAlistair John Strachan help 73823b2899fSLuis R. Rodriguez Select the minimal kernel log buffer size as a power of 2. 73923b2899fSLuis R. Rodriguez The final size is affected by LOG_CPU_MAX_BUF_SHIFT config 74023b2899fSLuis R. Rodriguez parameter, see below. Any higher size also might be forced 74123b2899fSLuis R. Rodriguez by "log_buf_len" boot parameter. 74223b2899fSLuis R. Rodriguez 743f17a32e9SAdrian Bunk Examples: 744f17a32e9SAdrian Bunk 17 => 128 KB 745f17a32e9SAdrian Bunk 16 => 64 KB 746f17a32e9SAdrian Bunk 15 => 32 KB 747f17a32e9SAdrian Bunk 14 => 16 KB 748794543a2SAlistair John Strachan 13 => 8 KB 749794543a2SAlistair John Strachan 12 => 4 KB 750794543a2SAlistair John Strachan 75123b2899fSLuis R. Rodriguezconfig LOG_CPU_MAX_BUF_SHIFT 75223b2899fSLuis R. Rodriguez int "CPU kernel log buffer size contribution (13 => 8 KB, 17 => 128KB)" 7532240a31dSGeert Uytterhoeven depends on SMP 75423b2899fSLuis R. Rodriguez range 0 21 75523b2899fSLuis R. Rodriguez default 0 if BASE_SMALL 756320bf431SYoann Congal default 12 757361e9dfbSJosh Triplett depends on PRINTK 75823b2899fSLuis R. Rodriguez help 75923b2899fSLuis R. Rodriguez This option allows to increase the default ring buffer size 76023b2899fSLuis R. Rodriguez according to the number of CPUs. The value defines the contribution 76123b2899fSLuis R. Rodriguez of each CPU as a power of 2. The used space is typically only few 76223b2899fSLuis R. Rodriguez lines however it might be much more when problems are reported, 76323b2899fSLuis R. Rodriguez e.g. backtraces. 76423b2899fSLuis R. Rodriguez 76523b2899fSLuis R. Rodriguez The increased size means that a new buffer has to be allocated and 76623b2899fSLuis R. Rodriguez the original static one is unused. It makes sense only on systems 76723b2899fSLuis R. Rodriguez with more CPUs. Therefore this value is used only when the sum of 76823b2899fSLuis R. Rodriguez contributions is greater than the half of the default kernel ring 76923b2899fSLuis R. Rodriguez buffer as defined by LOG_BUF_SHIFT. The default values are set 7700f7636e1SPaul Menzel so that more than 16 CPUs are needed to trigger the allocation. 77123b2899fSLuis R. Rodriguez 77223b2899fSLuis R. Rodriguez Also this option is ignored when "log_buf_len" kernel parameter is 77323b2899fSLuis R. Rodriguez used as it forces an exact (power of two) size of the ring buffer. 77423b2899fSLuis R. Rodriguez 77523b2899fSLuis R. Rodriguez The number of possible CPUs is used for this computation ignoring 7765e0d8d59SGeert Uytterhoeven hotplugging making the computation optimal for the worst case 7775e0d8d59SGeert Uytterhoeven scenario while allowing a simple algorithm to be used from bootup. 77823b2899fSLuis R. Rodriguez 77923b2899fSLuis R. Rodriguez Examples shift values and their meaning: 78023b2899fSLuis R. Rodriguez 17 => 128 KB for each CPU 78123b2899fSLuis R. Rodriguez 16 => 64 KB for each CPU 78223b2899fSLuis R. Rodriguez 15 => 32 KB for each CPU 78323b2899fSLuis R. Rodriguez 14 => 16 KB for each CPU 78423b2899fSLuis R. Rodriguez 13 => 8 KB for each CPU 78523b2899fSLuis R. Rodriguez 12 => 4 KB for each CPU 78623b2899fSLuis R. Rodriguez 78733701557SChris Downconfig PRINTK_INDEX 78833701557SChris Down bool "Printk indexing debugfs interface" 78933701557SChris Down depends on PRINTK && DEBUG_FS 79033701557SChris Down help 79133701557SChris Down Add support for indexing of all printk formats known at compile time 79233701557SChris Down at <debugfs>/printk/index/<module>. 79333701557SChris Down 79433701557SChris Down This can be used as part of maintaining daemons which monitor 79533701557SChris Down /dev/kmsg, as it permits auditing the printk formats present in a 79633701557SChris Down kernel, allowing detection of cases where monitored printks are 79733701557SChris Down changed or no longer present. 79833701557SChris Down 79933701557SChris Down There is no additional runtime cost to printk with this enabled. 80033701557SChris Down 8015cdc38f9SKAMEZAWA Hiroyuki# 8025cdc38f9SKAMEZAWA Hiroyuki# Architectures with an unreliable sched_clock() should select this: 8035cdc38f9SKAMEZAWA Hiroyuki# 8045cdc38f9SKAMEZAWA Hiroyukiconfig HAVE_UNSTABLE_SCHED_CLOCK 8055cdc38f9SKAMEZAWA Hiroyuki bool 8065cdc38f9SKAMEZAWA Hiroyuki 80738ff87f7SStephen Boydconfig GENERIC_SCHED_CLOCK 80838ff87f7SStephen Boyd bool 80938ff87f7SStephen Boyd 81069842cbaSPatrick Bellasimenu "Scheduler features" 81169842cbaSPatrick Bellasi 81269842cbaSPatrick Bellasiconfig UCLAMP_TASK 81369842cbaSPatrick Bellasi bool "Enable utilization clamping for RT/FAIR tasks" 81469842cbaSPatrick Bellasi depends on CPU_FREQ_GOV_SCHEDUTIL 81569842cbaSPatrick Bellasi help 81669842cbaSPatrick Bellasi This feature enables the scheduler to track the clamped utilization 81769842cbaSPatrick Bellasi of each CPU based on RUNNABLE tasks scheduled on that CPU. 81869842cbaSPatrick Bellasi 81969842cbaSPatrick Bellasi With this option, the user can specify the min and max CPU 82069842cbaSPatrick Bellasi utilization allowed for RUNNABLE tasks. The max utilization defines 82169842cbaSPatrick Bellasi the maximum frequency a task should use while the min utilization 82269842cbaSPatrick Bellasi defines the minimum frequency it should use. 82369842cbaSPatrick Bellasi 82469842cbaSPatrick Bellasi Both min and max utilization clamp values are hints to the scheduler, 82569842cbaSPatrick Bellasi aiming at improving its frequency selection policy, but they do not 82669842cbaSPatrick Bellasi enforce or grant any specific bandwidth for tasks. 82769842cbaSPatrick Bellasi 82869842cbaSPatrick Bellasi If in doubt, say N. 82969842cbaSPatrick Bellasi 83069842cbaSPatrick Bellasiconfig UCLAMP_BUCKETS_COUNT 83169842cbaSPatrick Bellasi int "Number of supported utilization clamp buckets" 83269842cbaSPatrick Bellasi range 5 20 83369842cbaSPatrick Bellasi default 5 83469842cbaSPatrick Bellasi depends on UCLAMP_TASK 83569842cbaSPatrick Bellasi help 83669842cbaSPatrick Bellasi Defines the number of clamp buckets to use. The range of each bucket 83769842cbaSPatrick Bellasi will be SCHED_CAPACITY_SCALE/UCLAMP_BUCKETS_COUNT. The higher the 83869842cbaSPatrick Bellasi number of clamp buckets the finer their granularity and the higher 83969842cbaSPatrick Bellasi the precision of clamping aggregation and tracking at run-time. 84069842cbaSPatrick Bellasi 84169842cbaSPatrick Bellasi For example, with the minimum configuration value we will have 5 84269842cbaSPatrick Bellasi clamp buckets tracking 20% utilization each. A 25% boosted tasks will 84369842cbaSPatrick Bellasi be refcounted in the [20..39]% bucket and will set the bucket clamp 84469842cbaSPatrick Bellasi effective value to 25%. 84569842cbaSPatrick Bellasi If a second 30% boosted task should be co-scheduled on the same CPU, 84669842cbaSPatrick Bellasi that task will be refcounted in the same bucket of the first task and 84769842cbaSPatrick Bellasi it will boost the bucket clamp effective value to 30%. 84869842cbaSPatrick Bellasi The clamp effective value of a bucket is reset to its nominal value 84969842cbaSPatrick Bellasi (20% in the example above) when there are no more tasks refcounted in 85069842cbaSPatrick Bellasi that bucket. 85169842cbaSPatrick Bellasi 85269842cbaSPatrick Bellasi An additional boost/capping margin can be added to some tasks. In the 85369842cbaSPatrick Bellasi example above the 25% task will be boosted to 30% until it exits the 85469842cbaSPatrick Bellasi CPU. If that should be considered not acceptable on certain systems, 85569842cbaSPatrick Bellasi it's always possible to reduce the margin by increasing the number of 85669842cbaSPatrick Bellasi clamp buckets to trade off used memory for run-time tracking 85769842cbaSPatrick Bellasi precision. 85869842cbaSPatrick Bellasi 85969842cbaSPatrick Bellasi If in doubt, use the default value. 86069842cbaSPatrick Bellasi 86169842cbaSPatrick Bellasiendmenu 86269842cbaSPatrick Bellasi 863be3a7284SAndrea Arcangeli# 864be3a7284SAndrea Arcangeli# For architectures that want to enable the support for NUMA-affine scheduler 865be3a7284SAndrea Arcangeli# balancing logic: 866be3a7284SAndrea Arcangeli# 867be3a7284SAndrea Arcangeliconfig ARCH_SUPPORTS_NUMA_BALANCING 868be3a7284SAndrea Arcangeli bool 869be3a7284SAndrea Arcangeli 870be5e610cSPeter Zijlstra# 87172b252aeSMel Gorman# For architectures that prefer to flush all TLBs after a number of pages 87272b252aeSMel Gorman# are unmapped instead of sending one IPI per page to flush. The architecture 87372b252aeSMel Gorman# must provide guarantees on what happens if a clean TLB cache entry is 87472b252aeSMel Gorman# written after the unmap. Details are in mm/rmap.c near the check for 87572b252aeSMel Gorman# should_defer_flush. The architecture should also consider if the full flush 87672b252aeSMel Gorman# and the refill costs are offset by the savings of sending fewer IPIs. 87772b252aeSMel Gormanconfig ARCH_WANT_BATCHED_UNMAP_TLB_FLUSH 87872b252aeSMel Gorman bool 87972b252aeSMel Gorman 880c12d3362SArd Biesheuvelconfig CC_HAS_INT128 8813a7c7331SMasahiro Yamada def_bool !$(cc-option,$(m64-flag) -D__SIZEOF_INT128__=0) && 64BIT 882c12d3362SArd Biesheuvel 883dee2b702SGustavo A. R. Silvaconfig CC_IMPLICIT_FALLTHROUGH 884dee2b702SGustavo A. R. Silva string 885158ea2d2SGustavo A. R. Silva default "-Wimplicit-fallthrough=5" if CC_IS_GCC && $(cc-option,-Wimplicit-fallthrough=5) 886dee2b702SGustavo A. R. Silva default "-Wimplicit-fallthrough" if CC_IS_CLANG && $(cc-option,-Wunreachable-code-fallthrough) 887dee2b702SGustavo A. R. Silva 8883e00f580SKees Cook# Currently, disable gcc-10+ array-bounds globally. 8890da6e5fdSLinus Torvalds# It's still broken in gcc-13, so no upper bound yet. 8903e00f580SKees Cookconfig GCC10_NO_ARRAY_BOUNDS 8915a41237aSLinus Torvalds def_bool y 8925a41237aSLinus Torvalds 893f0be87c4SLinus Torvaldsconfig CC_NO_ARRAY_BOUNDS 894f0be87c4SLinus Torvalds bool 8958e5bd4eaSYury Norov default y if CC_IS_GCC && GCC_VERSION >= 90000 && GCC10_NO_ARRAY_BOUNDS 896f0be87c4SLinus Torvalds 89702153319SLinus Torvalds# Currently, disable -Wstringop-overflow for GCC globally. 89802153319SLinus Torvaldsconfig GCC_NO_STRINGOP_OVERFLOW 899a5e0ace0SGustavo A. R. Silva def_bool y 900a5e0ace0SGustavo A. R. Silva 901a5e0ace0SGustavo A. R. Silvaconfig CC_NO_STRINGOP_OVERFLOW 902a5e0ace0SGustavo A. R. Silva bool 90302153319SLinus Torvalds default y if CC_IS_GCC && GCC_NO_STRINGOP_OVERFLOW 904a5e0ace0SGustavo A. R. Silva 905a5e0ace0SGustavo A. R. Silvaconfig CC_STRINGOP_OVERFLOW 906a5e0ace0SGustavo A. R. Silva bool 907a5e0ace0SGustavo A. R. Silva default y if CC_IS_GCC && !CC_NO_STRINGOP_OVERFLOW 908a5e0ace0SGustavo A. R. Silva 90972b252aeSMel Gorman# 910be5e610cSPeter Zijlstra# For architectures that know their GCC __int128 support is sound 911be5e610cSPeter Zijlstra# 912be5e610cSPeter Zijlstraconfig ARCH_SUPPORTS_INT128 913be5e610cSPeter Zijlstra bool 914be5e610cSPeter Zijlstra 915be3a7284SAndrea Arcangeli# For architectures that (ab)use NUMA to represent different memory regions 916be3a7284SAndrea Arcangeli# all cpu-local but of different latencies, such as SuperH. 917be3a7284SAndrea Arcangeli# 918be3a7284SAndrea Arcangeliconfig ARCH_WANT_NUMA_VARIABLE_LOCALITY 919be3a7284SAndrea Arcangeli bool 920be3a7284SAndrea Arcangeli 921be3a7284SAndrea Arcangeliconfig NUMA_BALANCING 922be3a7284SAndrea Arcangeli bool "Memory placement aware NUMA scheduler" 923be3a7284SAndrea Arcangeli depends on ARCH_SUPPORTS_NUMA_BALANCING 924be3a7284SAndrea Arcangeli depends on !ARCH_WANT_NUMA_VARIABLE_LOCALITY 925554b0f3cSSebastian Andrzej Siewior depends on SMP && NUMA && MIGRATION && !PREEMPT_RT 926be3a7284SAndrea Arcangeli help 927be3a7284SAndrea Arcangeli This option adds support for automatic NUMA aware memory/task placement. 928be3a7284SAndrea Arcangeli The mechanism is quite primitive and is based on migrating memory when 9296d56a410SPaul Gortmaker it has references to the node the task is running on. 930be3a7284SAndrea Arcangeli 931be3a7284SAndrea Arcangeli This system will be inactive on UMA systems. 932be3a7284SAndrea Arcangeli 9336f7c97e8SAneesh Kumar K.Vconfig NUMA_BALANCING_DEFAULT_ENABLED 9346f7c97e8SAneesh Kumar K.V bool "Automatically enable NUMA aware memory/task placement" 9356f7c97e8SAneesh Kumar K.V default y 9366f7c97e8SAneesh Kumar K.V depends on NUMA_BALANCING 9376f7c97e8SAneesh Kumar K.V help 9386f7c97e8SAneesh Kumar K.V If set, automatic NUMA balancing will be enabled if running on a NUMA 9396f7c97e8SAneesh Kumar K.V machine. 9406f7c97e8SAneesh Kumar K.V 94121c690a3SSuren Baghdasaryanconfig SLAB_OBJ_EXT 94221c690a3SSuren Baghdasaryan bool 94321c690a3SSuren Baghdasaryan 94423964d2dSLi Zefanmenuconfig CGROUPS 9456341e62bSChristoph Jaeger bool "Control Group support" 9462bd59d48STejun Heo select KERNFS 947ddbcc7e8SPaul Menage help 94823964d2dSLi Zefan This option adds support for grouping sets of processes together, for 9495cdc38f9SKAMEZAWA Hiroyuki use with process control subsystems such as Cpusets, CFS, memory 9505cdc38f9SKAMEZAWA Hiroyuki controls or device isolation. 9515cdc38f9SKAMEZAWA Hiroyuki See 952d6a3b247SMauro Carvalho Chehab - Documentation/scheduler/sched-design-CFS.rst (CFS) 953da82c92fSMauro Carvalho Chehab - Documentation/admin-guide/cgroup-v1/ (features for grouping, isolation 95445ce80fbSLi Zefan and resource control) 955ddbcc7e8SPaul Menage 956ddbcc7e8SPaul Menage Say N if unsure. 957ddbcc7e8SPaul Menage 95823964d2dSLi Zefanif CGROUPS 95923964d2dSLi Zefan 9603e32cb2eSJohannes Weinerconfig PAGE_COUNTER 9613e32cb2eSJohannes Weiner bool 9623e32cb2eSJohannes Weiner 9636a010a49STejun Heoconfig CGROUP_FAVOR_DYNMODS 9646a010a49STejun Heo bool "Favor dynamic modification latency reduction by default" 9656a010a49STejun Heo help 9666a010a49STejun Heo This option enables the "favordynmods" mount option by default 9676a010a49STejun Heo which reduces the latencies of dynamic cgroup modifications such 9686a010a49STejun Heo as task migrations and controller on/offs at the cost of making 9696a010a49STejun Heo hot path operations such as forks and exits more expensive. 9706a010a49STejun Heo 9716a010a49STejun Heo Say N if unsure. 9726a010a49STejun Heo 973c255a458SAndrew Mortonconfig MEMCG 974a0166ec4SJohannes Weiner bool "Memory controller" 9753e32cb2eSJohannes Weiner select PAGE_COUNTER 97679bd9814STejun Heo select EVENTFD 97721c690a3SSuren Baghdasaryan select SLAB_OBJ_EXT 97800f0b825SBalbir Singh help 979a0166ec4SJohannes Weiner Provides control over the memory footprint of tasks in a cgroup. 98000f0b825SBalbir Singh 981e93d4166SRoman Gushchinconfig MEMCG_V1 982e93d4166SRoman Gushchin bool "Legacy cgroup v1 memory controller" 983c9929f0eSVlastimil Babka depends on MEMCG 984e93d4166SRoman Gushchin default n 985e93d4166SRoman Gushchin help 986e93d4166SRoman Gushchin Legacy cgroup v1 memory controller which has been deprecated by 987e93d4166SRoman Gushchin cgroup v2 implementation. The v1 is there for legacy applications 988e93d4166SRoman Gushchin which haven't migrated to the new cgroup v2 interface yet. If you 989e93d4166SRoman Gushchin do not have any such application then you are completely fine leaving 990e93d4166SRoman Gushchin this option disabled. 991e93d4166SRoman Gushchin 992e93d4166SRoman Gushchin Please note that feature set of the legacy memory controller is likely 993e93d4166SRoman Gushchin going to shrink due to deprecation process. New deployments with v1 994e93d4166SRoman Gushchin controller are highly discouraged. 995e93d4166SRoman Gushchin 996e93d4166SRoman Gushchin San N is unsure. 99784c07d11SKirill Tkhai 9986bf024e6SJohannes Weinerconfig BLK_CGROUP 9996bf024e6SJohannes Weiner bool "IO controller" 10006bf024e6SJohannes Weiner depends on BLOCK 10012bc64a20SAneesh Kumar K.V default n 1002a7f7f624SMasahiro Yamada help 10036bf024e6SJohannes Weiner Generic block IO controller cgroup interface. This is the common 10046bf024e6SJohannes Weiner cgroup interface which should be used by various IO controlling 10056bf024e6SJohannes Weiner policies. 10062bc64a20SAneesh Kumar K.V 10076bf024e6SJohannes Weiner Currently, CFQ IO scheduler uses it to recognize task groups and 10086bf024e6SJohannes Weiner control disk bandwidth allocation (proportional time slice allocation) 10096bf024e6SJohannes Weiner to such task groups. It is also used by bio throttling logic in 10106bf024e6SJohannes Weiner block layer to implement upper limit in IO rates on a device. 1011e5d1367fSStephane Eranian 10126bf024e6SJohannes Weiner This option only enables generic Block IO controller infrastructure. 10136bf024e6SJohannes Weiner One needs to also enable actual IO controlling logic/policy. For 10146bf024e6SJohannes Weiner enabling proportional weight division of disk bandwidth in CFQ, set 10157baf2199SKrzysztof Kozlowski CONFIG_BFQ_GROUP_IOSCHED=y; for enabling throttling policy, set 10166bf024e6SJohannes Weiner CONFIG_BLK_DEV_THROTTLING=y. 10176bf024e6SJohannes Weiner 1018da82c92fSMauro Carvalho Chehab See Documentation/admin-guide/cgroup-v1/blkio-controller.rst for more information. 10196bf024e6SJohannes Weiner 10206bf024e6SJohannes Weinerconfig CGROUP_WRITEBACK 10216bf024e6SJohannes Weiner bool 10226bf024e6SJohannes Weiner depends on MEMCG && BLK_CGROUP 10236bf024e6SJohannes Weiner default y 1024e5d1367fSStephane Eranian 10257c941438SDhaval Gianimenuconfig CGROUP_SCHED 1026a0166ec4SJohannes Weiner bool "CPU controller" 10277c941438SDhaval Giani default n 10287c941438SDhaval Giani help 10297c941438SDhaval Giani This feature lets CPU scheduler recognize task groups and control CPU 10307c941438SDhaval Giani bandwidth allocation to such task groups. It uses cgroups to group 10317c941438SDhaval Giani tasks. 10327c941438SDhaval Giani 10337c941438SDhaval Gianiif CGROUP_SCHED 10347c941438SDhaval Gianiconfig FAIR_GROUP_SCHED 10357c941438SDhaval Giani bool "Group scheduling for SCHED_OTHER" 10367c941438SDhaval Giani depends on CGROUP_SCHED 10377c941438SDhaval Giani default CGROUP_SCHED 10387c941438SDhaval Giani 1039ab84d31eSPaul Turnerconfig CFS_BANDWIDTH 1040ab84d31eSPaul Turner bool "CPU bandwidth provisioning for FAIR_GROUP_SCHED" 1041ab84d31eSPaul Turner depends on FAIR_GROUP_SCHED 1042ab84d31eSPaul Turner default n 1043ab84d31eSPaul Turner help 1044ab84d31eSPaul Turner This option allows users to define CPU bandwidth rates (limits) for 1045ab84d31eSPaul Turner tasks running within the fair group scheduler. Groups with no limit 1046ab84d31eSPaul Turner set are considered to be unconstrained and will run with no 1047ab84d31eSPaul Turner restriction. 1048d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-bwc.rst for more information. 1049ab84d31eSPaul Turner 10507c941438SDhaval Gianiconfig RT_GROUP_SCHED 10517c941438SDhaval Giani bool "Group scheduling for SCHED_RR/FIFO" 10527c941438SDhaval Giani depends on CGROUP_SCHED 10537c941438SDhaval Giani default n 10547c941438SDhaval Giani help 10557c941438SDhaval Giani This feature lets you explicitly allocate real CPU bandwidth 105632bd7eb5SLi Zefan to task groups. If enabled, it will also make it impossible to 10577c941438SDhaval Giani schedule realtime tasks for non-root users until you allocate 10587c941438SDhaval Giani realtime bandwidth for them. 1059d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-rt-group.rst for more information. 10607c941438SDhaval Giani 10617c941438SDhaval Gianiendif #CGROUP_SCHED 10627c941438SDhaval Giani 1063af7f588dSMathieu Desnoyersconfig SCHED_MM_CID 1064af7f588dSMathieu Desnoyers def_bool y 1065af7f588dSMathieu Desnoyers depends on SMP && RSEQ 1066af7f588dSMathieu Desnoyers 10672480c093SPatrick Bellasiconfig UCLAMP_TASK_GROUP 10682480c093SPatrick Bellasi bool "Utilization clamping per group of tasks" 10692480c093SPatrick Bellasi depends on CGROUP_SCHED 10702480c093SPatrick Bellasi depends on UCLAMP_TASK 10712480c093SPatrick Bellasi default n 10722480c093SPatrick Bellasi help 10732480c093SPatrick Bellasi This feature enables the scheduler to track the clamped utilization 10742480c093SPatrick Bellasi of each CPU based on RUNNABLE tasks currently scheduled on that CPU. 10752480c093SPatrick Bellasi 10762480c093SPatrick Bellasi When this option is enabled, the user can specify a min and max 10772480c093SPatrick Bellasi CPU bandwidth which is allowed for each single task in a group. 10782480c093SPatrick Bellasi The max bandwidth allows to clamp the maximum frequency a task 10792480c093SPatrick Bellasi can use, while the min bandwidth allows to define a minimum 10802480c093SPatrick Bellasi frequency a task will always use. 10812480c093SPatrick Bellasi 10822480c093SPatrick Bellasi When task group based utilization clamping is enabled, an eventually 10832480c093SPatrick Bellasi specified task-specific clamp value is constrained by the cgroup 10842480c093SPatrick Bellasi specified clamp value. Both minimum and maximum task clamping cannot 10852480c093SPatrick Bellasi be bigger than the corresponding clamping defined at task group level. 10862480c093SPatrick Bellasi 10872480c093SPatrick Bellasi If in doubt, say N. 10882480c093SPatrick Bellasi 10896bf024e6SJohannes Weinerconfig CGROUP_PIDS 10906bf024e6SJohannes Weiner bool "PIDs controller" 10916bf024e6SJohannes Weiner help 10926bf024e6SJohannes Weiner Provides enforcement of process number limits in the scope of a 10936bf024e6SJohannes Weiner cgroup. Any attempt to fork more processes than is allowed in the 10946bf024e6SJohannes Weiner cgroup will fail. PIDs are fundamentally a global resource because it 10956bf024e6SJohannes Weiner is fairly trivial to reach PID exhaustion before you reach even a 10966bf024e6SJohannes Weiner conservative kmemcg limit. As a result, it is possible to grind a 10976bf024e6SJohannes Weiner system to halt without being limited by other cgroup policies. The 10986cc578dfSParav Pandit PIDs controller is designed to stop this from happening. 10996bf024e6SJohannes Weiner 11006bf024e6SJohannes Weiner It should be noted that organisational operations (such as attaching 110198076833SJonathan Neuschäfer to a cgroup hierarchy) will *not* be blocked by the PIDs controller, 11026bf024e6SJohannes Weiner since the PIDs limit only affects a process's ability to fork, not to 11036bf024e6SJohannes Weiner attach to a cgroup. 11046bf024e6SJohannes Weiner 110539d3e758SParav Panditconfig CGROUP_RDMA 110639d3e758SParav Pandit bool "RDMA controller" 110739d3e758SParav Pandit help 110839d3e758SParav Pandit Provides enforcement of RDMA resources defined by IB stack. 110939d3e758SParav Pandit It is fairly easy for consumers to exhaust RDMA resources, which 111039d3e758SParav Pandit can result into resource unavailability to other consumers. 111139d3e758SParav Pandit RDMA controller is designed to stop this from happening. 111239d3e758SParav Pandit Attaching processes with active RDMA resources to the cgroup 111339d3e758SParav Pandit hierarchy is allowed even if can cross the hierarchy's limit. 111439d3e758SParav Pandit 11156bf024e6SJohannes Weinerconfig CGROUP_FREEZER 11166bf024e6SJohannes Weiner bool "Freezer controller" 11176bf024e6SJohannes Weiner help 11186bf024e6SJohannes Weiner Provides a way to freeze and unfreeze all tasks in a 11196bf024e6SJohannes Weiner cgroup. 11206bf024e6SJohannes Weiner 1121489c2a20SJohannes Weiner This option affects the ORIGINAL cgroup interface. The cgroup2 memory 1122489c2a20SJohannes Weiner controller includes important in-kernel memory consumers per default. 1123489c2a20SJohannes Weiner 1124489c2a20SJohannes Weiner If you're using cgroup2, say N. 1125489c2a20SJohannes Weiner 11266bf024e6SJohannes Weinerconfig CGROUP_HUGETLB 11276bf024e6SJohannes Weiner bool "HugeTLB controller" 11286bf024e6SJohannes Weiner depends on HUGETLB_PAGE 11296bf024e6SJohannes Weiner select PAGE_COUNTER 1130afc24d49SVivek Goyal default n 11316bf024e6SJohannes Weiner help 11326bf024e6SJohannes Weiner Provides a cgroup controller for HugeTLB pages. 11336bf024e6SJohannes Weiner When you enable this, you can put a per cgroup limit on HugeTLB usage. 11346bf024e6SJohannes Weiner The limit is enforced during page fault. Since HugeTLB doesn't 11356bf024e6SJohannes Weiner support page reclaim, enforcing the limit at page fault time implies 11366bf024e6SJohannes Weiner that, the application will get SIGBUS signal if it tries to access 11376bf024e6SJohannes Weiner HugeTLB pages beyond its limit. This requires the application to know 11386bf024e6SJohannes Weiner beforehand how much HugeTLB pages it would require for its use. The 11396bf024e6SJohannes Weiner control group is tracked in the third page lru pointer. This means 11406bf024e6SJohannes Weiner that we cannot use the controller with huge page less than 3 pages. 1141afc24d49SVivek Goyal 11426bf024e6SJohannes Weinerconfig CPUSETS 11436bf024e6SJohannes Weiner bool "Cpuset controller" 1144e1d4eeecSNicolas Pitre depends on SMP 11456bf024e6SJohannes Weiner help 11466bf024e6SJohannes Weiner This option will let you create and manage CPUSETs which 11476bf024e6SJohannes Weiner allow dynamically partitioning a system into sets of CPUs and 11486bf024e6SJohannes Weiner Memory Nodes and assigning tasks to run only within those sets. 11496bf024e6SJohannes Weiner This is primarily useful on large SMP or NUMA systems. 1150afc24d49SVivek Goyal 11516bf024e6SJohannes Weiner Say N if unsure. 1152afc24d49SVivek Goyal 11536bf024e6SJohannes Weinerconfig PROC_PID_CPUSET 11546bf024e6SJohannes Weiner bool "Include legacy /proc/<pid>/cpuset file" 11556bf024e6SJohannes Weiner depends on CPUSETS 115689e9b9e0STejun Heo default y 115789e9b9e0STejun Heo 11586bf024e6SJohannes Weinerconfig CGROUP_DEVICE 11596bf024e6SJohannes Weiner bool "Device controller" 11606bf024e6SJohannes Weiner help 11616bf024e6SJohannes Weiner Provides a cgroup controller implementing whitelists for 11626bf024e6SJohannes Weiner devices which a process in the cgroup can mknod or open. 11636bf024e6SJohannes Weiner 11646bf024e6SJohannes Weinerconfig CGROUP_CPUACCT 11656bf024e6SJohannes Weiner bool "Simple CPU accounting controller" 11666bf024e6SJohannes Weiner help 11676bf024e6SJohannes Weiner Provides a simple controller for monitoring the 11686bf024e6SJohannes Weiner total CPU consumed by the tasks in a cgroup. 11696bf024e6SJohannes Weiner 11706bf024e6SJohannes Weinerconfig CGROUP_PERF 11716bf024e6SJohannes Weiner bool "Perf controller" 11726bf024e6SJohannes Weiner depends on PERF_EVENTS 11736bf024e6SJohannes Weiner help 11746bf024e6SJohannes Weiner This option extends the perf per-cpu mode to restrict monitoring 11756bf024e6SJohannes Weiner to threads which belong to the cgroup specified and run on the 11766546b19fSNamhyung Kim designated cpu. Or this can be used to have cgroup ID in samples 11776546b19fSNamhyung Kim so that it can monitor performance events among cgroups. 11786bf024e6SJohannes Weiner 11796bf024e6SJohannes Weiner Say N if unsure. 11806bf024e6SJohannes Weiner 118130070984SDaniel Mackconfig CGROUP_BPF 118230070984SDaniel Mack bool "Support for eBPF programs attached to cgroups" 1183483c4933SAndy Lutomirski depends on BPF_SYSCALL 1184483c4933SAndy Lutomirski select SOCK_CGROUP_DATA 118530070984SDaniel Mack help 118630070984SDaniel Mack Allow attaching eBPF programs to a cgroup using the bpf(2) 118730070984SDaniel Mack syscall command BPF_PROG_ATTACH. 118830070984SDaniel Mack 118930070984SDaniel Mack In which context these programs are accessed depends on the type 119030070984SDaniel Mack of attachment. For instance, programs that are attached using 119130070984SDaniel Mack BPF_CGROUP_INET_INGRESS will be executed on the ingress path of 119230070984SDaniel Mack inet sockets. 119330070984SDaniel Mack 1194a72232eaSVipin Sharmaconfig CGROUP_MISC 1195a72232eaSVipin Sharma bool "Misc resource controller" 1196a72232eaSVipin Sharma default n 1197a72232eaSVipin Sharma help 1198a72232eaSVipin Sharma Provides a controller for miscellaneous resources on a host. 1199a72232eaSVipin Sharma 1200a72232eaSVipin Sharma Miscellaneous scalar resources are the resources on the host system 1201a72232eaSVipin Sharma which cannot be abstracted like the other cgroups. This controller 1202a72232eaSVipin Sharma tracks and limits the miscellaneous resources used by a process 1203a72232eaSVipin Sharma attached to a cgroup hierarchy. 1204a72232eaSVipin Sharma 1205a72232eaSVipin Sharma For more information, please check misc cgroup section in 1206a72232eaSVipin Sharma /Documentation/admin-guide/cgroup-v2.rst. 1207a72232eaSVipin Sharma 12086bf024e6SJohannes Weinerconfig CGROUP_DEBUG 120923b0be48SWaiman Long bool "Debug controller" 12106bf024e6SJohannes Weiner default n 121123b0be48SWaiman Long depends on DEBUG_KERNEL 12126bf024e6SJohannes Weiner help 12136bf024e6SJohannes Weiner This option enables a simple controller that exports 121423b0be48SWaiman Long debugging information about the cgroups framework. This 121523b0be48SWaiman Long controller is for control cgroup debugging only. Its 121623b0be48SWaiman Long interfaces are not stable. 12176bf024e6SJohannes Weiner 12186bf024e6SJohannes Weiner Say N. 12196bf024e6SJohannes Weiner 122073b35147SArnd Bergmannconfig SOCK_CGROUP_DATA 122173b35147SArnd Bergmann bool 122273b35147SArnd Bergmann default n 122373b35147SArnd Bergmann 122423964d2dSLi Zefanendif # CGROUPS 1225c077719bSKAMEZAWA Hiroyuki 12268dd2a82cSDaniel Lezcanomenuconfig NAMESPACES 12276a108a14SDavid Rientjes bool "Namespaces support" if EXPERT 12282813893fSIulia Manda depends on MULTIUSER 12296a108a14SDavid Rientjes default !EXPERT 1230c5289a69SPavel Emelyanov help 1231c5289a69SPavel Emelyanov Provides the way to make tasks work with different objects using 1232c5289a69SPavel Emelyanov the same id. For example same IPC id may refer to different objects 1233c5289a69SPavel Emelyanov or same user id or pid may refer to different tasks when used in 1234c5289a69SPavel Emelyanov different namespaces. 1235c5289a69SPavel Emelyanov 12368dd2a82cSDaniel Lezcanoif NAMESPACES 12378dd2a82cSDaniel Lezcano 123858bfdd6dSPavel Emelyanovconfig UTS_NS 123958bfdd6dSPavel Emelyanov bool "UTS namespace" 124017a6d441SDaniel Lezcano default y 124158bfdd6dSPavel Emelyanov help 124258bfdd6dSPavel Emelyanov In this namespace tasks see different info provided with the 124358bfdd6dSPavel Emelyanov uname() system call 124458bfdd6dSPavel Emelyanov 1245769071acSAndrei Vaginconfig TIME_NS 1246769071acSAndrei Vagin bool "TIME namespace" 1247660fd04fSThomas Gleixner depends on GENERIC_VDSO_TIME_NS 1248769071acSAndrei Vagin default y 1249769071acSAndrei Vagin help 1250769071acSAndrei Vagin In this namespace boottime and monotonic clocks can be set. 1251769071acSAndrei Vagin The time will keep going with the same pace. 1252769071acSAndrei Vagin 1253ae5e1b22SPavel Emelyanovconfig IPC_NS 1254ae5e1b22SPavel Emelyanov bool "IPC namespace" 12558dd2a82cSDaniel Lezcano depends on (SYSVIPC || POSIX_MQUEUE) 125617a6d441SDaniel Lezcano default y 1257ae5e1b22SPavel Emelyanov help 1258ae5e1b22SPavel Emelyanov In this namespace tasks work with IPC ids which correspond to 1259614b84cfSSerge E. Hallyn different IPC objects in different namespaces. 1260ae5e1b22SPavel Emelyanov 1261aee16ce7SPavel Emelyanovconfig USER_NS 126219c92399SKees Cook bool "User namespace" 12635673a94cSEric W. Biederman default n 1264aee16ce7SPavel Emelyanov help 1265aee16ce7SPavel Emelyanov This allows containers, i.e. vservers, to use user namespaces 1266aee16ce7SPavel Emelyanov to provide different user info for different servers. 1267e11f0ae3SEric W. Biederman 1268e11f0ae3SEric W. Biederman When user namespaces are enabled in the kernel it is 1269d886f4e4SJohannes Weiner recommended that the MEMCG option also be enabled and that 1270d886f4e4SJohannes Weiner user-space use the memory control groups to limit the amount 1271d886f4e4SJohannes Weiner of memory a memory unprivileged users can use. 1272e11f0ae3SEric W. Biederman 1273aee16ce7SPavel Emelyanov If unsure, say N. 1274aee16ce7SPavel Emelyanov 127574bd59bbSPavel Emelyanovconfig PID_NS 12769bd38c2cSDaniel Lezcano bool "PID Namespaces" 127717a6d441SDaniel Lezcano default y 127874bd59bbSPavel Emelyanov help 127912d2b8f9SHeikki Orsila Support process id namespaces. This allows having multiple 1280692105b8SMatt LaPlante processes with the same pid as long as they are in different 128174bd59bbSPavel Emelyanov pid namespaces. This is a building block of containers. 128274bd59bbSPavel Emelyanov 1283d6eb633fSMatt Helsleyconfig NET_NS 1284d6eb633fSMatt Helsley bool "Network namespace" 12858dd2a82cSDaniel Lezcano depends on NET 128617a6d441SDaniel Lezcano default y 1287d6eb633fSMatt Helsley help 1288d6eb633fSMatt Helsley Allow user space to create what appear to be multiple instances 1289d6eb633fSMatt Helsley of the network stack. 1290d6eb633fSMatt Helsley 12918dd2a82cSDaniel Lezcanoendif # NAMESPACES 12928dd2a82cSDaniel Lezcano 12935cb366bbSAdrian Reberconfig CHECKPOINT_RESTORE 12945cb366bbSAdrian Reber bool "Checkpoint/restore support" 129530341ec9SRen Zhijie depends on PROC_FS 12965cb366bbSAdrian Reber select PROC_CHILDREN 1297bfe3911aSChris Wilson select KCMP 12985cb366bbSAdrian Reber default n 12995cb366bbSAdrian Reber help 13005cb366bbSAdrian Reber Enables additional kernel features in a sake of checkpoint/restore. 13015cb366bbSAdrian Reber In particular it adds auxiliary prctl codes to setup process text, 13025cb366bbSAdrian Reber data and heap segment sizes, and a few additional /proc filesystem 13035cb366bbSAdrian Reber entries. 13045cb366bbSAdrian Reber 13055cb366bbSAdrian Reber If unsure, say N here. 13065cb366bbSAdrian Reber 13075091faa4SMike Galbraithconfig SCHED_AUTOGROUP 13085091faa4SMike Galbraith bool "Automatic process group scheduling" 13095091faa4SMike Galbraith select CGROUPS 13105091faa4SMike Galbraith select CGROUP_SCHED 13115091faa4SMike Galbraith select FAIR_GROUP_SCHED 13125091faa4SMike Galbraith help 13135091faa4SMike Galbraith This option optimizes the scheduler for common desktop workloads by 13145091faa4SMike Galbraith automatically creating and populating task groups. This separation 13155091faa4SMike Galbraith of workloads isolates aggressive CPU burners (like build jobs) from 13165091faa4SMike Galbraith desktop applications. Task group autogeneration is currently based 13175091faa4SMike Galbraith upon task session. 13185091faa4SMike Galbraith 13197af37becSDaniel Lezcanoconfig RELAY 13207af37becSDaniel Lezcano bool "Kernel->user space relay support (formerly relayfs)" 132126b5679eSPeter Zijlstra select IRQ_WORK 13227af37becSDaniel Lezcano help 13237af37becSDaniel Lezcano This option enables support for relay interface support in 13247af37becSDaniel Lezcano certain file systems (such as debugfs). 13257af37becSDaniel Lezcano It is designed to provide an efficient mechanism for tools and 13267af37becSDaniel Lezcano facilities to relay large amounts of data from kernel space to 13277af37becSDaniel Lezcano user space. 13287af37becSDaniel Lezcano 13297af37becSDaniel Lezcano If unsure, say N. 13307af37becSDaniel Lezcano 1331f991633dSDimitri Gorokhovikconfig BLK_DEV_INITRD 1332f991633dSDimitri Gorokhovik bool "Initial RAM filesystem and RAM disk (initramfs/initrd) support" 1333f991633dSDimitri Gorokhovik help 1334f991633dSDimitri Gorokhovik The initial RAM filesystem is a ramfs which is loaded by the 1335f991633dSDimitri Gorokhovik boot loader (loadlin or lilo) and that is mounted as root 1336f991633dSDimitri Gorokhovik before the normal boot procedure. It is typically used to 1337f991633dSDimitri Gorokhovik load modules needed to mount the "real" root file system, 13388c27ceffSMauro Carvalho Chehab etc. See <file:Documentation/admin-guide/initrd.rst> for details. 1339f991633dSDimitri Gorokhovik 1340f991633dSDimitri Gorokhovik If RAM disk support (BLK_DEV_RAM) is also included, this 1341f991633dSDimitri Gorokhovik also enables initial RAM disk (initrd) support and adds 1342f991633dSDimitri Gorokhovik 15 Kbytes (more on some other architectures) to the kernel size. 1343f991633dSDimitri Gorokhovik 1344f991633dSDimitri Gorokhovik If unsure say Y. 1345f991633dSDimitri Gorokhovik 1346c33df4eaSJean-Paul Samanif BLK_DEV_INITRD 1347c33df4eaSJean-Paul Saman 1348dbec4866SSam Ravnborgsource "usr/Kconfig" 1349dbec4866SSam Ravnborg 1350c33df4eaSJean-Paul Samanendif 1351c33df4eaSJean-Paul Saman 135276db5a27SMasami Hiramatsuconfig BOOT_CONFIG 135376db5a27SMasami Hiramatsu bool "Boot config support" 1354a2a9d67aSMasami Hiramatsu select BLK_DEV_INITRD if !BOOT_CONFIG_EMBED 135576db5a27SMasami Hiramatsu help 135676db5a27SMasami Hiramatsu Extra boot config allows system admin to pass a config file as 135776db5a27SMasami Hiramatsu complemental extension of kernel cmdline when booting. 13580947db01SMasami Hiramatsu The boot config file must be attached at the end of initramfs 135985c46b78SMasami Hiramatsu with checksum, size and magic word. 13600947db01SMasami Hiramatsu See <file:Documentation/admin-guide/bootconfig.rst> for details. 136176db5a27SMasami Hiramatsu 136276db5a27SMasami Hiramatsu If unsure, say Y. 136376db5a27SMasami Hiramatsu 1364b743852cSPaul E. McKenneyconfig BOOT_CONFIG_FORCE 1365b743852cSPaul E. McKenney bool "Force unconditional bootconfig processing" 1366b743852cSPaul E. McKenney depends on BOOT_CONFIG 13676ded8a28SPaul E. McKenney default y if BOOT_CONFIG_EMBED 1368b743852cSPaul E. McKenney help 1369b743852cSPaul E. McKenney With this Kconfig option set, BOOT_CONFIG processing is carried 1370b743852cSPaul E. McKenney out even when the "bootconfig" kernel-boot parameter is omitted. 1371b743852cSPaul E. McKenney In fact, with this Kconfig option set, there is no way to 1372b743852cSPaul E. McKenney make the kernel ignore the BOOT_CONFIG-supplied kernel-boot 1373b743852cSPaul E. McKenney parameters. 1374b743852cSPaul E. McKenney 1375b743852cSPaul E. McKenney If unsure, say N. 1376b743852cSPaul E. McKenney 1377a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED 1378a2a9d67aSMasami Hiramatsu bool "Embed bootconfig file in the kernel" 1379a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG 1380a2a9d67aSMasami Hiramatsu help 1381a2a9d67aSMasami Hiramatsu Embed a bootconfig file given by BOOT_CONFIG_EMBED_FILE in the 1382a2a9d67aSMasami Hiramatsu kernel. Usually, the bootconfig file is loaded with the initrd 1383a2a9d67aSMasami Hiramatsu image. But if the system doesn't support initrd, this option will 1384a2a9d67aSMasami Hiramatsu help you by embedding a bootconfig file while building the kernel. 1385a2a9d67aSMasami Hiramatsu 1386a2a9d67aSMasami Hiramatsu If unsure, say N. 1387a2a9d67aSMasami Hiramatsu 1388a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED_FILE 1389a2a9d67aSMasami Hiramatsu string "Embedded bootconfig file path" 1390a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG_EMBED 1391a2a9d67aSMasami Hiramatsu help 1392a2a9d67aSMasami Hiramatsu Specify a bootconfig file which will be embedded to the kernel. 1393a2a9d67aSMasami Hiramatsu This bootconfig will be used if there is no initrd or no other 1394a2a9d67aSMasami Hiramatsu bootconfig in the initrd. 1395a2a9d67aSMasami Hiramatsu 13961274aea1SDavid Disseldorpconfig INITRAMFS_PRESERVE_MTIME 13971274aea1SDavid Disseldorp bool "Preserve cpio archive mtimes in initramfs" 13981274aea1SDavid Disseldorp default y 13991274aea1SDavid Disseldorp help 14001274aea1SDavid Disseldorp Each entry in an initramfs cpio archive carries an mtime value. When 14011274aea1SDavid Disseldorp enabled, extracted cpio items take this mtime, with directory mtime 14021274aea1SDavid Disseldorp setting deferred until after creation of any child entries. 14031274aea1SDavid Disseldorp 14041274aea1SDavid Disseldorp If unsure, say Y. 14051274aea1SDavid Disseldorp 1406877417e6SArnd Bergmannchoice 1407877417e6SArnd Bergmann prompt "Compiler optimization level" 14082cc3ce24SUlf Magnusson default CC_OPTIMIZE_FOR_PERFORMANCE 1409877417e6SArnd Bergmann 1410877417e6SArnd Bergmannconfig CC_OPTIMIZE_FOR_PERFORMANCE 141115f5db60SMasahiro Yamada bool "Optimize for performance (-O2)" 1412877417e6SArnd Bergmann help 1413877417e6SArnd Bergmann This is the default optimization level for the kernel, building 1414877417e6SArnd Bergmann with the "-O2" compiler flag for best performance and most 1415877417e6SArnd Bergmann helpful compile-time warnings. 1416877417e6SArnd Bergmann 1417c45b4f1fSLinus Torvaldsconfig CC_OPTIMIZE_FOR_SIZE 141815f5db60SMasahiro Yamada bool "Optimize for size (-Os)" 1419c45b4f1fSLinus Torvalds help 1420ce3b487fSMasahiro Yamada Choosing this option will pass "-Os" to your compiler resulting 1421ce3b487fSMasahiro Yamada in a smaller kernel. 1422c45b4f1fSLinus Torvalds 1423877417e6SArnd Bergmannendchoice 1424877417e6SArnd Bergmann 14255d20ee31SNicholas Pigginconfig HAVE_LD_DEAD_CODE_DATA_ELIMINATION 14265d20ee31SNicholas Piggin bool 14275d20ee31SNicholas Piggin help 14285d20ee31SNicholas Piggin This requires that the arch annotates or otherwise protects 14295d20ee31SNicholas Piggin its external entry points from being discarded. Linker scripts 14305d20ee31SNicholas Piggin must also merge .text.*, .data.*, and .bss.* correctly into 14315d20ee31SNicholas Piggin output sections. Care must be taken not to pull in unrelated 14325d20ee31SNicholas Piggin sections (e.g., '.text.init'). Typically '.' in section names 14335d20ee31SNicholas Piggin is used to distinguish them from label names / C identifiers. 14345d20ee31SNicholas Piggin 14355d20ee31SNicholas Pigginconfig LD_DEAD_CODE_DATA_ELIMINATION 14365d20ee31SNicholas Piggin bool "Dead code and data elimination (EXPERIMENTAL)" 14375d20ee31SNicholas Piggin depends on HAVE_LD_DEAD_CODE_DATA_ELIMINATION 14385d20ee31SNicholas Piggin depends on EXPERT 1439e85d1d65SMasahiro Yamada depends on $(cc-option,-ffunction-sections -fdata-sections) 1440e85d1d65SMasahiro Yamada depends on $(ld-option,--gc-sections) 14415d20ee31SNicholas Piggin help 14428b9d2712SMasahiro Yamada Enable this if you want to do dead code and data elimination with 14438b9d2712SMasahiro Yamada the linker by compiling with -ffunction-sections -fdata-sections, 14448b9d2712SMasahiro Yamada and linking with --gc-sections. 14455d20ee31SNicholas Piggin 14465d20ee31SNicholas Piggin This can reduce on disk and in-memory size of the kernel 14475d20ee31SNicholas Piggin code and static data, particularly for small configs and 14485d20ee31SNicholas Piggin on small systems. This has the possibility of introducing 14495d20ee31SNicholas Piggin silently broken kernel if the required annotations are not 14505d20ee31SNicholas Piggin present. This option is not well tested yet, so use at your 14515d20ee31SNicholas Piggin own risk. 14525d20ee31SNicholas Piggin 145359612b24SNathan Chancellorconfig LD_ORPHAN_WARN 145459612b24SNathan Chancellor def_bool y 145559612b24SNathan Chancellor depends on ARCH_WANT_LD_ORPHAN_WARN 145659612b24SNathan Chancellor depends on $(ld-option,--orphan-handling=warn) 1457e1789d7cSXin Li depends on $(ld-option,--orphan-handling=error) 1458e1789d7cSXin Li 1459e1789d7cSXin Liconfig LD_ORPHAN_WARN_LEVEL 1460e1789d7cSXin Li string 1461e1789d7cSXin Li depends on LD_ORPHAN_WARN 1462e1789d7cSXin Li default "error" if WERROR 1463e1789d7cSXin Li default "warn" 146459612b24SNathan Chancellor 14650847062aSRandy Dunlapconfig SYSCTL 14660847062aSRandy Dunlap bool 14670847062aSRandy Dunlap 1468657a5209SMike Frysingerconfig HAVE_UID16 1469657a5209SMike Frysinger bool 1470657a5209SMike Frysinger 1471657a5209SMike Frysingerconfig SYSCTL_EXCEPTION_TRACE 1472657a5209SMike Frysinger bool 1473657a5209SMike Frysinger help 1474657a5209SMike Frysinger Enable support for /proc/sys/debug/exception-trace. 1475657a5209SMike Frysinger 1476657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_NO_WARN 1477657a5209SMike Frysinger bool 1478657a5209SMike Frysinger help 1479657a5209SMike Frysinger Enable support for /proc/sys/kernel/ignore-unaligned-usertrap 1480657a5209SMike Frysinger Allows arch to define/use @no_unaligned_warning to possibly warn 1481657a5209SMike Frysinger about unaligned access emulation going on under the hood. 1482657a5209SMike Frysinger 1483657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_ALLOW 1484657a5209SMike Frysinger bool 1485657a5209SMike Frysinger help 1486657a5209SMike Frysinger Enable support for /proc/sys/kernel/unaligned-trap 1487657a5209SMike Frysinger Allows arches to define/use @unaligned_enabled to runtime toggle 1488657a5209SMike Frysinger the unaligned access emulation. 1489657a5209SMike Frysinger see arch/parisc/kernel/unaligned.c for reference 1490657a5209SMike Frysinger 1491657a5209SMike Frysingerconfig HAVE_PCSPKR_PLATFORM 1492657a5209SMike Frysinger bool 1493657a5209SMike Frysinger 14946a108a14SDavid Rientjesmenuconfig EXPERT 14956a108a14SDavid Rientjes bool "Configure standard kernel features (expert users)" 1496f505c553SJosh Triplett # Unhide debug options, to make the on-by-default options visible 1497f505c553SJosh Triplett select DEBUG_KERNEL 14981da177e4SLinus Torvalds help 14991da177e4SLinus Torvalds This option allows certain base kernel options and settings 15001da177e4SLinus Torvalds to be disabled or tweaked. This is for specialized 15011da177e4SLinus Torvalds environments which can tolerate a "non-standard" kernel. 15021da177e4SLinus Torvalds Only use this if you really know what you are doing. 15031da177e4SLinus Torvalds 1504ae81f9e3SChuck Ebbertconfig UID16 15056a108a14SDavid Rientjes bool "Enable 16-bit UID system calls" if EXPERT 15062813893fSIulia Manda depends on HAVE_UID16 && MULTIUSER 1507ae81f9e3SChuck Ebbert default y 1508ae81f9e3SChuck Ebbert help 1509ae81f9e3SChuck Ebbert This enables the legacy 16-bit UID syscall wrappers. 1510ae81f9e3SChuck Ebbert 15112813893fSIulia Mandaconfig MULTIUSER 15122813893fSIulia Manda bool "Multiple users, groups and capabilities support" if EXPERT 15132813893fSIulia Manda default y 15142813893fSIulia Manda help 15152813893fSIulia Manda This option enables support for non-root users, groups and 15162813893fSIulia Manda capabilities. 15172813893fSIulia Manda 15182813893fSIulia Manda If you say N here, all processes will run with UID 0, GID 0, and all 15192813893fSIulia Manda possible capabilities. Saying N here also compiles out support for 15202813893fSIulia Manda system calls related to UIDs, GIDs, and capabilities, such as setuid, 15212813893fSIulia Manda setgid, and capset. 15222813893fSIulia Manda 15232813893fSIulia Manda If unsure, say Y here. 15242813893fSIulia Manda 1525f6187769SFabian Frederickconfig SGETMASK_SYSCALL 1526f6187769SFabian Frederick bool "sgetmask/ssetmask syscalls support" if EXPERT 1527cd14b018SMasahiro Yamada default PARISC || M68K || PPC || MIPS || X86 || SPARC || MICROBLAZE || SUPERH 1528a7f7f624SMasahiro Yamada help 1529f6187769SFabian Frederick sys_sgetmask and sys_ssetmask are obsolete system calls 1530f6187769SFabian Frederick no longer supported in libc but still enabled by default in some 1531f6187769SFabian Frederick architectures. 1532f6187769SFabian Frederick 1533f6187769SFabian Frederick If unsure, leave the default option here. 1534f6187769SFabian Frederick 15356af9f7bfSFabian Frederickconfig SYSFS_SYSCALL 15366af9f7bfSFabian Frederick bool "Sysfs syscall support" if EXPERT 15376af9f7bfSFabian Frederick default y 1538a7f7f624SMasahiro Yamada help 15396af9f7bfSFabian Frederick sys_sysfs is an obsolete system call no longer supported in libc. 15406af9f7bfSFabian Frederick Note that disabling this option is more secure but might break 15416af9f7bfSFabian Frederick compatibility with some systems. 15426af9f7bfSFabian Frederick 15436af9f7bfSFabian Frederick If unsure say Y here. 15446af9f7bfSFabian Frederick 1545d1b069f5SRandy Dunlapconfig FHANDLE 1546d1b069f5SRandy Dunlap bool "open by fhandle syscalls" if EXPERT 1547d1b069f5SRandy Dunlap select EXPORTFS 1548d1b069f5SRandy Dunlap default y 1549d1b069f5SRandy Dunlap help 1550d1b069f5SRandy Dunlap If you say Y here, a user level program will be able to map 1551d1b069f5SRandy Dunlap file names to handle and then later use the handle for 1552d1b069f5SRandy Dunlap different file system operations. This is useful in implementing 1553d1b069f5SRandy Dunlap userspace file servers, which now track files using handles instead 1554d1b069f5SRandy Dunlap of names. The handle would remain the same even if file names 1555d1b069f5SRandy Dunlap get renamed. Enables open_by_handle_at(2) and name_to_handle_at(2) 1556d1b069f5SRandy Dunlap syscalls. 1557d1b069f5SRandy Dunlap 1558baa73d9eSNicolas Pitreconfig POSIX_TIMERS 1559baa73d9eSNicolas Pitre bool "Posix Clocks & timers" if EXPERT 1560baa73d9eSNicolas Pitre default y 1561baa73d9eSNicolas Pitre help 1562baa73d9eSNicolas Pitre This includes native support for POSIX timers to the kernel. 1563baa73d9eSNicolas Pitre Some embedded systems have no use for them and therefore they 1564baa73d9eSNicolas Pitre can be configured out to reduce the size of the kernel image. 1565baa73d9eSNicolas Pitre 1566baa73d9eSNicolas Pitre When this option is disabled, the following syscalls won't be 1567baa73d9eSNicolas Pitre available: timer_create, timer_gettime: timer_getoverrun, 1568baa73d9eSNicolas Pitre timer_settime, timer_delete, clock_adjtime, getitimer, 1569baa73d9eSNicolas Pitre setitimer, alarm. Furthermore, the clock_settime, clock_gettime, 1570baa73d9eSNicolas Pitre clock_getres and clock_nanosleep syscalls will be limited to 1571baa73d9eSNicolas Pitre CLOCK_REALTIME, CLOCK_MONOTONIC and CLOCK_BOOTTIME only. 1572baa73d9eSNicolas Pitre 1573baa73d9eSNicolas Pitre If unsure say y. 1574baa73d9eSNicolas Pitre 1575d59745ceSMatt Mackallconfig PRINTK 1576d59745ceSMatt Mackall default y 15776a108a14SDavid Rientjes bool "Enable support for printk" if EXPERT 157874876a98SFrederic Weisbecker select IRQ_WORK 1579d59745ceSMatt Mackall help 1580d59745ceSMatt Mackall This option enables normal printk support. Removing it 1581d59745ceSMatt Mackall eliminates most of the message strings from the kernel image 1582d59745ceSMatt Mackall and makes the kernel more or less silent. As this makes it 1583d59745ceSMatt Mackall very difficult to diagnose system problems, saying N here is 1584d59745ceSMatt Mackall strongly discouraged. 1585d59745ceSMatt Mackall 1586c8538a7aSMatt Mackallconfig BUG 15876a108a14SDavid Rientjes bool "BUG() support" if EXPERT 1588c8538a7aSMatt Mackall default y 1589c8538a7aSMatt Mackall help 1590c8538a7aSMatt Mackall Disabling this option eliminates support for BUG and WARN, reducing 1591c8538a7aSMatt Mackall the size of your kernel image and potentially quietly ignoring 1592c8538a7aSMatt Mackall numerous fatal conditions. You should only consider disabling this 1593c8538a7aSMatt Mackall option for embedded systems with no facilities for reporting errors. 1594c8538a7aSMatt Mackall Just say Y. 1595c8538a7aSMatt Mackall 1596708e9a79SMatt Mackallconfig ELF_CORE 1597046d662fSAlex Kelly depends on COREDUMP 1598708e9a79SMatt Mackall default y 15996a108a14SDavid Rientjes bool "Enable ELF core dumps" if EXPERT 1600708e9a79SMatt Mackall help 1601708e9a79SMatt Mackall Enable support for generating core dumps. Disabling saves about 4k. 1602708e9a79SMatt Mackall 16038761f1abSRalf Baechle 1604e5e1d3cbSStas Sergeevconfig PCSPKR_PLATFORM 16056a108a14SDavid Rientjes bool "Enable PC-Speaker support" if EXPERT 16068761f1abSRalf Baechle depends on HAVE_PCSPKR_PLATFORM 160715f304b6SRalf Baechle select I8253_LOCK 1608e5e1d3cbSStas Sergeev default y 1609e5e1d3cbSStas Sergeev help 1610e5e1d3cbSStas Sergeev This option allows to disable the internal PC-Speaker 1611e5e1d3cbSStas Sergeev support, saving some memory. 1612e5e1d3cbSStas Sergeev 161327021649SYoann Congalconfig BASE_SMALL 161427021649SYoann Congal bool "Enable smaller-sized data structures for core" if EXPERT 16151da177e4SLinus Torvalds help 161627021649SYoann Congal Enabling this option reduces the size of miscellaneous core 16171da177e4SLinus Torvalds kernel data structures. This saves memory on small machines, 16181da177e4SLinus Torvalds but may reduce performance. 16191da177e4SLinus Torvalds 16201da177e4SLinus Torvaldsconfig FUTEX 16216a108a14SDavid Rientjes bool "Enable futex support" if EXPERT 16223f2bedabSArnd Bergmann depends on !(SPARC32 && SMP) 16231da177e4SLinus Torvalds default y 1624bc2eecd7SNicolas Pitre imply RT_MUTEXES 16251da177e4SLinus Torvalds help 16261da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 16271da177e4SLinus Torvalds support for "fast userspace mutexes". The resulting kernel may not 16281da177e4SLinus Torvalds run glibc-based applications correctly. 16291da177e4SLinus Torvalds 1630bc2eecd7SNicolas Pitreconfig FUTEX_PI 1631bc2eecd7SNicolas Pitre bool 1632bc2eecd7SNicolas Pitre depends on FUTEX && RT_MUTEXES 1633bc2eecd7SNicolas Pitre default y 1634bc2eecd7SNicolas Pitre 16351da177e4SLinus Torvaldsconfig EPOLL 16366a108a14SDavid Rientjes bool "Enable eventpoll support" if EXPERT 16371da177e4SLinus Torvalds default y 16381da177e4SLinus Torvalds help 16391da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 16401da177e4SLinus Torvalds support for epoll family of system calls. 16411da177e4SLinus Torvalds 1642fba2afaaSDavide Libenziconfig SIGNALFD 16436a108a14SDavid Rientjes bool "Enable signalfd() system call" if EXPERT 1644fba2afaaSDavide Libenzi default y 1645fba2afaaSDavide Libenzi help 1646fba2afaaSDavide Libenzi Enable the signalfd() system call that allows to receive signals 1647fba2afaaSDavide Libenzi on a file descriptor. 1648fba2afaaSDavide Libenzi 1649fba2afaaSDavide Libenzi If unsure, say Y. 1650fba2afaaSDavide Libenzi 1651b215e283SDavide Libenziconfig TIMERFD 16526a108a14SDavid Rientjes bool "Enable timerfd() system call" if EXPERT 1653b215e283SDavide Libenzi default y 1654b215e283SDavide Libenzi help 1655b215e283SDavide Libenzi Enable the timerfd() system call that allows to receive timer 1656b215e283SDavide Libenzi events on a file descriptor. 1657b215e283SDavide Libenzi 1658b215e283SDavide Libenzi If unsure, say Y. 1659b215e283SDavide Libenzi 1660e1ad7468SDavide Libenziconfig EVENTFD 16616a108a14SDavid Rientjes bool "Enable eventfd() system call" if EXPERT 1662e1ad7468SDavide Libenzi default y 1663e1ad7468SDavide Libenzi help 1664e1ad7468SDavide Libenzi Enable the eventfd() system call that allows to receive both 1665e1ad7468SDavide Libenzi kernel notification (ie. KAIO) or userspace notifications. 1666e1ad7468SDavide Libenzi 1667e1ad7468SDavide Libenzi If unsure, say Y. 1668e1ad7468SDavide Libenzi 16691da177e4SLinus Torvaldsconfig SHMEM 16706a108a14SDavid Rientjes bool "Use full shmem filesystem" if EXPERT 16711da177e4SLinus Torvalds default y 16721da177e4SLinus Torvalds depends on MMU 16731da177e4SLinus Torvalds help 16741da177e4SLinus Torvalds The shmem is an internal filesystem used to manage shared memory. 16751da177e4SLinus Torvalds It is backed by swap and manages resource limits. It is also exported 16761da177e4SLinus Torvalds to userspace as tmpfs if TMPFS is enabled. Disabling this 16771da177e4SLinus Torvalds option replaces shmem and tmpfs with the much simpler ramfs code, 16781da177e4SLinus Torvalds which may be appropriate on small systems without swap. 16791da177e4SLinus Torvalds 1680ebf3f09cSThomas Petazzoniconfig AIO 16816a108a14SDavid Rientjes bool "Enable AIO support" if EXPERT 1682ebf3f09cSThomas Petazzoni default y 1683ebf3f09cSThomas Petazzoni help 1684ebf3f09cSThomas Petazzoni This option enables POSIX asynchronous I/O which may by used 1685ebf3f09cSThomas Petazzoni by some high performance threaded applications. Disabling 1686ebf3f09cSThomas Petazzoni this option saves about 7k. 1687ebf3f09cSThomas Petazzoni 16882b188cc1SJens Axboeconfig IO_URING 16892b188cc1SJens Axboe bool "Enable IO uring support" if EXPERT 1690561fb04aSJens Axboe select IO_WQ 16912b188cc1SJens Axboe default y 16922b188cc1SJens Axboe help 16932b188cc1SJens Axboe This option enables support for the io_uring interface, enabling 16942b188cc1SJens Axboe applications to submit and complete IO through submission and 16952b188cc1SJens Axboe completion rings that are shared between the kernel and application. 16962b188cc1SJens Axboe 1697d3ac21caSJosh Triplettconfig ADVISE_SYSCALLS 1698d3ac21caSJosh Triplett bool "Enable madvise/fadvise syscalls" if EXPERT 1699d3ac21caSJosh Triplett default y 1700d3ac21caSJosh Triplett help 1701d3ac21caSJosh Triplett This option enables the madvise and fadvise syscalls, used by 1702d3ac21caSJosh Triplett applications to advise the kernel about their future memory or file 1703d3ac21caSJosh Triplett usage, improving performance. If building an embedded system where no 1704d3ac21caSJosh Triplett applications use these syscalls, you can disable this option to save 1705d3ac21caSJosh Triplett space. 1706d3ac21caSJosh Triplett 17075b25b13aSMathieu Desnoyersconfig MEMBARRIER 17085b25b13aSMathieu Desnoyers bool "Enable membarrier() system call" if EXPERT 17095b25b13aSMathieu Desnoyers default y 17105b25b13aSMathieu Desnoyers help 17115b25b13aSMathieu Desnoyers Enable the membarrier() system call that allows issuing memory 17125b25b13aSMathieu Desnoyers barriers across all running threads, which can be used to distribute 17135b25b13aSMathieu Desnoyers the cost of user-space memory barriers asymmetrically by transforming 17145b25b13aSMathieu Desnoyers pairs of memory barriers into pairs consisting of membarrier() and a 17155b25b13aSMathieu Desnoyers compiler barrier. 17165b25b13aSMathieu Desnoyers 17175b25b13aSMathieu Desnoyers If unsure, say Y. 17185b25b13aSMathieu Desnoyers 1719a751ea34SRandy Dunlapconfig KCMP 1720a751ea34SRandy Dunlap bool "Enable kcmp() system call" if EXPERT 1721a751ea34SRandy Dunlap help 1722a751ea34SRandy Dunlap Enable the kernel resource comparison system call. It provides 1723a751ea34SRandy Dunlap user-space with the ability to compare two processes to see if they 1724a751ea34SRandy Dunlap share a common resource, such as a file descriptor or even virtual 1725a751ea34SRandy Dunlap memory space. 1726a751ea34SRandy Dunlap 1727a751ea34SRandy Dunlap If unsure, say N. 1728a751ea34SRandy Dunlap 1729a751ea34SRandy Dunlapconfig RSEQ 1730a751ea34SRandy Dunlap bool "Enable rseq() system call" if EXPERT 1731a751ea34SRandy Dunlap default y 1732a751ea34SRandy Dunlap depends on HAVE_RSEQ 1733a751ea34SRandy Dunlap select MEMBARRIER 1734a751ea34SRandy Dunlap help 1735a751ea34SRandy Dunlap Enable the restartable sequences system call. It provides a 1736a751ea34SRandy Dunlap user-space cache for the current CPU number value, which 1737a751ea34SRandy Dunlap speeds up getting the current CPU number from user-space, 1738a751ea34SRandy Dunlap as well as an ABI to speed up user-space operations on 1739a751ea34SRandy Dunlap per-CPU data. 1740a751ea34SRandy Dunlap 1741a751ea34SRandy Dunlap If unsure, say Y. 1742a751ea34SRandy Dunlap 1743a751ea34SRandy Dunlapconfig DEBUG_RSEQ 1744a751ea34SRandy Dunlap default n 1745a751ea34SRandy Dunlap bool "Enable debugging of rseq() system call" if EXPERT 1746a751ea34SRandy Dunlap depends on RSEQ && DEBUG_KERNEL 1747a751ea34SRandy Dunlap help 1748a751ea34SRandy Dunlap Enable extra debugging checks for the rseq system call. 1749a751ea34SRandy Dunlap 1750a751ea34SRandy Dunlap If unsure, say N. 1751a751ea34SRandy Dunlap 1752a751ea34SRandy Dunlapconfig CACHESTAT_SYSCALL 1753a751ea34SRandy Dunlap bool "Enable cachestat() system call" if EXPERT 1754a751ea34SRandy Dunlap default y 1755a751ea34SRandy Dunlap help 1756a751ea34SRandy Dunlap Enable the cachestat system call, which queries the page cache 1757a751ea34SRandy Dunlap statistics of a file (number of cached pages, dirty pages, 1758a751ea34SRandy Dunlap pages marked for writeback, (recently) evicted pages). 1759a751ea34SRandy Dunlap 1760a751ea34SRandy Dunlap If unsure say Y here. 1761a751ea34SRandy Dunlap 1762a751ea34SRandy Dunlapconfig PC104 1763a751ea34SRandy Dunlap bool "PC/104 support" if EXPERT 1764a751ea34SRandy Dunlap help 1765a751ea34SRandy Dunlap Expose PC/104 form factor device drivers and options available for 1766a751ea34SRandy Dunlap selection and configuration. Enable this option if your target 1767a751ea34SRandy Dunlap machine has a PC/104 bus. 1768a751ea34SRandy Dunlap 1769d1b069f5SRandy Dunlapconfig KALLSYMS 1770d1b069f5SRandy Dunlap bool "Load all symbols for debugging/ksymoops" if EXPERT 1771d1b069f5SRandy Dunlap default y 1772d1b069f5SRandy Dunlap help 1773d1b069f5SRandy Dunlap Say Y here to let the kernel print out symbolic crash information and 1774d1b069f5SRandy Dunlap symbolic stack backtraces. This increases the size of the kernel 1775d1b069f5SRandy Dunlap somewhat, as all symbols have to be loaded into the kernel image. 1776d1b069f5SRandy Dunlap 177730f3bb09SZhen Leiconfig KALLSYMS_SELFTEST 177830f3bb09SZhen Lei bool "Test the basic functions and performance of kallsyms" 177930f3bb09SZhen Lei depends on KALLSYMS 178030f3bb09SZhen Lei default n 178130f3bb09SZhen Lei help 178230f3bb09SZhen Lei Test the basic functions and performance of some interfaces, such as 178330f3bb09SZhen Lei kallsyms_lookup_name. It also calculates the compression rate of the 178430f3bb09SZhen Lei kallsyms compression algorithm for the current symbol set. 178530f3bb09SZhen Lei 178630f3bb09SZhen Lei Start self-test automatically after system startup. Suggest executing 178730f3bb09SZhen Lei "dmesg | grep kallsyms_selftest" to collect test results. "finish" is 178830f3bb09SZhen Lei displayed in the last line, indicating that the test is complete. 178930f3bb09SZhen Lei 1790d1b069f5SRandy Dunlapconfig KALLSYMS_ALL 1791d1b069f5SRandy Dunlap bool "Include all symbols in kallsyms" 1792d1b069f5SRandy Dunlap depends on DEBUG_KERNEL && KALLSYMS 1793d1b069f5SRandy Dunlap help 1794d1b069f5SRandy Dunlap Normally kallsyms only contains the symbols of functions for nicer 1795d1b069f5SRandy Dunlap OOPS messages and backtraces (i.e., symbols from the text and inittext 1796bdf0fe33SBaruch Siach sections). This is sufficient for most cases. And only if you want to 1797bdf0fe33SBaruch Siach enable kernel live patching, or other less common use cases (e.g., 1798bdf0fe33SBaruch Siach when a debugger is used) all symbols are required (i.e., names of 1799bdf0fe33SBaruch Siach variables from the data sections, etc). 1800d1b069f5SRandy Dunlap 1801d1b069f5SRandy Dunlap This option makes sure that all symbols are loaded into the kernel 1802d1b069f5SRandy Dunlap image (i.e., symbols from all sections) in cost of increased kernel 1803d1b069f5SRandy Dunlap size (depending on the kernel configuration, it may be 300KiB or 1804d1b069f5SRandy Dunlap something like this). 1805d1b069f5SRandy Dunlap 1806bdf0fe33SBaruch Siach Say N unless you really need all symbols, or kernel live patching. 1807d1b069f5SRandy Dunlap 1808d1b069f5SRandy Dunlapconfig KALLSYMS_ABSOLUTE_PERCPU 1809d1b069f5SRandy Dunlap bool 1810d1b069f5SRandy Dunlap depends on KALLSYMS 1811d1b069f5SRandy Dunlap default X86_64 && SMP 1812d1b069f5SRandy Dunlap 1813d1b069f5SRandy Dunlap# end of the "standard kernel features (expert users)" menu 1814d1b069f5SRandy Dunlap 18153ccfebedSMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_CALLBACKS 18163ccfebedSMathieu Desnoyers bool 18173ccfebedSMathieu Desnoyers 181870216e18SMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_SYNC_CORE 181970216e18SMathieu Desnoyers bool 182070216e18SMathieu Desnoyers 1821cdd6c482SIngo Molnarconfig HAVE_PERF_EVENTS 18220793a61dSThomas Gleixner bool 1823018df72dSMike Frysinger help 1824018df72dSMike Frysinger See tools/perf/design.txt for details. 18250793a61dSThomas Gleixner 18262aef6f30SSean Christophersonconfig GUEST_PERF_EVENTS 18272aef6f30SSean Christopherson bool 18282aef6f30SSean Christopherson depends on HAVE_PERF_EVENTS 18292aef6f30SSean Christopherson 1830906010b2SPeter Zijlstraconfig PERF_USE_VMALLOC 1831906010b2SPeter Zijlstra bool 1832906010b2SPeter Zijlstra help 1833906010b2SPeter Zijlstra See tools/perf/design.txt for details 1834906010b2SPeter Zijlstra 183557c0c15bSIngo Molnarmenu "Kernel Performance Events And Counters" 18360793a61dSThomas Gleixner 1837cdd6c482SIngo Molnarconfig PERF_EVENTS 183857c0c15bSIngo Molnar bool "Kernel performance events and counters" 1839392d65a9SRobert Richter default y if PROFILING 1840cdd6c482SIngo Molnar depends on HAVE_PERF_EVENTS 1841e360adbeSPeter Zijlstra select IRQ_WORK 18420793a61dSThomas Gleixner help 184357c0c15bSIngo Molnar Enable kernel support for various performance events provided 184457c0c15bSIngo Molnar by software and hardware. 18450793a61dSThomas Gleixner 1846dd77038dSThadeu Lima de Souza Cascardo Software events are supported either built-in or via the 184757c0c15bSIngo Molnar use of generic tracepoints. 184857c0c15bSIngo Molnar 184957c0c15bSIngo Molnar Most modern CPUs support performance events via performance 185057c0c15bSIngo Molnar counter registers. These registers count the number of certain 18510793a61dSThomas Gleixner types of hw events: such as instructions executed, cachemisses 18520793a61dSThomas Gleixner suffered, or branches mis-predicted - without slowing down the 18530793a61dSThomas Gleixner kernel or applications. These registers can also trigger interrupts 18540793a61dSThomas Gleixner when a threshold number of events have passed - and can thus be 18550793a61dSThomas Gleixner used to profile the code that runs on that CPU. 18560793a61dSThomas Gleixner 185757c0c15bSIngo Molnar The Linux Performance Event subsystem provides an abstraction of 1858dd77038dSThadeu Lima de Souza Cascardo these software and hardware event capabilities, available via a 185957c0c15bSIngo Molnar system call and used by the "perf" utility in tools/perf/. It 18600793a61dSThomas Gleixner provides per task and per CPU counters, and it provides event 18610793a61dSThomas Gleixner capabilities on top of those. 18620793a61dSThomas Gleixner 18630793a61dSThomas Gleixner Say Y if unsure. 18640793a61dSThomas Gleixner 1865906010b2SPeter Zijlstraconfig DEBUG_PERF_USE_VMALLOC 1866906010b2SPeter Zijlstra default n 1867906010b2SPeter Zijlstra bool "Debug: use vmalloc to back perf mmap() buffers" 1868cb307113SMichael Ellerman depends on PERF_EVENTS && DEBUG_KERNEL && !PPC 1869906010b2SPeter Zijlstra select PERF_USE_VMALLOC 1870906010b2SPeter Zijlstra help 1871906010b2SPeter Zijlstra Use vmalloc memory to back perf mmap() buffers. 1872906010b2SPeter Zijlstra 1873906010b2SPeter Zijlstra Mostly useful for debugging the vmalloc code on platforms 1874906010b2SPeter Zijlstra that don't require it. 1875906010b2SPeter Zijlstra 1876906010b2SPeter Zijlstra Say N if unsure. 1877906010b2SPeter Zijlstra 18780793a61dSThomas Gleixnerendmenu 18790793a61dSThomas Gleixner 1880091f6e26SDavid Howellsconfig SYSTEM_DATA_VERIFICATION 1881091f6e26SDavid Howells def_bool n 1882091f6e26SDavid Howells select SYSTEM_TRUSTED_KEYRING 1883091f6e26SDavid Howells select KEYS 1884091f6e26SDavid Howells select CRYPTO 1885d43de6c7SDavid Howells select CRYPTO_RSA 1886091f6e26SDavid Howells select ASYMMETRIC_KEY_TYPE 1887091f6e26SDavid Howells select ASYMMETRIC_PUBLIC_KEY_SUBTYPE 1888091f6e26SDavid Howells select ASN1 1889091f6e26SDavid Howells select OID_REGISTRY 1890091f6e26SDavid Howells select X509_CERTIFICATE_PARSER 1891091f6e26SDavid Howells select PKCS7_MESSAGE_PARSER 189282c04ff8SPeter Foley help 1893091f6e26SDavid Howells Provide PKCS#7 message verification using the contents of the system 1894091f6e26SDavid Howells trusted keyring to provide public keys. This then can be used for 1895091f6e26SDavid Howells module verification, kexec image verification and firmware blob 1896091f6e26SDavid Howells verification. 189782c04ff8SPeter Foley 1898125e5645SMathieu Desnoyersconfig PROFILING 1899b309a294SRobert Richter bool "Profiling support" 1900125e5645SMathieu Desnoyers help 1901125e5645SMathieu Desnoyers Say Y here to enable the extended profiling support mechanisms used 1902f8408264SViresh Kumar by profilers. 1903125e5645SMathieu Desnoyers 19042f7ab126SMiguel Ojedaconfig RUST 19052f7ab126SMiguel Ojeda bool "Rust support" 19062f7ab126SMiguel Ojeda depends on HAVE_RUST 19072f7ab126SMiguel Ojeda depends on RUST_IS_AVAILABLE 19082f7ab126SMiguel Ojeda depends on !MODVERSIONS 1909f1385dc6SNeal Gompa depends on !GCC_PLUGIN_RANDSTRUCT 19102f7ab126SMiguel Ojeda depends on !RANDSTRUCT 1911c1177979SMartin Rodriguez Reboredo depends on !DEBUG_INFO_BTF || PAHOLE_HAS_LANG_EXCLUDE 1912*ca627e63SMatthew Maurer depends on !CFI_CLANG || RUSTC_VERSION >= 107900 && $(cc-option,-fsanitize=kcfi -fsanitize-cfi-icall-experimental-normalize-integers) 1913*ca627e63SMatthew Maurer select CFI_ICALL_NORMALIZE_INTEGERS if CFI_CLANG 1914*ca627e63SMatthew Maurer depends on !CALL_PADDING || RUSTC_VERSION >= 108000 19152f7ab126SMiguel Ojeda help 19162f7ab126SMiguel Ojeda Enables Rust support in the kernel. 19172f7ab126SMiguel Ojeda 19182f7ab126SMiguel Ojeda This allows other Rust-related options, like drivers written in Rust, 19192f7ab126SMiguel Ojeda to be selected. 19202f7ab126SMiguel Ojeda 19212f7ab126SMiguel Ojeda It is also required to be able to load external kernel modules 19222f7ab126SMiguel Ojeda written in Rust. 19232f7ab126SMiguel Ojeda 19242f7ab126SMiguel Ojeda See Documentation/rust/ for more information. 19252f7ab126SMiguel Ojeda 19262f7ab126SMiguel Ojeda If unsure, say N. 19272f7ab126SMiguel Ojeda 19282f7ab126SMiguel Ojedaconfig RUSTC_VERSION_TEXT 19292f7ab126SMiguel Ojeda string 19302f7ab126SMiguel Ojeda depends on RUST 19315134a335SMiguel Ojeda default "$(RUSTC_VERSION_TEXT)" 19325134a335SMiguel Ojeda help 19335134a335SMiguel Ojeda See `CC_VERSION_TEXT`. 19342f7ab126SMiguel Ojeda 19352f7ab126SMiguel Ojedaconfig BINDGEN_VERSION_TEXT 19362f7ab126SMiguel Ojeda string 19372f7ab126SMiguel Ojeda depends on RUST 19389e98db17SMiguel Ojeda # The dummy parameter `workaround-for-0.69.0` is required to support 0.69.0 19399e98db17SMiguel Ojeda # (https://github.com/rust-lang/rust-bindgen/pull/2678). It can be removed when 19409e98db17SMiguel Ojeda # the minimum version is upgraded past that (0.69.1 already fixed the issue). 1941aacf93e8SMasahiro Yamada default "$(shell,$(BINDGEN) --version workaround-for-0.69.0 2>/dev/null)" 19422f7ab126SMiguel Ojeda 19435f87f112SIngo Molnar# 19445f87f112SIngo Molnar# Place an empty function call at each tracepoint site. Can be 19455f87f112SIngo Molnar# dynamically changed for a probe function. 19465f87f112SIngo Molnar# 194797e1c18eSMathieu Desnoyersconfig TRACEPOINTS 19485f87f112SIngo Molnar bool 194997e1c18eSMathieu Desnoyers 195089cde455SEric DeVoldersource "kernel/Kconfig.kexec" 195189cde455SEric DeVolder 19521da177e4SLinus Torvaldsendmenu # General setup 19531da177e4SLinus Torvalds 19541572497cSChristoph Hellwigsource "arch/Kconfig" 19551572497cSChristoph Hellwig 1956ae81f9e3SChuck Ebbertconfig RT_MUTEXES 19576341e62bSChristoph Jaeger bool 19581c6f9ec0SSebastian Andrzej Siewior default y if PREEMPT_RT 1959ae81f9e3SChuck Ebbert 1960c8424e77SThiago Jung Bauermannconfig MODULE_SIG_FORMAT 1961c8424e77SThiago Jung Bauermann def_bool n 1962c8424e77SThiago Jung Bauermann select SYSTEM_DATA_VERIFICATION 1963c8424e77SThiago Jung Bauermann 196473b4fc92SChristophe Leroysource "kernel/module/Kconfig" 19656c9692e2SPeter Zijlstra 196698a79d6aSRusty Russellconfig INIT_ALL_POSSIBLE 196798a79d6aSRusty Russell bool 196898a79d6aSRusty Russell help 19695f054e31SRusty Russell Back when each arch used to define their own cpu_online_mask and 19705f054e31SRusty Russell cpu_possible_mask, some of them chose to initialize cpu_possible_mask 197198a79d6aSRusty Russell with all 1s, and others with all 0s. When they were centralised, 197298a79d6aSRusty Russell it was better to provide this option than to break all the archs 1973692105b8SMatt LaPlante and have several arch maintainers pursuing me down dark alleys. 197498a79d6aSRusty Russell 19753a65dfe8SJens Axboesource "block/Kconfig" 1976e98c3202SAvi Kivity 1977e98c3202SAvi Kivityconfig PREEMPT_NOTIFIERS 1978e98c3202SAvi Kivity bool 1979e260be67SPaul E. McKenney 198016295becSSteffen Klassertconfig PADATA 198116295becSSteffen Klassert depends on SMP 198216295becSSteffen Klassert bool 198316295becSSteffen Klassert 19844520c6a4SDavid Howellsconfig ASN1 19854520c6a4SDavid Howells tristate 19864520c6a4SDavid Howells help 19874520c6a4SDavid Howells Build a simple ASN.1 grammar compiler that produces a bytecode output 19884520c6a4SDavid Howells that can be interpreted by the ASN.1 stream decoder and used to 19894520c6a4SDavid Howells inform it as to what tags are to be expected in a stream and what 19904520c6a4SDavid Howells functions to call on what tags. 19914520c6a4SDavid Howells 19926beb0009SThomas Gleixnersource "kernel/Kconfig.locks" 1993e61938a9SMathieu Desnoyers 19940ebeea8cSDaniel Borkmannconfig ARCH_HAS_NON_OVERLAPPING_ADDRESS_SPACE 19950ebeea8cSDaniel Borkmann bool 19960ebeea8cSDaniel Borkmann 19974ff4c745SAndrea Parriconfig ARCH_HAS_PREPARE_SYNC_CORE_CMD 19984ff4c745SAndrea Parri bool 19994ff4c745SAndrea Parri 2000e61938a9SMathieu Desnoyersconfig ARCH_HAS_SYNC_CORE_BEFORE_USERMODE 2001e61938a9SMathieu Desnoyers bool 20021bd21c6cSDominik Brodowski 20031bd21c6cSDominik Brodowski# It may be useful for an architecture to override the definitions of the 20047303e30eSDominik Brodowski# SYSCALL_DEFINE() and __SYSCALL_DEFINEx() macros in <linux/syscalls.h> 20057303e30eSDominik Brodowski# and the COMPAT_ variants in <linux/compat.h>, in particular to use a 20067303e30eSDominik Brodowski# different calling convention for syscalls. They can also override the 20077303e30eSDominik Brodowski# macros for not-implemented syscalls in kernel/sys_ni.c and 20087303e30eSDominik Brodowski# kernel/time/posix-stubs.c. All these overrides need to be available in 20097303e30eSDominik Brodowski# <asm/syscall_wrapper.h>. 20101bd21c6cSDominik Brodowskiconfig ARCH_HAS_SYSCALL_WRAPPER 20111bd21c6cSDominik Brodowski def_bool n 2012