Kconfig文件结构

最新推荐文章于 2024-07-30 11:01:38 发布
最新推荐文章于 2024-07-30 11:01:38 发布
阅读量944 收藏 1
点赞数
分类专栏： Linux-file

Kconfig文件结构(图文)简介

1 Kconfig和Makefile

毫不夸张地说，Kconfig和Makefile是我们浏览内核代码时最为依仗的两个文件。基本上，Linux 内核中每一个目录下边都会有一个Kconfig文件和一个Makefile文件。Kconfig和Makefile就好似一个城市的地图，地图引导我们去 认识一个城市，而Kconfig和Makefile则可以让我们了解一个内核目录下面的结构。在希望研究内核的某个子系统、某个驱动或其他某个部分时，都 有必要首先仔细阅读一下相关目录下的Kconfig和Makefile文件。
分布到各目录的Kconfig构成了一个分布式的内核配置数据库，每个Kconfig分别描述了所属目录源文档相关的内核配置菜单。在内核配置make menuconfig时，从Kconfig中读出菜单，用户选择后保存到.config的内核配置文档中。 在内核编译时，主Makefile调用这个.config，就知道了用户的选择。
假如想使这个驱动被编译，则要修改Makefile文件，因此，需要添加新的驱动时，需要修改的文件有两个:Kconfig,Makefile.

2 菜单组织结构

一般一个Kconfig文件表示的就是一个菜单，一个菜单由多个菜单项组成,其格式如下:

menu 菜单名  

  

菜单项或菜单链接1  

菜单项或菜单链接2  

...  

菜单项或菜单链接n  

  

endmenu  

复制代码

其中菜单项就是指菜单的子菜单，所谓菜单链接就是指链接到另一个Kconfig文件，如此一下，菜单就可以实现随意嵌套了.

例如:

# drivers/Kconfig  

menu "Device Drivers"  

source "drivers/base/Kconfig"  

source "drivers/connector/Kconfig"  

source "drivers/mtd/Kconfig"  

source "drivers/of/Kconfig"  

source "drivers/parport/Kconfig"  

source "drivers/pnp/Kconfig"  

source "drivers/block/Kconfig"  

source "drivers/hello/Kconfig"  

config test  

  bool "提示字符串"  

  default y  

  ...  

endmenu   

复制代码

2.1 菜单项

语法:

config <symbol>  

<config options>  

复制代码

<symbol>为一符号，就好像代码中的局部变量x一样,可用于后边的表达式中.

例如:

config UEVENT_HELPER_PATH  

       string "path to uevent helper"  

       depends on HOTPLUG  

       default "/sbin/hotplug"  

       help  

      Path to uevent helper program forked by the kernel for  

      every uevent.  

复制代码

上面菜单项的属性string表示菜单的类型，每一个菜单项必须有一个类型.

注:每个config菜单项都会产生一个配置选项CONFIG_XXX, XXX即为<symbol>. 如上，则会产生一个配置项:CONFIG_UEVENT_HELPER_PATH,此配置项的值记录在内核根目录下的隐藏文件.config内， 例:~/WORKING_DIRECTORY/kernel/goldfish/.config文件内.

2.2 菜单链接

菜单链接的格式如下:

source "路径"  

复制代码

如:

source "drivers/pnp/Kconfig"  

复制代码

2.3 菜单属性2.3.1 类型

类型可以是:bool、tristate、string、hex和int。
bool类型的只能选中或不选中，选中为y,不选中为n.
tristate类型的菜单项为值可为三种值，多了编译成内核模块的选项。其值可为y,n,m.
string类型表示需要用户输入一串字符串。
hex类型则需要用户输入一个16进制数。
int类型表示用户输入一个整型.
总结:
菜单类型属性就好比一个控件，bool相当于单选框，trstate相当于有三种状态的复选框，string相当于供用户输入字符串的文本编辑框，hex相当于供用户输入16进制数的文本编辑框，而int就相当于供用户输入整型数的文本编辑框。
类型关键字后边可跟随提示字符，也可以不跟随,取决于情况。如：

string "path to uevent helper"  

复制代码

bool "Prevent firmware from being built"

复制代码

注:每一个菜单项必须有类型属性。

2.3.2 默认值

默认值属性default一般在类型属性后边，如:

config UEVENT_HELPER_PATH  

    string "path to uevent helper"  

    default "/sbin/hotplug"  

复制代码

表示当前菜单项若用户没有选择或输入任何值时，所取的默认值.上述所示为当前的默认值为"/sbin/totplug".

2.3.3 依赖

依赖可以是"depends on"或"requires".
语法:

depends on/requires <expr>

复制代码

<expre>为表达式，可为之前定义的菜单项名.

如:

depends on HOTPLUG  

复制代码

表示此菜单项显示与否取决于另外一个菜单项HOTPLUG ，只有当菜单项HOTPLUG这个菜单项有效显示，当前菜单项才会显示。

例如:

config MODULES    

    bool "Enable loadable module support"    

   

config MODVERSIONS    

    bool "Set version information on all module symbols"    

    depends on MODULES    

   

    comment "module support disabled"    

    depends on !MODULES   

复制代码

菜单项MODVERSIONS的显示与否取决于菜单项MODULES。这种信赖关系常用在子菜单项中。

2.3.4 选择

语法:

choice  

  

选择项  

  

..  

  

endchoice

复制代码

2.3.5 提示

语法:

comment "提示信息字符串"  

comment选项  

复制代码
comment只是用来给用户提示信息的，后跟字符串，此字符串也可以在终端中显示。
comment选项只可以是deponds on。

2.3.6 帮助

语法:

help/---help--- <字符串>  

复制代码

例如:

config EXTRA_FIRMWARE_DIR  

    string "Firmware blobs root directory"  

    depends on EXTRA_FIRMWARE != ""  

    default "firmware"  

    help  

      This option controls the directory in which the kernel build system  

      looks for the firmware files listed in the EXTRA_FIRMWARE option.  

      The default is the firmware/ directory in the kernel source tree,  

      but by changing this option you can point it elsewhere, such as  

      the /lib/firmware/ directory or another separate directory  

      containing firmware files.  

复制代码

help相当于注释一样，在给编辑Kconfig文件的人看的，这样可以保持其可读性.
3 举例

Kconfig:

# drivers/Kconfig  

  

menu "Device Drivers"  

  

source "drivers/base/Kconfig"  

  

source "drivers/connector/Kconfig"  

  

source "drivers/mtd/Kconfig"  

...  

endmenu  

复制代码

其对应的make menuconfig界面如下图所示:2.gif 

source "drivers/base/Kconfig"中的Kconfig内容如下:即对应着上图中的第一项"Generic Driver Option"的子菜单内容:
这里不再列出来！

显示效果如下图所示:
3.gif 

各个目录下的Kconfig文件经过最终配置，最终会在内核根目录下生成一个.config文件，这是个隐藏文件，这个文件记录着各个选项的配置及值。供Makefile文件使用. 使用命令：ls -al可看到！
如:
.config:

#  

# Automatically generated make config: don't edit  

# Linux kernel version: 2.6.29  

# Thu Dec 15 21:15:25 2011  

#  

CONFIG_ARM=y  

CONFIG_SYS_SUPPORTS_APM_EMULATION=y  

# CONFIG_GENERIC_GPIO is not set  

CONFIG_GENERIC_TIME=y  

CONFIG_GENERIC_CLOCKEVENTS=y  

CONFIG_MMU=y  

# CONFIG_NO_IOPORT is not set  

CONFIG_GENERIC_HARDIRQS=y  

CONFIG_STACKTRACE_SUPPORT=y  

CONFIG_HAVE_LATENCYTOP_SUPPORT=y  

CONFIG_LOCKDEP_SUPPORT=y  

CONFIG_TRACE_IRQFLAGS_SUPPORT=y  

CONFIG_HARDIRQS_SW_RESEND=y  

CONFIG_GENERIC_IRQ_PROBE=y  

CONFIG_RWSEM_GENERIC_SPINLOCK=y  

# CONFIG_ARCH_HAS_ILOG2_U32 is not set  

# CONFIG_ARCH_HAS_ILOG2_U64 is not set  

CONFIG_GENERIC_HWEIGHT=y  

CONFIG_GENERIC_CALIBRATE_DELAY=y  

CONFIG_GENERIC_HARDIRQS_NO__DO_IRQ=y  

CONFIG_VECTORS_BASE=0xffff0000  

CONFIG_DEFCONFIG_LIST="/lib/modules/$UNAME_RELEASE/.config"  

复制代码

每一个CONFIG_xxx记录着之前Kconfig文件内的菜单项的值.

wuruixn
关注
专栏目录
Kconfig文件的用途及解析
Felix
08-17 3642
Linux中Kconfig文件的用途 语法， 以及使用方式 遇到的问题： Kconfig文件中定义的宏控和config文件中定义的不一致，导致不能编译生成指定的文件，需要详细了解并总结下该文件，记录该问题
Kconfig结构
yzd
07-05 134
3.7 Kconfig和Makefile 毫不夸张地说，Kconfig和Makefile是我们浏览内核代码时最为依仗的两个文件。基本上，Linux 内核中每一个目录下边都会有一个Kconfig文件和一个Makefile文件。Kconfig和Makefile就好似一个城市的地图，地图引导我们去 认识一个城市，而Kconfig和Makefile则可以让我们了解一个内核目录下面的结构。在希望研究内核的...
Kconfig详解
卓越之路
09-02 6024
转载： https://www.cnblogs.com/Daniel-G/archive/2013/08/27/3284791.html https://blog.csdn.net/ultraman_hs/article/details/52984929 下面截取/drivers/net下的Kconfig文件中的部分内容： # Network device configuration menuc...
Linux内核配置——Kconfig文件
weixin_42031299的博客
09-12 1631
1.1、Kconfig文件内容 menuconfig NETDEVICES default y if UML depends on NET bool "Network device support" ---help--- You can say N here if you don't intend to connect your Linux box to any other computer at all. config DM9000 tristate "DM9000 support
rt-thread的Kconfig的修改.doc
01-28
此时，你需要编辑bsp根目录下的Kconfig文件，确保所有配置项的路径都与当前工程结构匹配。这可能涉及到调整CONFIG_FOO_PATH之类的选项，以反映新的文件位置。 完成Kconfig的修改后，重新运行menuconfig应该可以正常...
Kconfig简介
06-24
Kconfig文件的详细语法规则可以在内核文档`Documentation/kbuild/kconfig-language.txt`中找到。通过Kconfig，开发者可以轻松地启用或禁用内核的特定功能，根据硬件特性定制内核，甚至在不修改源码的情况下调整内核...
kconfig-language.zip_kconfig_language
09-23
Kconfig文件通常以`.conf`为扩展名，它们位于内核源代码树的不同目录下，用于定义各个模块或功能的配置选项。每个Kconfig文件由一系列配置项（config）组成，每个配置项都有一个唯一的标识符，即配置变量名。 1. ...
kconfig语法
10-23
内核移植Kconfig的语法 把那些目录 文件编入内核 哪些文件编程模块 内核的配置 等等
Kconfig语法
05-25
linux2.6.x的配置文件kconfig语法linux在2.6版本以后将配置文件由原来的config.in 改为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 +- ... 每个选项都有其自己的依赖关系。这些依赖关系决定了选项是否是可见的。父选项可见，子选项才能可见。 菜单选项 -------- 大多数的选项都定义了一个配置选项，其它选项则有助于对它们进行组织。(原文：Most entries define a config option, all other entries help to organize them.)一个配置选项定义可以是下面 的形式： 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" 为定义了一新的配置选项。下面的几行定义了该配置 选项的属性。属性可以是该配置选项的类型，输入提示(input prompt)，依赖关系，帮助信息和默认值。一 配置选项可以用相同的名字定义多次，但每个定义只能有一个输入提示并且类型还不能冲突。 菜单属性 -------- 一菜单选项可以有多个属性。并不要求这些属性可以用在任何地方(见语法)。 - 类型定义："bool"/"tristate"/"string"/"hex"/"int" 每个配置选项都必须指定类型。有两个基本类型：tristate 和 string，其他类型都是基于这两个基本 类型。类型定义可以用输入提示，所以下面的两个例子是等价的： bool "Networking support" 和 bool prompt "Networking support" - 输入提示： "prompt" ["if" ] 每个菜单选项最多只能有一个显示给用户的输入提示。可以用 "if" 来表示该提示的依赖关系，当然这是 可选的。 - 默认值："default" ["if" ] 一个配置选项可以有任意多个默认值。如果有多个默认值，那么只有第一个被定义的值是可用的。默认值并 不是只限于应用在定义他们的菜单选项。这就意味着默认值可以定义在任何地方或被更早的定义覆盖。 如果用户没有设置(通过上面的输入提示)，配置选项的值就是默认值。如果可以显示输入提示的话，就会把 默认值显示给用户，并可以让用户进行修改。 默认值的依赖关系可以用 "if" 添加。(可选项) - 依赖关系："depends on"/"requires" 为一菜单选项定义依赖关系。如果定义了多个依赖关系，它们之间用 '&&' 间隔。依赖关系也可以应用到 该菜单中所有的其它选项(同样接受一if表达式)，所以下面的两个例子是等价的： bool "foo" if BAR default y if BAR and depends on BAR bool "foo" default y - 反向依赖关系："select" ["if" ] 尽管普通的依赖关系可以降低一选项的上限，反向依赖能将这一限制降的更低。当前菜单选项的值是symbol 的最小值。如果symbol被选择了多次，上限就是其中的最大值。 反向依赖只能用在 boolean 或 tristate 选项上。 - 数据范围："range" ["if" ] 为int和hex类型的选项设置可以接受输入值范围。用户只能输入大于等于第一个symbol，小于等于第二个 symbol的值。 - 帮助信息： "help" or "---help---" 定义一帮助信息。帮助信息的结束就由缩进的水平决定的，这也就意味着信息是在第一个比帮助信息开始行 的缩进小的行结束。 "---help---" 和 "help" 在实现的作用上没有区别，"---help---" 有助于将文件中的配置逻辑与 给开发人员的提示分开。 菜单依赖关系 ------------ 依赖关系决定了菜单选项是否可见，也可以减少tristate的输入范围。tristate逻辑比boolean逻辑在表 达式中用更多的状态(state)来表示模块的状态。依赖关系表达式的语法如下： ::= (1) '=' (2) '!=' (3) '(' ')' (4) '!' (5) '&&' (6) '||' (7) 表达式是以优先级的降序列出的。 (1) 将symbol赋给表达式。boolean和tristate类型的symbol直接赋给表达式。所有其它类型的symbol 都赋 'n'。 (2) 如果两个symbol相等，返回'y'，否则为'n'。 (3) 如果两个symbol相等，返回'n'，否则为'y'。 (4) 返回表达式的值。用于改变优先级。 (5) 返回 (2-/expr/) 的结果。 (6) 返回 min(/expr/,/expr/) 的结果。 (7) 返回 max(/expr/,/expr/) 的结果。 一个表达式的值可以是'n'，'m'或'y'(或者是计算的结果 0,1,2）。当表达式的值为'm'或'y'的时候，菜 单项才是可见的。 symbol有两种类型：不可变的和可变的。不可变的symbol是最普通的，由'config'语句定义，完全由数字 、字母和下划线组成(alphanumeric characters or underscores)。 不可变的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个同样可以用在菜单选项定义的开始。 config: "config" 定义了一配置选项 并且可以接受任何前面介绍的属性。 menuconfig: "menuconfig" 此关键字和前面的关键字很相似，但它在前面的基础上要求所有的子选项作为独立的行显示。(This is similar to the simple config entry above, but it also gives a hint to front ends, that all suboptions should be displayed as a separate list of options.) choices: "choice" "endchoice" 该关键字定义了一组选择项，并且选项可以是前面描述的任何属性。尽管boolean只允许选择一个配置选项， tristate可以抒多个配置选项设为'm'，但选项只能是boolean或tristate类型。这可以在一个硬件有多 个驱动的情况下使用，最终只有一个驱动被编译进/加载到内核，，但所有的驱动都可以编译成模块。 选项可以接受的另一个选项是"optional"，这样选项就被设置为'n'，没有被选中的。 comment: "comment" 这里定义了在配置过程中显示给用户的注释，该注释还将写进输出文件中。唯一可用的可选项是依赖关系。 menu: "menu" "endmenu" 这里定义了一个菜单，详细信息请看前面的"菜单结构"。唯一可用的可选项是依赖关系。 if: "if" "endif" 这里定义了if结构。依赖关系被加到所有在if ... endif 中的菜单选项中。
Linux内核Kconfig 文件介绍
huang_1988的博客
01-24 1796
内核源码每个子目录下，都有一个Makefile文件和Kconfig文件，Kconfig文件用于配置内核。在Linux内核顶层源码目录下执行make menuconfig命令会生成内核配置界面，配置界面以树状菜单形式组织。所有的的配置工具（如make config、make xconfig等）都是通过读取 arch/$(ARCH)/Kconfig文件，生成配置界面供开发人员进行内核编译配置最终生成配置文件.config。Kconfig 包含：（1）config 条目（2）menu条目。
内核的Kconfig文件详解
Hello,World
03-28 1887
内核是个复杂庞大的系统，对它进行配置、裁剪、编译原本非常的复杂和困难，但现在我们却只需要简单的2个命令make menuconfig和make uImage就搞定了，原因是在其背后有一个设计精巧的内核构造系统帮我们精确完成了各项任务。内核构造系统最关键的组成元素就是各个目录下的Kconfig文件和Makefile文件，本文将对这2类文件进行介绍，以使大家了解内核构造系统的基本情况，从而能够修改他们...
编译内核文件 Kconfig .config 和 Makefile 之间的联系
Caso_卡索的博客
11-26 442
在内核编译时，主Makefile调用 .config文件来获取用户的选择。
鸿蒙轻内核Kconfig使用笔记
maniuT的博客
06-14 849
Kconfig语言定义了一套完整的规则来表述配置项及配置项间的关系，详细内容可以参考Linux官方文档 Kconfig Language ，此处不赘述。鸿蒙轻内核使用的是Python的开源三方库kconfiglib（menuconfig只是其提供的命令之一，相关命令还有genconfig, savedefconfig等等），官方主页为https://pypi.org/project/kconfiglib。
Kconfig 详述
最新发布
qq_61531048的博客
07-30 548
1、你可以在不同的 Kconfig 文件或同一个文件的不同位置，重复定义一个配置选项，只要它们的名称相同。2、这种重复定义通常是为了在不同的上下文中提供不同的选项描述或依赖关系。
Linux 内核目录结构，编译，及顶层Makefile，Kconfig，.config，子目录kconfig，Makefile，kbuild的关系
rjszcb的博客
11-03 871
lib是库的意思，这里面都是一些公用的有用的库函数，注意这里的库函数和C语言的库函数不一样的。选中我们需要的soc，如三星的s5pv210，hisi的soc，和其他和cpu核心代码相关的代码，这些是设计cpu的厂家，如华为，三星做的事，外部人配置是很麻烦的事，因为很多不开放，我熟悉的代码，只有他们才知道，当他们配置好后，会保存配置到.congfig文件，在内核主根目录下，ls -a命令，可以看到这个文件，这个就是soc厂家配置好的，发布内核时，给我们的，我们一般在此基础上开发我们自己需要的驱动。
Linux内核学习（六）：linux kernel的Kconfig分析
叫好与叫座虽然不是对立面，但想在同一个作品中达到双重效果很难。
07-23 1673
内核的配置界面以树状的菜单形式组织，主菜单下有若干个子菜单，子菜单下又有子菜单或配置选项。每个子菜单或选项可以有依赖关系，这些依赖关系用来确定它们是否显示。只有被依赖项的父项已经被选中，子项才会显示。Kconfig文件的语法可以参考。...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值