OpenWrt Makefile 整體分析

分析版本: svn://svn.openwrt.org.cn/openwrt/branches/backfire

OpenWrt基本結構
–target/Linux/ 目錄裏面是各平臺(arch)的相關代碼
–target/linux/ /config 文件的配置文件
–package 目錄裏面包含了我們在配置文件裏面設定的所有編譯好的軟件包
–scripts/feeds update 來對軟件包進行更新
–scirpts/feeds search X 查找軟件包X
–package/symlinks 估計意思是更新軟件源之類的

=========================我是分割線=================
==以下部分參考：http://www.right.com.cn/forum/thread-73443-1-1.html===
=======================================================
OpenWrt的主Makefile文件只有100行，可以簡單分爲三部分，1~17行爲前導部分，19~31爲首次執行部分，33~101爲再次執行部分。

前導部分
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屬於僞目標。通過僞目標說明可以知道可以執行的目標。

===================我是分割線==================
====>Makefile:
TOPDIR:=${CURDIR} #定義直接變量取得當前make的工作目錄
LC_ALL:=C
LANG:=C
export TOPDIR LC_ALL LANG #定義直接變量，把變量延伸，使得在包含的mk中也可用

world:
#指示make不帶目標時要執行的命令，也就是默認執行的命令，由於其不帶規則和依賴，所以表明此目標在此後將會有其他依賴關係或命令，當執行”~$ make”時，即跳轉到toplevel.mk執行。======1======

include $(TOPDIR)/include/host.mk #引入文件

ifneq ($(OPENWRT_BUILD),1) #判斷是否是首次執行OPENWRT_BUILD在toplevel.mk中定義爲0
# XXX: these three lines are normally defined by rules.mk
# but we can’t include that file in this context
empty:=
space:= $(empty) $(empty)
_SINGLE=export MAKEFLAGS=$(space);

override OPENWRT_BUILD=1 #如果是首次執行，使用override強制openwrt_build爲1
export OPENWRT_BUILD #延伸openwrt_build變量的使用
include $(TOPDIR)/include/debug.mk #引入文件
include $(TOPDIR)/include/depends.mk
include $(TOPDIR)/include/toplevel.mk
else
include rules.mk #不是首次執行，則引入以下文件
include $(INCLUDE_DIR)/depends.mk
include $(INCLUDE_DIR)/subdir.mk
include target/Makefile
include package/Makefile
include tools/Makefile
include toolchain/Makefile

$(toolchain/stamp-install): $(tools/stamp-install)
$(target/stamp-compile): $(toolchain/stamp-install) $(tools/stamp-install) $(BUILD_DIR)/.prepared
$(package/stamp-cleanup): $(target/stamp-compile)
$(package/stamp-compile): $(target/stamp-compile) $(package/stamp-cleanup)
$(package/stamp-install): $(package/stamp-compile)
$(package/stamp-rootfs-prepare): $(package/stamp-install)
$(target/stamp-install): $(package/stamp-compile) $(package/stamp-install) $(package/stamp-rootfs-prepare)
$(BUILD_DIR)/.prepared: Makefile
@mkdir -p $$(dirname $@)
@touch $@

prepare: $(target/stamp-compile)

clean: FORCE
$(_SINGLE)$(SUBMAKE) target/linux/clean
rm -rf $(BUILD_DIR) $(BIN_DIR) $(BUILD_LOG_DIR)

dirclean: clean
rm -rf $(STAGING_DIR) $(STAGING_DIR_HOST) $(STAGING_DIR_TOOLCHAIN) $(TOOLCHAIN_DIR) $(BUILD_DIR_HOST) $(BUILD_DIR_TOOLCHAIN)
rm -rf $(TMP_DIR)

#處理依賴問題===========9=========
tmp/.prereq_packages: .config
@echo “this is in main Makefile tmp/.prereq_packages”
unset ERROR; \
for package in $(sort $(prereq-y) $(prereq-m)); do \
$(_SINGLE)$(NO_TRACE_MAKE) -s -r -C package/

packageprereq||ERROR=1; done; if[−n"

ERROR" ]; then \
echo “Package prerequisite check failed.”; \
false; \
fi
touch $@

# check prerequisites before starting to build

#在toplevel.mk中的prereq目標執行完之後，跳轉回到主Makefile文件，執行其prereq目標的規則================8====================
prereq: $(target/stamp-prereq) tmp/.prereq_packages
@echo “this is in main Makefile”

prepare: .config $(tools/stamp-install) $(toolchain/stamp-install)

#當所有的依賴已經準備好之後，開始執行編譯==============10=============
world: prepare $(target/stamp-compile) $(package/stamp-cleanup) $(package/stamp-compile) $(package/stamp-install) $(package/stamp-rootfs-prepare) $(target/stamp-install) FORCE
$(_SINGLE)$(SUBMAKE) -r package/index

# update all feeds, re-create index files, install symlinks
package/symlinks:
$(SCRIPT_DIR)/feeds update -a
$(SCRIPT_DIR)/feeds install -a

# re-create index files, install symlinks
package/symlinks-install:
$(SCRIPT_DIR)/feeds update -i
$(SCRIPT_DIR)/feeds install -a

# remove all symlinks, don’t touch ./feeds
package/symlinks-clean:
$(SCRIPT_DIR)/feeds uninstall -a

.PHONY: clean dirclean prereq prepare world package/symlinks package/symlinks-install package/symlinks-clean

endif

=====>./include/toplevel.mk:
RELEASE:=Backfire #爲了避免出現循環
SHELL:=/usr/bin/env bash
PREP_MK= OPENWRT_BUILD= QUIET=0

include $(TOPDIR)/include/verbose.mk

ifeq ($(SDK),1)
include $(TOPDIR)/include/version.mk
else
REVISION:=$(shell $(TOPDIR)/scripts/getver.sh) #shell 執行操作系統的命令
endif

OPENWRTVERSION:=$(RELEASE)$(if $(REVISION), ($(REVISION)))
export RELEASE
export REVISION
export OPENWRTVERSION
export IS_TTY=$(shell tty -s && echo 1 || echo 0)
export LD_LIBRARY_PATH:=$(if $(LD_LIBRARY_PATH),$(LD_LIBRARY_PATH):)$(STAGING_DIR_HOST)/lib
export DYLD_LIBRARY_PATH:=$(if $(DYLD_LIBRARY_PATH),$(DYLD_LIBRARY_PATH):)$(STAGING_DIR_HOST)/lib

# prevent perforce from messing with the patch utility
unexport P4PORT P4USER P4CONFIG P4CLIENT

# prevent user defaults for quilt from interfering
unexport QUILT_PATCHES QUILT_PATCH_OPTS

# make sure that a predefined CFLAGS variable does not disturb packages
export CFLAGS=

ifeq ($(FORCE),)
.config scripts/config/conf scripts/config/mconf: tmp/.prereq-build
endif

SCAN_COOKIE?=$(shell echo

)
export SCAN_COOKIE

SUBMAKE:=umask 022; $(SUBMAKE)

prepare-mk: FORCE ;

#依賴於FORCE保證及時目標存在也會執行此命令=================4=============
prepare-tmpinfo: FORCE
mkdir -p tmp/info #-r禁止使用任何隱含規則 -f制定需要執行的文件-j輸出規則中的命令 -r命令運行時不輸出命令的輸出 mkdir –p 一次性創建多層目錄
$(_SINGLE)$(NO_TRACE_MAKE) -j1 -r -s -f include/scan.mk SCAN_TARGET=”packageinfo” SCAN_DIR=”package” SCAN_NAME=”package” SCAN_DEPS=”$(TOPDIR)/include/package*.mk $(TOPDIR)/overlay/*/*.mk” SCAN_DEPTH=5 SCAN_EXTRA=”"
$(_SINGLE)$(NO_TRACE_MAKE) -j1 -r -s -f include/scan.mk SCAN_TARGET=”targetinfo” SCAN_DIR=”target/linux” SCAN_NAME=”target” SCAN_DEPS=”profiles/*.mk $(TOPDIR)/include/kernel*.mk $(TOPDIR)/include/target.mk” SCAN_DEPTH=2 SCAN_EXTRA=”" SCAN_MAKEOPTS=”TARGET_BUILD=1″
for type in package target; do \
f=tmp/.

typeinfo;t=tmp/.config−

{type}.in; \
[ "

t"−nt"

f" ] || ./scripts/metadata.pl

typeconfig“

f” > “

t” || { rm -f “

t”; echo “Failed to build $$t”; false; break; }; \
done
./scripts/metadata.pl package_mk tmp/.packageinfo > tmp/.packagedeps || { rm -f tmp/.packagedeps; false; }
touch $(TOPDIR)/tmp/.build

.config: ./scripts/config/conf $(if $(CONFIG_HAVE_DOT_CONFIG),,prepare-tmpinfo)
@+if [ \! -e .config ] || ! grep CONFIG_HAVE_DOT_CONFIG .config >/dev/null; then \
#”+”無論如何這些命令都會被執行
[ -e $(HOME)/.openwrt/defconfig ] && cp $(HOME)/.openwrt/defconfig .config; \
$(_SINGLE)$(NO_TRACE_MAKE) menuconfig $(PREP_MK); \
fi

scripts/config/mconf:
@$(_SINGLE)$(SUBMAKE) -s -C scripts/config all

$(eval $(call rdep,scripts/config,scripts/config/mconf))

scripts/config/conf:
@$(_SINGLE)$(SUBMAKE) -s -C scripts/config conf
#-C 意思就是轉到此目錄下執行make -s全面禁止命令的顯示，跳轉到scripts/config下執行此目錄下的Makefile文件的conf標籤=============4=========

config: scripts/config/conf prepare-tmpinfo FORCE
$< Config.in #$< 描述了所有的依賴

config-clean: FORCE
$(_SINGLE)$(NO_TRACE_MAKE) -C scripts/config clean

defconfig: scripts/config/conf prepare-tmpinfo FORCE
touch .config
$< -D .config Config.in

oldconfig: scripts/config/conf prepare-tmpinfo FORCE
$< -$(if $(CONFDEFAULT),$(CONFDEFAULT),o) Config.in

menuconfig: scripts/config/mconf prepare-tmpinfo FORCE
if [ \! -e .config -a -e $(HOME)/.openwrt/defconfig ]; then \
cp $(HOME)/.openwrt/defconfig .config; \
fi
$< Config.in

prepare_kernel_conf: .config FORCE

ifeq ($(wildcard staging_dir/host/bin/sed),)
prepare_kernel_conf:
@+$(SUBMAKE) -r tools/sed/install
else
prepare_kernel_conf: ;
endif

kernel_oldconfig: prepare_kernel_conf
$(_SINGLE)$(NO_TRACE_MAKE) -C target/linux oldconfig

kernel_menuconfig: prepare_kernel_conf
$(_SINGLE)$(NO_TRACE_MAKE) -C target/linux menuconfig

#建立其依賴 ===========6==============轉到include/prereq-build.mk下執行，主要就是檢查各種依賴關係是否已經安裝好。
tmp/.prereq-build: include/prereq-build.mk
mkdir -p tmp
rm -f tmp/.host.mk
@$(_SINGLE)$(NO_TRACE_MAKE) -j1 -r -s -f $(TOPDIR)/include/prereq-build.mk prereq 2>/dev/null || { \
echo “Prerequisite check failed. Use FORCE=1 to override.”; \
false; \
}
touch $@

download: .config FORCE
@+$(SUBMAKE) tools/download
@+$(SUBMAKE) toolchain/download
@+$(SUBMAKE) package/download
@+$(SUBMAKE) target/download

clean dirclean: .config
@+$(SUBMAKE) -r $@

#再次找到prereq目標，然後建立其依賴prepare-tmpinfo .config========3=========
prereq:: prepare-tmpinfo .config
@+$(MAKE) -r -s tmp/.prereq-build $(PREP_MK)
#-r 不運行命令，也不輸出，僅僅檢查目標是否需要更新========5===========
@+$(NO_TRACE_MAKE) -r -s $@ #所有的準備完之後，跳轉回主Makefile文件======7=======

#雙::號規則允許在多個規則中爲同一個目標創建不同命令，NO_TRACE_MAKE在include/verbose.mk中定義爲 :=$(MAKE) V=99，PREP_MK在開始定義爲0，+代表之後的命令都要執行，也就是表示執行-r禁止使用任何隱含規則-s禁止所有執行命令的顯示 $ make prereq =========2=========
%::
@+$(PREP_MK) $(NO_TRACE_MAKE) -r -s prereq
@+$(SUBMAKE) -r $@

help:
cat README

docs docs/compile: FORCE
@$(_SINGLE)$(SUBMAKE) -C docs compile

docs/clean: FORCE
@$(_SINGLE)$(SUBMAKE) -C docs clean

distclean:
rm -rf tmp build_dir staging_dir dl .config* feeds package/feeds package/openwrt-packages bin
@$(_SINGLE)$(SUBMAKE) -C scripts/config clean

ifeq ($(findstring v,$(DEBUG)),)
.SILENT: symlinkclean clean dirclean distclean config-clean download help tmpinfo-clean .config scripts/config/mconf scripts/config/conf menuconfig tmp/.prereq-build tmp/.prereq-package prepare-tmpinfo
endif
.PHONY: help FORCE
.NOTPARALLEL: