u-boot的Makefile分析

U－BOOT是一个LINUX下的工程，在编译之前必须已经安装对应体系结构的交叉编译环境，这里只针对ARM，编译器系列软件为 ppc_6xx-。U－BOOT的下载地址：http://sourceforge.net/projects/u-boot

我下载的是1.1.5版本
要了解一个LINUX工程的结构必须看懂Makefile，尤其是顶层的，没办法，UNIX世界就是这么无奈，什么东西都用文档去管理、配置。首先在这方面我是个新手，时间所限只粗浅地看了一些Makefile规则,请各位多多指教。以cpci5200为例:
几个重要的文件分析：
u-boot-1.1.5/Makefile
u-boot-1.1.5/mkconfig
u-boot-1.1.5/config.mk
u-boot根目录下的Makefile文件（u-boot-1.1.5/Makefile）它负责配置u-boot的编译方式，具体说来包括：使用何种指令集，需包含哪些接口驱动、库等。Makefile的内容从上到下分别是：分定义编译环境：使用何种编译器、编译方式、目标文件的生成及它们最终镜像中的链接次序等。Mkconfig和config.mk在接下来的分析中会涉及到。
在编译U－BOOT之前，先要执行
# make cpci5200_config
cpci5200_config是Makefile的一个目标,定义如下：
cpci5200_config: unconfig
@$(MKCONFIG) -a cpci5200 ppc mpc5xxx cpci5200 esd
其中，unconfig定义如下：
unconfig:
@rm -f $(obj)include/config.h $(obj)include/config.mk /
$(obj)board/*/config.tmp $(obj)board/*/*/config.tmp
显然，执行# make cpci5200_config时，先执行unconfig目标，注意不指定输出目标时，obj，src变量均为空，unconfig下面的命令清理上一 次执行make *_config时生成的头文件和makefile的包含文件。主要是include/config.h 和include/config.mk文件。
然后才执行命令
@$(MKCONFIG) -a cpci5200 ppc mpc5xxx cpci5200 esd
$(MKCONFIG)就会被替换成$(SRCTREE)/mkconfig文件路径， MKCONFIG 是顶层目录下的mkcofig脚本文件（u-boot-1.1.5/mkconfig），后面五个是传入的参数。Mkconfig文件的详细分析见文档末尾。
注意一下u-boot对板卡的分类方法：

Target：宿主机平台

Architecture：定义芯片架构（如MIPS、POWERPC、ARM等）

CPU：定义芯片指令集版本（如ARM7、ARM9、ARM11等）

Board：芯片厂商，它细分为两类

[VENDOR]：按厂商划分（如AT9200、S3C44B0等）

[SOC]：按SOC类型（如S3C2440、S3C2410等）
1)对于cpci5200_config而言，mkconfig主要做三件事：
在include文件夹下建立相应的文件（夹）软(符号)连接，
#如果是PPC体系将执行以下操作：

#ln -s asm-ppc asm
#ln -s arch-mpc5xxx asm-ppc/arch

#ln -s proc-armv asm-ppc/proc
生成Makefile包含文件include/config.mk，内容很简单，定义了四个变量：
ARCH = ppc

CPU = mpc5xxx

BOARD = cpci5200

VENDOR = esd
这些变量可以供其它的makefile使用，作为一个基本配置.
生成include/config.h头文件，只有一行：
echo“/* Automatically generated - do not edit */”>>config.h

echo“＃include <config/$1.h>”>>config.h
这两行代码生成一个include/config.h文件，这个文件很简单，只有一句话：

#include <$1.h> 当然这里的$1时要被替换成不同的board名字的.这个取决于我们在主Makefile中xxxx_config目标中的xxxx是什么.
mkconfig脚本文件的执行至此结束
2)分析config.mk的内容：
u-boot根目录下自带一个config.mk文件（u-boot-1.1.5/config.mk），应 该说这才是真正的Makefile，以上介绍的两个脚本Makefile和mkconfig完成了环境配置之后，在该文件中才定义具体的编译规则，所以你会发现在各个子模块（board、 cpu、lib_xxx、net、disk...）目录中的Makefile第一句就是：include
$(TOPDIR)/config.mk。文件内容分析如下：
这个文件的功能就是给各个在编译过程中的变量赋值，包括编译执行的函数与编译的时候所带的参数等等。还会根据是否定义了ARCH，CPU，SOC，VENDOR，BOARD来决定是否包含相应位置的config.mk文件，这些个文件里，也是定义了相应的平台在编译的时候应该加的参数。所以如果你为你自己的开发板取了别的名字了，那么就要检查一下这个文件，看一下相应的位置上的config.mk文件有没有，内容是否为你要想的。
l 包含体系，开发板，CPU特定的规则文件：
#指定预编译体系结构选项
ifdef ARCH
sinclude $(TOPDIR)/$(ARCH)_config.mk # include architecture dependend rules
endif
#定义编译时对齐，浮点等选项
ifdef CPU
sinclude $(TOPDIR)/cpu/$(CPU)/config.mk # include CPU specific rules
endif
ifdef SOC
sinclude $(TOPDIR)/cpu/$(CPU)/$(SOC)/config.mk # include SoC specific rules
endif
ifdef VENDOR
BOARDDIR = $(VENDOR)/$(BOARD)
else
BOARDDIR = $(BOARD)
Endif
#指定特定板子的镜像连接时的内存基地址，重要！
ifdef BOARD
sinclude $(TOPDIR)/board/$(BOARDDIR)/config.mk # include board specific rules
endif
l 定义交叉编译链工具
# Include the make variables (CC, etc...)
#
AS = $(CROSS_COMPILE)as
LD = $(CROSS_COMPILE)ld
CC = $(CROSS_COMPILE)gcc
CPP = $(CC) -E
AR = $(CROSS_COMPILE)ar
NM = $(CROSS_COMPILE)nm
STRIP = $(CROSS_COMPILE)strip
OBJCOPY = $(CROSS_COMPILE)objcopy
OBJDUMP = $(CROSS_COMPILE)objdump
RANLIB = $(CROSS_COMPILE)RANLIB
l 定义AR选项ARFLAGS，调试选项DBGFLAGS，优化选项OPTFLAGS　预处理选项CPPFLAGS，C编译器选项CFLAGS，连接选项LDFLAGS
#制定了在编译的时候告诉编译器生成的代码的基地址是TEXT_BASE
CPPFLAGS := $(DBGFLAGS) $(OPTFLAGS) $(RELFLAGS) /
-D__KERNEL__ -DTEXT_BASE=$(TEXT_BASE) /

AFLAGS := $(AFLAGS_DEBUG) -D__ASSEMBLY__ $(CPPFLAGS)

#指定了起始地址TEXT_BASE
LDFLAGS += -Bstatic -T $(LDSCRIPT) -Ttext $(TEXT_BASE) $(PLATFORM_LDFLAGS)

l 指定编译规则
ifndef REMOTE_BUILD

%.s: %.S
$(CPP) $(AFLAGS) -o $@ $<
%.o: %.S
$(CC) $(AFLAGS) -c -o $@ $<
%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<

else

$(obj)%.s: %.S
$(CPP) $(AFLAGS) -o $@ $<
$(obj)%.o: %.S
$(CC) $(AFLAGS) -c -o $@ $<
$(obj)%.o: %.c
$(CC) $(CFLAGS) -c -o $@ $<
endif
3）[b]分析最关键的u-boot ELF文件镜像的生成[/b]
Makefile文件中的各个依赖目标分析如下：
l 依赖目标depend :生成各个子目录的.depend文件，.depend列出每个目标文件的依赖文件。生成方法，调用每个子目录的make _depend。
depend dep:

for dir in $(SUBDIRS) ; do $(MAKE) -C $$dir _depend ; done
l 依赖目标version：生成版本信息到版本文件VERSION_FILE中。
version:

@echo -n "#define U_BOOT_VERSION /"U-Boot " > $(VERSION_FILE); /

echo -n "$(U_BOOT_VERSION)" >> $(VERSION_FILE); /

echo -n $(shell $(CONFIG_SHELL) $(TOPDIR)/tools/setlocalversion /

$(TOPDIR)) >> $(VERSION_FILE); /

echo "/"" >> $(VERSION_FILE)
l 伪目标SUBDIRS: 执行tools ,examples ,post,post/cpu 子目录下面的make文件。
SUBDIRS = tools /

examples /

post /

post/cpu

.PHONY : $(SUBDIRS)
$(SUBDIRS):

$(MAKE) -C $@ all
l 依赖目标$(OBJS)，即cpu/start.o
$(OBJS):

$(MAKE) -C cpu/$(CPU) $(if $(REMOTE_BUILD),$@,$(notdir $@))
l 依赖目标$(LIBS)，这个目标太多，都是每个子目录的库文件*.a ，通过执行相应子目录下的make来完成：
$(LIBS):

$(MAKE) -C $(dir $(subst $(obj),,$@))
l 依赖目标$(LDSCRIPT)：
LDSCRIPT := $(TOPDIR)/board/$(BOARDDIR)/u-boot.lds

LDFLAGS += -Bstatic -T $(LDSCRIPT) -Ttext $(TEXT_BASE) $(PLATFORM_LDFLAGS)
对于每一种开发板来说,LDSCRIPT即连接脚本文件，例如board/esd/cpci5200/u-boot.lds，定义了连接时各个目标文件是如何组织的。内容如下：
OUTPUT_ARCH(powerpc)
SEARCH_DIR(/lib); SEARCH_DIR(/usr/lib); SEARCH_DIR(/usr/local/lib); SEARCH_DIR(/usr/local/powerpc-any-elf/lib);
/* Do we need any of these for elf?
__DYNAMIC = 0; */
SECTIONS
{
/* Read-only sections, merged into text segment: */
. = + SIZEOF_HEADERS;
.interp : { *(.interp) }
.hash : { *(.hash) }
.dynsym : { *(.dynsym) }
.dynstr : { *(.dynstr) }
.rel.text : { *(.rel.text) }
.rela.text : { *(.rela.text) }
.rel.data : { *(.rel.data) }
.rela.data : { *(.rela.data) }
.rel.rodata : { *(.rel.rodata) }
.rela.rodata : { *(.rela.rodata) }
.rel.got : { *(.rel.got) }
.rela.got : { *(.rela.got) }
.rel.ctors : { *(.rel.ctors) }
.rela.ctors : { *(.rela.ctors) }
.rel.dtors : { *(.rel.dtors) }
.rela.dtors : { *(.rela.dtors) }
.rel.bss : { *(.rel.bss) }
.rela.bss : { *(.rela.bss) }
.rel.plt : { *(.rel.plt) }
.rela.plt : { *(.rela.plt) }
.init : { *(.init) }
.plt : { *(.plt) }
#.text的基地址由LDFLAGS中-Ttext
$(TEXT_BASE)指定
.text :
{
#start.o为首
cpu/mpc5xxx/start.o (.text)
*(.text)
*(.fixup)
*(.got1)
. = ALIGN(16);
*(.rodata)
*(.rodata1)
*(.rodata.str1.4)
*(.eh_frame)
}
.fini : { *(.fini) } =0
.ctors : { *(.ctors) }
.dtors : { *(.dtors) }

/* Read-write section, merged into data segment: */
. = (. + 0x0FFF) & 0xFFFFF000;
_erotext = .;
PROVIDE (erotext = .);
.reloc :
{
*(.got)
_GOT2_TABLE_ = .;
*(.got2)
_FIXUP_TABLE_ = .;
*(.fixup)
}
__got2_entries = (_FIXUP_TABLE_ - _GOT2_TABLE_) >> 2;
__fixup_entries = (. - _FIXUP_TABLE_) >> 2;

.data :
{
*(.data)
*(.data1)
*(.sdata)
*(.sdata2)
*(.dynamic)
CONSTRUCTORS
}
_edata = .;
PROVIDE (edata = .);

. = .;
__u_boot_cmd_start = .;
.u_boot_cmd : { *(.u_boot_cmd) }
__u_boot_cmd_end = .;

. = .;
__start___ex_table = .;
__ex_table : { *(__ex_table) }
__stop___ex_table = .;

. = ALIGN(4096);
__init_begin = .;
.text.init : { *(.text.init) }
.data.init : { *(.data.init) }
. = ALIGN(4096);
__init_end = .;

__bss_start = .;
.bss :
{
*(.sbss) *(.scommon)
*(.dynbss)
*(.bss)
*(COMMON)
}
_end = . ;
PROVIDE (end = .);
}
整个makefile剩下的内容全部是各种不同的开发板的*_config:目标的定义了。
对于各子目录的makefile文件，主要是生成*.o文件然后执行AR生成对应的库文件。
概括起来，工程的编译流程也就 是通过执行执行一个make *_config传入ARCH，CPU，BOARD，SOC参数，mkconfig根据参数将include头文件夹相应的头文件夹连接好，生成 config.h。然后执行make分别调用各子目录的makefile 生成所有的obj文件和obj库文件*.a.最后连接所有目标文件，生成镜像。不同格式的镜像都是调用相应工具由elf镜像直接或者间接生成的。

Mkconfig源码注解

#下面这一行的内容，表示这个shell脚本的解释器是/bin/sh，给的解释器的参数为-e，这个#参数的意思就是，当shell返回值为非零值的时候，shell马上退出执行。在shell脚本里也
#可以没有这一行，这一行不是必须的，如果没有这一行的话，那么shell脚本就会用当前运
#行环境下的默认的shell来执行。
#!/bin/sh -e

# Script to create header files and links to configure
# U-Boot for a specific board.
#
# Parameters: Target Architecture CPU Board [VENDOR] [SOC]
#
# (C) 2002-2006 DENX Software Engineering, Wolfgang Denk <wd@denx.de>
#

#APPEND变量与BOARD_NAME变量都设置了默认值，如果后面对变量值有修改就以后面的为准，#没有就是默认值了。这里的APPEND的参数的意义，实际上就是用来标识是否产生一个新的配#置文件，还是直接把生成的配置信息写到旧文件后面。
APPEND=no # Default: Create new config file
BOARD_NAME="" # Name to print in make output

#$#代表的是传入脚本的参数的个数，-gt表示是如果左边参数比右边参数大，则返回true，
#否则为false。$1代表的是传入的第一个参数的内容，$2表示传入的第二个参数的内容，以
#此类推。shift表示参数都左移一位，原来的$3变为$2，$2为$1，$1的内容则被丢弃。这个
#地方，实际上是处理了一些附加的参数的问题，如果是--，则仅丢弃不做其它处理；如果是#-a，则把APPEND的值置为yes；如果是-n，则表示后面跟的是板子的名字。${a%%pattern}是#shell中的一个替换语法，表示把变量a中的内容，从右至左，最大程度上把符合pattern样
#式的字符串删掉。这里可以看出，如果-n后面跟的是类似于smdk2410_config的参数的话，
#则最后会变成smdk2410；如果是其它的值，则退出循环，不执行了。在Makefile中的动作，#其实并不会触发这里的处理逻辑，估计这里是作者为了调试方便，需要单独运行此脚本的时#候，加的一些对参数的处理。
while [ $# -gt 0 ] ; do
case "$1" in
--) shift ; break ;;
-a) shift ; APPEND=yes ;;
-n) shift ; BOARD_NAME="${1%%_config}" ; shift ;;
*) break ;;
esac
done

#第一行的语法表示如果BOARD_NAME没有被设置过，则把它置为变量1的值。然后进行参数个
#数的判断，-lt表示less than则返回true，也就是如果参数少于4个或是参数大于6个，则退#出，不执行。如果没有退出执行的话，则输出Configuring for ${BOARD_NAME} board...这#句话，其中${BOARD_NAME}会被替换成用户输入的板子的名字。
[ "${BOARD_NAME}" ] || BOARD_NAME="$1"

[ $# -lt 4 ] && exit 1
[ $# -gt 6 ] && exit 1

echo "Configuring for ${BOARD_NAME} board..."

#
# Create link to architecture specific headers
#
#当用户指定的$OBJTREE与$SRCTREE不一致的时候会做如下一些事情：
#在$OBJTREE下建立include文件夹
#在$OBJTREE下建立include2文件夹
#进入到include2文件夹，其实就是$OBJTREE文件夹下的include2
#删除asm，其实往后看就知道了，这是一个文件夹，是以link的方式建立的
#然后建立一个asm的文件夹，这个文件夹是指向${SRCTREE}/include/asm-$2的，$2这个参数#多指CPU架构类型如：PPC,ARM。
#给变量LNPREFIX赋值。这个变量在以后的执行会用到，所以这里给的asm的位置，是相对于
#后来执行的时候，当前工作目录与asm之间的关系来定的。
#进入到$OBJTREE中的include文件夹（之前是在include2里）。
#删除掉asm-$2文件夹，其实就是asm-arm文件夹。
#删除掉asm文件夹
#建立一个新的asm-$2文件夹，其实就是asm-arm文件夹
#建立一个名为asm的link，这个link指向新建立的asm-arm文件夹。
#现在看一下整个目录大概的结构：
${OBJTREE}
Include
asm-arm
asm -> ./asm-arm
include2
asm -> ${SRCTREE}/include/asm-arm
#可以看到，目前在include下的asm-arm与asm其实是同一个文件夹，并且内容为空，include2
#文件夹下的asm是指向了源码树中的${SRCTREE}/include/asm-arm文件夹。
#如果"$SRCTREE"与"$OBJTREE"是同一个文件（大多数情况下，咱们都是这种方式来编译的），#那么就是仅仅在include文件夹下，建立一个名为asm的link，直接指向asm-$2，即asm-arm。
#最后删除asm-arm/arch文件夹。
if [ "$SRCTREE" != "$OBJTREE" ] ; then
mkdir -p ${OBJTREE}/include
mkdir -p ${OBJTREE}/include2
cd ${OBJTREE}/include2
rm -f asm
ln -s ${SRCTREE}/include/asm-$2 asm
LNPREFIX="../../include2/asm/"
cd ../include
rm -rf asm-$2
rm -f asm
mkdir asm-$2
ln -s asm-$2 asm
else
cd ./include
rm -f asm
ln -s asm-$2 asm
fi

rm -f asm-$2/arch

#下面第一句中连接两个判断的-o，相当于or的意思，就是表示的“或”。意思就是如果第6
#个参数为空或是为NULL，则在include下建立一个asm-$2/arch的link，指向#${LNPREFIX}arch-$3，否则就在include下建立一个asm-$2/arch的link，指向#${LNPREFIX}arch-$6
if [ -z "$6" -o "$6" = "NULL" ] ; then
ln -s ${LNPREFIX}arch-$3 asm-$2/arch
else
ln -s ${LNPREFIX}arch-$6 asm-$2/arch
fi

#如果第二个参数是arm的话，则删除include/asm-$2/proc文件，实际上就是#include/asm-arm/proc文件夹，建立一个新的link，在include/asm-$2/proc处，也即#include/asm-arm/proc，指向${LNPREFIX}proc-armv文件夹
if [ "$2" = "arm" ] ; then
rm -f asm-$2/proc
ln -s ${LNPREFIX}proc-armv asm-$2/proc
fi

#
# Create include file for Make
#
#第一行，输出ARCH = $2，即ARCH = arm到config.mk，也即include/config.mk，注意这里
#用了一个>，它表示重新生成一个config.mk文件，如果有旧的，则覆盖
#第二行，同理，输出CPU = arm920t到config.mk中
#第三行，同理，输出BOARD = smdk2410到config.mk
#第四行，判断，如果$5不为空，且$5的值不为NULL，
#则把VENDOR = $5的值输出到config.mk中
#第五行，同理，把SOC输出到config.mk中
echo "ARCH = $2" > config.mk
echo "CPU = $3" >> config.mk
echo "BOARD = $4" >> config.mk

[ "$5" ] && [ "$5" != "NULL" ] && echo "VENDOR = $5" >> config.mk

[ "$6" ] && [ "$6" != "NULL" ] && echo "SOC = $6" >> config.mk

#
# Create board specific header file
#
#如果APPEND的值为yes，则写入一空行到已经存在的config.h中，也即include/config.h中，#如果不是，则生成一个新的config.h，如果旧的文件存在，则覆盖。
if [ "$APPEND" = "yes" ] # Append to existing config file
then
echo >> config.h
else
> config.h # Create new config file
fi
echo "/* Automatically generated - do not edit */" >>config.h
echo "#include <configs/$1.h>" >>config.h

exit 0