KCONFIG(1)

πŸŽ€ KCONFIG πŸŽ€

okay bestie, welcome to the kconfig manual β€” it's the kconfig page from the kconfig manual, dated October 2017, and honestly? it's giving "quietly runs your entire kernel config and never asks for credit." let's get into it πŸ’…


✨ NAME ✨

kconfig β€” a standalone implementation of the Linux Kconfig parser. that's it, that's the whole vibe 🫢


✨ SYNOPSIS ✨

kconfig [options] <KConfig_file>

✨ DESCRIPTION ✨

so the kconfig toolkit is the whole girlboss situation: it supports the Kconfig language, and it implements the parser plus all the configuration support that goes along with the KConfig files β€” and it respects the Linux kernel KConfig convention the entire time. no notes, iconic behavior πŸ‘‘

At configuration time, you've got options, literally:

  • kconfig-mconf β€” built on ncurses (menuconfig) πŸ’…
  • kconfig-conf β€” built on dialog (config)
  • kconfig-gconf β€” built on GTK+ (gconfig)

And the associated tools, bestie, don't sleep on these:

  • kconfig-diff β€” displays the symbols diff between .config files πŸ¦‹

✨ OPTIONS ✨

  • --silentoldconfig β€” only for kconfig-conf, okay? it reloads a given .config and regenerates the header and command files accordingly. very "i'll handle it quietly" energy πŸ™ˆ
  • --allnoconfig β€” sets all boolean configuration to no. respectfully, everything is off πŸ’€
  • --allyesconfig β€” sets all boolean configuration to yes. everything is ON. main character config πŸ”₯
  • --randconfig β€” generates a random configuration. chaos mode, no cap 🌈

✨ ENVIRONMENT ✨

🌸 Environment variables for '*config' 🌸

  • KCONFIG_CONFIG β€” you can set this environment variable to specify a default kernel config file name, so it overrides the default name of ".config". cute little rename πŸ’–
  • KCONFIG_OVERWRITECONFIG β€” if you set KCONFIG_OVERWRITECONFIG in the environment, Kconfig will not break symlinks when .config is a symlink to somewhere else. it respects the link, periodt ✨
  • CONFIG_ β€” if you set CONFIG_ in the environment, Kconfig will prefix all symbols with its value when saving the configuration, instead of using the default, "CONFIG_". πŸŽ€

🌸 Environment variables for '{allyes/allmod/allno/rand}config' 🌸

  • KCONFIG_ALLCONFIG β€” the allyesconfig/allmodconfig/allnoconfig/randconfig variants can also use the environment variable KCONFIG_ALLCONFIG as a flag or a filename that contains config symbols that the user requires to be set to a specific value. so if KCONFIG_ALLCONFIG is used without a filename where KCONFIG_ALLCONFIG == "" or KCONFIG_ALLCONFIG == "1", "make *config" checks for a file named "all{yes/mod/no/def/random}.config" (corresponding to the *config command that was used) for symbol values that are to be forced. and if that file is not found, it checks for a file named "all.config" to contain forced values. πŸ•΅οΈβ€β™€οΈ

This enables you to create "miniature" config (miniconfig) or custom config files containing just the config symbols that you are interested in. then the kernel config system generates the full .config file, including symbols of your miniconfig file. literally so efficient 🫢

This 'KCONFIG_ALLCONFIG' file is a config file which contains (usually a subset of all) preset config symbols. these variable settings are still subject to normal dependency checks β€” so don't think you can just sneak past deps, bestie 😭

Examples:

KCONFIG_ALLCONFIG=custom-notebook.config make allnoconfig or
KCONFIG_ALLCONFIG=mini.config make allnoconfig or
make KCONFIG_ALLCONFIG=mini.config allnoconfig

These examples will disable most options (allnoconfig) but enable or disable the options that are explicitly listed in the specified mini-config files. iconic. obsessed. πŸ’…

🌸 Environment variables for 'randconfig' 🌸

  • KCONFIG_SEED β€” you can set this to the integer value used to seed the RNG, if you want to somehow debug the behaviour of the kconfig parser/frontends. if it's not set, the current time will be used. ⭐
  • KCONFIG_PROBABILITY β€” this variable can be used to skew the probabilities. see /usr/share/doc/kconfig-frontends/kconfig.txt.gz. πŸ“–

🌸 Environment variables for 'silentoldconfig' 🌸

  • KCONFIG_NOSILENTUPDATE β€” if this variable has a non-blank value, it prevents silent kernel config updates (requires explicit updates). no sneaky updates allowed, we ask first πŸ™ˆ
  • KCONFIG_AUTOCONFIG β€” this environment variable can be set to specify the path name of the "auto.conf" file. its default value is "include/config/auto.conf". πŸ’œ
  • KCONFIG_TRISTATE β€” this environment variable can be set to specify the path name of the "tristate.conf" file. its default value is "include/config/tristate.conf". 🌸
  • KCONFIG_AUTOHEADER β€” this environment variable can be set to specify the path name of the "autoconf.h" (header) file. its default value is "include/generated/autoconf.h". πŸŽ€

✨ HISTORY ✨

June 2017 β€” this man page was originally compiled by Philippe Thierry (phil at reseau-libre dot com). thank you for your service, king πŸ«‘πŸ’–


and that's the whole page, bestie!! πŸ¦‹ this was the kconfig man page from the kconfig manual, page date October 2017, written by Philippe Thierry, and it's a wrap πŸ’…βœ¨πŸ‘‘