makefile詳解 make 的執行 二十三
阿新 • • 發佈：2019-01-13
make 的執行
——————
一般來說，最簡單的就是直接在命令列下輸入make命令，make命令會找當前目錄的makefile來執行，一切都是自動的。但也有時你也許只想讓make重編譯某些檔案，而不是整個工程，而又有的時候你有幾套編譯規則，你想在不同的時候使用不同的編譯規則，等等。本章節就是講述如何使用make命令的。
一、make的退出碼
make命令執行後有三個退出碼：
0 —— 表示成功執行。
1 —— 如果make執行時出現任何錯誤，其返回1。
2 —— 如果你使用了make的“-q”選項，並且make使得一些目標不需要更新，那麼返回2。
Make的相關引數我們會在後續章節中講述。
二、指定Makefile
前面我們說過，GNU make找尋預設的Makefile的規則是在當前目錄下依次找三個檔案——“GNUmakefile”、“makefile”和“Makefile”。其按順序找這三個檔案，一旦找到，就開始讀取這個檔案並執行。
當前，我們也可以給make命令指定一個特殊名字的Makefile。要達到這個功能，我們要使用make的“-f”或是“--file”引數（“--makefile”引數也行）。例如，我們有個makefile的名字是“hchen.mk”，那麼，我們可以這樣來讓make來執行這個檔案：
make –f hchen.mk
如果在make的命令列是，你不只一次地使用了“-f”引數，那麼，所有指定的makefile將會被連在一起傳遞給make執行。
三、指定目標
一般來說，make的最終目標是makefile中的第一個目標，而其它目標一般是由這個目標連帶出來的。這是make的預設行為。當然，一般來說，你的makefile中的第一個目標是由許多個目標組成，你可以指示make，讓其完成你所指定的目標。要達到這一目的很簡單，需在make命令後直接跟目標的名字就可以完成（如前面提到的“make clean”形式）
任何在makefile中的目標都可以被指定成終極目標，但是除了以“-”打頭，或是包含了“=”的目標，因為有這些字元的目標，會被解析成命令列引數或是變數。甚至沒有被我們明確寫出來的目標也可以成為make的終極目標，也就是說，只要make可以找到其隱含規則推導規則，那麼這個隱含目標同樣可以被指定成終極目標。
有一個make的環境變數叫“MAKECMDGOALS”，這個變數中會存放你所指定的終極目標的列表，如果在命令列上，你沒有指定目標，那麼，這個變數是空值。這個變數可以讓你使用在一些比較特殊的情形下。比如下面的例子：
sources = foo.c bar.c
ifneq ( $(MAKECMDGOALS),clean)
include $(sources:.c=.d)
endif
基於上面的這個例子，只要我們輸入的命令不是“make clean”，那麼makefile會自動包含“foo.d”和“bar.d”這兩個makefile。
使用指定終極目標的方法可以很方便地讓我們編譯我們的程式，例如下面這個例子：
.PHONY: all
all: prog1 prog2 prog3 prog4
從這個例子中，我們可以看到，這個makefile中有四個需要編譯的程式——“prog1”， “prog2”， “prog3”和 “prog4”，我們可以使用“make all”命令來編譯所有的目標（如果把all置成第一個目標，那麼只需執行“make”），我們也可以使用“make prog2”來單獨編譯目標“prog2”。
即然make可以指定所有makefile中的目標，那麼也包括“偽目標”，於是我們可以根據這種性質來讓我們的makefile根據指定的不同的目標來完成不同的事。在Unix世界中，軟體釋出時，特別是GNU這種開源軟體的釋出時，其makefile都包含了編譯、安裝、打包等功能。我們可以參照這種規則來書寫我們的makefile中的目標。
“all”
這個偽目標是所有目標的目標，其功能一般是編譯所有的目標。
“clean”
這個偽目標功能是刪除所有被make建立的檔案。
“install”
這個偽目標功能是安裝已編譯好的程式，其實就是把目標執行檔案拷貝到指定的目標中去。
“print”
這個偽目標的功能是例出改變過的原始檔。
“tar”
這個偽目標功能是把源程式打包備份。也就是一個tar檔案。
“dist”
這個偽目標功能是建立一個壓縮檔案，一般是把tar檔案壓成Z檔案。或是gz檔案。
“TAGS”
這個偽目標功能是更新所有的目標，以備完整地重編譯使用。
“check”和“test”
這兩個偽目標一般用來測試makefile的流程。
當然一個專案的makefile中也不一定要書寫這樣的目標，這些東西都是GNU的東西，但是我想，GNU搞出這些東西一定有其可取之處（等你的UNIX下的程式檔案一多時你就會發現這些功能很有用了），這裡只不過是說明了，如果你要書寫這種功能，最好使用這種名字命名你的目標，這樣規範一些，規範的好處就是——不用解釋，大家都明白。而且如果你的makefile中有這些功能，一是很實用，二是可以顯得你的makefile很專業（不是那種初學者的作品）。
四、檢查規則
有時候，我們不想讓我們的makefile中的規則執行起來，我們只想檢查一下我們的命令，或是執行的序列。於是我們可以使用make命令的下述引數：
“-n”
“--just-print”
“--dry-run”
“--recon”
不執行引數，這些引數只是列印命令，不管目標是否更新，把規則和連帶規則下的命令打印出來，但不執行，這些引數對於我們除錯makefile很有用處。
“-t”
“--touch”
這個引數的意思就是把目標檔案的時間更新，但不更改目標檔案。也就是說，make假裝編譯目標，但不是真正的編譯目標，只是把目標變成已編譯過的狀態。
“-q”
“--question”
這個引數的行為是找目標的意思，也就是說，如果目標存在，那麼其什麼也不會輸出，當然也不會執行編譯，如果目標不存在，其會打印出一條出錯資訊。
“-W <file>;”
“--what-if=<file>;”
“--assume-new=<file>;”
“--new-file=<file>;”
這個引數需要指定一個檔案。一般是是原始檔（或依賴檔案），Make會根據規則推導來執行依賴於這個檔案的命令，一般來說，可以和“-n”引數一同使用，來檢視這個依賴檔案所發生的規則命令。
另外一個很有意思的用法是結合“-p”和“-v”來輸出makefile被執行時的資訊（這個將在後面講述）。
五、make的引數
下面列舉了所有GNU make 3.80版的引數定義。其它版本和產商的make大同小異，不過其它產商的make的具體引數還是請參考各自的產品文件。
“-b”
“-m”
這兩個引數的作用是忽略和其它版本make的相容性。
“-B”
“--always-make”
認為所有的目標都需要更新（重編譯）。
“-C <dir>;”
“--directory=<dir>;”
指定讀取makefile的目錄。如果有多個“-C”引數，make的解釋是後面的路徑以前面的作為相對路徑，並以最後的目錄作為被指定目錄。如：“make –C ~hchen/test –C prog”等價於“make –C ~hchen/test/prog”。
“—debug[=<options>;]”
輸出make的除錯資訊。它有幾種不同的級別可供選擇，如果沒有引數，那就是輸出最簡單的除錯資訊。下面是<options>;的取值：
a —— 也就是all，輸出所有的除錯資訊。（會非常的多）
b —— 也就是basic，只輸出簡單的除錯資訊。即輸出不需要重編譯的目標。
v —— 也就是verbose，在b選項的級別之上。輸出的資訊包括哪個makefile被解析，不需要被重編譯的依賴檔案（或是依賴目標）等。
i —— 也就是implicit，輸出所以的隱含規則。
j —— 也就是jobs，輸出執行規則中命令的詳細資訊，如命令的PID、返回碼等。
m —— 也就是makefile，輸出make讀取makefile，更新makefile，執行makefile的資訊。
“-d”
相當於“--debug=a”。
“-e”
“--environment-overrides”
指明環境變數的值覆蓋makefile中定義的變數的值。
“-f=<file>;”
“--file=<file>;”
“--makefile=<file>;”
指定需要執行的makefile。
“-h”
“--help”
顯示幫助資訊。
“-i”
“--ignore-errors”
在執行時忽略所有的錯誤。
“-I <dir>;”
“--include-dir=<dir>;”
指定一個被包含makefile的搜尋目標。可以使用多個“-I”引數來指定多個目錄。
“-j [<jobsnum>;]”
“--jobs[=<jobsnum>;]”
指同時執行命令的個數。如果沒有這個引數，make執行命令時能執行多少就執行多少。如果有一個以上的“-j”引數，那麼僅最後一個“-j”才是有效的。（注意這個引數在MS-DOS中是無用的）
“-k”
“--keep-going”
出錯也不停止執行。如果生成一個目標失敗了，那麼依賴於其上的目標就不會被執行了。
“-l <load>;”
“--load-average[=<load]”
“—max-load[=<load>;]”
指定make執行命令的負載。
“-n”
“--just-print”
“--dry-run”
“--recon”
僅輸出執行過程中的命令序列，但並不執行。
“-o <file>;”
“--old-file=<file>;”
“--assume-old=<file>;”
不重新生成的指定的<file>;，即使這個目標的依賴檔案新於它。
“-p”
“--print-data-base”
輸出makefile中的所有資料，包括所有的規則和變數。這個引數會讓一個簡單的makefile都會輸出一堆資訊。如果你只是想輸出資訊而不想執行makefile，你可以使用“make -qp”命令。如果你想檢視執行makefile前的預設變數和規則，你可以使用“make –p –f /dev/null”。這個引數輸出的資訊會包含著你的makefile檔案的檔名和行號，所以，用這個引數來除錯你的makefile會是很有用的，特別是當你的環境變數很複雜的時候。
“-q”
“--question”
不執行命令，也不輸出。僅僅是檢查所指定的目標是否需要更新。如果是0則說明要更新，如果是2則說明有錯誤發生。
“-r”
“--no-builtin-rules”
禁止make使用任何隱含規則。
“-R”
“--no-builtin-variabes”
禁止make使用任何作用於變數上的隱含規則。
“-s”
“--silent”
“--quiet”
在命令執行時不輸出命令的輸出。
“-S”
“--no-keep-going”
“--stop”
取消“-k”選項的作用。因為有些時候，make的選項是從環境變數“MAKEFLAGS”中繼承下來的。所以你可以在命令列中使用這個引數來讓環境變數中的“-k”選項失效。
“-t”
“--touch”
相當於UNIX的touch命令，只是把目標的修改日期變成最新的，也就是阻止生成目標的命令執行。
“-v”
“--version”
輸出make程式的版本、版權等關於make的資訊。
“-w”
“--print-directory”
輸出執行makefile之前和之後的資訊。這個引數對於跟蹤巢狀式呼叫make時很有用。
“--no-print-directory”
禁止“-w”選項。
“-W <file>;”
“--what-if=<file>;”
“--new-file=<file>;”
“--assume-file=<file>;”
假定目標<file>;需要更新，如果和“-n”選項使用，那麼這個引數會輸出該目標更新時的執行動作。如果沒有“-n”那麼就像執行UNIX的“touch”命令一樣，使得<file>;的修改時間為當前時間。
“--warn-undefined-variables”
只要make發現有未定義的變數，那麼就輸出警告資訊。
——————
一般來說，最簡單的就是直接在命令列下輸入make命令，make命令會找當前目錄的makefile來執行，一切都是自動的。但也有時你也許只想讓make重編譯某些檔案，而不是整個工程，而又有的時候你有幾套編譯規則，你想在不同的時候使用不同的編譯規則，等等。本章節就是講述如何使用make命令的。
一、make的退出碼
make命令執行後有三個退出碼：
0 —— 表示成功執行。
1 —— 如果make執行時出現任何錯誤，其返回1。
2 —— 如果你使用了make的“-q”選項，並且make使得一些目標不需要更新，那麼返回2。
Make的相關引數我們會在後續章節中講述。
二、指定Makefile
前面我們說過，GNU make找尋預設的Makefile的規則是在當前目錄下依次找三個檔案——“GNUmakefile”、“makefile”和“Makefile”。其按順序找這三個檔案，一旦找到，就開始讀取這個檔案並執行。
當前，我們也可以給make命令指定一個特殊名字的Makefile。要達到這個功能，我們要使用make的“-f”或是“--file”引數（“--makefile”引數也行）。例如，我們有個makefile的名字是“hchen.mk”，那麼，我們可以這樣來讓make來執行這個檔案：
make –f hchen.mk
如果在make的命令列是，你不只一次地使用了“-f”引數，那麼，所有指定的makefile將會被連在一起傳遞給make執行。
三、指定目標
一般來說，make的最終目標是makefile中的第一個目標，而其它目標一般是由這個目標連帶出來的。這是make的預設行為。當然，一般來說，你的makefile中的第一個目標是由許多個目標組成，你可以指示make，讓其完成你所指定的目標。要達到這一目的很簡單，需在make命令後直接跟目標的名字就可以完成（如前面提到的“make clean”形式）
任何在makefile中的目標都可以被指定成終極目標，但是除了以“-”打頭，或是包含了“=”的目標，因為有這些字元的目標，會被解析成命令列引數或是變數。甚至沒有被我們明確寫出來的目標也可以成為make的終極目標，也就是說，只要make可以找到其隱含規則推導規則，那麼這個隱含目標同樣可以被指定成終極目標。
有一個make的環境變數叫“MAKECMDGOALS”，這個變數中會存放你所指定的終極目標的列表，如果在命令列上，你沒有指定目標，那麼，這個變數是空值。這個變數可以讓你使用在一些比較特殊的情形下。比如下面的例子：
sources = foo.c bar.c
ifneq ( $(MAKECMDGOALS),clean)
include $(sources:.c=.d)
endif
基於上面的這個例子，只要我們輸入的命令不是“make clean”，那麼makefile會自動包含“foo.d”和“bar.d”這兩個makefile。
使用指定終極目標的方法可以很方便地讓我們編譯我們的程式，例如下面這個例子：
.PHONY: all
all: prog1 prog2 prog3 prog4
從這個例子中，我們可以看到，這個makefile中有四個需要編譯的程式——“prog1”， “prog2”， “prog3”和 “prog4”，我們可以使用“make all”命令來編譯所有的目標（如果把all置成第一個目標，那麼只需執行“make”），我們也可以使用“make prog2”來單獨編譯目標“prog2”。
即然make可以指定所有makefile中的目標，那麼也包括“偽目標”，於是我們可以根據這種性質來讓我們的makefile根據指定的不同的目標來完成不同的事。在Unix世界中，軟體釋出時，特別是GNU這種開源軟體的釋出時，其makefile都包含了編譯、安裝、打包等功能。我們可以參照這種規則來書寫我們的makefile中的目標。
“all”
這個偽目標是所有目標的目標，其功能一般是編譯所有的目標。
“clean”
這個偽目標功能是刪除所有被make建立的檔案。
“install”
這個偽目標功能是安裝已編譯好的程式，其實就是把目標執行檔案拷貝到指定的目標中去。
“print”
這個偽目標的功能是例出改變過的原始檔。
“tar”
這個偽目標功能是把源程式打包備份。也就是一個tar檔案。
“dist”
這個偽目標功能是建立一個壓縮檔案，一般是把tar檔案壓成Z檔案。或是gz檔案。
“TAGS”
這個偽目標功能是更新所有的目標，以備完整地重編譯使用。
“check”和“test”
這兩個偽目標一般用來測試makefile的流程。
當然一個專案的makefile中也不一定要書寫這樣的目標，這些東西都是GNU的東西，但是我想，GNU搞出這些東西一定有其可取之處（等你的UNIX下的程式檔案一多時你就會發現這些功能很有用了），這裡只不過是說明了，如果你要書寫這種功能，最好使用這種名字命名你的目標，這樣規範一些，規範的好處就是——不用解釋，大家都明白。而且如果你的makefile中有這些功能，一是很實用，二是可以顯得你的makefile很專業（不是那種初學者的作品）。
四、檢查規則
有時候，我們不想讓我們的makefile中的規則執行起來，我們只想檢查一下我們的命令，或是執行的序列。於是我們可以使用make命令的下述引數：
“-n”
“--just-print”
“--dry-run”
“--recon”
不執行引數，這些引數只是列印命令，不管目標是否更新，把規則和連帶規則下的命令打印出來，但不執行，這些引數對於我們除錯makefile很有用處。
“-t”
“--touch”
這個引數的意思就是把目標檔案的時間更新，但不更改目標檔案。也就是說，make假裝編譯目標，但不是真正的編譯目標，只是把目標變成已編譯過的狀態。
“-q”
“--question”
這個引數的行為是找目標的意思，也就是說，如果目標存在，那麼其什麼也不會輸出，當然也不會執行編譯，如果目標不存在，其會打印出一條出錯資訊。
“-W <file>;”
“--what-if=<file>;”
“--assume-new=<file>;”
“--new-file=<file>;”
這個引數需要指定一個檔案。一般是是原始檔（或依賴檔案），Make會根據規則推導來執行依賴於這個檔案的命令，一般來說，可以和“-n”引數一同使用，來檢視這個依賴檔案所發生的規則命令。
另外一個很有意思的用法是結合“-p”和“-v”來輸出makefile被執行時的資訊（這個將在後面講述）。
五、make的引數
下面列舉了所有GNU make 3.80版的引數定義。其它版本和產商的make大同小異，不過其它產商的make的具體引數還是請參考各自的產品文件。
“-b”
“-m”
這兩個引數的作用是忽略和其它版本make的相容性。
“-B”
“--always-make”
認為所有的目標都需要更新（重編譯）。
“-C <dir>;”
“--directory=<dir>;”
指定讀取makefile的目錄。如果有多個“-C”引數，make的解釋是後面的路徑以前面的作為相對路徑，並以最後的目錄作為被指定目錄。如：“make –C ~hchen/test –C prog”等價於“make –C ~hchen/test/prog”。
“—debug[=<options>;]”
輸出make的除錯資訊。它有幾種不同的級別可供選擇，如果沒有引數，那就是輸出最簡單的除錯資訊。下面是<options>;的取值：
a —— 也就是all，輸出所有的除錯資訊。（會非常的多）
b —— 也就是basic，只輸出簡單的除錯資訊。即輸出不需要重編譯的目標。
v —— 也就是verbose，在b選項的級別之上。輸出的資訊包括哪個makefile被解析，不需要被重編譯的依賴檔案（或是依賴目標）等。
i —— 也就是implicit，輸出所以的隱含規則。
j —— 也就是jobs，輸出執行規則中命令的詳細資訊，如命令的PID、返回碼等。
m —— 也就是makefile，輸出make讀取makefile，更新makefile，執行makefile的資訊。
“-d”
相當於“--debug=a”。
“-e”
“--environment-overrides”
指明環境變數的值覆蓋makefile中定義的變數的值。
“-f=<file>;”
“--file=<file>;”
“--makefile=<file>;”
指定需要執行的makefile。
“-h”
“--help”
顯示幫助資訊。
“-i”
“--ignore-errors”
在執行時忽略所有的錯誤。
“-I <dir>;”
“--include-dir=<dir>;”
指定一個被包含makefile的搜尋目標。可以使用多個“-I”引數來指定多個目錄。
“-j [<jobsnum>;]”
“--jobs[=<jobsnum>;]”
指同時執行命令的個數。如果沒有這個引數，make執行命令時能執行多少就執行多少。如果有一個以上的“-j”引數，那麼僅最後一個“-j”才是有效的。（注意這個引數在MS-DOS中是無用的）
“-k”
“--keep-going”
出錯也不停止執行。如果生成一個目標失敗了，那麼依賴於其上的目標就不會被執行了。
“-l <load>;”
“--load-average[=<load]”
“—max-load[=<load>;]”
指定make執行命令的負載。
“-n”
“--just-print”
“--dry-run”
“--recon”
僅輸出執行過程中的命令序列，但並不執行。
“-o <file>;”
“--old-file=<file>;”
“--assume-old=<file>;”
不重新生成的指定的<file>;，即使這個目標的依賴檔案新於它。
“-p”
“--print-data-base”
輸出makefile中的所有資料，包括所有的規則和變數。這個引數會讓一個簡單的makefile都會輸出一堆資訊。如果你只是想輸出資訊而不想執行makefile，你可以使用“make -qp”命令。如果你想檢視執行makefile前的預設變數和規則，你可以使用“make –p –f /dev/null”。這個引數輸出的資訊會包含著你的makefile檔案的檔名和行號，所以，用這個引數來除錯你的makefile會是很有用的，特別是當你的環境變數很複雜的時候。
“-q”
“--question”
不執行命令，也不輸出。僅僅是檢查所指定的目標是否需要更新。如果是0則說明要更新，如果是2則說明有錯誤發生。
“-r”
“--no-builtin-rules”
禁止make使用任何隱含規則。
“-R”
“--no-builtin-variabes”
禁止make使用任何作用於變數上的隱含規則。
“-s”
“--silent”
“--quiet”
在命令執行時不輸出命令的輸出。
“-S”
“--no-keep-going”
“--stop”
取消“-k”選項的作用。因為有些時候，make的選項是從環境變數“MAKEFLAGS”中繼承下來的。所以你可以在命令列中使用這個引數來讓環境變數中的“-k”選項失效。
“-t”
“--touch”
相當於UNIX的touch命令，只是把目標的修改日期變成最新的，也就是阻止生成目標的命令執行。
“-v”
“--version”
輸出make程式的版本、版權等關於make的資訊。
“-w”
“--print-directory”
輸出執行makefile之前和之後的資訊。這個引數對於跟蹤巢狀式呼叫make時很有用。
“--no-print-directory”
禁止“-w”選項。
“-W <file>;”
“--what-if=<file>;”
“--new-file=<file>;”
“--assume-file=<file>;”
假定目標<file>;需要更新，如果和“-n”選項使用，那麼這個引數會輸出該目標更新時的執行動作。如果沒有“-n”那麼就像執行UNIX的“touch”命令一樣，使得<file>;的修改時間為當前時間。
“--warn-undefined-variables”
只要make發現有未定義的變數，那麼就輸出警告資訊。