6.如何自动生成头文件依赖 -M

我们在编译时，希望改了某个c文件，就只编译那一个c文件，同时，改了一个头文件时，也希望包含这个头文件的c文件也编译。对于前者，make默认就是这样做的，而对于后者，却需要我们配合gcc的一些选项来实现这个目的。

要想实现头文件改动，包含了此头文件的c文件也编译，需要在Makefile中体现出c文件与头文件的依赖关系，比如func.c中包含了func.h，那么Makefile中如果有如下依赖关系，就可以实现改了func.h后，func.c也被编译：

func.o:func.c func.h

这样，改了func.h就会自动编译func.c生成func.o。

gcc提供了一个-M选项，来实现自动生成这种依赖的功能。-M选项会把包含的系统头文件以及其所包含的其他系统头文件也找出来了，如果我们不需要输出系统头文件的依赖关系时，可以用-MM选项。我们在编译时，加上-MD选项，就能在生成.o的位置自动生成对应c文件的.d依赖文件。当然，生成了.d依赖文件，我们还需要将.d依赖文件包含到makefile中才行，这样make时才会使用这种依赖关系。

1.为什么要使用后缀名为 .d 的依赖文件？

在 Makefile 中， 我们的依赖关系可能需要包含一系列的头文件。
比如
main.c 源文件内容如下：

#include "stdio.h"
#include "defs.h"

int main(int argc, char *argv[])
{
    
    printf("Hello, %s!\n", NAME);
    return 0;
}       

defs.h 头文件如下：

#ifndef _DEFS_H_
#define _DEFS_H_

#define NAME "makefile"

#endif _DEFS_H_

#那么依赖关系应该如下： 
    main.o : main.c stdio.h defs.h ...   

但如果是一个比较大型的工程，你必需清楚每一个 C 源文件包含了哪些头文件，并且在加入或删除头文件时，也需要小心地修改 Makefile，这是一个很没有维护性的工作。为了避免这种繁重而又容易出错的事情，我们可以使用 gcc编译的一个功能。大多数的 gcc 编译器都支持一个 “-M” 的选项，即自动找寻源文件中包含的头文件，并生成一个依赖关系。例如，执行下面的命令：

gcc -M main.c   
其输出如下：  
    main.o : main.c defs.h

由编译器自动生成依赖关系，这样做的好处有以下几点：

• 不必手动书写若干文件的依赖关系，由编译器自动生成
• 不管是 .c 文件还是 .h 文件有更新，目标文件都会重新编译

2. 参数说明

2.1 -M

生成文件的依赖关系,同时也把一些标准库的头文件也包含了进来。本质是告诉预处理器输出一个适合 make 的规则，用于描述各目标文件的依赖关系。对于每个源文件，预处理器输出 一个 make 规则，该规则的目标项 (target) 是源文件对应的目标文件名，依赖项 (dependency) 是源文件中 ‘#include’ 引用的所有文件，生成的规则可以是单行，但如果太长,就用’\’换行符续成多行。规则 显示在标准输出，不产生预处理过的C程序。
注意：该选项默认打开了 -E 选项， -E 参数的用处是使得编译器在预处理结束时就停止编译

>   例如： gcc -M main.c
>   则在终端上输出如下：
>   main.o: main.c defs.h \
>   /usr/include/stdio.h \
>   /usr/include/features.h \
>   /usr/include/sys/cdefs.h /usr/include/gnu/stubs.h \
>   /usr/lib/gcc-lib/i486-suse-linux/2.95.3/include/stddef.h \
>   /usr/include/bits/types.h \
>   /usr/include/bits/pthreadtypes.h \
>   /usr/include/_G_config.h /usr/include/wchar.h \
>   /usr/include/bits/wchar.h /usr/include/gconv.h \
>   /usr/lib/gcc-lib/i486-suse-linux/2.95.3/include/stdarg.h \
>   /usr/include/bits/stdio_lim.h
> 

2.2 -MM

生成文件的依赖关系，和 -M 类似，但不包含标准库的头文件

例如：gcc -MM main.c
则在终端上输出如下：
main.o: main.c defs.h

2.3 -MF File

当使用了 ‘-M’ 或者 ‘-MM’ 选项时，则把依赖关系写入名为 ‘File’ 的文件中。若同时也使用了 ‘-MD’ 或 ‘-MMD’，’-MF’ 将覆写输出的依赖文件的名称

例如：gcc -M -MF main.d main.c
    则 '—M' 输出的内容就存在于 main.d 文件中了

2.4 -MD

等同于 ‘-M -MF File’，但是默认关闭了 ‘-E’ 选项. 其输出的文件名是基于 ‘-o’ 选项，若给定了 ‘-o’ 选项，则输出的文件名是 ‘-o’ 指定的文件名，并添加 .d 后缀，若没有给定，则输入的文件名作为输出的文件名，并添加.d后缀，同时继续指定的编译工作
注意：’-MD’ 不会像 ‘-M’ 那样阻止正常的编译任务. 因为它默认关闭了 ‘-E’ 选项, 比如命令中使用了 -c 选项，其结果要生成 .o 文件，若使用了 ‘-M’ 选项，则不会生成 .o 文件，若使用的是 ‘-MD’ 选项，则会生成 .o 文件

例如1：gcc -E -MD main.c
本目录下生成了以下文件：
    main.d 
同时在终端上输出了 main.c 文件的预处理结果

经实测发现,不使用 '-o' 指定输出文件名，以下情况有细微的差别:
gcc -E main.c //不使用 '-o'，则把结果输出在终端上
gcc -S main.c //不使用 '-o'，则把结果默认输出到以输入文件名为名称的 .s 文件中，即 main.s
gcc -c main.c //同上
gcc main.o   //不使用 '-o'，则把结果默认输出到 a.out 可执行文件中

例如2：gcc -E -o tmp.i -MD main.c
本目录下生成了以下文件：
    tmp.d tmp.i

例如3：gcc -c -MD main.c
本目录下生成了以下文件：
    main.d main.o

例如4：gcc -c -o tmp.o -MD main.c
本目录下生成了以下文件：
    tmp.d tmp.o

例如5: gcc -MD main.c
本目录下生成了以下文件:
    a.out main.d 

例如6: gcc -M -MD main.c
本目录下生成了以下文件:
    main.d  //并不会生成a.out可执行文件,因为 '-M' 默认打开了 '-E' 选项,使得编译器在预处理结束后就停止编译

2.5 -MMD

类似于 ‘-MD’，但是输出的依赖文件中，不包含标准头文件

2.6 -MP

生成的依赖文件里面，依赖规则中的所有.h依赖项都会在该文件中生成一个伪目标，其不依赖任何其他依赖项。该伪规则将避免删除了对应的头文件而没有更新 “Makefile” 去匹配新的依赖关系而导致make出错的情况出现。
(英文描述:This option instructs CPP to add a phony target for each dependency
other than the main file, causing each to depend on nothing. These
dummy rules work around errors ‘make’ gives if you remove header
files without updating the ‘Makefile’ to match.)

例如1: gcc -c -MM -MD main.c
生成的 main.d 文件内容如下:
main.o: main.c defs.h

例如2: gcc -c -MM -MD main.c -MP
生成的 main.d 文件内容如下:
main.o: main.c defs.h
defs.h:  //该选项会生成该伪目标，其没有任何依赖项,若不使用 '-MP' 选项,则不会生成该伪目标规则

2.7 -MT Target

在生成的依赖文件中,指定依赖规则中的目标

例如: gcc -MF main.d -MG -MM -MP -MT main.d -MT main.o main.c

$ cat main.d    #查看生成的依赖文件的内容
main.d main.o: main.c
注:依赖规则中main.d 和 main.o 目标都是通过'-MT'选项指定的

3. 使用示例

#查找文件c.c的头文件依赖，打印出来
gcc -M c.c

#把c.c的头文件依赖写入到 c.d文件中
gcc -M -MF c.d c.c

#既把c.c的头文件依赖写入到 c.d文件中,又同时编译c.c文件为c.o
gcc -c -o c.o c.c -MD -MF c.d

#makefile
%.o : %.c
	gcc -c -o [email protected] $< -MD -MF [email protected]

以上简单介绍了 gcc -M 相关的选项,旨在让 make 自动推导并生成文件的依赖关系。
以下提供一个比较好的 gcc -M 选项的参考示例， 它将自动生成依赖文件，并保存在指定目录下的 ‘.d’ 文件中。

3.1 makefile 示例1

SRCS=$(wildcard *.c)
OBJS=$(SRCS:.c=.o)
DEPS=$(SRCS:.c=.d)

.PHONY: all clean

all: main

-include $(DEPS) 
#注释:'-'号的作用：加载错误时，会继续执行 make，主要是考虑到首次 make 时，目录中若不存在 '*.d' 文件时，加载便会产生错误而停止 make 的执行

%.o:%.c
    gcc -c -g -Wall $< -o [email protected] -MD -MF $*.d -MP 

main: $(OBJS)
    gcc $^ -o [email protected]   #注释:$^:表示所有的依赖文件 [email protected]:表示目标文件

clean: 
        rm -f  *.d *.o main

其中的依赖文件.d 是否存在，也可以改用shell中的判断。如下面的示例：

3.1 makefile 示例2

#makefile

objs = a.o b.o c.o
dep_files = $(patsubst % ,.%.d ,$(objs))
dep_files_exist = $(wildcard $(dep_files))
test : $(objs)
	gcc -o test $^
	
ifneq ($(dep_files_exist),)
include $(dep_files_exist)
endif


%.o : %.c
	gcc -c -o [email protected] $< -MD -MF [email protected]
	
clean:
	rm *.o test
distclean:
	 $(dep_files)
	 
.PHONY:
	clean

4. 延伸说明

Makefile 文件中使用比较多的自动变量:

 - [email protected] : 表示一个规则中的目标.当规则中有多个目标时,[email protected] 所指的是其中任何造成规则的命令运行的目标
 - $^ : 表示规则中的所有依赖项
 - $< : 表示规则中的第一个依赖项

例如 Makefile 文件内容如下:
target1 target2:dep1 dep2 dep3
    @echo "Tar:[email protected], First Dep:$<, All Dep:$^"

dep1 dep2 dep3:    
#注释:不写该行目标规则,执行 make 会报错,因为 makefile 目录下不仅没有 dep1 dep2 dep3 文件,
#makefile 文件中也没有以这些依赖文件做为目标的规则.

运行 make: 
1. make target1 或者 make (把文件中第一个目标当作首要目标)
终端输出如下:
    Tar:target1, First Dep:dep1, All Dep:dep1 dep2 dep3

2. make target2
终端输出如下:
    Tar:target2, First Dep:dep1, All Dep:dep1 dep2 dep3

3. make target1 target2
终端输出如下:
    Tar:target2, First Dep:dep1, All Dep:dep1 dep2 dep3
    Tar:target2, First Dep:dep1, All Dep:dep1 dep2 dep3