英語

• 簡體中文

配置目標和編輯器

此檔案包含使用 make *config 的一些幫助資訊。

使用 make help 列出所有可能的配置目標。

xconfig (‘qconf’)、menuconfig (‘mconf’) 和 nconfig (‘nconf’) 程式也具有嵌入式幫助文字。 請務必檢查導航、搜尋和其他常規幫助文字。

gconfig (‘gconf’) 程式提供的幫助文字有限。

常規

新的核心版本通常會引入新的配置符號。 更重要的是，新的核心版本可能會重新命名配置符號。 發生這種情況時，使用先前工作的 .config 檔案並執行 “make oldconfig” 不一定會為您生成一個可工作的新核心，因此您可能會發現需要檢視引入了哪些新的核心符號。

要檢視新配置符號的列表，請使用

cp user/some/old.config .config
make listnewconfig

配置程式將逐行列出所有新的符號。

或者，您可以使用暴力方法

make oldconfig
scripts/diffconfig .config.old .config | less

環境變數

*config 的環境變數

KCONFIG_CONFIG

此環境變數可用於指定預設的核心配置檔名，以覆蓋預設名稱 “.config”。

KCONFIG_DEFCONFIG_LIST

此環境變數指定一個配置檔案列表，如果 .config 尚不存在，則可以使用這些檔案作為基本配置。 列表中的條目彼此用空格分隔，並且使用存在的第一個條目。

KCONFIG_OVERWRITECONFIG

如果在環境中設定了 KCONFIG_OVERWRITECONFIG，則當 .config 是指向其他位置的符號連結時，Kconfig 將不會中斷符號連結。

KCONFIG_WARN_UNKNOWN_SYMBOLS

此環境變數使 Kconfig 警告配置輸入中所有無法識別的符號。

KCONFIG_WERROR

如果設定了此變數，Kconfig 會將警告視為錯誤。

CONFIG_

如果在環境中設定 CONFIG_，Kconfig 將使用其值作為字首，而不是使用預設值 CONFIG_，來為所有符號新增字首，然後再儲存配置。

{allyes/allmod/allno/rand}config 的環境變數

KCONFIG_ALLCONFIG

allyesconfig/allmodconfig/allnoconfig/randconfig 變體也可以使用環境變數 KCONFIG_ALLCONFIG 作為標誌或包含使用者需要設定為特定值的配置符號的檔案。 如果 KCONFIG_ALLCONFIG 在沒有檔名的情況下使用，其中 KCONFIG_ALLCONFIG == “” 或 KCONFIG_ALLCONFIG == “1”，則 make *config 會檢查一個名為 “all{yes/mod/no/def/random}.config” 的檔案（對應於使用的 *config 命令），以獲取要強制執行的符號值。 如果找不到此檔案，它將檢查名為 “all.config” 的檔案是否包含強制值。

這使您可以建立 “微型” 配置 (miniconfig) 或自定義配置檔案，其中僅包含您感興趣的配置符號。 然後，核心配置系統會生成完整的 .config 檔案，其中包括您的微型配置檔案中的符號。

此 KCONFIG_ALLCONFIG 檔案是一個配置檔案，其中包含（通常是所有）預設配置符號的子集。 這些變數設定仍然要經過正常的依賴項檢查。

示例

KCONFIG_ALLCONFIG=custom-notebook.config make allnoconfig

或

KCONFIG_ALLCONFIG=mini.config make allnoconfig

或

make KCONFIG_ALLCONFIG=mini.config allnoconfig

這些示例將停用大多數選項 (allnoconfig)，但會啟用或停用在指定的微型配置檔案中顯式列出的選項。

randconfig 的環境變數

KCONFIG_SEED

如果要以某種方式除錯 kconfig 解析器/前端的行為，則可以將其設定為用於播種 RNG 的整數值。 如果未設定，將使用當前時間。

KCONFIG_PROBABILITY

此變數可用於傾斜機率。 可以取消設定或為空此變數，或者將其設定為三種不同的格式

KCONFIG_PROBABILITY	y:n 分割	y:m:n 分割
未設定或為空	50 : 50	33 : 33 : 34
N	N : 100-N	N/2 : N/2 : 100-N
[1] N:M	N+M : 100-(N+M)	N : M : 100-(N+M)
[2] N:M:L	N : 100-N	M : L : 100-(M+L)

其中 N、M 和 L 是 [0,100] 範圍內的整數（以 10 為底），因此

[1] N+M 在 [0,100] 範圍內

[2] M+L 在 [0,100] 範圍內

示例

KCONFIG_PROBABILITY=10
    10% of booleans will be set to 'y', 90% to 'n'
    5% of tristates will be set to 'y', 5% to 'm', 90% to 'n'
KCONFIG_PROBABILITY=15:25
    40% of booleans will be set to 'y', 60% to 'n'
    15% of tristates will be set to 'y', 25% to 'm', 60% to 'n'
KCONFIG_PROBABILITY=10:15:15
    10% of booleans will be set to 'y', 90% to 'n'
    15% of tristates will be set to 'y', 15% to 'm', 70% to 'n'

syncconfig 的環境變數

KCONFIG_NOSILENTUPDATE

如果此變數具有非空白值，則會阻止靜默核心配置更新（需要顯式更新）。

KCONFIG_AUTOCONFIG

可以設定此環境變數以指定 “auto.conf” 檔案的路徑和名稱。 它的預設值為 “include/config/auto.conf”。

KCONFIG_AUTOHEADER

可以設定此環境變數以指定 “autoconf.h”（標頭檔案）檔案的路徑和名稱。 它的預設值為 “include/generated/autoconf.h”。

menuconfig

在 menuconfig 中搜索

搜尋功能會搜尋核心配置符號名稱，因此您必須知道與您要查詢的內容接近的內容。

示例

/hotplug
This lists all config symbols that contain "hotplug",
e.g., HOTPLUG_CPU, MEMORY_HOTPLUG.

如需搜尋幫助，請輸入 /，然後按 TAB-TAB（以突出顯示 <Help>）並按 Enter。 這會告訴您可以將正則表示式 (regexes) 也用於搜尋字串中，因此如果您對 MEMORY_HOTPLUG 不感興趣，您可以嘗試

/^hotplug

搜尋時，符號按以下方式排序

• 首先，完全匹配項，按字母順序排序（完全匹配是指搜尋與完整符號名稱匹配的情況）；

• 然後，其他匹配項，按字母順序排序。

例如，^ATH.K 匹配

ATH5K ATH9K ATH5K_AHB ATH5K_DEBUG [...] ATH6KL ATH6KL_DEBUG [...] ATH9K_AHB ATH9K_BTCOEX_SUPPORT ATH9K_COMMON [...]

其中只有 ATH5K 和 ATH9K 完全匹配，因此首先排序（並按字母順序），然後是所有其他符號，按字母順序排序。

在此選單中，按下 (#) 字首中的鍵將直接跳轉到該位置。 退出此新選單後，您將返回到當前搜尋結果。

“menuconfig” 的使用者介面選項

MENUCONFIG_COLOR

可以使用變數 MENUCONFIG_COLOR 選擇不同的顏色主題。 要選擇主題，請使用

make MENUCONFIG_COLOR=<theme> menuconfig

可用主題包括

- mono       => selects colors suitable for monochrome displays
- blackbg    => selects a color scheme with black background
- classic    => theme with blue background. The classic look
- bluetitle  => a LCD friendly version of classic. (default)

MENUCONFIG_MODE

此模式在一個大型樹中顯示所有子選單。

示例

make MENUCONFIG_MODE=single_menu menuconfig

nconfig

nconfig 是另一種基於文字的配置器。 它在終端（視窗）底部列出執行命令的功能鍵。 您也可以只使用相應的數字鍵來執行命令，除非您在資料輸入視窗中。 例如，您可以直接按 6 而不是 F6 儲存。

使用 F1 獲取全域性幫助或 F3 獲取簡短幫助選單。

在 nconfig 中搜索

您可以搜尋選單項 “提示” 字串或配置符號。

使用 / 開始搜尋選單條目。 這不支援正則表示式。 使用 <Down> 或 <Up> 分別查詢下一個命中項和上一個命中項。 使用 <Esc> 終止搜尋模式。

F8 (SymSearch) 搜尋給定字串或正則表示式 (regex) 的配置符號。

在 SymSearch 中，按下 (#) 字首中的鍵將直接跳轉到該位置。 退出此新選單後，您將返回到當前搜尋結果。

環境變數

NCONFIG_MODE

此模式在一個大型樹中顯示所有子選單。

示例

make NCONFIG_MODE=single_menu nconfig

xconfig

在 xconfig 中搜索

搜尋功能會搜尋核心配置符號名稱，因此您必須知道與您要查詢的內容接近的內容。

示例

Ctrl-F hotplug

或

Menu: File, Search, hotplug

列出符號名稱中包含 “hotplug” 的所有配置符號條目。 在此搜尋對話方塊中，您可以更改任何未灰顯的條目的配置設定。 您還可以輸入不同的搜尋字串，而無需返回主選單。

gconfig

在 gconfig 中搜索

gconfig 中沒有搜尋命令。 但是，gconfig 確實有幾種不同的檢視選項、模式和選項。