15 快速参考
这是对指令、文本操作函数以及GNU make能够理解的变量等的汇总。对于其他方面的总结参阅特殊的内建目标名，隐含规则目录，选项概要。
这里是GNU make是别的指令的总结：
define variable
endef
定义多行递归调用扩展型变量。参阅定义固定次序的命令。
ifdef variable
ifndef variable
ifeq (a,b)
ifeq "a" "b"
ifeq 'a' 'b'
ifneq (a,b)
ifneq "a" "b"
ifneq 'a' 'b'
else
endif
makefile文件中的条件扩展，参阅makefile文件中的条件语句。
include file
-include file
sinclude file
包含其它makefile文件，参阅包含其它makefile文件。
override variable = value
override variable := value
override variable += value
override variable ?= value
override define variable
endef
定义变量、对以前的定义重载、以及对在命令行中定义的变量重载。参阅override指令。
export
告诉make缺省向子过程输出所有变量，参阅与子make通讯的变量。
export variable
export variable = value
export variable := value
export variable += value
export variable ?= value
unexport variable
告诉make是否向子过程输出一个特殊的变量。参业与子make通讯的变量。
vpath pattern path
制定搜寻匹配‘%’格式的文件的路径。参阅vpath指令。
vpath pattern
去除以前为‘pattern’指定的所有搜寻路径。
vpath
去除以前用vpath指令指定的所有搜寻路径。
这里是操作文本函数的总结，参阅文本转换函数：
$(subst from,to,text)
在‘text’中用‘to’代替‘from’，参阅字符串替换与分析函数。
$(patsubst pattern,replacement,text)
在‘text’中用‘replacement’代替匹配‘pattern’字，参阅字符串替换与分析函数。
$(strip string)
从字符串中移去多余的空格。参阅字符串替换与分析函数。
$(findstring find,text)
确定‘find’在‘text’中的位置。参阅字符串替换与分析函数。
$(filter pattern...,text)
在‘text’中选择匹配‘pattern’的字。参阅字符串替换与分析函数。
$(filter-out pattern...,text)
在‘text’中选择不匹配‘pattern’的字。参阅字符串替换与分析函数。
$(sort list)
将‘list’中的字按字母顺序排序，并删除重复的字。参阅字符串替换与分析函数。
$(dir names...)
从文件名中抽取路径名。参阅文件名函数。
$(notdir names...)
从文件名中抽取路径部分。参阅文件名函数。
$(suffix names...)
从文件名中抽取非路径部分。参阅文件名函数。
$(basename names...)
从文件名中抽取基本文件名。参阅文件名函数。
$(addsuffix suffix,names...)
为‘names’中的每个字添加后缀。参阅文件名函数。
$(addprefix prefix,names...)
为‘names’中的每个字添加前缀。参阅文件名函数。
$(join list1,list2)
连接两个并行的字列表。参阅文件名函数。
$(word n,text)
从‘text’中抽取第n个字。参阅文件名函数。
$(words text)
计算‘text’中字的数目。参阅文件名函数。
$(wordlist s,e,text)
返回‘text’中s到e之间的字。参阅文件名函数。
$(firstword names...)
在‘names…’中的第一个字。参阅文件名函数。
$(wildcard pattern...)
寻找匹配shell文件名格式的文件名。参阅wildcard函数。
$(error text...)
该函数执行时，make产生信息为‘text’的致命错误。参阅控制make的函数。
$(warning text...)
该函数执行时，make产生信息为‘text’的警告。参阅控制make的函数。
$(shell command)
执行shell命令并返回它的输出。参阅函数shell。
$(origin variable)
返回make变量‘variable’的定义信息。参阅函数origin。
$(foreach var,words,text)
将列表列表words中的每一个字对应后接var中的每一个字，将结果放在text中。参阅函数foreach。
$(call var,param,...)
使用对$(1), $(2)...对变量计算变量 var ，变量$(1), $(2)...分别代替参数 param 第一个、第二个…的值。参阅函数call。
这里是对自动变量的总结，完整的描述参阅自动变量。
$@
目标文件名。
$%
当目标是档案成员时，表示目标成员名。
$<
第一个依赖名。
$?
所有比目标‘新’的依赖的名字，名字之间用空格隔开。对于为档案成员的依赖，只能使用命名的成员。参阅使用make更新档案文件。
$^
$+
所有依赖的名字，名字之间用空格隔开。对于为档案成员的依赖，只能使用命名的成员。参阅使用make更新档案文件。变量 $^ 省略了重复的依赖，而变量 $+ 则按照原来次序保留重复项，
$*
和隐含规则匹配的stem(径)。参阅格式匹配。
$(@D)
$(@F)
变量$@.中的路径部分和文件名部分。
$(*D)
$(*F)
变量$*中的路径部分和文件名部分。
$(%D)
$(%F)
变量$%中的路径部分和文件名部分。
$(
$(
变量$<中的路径部分和文件名部分。
$(^D)
$(^F)
变量$^中的路径部分和文件名部分。
$(+D)
$(+F)
变量$+中的路径部分和文件名部分。
$(?D)
$(?F)
变量$?中的路径部分和文件名部分。
以下是GNU make使用变量：
MAKEFILES
每次调用make要读入的Makefiles文件。参阅变量MAKEFILES。
VPATH
对在当前目录下不能找到的文件搜索的路径。参阅VPATH: 所有依赖的搜寻路径。
SHELL
系统缺省命令解释程序名，通常是`/bin/sh'。您可以在makefile文件中设值变量SHELL改变运行程序使用的shell。参阅执行命令。
MAKESHELL
改变量仅用于MS-DOS，make使用的命令解释程序名，该变量的值比变量SHELL的值优先。参阅执行命令。
MAKE
调用的make名。在命令行中使用该变量有特殊的意义。参阅变量MAKE的工作方式。
MAKELEVEL
递归调用的层数(子makes)。参阅与子make通讯的变量。
MAKEFLAGS
向make提供标志。您可以在环境或makefile文件中使用该变量设置标志。参阅与子make通讯的变量。在命令行中不能直接使用该变量，应为它的内容不能在shell中正确引用，但总是允许递归调用make时通过环境传递给子make。
MAKECMDGOALS
该目标是在命令行中提供给make的。设置该变量对make的行为没有任何影响。参阅特别目标的参数。
CURDIR
设置当前工作目录的路径名，参阅递归调用make。
SUFFIXES
在读入任何makefile文件之前的后缀列表。
.LIBPATTERNS
定义make搜寻的库文件名，以及搜寻次序。参阅连接库搜寻目录。
16 make产生的错误
这里是您可以看到的由make产生绝大多数普通错误列表，以及它们的含义和修正它们信息。
有时make产生的错误不是致命的，如一般在命令脚本行前面存在前缀的情况下，和在命令行使用选向‘-k’的情况下产生的错误几乎都不是致命错误。使用字符串***作前缀将产生致命的错误。
错误信息前面都使用前缀，前缀的内容是产生错误的程序名或makefile文件中存在错误的文件名和包含该错误的行的行号和。
在下述的错误列表中，省略了普通的前缀：
`[foo] Error NN'
`[foo] signal description'
这些错误并不是真的make的错误。它们意味着make调用的程序返回非零状态值，错误码（Error NN），这种情况make解释为失败，或非正常方式退出（一些类型信号），参阅命令错误。如果信息中没有附加***，则是子过程失败，但在makefile文件中的这条规则有特殊前缀，因此make忽略该错误。
`missing separator. Stop.'
`missing separator (did you mean TAB instead of 8 spaces?). Stop.'
这意味着make在读取命令行时遇到不能理解的内容。GNU make 检查各种分隔符(:, =, 字符TAB，等) 从而帮助确定它在命令行中遇到了什么类型的错误。这意味着，make不能发现一个合法的分隔符。出现该信息的最可能的原因是您（或许您的编辑器，绝大部分是ms-windows的编辑器）在命令行缩进使用了空格代替了字符Tab。这种情况下，make将使用上述的第二种形式产生错误信息。一定切记，任何命令行都以字符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'.'
这意味着make决定必须建立一个目标，但却不能在makefile文件中发现任何用于创建该目标的指令，包括具体规则和隐含规则。如果您希望创建该目标，您需要另外为改目标编写规则。其它关于该问题产生原因可能是makefile文件是草稿（如文件名错）或破坏了源文件树（一个文件不能按照计划重建，仅仅由于一个依赖的问题）。
`No targets specified and no makefile found. Stop.'
`No targets. Stop.'
前者意味着您没有为命令行提供要创建的目标，make不能读入任何makefile文件。后者意味着一些makefile文件被找到，但没有包含缺省目标以及命令行等。GNU make在这种情况下无事可做。参阅指定makefile文件的参数。
`Makefile `xxx' was not found.'
`Included makefile `xxx' was not found.'
在命令行中指定一个makefile文件（前者）或包含的makefile 文件（后者）没有找到。
`warning: overriding commands for target `xxx''
`warning: ignoring old commands for target `xxx''
GNU make允许命令在一个规则中只能对一个命令使用一次(双冒号规则除外)。如果您为一个目标指定一个命令，而该命令在目标定义是已经定义过，这种警告就会产生；第二个信息表明后来设置的命令将改写以前对该命令的设置。参阅具有多条规则的目标。
`Circular xxx <- yyy dependency dropped.'
这意味着make检测到一个相互依靠一个循环：在跟踪目标xxx的依赖yyy 时发现，依赖yyy的依赖中一个又以xxx为依赖。
`Recursive variable `xxx' references itself (eventually). Stop.'
这意味着您定义一个正常（递归调用性）make变量xxx，当它扩展时，它将引用它自身。无论对于简单扩展型变量(:=)或追加定义（+=），这也都是不能允许的，参阅使用变量。
`Unterminated variable reference. Stop.'
这意味着您在变量引用或函数调用时忘记写右括号。
`insufficient arguments to function `xxx'. Stop.'
这意味着您在调用函数是您密友提供需要数目的参数。关于函数参数的详细描述参阅文本转换函数。
`missing target pattern. Stop.'
`multiple target patterns. Stop.'
`target pattern contains no `%'. Stop.'
这些错误信息是畸形的静态格式规则引起的。第一条意味着在规则的目标部分没有规则，第二条意味着在目标部分有多个规则，第三条意味着没有包含格式符%。参阅静态格式规则语法。
`warning: -jN forced in submake: disabling jobserver mode.'
该条警告和下条警告是在make检测到在能与子make通讯的系统中包含并行处理的错误（参阅与子make通讯选项）。该警告信息是如果递归调用一个make过程，而且还使用了‘-jn’选项（这里n大于1）。这种情况很可能发生，例如，如果您设置环境变量MAKE为‘make –j2’。这种情况下，子make不能与其它make过程通讯， 而且还简单假装它由两个任务。
`warning: jobserver unavailable: using -j1. Add `+' to parent make rule.'
为了保证make过程之间通讯，父层make将传递信息给子make。这可能导致问题，因为子过程有可能不是实际的一个make，而父过程仅仅认为子过程是一个make而将所有信息传递给子过程。父过程是采用正常的算法决定这些的（参阅变量MAKE的工作方式）。如果makefile文件构建了这样的父过程，它并不知道子过程是否为make，那么，子过程将拒收那些没有用的信息。这种情况下，子过程就会产生该警告信息，然后按照它内建的次序方式进行处理。
17 复杂的makfile文件例子
这是一个用于GNU tar程序的makefile文件；这是一个中等复杂的makefile文件。
因为‘all’是第一个目标，所以它是缺省目标。该makefile文件一个有趣的地方是‘testpad.h'是由testpad程序创建的源文件，而且该程序自身由‘testpad.c'编译得到的。
如果您键入‘make'或`make all'，则make创建名为‘tar'可执行文件, 提供远程访问磁带的进程‘rmt'，和名为‘tar.info'的Info文件。
如果您键入‘make install'，则make不但创建‘tar',‘rmt',和‘tar.info'，而且安装它们。
如果您键入‘make clean', 则make删除所有‘.o'文件，以及‘tar',‘rmt',‘testpad', ‘testpad.h',和‘core’文件。
如果您键入‘make distclean', 则make不仅删除‘make clean'删除的所有文件，而且包括文件‘TAGS', ‘Makefile', 和‘config.status' 文件。(虽然不明显，但该 makefile (和‘config.status')是用户用configure程序产生的，该程序是由发布的tar文件提供，但这里不进行说明。)
如果您键入‘make realclean', 则make删除‘make distclean '删除的所有文件，而且包括由‘tar.texinfo'产生的Info文件。
另外，目标shar和dist创造了发布文件的核心。
# 自动从makefile.in产生
# 用于GNU tar 程序的Unix Makefile
# Copyright (C) 1991 Free Software Foundation, Inc.
# 本程序是自由软件；在遵照GNU条款的情况下
# 您可以重新发布它或更改它
# 普通公众许可证 ...
...
...
SHELL = /bin/sh
#### 启动系统配置部分 ####
srcdir = .
# 如果您使用gcc, 您应该在运行
# 和它一起创建的固定包含的脚本程序以及
# 使用-traditional选项运行gcc中间选择其一。
# 另外的ioctl调用在一些系统上不能正确编译
CC = gcc -O
YACC = bison -y
INSTALL = /usr/local/bin/install -c
INSTALLDATA = /usr/local/bin/install -c -m 644
# 您应该在DEFS中添加的内容：
# -DSTDC_HEADERS 如果您有标准C的头文件和
# 库文件。
# -DPOSIX 如果您有POSIX.1的头文件和
# 库文件。
# -DBSD42 如果您有sys/dir.h (除非
# 您使用-DPOSIX), sys/file.h,
# 和st_blocks在`struct stat'中。
# -DUSG 如果您有System V/ANSI C
# 字符串和内存控制函数
# 和头文件， sys/sysmacros.h,
# fcntl.h, getcwd, no valloc,
# 和 ndir.h (除非
# 您使用-DDIRENT)。
# -DNO_MEMORY_H 如果USG或STDC_HEADERS 但是不
# 包括memory.h.
# -DDIRENT 如果USG而且您又用dirent.h
# 代替ndir.h。
# -DSIGTYPE=int 如果您的信号控制器
# 返回int,非void.
# -DNO_MTIO 如果您缺少sys/mtio.h
# (magtape ioctls).
# -DNO_REMOTE 如果您没有一个远程shell
# 或rexec.
# -DUSE_REXEC 对远程磁带使用rexec
# 操作代替
# 分支rsh或remsh.
# -DVPRINTF_MISSING 如果您缺少函数vprintf
# (但是有_doprnt).
# -DDOPRNT_MISSING 如果您缺少函数 _doprnt.
# 同样需要定义
# -DVPRINTF_MISSING.
# -DFTIME_MISSING 如果您缺少系统调用ftime
# -DSTRSTR_MISSING 如果您缺少函数strstr。
# -DVALLOC_MISSING 如果您缺少函数valloc。
# -DMKDIR_MISSING 如果您缺少系统调用mkdir和
# rmdir。
# -DRENAME_MISSING 如果您缺少系统调用rename。
# -DFTRUNCATE_MISSING 如果您缺少系统调用ftruncate。
#
# -DV7 在Unix版本7 (没有
# 进行长期测试).
# -DEMUL_OPEN3 如果您缺少3-参数版本
# 的open, 并想通过您有的系统调用
# 仿真它。
# -DNO_OPEN3 如果您缺少3-参数版本的open
# 并要禁止tar –k选项
# 代替仿真open.
# -DXENIX 如果您有sys/inode.h
# 并需要它包含94
DEFS = -DSIGTYPE=int -DDIRENT -DSTRSTR_MISSING \
-DVPRINTF_MISSING -DBSD42
# 设置为rtapelib.o ，除非使它为空时
# 您定义了NO_REMOTE,
RTAPELIB = rtapelib.o
LIBS =
DEF_AR_FILE = /dev/rmt8
DEFBLOCKING = 20
CDEBUG = -g
CFLAGS = $(CDEBUG) -I. -I$(srcdir) $(DEFS) \
-DDEF_AR_FILE=\"$(DEF_AR_FILE)\" \
-DDEFBLOCKING=$(DEFBLOCKING)
LDFLAGS = -g
prefix = /usr/local
# 每一个安装程序的前缀。
#正常为空或`g'。
binprefix =
# 安装tar的路径
bindir = $(prefix)/bin
# 安装info文件的路径.
infodir = $(prefix)/info
#### 系统配置结束部分 ####
SRC1 = tar.c create.c extract.c buffer.c \
getoldopt.c update.c gnu.c mangle.c
SRC2 = version.c list.c names.c diffarch.c \
port.c wildmat.c getopt.c
SRC3 = getopt1.c regex.c getdate.y
SRCS = $(SRC1) $(SRC2) $(SRC3)
OBJ1 = tar.o create.o extract.o buffer.o \
getoldopt.o update.o gnu.o mangle.o
OBJ2 = version.o list.o names.o diffarch.o \
port.o wildmat.o getopt.o
OBJ3 = getopt1.o regex.o getdate.o $(RTAPELIB)
OBJS = $(OBJ1) $(OBJ2) $(OBJ3)
AUX = README COPYING ChangeLog Makefile.in \
makefile.pc configure configure.in \
tar.texinfo tar.info* texinfo.tex \
tar.h port.h open3.h getopt.h regex.h \
rmt.h rmt.c rtapelib.c alloca.c \
msd_dir.h msd_dir.c tcexparg.c \
level-0 level-1 backup-specs testpad.c
all: tar rmt tar.info
tar: $(OBJS)
$(CC) $(LDFLAGS) -o $@ $(OBJS) $(LIBS)
rmt: rmt.c
$(CC) $(CFLAGS) $(LDFLAGS) -o $@ rmt.c
tar.info: tar.texinfo
makeinfo tar.texinfo
install: all
$(INSTALL) tar $(bindir)/$(binprefix)tar
-test ! -f rmt || $(INSTALL) rmt /etc/rmt
$(INSTALLDATA) $(srcdir)/tar.info* $(infodir)
$(OBJS): tar.h port.h testpad.h
regex.o buffer.o tar.o: regex.h
# getdate.y 有8个变换/减少冲突。
testpad.h: testpad
./testpad
testpad: testpad.o
$(CC) -o $@ testpad.o
TAGS: $(SRCS)
etags $(SRCS)
clean:
rm -f *.o tar rmt testpad testpad.h core
distclean: clean
rm -f TAGS Makefile config.status
realclean: distclean
rm -f tar.info*
shar: $(SRCS) $(AUX)
shar $(SRCS) $(AUX) | compress \
> tar-`sed -e '/version_string/!d' \
-e 's/[^0-9.]*\([0-9.]*\).*/\1/' \
-e q
version.c`.shar.Z
dist: $(SRCS) $(AUX)
echo tar-`sed \
-e '/version_string/!d' \
-e 's/[^0-9.]*\([0-9.]*\).*/\1/' \
-e q
version.c` > .fname
-rm -rf `cat .fname`
mkdir `cat .fname`
ln $(SRCS) $(AUX) `cat .fname`
tar chZf `cat .fname`.tar.Z `cat .fname`
-rm -rf `cat .fname` .fname
tar.zoo: $(SRCS) $(AUX)
-rm -rf tmp.dir
-mkdir tmp.dir
-rm tar.zoo
for X in $(SRCS) $(AUX) do \
echo $$X \
sed 's/$$/^M/' $$X \
> tmp.dir/$$X done
cd tmp.dir zoo aM ../tar.zoo *
-rm -rf tmp.dir
脚注
(1)
为 MS-DOS 和 MS-Windows编译的GNU Make和将前缀定义为DJGPP树体系的根的行为相同。
(2)
在MS-DOS上, 当前工作目录的值是global, 因此改变它将影响这些系统中随后的命令行。
(3)
texi2dvi 使用TeX 进行真正的格式化工作. TeX没有和 Texinfo一块发布。
--------------------------------------------------------------------------------
本文档使用版本1.54的texi2html 翻译器于2000年7月19日产生。
本文档的版权所有，不允许用于任何商业行为。
名词翻译对照表
archive 档案
archive member targets 档案成员目标
arguments of functions 函数参数
automatic variables 自动变量
backslash (\) 反斜杠
basename 基本文件名
binary packages 二进制包
compatibility 兼容性
data base 数据库
default directries 缺省目录
default goal 缺省最终目标
defining variables verbatim 定义多行变量
directive 指令
dummy pattern rule 伪格式规则
echoing of commands 命令回显
editor 编辑器
empty commands 空命令
empty targets 空目标
environment 环境
explicit rule 具体规则
file name functions 文件名函数
file name suffix 文件名后缀
flags 标志
flavors of variables 变量的特色
functions 函数
goal 最终目标
implicit rule 隐含规则
incompatibilities 不兼容性
intermediate files 中间文件
match-anything rule 万用规则
options 选项
parallel execution 并行执行
pattern rule 格式规则
phony targets 假想目标
prefix 前缀
prerequisite 依赖
recompilation 重新编译
rule 规则
shell command shell命令
static pattern rule 静态格式规则
stem 径
sub-make 子make
subdirectories 子目录
suffix 后缀
suffix rule 后缀规则
switches 开关
target 目标
value 值
variable 变量
wildcard 通配符
word 字
| | |
