Kconfig基本語法


 

 

Linux 內核在2.6版本以后將配置文件由原來的config.in改為Kconfig。當執行make menuconfig時會出現內核的配置界面,所有配置工具都是通過讀取arch/$(ARCH)Kconfig文件來生成配置界面,這個文件就是所有配置的總入口,它會包含其他目錄的Kconfig

Kconfig的作用是用來配置內核,它就是各種配置界面的源文件,內核的配置工具讀取各個Kconfig文件,生成配置界面供開發人員配置內核,最后生成配置文件.config

Kconfig的語法可以參考Documentation/kbuild/kconfig-language.txt,在這里給出kconfig-language.txt的中文翻譯。

 

介紹

----

在配置數據庫的配置選項是以樹的形式組織的:

+- Code maturity level options

   | +- Prompt for development and/or incomplete code/drivers

   +- General setup

   | +- Networking support

   | +- System V IPC

   | +- BSD Process Accounting

   | +- Sysctl support

   +- Loadable module support

   | +- Enable loadable module support

   |     +- Set version information on all module symbols

   |     +- Kernel module loader

   +- ...

每個選項都有其自己的依賴關系。這些依賴關系決定了選項是否是可見的。父選項可見,子選項才能可見。

 

菜單選項

--------

大多數的選項都定義了一個配置選項,其它選項則有助於對它們進行組織。一個配置選項定義可以是下面的形式:

config MODVERSIONS

   bool "Set version information on all module symbols"

   depends MODULES

   help

      Usually, modules have to be recompiled whenever you switch to a new

      kernel. ...

每行都是以config關鍵字開始,並可以接多個參數。"config" 為定義了一新的配置選項。下面的幾行定義了該配置選項的屬性。屬性可以是該配置選項的類型、輸入提示(input prompt)、依賴關系、幫助信息和默認值。配置選項可以用相同的名字定義多次,但每個定義只能有一個輸入提示並且類型還不能沖突。

 

菜單屬性

--------

菜單選項可以有多個屬性。並不要求這些屬性可以用在任何地方(見語法)

類型定義:"bool"/"tristate"/"string"/"hex"/"int"

每個配置選項都必須指定類型。有兩個基本類型:tristate string,其他類型都是基於這兩個基本類型。類型定義可以用輸入提示,所以下面的兩個例子是等價的:

   bool "Networking support"

   bool

   prompt "Networking support"

 

輸入提示: "prompt " <prompt> ["if" <expr>]

每個菜單選項最多只能有一個顯示給用戶的輸入提示。可以用 "if" 來表示該提示的依賴關系,當然這是可選的。

默認值:"default" <expr> ["if" <expr>]

一個配置選項可以有任意多個默認值。如果有多個默認值,那么只有第一個被定義的值是可用的。默認值並不是只限於應用在定義他們的菜單選項。這就意味着默認值可以定義在任何地方或被更早的定義覆蓋。如果用戶沒有設置(通過上面的輸入提示),配置選項的值就是默認值。如果可以顯示輸入提示的話,就會把默認值顯示給用戶,並可以讓用戶進行修改。默認值的依賴關系可以用 "if" 添加。(可選項)

 

依賴關系:"depends on"/"requires" <expr>

為一菜單選項定義依賴關系。如果定義了多個依賴關系,它們之間用 '&&' 間隔。依賴關系也可以應用到該菜單中所有的其它選項(同樣接受一if表達式),所以下面的兩個例子是等價的:

   bool "foo" if BAR

   default y if BAR

and

   depends on BAR

   bool "foo"

   default y

 

反向依賴關系:"select" <symbol> ["if" <expr>]

盡管普通的依賴關系可以降低選項的上限,反向依賴能將這一限制降的更低。當前菜單選項的值是symbol的最小值。如果symbol被選擇了多次,上限就是其中的最大值。反向依賴只能用在 boolean tristate 選項上。

 

數據范圍:"range" <symbol> <symbol> ["if" <expr>]

inthex類型的選項設置可以接受輸入值范圍。用戶只能輸入大於等於第一個symbol,小於等於第二個symbol的值。

 

幫助信息: "help" or "---help---"

定義一幫助信息。幫助信息的結束就由縮進的水平決定的,這也就意味着信息是在第一個比幫助信息開始行的縮進小的行結束。"---help---" "help" 在實現的作用上沒有區別,"---help---" 有助於將文件中的配置邏輯與給開發人員的提示分開。

 

菜單依賴關系

------------

依賴關系決定了菜單選項是否可見,也可以減少tristate的輸入范圍。tristate邏輯比boolean邏輯在表達式中用更多的狀態(state)來表示模塊的狀態。依賴關系表達式的語法如下:

<expr> ::= <symbol>                             (1)

           <symbol> '=' <symbol>                (2)

           <symbol> '!=' <symbol>               (3)

           '(' <expr> ')'                       (4)

           '!' <expr>                           (5)

           <expr> '&&' <expr>                   (6)

           <expr> '||' <expr>                   (7)

表達式是以優先級的降序列出的。

(1) symbol賦給表達式。booleantristate類型的symbol直接賦給表達式。所有其它類型的symbol都賦 'n'

(2) 如果兩個symbol相等,返回'y',否則為'n'

(3) 如果兩個symbol相等,返回'n',否則為'y'

(4) 返回表達式的值。用於改變優先級。

(5) 返回 !(/expr/) 的結果。

(6) 返回 min(/expr/,/expr/) 的結果。

(7) 返回 max(/expr/,/expr/) 的結果。

一個表達式的值可以是'n''m''y'(或者是計算的結果 0,1,2)。當表達式的值為'm''y'的時候,菜單項才是可見的。

symbol有兩種類型:不可變的和可變的。不可變的symbol是最普通的,由'config'語句定義,完全由數字、字母和下划線組成。不可變的symbol只是表達式的一部分。經常用單引號或雙引號括起來。在引號中,可以使用任何字符,使用引號要用轉義字符'/'

 

菜單結構

--------

菜單在樹中的位置可由兩種方法決定。第一種可以是這樣:

menu "Network device support"

   depends NET

config NETDEVICES

   ...

endmenu

所有的在"menu" ... "endmenu" 之間都是"Network device support"的子菜單。所有的子菜單選項都繼承了父菜單的依賴關系,比如,"NET"的依賴關系就被加到了配置選項NETDEVICES的依賴列表中。

還有就是通過分析依賴關系生成菜單的結構。如果菜單選項在一定程度上依賴於前面的選項,它就能成為該選項的子菜單。首先,前面的()選項必須是依賴列表中的一部分並且它們中必須有滿足下面兩個條件的選項:

如果父選項為'n',子選項必須不可見。

如果父選項可見,子選項才能可見。

config MODULES

   bool "Enable loadable module support"

config MODVERSIONS

   bool "Set version information on all module symbols"

   depends MODULES

comment "module support disabled"

   depends !MODULES

MODVERSIONS 直接依賴 MODULES,這就意味着如果MODULES不為'n',該選項才可見。換句話說,當MODULES可見時,選項才可見(MODULES()依賴關系也是選項依賴關系的一部分)

 

Kconfig 語法

------------

配置文件描述了菜單選項,每行都是以一關鍵字開頭(除了幫助信息)。下面的關鍵字:

- config

- menuconfig

- choice/endchoice

- comment

- menu/endmenu

- if/endif

- source

5個同樣可以用在菜單選項定義的開始。

 

1config:

   "config" <symbol>

   <config options>

config是關鍵字,表示一個配置選項的開始;緊跟着的<symbol>是配置選項的名稱,省略了前綴"CONFIG_"

例如:

config TMPFS_POSIX_ACL

    bool "Tmpfs POSIX Access Control Lists"

    depends on TMPFS

    select GENERIC_ACL

    help

      POSIX Access Control Lists (ACLs) support permissions for users and

      groups beyond the owner/group/world scheme.

      To learn more about Access Control Lists, visit the POSIX ACLs for

      Linux website <http://acl.bestbits.at/>.

     If you don't know what Access Control Lists are, say N.

解析:config是關鍵字,表示一個配置選項的開始;緊跟着的TMPFS_POSIX_ACL是配置選項的名稱,省略了前綴"CONFIG_"

    bool表示變量類型,即"CONFIG_ TMPFS_POSIX_ACL "的類型,有5種類型:booltristatestringhexint,其中tristatestring是基本的類型

    bool變量的值:     yn

    tristate變量的值: ynm

    string變量的值:   字符串

    bool之后的字符串“Tmpfs POSIX Access Control Lists”是提示信息,在配置界面中上下移動光標選中它時,就可以通過按空格或回車鍵來設置CONFIG_ TMPFS_POSIX_ACL的值。

depends on:表示依賴於XXX,“depends on TMPFS”表示只有當TMPFS配置選項被選中時,當前配置選項的提示信息才會出現,才能設置當前配置選項。

 

2menuconfig:

   "menuconfig" <symbol>

   <config options>

此關鍵字和前面的關鍵字很相似,但它在前面的基礎上要求所有的子選項作為獨立的行顯示。

 

3choices:

   "choice"

   <choice options>

   <choice block>

   "endchoice"

該關鍵字定義了一組選擇項,並且選項可以是前面描述的任何屬性。盡管boolean只允許選擇一個配置選項,tristate可以抒多個配置選項設為'm',但選項只能是booleantristate類型。這可以在一個硬件有多個驅動的情況下使用,最終只有一個驅動被編譯進/加載到內核,但所有的驅動都可以編譯成模塊。選項可以接受的另一個選項是"optional",這樣選項就被設置為'n',沒有被選中的。

例如:

    choice條目將多個類似的配置選項組合在一起,供用戶單選或多選

       choice

             prompt "ARM system type"

             default ARCH_VERSATILE

             config ARCH_AAEC2000

                  .........

             config ARCH_REALVIEW

                  .........

        endchoice

      prompt "ARM system type"給出提示信息“ARM system type”,光標選中后回車進入就可以看到多個config條目定義的配置選項。choice條目中定義的變量只有booltristate

 

4comment:

   "comment" <prompt>

   <comment options>

這里定義了在配置過程中顯示給用戶的注釋,該注釋還將寫進輸出文件中。唯一可用的可選項是依賴關系。

例如:

    comment條目用於定義一些幫助信息,出現在界面的第一行,如在arch/arm/Kconifg中有如下代碼:

menu "Floating point emulation"

comment "At least one emulation must be selected"

config FPE_NWFPE

.........                                                                              

config FPE_NWFPE_XP

在界面中如下所示:

clip_image002

 

5menu:

   "menu" <prompt>

   <menu options>

   <menu block>

   "endmenu"

這里定義了一個菜單,詳細信息請看前面的"菜單結構"。唯一可用的可選項是依賴關系。

例如:

    menu條目用於生成菜單,其格式如下:

         menu "Floating poing emulation"

         config FPE_NWFPE

         ..............

         config FPE_NWFPE_XP

         .............

         endmenu

   menu之后的Floating poing emulation是菜單名,menuendmenu間有很多config條目,在配置界面中如下所示:

         Floating poing emulation--->

                       [] FPE_NWFPE

                       [] FPE_NWFPE_XP

6if:

   "if" <expr>

   <if block>

   "endif"

這里定義了if結構。依賴關系<expr>被加到所有在if ... endif 中的菜單選項中。

 

7source

   source條目用於讀取另一個Kconfig文件,如:

        source "net/Kconifg"

 

 

 

 

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM