Linux Makefile 生成 *.d 依赖文件以及 gcc -M -MF -MP 等相关选项说明

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 ...   

假设目标文件 main.o 的依赖关系缺少了 defs.h 文件,当 defs.h 文件中的内容改变后,根本不会重新编译目标文件,这是致命的,因为目标文件内部引用了 defs.h 文件中的宏定义。

如果是一个比较大型的工程,我们必需清楚每一个源文件都包含了哪些头文件,并且在加入或删除某些头文件时,也需要一并修改 Makefile,这是一个费力不讨好的工作。

为了避免这种繁重而又容易出错的事情,可以使用 C/C++ 编译器的 “-M” 系列选项,即自动获取源文件中包含的头文件,并生成一个依赖关系。

由编译器自动生成依赖关系,这样做的好处有如下两点:

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

2. 参数说明


  • -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
    
  • -MM
    生成文件的依赖关系,和 -M 类似,但不包含标准库的头文件

    例如:

    gcc -MM main.c
    

    则在终端上输出如下:

    main.o: main.c defs.h
    
  • -MG
    要求把缺失的头文件按存在对待,并且假定他们和源文件在同一目录下,必须和 ‘-M’ 选项一起用。

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

    例如:

    gcc -M -MF main.d main.c
    

    则 “-M” 输出的内容就保存在 main.d 文件中了

  • -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 //不使用 '-o',则把结果输出到以输入文件名为名称的 .o 文件中,即 main.o
    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' 选项,使得编译器在预处理结束后就停止编译
    

    例 7:

    gcc -c -M -MF main.d  main.c
    
    本目录下生成了以下文件:
    	 main.d 
    
    不会生成 main.o 文件,因为 '-M' 默认打开了 '-E' 选项,使得编译器在预处理结束后就停止编译
    

    例 8:

    gcc -c -o m.o -M -MF main.d  main.c
    
    本目录下生成了以下文件:
    	 main.d m.o
    
    此处为啥跟 例7 不一样,生成了 m.o 文件,而不受 -M 的影响而终止编译呢?
    

    针对 例7 和 例8 的差异,博主找到了如下说明:

    GCC 编译器在处理命令行选项时有一个特定的顺序。如果没有指定 -o 选项,编译器会默认将目标文件命名为 “a.out”。但是当使用 -M 选项时,GCC 将输出依赖关系文件而不是目标文件。因此如果你不指定 -o 选项,编译器会将生成的目标文件命名为 “a.out”,并且将输出重定向到依赖关系文件 “main.d”,这样就导致了预期之外的行为。

    通过增加 -o 选项并指定目标文件的名称为 “main.o”,你告诉编译器将生成的目标文件命名为 “main.o”,而不是默认的 “a.out”。这样编译器就不会将输出重定向到依赖关系文件 “main.d”,从而避免了预处理后终止的问题。

  • -MMD
    类似于 “-MD”,但是输出的依赖文件中,不包含标准头文件

  • -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: 
    <------------
    
    该选项会生成 "defs.h:" 伪目标,其没有任何依赖项,若不使用 '-MP' 选项,则不会生成该伪目标规则
    
  • -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. 使用参考


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

Makefile 如下所示:

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

.PHONY: all clean

all: main

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

%.o:%.c
	gcc -c -g -Wall $< -o $@ -MD -MF $*.d -MP 

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

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

仍旧以本篇文章开头的源文件进行 make,将生成如下文件:

文件说明
main可执行文件
main.o编译的二进制目标文件
main.d保存了 main.o 依赖关系的文件
注释: 
$* 表示目标模式中 '%' 及其之前的部分.如果目标是 'dir/a.foo.b',
并且目标的模式为 'a.%.b',那么 '$*' 的值就是 'dir/a.foo'。
如果目标中没有模式的定义,那么 '$*' 就不能被推导出;
但是,如果目标文件是 make 所识别的,那么 '$*' 就是除了后缀的那一部分。

例如:
目标是 'foo.c',因为 '.c' 是 make 所能识别的后缀名,
所以 '$*' 的值就是 'foo',这个特性是 GNU make 的。

4. 延伸说明


  • 自动化变量

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

    自动变量说明
    $@表示一个规则中的目标.当规则中有多个目标时,$@ 所指的是其中任何造成规则的命令运行的目标
    $^表示规则中的所有依赖项
    $<表示规则中的第一个依赖项

    例如:

    Makefile 文件内容如下:

    target1 target2:dep1 dep2 dep3
    	@echo "Tar:$@, First Dep:$<, All Dep:$^"
    
    # 注释:不写以下行目标规则,执行 make 会报错,
    # 因为 makefile 文件所在目录下不仅没有 dep1 dep2 dep3 文件,
    # makefile 文件中也没有以这些依赖文件做为目标的规则.
    dep1 dep2 dep3:   
    
    运行 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:target1, First Dep:dep1, All Dep:dep1 dep2 dep3
    	Tar:target2, First Dep:dep1, All Dep:dep1 dep2 dep3
    

    相信大家在看了以上例子,能够更加理解这三个自动化变量的含义,尤其是 ‘$@’,前面已经说明,这里就不再赘述了。

  • -M 和 -E 选项的区别
    -E:用于执行预处理操作,包括宏展开、包含头文件等操作,生成预处理后的输出。

    -M:用于生成源文件及其包含的头文件之间的依赖关系,并输出到标准输出。它会将这些依赖关系输出为 Makefile 格式或类似的格式,以便在构建过程中自动处理文件之间的依赖关系。

    当使用 gcc -M 选项时,它会在生成依赖关系的同时执行预处理操作,因此包含了 gcc -E 选项的一部分功能。然而,-M 选项的主要目的是生成依赖关系,而不是生成预处理后的输出。

5. 参考链接


以上有些内容引用了其他博客,在此感谢博主;以上内容若有差错,欢迎指正,以免误人误己。

  • 116
    点赞
  • 420
    收藏
    觉得还不错? 一键收藏
  • 21
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论 21
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值