Kconfig、Kbuild Makefile

一、 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

Kconfig、Kbuild Makefile_第1张图片

图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由五个部分组成:

  • kernel Makefile,又叫top makefile,位于linux内核源代码的顶层目录,通过读取内核配置文件配置编译环境变量,并根据内核配置文件确定访问哪些子目录,用于编译Linux kernel目标文件vmlinux和模块module
  • arch/$(ARCH)/Makefile:系统对应平台的Makefile。kernel Makefile会根据此Makefile提取体系结构相关的信息
  • kbuild Makefiles每个子目录都有kbuild Makefile用来执行从其上层目录传递下来的命令,Kbuild Makefile从.config文件中提取信息,生成Kbuild编译内核需要的文件列表,它们负责生成built-in或模块化目标。注意kbuild Makefile是指使用kbuild结构的Makefile,内核中的大多数Makefile都是kbuild Makefile。)
  • Scripts/Makefile.*:所有kbuildMakefile的规则,它们包含了定义/规则等。
  • .config:内核配置文件(一般由make menuconfig生成)。

2 kbuild文件

2.1 obj-yobj-m

        最简单的kbuild Makefile可以仅包含:

obj-$(CONFIG_FOO) += foo.o

        其中$(CONFIG_FOO)可以等于ym,它的值由.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目标由多个源文件编译得到

        如果某个目标由多个源文件编译得到,那么可以通过$(<module_name>-objs)$(<module_name>-y)把这些源文件告诉kbuildKbuild能够识别后缀-objs-y,例如:

        #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-yobj-m中。例如:

        #fs/Makefile

        obj-$(CONFIG_EXT2_FS) += ext2/

        CONFIG_EXT2_FSym时,kbuild系统会在ext2目录中调用make命令(也即调用ext2目录中的Makefile

2.2 lib-ylib-m

        在一个目录下,obj-y所列出的文件,将被编译成built-in.o文件,而lib-ylib-m所列出的文件,将在当前目录下生成lib.a文件。

        注意:一般lib-ylib-m只用在lib/arch/*/lib这两个目录中。

2.3编译选项变量

2.3.1 ccflags-yasflags-yldflags-y

这三个变量只在当前Makefile中有效。补充:$(KBUILD_CFLAGS)是定义在根目录Makefile中的变量,它适用于整个内核数。

2.3.2subdir-ccflags-ysubdir-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-optionld-optioncc-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

        gcc3.0之后改变了指定函数、循环等对齐选项的类型。gcc <3.00时,cc-option-align =-maligngcc >=3.00时,cc-option-align =-falign。使用$(cc-option-align)来选择正确的前缀。例如:

        KBUILD_CFLAGS += $(cc-option-align)-functions=4

2.5.4 cc-versioncc-ifversioncc-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 <path to kernel src> M=$PWD modules

-C指定代码树的位置,M=$PWD或M='PWD'告诉kbuild回到当前目录来执行build操作




你可能感兴趣的:(Kconfig、Kbuild Makefile)