Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 1 | This file contains some assistance for using "make *config". |
| 2 | |
| 3 | Use "make help" to list all of the possible configuration targets. |
| 4 | |
| 5 | The xconfig ('qconf') and menuconfig ('mconf') programs also |
| 6 | have embedded help text. Be sure to check it for navigation, |
| 7 | search, and other general help text. |
| 8 | |
| 9 | ====================================================================== |
| 10 | General |
| 11 | -------------------------------------------------- |
| 12 | |
| 13 | New kernel releases often introduce new config symbols. Often more |
| 14 | important, new kernel releases may rename config symbols. When |
| 15 | this happens, using a previously working .config file and running |
| 16 | "make oldconfig" won't necessarily produce a working new kernel |
| 17 | for you, so you may find that you need to see what NEW kernel |
| 18 | symbols have been introduced. |
| 19 | |
| 20 | To see a list of new config symbols when using "make oldconfig", use |
| 21 | |
| 22 | cp user/some/old.config .config |
| 23 | yes "" | make oldconfig >conf.new |
| 24 | |
| 25 | and the config program will list as (NEW) any new symbols that have |
| 26 | unknown values. Of course, the .config file is also updated with |
| 27 | new (default) values, so you can use: |
| 28 | |
| 29 | grep "(NEW)" conf.new |
| 30 | |
Javi Merino | 673d29f | 2012-03-30 13:37:02 -0700 | [diff] [blame] | 31 | to see the new config symbols or you can use diffconfig to see the |
| 32 | differences between the previous and new .config files: |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 33 | |
Javi Merino | 673d29f | 2012-03-30 13:37:02 -0700 | [diff] [blame] | 34 | scripts/diffconfig .config.old .config | less |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 35 | |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 36 | ______________________________________________________________________ |
| 37 | Environment variables for '*config' |
| 38 | |
| 39 | KCONFIG_CONFIG |
| 40 | -------------------------------------------------- |
| 41 | This environment variable can be used to specify a default kernel config |
| 42 | file name to override the default name of ".config". |
| 43 | |
| 44 | KCONFIG_OVERWRITECONFIG |
| 45 | -------------------------------------------------- |
| 46 | If you set KCONFIG_OVERWRITECONFIG in the environment, Kconfig will not |
| 47 | break symlinks when .config is a symlink to somewhere else. |
| 48 | |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 49 | ______________________________________________________________________ |
| 50 | Environment variables for '{allyes/allmod/allno/rand}config' |
| 51 | |
| 52 | KCONFIG_ALLCONFIG |
| 53 | -------------------------------------------------- |
| 54 | (partially based on lkml email from/by Rob Landley, re: miniconfig) |
| 55 | -------------------------------------------------- |
| 56 | The allyesconfig/allmodconfig/allnoconfig/randconfig variants can |
| 57 | also use the environment variable KCONFIG_ALLCONFIG as a flag or a |
| 58 | filename that contains config symbols that the user requires to be |
| 59 | set to a specific value. If KCONFIG_ALLCONFIG is used without a |
| 60 | filename, "make *config" checks for a file named |
Sam Ravnborg | 0748cb3 | 2010-07-31 23:35:31 +0200 | [diff] [blame] | 61 | "all{yes/mod/no/def/random}.config" (corresponding to the *config command |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 62 | that was used) for symbol values that are to be forced. If this file |
| 63 | is not found, it checks for a file named "all.config" to contain forced |
| 64 | values. |
| 65 | |
| 66 | This enables you to create "miniature" config (miniconfig) or custom |
| 67 | config files containing just the config symbols that you are interested |
| 68 | in. Then the kernel config system generates the full .config file, |
| 69 | including symbols of your miniconfig file. |
| 70 | |
| 71 | This 'KCONFIG_ALLCONFIG' file is a config file which contains |
| 72 | (usually a subset of all) preset config symbols. These variable |
| 73 | settings are still subject to normal dependency checks. |
| 74 | |
| 75 | Examples: |
| 76 | KCONFIG_ALLCONFIG=custom-notebook.config make allnoconfig |
| 77 | or |
| 78 | KCONFIG_ALLCONFIG=mini.config make allnoconfig |
| 79 | or |
| 80 | make KCONFIG_ALLCONFIG=mini.config allnoconfig |
| 81 | |
| 82 | These examples will disable most options (allnoconfig) but enable or |
| 83 | disable the options that are explicitly listed in the specified |
| 84 | mini-config files. |
| 85 | |
| 86 | ______________________________________________________________________ |
| 87 | Environment variables for 'silentoldconfig' |
| 88 | |
| 89 | KCONFIG_NOSILENTUPDATE |
| 90 | -------------------------------------------------- |
| 91 | If this variable has a non-blank value, it prevents silent kernel |
Thomas Weber | 8839316 | 2010-03-16 11:47:56 +0100 | [diff] [blame] | 92 | config updates (requires explicit updates). |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 93 | |
| 94 | KCONFIG_AUTOCONFIG |
| 95 | -------------------------------------------------- |
| 96 | This environment variable can be set to specify the path & name of the |
| 97 | "auto.conf" file. Its default value is "include/config/auto.conf". |
| 98 | |
Michal Marek | bc081dd | 2009-12-07 16:38:33 +0100 | [diff] [blame] | 99 | KCONFIG_TRISTATE |
| 100 | -------------------------------------------------- |
| 101 | This environment variable can be set to specify the path & name of the |
| 102 | "tristate.conf" file. Its default value is "include/config/tristate.conf". |
| 103 | |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 104 | KCONFIG_AUTOHEADER |
| 105 | -------------------------------------------------- |
| 106 | This environment variable can be set to specify the path & name of the |
Sam Ravnborg | 264a268 | 2009-10-18 00:49:24 +0200 | [diff] [blame] | 107 | "autoconf.h" (header) file. |
| 108 | Its default value is "include/generated/autoconf.h". |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 109 | |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 110 | |
| 111 | ====================================================================== |
| 112 | menuconfig |
| 113 | -------------------------------------------------- |
| 114 | |
| 115 | SEARCHING for CONFIG symbols |
| 116 | |
| 117 | Searching in menuconfig: |
| 118 | |
| 119 | The Search function searches for kernel configuration symbol |
| 120 | names, so you have to know something close to what you are |
| 121 | looking for. |
| 122 | |
| 123 | Example: |
| 124 | /hotplug |
| 125 | This lists all config symbols that contain "hotplug", |
| 126 | e.g., HOTPLUG, HOTPLUG_CPU, MEMORY_HOTPLUG. |
| 127 | |
| 128 | For search help, enter / followed TAB-TAB-TAB (to highlight |
| 129 | <Help>) and Enter. This will tell you that you can also use |
| 130 | regular expressions (regexes) in the search string, so if you |
| 131 | are not interested in MEMORY_HOTPLUG, you could try |
| 132 | |
| 133 | /^hotplug |
| 134 | |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 135 | ______________________________________________________________________ |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 136 | User interface options for 'menuconfig' |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 137 | |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 138 | MENUCONFIG_COLOR |
| 139 | -------------------------------------------------- |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 140 | It is possible to select different color themes using the variable |
| 141 | MENUCONFIG_COLOR. To select a theme use: |
| 142 | |
| 143 | make MENUCONFIG_COLOR=<theme> menuconfig |
| 144 | |
| 145 | Available themes are: |
| 146 | mono => selects colors suitable for monochrome displays |
| 147 | blackbg => selects a color scheme with black background |
| 148 | classic => theme with blue background. The classic look |
| 149 | bluetitle => a LCD friendly version of classic. (default) |
| 150 | |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 151 | MENUCONFIG_MODE |
| 152 | -------------------------------------------------- |
| 153 | This mode shows all sub-menus in one large tree. |
| 154 | |
| 155 | Example: |
Markus Heidelberg | 98f540d31b | 2009-05-18 01:36:47 +0200 | [diff] [blame] | 156 | make MENUCONFIG_MODE=single_menu menuconfig |
| 157 | |
Randy Dunlap | 2af238e | 2008-02-29 14:21:53 -0800 | [diff] [blame] | 158 | |
| 159 | ====================================================================== |
| 160 | xconfig |
| 161 | -------------------------------------------------- |
| 162 | |
| 163 | Searching in xconfig: |
| 164 | |
| 165 | The Search function searches for kernel configuration symbol |
| 166 | names, so you have to know something close to what you are |
| 167 | looking for. |
| 168 | |
| 169 | Example: |
| 170 | Ctrl-F hotplug |
| 171 | or |
| 172 | Menu: File, Search, hotplug |
| 173 | |
| 174 | lists all config symbol entries that contain "hotplug" in |
| 175 | the symbol name. In this Search dialog, you may change the |
| 176 | config setting for any of the entries that are not grayed out. |
| 177 | You can also enter a different search string without having |
| 178 | to return to the main menu. |
| 179 | |
| 180 | |
| 181 | ====================================================================== |
| 182 | gconfig |
| 183 | -------------------------------------------------- |
| 184 | |
| 185 | Searching in gconfig: |
| 186 | |
| 187 | None (gconfig isn't maintained as well as xconfig or menuconfig); |
| 188 | however, gconfig does have a few more viewing choices than |
| 189 | xconfig does. |
| 190 | |
| 191 | ### |