1 概述
Makefile由五個部分組成:
- Makefile:根目錄Makefile,它讀取.config檔案,并負責建立vmlinux(核心鏡像)和modules(子產品檔案)。
- .config:核心配置檔案(一般由make menuconfig生成)。
- arch/$(ARCH)/Makefile:目标處理器的Makefile。
- scripts/Makefile.*:所有kbuild Makefile的規則,它們包含了定義/規則等。
- kbuild Makefiles:每個子目錄都有kbuild Makefile,它們負責生成built-in或子產品化目标。(注意:kbuild Makefile是指使用kbuild結構的Makefile,核心中的大多數Makefile都是kbuild 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中。
2.1.2 目标由多個源檔案編譯得到
如果某個目标由多個源檔案編譯得到,那麼可以通過$(<module_name>-objs)或$(<module_name>-y)把這些源檔案告訴kbuild。Kbuild能夠識别字尾-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檔案。
下面是一個使用字尾-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 |
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.2 subdir-ccflags-y、subdir-asflags-y
這兩個變量作用于目前Makefile及其所有子目錄。
2.3.2 CFLAGS_$@、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.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 |
(注:本文所述内容來自kernel-2.6.30/Documentation/kbuild/makefiles.txt,适用于Linux 2.6核心)
##Kbuild Makefile
作者:柒月