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>]

为int和hex类型的选项设置可以接受输入值范围。用户只能输入大于等于第一个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赋给表达式。boolean和tristate类型的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个同样可以用在菜单选项定义的开始。

1、config:

"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种类型:bool、tristate、string、hex和int,其中tristate和string是基本的类型

bool变量的值:     y和n

tristate变量的值: y、n和m

string变量的值:   字符串

bool之后的字符串“Tmpfs POSIX Access Control Lists”是提示信息,在配置界面中上下移动光标选中它时,就可以通过按空格或回车键来设置CONFIG_ TMPFS_POSIX_ACL的值。

depends on:表示依赖于XXX,“depends on TMPFS”表示只有当TMPFS配置选项被选中时,当前配置选项的提示信息才会出现,才能设置当前配置选项。

2、menuconfig:

"menuconfig" <symbol>

<config options>

此关键字和前面的关键字很相似,但它在前面的基础上要求所有的子选项作为独立的行显示。

3、choices:

"choice"

<choice options>

<choice block>

"endchoice"

该关键字定义了一组选择项,并且选项可以是前面描述的任何属性。尽管boolean只允许选择一个配置选项,tristate可以抒多个配置选项设为‘m‘,但选项只能是boolean或tristate类型。这可以在一个硬件有多个驱动的情况下使用,最终只有一个驱动被编译进/加载到内核,但所有的驱动都可以编译成模块。选项可以接受的另一个选项是"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条目中定义的变量只有bool和tristate。

4、comment:

"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

在界面中如下所示:

5、menu:

"menu" <prompt>

<menu options>

<menu block>

"endmenu"

这里定义了一个菜单,详细信息请看前面的"菜单结构"。唯一可用的可选项是依赖关系。

例如:

menu条目用于生成菜单,其格式如下:

menu "Floating poing emulation"

config FPE_NWFPE

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

config FPE_NWFPE_XP

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

endmenu

menu之后的Floating poing emulation是菜单名,menu和endmenu间有很多config条目,在配置界面中如下所示:

Floating poing emulation--->

[] FPE_NWFPE

[] FPE_NWFPE_XP

6、if:

"if" <expr>

<if block>

"endif"

这里定义了if结构。依赖关系<expr>被加到所有在if ... endif 中的菜单选项中。

7、source:

source条目用于读取另一个Kconfig文件,如:

source "net/Kconifg"

时间: 2024-10-11 17:31:32

Kconfig基本语法的相关文章

kconfig 和 config.in 语法 翻译

内核源码树的目录下都有两个文件Kconfig(2.4版本是Config.in)和Makefile.分布到各目录的 Kconfig构成了一个分布式的内核配置数据库,每个Kconfig分别描述了所属目录源文件相关的内核配置菜单.在内核配置make menuconfig(或xconfig等)时,从Kconfig中读出菜单,用户选择后保存到.config的内核配置文件中.在内核编译时,主 Makefile调用这个.config,就知道了用户的选择. 上面的内容说明了,Kconfig就是对应着内核的配置菜

Konfig

内核源码树的目录下都有两个文档 Kconfig (2.4版本是Config.in)和Makefile.分布到各目录的Kconfig构成了一个分布式的内核配置数据库,每个Kconfig分别描述了 所属目录源文档相关的内核配置菜单.在内核配置make menuconfig时,从Kconfig中读出菜单,用户选择后保存到.config的内核配置文档中.在内核编译时,主Makefile调用这 个.config,就知道了用户的选择. 上面的内容说明了,Kconfig就是对应着内核的配置菜单.假如要想添加新

Samsung_tiny4412(笔记)--&gt;linux 3.5,U-Boot,Busybox,SD卡启动环境搭建

/*********************************************************************************** * * Samsung_tiny4412(笔记)-->linux 3.5,U-Boot,Busybox,SD卡启动环境搭建 * * 声明: * 1. 以下所有的shell命令都是在root权限下运行的; * 2. minicom(U-Boot)指的是用minicom连接开发板作为U-Boot的终端; * 3. 文中在需要往文件中

linux设备驱动归纳总结(一)内核的相关基础概念【转】

本文转载自:http://blog.chinaunix.net/uid-25014876-id-59413.html linux设备驱动归纳总结(一):内核的相关基础概念 xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx 一.linux设备驱动的作用 内核:用于管理软硬件资源,并提供运行环境.如分配4G虚拟空间等. linux设备驱动:是连接硬件和内核之间的桥梁. linu

kernel编译

Linux内核编译与安装 Linux内核介绍 Linux内核是一个用C语言写成的,符合POSIX标准的类Unix操作系统.内核是操作系统中最基本的一部分,提供了众多应用程序访问计算机硬件的机制.Linux内核的一大特点就是采用了整体式结构,有很多过程组成,每个过程都可以独立编译,其模块机制又湿得内核保持独立而又易于扩充.Linux发行版实在Linux内核的基础之上,与外带的应用软件和工具打包配置之后发行的版本.最初的Linux内核在1991年由当时还在芬兰赫尔辛基大学计算机系读书的Linus T

内核kconfig语法及原理

语法 http://www.cnblogs.com/AP0904225/p/5967979.html 目前自己用过 一.菜单 menu "desc" endmenu 二.可配菜单 menuconfig CONFIG_STR bool "desc" depends on CONFIG_OTHER default  y help if  CONFIG_STR ~~do sth endif 三.单选菜单 choice prompt "desc" def

Linux Kernel的Makefile与Kconfig文件的语法

https://www.kernel.org/doc/Documentation/kbuild/kconfig-language.txt Introduction ------------ The configuration database is a collection of configuration options organized in a tree structure: +- Code maturity level options | +- Prompt for developme

十天学Linux内核之第十天---总结篇(kconfig和Makefile &amp; 讲不出再见)

原文:十天学Linux内核之第十天---总结篇(kconfig和Makefile & 讲不出再见) 非常开心能够和大家一起分享这些,让我受益匪浅,感激之情也溢于言表,,code monkey的话少,没办法煽情了,,,,,,,冬天的风,吹得伤怀,倒叙往事,褪成空白~学校的人越来越少了,就像那年我们小年之后再回家的场景一样,到处荒芜,然而我们的激情却不褪去,依然狂躁在实验室凌晨两点半的星空里,也许今天又会是这样的一年,不一样的是身边的人变成学弟学妹了,而我们几个大三老家伙依然在,为自己喜欢的事情,为

【总结】嵌入式linux内核中Makefile、Kconfig、.config的关系及增加开机Hello World【转】

本文转载自:http://blog.csdn.net/fengyuwuzu0519/article/details/73772109 为了弄清内核的组织结构,我们先来实现下面这个简单的例子. 一.增加内核启动Hello World 任务: 内核启动的时候加载Hello驱动,并打印出Hello World 步骤: (1)在drivers目录下新建hello文件夹,在里面实现相应的hello.c.Makefile.Kconfig (2)修改上一级(Linux-3.4.2/drivers下)的Make