Kconfig和Makefile

内核的源码树目录下一般都会有两个文件：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 加入到内核中。即可达到您的目的。
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 加入到内核中。即可达到您的目的。






例子：
假设我们要在内核源代码 drivers 目录下如下用于 test driver 的树型目录:
|----test
      |---- cpu
      |---- cpu.c
      |---- test.c
      |---- test_client.c
      |---- test_ioctl.c
      |---- test_proc.c
      |---- test_queue.c
在内核中增加目录和子目录,我们需为相应的新增目录创建 Kconfig 和 Makefile 文件,而新增目录的父目录中的 Kconfig 和 Makefile 文件也需要修改,以便新增的 Kconfig 和 Makefile 文件能被引用. 在新增的 test 目录下,应包含如下 Kconfig 文件:
# # TEST driver configuration #
menu "Test Driver " #comment "Test Driver"
config EST
bool "TEST suport"
 
config TEST_USER tristate "TEST user-space interface"
depends on CONFIG_TEST
endmenu
由于 TEST Driver 对于内核来说是新的功能,所以首先需要创建一个菜单 TEST Driver ;然后显示 "TEST support " ,等待用户选择;接下来判断用户是否选择了 TEST Driver ,如果是 (CONFIG_TEST=y),则进一步显示子功能:用户接口与CPU功能支持;由于用户接口功能可以被编译成内核模块,所以这里的询问语句使用了 tristate. 为了使这个 Kconfig 文件能起作用,需要修改 drivers/Kconfig 文件,增加以下内容: source "drivers/test/Kconfig"
脚本中的 source 意味着引用新的 Kconfig 文件.在新增的 test 目录下,应该包含如下 Makefile 文件: #drivers/test/Makefile #
#Makefile for the TEST #
obj-$(CONFIG_TEST) += test.o test_queue.o test_client.o
obj-$(CONFIG_TEST_USER) += test_ioctl.o
obj-$(CONFIG_PROC_FS) += test_proc.o
obj-$(CONFIG_TEST_CPU) += cpu/
该脚本根据配置变量的取值构建 obj-* 列表.由于 test 目录中包含一个子目录 cpu ,当CONFIG_TEST_CPU=y 时,需要将 cpu 目录加入列表. test 目录中的 cpu 目录也需包含如下的 Makefile 文件:
# drivers/test/cpu/Makefile #
# Makefile for the TEST cpu #
obj-$(CONFIG_TEST_CPU) += cpu.o
为了使得整个 test 目录能够被编译命令作用到, test 目录父目录中的 Makefile 文件也需新增如下脚本: obj-$(CONFIG_TEST) += test/
增加了 Kconfig 和 Makefile 文件之后的新的 test 树型目录如下所示: 
|----test
       |---- cpu
       |---- cpu.c
       |---- Makefile
       |---- test.c
       |---- test_client.c
       |---- test_ioctl.c
       |---- test_proc.c
       |---- test_queue.c
       |---- Makefile
       |---- Kconfig