日志
makefile3
| |
文件名操作函数
下面我们要介绍的函数主要是处理文件名的。每个函数的参数字符串都会被当做一个或是一
系列的文件名来对待。
$(dir <names...>)
名称：取目录函数——dir。
功能：从文件名序列<names>中取出目录部分。目录部分是指最后一个反斜杠（“/”）之
前的部分。如果没有反斜杠，那么返回“./”。
返回：返回文件名序列<names>的目录部分。
示例： $(dir src/foo.c hacks)返回值是“src/ ./”。
$(notdir <names...>)
名称：取文件函数——notdir。
功能：从文件名序列<names>中取出非目录部分。非目录部分是指最后一个反斜杠（“/”）
之后的部分。
返回：返回文件名序列<names>的非目录部分。
示例：$(notdir src/foo.c hacks)返回值是“foo.c hacks”。
$(suffix <names...>)
名称：取后缀函数——suffix。
功能：从文件名序列<names>中取出各个文件名的后缀。
返回：返回文件名序列<names>的后缀序列，如果文件没有后缀，则返回空字串。
示例：$(suffix src/foo.c src-1.0/bar.c hacks)返回值是“.c .c”。
$(basename <names...>)
名称：取前缀函数——basename。
功能：从文件名序列<names>中取出各个文件名的前缀部分。
返回：返回文件名序列<names>的前缀序列，如果文件没有前缀，则返回空字串。
示例：$(basename src/foo.c src-1.0/bar.c hacks)返回值是“src/foo src-1.0/bar
hacks”。
$(addsuffix <suffix>,<names...>)
名称：加后缀函数——addsuffix。
功能：把后缀<suffix>加到<names>中的每个单词后面。
返回：返回加过后缀的文件名序列。
示例：$(addsuffix .c,foo bar)返回值是“foo.c bar.c”。$(addprefix <prefix>,<names...>)
名称：加前缀函数——addprefix。
功能：把前缀<prefix>加到<names>中的每个单词后面。
返回：返回加过前缀的文件名序列。
示例：$(addprefix src/,foo bar)返回值是“src/foo src/bar”。
$(join <list1>,<list2>)
名称：连接函数——join。
功能：把<list2>中的单词对应地加到<list1>的单词后面。如果<list1>的单词个数要比
<list2>的多，那么，<list1>中的多出来的单词将保持原样。如果<list2>的单词个数要比<list1>
多，那么，<list2>多出来的单词将被复制到<list2>中。
返回：返回连接过后的字符串。
示例：$(join aaa bbb , 111 222 333)返回值是“aaa111 bbb222 333”。
四、foreach 函数
foreach 函数和别的函数非常的不一样。因为这个函数是用来做循环用的，Makefile中的
foreach函数几乎是仿照于Unix标准Shell（/bin/sh）中的for语句，或是C-Shell（/bin/csh）
中的foreach语句而构建的。它的语法是：
$(foreach <var>,<list>,<text>)
这个函数的意思是，把参数<list>中的单词逐一取出放到参数<var>所指定的变量中，然后再
执行<text>所包含的表达式。每一次<text>会返回一个字符串，循环过程中，<text>的所返回
的每个字符串会以空格分隔，最后当整个循环结束时，<text>所返回的每个字符串所组成的
整个字符串（以空格分隔）将会是foreach函数的返回值。
所以，<var>最好是一个变量名，<list>可以是一个表达式，而<text>中一般会使用<var>这个
参数来依次枚举<list>中的单词。举个例子：
names := a b c d
files := $(foreach n,$(names),$(n).o)
上面的例子中，$(name)中的单词会被挨个取出，并存到变量“n”中，“$(n).o”每次根据“$(n)”
计算出一个值，这些值以空格分隔，最后作为foreach函数的返回，所以，$(files)的值是“a.o
b.o c.o d.o”。
注意，foreach 中的<var>参数是一个临时的局部变量，foreach 函数执行完后，参数<var>的
变量将不在作用，其作用域只在foreach函数当中。
五、if 函数
if函数很像GNU的make所支持的条件语句——ifeq（参见前面所述的章节），if函数的语
法是：
$(if <condition>,<then-part>)
或是
$(if <condition>,<then-part>,<else-part>)
可见，if函数可以包含“else”部分，或是不含。即if函数的参数可以是两个，也可以是三个。
<condition>参数是if的表达式，如果其返回的为非空字符串，那么这个表达式就相当于返回
真，于是，<then-part>会被计算，否则<else-part>会被计算。
而if函数的返回值是，如果<condition>为真（非空字符串），那个<then-part>会是整个函数
的返回值，如果<condition>为假（空字符串），那么<else-part>会是整个函数的返回值，此
时如果<else-part>没有被定义，那么，整个函数返回空字串。
所以，<then-part>和<else-part>只会有一个被计算。
六、call 函数
call函数是唯一一个可以用来创建新的参数化的函数。你可以写一个非常复杂的表达式，这
个表达式中，你可以定义许多参数，然后你可以用call函数来向这个表达式传递参数。其语
法是：
$(call <expression>,<parm1>,<parm2>,<parm3>...)
当make执行这个函数时，<expression>参数中的变量，如$(1)，$(2)，$(3)等，会被参数<p
arm1>，<parm2>，<parm3>依次取代。而<expression>的返回值就是call函数的返回值。例
如：
reverse = $(1) $(2)
foo = $(call reverse,a,b)
那么，foo的值就是“a b”。当然，参数的次序是可以自定义的，不一定是顺序的，如：
reverse = $(2) $(1)
foo = $(call reverse,a,b)
此时的foo的值就是“b a”。
七、origin 函数
origin函数不像其它的函数，他并不操作变量的值，他只是告诉你你的这个变量是哪里来的？
其语法是：
$(origin <variable>)
注意，<variable>是变量的名字，不应该是引用。所以你最好不要在<variable>中使用“$”字
符。Origin函数会以其返回值来告诉你这个变量的“出生情况”，下面，是origin函数的返回
值:
“undefined”
如果<variable>从来没有定义过，origin函数返回这个值“undefined”。
“default”
如果<variable>是一个默认的定义，比如“CC”这个变量，这种变量我们将在后面讲
述。
“environment”
如果<variable>是一个环境变量，并且当Makefile被执行时，“-e”参数没有被打开
。
“file”
如果<variable>这个变量被定义在Makefile中。
“command line”
如果<variable>这个变量是被命令行定义的。
“override”
如果<variable>是被override指示符重新定义的。
“automatic”
如果<variable>是一个命令运行中的自动化变量。关于自动化变量将在后面讲述。这些
信息对于我们编写Makefile是非常有用的，例如，假设我们有一个Makefile其包了一个定
义文件Make.def，在Make.def中定义了一个变量“bletch”，而我们的环境中也有一个环境变
量“bletch”，此时，我们想判断一下，如果变量来源于环境，那么我们就把之重定义了，如
果来源于Make.def或是命令行等非环境的，那么我们就不重新定义它。于是，在我们的
Makefile中，我们可以这样写：
ifdef bletch
ifeq "$(origin bletch)" "environment"
bletch = barf, gag, etc.
endif
endif
当然，你也许会说，使用override关键字不就可以重新定义环境中的变量了吗？为什么需要
使用这样的步骤？是的，我们用override是可以达到这样的效果，可是override过于粗暴，
它同时会把从命令行定义的变量也覆盖了，而我们只想重新定义环境传来的，而不想重新定
义命令行传来的。
八、shell 函数
shell函数也不像其它的函数。顾名思义，它的参数应该就是操作系统Shell的命令。它和反
引号“`”是相同的功能。这就是说，shell 函数把执行操作系统命令后的输出作为函数返回。
于是，我们可以用操作系统命令以及字符串处理命令awk，sed等等命令来生成一个变量，
如：
contents := $(shell cat foo)
files := $(shell echo *.c)
注意，这个函数会新生成一个Shell程序来执行命令，所以你要注意其运行性能，如果你的
Makefile中有一些比较复杂的规则，并大量使用了这个函数，那么对于你的系统性能是有害
的。特别是Makefile的隐晦的规则可能会让你的shell函数执行的次数比你想像的多得多。
九、控制 make 的函数
make提供了一些函数来控制make的运行。通常，你需要检测一些运行Makefile时的运行
时信息，并且根据这些信息来决定，你是让make继续执行，还是停止。
$(error <text ...>)
产生一个致命的错误，<text ...>是错误信息。注意，error函数不会在一被使用就会
产生错误信息，所以如果你把其定义在某个变量中，并在后续的脚本中使用这个变量，那么
也是可以的。例如：
示例一：
ifdef ERROR_001
$(error error is $(ERROR_001))
endif
示例二：
ERR = $(error found an error!)
.PHONY: err
err: ; $(ERR)
示例一会在变量ERROR_001定义了后执行时产生error调用，而示例二则在目录err
被执行时才发生error调用。
$(warning <text ...>)
这个函数很像error函数，只是它并不会让make退出，只是输出一段警告信息，而make
继续执行。
make 的退出码
make命令执行后有三个退出码：
0 —— 表示成功执行。
1 —— 如果make运行时出现任何错误，其返回1。
2 —— 如果你使用了make的“-q”选项，并且make使得一些目标不需要更新，那么返
回2。
指定makefile：make –f hchen.mk
如果在make的命令行是，你不只一次地使用了“-f”参数，那么，所有指定的makefile将会
被连在一起传递给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发现有未定义的变量，那么就输出警告信息。
如果你只是想输出信息而不想执行makefile，你可以使用“make -qp”命
令。如果你想查看执行makefile前的预设变量和规则，你可以使用“make –p –f /dev/null”。
这个参数输出的信息会包含着你的makefile文件的文件名和行号，所以，用这个参数来调试
你的makefile会是很有用的，特别是当你的环境变量很复杂的时候。
“-q”
“--question”
不运行命令，也不输出。仅仅是检查所指定的目标是否需要更新。如果是0则说明要更新，
如果是2则说明有错误发生。
/2 
eetop公众号
创芯大讲堂
创芯人才网