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指向描述文件中第一个目标文件。
    make如何实现对源代码的操作是通过一个被称之为makefile的文件来完成的，在下面的小节里，主要向读者介绍一下makefile的相关知识。

makefile基本结构
GNU Make 的主要工作是读一个文本文件 makefile。makefile 是用bash语言写的，bash语言是很像BASIC语言的一种命令解释语言。这个文件里主要描述了有关哪些目标文件是从哪些依赖文件中产生的，是用何种命令来进行这个产生过程的。有了这些信息， make 会检查磁盘的文件，如果目标文件的日期(即该文件生成或最后修改的日期)至少比它的一个依赖文件日期早的话，make 就会执行相应的命令，以更新目标文件。
    makefile一般被称为“makefile”或“Makefile”。还可以在 make 的命令行中指定别的文件名。如果没有特别指定的话，make就会寻找“makefile”或“Makefile”，所以为了简单起见，建议读者使用这两名字。如果要使用其他文件作为 makefile，则可利用类似下面的 make 命令选项指定 makefile 文件：
　　$ make -f  makefilename
    一个 makefile 主要含有一系列的规则，如下：
    目标文件名 : 依赖文件名

(tab键)  命令
第一行称之为规则，第二行是执行规则的命令，必须要以tab键开始。
    下面举一个简单的makefile的例子。
executable : main.o io.o
     gcc main.o  io.o  -o executable
main.o : main.c  
     gcc -Wall -O -g  -c main.c -o main.o
io.o : io.c
     gcc -Wall -O -g  -c io.c -o io.o  

    这是一个最简单的 makefile，make从第一条规则开始，executable是makefile最终要生成的目标文件。给出的规则说明executable依赖于两个目标文件main.o和io.o，只要executable 比它依赖的文件中的任何一个旧的话，下一行的命令就会被执行。但是，在检查文件 main.o 和 io.o 的日期之前，它会往下查找那些把 main.o 或 io.o 做为目标文件的规则。make先找到了关于 main.o 的规则，该目标文件的依赖文件是main.c。makefile后面的文件中再也找不到生成这个依赖文件的规则了。此时，make开始检查磁盘上这个依赖文件的日期，如果这个文件的日期比main.o 日期新的话，那么这个规则下面的命令 gcc -c main.c –o main.o 就会执行，以更新文件 main.o 。同样make对文件io.o 做类似的检查，它的依赖文件是io.c，对io.o的处理和main.o类似。
    现在， 再回到第一个规则处，如果刚才两个规则中的任何一个被执行，最终的目标文件executable都需要重建(因为executable所依赖的其中一个 .o 文件就会比它新)，因此链接命令就会被执行。
    有了makefile，对任何一个源文件进行修改后，所有依赖于该文件的目标文件都会被重新编译(因为.o 文件依赖于.c 文件)，进而最终可执行文件会被重新链接(因为它所依赖的.o 文件被改变了)，再也不用手工去一个个修改了。

编写make
1、Makefile 宏定义

makefile 里的宏是大小写敏感的，一般都使用大写字母。它们几乎可以从任何地方被引用，可以代表很多类型，例如可以存储文件名列表，存储可执行文件名和编译器标志等。

要定义一个宏，在makefile中，任意一行的开始写下该宏名，后面跟一个等号，等号后面是要设定的这个宏的值。如果以后要引用到该宏时，使用 $ (宏名)，或者是${宏名}，注意宏名一定要写在圆或花括号之内。把上一小节所举的例子，用引入宏名的方法，可以写成下面的形式：

OBJS = main.o io.o
CC = gcc
CFLAGS = -Wall -O -g



executable: $(OBJS)
     $(CC) $(OBJS) -o executable

main.o : main.c

     $(CC) $(CFLAGS) -c main.c -o main.o



io.o : io.c

$(CC) $(CFLAGS) -c io.c -o io.o

在这个makefile中引入了三个宏定义，所以如果当这些宏中的某些值发生变化时，开发者只需在要修改的宏处，将其宏值修改为要求的值即可，makefile中用到这些宏的地方会自动变化。在make中还有一些已经定义好的内部变量，有几个较常用的变量是$@， $< ，$?，$*, $^ (注意：这些变量不需要括号括住)。

$@ 扩展为当前规则的目标文件名；

$< 扩展为当前规则依赖文件列表中的第一个依赖文件；

$? 扩展为所有的修改日期比当前规则的目标文件的创建日期更晚的依赖文件，该值只有在使用显式规则时才会被使用；

$* 扩展成当前规则中目标文件和依赖文件共享的文件名，不含扩展名；

$^ 扩展为整个依赖文件的列表(除掉了所有重复的文件名)。

利用这些变量，可以把上面的 makefile 写成：

OBJS = main.o io.o
CC = gcc
CFLAGS = -Wall -O -g



executable: $(OBJS)
     $(CC) $^ -o $@

main.o : main.c

     $(CC) $(CFLAGS) –c $< -o $@



io.o : io.c

$(CC) $(CFLAGS) -c  $< -o $@

可以将宏变量应用到其他许多地方，尤其是当把它们和函数混合使用的时候，正确使用宏，会给开发者带来极大的便利。

2、隐含规则

请注意，在上面的例子里，几个产生 .o文件的命令都是以.c 文件作为依赖文件产生 .o 目标(obj)文件，这是一个标准的生成目标文件的步骤。如果把生成main.o和io.o的规则从makefile中删除，make 会查找它的隐含规则，然后会找到一个适当的命令去执行。实际上make已经知道该如何生成这些目标文件，它使用变量 CC 做为编译器，并且传递宏 CFLAGS 给 C 编译器(CXXFLAGS用于 C++ 编译器)，CPPFLAGS(C预处理选项)， TARGET_ARCH (就目前例子而言，还不用考虑这个宏)，然后它加入开关选项 -c ，后面跟预定义宏 $<(第一个依赖文件名)，最后是开关项 -o，后跟预定义宏$@ (目标文件名)。一个Ｃ编译的具体命令将 会是：

$(CC) $(CFLAGS) $(CPPFLAGS) $(TARGET_ARCH) -c $< -o $@

在make 工具中所包含的这些内置的或隐含的规则，定义了如何从不同的依赖文件建立特定类型的目标。Unix系统通常支持一种基于文件扩展名即文件名后缀的隐含规则。这种后缀规则定义了如何将一个具有特定文件名后缀的文件(例如.c文件)，转换成为具有另一种文件名后缀的文件(例如.o文件)：

系统中默认的常用文件扩展名及其含义为：

.o 　目标文件
　　.c 　C源文件
　　.f 　FORTRAN源文件
　　.s 　汇编源文件
　　.y 　Yacc-C源语法
　　.l 　Lex源语法
    而GNU make 除了支持后缀规则外还支持另一种类型的隐含规则即模式规则。这种规则更加通用，因为可以利用模式规则定义更加复杂的依赖性规则。同时可用来定义目标和依赖文件之间的关系，例如下面的模式规则定义了如何将任意一个.c 文件转换为文件名相同的.o 文件：
　　%.o : %.c
　　 $(CC) $(CFLAGS) $(CPPFLAGS) -c -o $@ $<

3、伪目标

如果需要最终产生两个和更多的可执行文件，但这些文件是相互独立的，也就是说任何一个目标文件的重建，不会影响其他目标文件。此时，可以通过使用所谓的伪目标来达到这一目的。一个伪目标和一个真正的目标文件的唯一区别在于，这个目标文件本身并不存在。因此， make总是会假设它需要被生成，当make把该伪目标文件的所有依赖文件都更新后，就会执行它的规则里的命令行。

举一个简单的例子，如果makefile 开始处输入
all : executable1 executable2

这里 executable1和executable2是最终希望生成的两个可执行文件。 make 把这个 'all' 做为它的主要目标，每次执行时都会尝试把 'all' 更新。但是，由于这行规则里并没有命令来作用在一个叫 'all' 的实际文件上(事实上， all 也不会实际生成)，所以这个规则并不真的改变 'all' 的状态。可既然这个文件并不存在，所以 make 会尝试更新 all 规则，因此就检查它的依赖文件 executable1, exectable2 是否需要更新，如果需要，就把它们更新，从而达到生成两个目标文件的目的。 伪目标在makefile中广泛使用。

4、函数

makefile 里的函数跟它的宏很相似，在使用的时候，用一个 $ 符号开始后跟圆括号，在圆括号内包含函数名，空格后跟一系列由逗号分隔的参数。例如，在 GNU Make 里有一个名为 'wildcard' 的函 数，它只有一个参数，功能是展开成一列所有符合由其参数描述的文件名，文件间以空格间隔。可以像下面所示使用这个命令：
SOURCES = $(wildcard *.c)
这样会产生一个所有以 '.c' 结尾的文件的列表，然后存入变量 SOURCES 里。当然你不需要一定要把结果存入一个变量。
   另一个有用的函数是 patsubst (patten substitude, 匹配替换的缩写) 函数。它需要３个参数：第一个是一个需要匹配的模式，第二个表示用什么来替换它，第三个是一个需要被处理的由空格分隔的字列。例如，处理那个经过上面定义后的变量，
OBJS = $(patsubst %.c,%.o,$(SOURCES))
这个语句将处理所有在 SOURCES宏中的文件名后缀是 '.c'的文件 ，用 '.o' 把 '.c' 取代。注意这里的 % 符号是通配符，匹配一个或多个字符，它每次所匹配的字符串叫做一个‘柄’(stem) 。在第二个参数里，% 被解释成用第一参数所匹配的那个柄。

感兴趣的读者如果需要更进一步的了解，请参考GNU Make 手册。
7.2.2.3  makefile的一个具体例子

在这里给读者举一个简单的makefile的例子，通过对这个makefile的讲解，来巩固前面介绍的相关知识。

INCLUDES =-I/home/nie/mysrc/include  \

          -I/home/nie/mysrc/extern/include \

          -I/home/nie/mysrc/src \

          -I/home/nie/mysrc/libsrc \

          -I. \

          -I..

         

EXT_CC_OPTS = -DEXT_MODE

CPP_REQ_DEFINES = -DMODEL=tune1 -DRT -DNUMST=2 \

                  -DTID01EQ=1 -DNCSTATES=0  \

                  -DMT=0 -DHAVESTDIO

RTM_CC_OPTS = -DUSE_RTMODEL

CFLAGS = -O -g

CFLAGS += $(CPP_REQ_DEFINES)

CFLAGS += $(EXT_CC_OPTS)

CFLAGS +=$(RTM_CC_OPTS)

SRCS  = tune1.c   rt_sim.c rt_nonfinite.c  grt_main.c rt_logging.c \

            ext_svr.c updown.c ext_svr_transport.c ext_work.c

OBJS  = $(SRCS:.c=.o)

RM    =  rm –f

CC    = gcc

LD    = gcc

all: tune1

%.o : %.c

$(CC) -c -o $@ $(CFLAGS)  $(INCLUDES)   $<

tune1 : $(OBJS)   

$(LD) -o  $@  $(OBJS)  -lm

clean :

  $(RM)  $(OBJS)

在这个makefile中首先定义了十个宏：

' INCLUDES =-I …'(省略号代表-I后面的内容)，'-I dirname' 表示将dirname所指的目录加入到程序头文件目录列表中去，是在进行预处理过程中使用的参数；

' EXT_CC_OPTS = -DEXT_MODE ' 表示在程序中定义了宏EXT_MODE，等价于在源代码写入语句' #define EXT_MODE ' ；

接下来的两个宏定义CPP_REQ_DEFINES 和RTM_CC_OPTS起到和EXT_CC_OPTS类似的作用；

'CFLAGS =-O -g '是编译器的编译选项，表示在编译的过程中对代码进行基本优化，并产生能被GNU调试器(如gdb)使用的调试信息；

'CFLAGS += ' 表示对这个宏定义在原来的基础上增加新的内容；

' SRCS  = …'代表了所有要编译的源代码文件列表；

' OBJS  = $(SRCS:.c=.o)'表示把宏SRC所代表的所有以.c结尾的文件名用.o结尾的文件名替换，即表示各个源文件所对应的目标文件名；

' RM    = rm –f ' 表示删除命令，-f是强制删除选项，使用该符号，在对文件进行删除时，没有提示；

' CC = gcc '表示编译器是用gcc；

' LD= gcc' 表示链接命令是用gcc；

all和clean是两个伪目标，在使用make命令的时候，如果不指明目标文件名，则是以在makefile 中出现的第一个目标作为最终目标，所以如果键入命令make，则伪目标all被作为最终的目标而执行，由于这个文件并不存在，所以 make 会尝试更新 all 规则，因此就检查它的依赖文件 tune1 是否需要更新，如果需要，就把它更新，这样伪目标下面的两条规则就会被执行，从而生成可执行文件tune1。如果要执行删除命令，只需要键入命令make clean，就会把所有以.o结尾的中间文件删除。

另外，请读者注意在本makefile的例子中多次用到' \'，该符号用于在makefile中，如果一条语句过长时，可以用' \'放在这条语句的右边界，通过回车换行，使下面新一行的语句成为该语句的续行。

在makefile文件中，用符号' #'作为注释行语句的开始，以增强makefile文件的可读性。

本例假设makefile文件名为makefile，当然也可按照个人的喜好取其他文件名，如果文件名不是makefile，Makefile的话，在用make命令是，请使用make –f  makefilename。

到此，希望读者能够掌握make 和makefile的基本使用。