makefile 笔记2

8 make的运行
     8.1 make的退出码
       0 —— 表示成功执行。
            1 —— 如果make运行时出现任何错误，其返回1。
            2 —— 如果你使用了make的“-q”选项，并且make使得一些目标不需要更新，那么返回2。
        8.2 指定makefile文件 -f 或 --file 或 --makefile
            make –f hchen.mk
        8.3 指定目标
          “all”
             这个伪目标是所有目标的目标，其功能一般是编译所有的目标。
          “clean”
             这个伪目标功能是删除所有被make创建的文件。
          “install”
             这个伪目标功能是安装已编译好的程序，其实就是把目标执行文件拷贝到指定的目标中去。
          “print”
             这个伪目标的功能是例出改变过的源文件。
          “tar”
             这个伪目标功能是把源程序打包备份。也就是一个tar文件。
          “dist”
             这个伪目标功能是创建一个压缩文件，一般是把tar文件压成Z文件。或是gz文件。
          “TAGS”
             这个伪目标功能是更新所有的目标，以备完整地重编译使用。
          “check”和“test”
             这两个伪目标一般用来测试makefile的流程。
     8.4 检查规则
       有时候，我们不想让我们的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”参数一同使用，来查看这个依赖文件
         所发生的规则命令。
     8.5 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发现有未定义的变量，那么就输出警告信息。

9.隐含规则
    9.1 使用隐含规则
    9.2 隐含规则一览
      make 内建的隐含规则,不明确的写下规则,make就会在这些规则中寻找需要的规则和命令.
      除非用make的-r或--no-buildin-rule来取消所用预置的隐含规则
      1、编译C程序的隐含规则。
      “<n>.o”的目标的依赖目标会自动推导为“<n>.c”，并且其生成命令是
       “$(CC) –c $(CPPFLAGS) $(CFLAGS)”
      2、编译C++程序的隐含规则。
       “<n>.o”的目标的依赖目标会自动推导为“<n>.cc”或是“<n>.C”，并且其生成命令是
       “$(CXX) –c $(CPPFLAGS) $(CFLAGS)”。（建议使用“.cc”作为C++源文件的后缀，而不是“.C”）
      7、汇编和汇编预处理的隐含规则。
       “<n>.o” 的目标的依赖目标会自动推导为“<n>.s”，默认使用编译品“as”，并且其生成命令是：
       “$(AS) $(ASFLAGS)”。
       “<n>.s” 的目标的依赖目标会自动推导为“<n>.S”，默认使用C预编译器“cpp”，并且其生成命令是：
       “$(AS) $(ASFLAGS)”。

      8、链接Object文件的隐含规则。
       “<n>”目标依赖于“<n>.o”，通过运行C的编译器来运行链接程序生成（一般是“ld”），其生成命令是：
       “$(CC) $(LDFLAGS) <n>.o $(LOADLIBES) $(LDLIBS)”。
    9.3 隐含规则中使用的变量
      在隐含规则中的命令中，基本上都是使用了一些预先设置的变量。你可以在你的makefile中改变这些变量的值，
      或是在make的命令行中传入这些值，或是在你的环境变量中设置这些值，无论怎么样，只要设置了这些特定的变量，
      那么其就会对隐含规则起作用,当然，你也可以利用make的“-R”或“--no–builtin-variables”参数来取消
      你所定义的变量对隐含规则的作用。

      1、关于命令的变量。

      AR
          函数库打包程序。默认命令是“ar”。
      AS
          汇编语言编译程序。默认命令是“as”。
      CC
          C语言编译程序。默认命令是“cc”。
      CXX
          C++语言编译程序。默认命令是“g++”。
      CPP
          C程序的预处理器（输出是标准输出设备）。默认命令是“$(CC) –E”。
          转换C Web 到 C。默认命令是“ctangle”。
      RM
          删除文件命令。默认命令是“rm –f”。

      2、关于命令参数的变量

      下面的这些变量都是相关上面的命令的参数。如果没有指明其默认值，那么其默认值都是空。

      ARFLAGS
          函数库打包程序AR命令的参数。默认值是“rv”。
      ASFLAGS
          汇编语言编译器参数。（当明显地调用“.s”或“.S”文件时）。
      CFLAGS
          C语言编译器参数。
      CXXFLAGS
          C++语言编译器参数。
      CPPFLAGS
          C预处理器参数。（ C 和 Fortran 编译器也会用到）。
      LDFLAGS
          链接器参数。（如：“ld”）

    9.4 隐含规则链
    9.5 定义模式规则
      9.5.1 模式规则介绍
         规则的目标定义中包含%,代表任意非空字符串.
         目标的%决定了依赖的%
      9.5.2 示例
          %.o : %.c
              $(CC) -c $(CFLAGS) $(CPPFLAGS) $< -o $@

              $<目标依赖集, $@目标集
          9.5.3 自动化变量
            $@目标文件集,
            $%当目标是函数库文件时,表规则中的目标成员名
            $< 依赖目标中的第一个目标名字。如果依赖目标是以模式（即"%"）定义的，那么"$<"将是符合模式的一系列的文件集
            $?    所有比目标新的依赖目标的集合。以空格分隔
            $^    所有的依赖目标的集合。以空格分隔。如果在依赖目标中有多个重复的，那个这个变量会去除重复的依赖目标
            $+    这个变量很像"$^"，也是所有依赖目标的集合。只是它不去除重复的依赖目标
            $*    这个变量表示目标模式中"%"及其之前的部分
            四个变量（$@、$<、$%、$*）在扩展时只会有一个文件，而另三个的值是一个文件列表
            这七个自动化变量还可以取得文件的目录名或是在当前目录下的符合模式的文件名，只需要搭配上"D"或"F"字样
          9.5.5
            5、重载内建隐含规则

        你可以重载内建的隐含规则（或是定义一个全新的），例如你可以重新构造和内建隐含规则不同的命令，如：

            %.o : %.c
                    $(CC) -c $(CPPFLAGS) $(CFLAGS) -D$(date)

        你可以取消内建的隐含规则，只要不在后面写命令就行。如：

            %.o : %.s

        同样，你也可以重新定义一个全新的隐含规则，其在隐含规则中的位置取决于你在哪里写下这个规则。朝前的位置就靠前。

      9.5.6 隐含规则搜索算法
10 使用make更新函数库文件
    10.1函数库文件成员
      一个函数库文件由多个文件组成。你可以以如下格式指定函数库文件及其组成：

          archive(member)

      这个不是一个命令，而一个目标和依赖的定义。一般来说，这种用法基本上就是为了"ar"命令来服务的。如：

          foolib(hack.o) : hack.o
                  ar cr foolib hack.o

      如果要指定多个member，那就以空格分开，如：

          foolib(hack.o kludge.o)

      其等价于：

          foolib(hack.o) foolib(kludge.o)

      你还可以使用Shell的文件通配符来定义，如：

          foolib(*.o)
    10.2 函数库文件成员的隐含规则
    10.3函数库文件的后缀规则