linux内核中Kconfig文档的作用
2.6内核的源码树目录下一般都会有两个文文:Kconfig和Makefile。分布在各目录下的Kconfig构成了一个分布式的内核配置数据库,每个Kconfig分别描述了所属目录源文件相关的内核配置菜单。在内核配置make menuconfig(或xconfig等)时,从Kconfig中读出配置菜单,用户配置完后保存到.config(在顶层目录下生成)中。在内核编译时,主Makefile调用这个.config,就知道了用户对内核的配置情况。
上面的内容说明:Kconfig就是对应着内核的配置菜单。假如要想添加新的驱动到内核的源码中,可以通过修改Kconfig来增加对我们驱动的配置菜单,这样就有途径选择我们的驱动,假如想使这个驱动被编译,还要修改该驱动所在目录下的Makefile。
因此,一般添加新的驱动时需要修改的文件有两种(注意不只是两个)
*Kconfig
*Makefile
要想知道怎么修改这两种文件,就要知道两种文档的语法结构。
First: Kconfig
每个菜单项都有一个关键字标识,最常见的就是config。
语法:
config symbol
options
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
symbol就是新的菜单项,options是在这个新的菜单项下的属性和选项
其中options部分有:
1、类型定义:
每个config菜单项都要有类型定义,bool:布尔类型, tristate三态:内建、模块、移除, string:字符串, hex:十六进制, integer:整型
例如config HELLO_MODULE
bool "hello test module"
bool类型的只能选中或不选中,tristate类型的菜单项多了编译成内核模块的选项,假如选择编译成内核模块,则会在.config中生成一个CONFIG_HELLO_MODULE=m的配置,假如选择内建,就是直接编译成内核影响,就会在.config中生成一个CONFIG_HELLO_MODULE=y的配置.
2、依赖型定义depends on或requires
指此菜单的出现是否依赖于另一个定义
config HELLO_MODULE
bool "hello test module"
depends on ARCH_PXA
这个例子表明HELLO_MODULE这个菜单项只对XScale处理器有效,即只有在选择了ARCH_PXA, 该菜单才可见(可配置)。
3、帮助性定义
只是增加帮助用关键字help或---help---
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
更多详细的Kconfigconfig语法可参考:
Second: 内核的Makefile
内核的Makefile分为5个组成部分:
Makefile 最顶层的Makefile
.config 内核的当前配置文档,编译时成为顶层Makefile的一部分
arch/$(ARCH)/Makefile 和体系结构相关的Makefile
s/ Makefile.* 一些Makefile的通用规则
kbuild Makefile 各级目录下的大概约500个文档,编译时根据上层Makefile传下来的宏定义和其他编译规则,将源代码编译成模块或编入内核。
顶层的Makefile文档读取 .config文档的内容,并总体上负责build内核和模块。Arch Makefile则提供补充体系结构相关的信息。 s目录下的Makefile文档包含了任何用来根据kbuild Makefile 构建内核所需的定义和规则。
(其中.config的内容是在make menuconfig的时候,通过Kconfig文档配置的结果)
在linux2.6.x/Documentation/kbuild目录下有详细的介绍有关kernel makefile的知识。
最后举个例子:
假设想把自己写的一个flash的驱动程式加载到工程中,而且能够通过menuconfig配置内核时选择该驱动该怎么办呢?能够分三步:
第一:将您写的flashtest.c 文档添加到/driver/mtd/maps/ 目录下。
第二:修改/driver/mtd/maps目录下的kconfig文档:
config MTD_flashtest
tristate “ap71 flash"
这样当make menuconfig时 ,将会出现 ap71 flash选项。
第三:修改该目录下makefile文档。
添加如下内容:obj-$(CONFIG_MTD_flashtest) += flashtest.o
这样,当您运行make menucofnig时,您将发现ap71 flash选项,假如您选择了此项。该选择就会保存在.config文档中。当您编译内核时,将会读取.config文档,当发现ap71 flash 选项为yes 时,系统在调用/driver/mtd/maps/下的makefile 时,将会把 flashtest.o 加入到内核中。即可达到您的目的。
我们都知道驱动可以编译成module和直接编译进内核,那么这两者到底有什么区别?
从驱动的入口函数来看,两者都是一样的,都是module_init();
在linux/init.h中可以看到,以下代码:
1. #ifndef MODULE
2.
3. #ifndef __ASSEMBLY__
4.
5. /* initcalls are now grouped by functionality into separate
6. * subsections. Ordering inside the subsections is determined
7. * by link order.
8. * For backwards compatibility, initcall() puts the call in
9. * the device init subsection.
10. *
11. * The `id' arg to __define_initcall() is needed so that multiple initcalls
12. * can point at the same handler without causing duplicate-symbol build errors.
13. */
14.
15. #define __define_initcall(level,fn,id) /
16. static
17. ".initcall" level ".init"))) = fn
18. ....................
19. ....................
20. #define __initcall(fn) device_initcall(fn)
21.
22. #define __exitcall(fn) /
23. static
24. .....................
25. #else /* MODULE */
26. /* Each module must use one module_init(), or one no_module_init */
27. #define module_init(initfn) /
28. static inline initcall_t __inittest(void) /
29. return
30. int init_module(void) __attribute__((alias(#initfn)));
31.
32. /* This is only required if you want to be unloadable. */
33. #define module_exit(exitfn) /
34. static inline exitcall_t __exittest(void) /
35. return
36. void cleanup_module(void) __attribute__((alias(#exitfn)));
如果没有定义MODULE宏,那么驱动初始化函数就会带有.initcall6.init属性,那么在其编译时将会被安排到__initcall_start和__initcall_end范围之间(可以参考内核源码目录下的内核链接脚本arch/cpu-type/kernel/vmlinux.lds.S,其中cpu-type可以是mips、arm、i386等),
__initcall_start = .;
1. .initcall.init : {
2. INITCALLS
3. }
4. __initcall_end = .;
5.
6. 而INITCALLS宏定义在include/asm-generic/Vmlinux.lds.h中:
7. #define INITCALLS /
8. *(.initcall0.init) /
9. *(.initcall0s.init) /
10. *(.initcall1.init) /
11. *(.initcall1s.init) /
12. *(.initcall2.init) /
13. *(.initcall2s.init) /
14. *(.initcall3.init) /
15. *(.initcall3s.init) /
16. *(.initcall4.init) /
17. *(.initcall4s.init) /
18. *(.initcall5.init) /
19. *(.initcall5s.init) /
20. *(.initcallrootfs.init) /
21. *(.initcall6.init) /
22. *(.initcall6s.init) /
23. *(.initcall7.init) /
24. *(.initcall7s.init)
在kernel启动时,会执行如下函数:
init->do_basic_setup->do_initcalls
do_initcalls中会把.initcall.init中的函数依次执行一遍
for (call = __initcall_start; call < __initcall_end; call++) {
...
(*call)();
...
}
于是在内核启动过程中执行了module_init(fn)函数,也就实现了自动加载模块的目的;
这类似于pmon中带有constructor属性的函数,都是在编译时统一将其安排到某一连续的地址范围内,然后再启动时,遍历执行这些函数。
***编译成模块时,模块也有版本号!在模块的Makefile中有编译该模块使用的内核版本号。或者在当前编译这个模块的内核源代码中也可以看到内核版本号。这个版本号即为所编译的模块的版本号!
当用insmod将模块加载进某个内核时,模块版本号必须要与该内核版本号一致,当然也可以用modprobe命令来强行插入。
注意前后两个内核版本号是针对不同的内核的,前者是针对编译模块时用的内核,后者是模块加载进内核时的内核(即利用该模块的某个内核)。
***字符设备和块设备跟文件系统打交道,他们服务于 文件系统,所以只需要关心文件系统。
***网络设备和协议栈打交道,他们服务于协议栈,所 以只需要关心协议栈。
linux内核中Kconfig文档的作用
2.6内核的源码树目录下一般都会有两个文文:Kconfig和Makefile。分布在各目录下的Kconfig构成了一个分布式的内核配置数据库,每个Kconfig分别描述了所属目录源文件相关的内核配置菜单。在内核配置make menuconfig(或xconfig等)时,从Kconfig中读出配置菜单,用户配置完后保存到.config(在顶层目录下生成)中。在内核编译时,主Makefile调用这个.config,就知道了用户对内核的配置情况。
上面的内容说明:Kconfig就是对应着内核的配置菜单。假如要想添加新的驱动到内核的源码中,可以通过修改Kconfig来增加对我们驱动的配置菜单,这样就有途径选择我们的驱动,假如想使这个驱动被编译,还要修改该驱动所在目录下的Makefile。
因此,一般添加新的驱动时需要修改的文件有两种(注意不只是两个)
*Kconfig
*Makefile
要想知道怎么修改这两种文件,就要知道两种文档的语法结构。
First: Kconfig
每个菜单项都有一个关键字标识,最常见的就是config。
语法:
config symbol
options
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
symbol就是新的菜单项,options是在这个新的菜单项下的属性和选项
其中options部分有:
1、类型定义:
每个config菜单项都要有类型定义,bool:布尔类型, tristate三态:内建、模块、移除, string:字符串, hex:十六进制, integer:整型
例如config HELLO_MODULE
bool "hello test module"
bool类型的只能选中或不选中,tristate类型的菜单项多了编译成内核模块的选项,假如选择编译成内核模块,则会在.config中生成一个CONFIG_HELLO_MODULE=m的配置,假如选择内建,就是直接编译成内核影响,就会在.config中生成一个CONFIG_HELLO_MODULE=y的配置.
2、依赖型定义depends on或requires
指此菜单的出现是否依赖于另一个定义
config HELLO_MODULE
bool "hello test module"
depends on ARCH_PXA
这个例子表明HELLO_MODULE这个菜单项只对XScale处理器有效,即只有在选择了ARCH_PXA, 该菜单才可见(可配置)。
3、帮助性定义
只是增加帮助用关键字help或---help---
<!--[if !supportLineBreakNewLine]-->
<!--[endif]-->
更多详细的Kconfigconfig语法可参考:
Second: 内核的Makefile
内核的Makefile分为5个组成部分:
Makefile 最顶层的Makefile
.config 内核的当前配置文档,编译时成为顶层Makefile的一部分
arch/$(ARCH)/Makefile 和体系结构相关的Makefile
s/ Makefile.* 一些Makefile的通用规则
kbuild Makefile 各级目录下的大概约500个文档,编译时根据上层Makefile传下来的宏定义和其他编译规则,将源代码编译成模块或编入内核。
顶层的Makefile文档读取 .config文档的内容,并总体上负责build内核和模块。Arch Makefile则提供补充体系结构相关的信息。 s目录下的Makefile文档包含了任何用来根据kbuild Makefile 构建内核所需的定义和规则。
(其中.config的内容是在make menuconfig的时候,通过Kconfig文档配置的结果)
在linux2.6.x/Documentation/kbuild目录下有详细的介绍有关kernel makefile的知识。
最后举个例子:
假设想把自己写的一个flash的驱动程式加载到工程中,而且能够通过menuconfig配置内核时选择该驱动该怎么办呢?能够分三步:
第一:将您写的flashtest.c 文档添加到/driver/mtd/maps/ 目录下。
第二:修改/driver/mtd/maps目录下的kconfig文档:
config MTD_flashtest
tristate “ap71 flash"
这样当make menuconfig时 ,将会出现 ap71 flash选项。
第三:修改该目录下makefile文档。
添加如下内容:obj-$(CONFIG_MTD_flashtest) += flashtest.o
这样,当您运行make menucofnig时,您将发现ap71 flash选项,假如您选择了此项。该选择就会保存在.config文档中。当您编译内核时,将会读取.config文档,当发现ap71 flash 选项为yes 时,系统在调用/driver/mtd/maps/下的makefile 时,将会把 flashtest.o 加入到内核中。即可达到您的目的。