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 65af0121c2SGary Guo default $(rustc-version) 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 81af0121c2SGary Guoconfig RUSTC_LLVM_VERSION 82af0121c2SGary Guo int 83af0121c2SGary Guo default $(rustc-llvm-version) 84af0121c2SGary Guo 851a927fd3SMasahiro Yamadaconfig CC_CAN_LINK 869371f86eSMasahiro Yamada bool 87f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag)) if 64BIT 88f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag)) 891a927fd3SMasahiro Yamada 90b1183b6dSMasahiro Yamadaconfig CC_CAN_LINK_STATIC 91b1183b6dSMasahiro Yamada bool 92f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m64-flag) -static) if 64BIT 93f67695c9SElliot Berman default $(success,$(srctree)/scripts/cc-can-link.sh $(CC) $(CLANG_FLAGS) $(USERCFLAGS) $(USERLDFLAGS) $(m32-flag) -static) 94c65eacbeSAndy Lutomirski 95f2f6a8e8SMark Rutland# Fixed in GCC 14, 13.3, 12.4 and 11.5 96f2f6a8e8SMark Rutland# https://gcc.gnu.org/bugzilla/show_bug.cgi?id=113921 97f2f6a8e8SMark Rutlandconfig GCC_ASM_GOTO_OUTPUT_BROKEN 98f2f6a8e8SMark Rutland bool 99f2f6a8e8SMark Rutland depends on CC_IS_GCC 100f2f6a8e8SMark Rutland default y if GCC_VERSION < 110500 101f2f6a8e8SMark Rutland default y if GCC_VERSION >= 120000 && GCC_VERSION < 120400 102f2f6a8e8SMark Rutland default y if GCC_VERSION >= 130000 && GCC_VERSION < 130300 103f2f6a8e8SMark Rutland 104587f1701SNick Desaulniersconfig CC_HAS_ASM_GOTO_OUTPUT 105f2f6a8e8SMark Rutland def_bool y 106f2f6a8e8SMark Rutland depends on !GCC_ASM_GOTO_OUTPUT_BROKEN 107f2f6a8e8SMark 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) 108587f1701SNick Desaulniers 1091aa0e8b1SSean Christophersonconfig CC_HAS_ASM_GOTO_TIED_OUTPUT 1101aa0e8b1SSean Christopherson depends on CC_HAS_ASM_GOTO_OUTPUT 1111aa0e8b1SSean Christopherson # Detect buggy gcc and clang, fixed in gcc-11 clang-14. 112534bd703SAlexandre 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) 1131aa0e8b1SSean Christopherson 1145cf896fbSPeter Collingbourneconfig TOOLS_SUPPORT_RELR 1152d122942SWill Deacon def_bool $(success,env "CC=$(CC)" "LD=$(LD)" "NM=$(NM)" "OBJCOPY=$(OBJCOPY)" $(srctree)/scripts/tools-support-relr.sh) 1165cf896fbSPeter Collingbourne 117eb111869SRasmus Villemoesconfig CC_HAS_ASM_INLINE 118eb111869SRasmus Villemoes def_bool $(success,echo 'void foo(void) { asm inline (""); }' | $(CC) -x c - -c -o /dev/null) 119eb111869SRasmus Villemoes 12051c2ee6dSNick Desaulniersconfig CC_HAS_NO_PROFILE_FN_ATTR 12151c2ee6dSNick Desaulniers def_bool $(success,echo '__attribute__((no_profile_instrument_function)) int x();' | $(CC) -x c - -c -o /dev/null -Werror) 12251c2ee6dSNick Desaulniers 123f06e108aSJan Hendrik Farrconfig CC_HAS_COUNTED_BY 124f06e108aSJan Hendrik Farr # TODO: when gcc 15 is released remove the build test and add 125f06e108aSJan Hendrik Farr # a gcc version check 126f06e108aSJan Hendrik Farr def_bool $(success,echo 'struct flex { int count; int array[] __attribute__((__counted_by__(count))); };' | $(CC) $(CLANG_FLAGS) -x c - -c -o /dev/null -Werror) 127f06e108aSJan Hendrik Farr # clang needs to be at least 19.1.3 to avoid __bdos miscalculations 128f06e108aSJan Hendrik Farr # https://github.com/llvm/llvm-project/pull/110497 129f06e108aSJan Hendrik Farr # https://github.com/llvm/llvm-project/pull/112636 130f06e108aSJan Hendrik Farr depends on !(CC_IS_CLANG && CLANG_VERSION < 190103) 131f06e108aSJan Hendrik Farr 132b688f369SKees Cookconfig CC_HAS_MULTIDIMENSIONAL_NONSTRING 133b688f369SKees Cook def_bool $(success,echo 'char tag[][4] __attribute__((__nonstring__)) = { };' | $(CC) $(CLANG_FLAGS) -x c - -c -o /dev/null -Werror) 134b688f369SKees Cook 135e7607f7dSNathan Chancellorconfig LD_CAN_USE_KEEP_IN_OVERLAY 136e7607f7dSNathan Chancellor # ld.lld prior to 21.0.0 did not support KEEP within an overlay description 137e7607f7dSNathan Chancellor # https://github.com/llvm/llvm-project/pull/130661 138e7607f7dSNathan Chancellor def_bool LD_IS_BFD || LLD_VERSION >= 210000 139e7607f7dSNathan Chancellor 14047cb6bf7SXiangfei Dingconfig RUSTC_HAS_COERCE_POINTEE 14147cb6bf7SXiangfei Ding def_bool RUSTC_VERSION >= 108400 14247cb6bf7SXiangfei Ding 1437129ea6eSMiguel Ojedaconfig RUSTC_HAS_UNNECESSARY_TRANSMUTES 1447129ea6eSMiguel Ojeda def_bool RUSTC_VERSION >= 108800 1457129ea6eSMiguel Ojeda 146613fe169SNathan Chancellorconfig PAHOLE_VERSION 147613fe169SNathan Chancellor int 148613fe169SNathan Chancellor default $(shell,$(srctree)/scripts/pahole-version.sh $(PAHOLE)) 149613fe169SNathan Chancellor 150b99b87f7SPeter Oberparleiterconfig CONSTRUCTORS 151b99b87f7SPeter Oberparleiter bool 152b99b87f7SPeter Oberparleiter 153e360adbeSPeter Zijlstraconfig IRQ_WORK 154fd0a68a2STejun Heo def_bool y if SMP 155e360adbeSPeter Zijlstra 15610916706SShile Zhangconfig BUILDTIME_TABLE_SORT 1571dbdc6f1SDavid Daney bool 1581dbdc6f1SDavid Daney 159c65eacbeSAndy Lutomirskiconfig THREAD_INFO_IN_TASK 160c65eacbeSAndy Lutomirski bool 161c65eacbeSAndy Lutomirski help 162c65eacbeSAndy Lutomirski Select this to move thread_info off the stack into task_struct. To 163c65eacbeSAndy Lutomirski make this work, an arch will need to remove all thread_info fields 164c65eacbeSAndy Lutomirski except flags and fix any runtime bugs. 165c65eacbeSAndy Lutomirski 166c6c314a6SAndy Lutomirski One subtle change that will be needed is to use try_get_task_stack() 167c6c314a6SAndy Lutomirski and put_task_stack() in save_thread_stack_tsk() and get_wchan(). 168c6c314a6SAndy Lutomirski 169ff0cfc66SAl Boldimenu "General setup" 1701da177e4SLinus Torvalds 1711da177e4SLinus Torvaldsconfig BROKEN 1721da177e4SLinus Torvalds bool 1731da177e4SLinus Torvalds 1741da177e4SLinus Torvaldsconfig BROKEN_ON_SMP 1751da177e4SLinus Torvalds bool 1761da177e4SLinus Torvalds depends on BROKEN || !SMP 1771da177e4SLinus Torvalds default y 1781da177e4SLinus Torvalds 1791da177e4SLinus Torvaldsconfig INIT_ENV_ARG_LIMIT 1801da177e4SLinus Torvalds int 181dd673bcaSAdrian Bunk default 32 if !UML 182dd673bcaSAdrian Bunk default 128 if UML 1831da177e4SLinus Torvalds help 18434ad92c2SRandy Dunlap Maximum of each of the number of arguments and environment 18534ad92c2SRandy Dunlap variables passed to init from the kernel command line. 1861da177e4SLinus Torvalds 1874bb16672SJiri Slabyconfig COMPILE_TEST 1884bb16672SJiri Slaby bool "Compile also drivers which will not load" 189ea29b20aSMasahiro Yamada depends on HAS_IOMEM 1904bb16672SJiri Slaby help 1914bb16672SJiri Slaby Some drivers can be compiled on a different platform than they are 1924bb16672SJiri Slaby intended to be run on. Despite they cannot be loaded there (or even 1934bb16672SJiri Slaby when they load they cannot be used due to missing HW support), 1944bb16672SJiri Slaby developers still, opposing to distributors, might want to build such 1954bb16672SJiri Slaby drivers to compile-test them. 1964bb16672SJiri Slaby 1974bb16672SJiri Slaby If you are a developer and want to build everything available, say Y 1984bb16672SJiri Slaby here. If you are a user/distributor, say N here to exclude useless 1994bb16672SJiri Slaby drivers to be distributed. 2004bb16672SJiri Slaby 2013fe617ccSLinus Torvaldsconfig WERROR 2023fe617ccSLinus Torvalds bool "Compile the kernel with warnings as errors" 203b339ec9cSMarco Elver default COMPILE_TEST 2043fe617ccSLinus Torvalds help 2053fe617ccSLinus Torvalds A kernel build should not cause any compiler warnings, and this 2062f7ab126SMiguel Ojeda enables the '-Werror' (for C) and '-Dwarnings' (for Rust) flags 207e1789d7cSXin Li to enforce that rule by default. Certain warnings from other tools 208e1789d7cSXin Li such as the linker may be upgraded to errors with this option as 209e1789d7cSXin Li well. 2103fe617ccSLinus Torvalds 211e1789d7cSXin Li However, if you have a new (or very old) compiler or linker with odd 212e1789d7cSXin Li and unusual warnings, or you have some architecture with problems, 2133fe617ccSLinus Torvalds you may need to disable this config option in order to 2143fe617ccSLinus Torvalds successfully build the kernel. 2153fe617ccSLinus Torvalds 2163fe617ccSLinus Torvalds If in doubt, say Y. 2173fe617ccSLinus Torvalds 218d6fc9fcbSMasahiro Yamadaconfig UAPI_HEADER_TEST 219d6fc9fcbSMasahiro Yamada bool "Compile test UAPI headers" 220fcbb8461SMasahiro Yamada depends on HEADERS_INSTALL && CC_CAN_LINK 221d6fc9fcbSMasahiro Yamada help 222d6fc9fcbSMasahiro Yamada Compile test headers exported to user-space to ensure they are 223d6fc9fcbSMasahiro Yamada self-contained, i.e. compilable as standalone units. 224d6fc9fcbSMasahiro Yamada 225d6fc9fcbSMasahiro Yamada If you are a developer or tester and want to ensure the exported 226d6fc9fcbSMasahiro Yamada headers are self-contained, say Y here. Otherwise, choose N. 227d6fc9fcbSMasahiro Yamada 2281da177e4SLinus Torvaldsconfig LOCALVERSION 2291da177e4SLinus Torvalds string "Local version - append to kernel release" 2301da177e4SLinus Torvalds help 2311da177e4SLinus Torvalds Append an extra string to the end of your kernel version. 2321da177e4SLinus Torvalds This will show up when you type uname, for example. 2331da177e4SLinus Torvalds The string you set here will be appended after the contents of 2341da177e4SLinus Torvalds any files with a filename matching localversion* in your 2351da177e4SLinus Torvalds object and source tree, in that order. Your total string can 2361da177e4SLinus Torvalds be a maximum of 64 characters. 2371da177e4SLinus Torvalds 238aaebf433SRyan Andersonconfig LOCALVERSION_AUTO 239aaebf433SRyan Anderson bool "Automatically append version information to the version string" 240aaebf433SRyan Anderson default y 241ac3339baSAlexey Dobriyan depends on !COMPILE_TEST 242aaebf433SRyan Anderson help 243aaebf433SRyan Anderson This will try to automatically determine if the current tree is a 2446e5a5420SRobert P. J. Day release tree by looking for git tags that belong to the current 2456e5a5420SRobert P. J. Day top of tree revision. 246aaebf433SRyan Anderson 247aaebf433SRyan Anderson A string of the format -gxxxxxxxx will be added to the localversion 2486e5a5420SRobert P. J. Day if a git-based tree is found. The string generated by this will be 249aaebf433SRyan Anderson appended after any matching localversion* files, and after the value 2506e5a5420SRobert P. J. Day set in CONFIG_LOCALVERSION. 251aaebf433SRyan Anderson 2520f9c608dSRasmus Villemoes (The actual string used here is the first 12 characters produced 2536e5a5420SRobert P. J. Day by running the command: 2546e5a5420SRobert P. J. Day 2556e5a5420SRobert P. J. Day $ git rev-parse --verify HEAD 2566e5a5420SRobert P. J. Day 2576e5a5420SRobert P. J. Day which is done within the script "scripts/setlocalversion".) 258aaebf433SRyan Anderson 2599afb719eSLaura Abbottconfig BUILD_SALT 2609afb719eSLaura Abbott string "Build ID Salt" 2619afb719eSLaura Abbott default "" 2629afb719eSLaura Abbott help 2639afb719eSLaura Abbott The build ID is used to link binaries and their debug info. Setting 2649afb719eSLaura Abbott this option will use the value in the calculation of the build id. 2659afb719eSLaura Abbott This is mostly useful for distributions which want to ensure the 2669afb719eSLaura Abbott build is unique between builds. It's safe to leave the default. 2679afb719eSLaura Abbott 2682e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_GZIP 2692e9f3bddSH. Peter Anvin bool 2702e9f3bddSH. Peter Anvin 2712e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_BZIP2 2722e9f3bddSH. Peter Anvin bool 2732e9f3bddSH. Peter Anvin 2742e9f3bddSH. Peter Anvinconfig HAVE_KERNEL_LZMA 2752e9f3bddSH. Peter Anvin bool 2762e9f3bddSH. Peter Anvin 2773ebe1243SLasse Collinconfig HAVE_KERNEL_XZ 2783ebe1243SLasse Collin bool 2793ebe1243SLasse Collin 2807dd65febSAlbin Tonnerreconfig HAVE_KERNEL_LZO 2817dd65febSAlbin Tonnerre bool 2827dd65febSAlbin Tonnerre 283e76e1fdfSKyungsik Leeconfig HAVE_KERNEL_LZ4 284e76e1fdfSKyungsik Lee bool 285e76e1fdfSKyungsik Lee 28648f7ddf7SNick Terrellconfig HAVE_KERNEL_ZSTD 28748f7ddf7SNick Terrell bool 28848f7ddf7SNick Terrell 289f16466afSVasily Gorbikconfig HAVE_KERNEL_UNCOMPRESSED 290f16466afSVasily Gorbik bool 291f16466afSVasily Gorbik 29230d65dbfSAlain Knaffchoice 29330d65dbfSAlain Knaff prompt "Kernel compression mode" 29430d65dbfSAlain Knaff default KERNEL_GZIP 29548f7ddf7SNick 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 29630d65dbfSAlain Knaff help 29730d65dbfSAlain Knaff The linux kernel is a kind of self-extracting executable. 29830d65dbfSAlain Knaff Several compression algorithms are available, which differ 29930d65dbfSAlain Knaff in efficiency, compression and decompression speed. 30030d65dbfSAlain Knaff Compression speed is only relevant when building a kernel. 30130d65dbfSAlain Knaff Decompression speed is relevant at each boot. 30230d65dbfSAlain Knaff 30330d65dbfSAlain Knaff If you have any problems with bzip2 or lzma compressed 30430d65dbfSAlain Knaff kernels, mail me (Alain Knaff) <alain@knaff.lu>. (An older 30530d65dbfSAlain Knaff version of this functionality (bzip2 only), for 2.4, was 30630d65dbfSAlain Knaff supplied by Christian Ludwig) 30730d65dbfSAlain Knaff 30830d65dbfSAlain Knaff High compression options are mostly useful for users, who 30930d65dbfSAlain Knaff are low on disk space (embedded systems), but for whom ram 31030d65dbfSAlain Knaff size matters less. 31130d65dbfSAlain Knaff 31230d65dbfSAlain Knaff If in doubt, select 'gzip' 31330d65dbfSAlain Knaff 31430d65dbfSAlain Knaffconfig KERNEL_GZIP 31530d65dbfSAlain Knaff bool "Gzip" 3162e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_GZIP 31730d65dbfSAlain Knaff help 3187dd65febSAlbin Tonnerre The old and tried gzip compression. It provides a good balance 3197dd65febSAlbin Tonnerre between compression ratio and decompression speed. 32030d65dbfSAlain Knaff 32130d65dbfSAlain Knaffconfig KERNEL_BZIP2 32230d65dbfSAlain Knaff bool "Bzip2" 3232e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_BZIP2 32430d65dbfSAlain Knaff help 32530d65dbfSAlain Knaff Its compression ratio and speed is intermediate. 3260a4dd35cSRandy Dunlap Decompression speed is slowest among the choices. The kernel 3272e9f3bddSH. Peter Anvin size is about 10% smaller with bzip2, in comparison to gzip. 3282e9f3bddSH. Peter Anvin Bzip2 uses a large amount of memory. For modern kernels you 3292e9f3bddSH. Peter Anvin will need at least 8MB RAM or more for booting. 33030d65dbfSAlain Knaff 33130d65dbfSAlain Knaffconfig KERNEL_LZMA 33230d65dbfSAlain Knaff bool "LZMA" 3332e9f3bddSH. Peter Anvin depends on HAVE_KERNEL_LZMA 33430d65dbfSAlain Knaff help 3350a4dd35cSRandy Dunlap This compression algorithm's ratio is best. Decompression speed 3360a4dd35cSRandy Dunlap is between gzip and bzip2. Compression is slowest. 3370a4dd35cSRandy Dunlap The kernel size is about 33% smaller with LZMA in comparison to gzip. 33830d65dbfSAlain Knaff 3393ebe1243SLasse Collinconfig KERNEL_XZ 3403ebe1243SLasse Collin bool "XZ" 3413ebe1243SLasse Collin depends on HAVE_KERNEL_XZ 3423ebe1243SLasse Collin help 3433ebe1243SLasse Collin XZ uses the LZMA2 algorithm and instruction set specific 3443ebe1243SLasse Collin BCJ filters which can improve compression ratio of executable 3453ebe1243SLasse Collin code. The size of the kernel is about 30% smaller with XZ in 3463ebe1243SLasse Collin comparison to gzip. On architectures for which there is a BCJ 3477472ff8aSLasse Collin filter (i386, x86_64, ARM, ARM64, RISC-V, big endian PowerPC, 3487472ff8aSLasse Collin and SPARC), XZ will create a few percent smaller kernel than 3497472ff8aSLasse Collin plain LZMA. 3503ebe1243SLasse Collin 3513ebe1243SLasse Collin The speed is about the same as with LZMA: The decompression 3523ebe1243SLasse Collin speed of XZ is better than that of bzip2 but worse than gzip 3533ebe1243SLasse Collin and LZO. Compression is slow. 3543ebe1243SLasse Collin 3557dd65febSAlbin Tonnerreconfig KERNEL_LZO 3567dd65febSAlbin Tonnerre bool "LZO" 3577dd65febSAlbin Tonnerre depends on HAVE_KERNEL_LZO 3587dd65febSAlbin Tonnerre help 3590a4dd35cSRandy Dunlap Its compression ratio is the poorest among the choices. The kernel 360681b3049SStephan Sperber size is about 10% bigger than gzip; however its speed 3617dd65febSAlbin Tonnerre (both compression and decompression) is the fastest. 3627dd65febSAlbin Tonnerre 363e76e1fdfSKyungsik Leeconfig KERNEL_LZ4 364e76e1fdfSKyungsik Lee bool "LZ4" 365e76e1fdfSKyungsik Lee depends on HAVE_KERNEL_LZ4 366e76e1fdfSKyungsik Lee help 367e76e1fdfSKyungsik Lee LZ4 is an LZ77-type compressor with a fixed, byte-oriented encoding. 368e76e1fdfSKyungsik Lee A preliminary version of LZ4 de/compression tool is available at 369e76e1fdfSKyungsik Lee <https://code.google.com/p/lz4/>. 370e76e1fdfSKyungsik Lee 371e76e1fdfSKyungsik Lee Its compression ratio is worse than LZO. The size of the kernel 372e76e1fdfSKyungsik Lee is about 8% bigger than LZO. But the decompression speed is 373e76e1fdfSKyungsik Lee faster than LZO. 374e76e1fdfSKyungsik Lee 37548f7ddf7SNick Terrellconfig KERNEL_ZSTD 37648f7ddf7SNick Terrell bool "ZSTD" 37748f7ddf7SNick Terrell depends on HAVE_KERNEL_ZSTD 37848f7ddf7SNick Terrell help 37948f7ddf7SNick Terrell ZSTD is a compression algorithm targeting intermediate compression 38048f7ddf7SNick Terrell with fast decompression speed. It will compress better than GZIP and 38148f7ddf7SNick Terrell decompress around the same speed as LZO, but slower than LZ4. You 38248f7ddf7SNick Terrell will need at least 192 KB RAM or more for booting. The zstd command 38348f7ddf7SNick Terrell line tool is required for compression. 38448f7ddf7SNick Terrell 385f16466afSVasily Gorbikconfig KERNEL_UNCOMPRESSED 386f16466afSVasily Gorbik bool "None" 387f16466afSVasily Gorbik depends on HAVE_KERNEL_UNCOMPRESSED 388f16466afSVasily Gorbik help 389f16466afSVasily Gorbik Produce uncompressed kernel image. This option is usually not what 390f16466afSVasily Gorbik you want. It is useful for debugging the kernel in slow simulation 391f16466afSVasily Gorbik environments, where decompressing and moving the kernel is awfully 392f16466afSVasily Gorbik slow. This option allows early boot code to skip the decompressor 393f16466afSVasily Gorbik and jump right at uncompressed kernel image. 394f16466afSVasily Gorbik 39530d65dbfSAlain Knaffendchoice 39630d65dbfSAlain Knaff 397ada4ab7aSChris Downconfig DEFAULT_INIT 398ada4ab7aSChris Down string "Default init path" 399ada4ab7aSChris Down default "" 400ada4ab7aSChris Down help 401ada4ab7aSChris Down This option determines the default init for the system if no init= 402ada4ab7aSChris Down option is passed on the kernel command line. If the requested path is 403ada4ab7aSChris Down not present, we will still then move on to attempting further 404ada4ab7aSChris Down locations (e.g. /sbin/init, etc). If this is empty, we will just use 405ada4ab7aSChris Down the fallback list when init= is not passed. 406ada4ab7aSChris Down 407bd5dc17bSJosh Triplettconfig DEFAULT_HOSTNAME 408bd5dc17bSJosh Triplett string "Default hostname" 409bd5dc17bSJosh Triplett default "(none)" 410bd5dc17bSJosh Triplett help 411bd5dc17bSJosh Triplett This option determines the default system hostname before userspace 412bd5dc17bSJosh Triplett calls sethostname(2). The kernel traditionally uses "(none)" here, 413bd5dc17bSJosh Triplett but you may wish to use a different default here to make a minimal 414bd5dc17bSJosh Triplett system more usable with less configuration. 415bd5dc17bSJosh Triplett 4161da177e4SLinus Torvaldsconfig SYSVIPC 4171da177e4SLinus Torvalds bool "System V IPC" 418a7f7f624SMasahiro Yamada help 4191da177e4SLinus Torvalds Inter Process Communication is a suite of library functions and 4201da177e4SLinus Torvalds system calls which let processes (running programs) synchronize and 4211da177e4SLinus Torvalds exchange information. It is generally considered to be a good thing, 4221da177e4SLinus Torvalds and some programs won't run unless you say Y here. In particular, if 4231da177e4SLinus Torvalds you want to run the DOS emulator dosemu under Linux (read the 4241da177e4SLinus Torvalds DOSEMU-HOWTO, available from <http://www.tldp.org/docs.html#howto>), 4251da177e4SLinus Torvalds you'll need to say Y here. 4261da177e4SLinus Torvalds 4271da177e4SLinus Torvalds You can find documentation about IPC with "info ipc" and also in 4281da177e4SLinus Torvalds section 6.4 of the Linux Programmer's Guide, available from 4291da177e4SLinus Torvalds <http://www.tldp.org/guides.html>. 4301da177e4SLinus Torvalds 431a5494dcdSEric W. Biedermanconfig SYSVIPC_SYSCTL 432a5494dcdSEric W. Biederman bool 433a5494dcdSEric W. Biederman depends on SYSVIPC 434a5494dcdSEric W. Biederman depends on SYSCTL 435a5494dcdSEric W. Biederman default y 436a5494dcdSEric W. Biederman 4370cbed0eeSGuo Renconfig SYSVIPC_COMPAT 4380cbed0eeSGuo Ren def_bool y 4390cbed0eeSGuo Ren depends on COMPAT && SYSVIPC 4400cbed0eeSGuo Ren 4411da177e4SLinus Torvaldsconfig POSIX_MQUEUE 4421da177e4SLinus Torvalds bool "POSIX Message Queues" 44319c92399SKees Cook depends on NET 444a7f7f624SMasahiro Yamada help 4451da177e4SLinus Torvalds POSIX variant of message queues is a part of IPC. In POSIX message 4461da177e4SLinus Torvalds queues every message has a priority which decides about succession 4471da177e4SLinus Torvalds of receiving it by a process. If you want to compile and run 4481da177e4SLinus Torvalds programs written e.g. for Solaris with use of its POSIX message 449b0e37650SRobert P. J. Day queues (functions mq_*) say Y here. 4501da177e4SLinus Torvalds 4511da177e4SLinus Torvalds POSIX message queues are visible as a filesystem called 'mqueue' 4521da177e4SLinus Torvalds and can be mounted somewhere if you want to do filesystem 4531da177e4SLinus Torvalds operations on message queues. 4541da177e4SLinus Torvalds 4551da177e4SLinus Torvalds If unsure, say Y. 4561da177e4SLinus Torvalds 457bdc8e5f8SSerge E. Hallynconfig POSIX_MQUEUE_SYSCTL 458bdc8e5f8SSerge E. Hallyn bool 459bdc8e5f8SSerge E. Hallyn depends on POSIX_MQUEUE 460bdc8e5f8SSerge E. Hallyn depends on SYSCTL 461bdc8e5f8SSerge E. Hallyn default y 462bdc8e5f8SSerge E. Hallyn 463c73be61cSDavid Howellsconfig WATCH_QUEUE 464c73be61cSDavid Howells bool "General notification queue" 465c73be61cSDavid Howells default n 466c73be61cSDavid Howells help 467c73be61cSDavid Howells 468c73be61cSDavid Howells This is a general notification queue for the kernel to pass events to 469c73be61cSDavid Howells userspace by splicing them into pipes. It can be used in conjunction 470c73be61cSDavid Howells with watches for key/keyring change notifications and device 471c73be61cSDavid Howells notifications. 472c73be61cSDavid Howells 473c02b872aSMauro Carvalho Chehab See Documentation/core-api/watch_queue.rst 474c73be61cSDavid Howells 475226b4ccdSKonstantin Khlebnikovconfig CROSS_MEMORY_ATTACH 476226b4ccdSKonstantin Khlebnikov bool "Enable process_vm_readv/writev syscalls" 477226b4ccdSKonstantin Khlebnikov depends on MMU 478226b4ccdSKonstantin Khlebnikov default y 479226b4ccdSKonstantin Khlebnikov help 480226b4ccdSKonstantin Khlebnikov Enabling this option adds the system calls process_vm_readv and 481226b4ccdSKonstantin Khlebnikov process_vm_writev which allow a process with the correct privileges 482a2a368d9SGeert Uytterhoeven to directly read from or write to another process' address space. 483226b4ccdSKonstantin Khlebnikov See the man page for more details. 484226b4ccdSKonstantin Khlebnikov 48569369a70SJosh Triplettconfig USELIB 4867374fa33SKees Cook bool "uselib syscall (for libc5 and earlier)" 4877374fa33SKees Cook default ALPHA || M68K || SPARC 48869369a70SJosh Triplett help 48969369a70SJosh Triplett This option enables the uselib syscall, a system call used in the 49069369a70SJosh Triplett dynamic linker from libc5 and earlier. glibc does not use this 49169369a70SJosh Triplett system call. If you intend to run programs built on libc5 or 49269369a70SJosh Triplett earlier, you may need to enable this syscall. Current systems 49369369a70SJosh Triplett running glibc can safely disable this. 49469369a70SJosh Triplett 4951da177e4SLinus Torvaldsconfig AUDIT 4961da177e4SLinus Torvalds bool "Auditing support" 497804a6a49SChris Wright depends on NET 4981da177e4SLinus Torvalds help 4991da177e4SLinus Torvalds Enable auditing infrastructure that can be used with another 5001da177e4SLinus Torvalds kernel subsystem, such as SELinux (which requires this for 501cb74ed27SPaul Moore logging of avc messages output). System call auditing is included 502cb74ed27SPaul Moore on architectures which support it. 5031da177e4SLinus Torvalds 5047a017721SAKASHI Takahiroconfig HAVE_ARCH_AUDITSYSCALL 5057a017721SAKASHI Takahiro bool 5067a017721SAKASHI Takahiro 5071da177e4SLinus Torvaldsconfig AUDITSYSCALL 508cb74ed27SPaul Moore def_bool y 5097a017721SAKASHI Takahiro depends on AUDIT && HAVE_ARCH_AUDITSYSCALL 51028a3a7ebSEric Paris select FSNOTIFY 51174c3cbe3SAl Viro 512d9817ebeSThomas Gleixnersource "kernel/irq/Kconfig" 513764e0da1SThomas Gleixnersource "kernel/time/Kconfig" 514b24abcffSDaniel Borkmannsource "kernel/bpf/Kconfig" 51587a4c375SChristoph Hellwigsource "kernel/Kconfig.preempt" 516d9817ebeSThomas Gleixner 517391dc69cSFrederic Weisbeckermenu "CPU/Task time and stats accounting" 518391dc69cSFrederic Weisbecker 519abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING 520abf917cdSFrederic Weisbecker bool 521abf917cdSFrederic Weisbecker 522fdf9c356SFrederic Weisbeckerchoice 523fdf9c356SFrederic Weisbecker prompt "Cputime accounting" 52402382affSNicholas Piggin default TICK_CPU_ACCOUNTING 525fdf9c356SFrederic Weisbecker 526fdf9c356SFrederic Weisbecker# Kind of a stub config for the pure tick based cputime accounting 527fdf9c356SFrederic Weisbeckerconfig TICK_CPU_ACCOUNTING 528fdf9c356SFrederic Weisbecker bool "Simple tick based cputime accounting" 529c58b0df1SFrederic Weisbecker depends on !S390 && !NO_HZ_FULL 530fdf9c356SFrederic Weisbecker help 531fdf9c356SFrederic Weisbecker This is the basic tick based cputime accounting that maintains 532fdf9c356SFrederic Weisbecker statistics about user, system and idle time spent on per jiffies 533fdf9c356SFrederic Weisbecker granularity. 534fdf9c356SFrederic Weisbecker 535fdf9c356SFrederic Weisbecker If unsure, say Y. 536fdf9c356SFrederic Weisbecker 537abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_NATIVE 538391dc69cSFrederic Weisbecker bool "Deterministic task and CPU time accounting" 539c58b0df1SFrederic Weisbecker depends on HAVE_VIRT_CPU_ACCOUNTING && !NO_HZ_FULL 540abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 541391dc69cSFrederic Weisbecker help 542391dc69cSFrederic Weisbecker Select this option to enable more accurate task and CPU time 543391dc69cSFrederic Weisbecker accounting. This is done by reading a CPU counter on each 544391dc69cSFrederic Weisbecker kernel entry and exit and on transitions within the kernel 545391dc69cSFrederic Weisbecker between system, softirq and hardirq state, so there is a 546391dc69cSFrederic Weisbecker small performance impact. In the case of s390 or IBM POWER > 5, 547391dc69cSFrederic Weisbecker this also enables accounting of stolen time on logically-partitioned 548391dc69cSFrederic Weisbecker systems. 549391dc69cSFrederic Weisbecker 550abf917cdSFrederic Weisbeckerconfig VIRT_CPU_ACCOUNTING_GEN 551abf917cdSFrederic Weisbecker bool "Full dynticks CPU time accounting" 55224a9c541SFrederic Weisbecker depends on HAVE_CONTEXT_TRACKING_USER 553554b0004SKevin Hilman depends on HAVE_VIRT_CPU_ACCOUNTING_GEN 554041a1574SArnd Bergmann depends on GENERIC_CLOCKEVENTS 555abf917cdSFrederic Weisbecker select VIRT_CPU_ACCOUNTING 55624a9c541SFrederic Weisbecker select CONTEXT_TRACKING_USER 557abf917cdSFrederic Weisbecker help 558abf917cdSFrederic Weisbecker Select this option to enable task and CPU time accounting on full 559abf917cdSFrederic Weisbecker dynticks systems. This accounting is implemented by watching every 560abf917cdSFrederic Weisbecker kernel-user boundaries using the context tracking subsystem. 561abf917cdSFrederic Weisbecker The accounting is thus performed at the expense of some significant 562abf917cdSFrederic Weisbecker overhead. 563abf917cdSFrederic Weisbecker 564abf917cdSFrederic Weisbecker For now this is only useful if you are working on the full 565abf917cdSFrederic Weisbecker dynticks subsystem development. 566abf917cdSFrederic Weisbecker 567abf917cdSFrederic Weisbecker If unsure, say N. 568abf917cdSFrederic Weisbecker 569b58c3584SRik van Rielendchoice 570b58c3584SRik van Riel 571fdf9c356SFrederic Weisbeckerconfig IRQ_TIME_ACCOUNTING 572fdf9c356SFrederic Weisbecker bool "Fine granularity task level IRQ time accounting" 573b58c3584SRik van Riel depends on HAVE_IRQ_TIME_ACCOUNTING && !VIRT_CPU_ACCOUNTING_NATIVE 574fdf9c356SFrederic Weisbecker help 575fdf9c356SFrederic Weisbecker Select this option to enable fine granularity task irq time 576fdf9c356SFrederic Weisbecker accounting. This is done by reading a timestamp on each 577fdf9c356SFrederic Weisbecker transitions between softirq and hardirq state, so there can be a 578fdf9c356SFrederic Weisbecker small performance impact. 579fdf9c356SFrederic Weisbecker 580fdf9c356SFrederic Weisbecker If in doubt, say N here. 581fdf9c356SFrederic Weisbecker 58211d4afd4SVincent Guittotconfig HAVE_SCHED_AVG_IRQ 58311d4afd4SVincent Guittot def_bool y 58411d4afd4SVincent Guittot depends on IRQ_TIME_ACCOUNTING || PARAVIRT_TIME_ACCOUNTING 58511d4afd4SVincent Guittot depends on SMP 58611d4afd4SVincent Guittot 587d4dbc991SVincent Guittotconfig SCHED_HW_PRESSURE 58898eb401dSValentin Schneider bool 589fcd7c9c3SValentin Schneider default y if ARM && ARM_CPU_TOPOLOGY 590fcd7c9c3SValentin Schneider default y if ARM64 59176504793SThara Gopinath depends on SMP 59298eb401dSValentin Schneider depends on CPU_FREQ_THERMAL 59398eb401dSValentin Schneider help 594d4dbc991SVincent Guittot Select this option to enable HW pressure accounting in the 595d4dbc991SVincent Guittot scheduler. HW pressure is the value conveyed to the scheduler 59698eb401dSValentin Schneider that reflects the reduction in CPU compute capacity resulted from 597d4dbc991SVincent Guittot HW throttling. HW throttling occurs when the performance of 598d4dbc991SVincent Guittot a CPU is capped due to high operating temperatures as an example. 59998eb401dSValentin Schneider 60098eb401dSValentin Schneider If selected, the scheduler will be able to balance tasks accordingly, 60198eb401dSValentin Schneider i.e. put less load on throttled CPUs than on non/less throttled ones. 60298eb401dSValentin Schneider 60398eb401dSValentin Schneider This requires the architecture to implement 604d4dbc991SVincent Guittot arch_update_hw_pressure() and arch_scale_thermal_pressure(). 60576504793SThara Gopinath 606391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT 607391dc69cSFrederic Weisbecker bool "BSD Process Accounting" 6082813893fSIulia Manda depends on MULTIUSER 609391dc69cSFrederic Weisbecker help 610391dc69cSFrederic Weisbecker If you say Y here, a user level program will be able to instruct the 611391dc69cSFrederic Weisbecker kernel (via a special system call) to write process accounting 612391dc69cSFrederic Weisbecker information to a file: whenever a process exits, information about 613391dc69cSFrederic Weisbecker that process will be appended to the file by the kernel. The 614391dc69cSFrederic Weisbecker information includes things such as creation time, owning user, 615391dc69cSFrederic Weisbecker command name, memory usage, controlling terminal etc. (the complete 616391dc69cSFrederic Weisbecker list is in the struct acct in <file:include/linux/acct.h>). It is 617391dc69cSFrederic Weisbecker up to the user level program to do useful things with this 618391dc69cSFrederic Weisbecker information. This is generally a good idea, so say Y. 619391dc69cSFrederic Weisbecker 620391dc69cSFrederic Weisbeckerconfig BSD_PROCESS_ACCT_V3 621391dc69cSFrederic Weisbecker bool "BSD Process Accounting version 3 file format" 622391dc69cSFrederic Weisbecker depends on BSD_PROCESS_ACCT 623391dc69cSFrederic Weisbecker default n 624391dc69cSFrederic Weisbecker help 625391dc69cSFrederic Weisbecker If you say Y here, the process accounting information is written 626391dc69cSFrederic Weisbecker in a new file format that also logs the process IDs of each 6273903bf94SRandy Dunlap process and its parent. Note that this file format is incompatible 628391dc69cSFrederic Weisbecker with previous v0/v1/v2 file formats, so you will need updated tools 629391dc69cSFrederic Weisbecker for processing it. A preliminary version of these tools is available 630391dc69cSFrederic Weisbecker at <http://www.gnu.org/software/acct/>. 631391dc69cSFrederic Weisbecker 632391dc69cSFrederic Weisbeckerconfig TASKSTATS 63319c92399SKees Cook bool "Export task/process statistics through netlink" 634391dc69cSFrederic Weisbecker depends on NET 6352813893fSIulia Manda depends on MULTIUSER 636391dc69cSFrederic Weisbecker default n 637391dc69cSFrederic Weisbecker help 638391dc69cSFrederic Weisbecker Export selected statistics for tasks/processes through the 639391dc69cSFrederic Weisbecker generic netlink interface. Unlike BSD process accounting, the 640391dc69cSFrederic Weisbecker statistics are available during the lifetime of tasks/processes as 641391dc69cSFrederic Weisbecker responses to commands. Like BSD accounting, they are sent to user 642391dc69cSFrederic Weisbecker space on task exit. 643391dc69cSFrederic Weisbecker 644391dc69cSFrederic Weisbecker Say N if unsure. 645391dc69cSFrederic Weisbecker 646391dc69cSFrederic Weisbeckerconfig TASK_DELAY_ACCT 64719c92399SKees Cook bool "Enable per-task delay accounting" 648391dc69cSFrederic Weisbecker depends on TASKSTATS 649f6db8347SNaveen N. Rao select SCHED_INFO 650391dc69cSFrederic Weisbecker help 651391dc69cSFrederic Weisbecker Collect information on time spent by a task waiting for system 652391dc69cSFrederic Weisbecker resources like cpu, synchronous block I/O completion and swapping 653391dc69cSFrederic Weisbecker in pages. Such statistics can help in setting a task's priorities 654391dc69cSFrederic Weisbecker relative to other tasks for cpu, io, rss limits etc. 655391dc69cSFrederic Weisbecker 656391dc69cSFrederic Weisbecker Say N if unsure. 657391dc69cSFrederic Weisbecker 658391dc69cSFrederic Weisbeckerconfig TASK_XACCT 65919c92399SKees Cook bool "Enable extended accounting over taskstats" 660391dc69cSFrederic Weisbecker depends on TASKSTATS 661391dc69cSFrederic Weisbecker help 662391dc69cSFrederic Weisbecker Collect extended task accounting data and send the data 663391dc69cSFrederic Weisbecker to userland for processing over the taskstats interface. 664391dc69cSFrederic Weisbecker 665391dc69cSFrederic Weisbecker Say N if unsure. 666391dc69cSFrederic Weisbecker 667391dc69cSFrederic Weisbeckerconfig TASK_IO_ACCOUNTING 66819c92399SKees Cook bool "Enable per-task storage I/O accounting" 669391dc69cSFrederic Weisbecker depends on TASK_XACCT 670391dc69cSFrederic Weisbecker help 671391dc69cSFrederic Weisbecker Collect information on the number of bytes of storage I/O which this 672391dc69cSFrederic Weisbecker task has caused. 673391dc69cSFrederic Weisbecker 674391dc69cSFrederic Weisbecker Say N if unsure. 675391dc69cSFrederic Weisbecker 676eb414681SJohannes Weinerconfig PSI 677eb414681SJohannes Weiner bool "Pressure stall information tracking" 67898dfdd9eSRandy Dunlap select KERNFS 679eb414681SJohannes Weiner help 680eb414681SJohannes Weiner Collect metrics that indicate how overcommitted the CPU, memory, 681eb414681SJohannes Weiner and IO capacity are in the system. 682eb414681SJohannes Weiner 683eb414681SJohannes Weiner If you say Y here, the kernel will create /proc/pressure/ with the 684eb414681SJohannes Weiner pressure statistics files cpu, memory, and io. These will indicate 685eb414681SJohannes Weiner the share of walltime in which some or all tasks in the system are 686eb414681SJohannes Weiner delayed due to contention of the respective resource. 687eb414681SJohannes Weiner 6882ce7135aSJohannes Weiner In kernels with cgroup support, cgroups (cgroup2 only) will 6892ce7135aSJohannes Weiner have cpu.pressure, memory.pressure, and io.pressure files, 6902ce7135aSJohannes Weiner which aggregate pressure stalls for the grouped tasks only. 6912ce7135aSJohannes Weiner 692c3123552SMauro Carvalho Chehab For more details see Documentation/accounting/psi.rst. 693eb414681SJohannes Weiner 694eb414681SJohannes Weiner Say N if unsure. 695eb414681SJohannes Weiner 696e0c27447SJohannes Weinerconfig PSI_DEFAULT_DISABLED 697e0c27447SJohannes Weiner bool "Require boot parameter to enable pressure stall information tracking" 698e0c27447SJohannes Weiner default n 699e0c27447SJohannes Weiner depends on PSI 700e0c27447SJohannes Weiner help 701e0c27447SJohannes Weiner If set, pressure stall information tracking will be disabled 702428a1cb4SBaruch Siach per default but can be enabled through passing psi=1 on the 703428a1cb4SBaruch Siach kernel commandline during boot. 704e0c27447SJohannes Weiner 7057b2489d3SJohannes Weiner This feature adds some code to the task wakeup and sleep 7067b2489d3SJohannes Weiner paths of the scheduler. The overhead is too low to affect 7077b2489d3SJohannes Weiner common scheduling-intense workloads in practice (such as 7087b2489d3SJohannes Weiner webservers, memcache), but it does show up in artificial 7097b2489d3SJohannes Weiner scheduler stress tests, such as hackbench. 7107b2489d3SJohannes Weiner 7117b2489d3SJohannes Weiner If you are paranoid and not sure what the kernel will be 7127b2489d3SJohannes Weiner used for, say Y. 7137b2489d3SJohannes Weiner 7147b2489d3SJohannes Weiner Say N if unsure. 7157b2489d3SJohannes Weiner 716391dc69cSFrederic Weisbeckerendmenu # "CPU/Task time and stats accounting" 717391dc69cSFrederic Weisbecker 7185c4991e2SFrederic Weisbeckerconfig CPU_ISOLATION 7195c4991e2SFrederic Weisbecker bool "CPU isolation" 72097577684SOleg Nesterov depends on SMP 7212c43838cSFrederic Weisbecker default y 7225c4991e2SFrederic Weisbecker help 7235c4991e2SFrederic Weisbecker Make sure that CPUs running critical tasks are not disturbed by 7245c4991e2SFrederic Weisbecker any source of "noise" such as unbound workqueues, timers, kthreads... 7252c43838cSFrederic Weisbecker Unbound jobs get offloaded to housekeeping CPUs. This is driven by 7262c43838cSFrederic Weisbecker the "isolcpus=" boot parameter. 7272c43838cSFrederic Weisbecker 7282c43838cSFrederic Weisbecker Say Y if unsure. 7295c4991e2SFrederic Weisbecker 7300af92d46SPaul E. McKenneysource "kernel/rcu/Kconfig" 731c903ff83SMike Travis 7321da177e4SLinus Torvaldsconfig IKCONFIG 733f2443ab6SRoss Biro tristate "Kernel .config support" 734a7f7f624SMasahiro Yamada help 7351da177e4SLinus Torvalds This option enables the complete Linux kernel ".config" file 7361da177e4SLinus Torvalds contents to be saved in the kernel. It provides documentation 7371da177e4SLinus Torvalds of which kernel options are used in a running kernel or in an 7381da177e4SLinus Torvalds on-disk kernel. This information can be extracted from the kernel 7391da177e4SLinus Torvalds image file with the script scripts/extract-ikconfig and used as 7401da177e4SLinus Torvalds input to rebuild the current kernel or to build another kernel. 7411da177e4SLinus Torvalds It can also be extracted from a running kernel by reading 7421da177e4SLinus Torvalds /proc/config.gz if enabled (below). 7431da177e4SLinus Torvalds 7441da177e4SLinus Torvaldsconfig IKCONFIG_PROC 7451da177e4SLinus Torvalds bool "Enable access to .config through /proc/config.gz" 7461da177e4SLinus Torvalds depends on IKCONFIG && PROC_FS 747a7f7f624SMasahiro Yamada help 7481da177e4SLinus Torvalds This option enables access to the kernel configuration file 7491da177e4SLinus Torvalds through /proc/config.gz. 7501da177e4SLinus Torvalds 751f7b101d3SJoel Fernandes (Google)config IKHEADERS 752f7b101d3SJoel Fernandes (Google) tristate "Enable kernel headers through /sys/kernel/kheaders.tar.xz" 753f7b101d3SJoel Fernandes (Google) depends on SYSFS 75443d8ce9dSJoel Fernandes (Google) help 755f7b101d3SJoel Fernandes (Google) This option enables access to the in-kernel headers that are generated during 756f7b101d3SJoel Fernandes (Google) the build process. These can be used to build eBPF tracing programs, 757f7b101d3SJoel Fernandes (Google) or similar programs. If you build the headers as a module, a module called 758f7b101d3SJoel Fernandes (Google) kheaders.ko is built which can be loaded on-demand to get access to headers. 75943d8ce9dSJoel Fernandes (Google) 760794543a2SAlistair John Strachanconfig LOG_BUF_SHIFT 761794543a2SAlistair John Strachan int "Kernel log buffer size (16 => 64KB, 17 => 128KB)" 7621c4b5ecbSChristoph Hellwig range 12 25 763f17a32e9SAdrian Bunk default 17 764361e9dfbSJosh Triplett depends on PRINTK 765794543a2SAlistair John Strachan help 76623b2899fSLuis R. Rodriguez Select the minimal kernel log buffer size as a power of 2. 76723b2899fSLuis R. Rodriguez The final size is affected by LOG_CPU_MAX_BUF_SHIFT config 76823b2899fSLuis R. Rodriguez parameter, see below. Any higher size also might be forced 76923b2899fSLuis R. Rodriguez by "log_buf_len" boot parameter. 77023b2899fSLuis R. Rodriguez 771f17a32e9SAdrian Bunk Examples: 772f17a32e9SAdrian Bunk 17 => 128 KB 773f17a32e9SAdrian Bunk 16 => 64 KB 774f17a32e9SAdrian Bunk 15 => 32 KB 775f17a32e9SAdrian Bunk 14 => 16 KB 776794543a2SAlistair John Strachan 13 => 8 KB 777794543a2SAlistair John Strachan 12 => 4 KB 778794543a2SAlistair John Strachan 77923b2899fSLuis R. Rodriguezconfig LOG_CPU_MAX_BUF_SHIFT 78023b2899fSLuis R. Rodriguez int "CPU kernel log buffer size contribution (13 => 8 KB, 17 => 128KB)" 7812240a31dSGeert Uytterhoeven depends on SMP 78223b2899fSLuis R. Rodriguez range 0 21 78323b2899fSLuis R. Rodriguez default 0 if BASE_SMALL 784320bf431SYoann Congal default 12 785361e9dfbSJosh Triplett depends on PRINTK 78623b2899fSLuis R. Rodriguez help 78723b2899fSLuis R. Rodriguez This option allows to increase the default ring buffer size 78823b2899fSLuis R. Rodriguez according to the number of CPUs. The value defines the contribution 78923b2899fSLuis R. Rodriguez of each CPU as a power of 2. The used space is typically only few 79023b2899fSLuis R. Rodriguez lines however it might be much more when problems are reported, 79123b2899fSLuis R. Rodriguez e.g. backtraces. 79223b2899fSLuis R. Rodriguez 79323b2899fSLuis R. Rodriguez The increased size means that a new buffer has to be allocated and 79423b2899fSLuis R. Rodriguez the original static one is unused. It makes sense only on systems 79523b2899fSLuis R. Rodriguez with more CPUs. Therefore this value is used only when the sum of 79623b2899fSLuis R. Rodriguez contributions is greater than the half of the default kernel ring 79723b2899fSLuis R. Rodriguez buffer as defined by LOG_BUF_SHIFT. The default values are set 7980f7636e1SPaul Menzel so that more than 16 CPUs are needed to trigger the allocation. 79923b2899fSLuis R. Rodriguez 80023b2899fSLuis R. Rodriguez Also this option is ignored when "log_buf_len" kernel parameter is 80123b2899fSLuis R. Rodriguez used as it forces an exact (power of two) size of the ring buffer. 80223b2899fSLuis R. Rodriguez 80323b2899fSLuis R. Rodriguez The number of possible CPUs is used for this computation ignoring 8045e0d8d59SGeert Uytterhoeven hotplugging making the computation optimal for the worst case 8055e0d8d59SGeert Uytterhoeven scenario while allowing a simple algorithm to be used from bootup. 80623b2899fSLuis R. Rodriguez 80723b2899fSLuis R. Rodriguez Examples shift values and their meaning: 80823b2899fSLuis R. Rodriguez 17 => 128 KB for each CPU 80923b2899fSLuis R. Rodriguez 16 => 64 KB for each CPU 81023b2899fSLuis R. Rodriguez 15 => 32 KB for each CPU 81123b2899fSLuis R. Rodriguez 14 => 16 KB for each CPU 81223b2899fSLuis R. Rodriguez 13 => 8 KB for each CPU 81323b2899fSLuis R. Rodriguez 12 => 4 KB for each CPU 81423b2899fSLuis R. Rodriguez 81533701557SChris Downconfig PRINTK_INDEX 81633701557SChris Down bool "Printk indexing debugfs interface" 81733701557SChris Down depends on PRINTK && DEBUG_FS 81833701557SChris Down help 81933701557SChris Down Add support for indexing of all printk formats known at compile time 82033701557SChris Down at <debugfs>/printk/index/<module>. 82133701557SChris Down 82233701557SChris Down This can be used as part of maintaining daemons which monitor 82333701557SChris Down /dev/kmsg, as it permits auditing the printk formats present in a 82433701557SChris Down kernel, allowing detection of cases where monitored printks are 82533701557SChris Down changed or no longer present. 82633701557SChris Down 82733701557SChris Down There is no additional runtime cost to printk with this enabled. 82833701557SChris Down 8295cdc38f9SKAMEZAWA Hiroyuki# 8305cdc38f9SKAMEZAWA Hiroyuki# Architectures with an unreliable sched_clock() should select this: 8315cdc38f9SKAMEZAWA Hiroyuki# 8325cdc38f9SKAMEZAWA Hiroyukiconfig HAVE_UNSTABLE_SCHED_CLOCK 8335cdc38f9SKAMEZAWA Hiroyuki bool 8345cdc38f9SKAMEZAWA Hiroyuki 83538ff87f7SStephen Boydconfig GENERIC_SCHED_CLOCK 83638ff87f7SStephen Boyd bool 83738ff87f7SStephen Boyd 83869842cbaSPatrick Bellasimenu "Scheduler features" 83969842cbaSPatrick Bellasi 84069842cbaSPatrick Bellasiconfig UCLAMP_TASK 84169842cbaSPatrick Bellasi bool "Enable utilization clamping for RT/FAIR tasks" 84269842cbaSPatrick Bellasi depends on CPU_FREQ_GOV_SCHEDUTIL 84369842cbaSPatrick Bellasi help 84469842cbaSPatrick Bellasi This feature enables the scheduler to track the clamped utilization 84569842cbaSPatrick Bellasi of each CPU based on RUNNABLE tasks scheduled on that CPU. 84669842cbaSPatrick Bellasi 84769842cbaSPatrick Bellasi With this option, the user can specify the min and max CPU 84869842cbaSPatrick Bellasi utilization allowed for RUNNABLE tasks. The max utilization defines 84969842cbaSPatrick Bellasi the maximum frequency a task should use while the min utilization 85069842cbaSPatrick Bellasi defines the minimum frequency it should use. 85169842cbaSPatrick Bellasi 85269842cbaSPatrick Bellasi Both min and max utilization clamp values are hints to the scheduler, 85369842cbaSPatrick Bellasi aiming at improving its frequency selection policy, but they do not 85469842cbaSPatrick Bellasi enforce or grant any specific bandwidth for tasks. 85569842cbaSPatrick Bellasi 85669842cbaSPatrick Bellasi If in doubt, say N. 85769842cbaSPatrick Bellasi 85869842cbaSPatrick Bellasiconfig UCLAMP_BUCKETS_COUNT 85969842cbaSPatrick Bellasi int "Number of supported utilization clamp buckets" 86069842cbaSPatrick Bellasi range 5 20 86169842cbaSPatrick Bellasi default 5 86269842cbaSPatrick Bellasi depends on UCLAMP_TASK 86369842cbaSPatrick Bellasi help 86469842cbaSPatrick Bellasi Defines the number of clamp buckets to use. The range of each bucket 86569842cbaSPatrick Bellasi will be SCHED_CAPACITY_SCALE/UCLAMP_BUCKETS_COUNT. The higher the 86669842cbaSPatrick Bellasi number of clamp buckets the finer their granularity and the higher 86769842cbaSPatrick Bellasi the precision of clamping aggregation and tracking at run-time. 86869842cbaSPatrick Bellasi 86969842cbaSPatrick Bellasi For example, with the minimum configuration value we will have 5 87069842cbaSPatrick Bellasi clamp buckets tracking 20% utilization each. A 25% boosted tasks will 87169842cbaSPatrick Bellasi be refcounted in the [20..39]% bucket and will set the bucket clamp 87269842cbaSPatrick Bellasi effective value to 25%. 87369842cbaSPatrick Bellasi If a second 30% boosted task should be co-scheduled on the same CPU, 87469842cbaSPatrick Bellasi that task will be refcounted in the same bucket of the first task and 87569842cbaSPatrick Bellasi it will boost the bucket clamp effective value to 30%. 87669842cbaSPatrick Bellasi The clamp effective value of a bucket is reset to its nominal value 87769842cbaSPatrick Bellasi (20% in the example above) when there are no more tasks refcounted in 87869842cbaSPatrick Bellasi that bucket. 87969842cbaSPatrick Bellasi 88069842cbaSPatrick Bellasi An additional boost/capping margin can be added to some tasks. In the 88169842cbaSPatrick Bellasi example above the 25% task will be boosted to 30% until it exits the 88269842cbaSPatrick Bellasi CPU. If that should be considered not acceptable on certain systems, 88369842cbaSPatrick Bellasi it's always possible to reduce the margin by increasing the number of 88469842cbaSPatrick Bellasi clamp buckets to trade off used memory for run-time tracking 88569842cbaSPatrick Bellasi precision. 88669842cbaSPatrick Bellasi 88769842cbaSPatrick Bellasi If in doubt, use the default value. 88869842cbaSPatrick Bellasi 88969842cbaSPatrick Bellasiendmenu 89069842cbaSPatrick Bellasi 891be3a7284SAndrea Arcangeli# 892be3a7284SAndrea Arcangeli# For architectures that want to enable the support for NUMA-affine scheduler 893be3a7284SAndrea Arcangeli# balancing logic: 894be3a7284SAndrea Arcangeli# 895be3a7284SAndrea Arcangeliconfig ARCH_SUPPORTS_NUMA_BALANCING 896be3a7284SAndrea Arcangeli bool 897be3a7284SAndrea Arcangeli 898be5e610cSPeter Zijlstra# 89972b252aeSMel Gorman# For architectures that prefer to flush all TLBs after a number of pages 90072b252aeSMel Gorman# are unmapped instead of sending one IPI per page to flush. The architecture 90172b252aeSMel Gorman# must provide guarantees on what happens if a clean TLB cache entry is 90272b252aeSMel Gorman# written after the unmap. Details are in mm/rmap.c near the check for 90372b252aeSMel Gorman# should_defer_flush. The architecture should also consider if the full flush 90472b252aeSMel Gorman# and the refill costs are offset by the savings of sending fewer IPIs. 90572b252aeSMel Gormanconfig ARCH_WANT_BATCHED_UNMAP_TLB_FLUSH 90672b252aeSMel Gorman bool 90772b252aeSMel Gorman 908c12d3362SArd Biesheuvelconfig CC_HAS_INT128 9093a7c7331SMasahiro Yamada def_bool !$(cc-option,$(m64-flag) -D__SIZEOF_INT128__=0) && 64BIT 910c12d3362SArd Biesheuvel 911dee2b702SGustavo A. R. Silvaconfig CC_IMPLICIT_FALLTHROUGH 912dee2b702SGustavo A. R. Silva string 913158ea2d2SGustavo A. R. Silva default "-Wimplicit-fallthrough=5" if CC_IS_GCC && $(cc-option,-Wimplicit-fallthrough=5) 914dee2b702SGustavo A. R. Silva default "-Wimplicit-fallthrough" if CC_IS_CLANG && $(cc-option,-Wunreachable-code-fallthrough) 915dee2b702SGustavo A. R. Silva 9163e00f580SKees Cook# Currently, disable gcc-10+ array-bounds globally. 9170da6e5fdSLinus Torvalds# It's still broken in gcc-13, so no upper bound yet. 9183e00f580SKees Cookconfig GCC10_NO_ARRAY_BOUNDS 9195a41237aSLinus Torvalds def_bool y 9205a41237aSLinus Torvalds 921f0be87c4SLinus Torvaldsconfig CC_NO_ARRAY_BOUNDS 922f0be87c4SLinus Torvalds bool 9238e5bd4eaSYury Norov default y if CC_IS_GCC && GCC_VERSION >= 90000 && GCC10_NO_ARRAY_BOUNDS 924f0be87c4SLinus Torvalds 92502153319SLinus Torvalds# Currently, disable -Wstringop-overflow for GCC globally. 92602153319SLinus Torvaldsconfig GCC_NO_STRINGOP_OVERFLOW 927a5e0ace0SGustavo A. R. Silva def_bool y 928a5e0ace0SGustavo A. R. Silva 929a5e0ace0SGustavo A. R. Silvaconfig CC_NO_STRINGOP_OVERFLOW 930a5e0ace0SGustavo A. R. Silva bool 93102153319SLinus Torvalds default y if CC_IS_GCC && GCC_NO_STRINGOP_OVERFLOW 932a5e0ace0SGustavo A. R. Silva 933a5e0ace0SGustavo A. R. Silvaconfig CC_STRINGOP_OVERFLOW 934a5e0ace0SGustavo A. R. Silva bool 935a5e0ace0SGustavo A. R. Silva default y if CC_IS_GCC && !CC_NO_STRINGOP_OVERFLOW 936a5e0ace0SGustavo A. R. Silva 93772b252aeSMel Gorman# 938be5e610cSPeter Zijlstra# For architectures that know their GCC __int128 support is sound 939be5e610cSPeter Zijlstra# 940be5e610cSPeter Zijlstraconfig ARCH_SUPPORTS_INT128 941be5e610cSPeter Zijlstra bool 942be5e610cSPeter Zijlstra 943be3a7284SAndrea Arcangeli# For architectures that (ab)use NUMA to represent different memory regions 944be3a7284SAndrea Arcangeli# all cpu-local but of different latencies, such as SuperH. 945be3a7284SAndrea Arcangeli# 946be3a7284SAndrea Arcangeliconfig ARCH_WANT_NUMA_VARIABLE_LOCALITY 947be3a7284SAndrea Arcangeli bool 948be3a7284SAndrea Arcangeli 949be3a7284SAndrea Arcangeliconfig NUMA_BALANCING 950be3a7284SAndrea Arcangeli bool "Memory placement aware NUMA scheduler" 951be3a7284SAndrea Arcangeli depends on ARCH_SUPPORTS_NUMA_BALANCING 952be3a7284SAndrea Arcangeli depends on !ARCH_WANT_NUMA_VARIABLE_LOCALITY 953554b0f3cSSebastian Andrzej Siewior depends on SMP && NUMA && MIGRATION && !PREEMPT_RT 954be3a7284SAndrea Arcangeli help 955be3a7284SAndrea Arcangeli This option adds support for automatic NUMA aware memory/task placement. 956be3a7284SAndrea Arcangeli The mechanism is quite primitive and is based on migrating memory when 9576d56a410SPaul Gortmaker it has references to the node the task is running on. 958be3a7284SAndrea Arcangeli 959be3a7284SAndrea Arcangeli This system will be inactive on UMA systems. 960be3a7284SAndrea Arcangeli 9616f7c97e8SAneesh Kumar K.Vconfig NUMA_BALANCING_DEFAULT_ENABLED 9626f7c97e8SAneesh Kumar K.V bool "Automatically enable NUMA aware memory/task placement" 9636f7c97e8SAneesh Kumar K.V default y 9646f7c97e8SAneesh Kumar K.V depends on NUMA_BALANCING 9656f7c97e8SAneesh Kumar K.V help 9666f7c97e8SAneesh Kumar K.V If set, automatic NUMA balancing will be enabled if running on a NUMA 9676f7c97e8SAneesh Kumar K.V machine. 9686f7c97e8SAneesh Kumar K.V 96921c690a3SSuren Baghdasaryanconfig SLAB_OBJ_EXT 97021c690a3SSuren Baghdasaryan bool 97121c690a3SSuren Baghdasaryan 97223964d2dSLi Zefanmenuconfig CGROUPS 9736341e62bSChristoph Jaeger bool "Control Group support" 9742bd59d48STejun Heo select KERNFS 975ddbcc7e8SPaul Menage help 97623964d2dSLi Zefan This option adds support for grouping sets of processes together, for 9775cdc38f9SKAMEZAWA Hiroyuki use with process control subsystems such as Cpusets, CFS, memory 9785cdc38f9SKAMEZAWA Hiroyuki controls or device isolation. 9795cdc38f9SKAMEZAWA Hiroyuki See 980d6a3b247SMauro Carvalho Chehab - Documentation/scheduler/sched-design-CFS.rst (CFS) 981da82c92fSMauro Carvalho Chehab - Documentation/admin-guide/cgroup-v1/ (features for grouping, isolation 98245ce80fbSLi Zefan and resource control) 983ddbcc7e8SPaul Menage 984ddbcc7e8SPaul Menage Say N if unsure. 985ddbcc7e8SPaul Menage 98623964d2dSLi Zefanif CGROUPS 98723964d2dSLi Zefan 9883e32cb2eSJohannes Weinerconfig PAGE_COUNTER 9893e32cb2eSJohannes Weiner bool 9903e32cb2eSJohannes Weiner 9916a010a49STejun Heoconfig CGROUP_FAVOR_DYNMODS 9926a010a49STejun Heo bool "Favor dynamic modification latency reduction by default" 9936a010a49STejun Heo help 9946a010a49STejun Heo This option enables the "favordynmods" mount option by default 9956a010a49STejun Heo which reduces the latencies of dynamic cgroup modifications such 9966a010a49STejun Heo as task migrations and controller on/offs at the cost of making 9976a010a49STejun Heo hot path operations such as forks and exits more expensive. 9986a010a49STejun Heo 9996a010a49STejun Heo Say N if unsure. 10006a010a49STejun Heo 1001c255a458SAndrew Mortonconfig MEMCG 1002a0166ec4SJohannes Weiner bool "Memory controller" 10033e32cb2eSJohannes Weiner select PAGE_COUNTER 100479bd9814STejun Heo select EVENTFD 100521c690a3SSuren Baghdasaryan select SLAB_OBJ_EXT 100600f0b825SBalbir Singh help 1007a0166ec4SJohannes Weiner Provides control over the memory footprint of tasks in a cgroup. 100800f0b825SBalbir Singh 1009*25352d2fSShakeel Buttconfig MEMCG_NMI_UNSAFE 1010*25352d2fSShakeel Butt bool 1011*25352d2fSShakeel Butt depends on MEMCG 1012*25352d2fSShakeel Butt depends on HAVE_NMI 1013*25352d2fSShakeel Butt depends on !ARCH_HAS_NMI_SAFE_THIS_CPU_OPS && !ARCH_HAVE_NMI_SAFE_CMPXCHG 1014*25352d2fSShakeel Butt default y 1015*25352d2fSShakeel Butt 1016e93d4166SRoman Gushchinconfig MEMCG_V1 1017e93d4166SRoman Gushchin bool "Legacy cgroup v1 memory controller" 1018c9929f0eSVlastimil Babka depends on MEMCG 1019e93d4166SRoman Gushchin default n 1020e93d4166SRoman Gushchin help 1021e93d4166SRoman Gushchin Legacy cgroup v1 memory controller which has been deprecated by 1022e93d4166SRoman Gushchin cgroup v2 implementation. The v1 is there for legacy applications 1023e93d4166SRoman Gushchin which haven't migrated to the new cgroup v2 interface yet. If you 1024e93d4166SRoman Gushchin do not have any such application then you are completely fine leaving 1025e93d4166SRoman Gushchin this option disabled. 1026e93d4166SRoman Gushchin 1027e93d4166SRoman Gushchin Please note that feature set of the legacy memory controller is likely 1028e93d4166SRoman Gushchin going to shrink due to deprecation process. New deployments with v1 1029e93d4166SRoman Gushchin controller are highly discouraged. 1030e93d4166SRoman Gushchin 1031fcb4824bSValdis Kletnieks Say N if unsure. 103284c07d11SKirill Tkhai 10336bf024e6SJohannes Weinerconfig BLK_CGROUP 10346bf024e6SJohannes Weiner bool "IO controller" 10356bf024e6SJohannes Weiner depends on BLOCK 10362bc64a20SAneesh Kumar K.V default n 1037a7f7f624SMasahiro Yamada help 10386bf024e6SJohannes Weiner Generic block IO controller cgroup interface. This is the common 10396bf024e6SJohannes Weiner cgroup interface which should be used by various IO controlling 10406bf024e6SJohannes Weiner policies. 10412bc64a20SAneesh Kumar K.V 10426bf024e6SJohannes Weiner Currently, CFQ IO scheduler uses it to recognize task groups and 10436bf024e6SJohannes Weiner control disk bandwidth allocation (proportional time slice allocation) 10446bf024e6SJohannes Weiner to such task groups. It is also used by bio throttling logic in 10456bf024e6SJohannes Weiner block layer to implement upper limit in IO rates on a device. 1046e5d1367fSStephane Eranian 10476bf024e6SJohannes Weiner This option only enables generic Block IO controller infrastructure. 10486bf024e6SJohannes Weiner One needs to also enable actual IO controlling logic/policy. For 10496bf024e6SJohannes Weiner enabling proportional weight division of disk bandwidth in CFQ, set 10507baf2199SKrzysztof Kozlowski CONFIG_BFQ_GROUP_IOSCHED=y; for enabling throttling policy, set 10516bf024e6SJohannes Weiner CONFIG_BLK_DEV_THROTTLING=y. 10526bf024e6SJohannes Weiner 1053da82c92fSMauro Carvalho Chehab See Documentation/admin-guide/cgroup-v1/blkio-controller.rst for more information. 10546bf024e6SJohannes Weiner 10556bf024e6SJohannes Weinerconfig CGROUP_WRITEBACK 10566bf024e6SJohannes Weiner bool 10576bf024e6SJohannes Weiner depends on MEMCG && BLK_CGROUP 10586bf024e6SJohannes Weiner default y 1059e5d1367fSStephane Eranian 10607c941438SDhaval Gianimenuconfig CGROUP_SCHED 1061a0166ec4SJohannes Weiner bool "CPU controller" 10627c941438SDhaval Giani default n 10637c941438SDhaval Giani help 10647c941438SDhaval Giani This feature lets CPU scheduler recognize task groups and control CPU 10657c941438SDhaval Giani bandwidth allocation to such task groups. It uses cgroups to group 10667c941438SDhaval Giani tasks. 10677c941438SDhaval Giani 10687c941438SDhaval Gianiif CGROUP_SCHED 1069e179e80cSTejun Heoconfig GROUP_SCHED_WEIGHT 1070e179e80cSTejun Heo def_bool n 1071e179e80cSTejun Heo 10727c941438SDhaval Gianiconfig FAIR_GROUP_SCHED 10737c941438SDhaval Giani bool "Group scheduling for SCHED_OTHER" 10747c941438SDhaval Giani depends on CGROUP_SCHED 1075e179e80cSTejun Heo select GROUP_SCHED_WEIGHT 10767c941438SDhaval Giani default CGROUP_SCHED 10777c941438SDhaval Giani 1078ab84d31eSPaul Turnerconfig CFS_BANDWIDTH 1079ab84d31eSPaul Turner bool "CPU bandwidth provisioning for FAIR_GROUP_SCHED" 1080ab84d31eSPaul Turner depends on FAIR_GROUP_SCHED 1081ab84d31eSPaul Turner default n 1082ab84d31eSPaul Turner help 1083ab84d31eSPaul Turner This option allows users to define CPU bandwidth rates (limits) for 1084ab84d31eSPaul Turner tasks running within the fair group scheduler. Groups with no limit 1085ab84d31eSPaul Turner set are considered to be unconstrained and will run with no 1086ab84d31eSPaul Turner restriction. 1087d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-bwc.rst for more information. 1088ab84d31eSPaul Turner 10897c941438SDhaval Gianiconfig RT_GROUP_SCHED 10907c941438SDhaval Giani bool "Group scheduling for SCHED_RR/FIFO" 10917c941438SDhaval Giani depends on CGROUP_SCHED 10927c941438SDhaval Giani default n 10937c941438SDhaval Giani help 10947c941438SDhaval Giani This feature lets you explicitly allocate real CPU bandwidth 109532bd7eb5SLi Zefan to task groups. If enabled, it will also make it impossible to 10967c941438SDhaval Giani schedule realtime tasks for non-root users until you allocate 10977c941438SDhaval Giani realtime bandwidth for them. 1098d6a3b247SMauro Carvalho Chehab See Documentation/scheduler/sched-rt-group.rst for more information. 10997c941438SDhaval Giani 110081951366STejun Heoconfig EXT_GROUP_SCHED 110181951366STejun Heo bool 110281951366STejun Heo depends on SCHED_CLASS_EXT && CGROUP_SCHED 110381951366STejun Heo select GROUP_SCHED_WEIGHT 110481951366STejun Heo default y 110581951366STejun Heo 11067c941438SDhaval Gianiendif #CGROUP_SCHED 11077c941438SDhaval Giani 1108af7f588dSMathieu Desnoyersconfig SCHED_MM_CID 1109af7f588dSMathieu Desnoyers def_bool y 1110af7f588dSMathieu Desnoyers depends on SMP && RSEQ 1111af7f588dSMathieu Desnoyers 11122480c093SPatrick Bellasiconfig UCLAMP_TASK_GROUP 11132480c093SPatrick Bellasi bool "Utilization clamping per group of tasks" 11142480c093SPatrick Bellasi depends on CGROUP_SCHED 11152480c093SPatrick Bellasi depends on UCLAMP_TASK 11162480c093SPatrick Bellasi default n 11172480c093SPatrick Bellasi help 11182480c093SPatrick Bellasi This feature enables the scheduler to track the clamped utilization 11192480c093SPatrick Bellasi of each CPU based on RUNNABLE tasks currently scheduled on that CPU. 11202480c093SPatrick Bellasi 11212480c093SPatrick Bellasi When this option is enabled, the user can specify a min and max 11222480c093SPatrick Bellasi CPU bandwidth which is allowed for each single task in a group. 11232480c093SPatrick Bellasi The max bandwidth allows to clamp the maximum frequency a task 11242480c093SPatrick Bellasi can use, while the min bandwidth allows to define a minimum 11252480c093SPatrick Bellasi frequency a task will always use. 11262480c093SPatrick Bellasi 11272480c093SPatrick Bellasi When task group based utilization clamping is enabled, an eventually 11282480c093SPatrick Bellasi specified task-specific clamp value is constrained by the cgroup 11292480c093SPatrick Bellasi specified clamp value. Both minimum and maximum task clamping cannot 11302480c093SPatrick Bellasi be bigger than the corresponding clamping defined at task group level. 11312480c093SPatrick Bellasi 11322480c093SPatrick Bellasi If in doubt, say N. 11332480c093SPatrick Bellasi 11346bf024e6SJohannes Weinerconfig CGROUP_PIDS 11356bf024e6SJohannes Weiner bool "PIDs controller" 11366bf024e6SJohannes Weiner help 11376bf024e6SJohannes Weiner Provides enforcement of process number limits in the scope of a 11386bf024e6SJohannes Weiner cgroup. Any attempt to fork more processes than is allowed in the 11396bf024e6SJohannes Weiner cgroup will fail. PIDs are fundamentally a global resource because it 11406bf024e6SJohannes Weiner is fairly trivial to reach PID exhaustion before you reach even a 11416bf024e6SJohannes Weiner conservative kmemcg limit. As a result, it is possible to grind a 11426bf024e6SJohannes Weiner system to halt without being limited by other cgroup policies. The 11436cc578dfSParav Pandit PIDs controller is designed to stop this from happening. 11446bf024e6SJohannes Weiner 11456bf024e6SJohannes Weiner It should be noted that organisational operations (such as attaching 114698076833SJonathan Neuschäfer to a cgroup hierarchy) will *not* be blocked by the PIDs controller, 11476bf024e6SJohannes Weiner since the PIDs limit only affects a process's ability to fork, not to 11486bf024e6SJohannes Weiner attach to a cgroup. 11496bf024e6SJohannes Weiner 115039d3e758SParav Panditconfig CGROUP_RDMA 115139d3e758SParav Pandit bool "RDMA controller" 115239d3e758SParav Pandit help 115339d3e758SParav Pandit Provides enforcement of RDMA resources defined by IB stack. 115439d3e758SParav Pandit It is fairly easy for consumers to exhaust RDMA resources, which 115539d3e758SParav Pandit can result into resource unavailability to other consumers. 115639d3e758SParav Pandit RDMA controller is designed to stop this from happening. 115739d3e758SParav Pandit Attaching processes with active RDMA resources to the cgroup 115839d3e758SParav Pandit hierarchy is allowed even if can cross the hierarchy's limit. 115939d3e758SParav Pandit 1160b168ed45SMaarten Lankhorstconfig CGROUP_DMEM 1161b168ed45SMaarten Lankhorst bool "Device memory controller (DMEM)" 1162e33b5149SMaxime Ripard select PAGE_COUNTER 1163b168ed45SMaarten Lankhorst help 1164b168ed45SMaarten Lankhorst The DMEM controller allows compatible devices to restrict device 1165b168ed45SMaarten Lankhorst memory usage based on the cgroup hierarchy. 1166b168ed45SMaarten Lankhorst 1167b168ed45SMaarten Lankhorst As an example, it allows you to restrict VRAM usage for applications 1168b168ed45SMaarten Lankhorst in the DRM subsystem. 1169b168ed45SMaarten Lankhorst 11706bf024e6SJohannes Weinerconfig CGROUP_FREEZER 11716bf024e6SJohannes Weiner bool "Freezer controller" 11726bf024e6SJohannes Weiner help 11736bf024e6SJohannes Weiner Provides a way to freeze and unfreeze all tasks in a 11746bf024e6SJohannes Weiner cgroup. 11756bf024e6SJohannes Weiner 1176489c2a20SJohannes Weiner This option affects the ORIGINAL cgroup interface. The cgroup2 memory 1177489c2a20SJohannes Weiner controller includes important in-kernel memory consumers per default. 1178489c2a20SJohannes Weiner 1179489c2a20SJohannes Weiner If you're using cgroup2, say N. 1180489c2a20SJohannes Weiner 11816bf024e6SJohannes Weinerconfig CGROUP_HUGETLB 11826bf024e6SJohannes Weiner bool "HugeTLB controller" 11836bf024e6SJohannes Weiner depends on HUGETLB_PAGE 11846bf024e6SJohannes Weiner select PAGE_COUNTER 1185afc24d49SVivek Goyal default n 11866bf024e6SJohannes Weiner help 11876bf024e6SJohannes Weiner Provides a cgroup controller for HugeTLB pages. 11886bf024e6SJohannes Weiner When you enable this, you can put a per cgroup limit on HugeTLB usage. 11896bf024e6SJohannes Weiner The limit is enforced during page fault. Since HugeTLB doesn't 11906bf024e6SJohannes Weiner support page reclaim, enforcing the limit at page fault time implies 11916bf024e6SJohannes Weiner that, the application will get SIGBUS signal if it tries to access 11926bf024e6SJohannes Weiner HugeTLB pages beyond its limit. This requires the application to know 11936bf024e6SJohannes Weiner beforehand how much HugeTLB pages it would require for its use. The 11946bf024e6SJohannes Weiner control group is tracked in the third page lru pointer. This means 11956bf024e6SJohannes Weiner that we cannot use the controller with huge page less than 3 pages. 1196afc24d49SVivek Goyal 11976bf024e6SJohannes Weinerconfig CPUSETS 11986bf024e6SJohannes Weiner bool "Cpuset controller" 1199e1d4eeecSNicolas Pitre depends on SMP 1200bf9850f6SKuan-Wei Chiu select UNION_FIND 12016bf024e6SJohannes Weiner help 12026bf024e6SJohannes Weiner This option will let you create and manage CPUSETs which 12036bf024e6SJohannes Weiner allow dynamically partitioning a system into sets of CPUs and 12046bf024e6SJohannes Weiner Memory Nodes and assigning tasks to run only within those sets. 12056bf024e6SJohannes Weiner This is primarily useful on large SMP or NUMA systems. 1206afc24d49SVivek Goyal 12076bf024e6SJohannes Weiner Say N if unsure. 1208afc24d49SVivek Goyal 12091abab1baSChen Ridongconfig CPUSETS_V1 12101abab1baSChen Ridong bool "Legacy cgroup v1 cpusets controller" 12111abab1baSChen Ridong depends on CPUSETS 12121abab1baSChen Ridong default n 12131abab1baSChen Ridong help 12141abab1baSChen Ridong Legacy cgroup v1 cpusets controller which has been deprecated by 12151abab1baSChen Ridong cgroup v2 implementation. The v1 is there for legacy applications 1216dae68fbaSMichal Koutný which haven't migrated to the new cgroup v2 interface yet. Legacy 1217dae68fbaSMichal Koutný interface includes cpuset filesystem and /proc/<pid>/cpuset. If you 12181abab1baSChen Ridong do not have any such application then you are completely fine leaving 12191abab1baSChen Ridong this option disabled. 12201abab1baSChen Ridong 12211abab1baSChen Ridong Say N if unsure. 12221abab1baSChen Ridong 12236bf024e6SJohannes Weinerconfig PROC_PID_CPUSET 12246bf024e6SJohannes Weiner bool "Include legacy /proc/<pid>/cpuset file" 1225dae68fbaSMichal Koutný depends on CPUSETS_V1 122689e9b9e0STejun Heo default y 122789e9b9e0STejun Heo 12286bf024e6SJohannes Weinerconfig CGROUP_DEVICE 12296bf024e6SJohannes Weiner bool "Device controller" 12306bf024e6SJohannes Weiner help 12316bf024e6SJohannes Weiner Provides a cgroup controller implementing whitelists for 12326bf024e6SJohannes Weiner devices which a process in the cgroup can mknod or open. 12336bf024e6SJohannes Weiner 12346bf024e6SJohannes Weinerconfig CGROUP_CPUACCT 12356bf024e6SJohannes Weiner bool "Simple CPU accounting controller" 12366bf024e6SJohannes Weiner help 12376bf024e6SJohannes Weiner Provides a simple controller for monitoring the 12386bf024e6SJohannes Weiner total CPU consumed by the tasks in a cgroup. 12396bf024e6SJohannes Weiner 12406bf024e6SJohannes Weinerconfig CGROUP_PERF 12416bf024e6SJohannes Weiner bool "Perf controller" 12426bf024e6SJohannes Weiner depends on PERF_EVENTS 12436bf024e6SJohannes Weiner help 12446bf024e6SJohannes Weiner This option extends the perf per-cpu mode to restrict monitoring 12456bf024e6SJohannes Weiner to threads which belong to the cgroup specified and run on the 12466546b19fSNamhyung Kim designated cpu. Or this can be used to have cgroup ID in samples 12476546b19fSNamhyung Kim so that it can monitor performance events among cgroups. 12486bf024e6SJohannes Weiner 12496bf024e6SJohannes Weiner Say N if unsure. 12506bf024e6SJohannes Weiner 125130070984SDaniel Mackconfig CGROUP_BPF 125230070984SDaniel Mack bool "Support for eBPF programs attached to cgroups" 1253483c4933SAndy Lutomirski depends on BPF_SYSCALL 1254483c4933SAndy Lutomirski select SOCK_CGROUP_DATA 125530070984SDaniel Mack help 125630070984SDaniel Mack Allow attaching eBPF programs to a cgroup using the bpf(2) 125730070984SDaniel Mack syscall command BPF_PROG_ATTACH. 125830070984SDaniel Mack 125930070984SDaniel Mack In which context these programs are accessed depends on the type 126030070984SDaniel Mack of attachment. For instance, programs that are attached using 126130070984SDaniel Mack BPF_CGROUP_INET_INGRESS will be executed on the ingress path of 126230070984SDaniel Mack inet sockets. 126330070984SDaniel Mack 1264a72232eaSVipin Sharmaconfig CGROUP_MISC 1265a72232eaSVipin Sharma bool "Misc resource controller" 1266a72232eaSVipin Sharma default n 1267a72232eaSVipin Sharma help 1268a72232eaSVipin Sharma Provides a controller for miscellaneous resources on a host. 1269a72232eaSVipin Sharma 1270a72232eaSVipin Sharma Miscellaneous scalar resources are the resources on the host system 1271a72232eaSVipin Sharma which cannot be abstracted like the other cgroups. This controller 1272a72232eaSVipin Sharma tracks and limits the miscellaneous resources used by a process 1273a72232eaSVipin Sharma attached to a cgroup hierarchy. 1274a72232eaSVipin Sharma 1275a72232eaSVipin Sharma For more information, please check misc cgroup section in 1276a72232eaSVipin Sharma /Documentation/admin-guide/cgroup-v2.rst. 1277a72232eaSVipin Sharma 12786bf024e6SJohannes Weinerconfig CGROUP_DEBUG 127923b0be48SWaiman Long bool "Debug controller" 12806bf024e6SJohannes Weiner default n 128123b0be48SWaiman Long depends on DEBUG_KERNEL 12826bf024e6SJohannes Weiner help 12836bf024e6SJohannes Weiner This option enables a simple controller that exports 128423b0be48SWaiman Long debugging information about the cgroups framework. This 128523b0be48SWaiman Long controller is for control cgroup debugging only. Its 128623b0be48SWaiman Long interfaces are not stable. 12876bf024e6SJohannes Weiner 12886bf024e6SJohannes Weiner Say N. 12896bf024e6SJohannes Weiner 129073b35147SArnd Bergmannconfig SOCK_CGROUP_DATA 129173b35147SArnd Bergmann bool 129273b35147SArnd Bergmann default n 129373b35147SArnd Bergmann 129423964d2dSLi Zefanendif # CGROUPS 1295c077719bSKAMEZAWA Hiroyuki 12968dd2a82cSDaniel Lezcanomenuconfig NAMESPACES 12976a108a14SDavid Rientjes bool "Namespaces support" if EXPERT 12982813893fSIulia Manda depends on MULTIUSER 12996a108a14SDavid Rientjes default !EXPERT 1300c5289a69SPavel Emelyanov help 1301c5289a69SPavel Emelyanov Provides the way to make tasks work with different objects using 1302c5289a69SPavel Emelyanov the same id. For example same IPC id may refer to different objects 1303c5289a69SPavel Emelyanov or same user id or pid may refer to different tasks when used in 1304c5289a69SPavel Emelyanov different namespaces. 1305c5289a69SPavel Emelyanov 13068dd2a82cSDaniel Lezcanoif NAMESPACES 13078dd2a82cSDaniel Lezcano 130858bfdd6dSPavel Emelyanovconfig UTS_NS 130958bfdd6dSPavel Emelyanov bool "UTS namespace" 131017a6d441SDaniel Lezcano default y 131158bfdd6dSPavel Emelyanov help 131258bfdd6dSPavel Emelyanov In this namespace tasks see different info provided with the 131358bfdd6dSPavel Emelyanov uname() system call 131458bfdd6dSPavel Emelyanov 1315769071acSAndrei Vaginconfig TIME_NS 1316769071acSAndrei Vagin bool "TIME namespace" 1317660fd04fSThomas Gleixner depends on GENERIC_VDSO_TIME_NS 1318769071acSAndrei Vagin default y 1319769071acSAndrei Vagin help 1320769071acSAndrei Vagin In this namespace boottime and monotonic clocks can be set. 1321769071acSAndrei Vagin The time will keep going with the same pace. 1322769071acSAndrei Vagin 1323ae5e1b22SPavel Emelyanovconfig IPC_NS 1324ae5e1b22SPavel Emelyanov bool "IPC namespace" 13258dd2a82cSDaniel Lezcano depends on (SYSVIPC || POSIX_MQUEUE) 132617a6d441SDaniel Lezcano default y 1327ae5e1b22SPavel Emelyanov help 1328ae5e1b22SPavel Emelyanov In this namespace tasks work with IPC ids which correspond to 1329614b84cfSSerge E. Hallyn different IPC objects in different namespaces. 1330ae5e1b22SPavel Emelyanov 1331aee16ce7SPavel Emelyanovconfig USER_NS 133219c92399SKees Cook bool "User namespace" 13335673a94cSEric W. Biederman default n 1334aee16ce7SPavel Emelyanov help 1335aee16ce7SPavel Emelyanov This allows containers, i.e. vservers, to use user namespaces 1336aee16ce7SPavel Emelyanov to provide different user info for different servers. 1337e11f0ae3SEric W. Biederman 1338e11f0ae3SEric W. Biederman When user namespaces are enabled in the kernel it is 1339d886f4e4SJohannes Weiner recommended that the MEMCG option also be enabled and that 1340d886f4e4SJohannes Weiner user-space use the memory control groups to limit the amount 1341d886f4e4SJohannes Weiner of memory a memory unprivileged users can use. 1342e11f0ae3SEric W. Biederman 1343aee16ce7SPavel Emelyanov If unsure, say N. 1344aee16ce7SPavel Emelyanov 134574bd59bbSPavel Emelyanovconfig PID_NS 13469bd38c2cSDaniel Lezcano bool "PID Namespaces" 134717a6d441SDaniel Lezcano default y 134874bd59bbSPavel Emelyanov help 134912d2b8f9SHeikki Orsila Support process id namespaces. This allows having multiple 1350692105b8SMatt LaPlante processes with the same pid as long as they are in different 135174bd59bbSPavel Emelyanov pid namespaces. This is a building block of containers. 135274bd59bbSPavel Emelyanov 1353d6eb633fSMatt Helsleyconfig NET_NS 1354d6eb633fSMatt Helsley bool "Network namespace" 13558dd2a82cSDaniel Lezcano depends on NET 135617a6d441SDaniel Lezcano default y 1357d6eb633fSMatt Helsley help 1358d6eb633fSMatt Helsley Allow user space to create what appear to be multiple instances 1359d6eb633fSMatt Helsley of the network stack. 1360d6eb633fSMatt Helsley 13618dd2a82cSDaniel Lezcanoendif # NAMESPACES 13628dd2a82cSDaniel Lezcano 13635cb366bbSAdrian Reberconfig CHECKPOINT_RESTORE 13645cb366bbSAdrian Reber bool "Checkpoint/restore support" 136530341ec9SRen Zhijie depends on PROC_FS 13665cb366bbSAdrian Reber select PROC_CHILDREN 1367bfe3911aSChris Wilson select KCMP 13685cb366bbSAdrian Reber default n 13695cb366bbSAdrian Reber help 13705cb366bbSAdrian Reber Enables additional kernel features in a sake of checkpoint/restore. 13715cb366bbSAdrian Reber In particular it adds auxiliary prctl codes to setup process text, 13725cb366bbSAdrian Reber data and heap segment sizes, and a few additional /proc filesystem 13735cb366bbSAdrian Reber entries. 13745cb366bbSAdrian Reber 13755cb366bbSAdrian Reber If unsure, say N here. 13765cb366bbSAdrian Reber 13775091faa4SMike Galbraithconfig SCHED_AUTOGROUP 13785091faa4SMike Galbraith bool "Automatic process group scheduling" 13795091faa4SMike Galbraith select CGROUPS 13805091faa4SMike Galbraith select CGROUP_SCHED 13815091faa4SMike Galbraith select FAIR_GROUP_SCHED 13825091faa4SMike Galbraith help 13835091faa4SMike Galbraith This option optimizes the scheduler for common desktop workloads by 13845091faa4SMike Galbraith automatically creating and populating task groups. This separation 13855091faa4SMike Galbraith of workloads isolates aggressive CPU burners (like build jobs) from 13865091faa4SMike Galbraith desktop applications. Task group autogeneration is currently based 13875091faa4SMike Galbraith upon task session. 13885091faa4SMike Galbraith 13897af37becSDaniel Lezcanoconfig RELAY 13907af37becSDaniel Lezcano bool "Kernel->user space relay support (formerly relayfs)" 139126b5679eSPeter Zijlstra select IRQ_WORK 13927af37becSDaniel Lezcano help 13937af37becSDaniel Lezcano This option enables support for relay interface support in 13947af37becSDaniel Lezcano certain file systems (such as debugfs). 13957af37becSDaniel Lezcano It is designed to provide an efficient mechanism for tools and 13967af37becSDaniel Lezcano facilities to relay large amounts of data from kernel space to 13977af37becSDaniel Lezcano user space. 13987af37becSDaniel Lezcano 13997af37becSDaniel Lezcano If unsure, say N. 14007af37becSDaniel Lezcano 1401f991633dSDimitri Gorokhovikconfig BLK_DEV_INITRD 1402f991633dSDimitri Gorokhovik bool "Initial RAM filesystem and RAM disk (initramfs/initrd) support" 1403f991633dSDimitri Gorokhovik help 1404f991633dSDimitri Gorokhovik The initial RAM filesystem is a ramfs which is loaded by the 1405f991633dSDimitri Gorokhovik boot loader (loadlin or lilo) and that is mounted as root 1406f991633dSDimitri Gorokhovik before the normal boot procedure. It is typically used to 1407f991633dSDimitri Gorokhovik load modules needed to mount the "real" root file system, 14088c27ceffSMauro Carvalho Chehab etc. See <file:Documentation/admin-guide/initrd.rst> for details. 1409f991633dSDimitri Gorokhovik 1410f991633dSDimitri Gorokhovik If RAM disk support (BLK_DEV_RAM) is also included, this 1411f991633dSDimitri Gorokhovik also enables initial RAM disk (initrd) support and adds 1412f991633dSDimitri Gorokhovik 15 Kbytes (more on some other architectures) to the kernel size. 1413f991633dSDimitri Gorokhovik 1414f991633dSDimitri Gorokhovik If unsure say Y. 1415f991633dSDimitri Gorokhovik 1416c33df4eaSJean-Paul Samanif BLK_DEV_INITRD 1417c33df4eaSJean-Paul Saman 1418dbec4866SSam Ravnborgsource "usr/Kconfig" 1419dbec4866SSam Ravnborg 1420c33df4eaSJean-Paul Samanendif 1421c33df4eaSJean-Paul Saman 142276db5a27SMasami Hiramatsuconfig BOOT_CONFIG 142376db5a27SMasami Hiramatsu bool "Boot config support" 1424a2a9d67aSMasami Hiramatsu select BLK_DEV_INITRD if !BOOT_CONFIG_EMBED 142576db5a27SMasami Hiramatsu help 142676db5a27SMasami Hiramatsu Extra boot config allows system admin to pass a config file as 142776db5a27SMasami Hiramatsu complemental extension of kernel cmdline when booting. 14280947db01SMasami Hiramatsu The boot config file must be attached at the end of initramfs 142985c46b78SMasami Hiramatsu with checksum, size and magic word. 14300947db01SMasami Hiramatsu See <file:Documentation/admin-guide/bootconfig.rst> for details. 143176db5a27SMasami Hiramatsu 143276db5a27SMasami Hiramatsu If unsure, say Y. 143376db5a27SMasami Hiramatsu 1434b743852cSPaul E. McKenneyconfig BOOT_CONFIG_FORCE 1435b743852cSPaul E. McKenney bool "Force unconditional bootconfig processing" 1436b743852cSPaul E. McKenney depends on BOOT_CONFIG 14376ded8a28SPaul E. McKenney default y if BOOT_CONFIG_EMBED 1438b743852cSPaul E. McKenney help 1439b743852cSPaul E. McKenney With this Kconfig option set, BOOT_CONFIG processing is carried 1440b743852cSPaul E. McKenney out even when the "bootconfig" kernel-boot parameter is omitted. 1441b743852cSPaul E. McKenney In fact, with this Kconfig option set, there is no way to 1442b743852cSPaul E. McKenney make the kernel ignore the BOOT_CONFIG-supplied kernel-boot 1443b743852cSPaul E. McKenney parameters. 1444b743852cSPaul E. McKenney 1445b743852cSPaul E. McKenney If unsure, say N. 1446b743852cSPaul E. McKenney 1447a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED 1448a2a9d67aSMasami Hiramatsu bool "Embed bootconfig file in the kernel" 1449a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG 1450a2a9d67aSMasami Hiramatsu help 1451a2a9d67aSMasami Hiramatsu Embed a bootconfig file given by BOOT_CONFIG_EMBED_FILE in the 1452a2a9d67aSMasami Hiramatsu kernel. Usually, the bootconfig file is loaded with the initrd 1453a2a9d67aSMasami Hiramatsu image. But if the system doesn't support initrd, this option will 1454a2a9d67aSMasami Hiramatsu help you by embedding a bootconfig file while building the kernel. 1455a2a9d67aSMasami Hiramatsu 1456a2a9d67aSMasami Hiramatsu If unsure, say N. 1457a2a9d67aSMasami Hiramatsu 1458a2a9d67aSMasami Hiramatsuconfig BOOT_CONFIG_EMBED_FILE 1459a2a9d67aSMasami Hiramatsu string "Embedded bootconfig file path" 1460a2a9d67aSMasami Hiramatsu depends on BOOT_CONFIG_EMBED 1461a2a9d67aSMasami Hiramatsu help 1462a2a9d67aSMasami Hiramatsu Specify a bootconfig file which will be embedded to the kernel. 1463a2a9d67aSMasami Hiramatsu This bootconfig will be used if there is no initrd or no other 1464a2a9d67aSMasami Hiramatsu bootconfig in the initrd. 1465a2a9d67aSMasami Hiramatsu 14661274aea1SDavid Disseldorpconfig INITRAMFS_PRESERVE_MTIME 14671274aea1SDavid Disseldorp bool "Preserve cpio archive mtimes in initramfs" 14681274aea1SDavid Disseldorp default y 14691274aea1SDavid Disseldorp help 14701274aea1SDavid Disseldorp Each entry in an initramfs cpio archive carries an mtime value. When 14711274aea1SDavid Disseldorp enabled, extracted cpio items take this mtime, with directory mtime 14721274aea1SDavid Disseldorp setting deferred until after creation of any child entries. 14731274aea1SDavid Disseldorp 14741274aea1SDavid Disseldorp If unsure, say Y. 14751274aea1SDavid Disseldorp 147683c0b272SDavid Disseldorpconfig INITRAMFS_TEST 147783c0b272SDavid Disseldorp bool "Test initramfs cpio archive extraction" if !KUNIT_ALL_TESTS 147883c0b272SDavid Disseldorp depends on BLK_DEV_INITRD && KUNIT=y 147983c0b272SDavid Disseldorp default KUNIT_ALL_TESTS 148083c0b272SDavid Disseldorp help 148183c0b272SDavid Disseldorp Build KUnit tests for initramfs. See Documentation/dev-tools/kunit 148283c0b272SDavid Disseldorp 1483877417e6SArnd Bergmannchoice 1484877417e6SArnd Bergmann prompt "Compiler optimization level" 14852cc3ce24SUlf Magnusson default CC_OPTIMIZE_FOR_PERFORMANCE 1486877417e6SArnd Bergmann 1487877417e6SArnd Bergmannconfig CC_OPTIMIZE_FOR_PERFORMANCE 148815f5db60SMasahiro Yamada bool "Optimize for performance (-O2)" 1489877417e6SArnd Bergmann help 1490877417e6SArnd Bergmann This is the default optimization level for the kernel, building 1491877417e6SArnd Bergmann with the "-O2" compiler flag for best performance and most 1492877417e6SArnd Bergmann helpful compile-time warnings. 1493877417e6SArnd Bergmann 1494c45b4f1fSLinus Torvaldsconfig CC_OPTIMIZE_FOR_SIZE 149515f5db60SMasahiro Yamada bool "Optimize for size (-Os)" 1496c45b4f1fSLinus Torvalds help 1497ce3b487fSMasahiro Yamada Choosing this option will pass "-Os" to your compiler resulting 1498ce3b487fSMasahiro Yamada in a smaller kernel. 1499c45b4f1fSLinus Torvalds 1500877417e6SArnd Bergmannendchoice 1501877417e6SArnd Bergmann 15025d20ee31SNicholas Pigginconfig HAVE_LD_DEAD_CODE_DATA_ELIMINATION 15035d20ee31SNicholas Piggin bool 15045d20ee31SNicholas Piggin help 15055d20ee31SNicholas Piggin This requires that the arch annotates or otherwise protects 15065d20ee31SNicholas Piggin its external entry points from being discarded. Linker scripts 15075d20ee31SNicholas Piggin must also merge .text.*, .data.*, and .bss.* correctly into 15085d20ee31SNicholas Piggin output sections. Care must be taken not to pull in unrelated 15095d20ee31SNicholas Piggin sections (e.g., '.text.init'). Typically '.' in section names 15105d20ee31SNicholas Piggin is used to distinguish them from label names / C identifiers. 15115d20ee31SNicholas Piggin 15125d20ee31SNicholas Pigginconfig LD_DEAD_CODE_DATA_ELIMINATION 15135d20ee31SNicholas Piggin bool "Dead code and data elimination (EXPERIMENTAL)" 15145d20ee31SNicholas Piggin depends on HAVE_LD_DEAD_CODE_DATA_ELIMINATION 15155d20ee31SNicholas Piggin depends on EXPERT 1516e85d1d65SMasahiro Yamada depends on $(cc-option,-ffunction-sections -fdata-sections) 1517e85d1d65SMasahiro Yamada depends on $(ld-option,--gc-sections) 15185d20ee31SNicholas Piggin help 15198b9d2712SMasahiro Yamada Enable this if you want to do dead code and data elimination with 15208b9d2712SMasahiro Yamada the linker by compiling with -ffunction-sections -fdata-sections, 15218b9d2712SMasahiro Yamada and linking with --gc-sections. 15225d20ee31SNicholas Piggin 15235d20ee31SNicholas Piggin This can reduce on disk and in-memory size of the kernel 15245d20ee31SNicholas Piggin code and static data, particularly for small configs and 15255d20ee31SNicholas Piggin on small systems. This has the possibility of introducing 15265d20ee31SNicholas Piggin silently broken kernel if the required annotations are not 15275d20ee31SNicholas Piggin present. This option is not well tested yet, so use at your 15285d20ee31SNicholas Piggin own risk. 15295d20ee31SNicholas Piggin 153059612b24SNathan Chancellorconfig LD_ORPHAN_WARN 153159612b24SNathan Chancellor def_bool y 153259612b24SNathan Chancellor depends on ARCH_WANT_LD_ORPHAN_WARN 153359612b24SNathan Chancellor depends on $(ld-option,--orphan-handling=warn) 1534e1789d7cSXin Li depends on $(ld-option,--orphan-handling=error) 1535e1789d7cSXin Li 1536e1789d7cSXin Liconfig LD_ORPHAN_WARN_LEVEL 1537e1789d7cSXin Li string 1538e1789d7cSXin Li depends on LD_ORPHAN_WARN 1539e1789d7cSXin Li default "error" if WERROR 1540e1789d7cSXin Li default "warn" 154159612b24SNathan Chancellor 15420847062aSRandy Dunlapconfig SYSCTL 15430847062aSRandy Dunlap bool 15440847062aSRandy Dunlap 1545657a5209SMike Frysingerconfig HAVE_UID16 1546657a5209SMike Frysinger bool 1547657a5209SMike Frysinger 1548657a5209SMike Frysingerconfig SYSCTL_EXCEPTION_TRACE 1549657a5209SMike Frysinger bool 1550657a5209SMike Frysinger help 1551657a5209SMike Frysinger Enable support for /proc/sys/debug/exception-trace. 1552657a5209SMike Frysinger 1553657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_NO_WARN 1554657a5209SMike Frysinger bool 1555657a5209SMike Frysinger help 1556657a5209SMike Frysinger Enable support for /proc/sys/kernel/ignore-unaligned-usertrap 1557657a5209SMike Frysinger Allows arch to define/use @no_unaligned_warning to possibly warn 1558657a5209SMike Frysinger about unaligned access emulation going on under the hood. 1559657a5209SMike Frysinger 1560657a5209SMike Frysingerconfig SYSCTL_ARCH_UNALIGN_ALLOW 1561657a5209SMike Frysinger bool 1562657a5209SMike Frysinger help 1563657a5209SMike Frysinger Enable support for /proc/sys/kernel/unaligned-trap 1564657a5209SMike Frysinger Allows arches to define/use @unaligned_enabled to runtime toggle 1565657a5209SMike Frysinger the unaligned access emulation. 1566657a5209SMike Frysinger see arch/parisc/kernel/unaligned.c for reference 1567657a5209SMike Frysinger 1568c443279aSChristian Braunerconfig SYSFS_SYSCALL 1569c443279aSChristian Brauner bool "Sysfs syscall support" 1570c443279aSChristian Brauner default n 1571c443279aSChristian Brauner help 1572c443279aSChristian Brauner sys_sysfs is an obsolete system call no longer supported in libc. 1573c443279aSChristian Brauner Note that disabling this option is more secure but might break 1574c443279aSChristian Brauner compatibility with some systems. 1575c443279aSChristian Brauner 1576c443279aSChristian Brauner If unsure say N here. 1577c443279aSChristian Brauner 1578657a5209SMike Frysingerconfig HAVE_PCSPKR_PLATFORM 1579657a5209SMike Frysinger bool 1580657a5209SMike Frysinger 15816a108a14SDavid Rientjesmenuconfig EXPERT 15826a108a14SDavid Rientjes bool "Configure standard kernel features (expert users)" 1583f505c553SJosh Triplett # Unhide debug options, to make the on-by-default options visible 1584f505c553SJosh Triplett select DEBUG_KERNEL 15851da177e4SLinus Torvalds help 15861da177e4SLinus Torvalds This option allows certain base kernel options and settings 15871da177e4SLinus Torvalds to be disabled or tweaked. This is for specialized 15881da177e4SLinus Torvalds environments which can tolerate a "non-standard" kernel. 15891da177e4SLinus Torvalds Only use this if you really know what you are doing. 15901da177e4SLinus Torvalds 1591ae81f9e3SChuck Ebbertconfig UID16 15926a108a14SDavid Rientjes bool "Enable 16-bit UID system calls" if EXPERT 15932813893fSIulia Manda depends on HAVE_UID16 && MULTIUSER 1594ae81f9e3SChuck Ebbert default y 1595ae81f9e3SChuck Ebbert help 1596ae81f9e3SChuck Ebbert This enables the legacy 16-bit UID syscall wrappers. 1597ae81f9e3SChuck Ebbert 15982813893fSIulia Mandaconfig MULTIUSER 15992813893fSIulia Manda bool "Multiple users, groups and capabilities support" if EXPERT 16002813893fSIulia Manda default y 16012813893fSIulia Manda help 16022813893fSIulia Manda This option enables support for non-root users, groups and 16032813893fSIulia Manda capabilities. 16042813893fSIulia Manda 16052813893fSIulia Manda If you say N here, all processes will run with UID 0, GID 0, and all 16062813893fSIulia Manda possible capabilities. Saying N here also compiles out support for 16072813893fSIulia Manda system calls related to UIDs, GIDs, and capabilities, such as setuid, 16082813893fSIulia Manda setgid, and capset. 16092813893fSIulia Manda 16102813893fSIulia Manda If unsure, say Y here. 16112813893fSIulia Manda 1612f6187769SFabian Frederickconfig SGETMASK_SYSCALL 1613f6187769SFabian Frederick bool "sgetmask/ssetmask syscalls support" if EXPERT 1614cd14b018SMasahiro Yamada default PARISC || M68K || PPC || MIPS || X86 || SPARC || MICROBLAZE || SUPERH 1615a7f7f624SMasahiro Yamada help 1616f6187769SFabian Frederick sys_sgetmask and sys_ssetmask are obsolete system calls 1617f6187769SFabian Frederick no longer supported in libc but still enabled by default in some 1618f6187769SFabian Frederick architectures. 1619f6187769SFabian Frederick 1620f6187769SFabian Frederick If unsure, leave the default option here. 1621f6187769SFabian Frederick 1622d1b069f5SRandy Dunlapconfig FHANDLE 1623d1b069f5SRandy Dunlap bool "open by fhandle syscalls" if EXPERT 1624d1b069f5SRandy Dunlap select EXPORTFS 1625d1b069f5SRandy Dunlap default y 1626d1b069f5SRandy Dunlap help 1627d1b069f5SRandy Dunlap If you say Y here, a user level program will be able to map 1628d1b069f5SRandy Dunlap file names to handle and then later use the handle for 1629d1b069f5SRandy Dunlap different file system operations. This is useful in implementing 1630d1b069f5SRandy Dunlap userspace file servers, which now track files using handles instead 1631d1b069f5SRandy Dunlap of names. The handle would remain the same even if file names 1632d1b069f5SRandy Dunlap get renamed. Enables open_by_handle_at(2) and name_to_handle_at(2) 1633d1b069f5SRandy Dunlap syscalls. 1634d1b069f5SRandy Dunlap 1635baa73d9eSNicolas Pitreconfig POSIX_TIMERS 1636baa73d9eSNicolas Pitre bool "Posix Clocks & timers" if EXPERT 1637baa73d9eSNicolas Pitre default y 1638baa73d9eSNicolas Pitre help 1639baa73d9eSNicolas Pitre This includes native support for POSIX timers to the kernel. 1640baa73d9eSNicolas Pitre Some embedded systems have no use for them and therefore they 1641baa73d9eSNicolas Pitre can be configured out to reduce the size of the kernel image. 1642baa73d9eSNicolas Pitre 1643baa73d9eSNicolas Pitre When this option is disabled, the following syscalls won't be 1644baa73d9eSNicolas Pitre available: timer_create, timer_gettime: timer_getoverrun, 1645baa73d9eSNicolas Pitre timer_settime, timer_delete, clock_adjtime, getitimer, 1646baa73d9eSNicolas Pitre setitimer, alarm. Furthermore, the clock_settime, clock_gettime, 1647baa73d9eSNicolas Pitre clock_getres and clock_nanosleep syscalls will be limited to 1648baa73d9eSNicolas Pitre CLOCK_REALTIME, CLOCK_MONOTONIC and CLOCK_BOOTTIME only. 1649baa73d9eSNicolas Pitre 1650baa73d9eSNicolas Pitre If unsure say y. 1651baa73d9eSNicolas Pitre 1652d59745ceSMatt Mackallconfig PRINTK 1653d59745ceSMatt Mackall default y 16546a108a14SDavid Rientjes bool "Enable support for printk" if EXPERT 165574876a98SFrederic Weisbecker select IRQ_WORK 1656d59745ceSMatt Mackall help 1657d59745ceSMatt Mackall This option enables normal printk support. Removing it 1658d59745ceSMatt Mackall eliminates most of the message strings from the kernel image 1659d59745ceSMatt Mackall and makes the kernel more or less silent. As this makes it 1660d59745ceSMatt Mackall very difficult to diagnose system problems, saying N here is 1661d59745ceSMatt Mackall strongly discouraged. 1662d59745ceSMatt Mackall 1663c8538a7aSMatt Mackallconfig BUG 16646a108a14SDavid Rientjes bool "BUG() support" if EXPERT 1665c8538a7aSMatt Mackall default y 1666c8538a7aSMatt Mackall help 1667c8538a7aSMatt Mackall Disabling this option eliminates support for BUG and WARN, reducing 1668c8538a7aSMatt Mackall the size of your kernel image and potentially quietly ignoring 1669c8538a7aSMatt Mackall numerous fatal conditions. You should only consider disabling this 1670c8538a7aSMatt Mackall option for embedded systems with no facilities for reporting errors. 1671c8538a7aSMatt Mackall Just say Y. 1672c8538a7aSMatt Mackall 1673708e9a79SMatt Mackallconfig ELF_CORE 1674046d662fSAlex Kelly depends on COREDUMP 1675708e9a79SMatt Mackall default y 16766a108a14SDavid Rientjes bool "Enable ELF core dumps" if EXPERT 1677708e9a79SMatt Mackall help 1678708e9a79SMatt Mackall Enable support for generating core dumps. Disabling saves about 4k. 1679708e9a79SMatt Mackall 16808761f1abSRalf Baechle 1681e5e1d3cbSStas Sergeevconfig PCSPKR_PLATFORM 16826a108a14SDavid Rientjes bool "Enable PC-Speaker support" if EXPERT 16838761f1abSRalf Baechle depends on HAVE_PCSPKR_PLATFORM 168415f304b6SRalf Baechle select I8253_LOCK 1685e5e1d3cbSStas Sergeev default y 1686e5e1d3cbSStas Sergeev help 1687e5e1d3cbSStas Sergeev This option allows to disable the internal PC-Speaker 1688e5e1d3cbSStas Sergeev support, saving some memory. 1689e5e1d3cbSStas Sergeev 169027021649SYoann Congalconfig BASE_SMALL 169127021649SYoann Congal bool "Enable smaller-sized data structures for core" if EXPERT 16921da177e4SLinus Torvalds help 169327021649SYoann Congal Enabling this option reduces the size of miscellaneous core 16941da177e4SLinus Torvalds kernel data structures. This saves memory on small machines, 16951da177e4SLinus Torvalds but may reduce performance. 16961da177e4SLinus Torvalds 16971da177e4SLinus Torvaldsconfig FUTEX 16986a108a14SDavid Rientjes bool "Enable futex support" if EXPERT 16993f2bedabSArnd Bergmann depends on !(SPARC32 && SMP) 17001da177e4SLinus Torvalds default y 1701bc2eecd7SNicolas Pitre imply RT_MUTEXES 17021da177e4SLinus Torvalds help 17031da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 17041da177e4SLinus Torvalds support for "fast userspace mutexes". The resulting kernel may not 17051da177e4SLinus Torvalds run glibc-based applications correctly. 17061da177e4SLinus Torvalds 1707bc2eecd7SNicolas Pitreconfig FUTEX_PI 1708bc2eecd7SNicolas Pitre bool 1709bc2eecd7SNicolas Pitre depends on FUTEX && RT_MUTEXES 1710bc2eecd7SNicolas Pitre default y 1711bc2eecd7SNicolas Pitre 17121da177e4SLinus Torvaldsconfig EPOLL 17136a108a14SDavid Rientjes bool "Enable eventpoll support" if EXPERT 17141da177e4SLinus Torvalds default y 17151da177e4SLinus Torvalds help 17161da177e4SLinus Torvalds Disabling this option will cause the kernel to be built without 17171da177e4SLinus Torvalds support for epoll family of system calls. 17181da177e4SLinus Torvalds 1719fba2afaaSDavide Libenziconfig SIGNALFD 17206a108a14SDavid Rientjes bool "Enable signalfd() system call" if EXPERT 1721fba2afaaSDavide Libenzi default y 1722fba2afaaSDavide Libenzi help 1723fba2afaaSDavide Libenzi Enable the signalfd() system call that allows to receive signals 1724fba2afaaSDavide Libenzi on a file descriptor. 1725fba2afaaSDavide Libenzi 1726fba2afaaSDavide Libenzi If unsure, say Y. 1727fba2afaaSDavide Libenzi 1728b215e283SDavide Libenziconfig TIMERFD 17296a108a14SDavid Rientjes bool "Enable timerfd() system call" if EXPERT 1730b215e283SDavide Libenzi default y 1731b215e283SDavide Libenzi help 1732b215e283SDavide Libenzi Enable the timerfd() system call that allows to receive timer 1733b215e283SDavide Libenzi events on a file descriptor. 1734b215e283SDavide Libenzi 1735b215e283SDavide Libenzi If unsure, say Y. 1736b215e283SDavide Libenzi 1737e1ad7468SDavide Libenziconfig EVENTFD 17386a108a14SDavid Rientjes bool "Enable eventfd() system call" if EXPERT 1739e1ad7468SDavide Libenzi default y 1740e1ad7468SDavide Libenzi help 1741e1ad7468SDavide Libenzi Enable the eventfd() system call that allows to receive both 1742e1ad7468SDavide Libenzi kernel notification (ie. KAIO) or userspace notifications. 1743e1ad7468SDavide Libenzi 1744e1ad7468SDavide Libenzi If unsure, say Y. 1745e1ad7468SDavide Libenzi 17461da177e4SLinus Torvaldsconfig SHMEM 17476a108a14SDavid Rientjes bool "Use full shmem filesystem" if EXPERT 17481da177e4SLinus Torvalds default y 17491da177e4SLinus Torvalds depends on MMU 17501da177e4SLinus Torvalds help 17511da177e4SLinus Torvalds The shmem is an internal filesystem used to manage shared memory. 17521da177e4SLinus Torvalds It is backed by swap and manages resource limits. It is also exported 17531da177e4SLinus Torvalds to userspace as tmpfs if TMPFS is enabled. Disabling this 17541da177e4SLinus Torvalds option replaces shmem and tmpfs with the much simpler ramfs code, 17551da177e4SLinus Torvalds which may be appropriate on small systems without swap. 17561da177e4SLinus Torvalds 1757ebf3f09cSThomas Petazzoniconfig AIO 17586a108a14SDavid Rientjes bool "Enable AIO support" if EXPERT 1759ebf3f09cSThomas Petazzoni default y 1760ebf3f09cSThomas Petazzoni help 1761ebf3f09cSThomas Petazzoni This option enables POSIX asynchronous I/O which may by used 1762ebf3f09cSThomas Petazzoni by some high performance threaded applications. Disabling 1763ebf3f09cSThomas Petazzoni this option saves about 7k. 1764ebf3f09cSThomas Petazzoni 17652b188cc1SJens Axboeconfig IO_URING 17662b188cc1SJens Axboe bool "Enable IO uring support" if EXPERT 1767561fb04aSJens Axboe select IO_WQ 17682b188cc1SJens Axboe default y 17692b188cc1SJens Axboe help 17702b188cc1SJens Axboe This option enables support for the io_uring interface, enabling 17712b188cc1SJens Axboe applications to submit and complete IO through submission and 17722b188cc1SJens Axboe completion rings that are shared between the kernel and application. 17732b188cc1SJens Axboe 17741802656eSJens Axboeconfig GCOV_PROFILE_URING 17751802656eSJens Axboe bool "Enable GCOV profiling on the io_uring subsystem" 17761802656eSJens Axboe depends on GCOV_KERNEL 17771802656eSJens Axboe help 17781802656eSJens Axboe Enable GCOV profiling on the io_uring subsystem, to facilitate 17791802656eSJens Axboe code coverage testing. 17801802656eSJens Axboe 17811802656eSJens Axboe If unsure, say N. 17821802656eSJens Axboe 17831802656eSJens Axboe Note that this will have a negative impact on the performance of 17841802656eSJens Axboe the io_uring subsystem, hence this should only be enabled for 17851802656eSJens Axboe specific test purposes. 17861802656eSJens Axboe 1787d3ac21caSJosh Triplettconfig ADVISE_SYSCALLS 1788d3ac21caSJosh Triplett bool "Enable madvise/fadvise syscalls" if EXPERT 1789d3ac21caSJosh Triplett default y 1790d3ac21caSJosh Triplett help 1791d3ac21caSJosh Triplett This option enables the madvise and fadvise syscalls, used by 1792d3ac21caSJosh Triplett applications to advise the kernel about their future memory or file 1793d3ac21caSJosh Triplett usage, improving performance. If building an embedded system where no 1794d3ac21caSJosh Triplett applications use these syscalls, you can disable this option to save 1795d3ac21caSJosh Triplett space. 1796d3ac21caSJosh Triplett 17975b25b13aSMathieu Desnoyersconfig MEMBARRIER 17985b25b13aSMathieu Desnoyers bool "Enable membarrier() system call" if EXPERT 17995b25b13aSMathieu Desnoyers default y 18005b25b13aSMathieu Desnoyers help 18015b25b13aSMathieu Desnoyers Enable the membarrier() system call that allows issuing memory 18025b25b13aSMathieu Desnoyers barriers across all running threads, which can be used to distribute 18035b25b13aSMathieu Desnoyers the cost of user-space memory barriers asymmetrically by transforming 18045b25b13aSMathieu Desnoyers pairs of memory barriers into pairs consisting of membarrier() and a 18055b25b13aSMathieu Desnoyers compiler barrier. 18065b25b13aSMathieu Desnoyers 18075b25b13aSMathieu Desnoyers If unsure, say Y. 18085b25b13aSMathieu Desnoyers 1809a751ea34SRandy Dunlapconfig KCMP 1810a751ea34SRandy Dunlap bool "Enable kcmp() system call" if EXPERT 1811a751ea34SRandy Dunlap help 1812a751ea34SRandy Dunlap Enable the kernel resource comparison system call. It provides 1813a751ea34SRandy Dunlap user-space with the ability to compare two processes to see if they 1814a751ea34SRandy Dunlap share a common resource, such as a file descriptor or even virtual 1815a751ea34SRandy Dunlap memory space. 1816a751ea34SRandy Dunlap 1817a751ea34SRandy Dunlap If unsure, say N. 1818a751ea34SRandy Dunlap 1819a751ea34SRandy Dunlapconfig RSEQ 1820a751ea34SRandy Dunlap bool "Enable rseq() system call" if EXPERT 1821a751ea34SRandy Dunlap default y 1822a751ea34SRandy Dunlap depends on HAVE_RSEQ 1823a751ea34SRandy Dunlap select MEMBARRIER 1824a751ea34SRandy Dunlap help 1825a751ea34SRandy Dunlap Enable the restartable sequences system call. It provides a 1826a751ea34SRandy Dunlap user-space cache for the current CPU number value, which 1827a751ea34SRandy Dunlap speeds up getting the current CPU number from user-space, 1828a751ea34SRandy Dunlap as well as an ABI to speed up user-space operations on 1829a751ea34SRandy Dunlap per-CPU data. 1830a751ea34SRandy Dunlap 1831a751ea34SRandy Dunlap If unsure, say Y. 1832a751ea34SRandy Dunlap 1833a751ea34SRandy Dunlapconfig DEBUG_RSEQ 1834a751ea34SRandy Dunlap default n 1835a751ea34SRandy Dunlap bool "Enable debugging of rseq() system call" if EXPERT 1836a751ea34SRandy Dunlap depends on RSEQ && DEBUG_KERNEL 1837a751ea34SRandy Dunlap help 1838a751ea34SRandy Dunlap Enable extra debugging checks for the rseq system call. 1839a751ea34SRandy Dunlap 1840a751ea34SRandy Dunlap If unsure, say N. 1841a751ea34SRandy Dunlap 1842a751ea34SRandy Dunlapconfig CACHESTAT_SYSCALL 1843a751ea34SRandy Dunlap bool "Enable cachestat() system call" if EXPERT 1844a751ea34SRandy Dunlap default y 1845a751ea34SRandy Dunlap help 1846a751ea34SRandy Dunlap Enable the cachestat system call, which queries the page cache 1847a751ea34SRandy Dunlap statistics of a file (number of cached pages, dirty pages, 1848a751ea34SRandy Dunlap pages marked for writeback, (recently) evicted pages). 1849a751ea34SRandy Dunlap 1850a751ea34SRandy Dunlap If unsure say Y here. 1851a751ea34SRandy Dunlap 1852a751ea34SRandy Dunlapconfig PC104 1853a751ea34SRandy Dunlap bool "PC/104 support" if EXPERT 1854a751ea34SRandy Dunlap help 1855a751ea34SRandy Dunlap Expose PC/104 form factor device drivers and options available for 1856a751ea34SRandy Dunlap selection and configuration. Enable this option if your target 1857a751ea34SRandy Dunlap machine has a PC/104 bus. 1858a751ea34SRandy Dunlap 1859d1b069f5SRandy Dunlapconfig KALLSYMS 1860d1b069f5SRandy Dunlap bool "Load all symbols for debugging/ksymoops" if EXPERT 1861d1b069f5SRandy Dunlap default y 1862d1b069f5SRandy Dunlap help 1863d1b069f5SRandy Dunlap Say Y here to let the kernel print out symbolic crash information and 1864d1b069f5SRandy Dunlap symbolic stack backtraces. This increases the size of the kernel 1865d1b069f5SRandy Dunlap somewhat, as all symbols have to be loaded into the kernel image. 1866d1b069f5SRandy Dunlap 186730f3bb09SZhen Leiconfig KALLSYMS_SELFTEST 186830f3bb09SZhen Lei bool "Test the basic functions and performance of kallsyms" 186930f3bb09SZhen Lei depends on KALLSYMS 187030f3bb09SZhen Lei default n 187130f3bb09SZhen Lei help 187230f3bb09SZhen Lei Test the basic functions and performance of some interfaces, such as 187330f3bb09SZhen Lei kallsyms_lookup_name. It also calculates the compression rate of the 187430f3bb09SZhen Lei kallsyms compression algorithm for the current symbol set. 187530f3bb09SZhen Lei 187630f3bb09SZhen Lei Start self-test automatically after system startup. Suggest executing 187730f3bb09SZhen Lei "dmesg | grep kallsyms_selftest" to collect test results. "finish" is 187830f3bb09SZhen Lei displayed in the last line, indicating that the test is complete. 187930f3bb09SZhen Lei 1880d1b069f5SRandy Dunlapconfig KALLSYMS_ALL 1881d1b069f5SRandy Dunlap bool "Include all symbols in kallsyms" 1882d1b069f5SRandy Dunlap depends on DEBUG_KERNEL && KALLSYMS 1883d1b069f5SRandy Dunlap help 1884d1b069f5SRandy Dunlap Normally kallsyms only contains the symbols of functions for nicer 1885d1b069f5SRandy Dunlap OOPS messages and backtraces (i.e., symbols from the text and inittext 1886bdf0fe33SBaruch Siach sections). This is sufficient for most cases. And only if you want to 1887bdf0fe33SBaruch Siach enable kernel live patching, or other less common use cases (e.g., 1888bdf0fe33SBaruch Siach when a debugger is used) all symbols are required (i.e., names of 1889bdf0fe33SBaruch Siach variables from the data sections, etc). 1890d1b069f5SRandy Dunlap 1891d1b069f5SRandy Dunlap This option makes sure that all symbols are loaded into the kernel 1892d1b069f5SRandy Dunlap image (i.e., symbols from all sections) in cost of increased kernel 1893d1b069f5SRandy Dunlap size (depending on the kernel configuration, it may be 300KiB or 1894d1b069f5SRandy Dunlap something like this). 1895d1b069f5SRandy Dunlap 1896bdf0fe33SBaruch Siach Say N unless you really need all symbols, or kernel live patching. 1897d1b069f5SRandy Dunlap 1898d1b069f5SRandy Dunlap# end of the "standard kernel features (expert users)" menu 1899d1b069f5SRandy Dunlap 19003ccfebedSMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_CALLBACKS 19013ccfebedSMathieu Desnoyers bool 19023ccfebedSMathieu Desnoyers 190370216e18SMathieu Desnoyersconfig ARCH_HAS_MEMBARRIER_SYNC_CORE 190470216e18SMathieu Desnoyers bool 190570216e18SMathieu Desnoyers 19065796d396SJeff Xuconfig ARCH_SUPPORTS_MSEAL_SYSTEM_MAPPINGS 19075796d396SJeff Xu bool 19085796d396SJeff Xu help 19095796d396SJeff Xu Control MSEAL_SYSTEM_MAPPINGS access based on architecture. 19105796d396SJeff Xu 19115796d396SJeff Xu A 64-bit kernel is required for the memory sealing feature. 19125796d396SJeff Xu No specific hardware features from the CPU are needed. 19135796d396SJeff Xu 19145796d396SJeff Xu To enable this feature, the architecture needs to update their 19155796d396SJeff Xu special mappings calls to include the sealing flag and confirm 19165796d396SJeff Xu that it doesn't unmap/remap system mappings during the life 19175796d396SJeff Xu time of the process. The existence of this flag for an architecture 19185796d396SJeff Xu implies that it does not require the remapping of the system 19195796d396SJeff Xu mappings during process lifetime, so sealing these mappings is safe 19205796d396SJeff Xu from a kernel perspective. 19215796d396SJeff Xu 19225796d396SJeff Xu After the architecture enables this, a distribution can set 19235796d396SJeff Xu CONFIG_MSEAL_SYSTEM_MAPPING to manage access to the feature. 19245796d396SJeff Xu 19255796d396SJeff Xu For complete descriptions of memory sealing, please see 19265796d396SJeff Xu Documentation/userspace-api/mseal.rst 19275796d396SJeff Xu 1928cdd6c482SIngo Molnarconfig HAVE_PERF_EVENTS 19290793a61dSThomas Gleixner bool 1930018df72dSMike Frysinger help 1931018df72dSMike Frysinger See tools/perf/design.txt for details. 19320793a61dSThomas Gleixner 19332aef6f30SSean Christophersonconfig GUEST_PERF_EVENTS 19342aef6f30SSean Christopherson bool 19352aef6f30SSean Christopherson depends on HAVE_PERF_EVENTS 19362aef6f30SSean Christopherson 1937906010b2SPeter Zijlstraconfig PERF_USE_VMALLOC 1938906010b2SPeter Zijlstra bool 1939906010b2SPeter Zijlstra help 1940906010b2SPeter Zijlstra See tools/perf/design.txt for details 1941906010b2SPeter Zijlstra 194257c0c15bSIngo Molnarmenu "Kernel Performance Events And Counters" 19430793a61dSThomas Gleixner 1944cdd6c482SIngo Molnarconfig PERF_EVENTS 194557c0c15bSIngo Molnar bool "Kernel performance events and counters" 1946392d65a9SRobert Richter default y if PROFILING 1947cdd6c482SIngo Molnar depends on HAVE_PERF_EVENTS 1948e360adbeSPeter Zijlstra select IRQ_WORK 19490793a61dSThomas Gleixner help 195057c0c15bSIngo Molnar Enable kernel support for various performance events provided 195157c0c15bSIngo Molnar by software and hardware. 19520793a61dSThomas Gleixner 1953dd77038dSThadeu Lima de Souza Cascardo Software events are supported either built-in or via the 195457c0c15bSIngo Molnar use of generic tracepoints. 195557c0c15bSIngo Molnar 195657c0c15bSIngo Molnar Most modern CPUs support performance events via performance 195757c0c15bSIngo Molnar counter registers. These registers count the number of certain 19580793a61dSThomas Gleixner types of hw events: such as instructions executed, cachemisses 19590793a61dSThomas Gleixner suffered, or branches mis-predicted - without slowing down the 19600793a61dSThomas Gleixner kernel or applications. These registers can also trigger interrupts 19610793a61dSThomas Gleixner when a threshold number of events have passed - and can thus be 19620793a61dSThomas Gleixner used to profile the code that runs on that CPU. 19630793a61dSThomas Gleixner 196457c0c15bSIngo Molnar The Linux Performance Event subsystem provides an abstraction of 1965dd77038dSThadeu Lima de Souza Cascardo these software and hardware event capabilities, available via a 196657c0c15bSIngo Molnar system call and used by the "perf" utility in tools/perf/. It 19670793a61dSThomas Gleixner provides per task and per CPU counters, and it provides event 19680793a61dSThomas Gleixner capabilities on top of those. 19690793a61dSThomas Gleixner 19700793a61dSThomas Gleixner Say Y if unsure. 19710793a61dSThomas Gleixner 1972906010b2SPeter Zijlstraconfig DEBUG_PERF_USE_VMALLOC 1973906010b2SPeter Zijlstra default n 1974906010b2SPeter Zijlstra bool "Debug: use vmalloc to back perf mmap() buffers" 1975cb307113SMichael Ellerman depends on PERF_EVENTS && DEBUG_KERNEL && !PPC 1976906010b2SPeter Zijlstra select PERF_USE_VMALLOC 1977906010b2SPeter Zijlstra help 1978906010b2SPeter Zijlstra Use vmalloc memory to back perf mmap() buffers. 1979906010b2SPeter Zijlstra 1980906010b2SPeter Zijlstra Mostly useful for debugging the vmalloc code on platforms 1981906010b2SPeter Zijlstra that don't require it. 1982906010b2SPeter Zijlstra 1983906010b2SPeter Zijlstra Say N if unsure. 1984906010b2SPeter Zijlstra 19850793a61dSThomas Gleixnerendmenu 19860793a61dSThomas Gleixner 1987091f6e26SDavid Howellsconfig SYSTEM_DATA_VERIFICATION 1988091f6e26SDavid Howells def_bool n 1989091f6e26SDavid Howells select SYSTEM_TRUSTED_KEYRING 1990091f6e26SDavid Howells select KEYS 1991091f6e26SDavid Howells select CRYPTO 1992d43de6c7SDavid Howells select CRYPTO_RSA 1993091f6e26SDavid Howells select ASYMMETRIC_KEY_TYPE 1994091f6e26SDavid Howells select ASYMMETRIC_PUBLIC_KEY_SUBTYPE 1995091f6e26SDavid Howells select ASN1 1996091f6e26SDavid Howells select OID_REGISTRY 1997091f6e26SDavid Howells select X509_CERTIFICATE_PARSER 1998091f6e26SDavid Howells select PKCS7_MESSAGE_PARSER 199982c04ff8SPeter Foley help 2000091f6e26SDavid Howells Provide PKCS#7 message verification using the contents of the system 2001091f6e26SDavid Howells trusted keyring to provide public keys. This then can be used for 2002091f6e26SDavid Howells module verification, kexec image verification and firmware blob 2003091f6e26SDavid Howells verification. 200482c04ff8SPeter Foley 2005125e5645SMathieu Desnoyersconfig PROFILING 2006b309a294SRobert Richter bool "Profiling support" 2007125e5645SMathieu Desnoyers help 2008125e5645SMathieu Desnoyers Say Y here to enable the extended profiling support mechanisms used 2009f8408264SViresh Kumar by profilers. 2010125e5645SMathieu Desnoyers 20112f7ab126SMiguel Ojedaconfig RUST 20122f7ab126SMiguel Ojeda bool "Rust support" 20132f7ab126SMiguel Ojeda depends on HAVE_RUST 20142f7ab126SMiguel Ojeda depends on RUST_IS_AVAILABLE 2015ac61506bSSami Tolvanen select EXTENDED_MODVERSIONS if MODVERSIONS 2016ac61506bSSami Tolvanen depends on !MODVERSIONS || GENDWARFKSYMS 2017f1385dc6SNeal Gompa depends on !GCC_PLUGIN_RANDSTRUCT 20182f7ab126SMiguel Ojeda depends on !RANDSTRUCT 20195daa0c35SMatthew Maurer depends on !DEBUG_INFO_BTF || (PAHOLE_HAS_LANG_EXCLUDE && !LTO) 20208b8ca9c2SAlice Ryhl depends on !CFI_CLANG || HAVE_CFI_ICALL_NORMALIZE_INTEGERS_RUSTC 2021ca627e63SMatthew Maurer select CFI_ICALL_NORMALIZE_INTEGERS if CFI_CLANG 2022af6017b6SMiguel Ojeda depends on !CALL_PADDING || RUSTC_VERSION >= 108100 2023f64e2f3aSMatthew Maurer depends on !KASAN_SW_TAGS 202493e34a0bSAlice Ryhl depends on !(MITIGATION_RETHUNK && KASAN) || RUSTC_VERSION >= 108300 20252f7ab126SMiguel Ojeda help 20262f7ab126SMiguel Ojeda Enables Rust support in the kernel. 20272f7ab126SMiguel Ojeda 20282f7ab126SMiguel Ojeda This allows other Rust-related options, like drivers written in Rust, 20292f7ab126SMiguel Ojeda to be selected. 20302f7ab126SMiguel Ojeda 20312f7ab126SMiguel Ojeda It is also required to be able to load external kernel modules 20322f7ab126SMiguel Ojeda written in Rust. 20332f7ab126SMiguel Ojeda 20342f7ab126SMiguel Ojeda See Documentation/rust/ for more information. 20352f7ab126SMiguel Ojeda 20362f7ab126SMiguel Ojeda If unsure, say N. 20372f7ab126SMiguel Ojeda 20382f7ab126SMiguel Ojedaconfig RUSTC_VERSION_TEXT 20392f7ab126SMiguel Ojeda string 20402f7ab126SMiguel Ojeda depends on RUST 20415134a335SMiguel Ojeda default "$(RUSTC_VERSION_TEXT)" 20425134a335SMiguel Ojeda help 20435134a335SMiguel Ojeda See `CC_VERSION_TEXT`. 20442f7ab126SMiguel Ojeda 20452f7ab126SMiguel Ojedaconfig BINDGEN_VERSION_TEXT 20462f7ab126SMiguel Ojeda string 20472f7ab126SMiguel Ojeda depends on RUST 20489e98db17SMiguel Ojeda # The dummy parameter `workaround-for-0.69.0` is required to support 0.69.0 2049c23d1f7eSMiguel Ojeda # (https://github.com/rust-lang/rust-bindgen/pull/2678) and 0.71.0 2050c23d1f7eSMiguel Ojeda # (https://github.com/rust-lang/rust-bindgen/pull/3040). It can be removed 2051c23d1f7eSMiguel Ojeda # when the minimum version is upgraded past the latter (0.69.1 and 0.71.1 2052c23d1f7eSMiguel Ojeda # both fixed the issue). 2053aacf93e8SMasahiro Yamada default "$(shell,$(BINDGEN) --version workaround-for-0.69.0 2>/dev/null)" 20542f7ab126SMiguel Ojeda 20555f87f112SIngo Molnar# 20565f87f112SIngo Molnar# Place an empty function call at each tracepoint site. Can be 20575f87f112SIngo Molnar# dynamically changed for a probe function. 20585f87f112SIngo Molnar# 205997e1c18eSMathieu Desnoyersconfig TRACEPOINTS 20605f87f112SIngo Molnar bool 2061a363d27cSMathieu Desnoyers select TASKS_TRACE_RCU 206297e1c18eSMathieu Desnoyers 206389cde455SEric DeVoldersource "kernel/Kconfig.kexec" 206489cde455SEric DeVolder 20651da177e4SLinus Torvaldsendmenu # General setup 20661da177e4SLinus Torvalds 20671572497cSChristoph Hellwigsource "arch/Kconfig" 20681572497cSChristoph Hellwig 2069ae81f9e3SChuck Ebbertconfig RT_MUTEXES 20706341e62bSChristoph Jaeger bool 20711c6f9ec0SSebastian Andrzej Siewior default y if PREEMPT_RT 2072ae81f9e3SChuck Ebbert 2073c8424e77SThiago Jung Bauermannconfig MODULE_SIG_FORMAT 2074c8424e77SThiago Jung Bauermann def_bool n 2075c8424e77SThiago Jung Bauermann select SYSTEM_DATA_VERIFICATION 2076c8424e77SThiago Jung Bauermann 207773b4fc92SChristophe Leroysource "kernel/module/Kconfig" 20786c9692e2SPeter Zijlstra 207998a79d6aSRusty Russellconfig INIT_ALL_POSSIBLE 208098a79d6aSRusty Russell bool 208198a79d6aSRusty Russell help 20825f054e31SRusty Russell Back when each arch used to define their own cpu_online_mask and 20835f054e31SRusty Russell cpu_possible_mask, some of them chose to initialize cpu_possible_mask 208498a79d6aSRusty Russell with all 1s, and others with all 0s. When they were centralised, 208598a79d6aSRusty Russell it was better to provide this option than to break all the archs 2086692105b8SMatt LaPlante and have several arch maintainers pursuing me down dark alleys. 208798a79d6aSRusty Russell 20883a65dfe8SJens Axboesource "block/Kconfig" 2089e98c3202SAvi Kivity 2090e98c3202SAvi Kivityconfig PREEMPT_NOTIFIERS 2091e98c3202SAvi Kivity bool 2092e260be67SPaul E. McKenney 209316295becSSteffen Klassertconfig PADATA 209416295becSSteffen Klassert depends on SMP 209516295becSSteffen Klassert bool 209616295becSSteffen Klassert 20974520c6a4SDavid Howellsconfig ASN1 20984520c6a4SDavid Howells tristate 20994520c6a4SDavid Howells help 21004520c6a4SDavid Howells Build a simple ASN.1 grammar compiler that produces a bytecode output 21014520c6a4SDavid Howells that can be interpreted by the ASN.1 stream decoder and used to 21024520c6a4SDavid Howells inform it as to what tags are to be expected in a stream and what 21034520c6a4SDavid Howells functions to call on what tags. 21044520c6a4SDavid Howells 21056beb0009SThomas Gleixnersource "kernel/Kconfig.locks" 2106e61938a9SMathieu Desnoyers 21070ebeea8cSDaniel Borkmannconfig ARCH_HAS_NON_OVERLAPPING_ADDRESS_SPACE 21080ebeea8cSDaniel Borkmann bool 21090ebeea8cSDaniel Borkmann 21104ff4c745SAndrea Parriconfig ARCH_HAS_PREPARE_SYNC_CORE_CMD 21114ff4c745SAndrea Parri bool 21124ff4c745SAndrea Parri 2113e61938a9SMathieu Desnoyersconfig ARCH_HAS_SYNC_CORE_BEFORE_USERMODE 2114e61938a9SMathieu Desnoyers bool 21151bd21c6cSDominik Brodowski 21161bd21c6cSDominik Brodowski# It may be useful for an architecture to override the definitions of the 21177303e30eSDominik Brodowski# SYSCALL_DEFINE() and __SYSCALL_DEFINEx() macros in <linux/syscalls.h> 21187303e30eSDominik Brodowski# and the COMPAT_ variants in <linux/compat.h>, in particular to use a 21197303e30eSDominik Brodowski# different calling convention for syscalls. They can also override the 21207303e30eSDominik Brodowski# macros for not-implemented syscalls in kernel/sys_ni.c and 21217303e30eSDominik Brodowski# kernel/time/posix-stubs.c. All these overrides need to be available in 21227303e30eSDominik Brodowski# <asm/syscall_wrapper.h>. 21231bd21c6cSDominik Brodowskiconfig ARCH_HAS_SYSCALL_WRAPPER 21241bd21c6cSDominik Brodowski def_bool n 2125