Makefile自動生成標頭檔案依賴

2021-08-14 20:14:32 字數 3110 閱讀 4653

makefile自動生成標頭檔案依賴是很常用的功能,本文的目的是想盡量詳細說明其中的原理和過程。

首先給出乙個本人在小專案中常用的makefile模板,支援自動生成標頭檔案依賴。

cc      = gcc 

cflags = -wall -o

includeflags =

ldflags =

objs = seq.o

targets = test_seq

.phony:all

all : $(targets)

test_seq:test_seq.o $(objs)

$(cc) -o $@ $^ $(ldflags)

%.o:%.c

$(cc) -o $@ -c $< $(cflags) $(includeflags)

%.d:%.c

@set -e; rm -f $@; $(cc) -mm $< $(includeflags) > $@.$$$$; \

sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' < $@.$$$$ > $@; \

rm -f $@.$$$$

-include $(objs:.o=.d)

.phony:clean

clean:

rm -f $(targets) *.o *.d *.d.*

讀入makefile

讀入被include的其它makefile

初始化makefile中的變數

推導隱晦規則,並分析所有規則

為所有目標建立依賴關係鏈

根據依賴關係,決定哪些目標需要重新生成

執行生成命令

從上面make的執行過程中可看出,要動態生成依賴關係,只能利用第2步讀入其它makefile的機制。那麼,我們是否可以先把生成的依賴關係儲存到檔案,然後再把該檔案的內容包含進來?

答案是yes! 只要利用include的機制。

include關鍵字是用於讀入其它makefile檔案。當該檔案不存在時,make會尋找是否有生成它的規則,如果有,則執行其生成命令,然後再嘗試讀入。在include前加減號"-"可以上make忽略其產生的錯誤,並不輸出任何錯誤資訊。

即是說,我們需要提供生成規則檔案的規則。例如,我們可以這樣動態生成標頭檔案依賴關係:

seq.d : seq.c

@echo 「seq.o seq.d : seq.c seq.h" > $@

-include seq.d

當make執行時,makefile中的內容將是這樣子(指記憶體上的資料):

seq.d : seq.c

@echo 「seq.o seq.d : seq.c seq.h" > $@

seq.o seq.d : seq.c seq.h

特別注意的是,由於對seq.c和seq.h的修改需要更新seq.d的內容(因為依賴關係可能已變化),因此seq.d也要在依賴關係的目標列表中。

基於上面的例子,現在可以開始討論如何自動生成標頭檔案依賴。

大多數c/c++編譯器提供了-m選項,可自動尋找原始檔依賴的標頭檔案,並生成依賴規則。對於gcc,需要使用-mm選項,否則它會把系統依賴的標頭檔案也包含進來。例如執行下面乙個命令:

gcc -mm seq.c
將輸出:

seq.o : seq.c seq.h
但我們需要結果是seq.d也要包含在目標列表中,所以還需要對它進行文字處理。因此,上面的例子可改為:

seq.d : seq.c

@set -e; \

gcc -mm $< > $@.$$$$; \

sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' < $@.$$$$ > $@; \

rm -f $@.$$$$

-include seq.d

第乙個命令@set -e。@關鍵字告訴make不輸出該行命令;set -e的作用是,當後面的命令的返回值非0時,立即退出。

那麼為什麼要把幾個命令寫在」同一行「(是對於make來說,因為\的作用就是連線行),並用分號隔開每個命令?因為在makefile這樣做才能使上乙個命令作用於下乙個命令。這裡是想要set -e作用於後面的命令。

第二個命令gcc -mm $< > $@.$$$$, 作用是根據原始檔生成依賴關係,並儲存到臨時檔案中。內建變數$<的值為第乙個依賴檔案(那seq.c),$$$$為字串"$$",由於makefile中所有的$字元都是特殊字元(即使在單引號之中!),要得到普通字元$,需要用$$來轉義; 而$$是shell的特殊變數,它的值為當前程序號;使用程序號為字尾的名稱建立臨時檔案,是shell程式設計常用做法,這樣可保證檔案唯一性。

第三個命令作用是將目標檔案加入依賴關係的目錄列表中,並儲存到目標檔案。關於正規表示式部分就不說了,唯一要注意的是內建變數$*$*的值為第乙個依賴檔案去掉字尾的名稱(這裡即是seq)。

第四個命令是將該臨時檔案刪除。

如果把內建變數都替換成其值後,實際內容是這樣子:

seq.d : seq.c

@set -e; \

gcc -mm seq.c > seq.d.$$$$; \

sed 's,\(seq\)\.o[ :]*,\1.o seq.d : ,g' < seq.d.$$$$ > seq.d; \

rm -f seq.d.$$$$

-include seq.d

最後,再把makefile的模式匹配應用上,就完成自動生成標頭檔案依賴功能了:

%.d : %.c

@set -e; \

gcc -mm $@ > $@.$$$$; \

sed 's,\($*\)\.o[ :]*,\1.o $@ : ,g' < $@.$$$$ > $@; \

rm -f $@.$$$$

-include seq.d

Makefile自動生成標頭檔案依賴

makefile自動生成標頭檔案依賴是很常用的功能,本文的目的是想盡量詳細說明其中的原理和過程。首先給出乙個本人在小專案中常用的makefile模板,支援自動生成標頭檔案依賴。cc gcc cflags wall o includeflags ldflags objs seq.o targets t...

pycharm自動生成標頭檔案注釋

1 在file settings file and code templates python script即可自定製pycharm建立檔案自動生成的標頭檔案注釋資訊 2 建立py檔案自動生成效果圖 3 可以自定製新增的標頭檔案注釋內容如下 可以根據需要新增相應的資訊 usr bin python3...

makefile檔案生成

前段時間,學習c,用autoconf和automake生成了乙個簡單的makefile檔案。autoconf是乙個用於生成可以自動地配置軟體原始碼包,用以適應多種unix類系統的shell指令碼工具,其中autoconf需要用到 m4,便於生成指令碼。automake是乙個從makefile.am檔...