轉載自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屬於偽目標。通過偽目標說明可以知道可以執行的目標。

OpenWrt的主Makefile工作過程