配置文件kconfig语法

配置文件kconfig语法

对于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

   +- ...

每个选项都有其自己的依赖关系。这些依赖关系决定了选项是否是可见的。父选项可见，子选项才能可见。

 

配置文件描述了菜单选项，每行都是以一关键字开头(除了帮助信息)，下一个关键字结束此菜单选项：

1 - config

2 - menuconfig

3 - choice/endchoice

4 - comment

5 - menu/endmenu

6 - if/endif

7 - source

前5个同样可以用在菜单选项定义的开始。

config: "config"	此关键字定义了一新的配置选项
menuconfig: "menuconfig"	此关键字和前面的关键字很相似，但它在前面的基础上要求所有的子选项作为独立的行显示。
choices: "choice"     "endchoice"	该关键字定义了一组选择项。
comment: "comment"	这里定义了在配置过程中显示给用户的注释，该注释还将写进输出文件中。
menu: "menu"     "endmenu"	这里定义了一个菜单，所有依赖于此菜单的选项都是它的子选项。
if: "if"   "endif"	这里定义了if结构。
source: "source"	读取其他具体的配置文件，其他配置文件会被解析。

 

1、菜单选项

每个菜单项都有一个关键字标识，最常见的就是config，一个配置选项定义的形式：

 

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" 为定义了一新的配置选项。下面的几行定义了该配置选项的属性。属性可以是该配置选项的（1）类型，（2）输入提示(input prompt)，（3）依赖关系，（4）默认值和，（5）帮助信息。一个配置选项可以用相同的名字定义多次，但每个定义只能有一个输入提示并且类型还不能冲突。

 

（1）配置选项的类型："bool"/"tristate"/"string"/"hex"/"int"

每个config菜单项都要有类型定义，bool：布尔类型， tristate三态：内建、模块、移除， string：字符串， hex：十六进制，int：整型，如：bool类型的只能选中或不选中，tristate类型的菜单项多了编译成内核模块的选项等，类型定义可以用输入提示，所以下面的两个例子是等价的：

   bool "Networking support"

和

   bool

   prompt "Networking support"

每个菜单选项最多只能有一个显示给用户的输入提示。可以用 "if" 来表示该提示的依赖关系输入提示：（ "prompt" ["if" ]），当然这是可选的。

（2） 输入提示：

输入提示，举例：prompt "Networking support"

（3） 依赖关系："depends on"/"requires"

为一菜单选项定义依赖关系。如果定义了多个依赖关系，它们之间用 '&&' 间隔。依赖关系也可以应用到该菜单中所有的其它选项。并且depends on与if等价，如下等价：

 

   bool "foo" if BAR

   default y if BAR

和

   depends on BAR

   bool "foo"

   default y

depends on BAR

（4）默认值："default" ["if" ]

一个配置选项可以有任意多个默认值。如果有多个默认值，那么只有第一个被定义的值是可用的。如果用户没有设置(通过上面的输入提示)，配置选项的值就是显示输入也即默认值。如果可以显示输入提示的话，就会把默认值显示给用户，并可以让用户进行修改。

默认值的依赖关系可以用 "if" 添加。(可选项)

（4） 帮助信息"help" or "---help---"

帮助信息的结束就由缩进的水平决定的，这也就意味着信息是在第一个比帮助信息开始行的缩进小的行结束。

"---help---" 和 "help" 在实现的作用上没有区别，"---help---" 有助于将文件中的配置逻辑与

给开发人员的提示分开。

 

2、菜单结构

菜单在树中的位置可由两种方法决定。第一种——直接树状结构：

menu "Network device support"

   depends NET

 

config NETDEVICES

   ...

 

endmenu

 

所有的在"menu" ... "endmenu" 之间都是"Network device support"的子菜单。所有的子菜单选项都继承了父菜单的依赖关系，比如，"NET"的依赖关系就被加到了配置选项NETDEVICES的依赖列表中。

第二种_通过分析依赖关系生成菜单的结构：

config MODULES

   bool "Enable loadable module support"

 

config MODVERSIONS

   bool "Set version information on all module symbols"

   depends MODULES

 

如果菜单选项在一定程度上依赖于前面的选项，它就能成为该选项的子菜单。前面的(父)选项必须是依赖列表中的一部分并且它们中必须有满足下面两个条件的选项：

- 如果父选项为'n'，子选项必须不可见。

- 如果父选项可见，子选项才能可见。

 

如上面的例子中：MODVERSIONS 直接依赖 MODULES，这就意味着如果MODULES不为'n'，该选项才可见。换句话说，当MODULES可见时，MODVERSIONS选项才可见(MODULES的(空)依赖关系也是选项依赖关系的一部分)。