OpenWrt的主Makefile工作过程
转载自http://www.right.com.cn/forum/thread-73443-1-3.html
OpenWrt的主Makefile内容如下
1 # Makefile for OpenWrt
2 #
3 # Copyright (C) 2007 OpenWrt.org
4 #
5 # This is free software, licensed under the GNU General Public License v2.
6 # See /LICENSE for more information.
7 #
8
9 TOPDIR:=${CURDIR}
10 LC_ALL:=C
11 LANG:=C
12 export TOPDIR LC_ALL LANG
13
14 empty:=
15 space:= $(empty) $(empty)
16 $(if $(findstring $(space),$(TOPDIR)),$(error ERROR: The path to the OpenWrt directory must not include any spaces))
17
18 world:
19
20 include $(TOPDIR)/include/host.mk
21
22 ifneq ($(OPENWRT_BUILD),1)
23 _SINGLE=export MAKEFLAGS=$(space);
24
25 override OPENWRT_BUILD=1
26 export OPENWRT_BUILD
27 GREP_OPTIONS=
28 export GREP_OPTIONS
29 include $(TOPDIR)/include/debug.mk
30 include $(TOPDIR)/include/depends.mk
31 include $(TOPDIR)/include/toplevel.mk
32 else
33 include rules.mk
34 include $(INCLUDE_DIR)/depends.mk
35 include $(INCLUDE_DIR)/subdir.mk
36 include target/Makefile
37 include package/Makefile
38 include tools/Makefile
39 include toolchain/Makefile
40
41 $(toolchain/stamp-install): $(tools/stamp-install)
42 $(target/stamp-compile): $(toolchain/stamp-install) $(tools/stamp-install) $(BUILD_DIR)/.prepared
43 $(package/stamp-compile): $(target/stamp-compile) $(package/stamp-cleanup)
44 $(package/stamp-install): $(package/stamp-compile)
45 $(target/stamp-install): $(package/stamp-compile) $(package/stamp-install)
46
47 printdb:
48 @true
49
50 prepare: $(target/stamp-compile)
51
52 clean: FORCE
53 rm -rf $(BUILD_DIR) $(STAGING_DIR) $(BIN_DIR) $(BUILD_LOG_DIR)
54
55 dirclean: clean
56 rm -rf $(STAGING_DIR_HOST) $(TOOLCHAIN_DIR) $(BUILD_DIR_HOST) $(BUILD_DIR_TOOLCHAIN)
57 rm -rf $(TMP_DIR)
58
59 ifndef DUMP_TARGET_DB
60 $(BUILD_DIR)/.prepared: Makefile
61 @mkdir -p $$(dirname $@)
62 @touch $@
63
64 tmp/.prereq_packages: .config
65 unset ERROR; \
66 for package in $(sort $(prereq-y) $(prereq-m)); do \
67 $(_SINGLE)$(NO_TRACE_MAKE) -s -r -C package/$$package prereq || ERROR=1; \
68 done; \
69 if [ -n "$$ERROR" ]; then \
70 echo "Package prerequisite check failed."; \
71 false; \
72 fi
73 touch $@
74 endif
75
76 # check prerequisites before starting to build
77 prereq: $(target/stamp-prereq) tmp/.prereq_packages
78 @if [ ! -f "$(INCLUDE_DIR)/site/$(ARCH)" ]; then \
79 echo 'ERROR: Missing site config for architecture "$(ARCH)" !'; \
80 echo ' The missing file will cause configure scripts to fail during compilation.'; \
81 echo ' Please provide a "$(INCLUDE_DIR)/site/$(ARCH)" file and restart the build.'; \
82 exit 1; \
83 fi
84
85 prepare: .config $(tools/stamp-install) $(toolchain/stamp-install)
86 world: prepare $(target/stamp-compile) $(package/stamp-compile) $(package/stamp-install) $(target/stamp-install) FORCE
87 $(_SINGLE)$(SUBMAKE) -r package/index
88
89 .PHONY: clean dirclean prereq prepare world package/symlinks package/symlinks-install package/symlinks-clean
90
91 endif
OpenWrt是一个典型的嵌入式Linux工程，了解OpenWrt的Makefile的工作过程对提高嵌入式Linux工程的开发能力有极其重要意义。
OpenWrt的主Makefile文件只有100行，可以简单分为三部分，1~20行为前导部分，21~31为首次执行部分，33~91为再次执行部分。
前导部分
CURDIR为make默认变量，默认值为当前目录。
前导部分主要把变量TOPDIR赋值为当前目录，把变量LC_ALL、LANG赋值为C，并使用变量延伸指示符export，把上述三个变量延伸到下层Makefile。
使用文件使用指示符include引入$(TOPDIR)/include/host.mk。在OpenWrt的主Makefile文件使用了多次include指示符，说明主Makefile文件被拆分成多个文件，被拆分的文件放在不同的目录。拆分的目的是明确各部分的功能，而且增加其灵活性。
在前导部分比较费解的是使用world目标，在makefile中基本规则为：
TARGETS : PREREQUISITES
COMMAND
...
即makefile规则由目标、依赖、命令三部分组成，在OpenWrt的主Makefile文件的第一个目标world没有依赖和命令。它主要起到指示当make命令不带目标时所要执行的目标，没有设定依赖和命令部分表明此目标在此后将会有其他依赖关系或命令。world目标的命令需要进一步参考$(TOPDIR)/include/toplevel.mk和主Makefile文件的再次执行部分。
首次执行部分
OPENWRT_BUILD是区分首次执行与再次执行的变量。在首次执行时使用强制赋值指示符override把OPENWRT_BUILD赋值为1，并使用变量延伸指示符export把OPENWRT_BUILD延伸。在OPENWRT_BUILD使用强制赋值指示符override意味着make命令行可能引入OPENWRT_BUILD参数。
引入$(TOPDIR)/include/debug.mk、$(TOPDIR)/include/depends.mk、$(TOPDIR)/include/toplevel.mk三个文件，由于TOPDIR是固定的，所以三个文件也是固定的。其中$(TOPDIR)/include/toplevel.mk的135行%::有效解释首次执行时world目标的规则。
再次执行部分
引入rules.mk、$(INCLUDE_DIR)/depends.mk、$(INCLUDE_DIR)/subdir.mk、target/Makefile、package/Makefile、tools/Makefile、toolchain/Makefile七个文件，rules.mk没有目录名，即引入与主Makefile文件目录相同的rules.mk。在rules.mk定义了INCLUDE_DIR为$(TOPDIR)/include，所以$(INCLUDE_DIR)/depends.mk实际上与首次执行时引入的$(TOPDIR)/include/depends.mk是同一个文件。
四个子目录下的Makefile实际上是不能独立执行。主要利用$(INCLUDE_DIR)/subdir.mk动态建立规则，诸如$(toolchain/stamp-install)目标是靠$(INCLUDE_DIR)/subdir.mk的stampfile函数动态建立。在package/Makefile动态建立了$(package/ stamp-prereq)、$(package/ stamp-cleanup)、$(package/ stamp-compile)、$(package/ stamp-install)、$(package/ stamp-rootfs-prepare)目标。
定义一些使用变量命名的目标，其变量的赋值位置在$(INCLUDE_DIR)/subdir.mk的stampfile函数中。目标只有依赖关系，可能说明其工作顺序，在$(INCLUDE_DIR)/subdir.mk的stampfile函数中有进一步说明其目标执行的命令，并为目标建立一个空文件，即使用变量命名的目标为真实的文件。
定义一些使用固定的目标规则。
其中：clean是清除编译结果的目标，清除$(BUILD_DIR) $(BIN_DIR) $(BUILD_LOG_DIR)三个目录的用意是十分明确。暂时不知道为什么执行make target/linux/clean。
dirclean是删除所有编译过程产生的目录和文件的目标，执行dirclean目标依赖于clean，因此将执行clean目标所执行的命令，然后删除$(STAGING_DIR) $(STAGING_DIR_HOST) $(STAGING_DIR_TOOLCHAIN) $(TOOLCHAIN_DIR) $(BUILD_DIR_HOST) $(BUILD_DIR_TOOLCHAIN)目录，以及删除$(TMP_DIR)目录。上述目录的变量均在rules.mk定义。好像删除staging_dir目录就意味着删除staging_dir目录下的所有子目录，不知道为什么要强调删除$(STAGING_DIR_HOST) $(STAGING_DIR_TOOLCHAIN) $(TOOLCHAIN_DIR)目录。同样删除builde_dir目录就意味着删除builde_dir目录下的所有子目录，不知道为什么要强调删除$(BUILD_DIR_TOOLCHAIN)目录。
tmp/.prereq_packages目标是对所需软件包的预处理。目标依赖于.config，即执行make menuconfig后将会进行一次所需软件包的预处理。不知什么原因在编译前删除tmp目录，执行时无法建立tmp/.prereq_packages文件。
prereq应该是预请求目标，在OpenWrt执行Makefile时好像都要先执行prereq目标。
prepare应该是准备目标，是world依赖的一个伪目标。依赖于文件.config和$(tools/stamp-install) $(toolchain/stamp-install)目标。
world就是编译的目标。依赖于prepare为目标和前面提到的变量命名目标。采用取消隐含规则方式执行package/index目标。package/index目标在package/Makefile的92行定义。
package/symlinks和package/symlinks-install是更新或安装软件包来源的目标，使用$(SCRIPT_DIR)/feeds脚本文件完成。
package/symlinks-clean是清除软件包来源的目标，也是使用$(SCRIPT_DIR)/feeds脚本文件完成。
最后使用伪目标.PHONY说明clean dirclean prereq prepare world package/symlinks package/symlinks-install package/symlinks-clean属于伪目标。通过伪目标说明可以知道可以执行的目标。
