makefile 参数

GNU Make

make是负责从项目的源代码中生成最终可执行文件和其他非源代码文件的工具。 make命令本身可带有四种参数：标志、宏定义、描述文件名和目标文件名。

其标准形式为：make [flags] [macro definitions] [targets]

Unix系统下标志位flags选项及其含义为：
-f file 指定file文件为描述文件，如果 file参数为 '-' 符，那么描述文件指向标准输入。如果没有 '-f' 参数，则系统将默认当前目录下名为makefile或者名为Makefile的文件为描述文件。在Linux中， GNU make 工具在当前工作目录中按照GNUmakefile、makefile、Makefile的顺序搜索 makefile文件。
-i 忽略命令执行返回的出错信息。
-s 沉默模式，在执行之前不输出相应的命令行信息。
-r 禁止使用隐含规则。

-n 非执行模式，输出所有执行命令，但并不执行。
-t 更新目标文件。
-q make操作将根据目标文件是否已经更新返回"0"或非"0"的状态信息。
-p 输出所有宏定义和目标文件描述。
-d Debug模式，输出有关文件和检测时间的详细信息。

Linux下make标志位的常用选项与Unix系统中稍有不同，下面只列出了不同部分：
-c dir 在读取 makefile 之前改变到指定的目录dir。
-I dir 当包含其他 makefile文件时，利用该选项指定搜索目录。
-h help文挡，显示所有的make选项。
-w 在处理 makefile 之前和之后，都显示工作目录。
通过命令行参数中的target ，可指定make要编译的目标，并且允许同时定义编译多个目标，操作时按照从左向右的顺序依次编译target选项中指定的目标文件。如果命令行中没有指定目标，则系统默认target指向描述文件中第一个目标文件。

2.1 make macro definitions

makefile如下：

　　LIBES= -LS

# use macros rewrite makefile ..

prog: $(OBJECTS)

cc $(OBJECTS) $(LIBES) -o prog

此时假如执行不带参数的make命令，将连接三个目标文档和库文档LS；但是假如在make命令后带有新的宏定义：

make "LIBES= -LL -LS"

则命令行后面的宏定义将覆盖makefile文档中的宏定义。若LL也是库文档，此时make命令将连接三个目标文档连同两个库文档LS和LL。

make local_all  "SW=SWM_DEBUG"

2.2  追加宏定义

c file:

#ifdef  SWM_DEBUG
Tracker->Debug( "%s:%d:%s, none do  iiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXxiiiiiiiiiiiiiiiiiiiiiii\n",__FILE__, __LINE__,__FUNCTION__ );
#endif

Makefile file:

CPPFLAGS += -DDEBUG_MEMORY

CPPFLAGS += -DDEBUG_CLASS_NAMES

make 命令：

make local_all  "CPPFLAGS += -DSWM_DEBUG"

通常我们需要看看自己的编写的makefile是否有错误，命令是否正确，执行顺序是否使我们期望的方式，这里就需要使用makefile的参数。

-n
--just-print
--dry-run
--recon
不执行参数，这些参数只是打印命令，不管目标是否更新，把规则和连带规则的命令打印出来，但不执行。

-t
--touch
这个参数的意思就是把目标文件的时间更新，但不更改目标文件。也就是说，make假装编译没标，但不是真正的编译目标，只是把目标变成已经编译的状态。

-q
--question
这个参数的行为是找目标的意思，也就是说，如果目标存在，那么其他什么也不会输出，当然也不会执行编译，如果目标不存在，则会打印出一条出错信息

-W <file>
--waht-if=<file>
--assume-new=<file>
--new-file=<file>
这个参数需要指定一个文件。一般是源文件（或依赖文件），make会根据规则推导来运行依赖于这个文件的命令，一般来说，可以和“-n”参数一同使用，来查看这个依赖文件锁发生的规则命令。

-b
-m
这两个参数的作用是忽略和其他版本make的兼容性

-B
--always-make
认为所有的目标都需要重新更新（重编译）

-C <dir>
--directory=<dir>
指定读取makefile的目录。如果有多个-C参数，make的解释是后面的路径以前面的作为相对路径，并以最后的目录作为被指定目录。如："make -C ~/test -C prog"等价于"make -C ~/test/prog"

-d
--debug[=<options>]
输出make的调试信息。它有几种不同的级别可供选择，如果没有参数，那就是输出最简单的调试信息，下面是<option>的取值：
a ----- 也就是all，输出所有的调试信息
b ----- basic，值输出简单的调试信息。即输出不需要重编译的目标
v ----- verbose，在b选项的级别之上。输出的信息包括哪个makefile被解析，不需要被重编译的依赖文件（或是依赖目标）等
i ----- implicit，输出所有的隐含规则
j ----- jobs，输出执行规则中命令的详细信息，如命令的PID，返回码等
m ----- makefile，输出make读取makefile，更新makefile，执行makefile的信息

-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”才是有效的。

-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发现有未定义的变量，那么就输出警告信息