一、 Kbuild语法
基本构成包括五种,menu/endmenu,menuconfig,config,choice/endchoice,source。下面就对每种详细介绍:
1、menu/endmenu
menu的作用,可以理解成一个目录,menu可以把其中一部分配置项包含到一个menu中,这样有利于配置的分类显示。menu与endmenu是一组指令,必须同时出现。menu和endmenu中包含的部分就是子目录中的配置项。
比如,在init/Kconfig中24行(可能不同)显示为:
menu "General setup"
这样,就会生成一个目录,特征就是右侧会出现一个箭头,如图1中第一行。当点击确认键时,会进入这个菜单项
图1
2、menuconfig
menuconfig有点类似menu,但区别就在于menu后面多了一个config,这个menu是可以配置的,如图1中的第二行,前面比menu类型多了一个方框,通过空格可以修改这个配置项的选中状态。而且从格式上来看,也是有区别的。格式如init/Kconfig中1131行:
menuconfig MODULES
bool "Enable loadable modulesupport"config
if MODULES
xx
endif
也就是说,配置项是位于if和endif中。其中的部分就是MODULES子目录显示的内容。如果选中了MODULE,那么if和endif中的内容可以显示。如果没有定义,就只能进入一个空目录。
3、config
config是构成Kconfig的最基本单元,其中定义了配置项的详细信息。定义的格式参考arch/arm/Kconfig中的第8行。
config ARM
bool
default y
select xxxxxxxxxx
help
???????????
可知,config需要定义名称,与menuconfig相同。这个名称不但用于裁剪内核中,还用于配置项之间的相互依赖关系中。
config的类型有5种,分别是bool(y/n),tristate(y/m/n),string(字符串),hex(十六进制),integer(整数)。其中,需要特别介绍一下bool和tristate,bool只能表示选中和不选,而tristate还可以配置成模块(m),特别对于驱动程序的开发非常有用。
其他语法如下:
1) prompt:提示,显示在make menuconfig中的名称,一般省略。下面两种写法相同。
a. bool “Networking Support”
b. bool
prompt “NetworkingSupport”
2) default:默认值
一个配置项可以有多个默认值,但是只有第一个被定义的值是有效的。
3) depends on/requires:依赖关系
如果依赖的配置项没有选中,那么就当前项也无法选中。
4) select:反向依赖
如果当前项选中,那么也选中select后的选项。
5) range:范围,用于hex和integer
range A B表示当前值不小于A,不大于B
6) comment:注释
4、choice/endchoice
choice的作用,多选一,有点像MFC中的Radio控件。参考arch/arm/Kconfig第205行。
choice
prompt "ARM system type"
default ARCH_VERSATILE
???????
config ARCH_SUN7I
bool "Allwinner Ltd. AW165x family"
select ARM_AMBA
select CPU_V7
select HAVE_SMP
???????
endchoice
显示的结果如图2,进入这一项后,显示结果如图3.
图2
图3
可见,choice有点类似于menu,是在子窗口里选择,但是不同的是子窗口中只能选择一项。在prompt后会显示当前选择项的名称。
5、 source
source只是将另外一个Kconfig文件直接复制到当前位置而已。但它的作用也是明显的,可以将这个系统贯穿在一起。从开始位置arch/arm/Kconfig,来将整个系统都作为配置型。
配置分析
当我们进入了Linux源码的根目录时,输入make menuconfig。假设,此时根目录已经存在了.config,如果不存在,会自动生成。这时,在命令行显示如下:
make menuconfig
script/Kconfig/mconf arch/arm/Kconfig
显然,在执行make menuconfig时,会自动调用scripts/Kconfig/mconf arch/arm/Kconfig开始系统的配置,那么arch/arm/Kconfig就是配置的起点。这个文件会通过source指令来调用其他目录下的Kconfig文件,从而完成整体配置。这样,arch/arm/Kconfig就可以理解成main函数,而source指令就有点类似于include。可以按照上面的语法,来分析Kconfig文件。
以上参考:http://photo.blog.sina.com.cn/list/blogpic.PHP?pid=4cd5d2bbtx6C0FdmLVf99&bid=4cd5d2bb0101gx9y&uid=1289081531
以下转自:http://blog.csdn.NET/tommy_wxie/article/details/7280463
(注:本文所述内容来自kernel-2.6.30\Documentation\kbuild\makefiles.txt,适用于linux 2.6内核)
Linux 2.6 内核Makefile
1概述
Makefile由五个部分组成:
2 kbuild文件
2.1 obj-y和obj-m
最简单的kbuild Makefile可以仅包含:
obj-$(CONFIG_FOO) += foo.o |
其中$(CONFIG_FOO)可以等于y或m,它的值由.config文件给出。如果$(CONFIG_FOO)既不是y也不是m,那么该文件不会被编译和链接
当$(CONFIG_FOO)等于y时,上面语句等价于obj-y += foo.o,它告诉kbuild在当前目录下,有一个叫做foo.o的目标文件,它将从foo.c或则foo.S编译得到。
当$(CONFIG_FOO)等于m时,表示foo.o需要被编译成模块。
2.1.1 obj-y生成built-in.o
Kbuild编译所有的$(obj-y)文件,并调用”$(LD) -r”把所有这些文件合并到built-in.o文件。这个built-in.o会被上一级目录的Makefile使用,最终链接到vmlinux中。
$(obj-y)中的文件是有顺序的。联接也是有顺序的,那是因为有些函数(module_init()/__initcall)将会在启动时按照他们出现的顺序进行调用。
2.1.2目标由多个源文件编译得到
如果某个目标由多个源文件编译得到,那么可以通过$(
#drivers/isdn/i4l/Makefile obj-$(CONFIG_ISDN) += isdn.o isdn-objs := isdn_net_lib.o isdn_v110.o isdn_common.o |
Kbuild会编译所有$(isdn-objs)中的对象,并调用"$(LD) -r"把它们链接成isdn.o文件。
Kbuild能够识别用于组成目标文件的后缀-objs和后缀-y。这就让Kbuild Makefile可以通过使用 CONFIG_ 符号来判断该对象是否是用来组合对象的。
-objs后面是目标文件,而-y针对复合对象。
下面是一个使用后缀-y的例子。后缀-y的好处是,可以使用CONFIG_XXX符号来决定是否加入某些源文件(.o从对应的.c或.S编译得到):
#fs/ext2/Makefile obj-$(CONFIG_EXT2_FS) += ext2.o ext2-y := balloc.o bitmap.o ext2-$(CONFIG_EXT2_FS_XATTR) += xattr.o |
在这个例子中,如果 $(CONFIG_EXT2_FS_XATTR) 是 'y',xattr.o将是复合对象 ext2.o的一部分。
注意:当然,当你要将其编译进内核时,上面的语法同样适用。
所以,如果你的 CONFIG_EXT2_FS=y,那Kbuild会按你所期望的那样,生成 ext2.o文件,然后将其联接到 built-in.o中,最终连接进内核中。
如果CONFIG_ETX2_FS=m,由balloc.o和bitmap.o两个目标文件最终链接生成ext2.o,直至ext2.ko文件,保存在/lib/modules目录下方便加载。
obj-$(...)+=xxx.o 表示是否编译xxx.o目标文件
xxx.o目标依赖多个源文件的情况就下面两种:
xxx-y+=xxx1.o 复合对象xxx.o目标依赖哪些文件
xxx-$(...)+=xxx2.o xxx3.o 复合对象xxx.o目标依赖哪些文件
或者xxx-objs+=xxx1.o xxx2.o xxx3.o 目标文件xxx.o依赖哪些文件
2.1.3调用子目录Makefile
Makefile只负责编译当前目录中的对象。子目录中的对象,由子目录中的Makefile负责。如何让make调用子目录中的Makefile?答案是把子目录包含到obj-y或obj-m中。例如:
#fs/Makefile obj-$(CONFIG_EXT2_FS) += ext2/ |
当CONFIG_EXT2_FS为y或m时,kbuild系统会在ext2目录中调用make命令(也即调用ext2目录中的Makefile)
2.2 lib-y和lib-m
在一个目录下,obj-y所列出的文件,将被编译成built-in.o文件,而lib-y或lib-m所列出的文件,将在当前目录下生成lib.a文件。
注意:一般lib-y或lib-m只用在lib/和arch/*/lib这两个目录中。
2.3编译选项变量
2.3.1 ccflags-y、asflags-y、ldflags-y
这三个变量只在当前Makefile中有效。补充:$(KBUILD_CFLAGS)是定义在根目录Makefile中的变量,它适用于整个内核数。
2.3.2subdir-ccflags-y、subdir-asflags-y
这两个变量作用于当前Makefile及其所有子目录。
2.3.2CFLAGS_$@、AFLAGS_$@
这两个变量只在当前Makefile中有效。$@可以用来指定文件名,让不同文件可以使用不同的编译选项。例如:
# drivers/scsi/Makefile CFLAGS_aha152x.o = -DAHA152X_STAT-DAUTOCONF CFLAGS_gdth.o =# -DDEBUG_GDTH=2 -D__SERIAL__ -D__COM2__ \ -DGDTH_STATISTICS CFLAGS_seagate.o = -DARBITRATE -DPARITY-DSEAGATE_USE_ASM |
2.3.3 EXTRA_CFLAGS
有时需要连接内核源代码外部的系统头文件,但Kbuild默认的系统头文件都在内核源代码内部,如何使用外部的头文件需要借助Kbuild系统的特殊规则
EXTRA_CFLAGS+=$(ext_include_path)
另外CFLAGS、EXTRA_CFLAGS、ccflags之间的区别是
ccflags是gcc编译器选项,而CFLAGS、EXTRA_CFLAGS是makefile内部的预定义变量
2.4 $(src)、$(obj)、$(kecho)
$(src)指向当前Makefie所在目录的相对路径。$(obj)指向用来保存目标文件的相对目录。示例如下:
#drivers/scsi/Makefile $(obj)/53c8xx_d.h: $(src)/53c7,8xx.scr$(src)/script_asm.pl $(CPP) -DCHIP=810 - < $< | ...$(src)/script_asm.pl |
这里,$(src)等于drivers/scsi/,$(obj)同样也等于drivers/scsi/。
使用“make -s”命令时,只会输出警告和错误信息。$(kecho)能够将其后的内容输出到标准输出流(一般就是显示器),前提是没有使用“make -s”。示例如下:
#arch/blackfin/boot/Makefile $(obj)/vmImage: $(obj)/vmlinux.gz $(call if_changed,uimage) @$(kecho) 'Kernel: $@ is ready' |
2.5 $(CC)相关功能
2.5.1 as-option、ld-option、cc-option
当编译、链接文件时,xx-opiton可以用来检查当前使用的$(CC)是否支持给出的编译选项。如前者不支持,可使用后者。例如:
#arch/sh/Makefile cflags-y += $(call as-option,-Wa$(comma)-isa=$(isa-y),) |
如果当前的$(CC)不支持-Wa$(comma)-isa=$(isa-y),那么可以使用第二个编译选项(这里为空)。
2.5.2 cc-option-yn
cc-option-yn用来检查$(CC)是否支持给出的编译选项。如支持,返回y,否则返回n。例如:
#arch/ppc/Makefile biarch := $(call cc-option-yn, -m32) aflags-$(biarch) += -a32 cflags-$(biarch) += -m32 |
2.5.3 cc-option-align
gcc在3.0之后改变了指定函数、循环等对齐选项的类型。gcc <3.00时,cc-option-align =-malign;gcc >=3.00时,cc-option-align =-falign。使用$(cc-option-align)来选择正确的前缀。例如:
KBUILD_CFLAGS += $(cc-option-align)-functions=4 |
2.5.4 cc-version、cc-ifversion、cc-fullversion
cc-version返回$(CC)版本。如$(CC)为gcc 3.41,那么cc-version返回0341。例如:
#arch/i386/Makefile cflags-y += $(shell \ if [ $(call cc-version) -ge 0300 ] ; then \ echo "-mregparm=3"; fi ;) |
cc-ifversion在版本符合条件的前提下返回最后一个参数。示例如下:
#fs/reiserfs/Makefile ccflags-y := $(call cc-ifversion, -lt, 0402, -O1) |
如果$(CC)版本低于4.2,那么ccflags-y将等于-O1。
cc-fullversion给出更详细的版本信息,例如:
#arch/powerpc/Makefile $(Q)if test "$(call cc-fullversion)" = "040200" ; then \ echo -n '*** GCC-4.2.0 cannot compile the 64-bit powerpc ' ;\ false ; \ fi |
2.5.5 cc-cross-prefix
cc- cross-prefix用于检查是否存在给定前缀的$(CC),如存在,返回第一个匹配的前缀,否则返回空。如有多个前缀需要匹配,各前缀之间使用单个空格隔开。例如:
#arch/m68k/Makefile ifneq ($(SUBARCH),$(ARCH)) ifeq ($(CROSS_COMPILE),) CROSS_COMPILE := $(call cc-cross-prefix,m68k-linux-gnu-) endif endif |
三、模块的编译
编译模块的时候,你可以将模块放在代码树中,用Make modules的方式来编译你的模块,obj-$(CONFIG_EXT2) += ext2.o即可
你也可以将模块相关文件目录放在代码树以外的位置,用如下的命令来编译模块:
make -C
-C指定代码树的位置,M=$PWD或M='PWD'告诉kbuild回到当前目录来执行build操作