[转]Makefile的常见错误信息

本章是对 make 执行过程中可能出现常见错误进行汇总、分析，并给出修正的可能方法。

make 执行过程中产生的错误并不是所有都是致命的；特别在命令行之前使用“ - ”、或者使用 make 的“ -k ”选项。 make 执行过程的致命错误都带有前缀字符串“ *** ”。

错误的信息都有前缀，一种是执行程序名作为错误的前缀（通常是“ make ”）；另外一种是当 Makefile 本身存在错误时，前缀包含了文件名和出现错误的行号。

在下述的错误列表中，省略了普通的前缀：

[FOO] Error NN

[FOO] signal description

这类错误并不是 make 的真正的错误。它表示 make 所调用的程序返回非零的错误码（ Error NN ），这种情况 make 会将其作为失败处理、或者以非正常方式退出（携带某种信号），参考 5.4 命令的错误 一节。

 

如果错误信息中没有附加“ *** ”字符串，则是子过程的调用失败，如果 Makefile 中此命令有前缀“ - ”， make 会忽略这个错误。

missing separator. Stop.

missing separator (did you mean TAB instead of 8 spaces?). Stop.

不可识别的命令行， make 在读取 Makefile 过程中不能解析其中包含的内容。 GNU make 在读取 Makefile 时根据各种分隔符（ :, =, [TAB] 字符等）识别 Makefile 的每一行内容。这些错误意味着 make 不能发现一个合法的分隔符。

 

出现这些错误信息的可能的原因是（或许是编辑器，绝大部分是 ms-windows 的编辑器）在 Makefile 中的命令之前使用了 4 个（或者 8 个）空格代替了 [Tab] 字符。这种情况，将产生上述的第二种形式产生错误信息。且记，所有的命令行都应该是以 [Tab] 字符开始的。

commands commence before first target. Stop.

missing rule before commands. Stop.

Makefile 可能是以命令行开始：以 [Tab] 字符开始，但不是一个合法的命令行（例如，一个变量的赋值）。命令行必须和规则一一对应。

 

产生第二种的错误的原因可能是一行的第一个非空字符为分号， make 会认为此处遗漏了规则的“ target: prerequisite ”部分。

No rule to make target `XXX'.

No rule to make target ` XXX ', needed by `yyy'.

无法为重建目标“ XXX ”找到合适的规则，包括明确规则和隐含规则。

 

修正这个错误的方法是：在 Makefile 中添加一个重建目标的规则。其它可能导致这些错误的原因是 Makefile 中文件名拼写错误，或者破坏了源文件树（一个文件不能被重建，可能是由于依赖文件的问题）。

No targets specified and no makefile found. Stop.

No targets. Stop.

第一个错误表示在命令行中没有指定需要重建的目标，并且 make 不能读入任何 makefile 文件。第二个错误表示能够找到 makefile 文件，但没有终极目标或者没有在命令行中指出需要重建的目标。这种情况下， make 什么也不做。

Makefile `XXX' was not found.

Included makefile `XXX' was not found.

没有使用“ -f ”指定 makefile 文件， make 不能在当前目录下找到默认 Makefile （ makefile 或者 GNUmakefile ）。使用“ -f ”指定文件，但不能读取这个指定的 makefile 文件。

warning: overriding commands for target `XXX'

warning: ignoring old commands for target `XXX'

对同一目标“ XXX ”存在一个以上的重建命令。 GNU make 规定：当同一个文件作为多个规则的目标时，只能有一个规则定义重建它的命令（双冒号规则除外）。如果为一个目标多次指定了相同或者不同的命令，就会产生第一个告警；第二个告警信息说新指定的命令覆盖了上一次指定的命令。

Circular XXX <- YYY dependency dropped.

规则的依赖关系产生了循环：目标“ XXX ”的依赖文件为“ YYY ”，而依赖“ YYY ”的依赖列表中又包含“ XXX ”。

Recursive variable `XXX' references itself (eventually). Stop.

make 的变量“ XXX ”（递归展开式）在替换展开时，引用它自身。无论对于直接展开式变量（通过 := 定义的）或追加定义（ += ），这都是不允许的。参考 第 5 章 使用变量

Unterminated variable reference. Stop.

变量或者函数引用语法不正确，没有使用完整的的括号（缺少一左括号或者右括号）。

insufficient arguments to function `XXX'. Stop.

函数“ XXX ”引用时参数数目不正确。函数缺少参数。

missing target pattern. Stop.

multiple target patterns. Stop.

target pattern contains no `%'. Stop.

mixed implicit and static pattern rules.  Stop.

不正确的静态模式规则。

第一条错误的原因是：静态模式规则的目标段中没有模式目标；

第二条错误的原因是：静态模式规则的目标段中存在多个模式目标；

第三条错误的原因是：静态模式规则的目标段目标模式中没有包含模式字符“ % ”；

第四条错误的原因是：静态模式规则的三部分都包含了模式字符“ % ”。正确的应该是只有后两个才可以包含模式字符“ % ”。

关于静态模式规则可参考 3.12 静态模式 一节

warning: -jN forced in submake: disabling jobserver mode.

这一条告警和下条告警信息发生在： make 检测到递归的 make 调用时，可通信的子 make 进程出现并行处理的错误（参考 5.6 make的递归执行 一节）。递归执行的 make 的命令行参数中存在“ -jN ”参数（ N 的值大于 1 ），在有些情况下可能导致此错误，例如： Makefile 中变量“ MAKE ”被赋值为“ make –j2” ，并且递归调用的命令行中使用变量“ MAKE ”。在这种情况下，被调用 make 进程不能和其它 make 进程进行通信，其只能简单的独立的并行处理两个任务”。

warning: jobserver unavailable: using -j1. Add `+' to parent make rule.

为了现实 make 进程之间的通信，上层 make 进程将传递信息给子 make 进程。在传递信息过程中可能存在这种情况，子 make 进程不是一个实际的 make 进程，而上层 make 却不能确定子进程是否是真实的 make 进程。它只是将所有信息传递下去。上层 make 采用正常的算法来决定这些（参考 5.6.1 变量 MAKE 一小节）。当出现这种情况，子进程只会接受父进程传递的部分有用的信息。子进程会产生该警告信息，之后按照其内建的顺序方式进行处理。

---

附录 ：关键字索引

GNU make 可识别的指示符：

define VARIABLE

endef                                      参考 6.8 多行定义 一节

---

ifdef VARIABLE

ifndef VARIABLE

ifeq (A,B)

ifeq "A" "B"

ifeq 'A' 'B'

ifneq (A,B)

ifneq "A" "B"

ifneq 'A' 'B'

else

endif                                         参考 7.2 条件判断的基本语法 一节

---

include FILE

-include FILE

sinclude FILE                         参考 3.3 包含其他 makefile文件 一节

---

override VARIABLE = VALUE

override VARIABLE := VALUE

override VARIABLE += VALUE

override VARIABLE ?= VALUE

override define VARIABLE

endef                                   参考 6.7 override指示符 一节

---

export

unexport VARIABLE              参考 5.6 make的递归执行 一节

---

vpath PATTERN PATH

vpath PATTERN

vpath                                      参考 4.12 目录搜索 一节

---

GNU make 函数 ：

subst

patsubst

strip

findstring

filter

filter-out

sort

word

words

wordlist

firstword                                 参考 8.2 文本处理函数 一节

---

dir

notdir

suffix

basename

addsuffix

addprefix

join      

wildcard                                  参考 8.3 文件名处理函数 一节

---

error                                     参考 8.11 make的控制函数 一节

warning                                   参考 8.11 make的控制函数 一节

shell                                     参考 8.10 shell函数 一节

origin                                   参考 8.9 origin函数 一节

foreach                                    参考 8.4 foreach函数 一节

call                                           参考 8.6 call函数 一节

if                                           参考 8.5 if函数 一节

eval                                          参考 8.8 eval函数 一节

value                                    参考 8.7 value函数 一节

---

GNU make 的自动化变量

$@

$%

$<

$?

$^

$+

$*

$(@D)

$(@F)

$(*D)

$(*F)

$(%D)

$(%F)

$(

$(

$(^D)

$(^F)

$(+D)

$(+F)

$(?D)

$(?F)                                   参考 10.5.3 自动化变量 一小节

---

GNU make 环境变量

MAKEFILES                          参考 3.4 变量 MAKEFILES 一节

MAKEFILES_LIST               参考 3.5 变量 MAKEFILE_LIST 一节

VPATH                                   参考 4.5.1 一般搜索 一小节

SHELL                                   参考 5.2 命令的执行 一节

MAKESHELL                        参考 5.2 命令的执行 一节

MAKE                                 参考 5.6 make的递归执行 一节

MAKELEVEL                        参考 5.6 make的递归执行 一节

MAKEFLAGS                       参考 5.6 make的递归执行 一节

MAKECMDGOALS              参考 9.2 指定终极目标 一节

CURDIR                                 参考 5.6 make的递归执行 一节

SUFFIXES                         参考 10.8 隐含规则的搜索算法 一节

.LIBPATTERNS                     参考 4.5.6 库文件和搜索目录 一小节