Linux内核Makefile文件.doc

Linux内核Makefile文件目录1 概述32 角色分工43 内核编译文件53.1 目标定义53.2 内嵌对象 - obj-y53.3 可加载模块 - obj-m63.4 导出符号目标73.5 库文件 - lib-y73.6 目录递归73.7 编译标记83.9 依赖关系93.10 特殊规则 $(obj)93.11 $(CC)支持功能104 辅助程序124.1 简单辅助程序124.2 组合辅助程序124.3 定义共享库124.4 C+语言使用方法134.5 辅助程序编译控制选项134.6 何时建立辅助程序144.7 使用hostprogs-$(CONFIG_FOO)155 编译清除机制166 体系Makefile文件186.1 变量设置186.2 增加预设置项206.3 目录表206.4 引导映像216.5 编译非内核目标226.6 编译引导映像命令226.7 定制编译命令246.8 预处理连接脚本247 Kbuild变量268 Makefile语言279 Credits2710 TODO271 概述Makefile包括五部分： Makefile 顶层Makefile文件 .config 内核配置文件 arch/$(ARCH)/Makefile 机器体系Makefile文件 scripts/Makefile.* 所有内核Makefiles共用规则 kbuild Makefiles 其它Makefile文件通过内核配置操作产生.config文件，顶层Makefile文件读取该文件的配置。顶层Makefile文件负责产生两个主要的程序：vmlinux (内核image)和模块。顶层Makefile文件根据内核配置，通过递归编译内核代码树子目录建立这两个文件。顶层Makefile文件文本一个名为 arch/$(ARCH)/Makefile的机器体系Makefile文件。机器体系Makefile文件为顶层Makefile文件提供与机器相关的信息。每一个子目录有一个Makefile文件，子目录Makefile文件根据上级目录Makefile文件命令启动编译。这些Makefile使用. config文件配置数据构建各种文件列表，并使用这些文件列表编译内嵌或模块目标文件。scripts/Makefile.*包含了所有的定义和规则，与Makefile文件一起编译出内核程序。2 角色分工人们与内核Makefile存在四种不同的关系：*用户* 用户使用make menuconfig或make命令编译内核。他们通常不读或编辑内核Makefile文件或其他源文件。*普通开发者* 普通开发者维护设备驱动程序、文件系统和网络协议代码，他们维护相关子系统的Makefile文件，因此他们需要内核Makefile文件整体性的一般知识和关于kbuild公共接口的详细知识。*体系开发者* 体系开发者关注一个整体的体系架构，比如sparc或者ia64。体系开发者既需要掌握关于体系的Makefile文件，也要熟悉内核Makefile文件。*内核开发者* 内核开发者关注内核编译系统本身。他们需要清楚内核Makefile文件的所有方面。本文档的读者对象是普通开发者和系统开发者。3 内核编译文件内核中大多数Makefile文件是使用kbuild基础架构的Makefile文件。本章介绍kbuild的Makefile中的语法。3.1节“目标定义”是一个快速导引，后面各章有详细介绍和实例。3.1 目标定义 目标定义是Makefile文件的主要部分（核心）。这些目标定义行定义了如何编译文件，特殊的兼容选项和递归子目录。 最简单的Makefile文件只包含一行： Example: obj-y += foo.o 这行告诉kbuild在该目录下名为foo.o的目标文件（object），foo.o通过编译foo.c或者foo.S而得到。 如果foo.o编译成一个模块，则使用obj-m变量，因此常见写法如下： Example: obj-$(CONFIG_FOO) += foo.o $(CONFIG_FOO)可以代表y(built-in对象)或m(module对象)。如果CONFIG_FOO不是y或m，那么这个文件不会被编译和链接。3.2 内嵌对象 - obj-y Makefile文件将为编译vmlinux的目标文件放在$(obj-y)列表中，这些列表依赖于内核配置。 Kbuild编译所有的$(obj-y)文件，然后调用$(LD) -r合并这些文件到一个built-in.o文件中。built-in.o经过父Makefile文件链接到vmlinux。$(obj-y)中的文件 顺序很重要。列表中文件允许重复，文件第一次出现将被链接到built-in.o，后续出现该文件将被忽略。 链接顺序之所以重要是因为一些函数在内核引导时将按照他们出现的顺序被调用，如函数(module_init() / _initcall)。所以要牢记改变链接顺序意味着也要改变SCSI控制器的检测顺序和重数磁盘。 Example: #drivers/isdn/i4l/Makefile # 内核ISDN子系统和设备驱动程序Makefile # 每个配置项是一个文件列表 obj-$(CONFIG_ISDN) += isdn.o obj-$(CONFIG_ISDN_PPP_BSDCOMP) += isdn_bsdcomp.o3.3 可加载模块 - obj-m $(obj-m)表示对象文件（object files）编译成可加载的内核模块。 一个模块可以通过一个源文件或几个源文件编译而成。Makefile只需简单地它们加到$(obj-m)。 Example: #drivers/isdn/i4l/Makefile obj-$(CONFIG_ISDN_PPP_BSDCOMP) += isdn_bsdcomp.o 注意：在这个例子中$(CONFIG_ISDN_PPP_BSDCOMP)含义是m。 如果内核模块通过几个源文件编译而成，使用以上同样的方法。 Kbuild需要知道通过哪些文件编译模块，因此需要设置一个$(-objs)变量。 Example: #drivers/isdn/i4l/Makefile obj-$(CONFIG_ISDN) += isdn.o isdn-objs := isdn_net_lib.o isdn_v110.o isdn_common.o 在这个例子中，模块名isdn.o. Kbuild首先编译$(isdn-objs)中的object文件，然后运行$(LD) -r将列表中文件生成isdn.o. Kbuild使用后缀-objs、-y识别对象文件。这种方法允许Makefile使用CONFIG_符号值确定一个object文件是否是另外一个object的组成部分。 Example: #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，则ext2.o只有xattr.o组成部分。 注意： 当然，当你将对象文件编译到内核时，以上语法同样有效。因此，如果CONFIG_EXT2_FS=y，Kbuild将先编译ext2.o文件，然后链接到built-in.o。3.4 导出符号目标 在Makefile文件中没有特别导出符号的标记。3.5 库文件 - lib-y obj-*中的object文件用于模块或built-in.o编译。object文件也可能编译到库文件中-lib.a。所有罗列在lib-y中的object文件都将编译到该目录下的一个单一的库文件中。包含在0bj-y中的object文件如果也列举在lib-y中将不会包含到库文件中，因为他们不能被访问。但lib-m中的object文件将被编译进lib.a库文件。 注意在相同的Makefile中可以列举文件到buit-in内核中也可以作为库文件的一个组成部分。因此在同一个目录下既可以有built-in.o也可以有lib.a文件。 Example: #arch/i386/lib/Makefile lib-y := checksum.o delay.o 这样将基于checksum.o、delay.o创建一个lib.a文件。对于内核编译来说，lib.a文件被包含在libs-y中。将“6.3 目录表”。 lib-y通常被限制使用在lib/和arch/*/lib目录中。3.6 目录递归 Makefile文件负责编译当前目录下的目标文件，子目录中的文件由子目录中的Makefile文件负责编译。编译系统将使用obj-y和obj-m自动递归编译各个子目录中文件。 如果ext2是一个子目录，fs目录下的Makefile将使用以下赋值语句是编译系统编译ext2子目录。 Example: #fs/Makefile obj-$(CONFIG_EXT2_FS) += ext2/ 如果CONFIG_EXT2_FS设置成y(built-in)或m(modular)，则对应的obj-变量也要设置，内核编译系统将进入ext2目录编译文件。内核编译系统只使用这些信息来决定是否需要编译这个目录，子目录中Makefile文件规定那些文件编译为模块那些是内核内嵌对象。 当指定目录名时使用CONFIG_变量是一种良好的做法。如果CONFIG_选项不为y或m，内核编译系统就会跳过这个目录。3.7 编译标记EXTRA_CFLAGS, EXTRA_AFLAGS, EXTRA_LDFLAGS, EXTRA_ARFLAGS 所有的EXTRA_变量只能使用在定义该变量后的Makefile文件中。EXTRA_变量被Makefile文件所有的执行命令语句所使用。 $(EXTRA_CFLAGS)是使用$(CC)编译C文件的选项。 Example: # drivers/sound/emu10k1/Makefile EXTRA_CFLAGS += -I$(obj) ifdef DEBUG EXTRA_CFLAGS += -DEMU10K1_DEBUG endif 定义这个变量是必须的，因为顶层Makefile定义了$(CFLAGS)变量并使用该变量编译整个代码树。 $(EXTRA_AFLAGS)是每个目录编译汇编语言源文件的选项。 Example: #arch/x86_64/kernel/Makefile EXTRA_AFLAGS := -traditional $(EXTRA_LDFLAGS)和$(EXTRA_ARFLAGS)用于每个目录的$(LD)和$(AR)选项。 Example: #arch/m68k/fpsp040/Makefile EXTRA_LDFLAGS := -xCFLAGS_$, AFLAGS_$ CFLAGS_$和AFLAGS_$只使用到当前Makefile文件的命令中。 $(CFLAGS_$)定义了使用$(CC)的每个文件的选项。$部分代表该文件。Example:# drivers/scsi/MakefileCFLAGS_aha152x.o = -DAHA152X_STAT -DAUTOCONFCFLAGS_gdth.o = # -DDEBUG_GDTH=2 -D_SERIAL_ -D_COM2_ -DGDTH_STATISTICSCFLAGS_seagate.o = -DARBITRATE -DPARITY -DSEAGATE_USE_ASM 这三行定义了aha152x.o、gdth.o和seagate.o文件的编译选项。 $(AFLAGS_$)使用在汇编语言代码文件中，具有同上相同的含义。 Example: # arch/arm/kernel/Makefile AFLAGS_head-armv.o := -DTEXTADDR=$(TEXTADDR) -traditional AFLAGS_head-armo.o := -DTEXTADDR=$(TEXTADDR) -traditional3.9 依赖关系 内核编译记录如下依赖关系： 1) 所有的前提文件(both *.c and *.h) 2) CONFIG_ 选项影响到的所有文件 3) 编译目标文件使用的命令行 因此，假如改变$(CC)的一个选项，所有相关的文件都要重新编译。3.10 特殊规则 $(obj) 特殊规则使用在内核编译需要规则定义而没有相应定义的时候。典型的例子如编译时头文件的产生规则。其他例子有体系Makefile编译引导映像的特殊规则。 特殊规则写法同普通的Make规则。Kbuild(应该是编译程序)在Makefile所在的目录不能被执行，因此所有的特殊规则需要提供前提文件和目标文件的相对路径。 定义特殊规则时将使用到两个变量：$(src)： $(src)是对于Makefile文件目录的相对路径，当使用代码树中的文件时使用该变量$(src)。$(obj)： $(obj)是目标文件目录的相对路径。生成文件使用$(obj)变量。 Example: #drivers/scsi/Makefile $(obj)/53c8xx_d.h: $(src)/53c7,8xx.scr $(src)/script_asm.pl $(CPP) -DCHIP=810 - $= 3.0用于定义functions、loops等边界对齐选项。 gcc = 3.00 cc-option-align = -falign Example: CFLAGS += $(cc-option-align)-functions=4 在上面例子中对于gcc = 3.00来说-falign-functions=4，gcc 3.00版本使用-malign-functions=4。cc-version cc-version返回$(CC)编译器数字版本号。 版本格式是，均为两位数字。例如gcc 3.41将返回0341。当一个特定$(CC)版本在某个方面有缺陷时cc-version是很有用的。例如-mregparm=3在一些gcc版本会失败尽管gcc接受这个选项。 Example: #arch/i386/Makefile GCC_VERSION := $(call cc-version) cflags-y += $(shell if $(GCC_VERSION) -ge 0300 ; then echo -mregparm=3; fi ;) 在上面例子中-mregparm=3表示只使用在版本大于等于3.0的gcc中。4 辅助程序 内核编译系统支持在编译（compliation）阶段编译主机可执行程序。为了使用主机程序需要两个步骤：第一个步骤使用hostprogs-y变量告 诉内核编译系统有主机程序可用。第二步给主机程序添加潜在的依赖关系。有两种方法，在规则中增加依赖关系或使用$(always)变量。具体描述如下。4.1 简单辅助程序 在一些情况下需要在主机上编译和运行主机程序。下面这行告诉kbuild在主机上建立bin2hex程序。 Example: hostprogs-y := bin2hex Kbuild假定使用Makefile相同目录下的单一C代码文件bin2hex.c编译bin2hex。4.2 组合辅助程序 主机程序也可以由多个object文件组成。定义组合辅助程序的语法同内核对象的定义方法。$(-objs)包含了所有的用于链接最终可执行程序的对象。 Example: #scripts/lxdialog/Makefile hostprogs-y := lxdialog lxdialog-objs := checklist.o lxdialog.o 扩展名.o文件都编译自对应的.c文件。在上面的例子中checklist.c编译成checklist.o，lxdialog.c编译为lxdialog.o。最后两个.o文件链接成可执行文件lxdialog。 注意：语法-y不能用于定义主机程序。4.3 定义共享库 扩展名为.so的对象是共享库文件，并且是位置无关的object文件。内核编译系统提供共享库使用支持，但使用方法有限制。在下面例子中libkconfig.so库文件被链接到可执行文件conf中。 Example: #scripts/kconfig/Makefile hostprogs-y := conf conf-objs := conf.o libkconfig.so libkconfig-objs := expr.o type.o 共享库文件需要对应的-objs定义, 在上面例子中库libkconfig由两个对象组成：expr.o和type.o。expr.o和type.o将被编译为位置无关代码并被链接如libkconfig.so。共享库不支持C+语言。4.4 C+语言使用方法 内核编译系统提供了对C+主机程序的支持以用于内核配置，但不主张其它方面使用这种方法。 Example: #scripts/kconfig/Makefile hostprogs-y := qconf qconf-cxxobjs := qconf.o 在上面例子中可执行文件由C+文件qconf.cc组成 - 通过$(qconf-cxxobjs)标识。 如果qconf由.c和.cc文件混合组成，附加行表示这种情况。 Example: #scripts/kconfig/Makefile hostprogs-y := qconf qconf-cxxobjs := qconf.o qconf-objs := check.o4.5 辅助程序编译控制选项 当编译主机程序时仍然可以使用$(HOSTCFLAGS)设置编译选项传递给$(HOSTCC)。这些选项将影响所有使用变量HOST_EXTRACFLAG的Makefile创建的主机程序。 Example: #scripts/lxdialog/Makefile HOST_EXTRACFLAGS += -I/usr/include/ncurses 为单个文件设置选项使用下面方式： Example: #arch/ppc64/boot/Makefile HOSTCFLAGS_piggyback.o := -DKERNELBASE=$(KERNELBASE) 也可以使用附加链接选项： Example: #scripts/kconfig/Makefile HOSTLOADLIBES_qconf := -L$(QTDIR)/lib 当链接qconf时将使用外部选项-L$(QTDIR)/lib。4.6 何时建立辅助程序 只有当需要时内核编译系统才会编译主机程序。有两种方式： (1) 在特殊规则中作为隐式的前提需求 Example: #drivers/pci/Makefile hostprogs-y := gen-devlist $(obj)/devlist.h: $(src)/pci.ids $(obj)/gen-devlist ( cd $(obj); ./gen-devlist ) $ 产生 .config文件 2) 保存内核版本到include/linux/version.h文件中 3) 符号链接include/asm to include/asm-$(ARCH) 4) 更新所有目标对象的其它前提文件- 附加前提文件定义在arch/$(ARCH)/Makefile文件中 5) 递归进入init-* core* drivers-* net-* libs-*中的所有子目录和编译所有的目标对象- 上面变量值都引用到arch/$(ARCH)/Makefile文件。 6) 链接所有的object文件生成vmlinux文件，vmlinux文件放在代码树根目录下。最开始链接的几个object文件列举在arch/$(ARCH)/Makefile文件的head-y变量中。7) 最后体系Makefile文件定义编译后期处理规则和建立最终的引导映像bootimage。- 包括创建引导记录- 准备initrd映像和相关处理6.1 变量设置LDFLAGS $(LD)一般选项 选项使用于链接器的所有调用中。通常定义emulation就可以了。 Example: #arch/s390/Makefile LDFLAGS := -m elf_s390 注意: EXTRA_LDFLAGS和LDFLAGS_$可以进一步订制使用选项，请参考第7章。LDFLAGS_MODULE $(LD)链接模块的选项 LDFLAGS_MODULE通常设置$(LD)链接模块的.ko选项。默认为-r即可重定位输出文件。LDFLAGS_vmlinux $(LD)链接vmlinux选项 LDFLAGS_vmlinux是定义链接最终vmlinux时链接器的选项。LDFLAGS_vmlinux支持使用LDFLAGS_$。 Example: #arch/i386/Makefile LDFLAGS_vmlinux := -e stextOBJCOPYFLAGS objcopy选项 当使用$(call if_changed,objcopy)转化a .o文件时，OBJCOPYFLAGS中的选项将被使用。$(call if_changed,objcopy)经常被用作为vmlinux产生原始的二进制文件。 Example: #arch/s390/Makefile OBJCOPYFLAGS := -O binary #arch/s390/boot/Makefile $(obj)/image: vmlinux FORCE $(call if_changed,objcopy) 在上面例子中$(obj)/image是vmlinux的二进制版本文件。$(call if_changed,xxx)的使用方法见后。AFLAGS $(AS)汇编选项 默认值见顶层Makefile文件。针对每个体系需要另外添加和修改它。 Example: #arch/sparc64/Makefile AFLAGS += -m64 -mcpu=ultrasparcCFLAGS $(CC)编译器选项 默认值见顶层Makefile文件。针对每个体系需要另外添加和修改它。 通常CFLAGS变量值取决于内核配置。 Example: #arch/i386/Makefile cflags-$(CONFIG_M386) += -march=i386 CFLAGS += $(cflags-y) 许多体系Makefiles文件动态启动市场