14.5 Makefile的标准目标名(转自make手册)

<老张>

普通会员

发贴: 459
积分: 0
来自:
注册日期: 2006-05-15
  发表时间： 2008-09-24 15:36:55  

--------------------------------------------------------------------------------
14.5 Makefile的标准目标名
所有 GNU 发布的软件包的 Makefile 中,必须包含以下这些目标:

all
此目标的动作是编译整个软件包。 “all”应该为Makefile的终极目标。该目标的
动作不重建任何文档(只编译所有的源代码,生成可执行程序) ;Info文件应该
作为发布文件的一部分,DVI文件只在明确指定的时候才应该被重建。
缺省情况下,对所有源程序的编译和连接应该使用选项“-g” ,是最终的可执行
程序中包含调试信息。当最终的可执行程序不需要包含调试信息时,可使用
“strip”去掉可执行程序中的调试符号以减小最终的程序大小。

install
此目标的动作是完成程序的编译并将最终的可执行程序、 库文件等拷贝到安装的
目录。 如果只是验证这些程序是否可被正确安装, 它的动作应该是一个测试安装
动作。
安装时一般不要对可执行程序进行strip(去掉可执行程序内部的调试信息) 。存
在另外一个目标“install-strip” ,它实现安装的同时完成对可执行程序strip。
保证目标“install”的动作不更改程序创建目录(builid目录)下的任何文件,对
这个目录下文件的修改(重建或者更新)是目标“all”所要定义的动作。
“install”目标定义的动作在安装目录不存在时,能够创建这些不存在的安装目
录。这些目录包括:变量“prefix”和“exec_prefix”指定的目录和所有必要的
子目录。完成此任务的方式可以使用下边介绍的“installdirs”目标。
在安装man文档的命令前使用“-”忽略这安装命令的错误,这样可以避免在没
有Unix man文档的系统上执行安装时出现错误。
安装Info文档的方法是使用变量 “INSTALL_DATA”将Info文档拷贝到 “$(infodir)”
目录下去(参考 14.4安装目录的变量 一节) ,如果存在“install-info”命令则执
行它。 “install-info”是一个编辑Info“dir”文件的程序,更新或者修改“info”
文档的入口和目录;它是Texinfo软件包的一部分。这里有一个安装Info文档的例
子:
$(DESTDIR)$(infodir)/foo.info: foo.info
$(POST_INSTALL)
# 可能在“.” (当前目录)存在一个新的文档,而不是“srcdir” 。
-if test -f foo.info; then d=.; \
else d=$(srcdir); fi; \
$(INSTALL_DATA) $$d/foo.info $(DESTDIR)$@; \
#如果 install-info 命令存在则运行它
# 使用“if”代替在命令行前的“-”
# 这样,就可以看到运行 install-info 产生的真正错误
# 我们使用“$(SHELL) -c”是因为在一些 shell 中
# 遇到未知的命令不会运行失败
if $(SHELL) -c 'install-info --version' \
>/dev/null 2>&1; then \
install-info --dir-file=$(DESTDIR)$(infodir)/dir \
$(DESTDIR)$(infodir)/foo.info; \
else true; fi
目标install的命令需要分为三类: 正常命令、 预安装命令和安装后命令。 参考 14.6
安装命令分类 一节

uninstall
删除所有已安装文件——由install创建的文件拷贝。规则所定义的命令不能修改
编译目录下的文件,仅仅是删除安装目录下的文件。像install目标的命令一样,
uninstall目标的命令也分为三类。参考 14.6 安装命令分类 一节

install-strip
和目标install的动作类似,但是install-strip指定的命令在安装时对可执行文件进
行strip(去掉程序内部的调试信息) 。它的定义如下:
install-strip:
$(MAKE) INSTALL_PROGRAM='$(INSTALL_PROGRAM) -s' install
如果软件包的存在安装脚本时,目标install-strip所定义的命令就不能是对目标
“install”的引用,它仅仅完成对可执行文件的strip。
“install-strip”不应该直接在build目录下对可执行文件进行strip,应该是对安装
目录下的可执行文件进行strip。就是说“install-strip”所定义的命令不能对build
目录下的文件产生影响。
一般不建议安装时对可执行文件进行strip,因为去掉可执行文件的调试信息后,
如果在程序中存在bug,就不能通过gdb对程序进行调试。

clean
清除当前目录下编译生成的所有文件, 这些文件在make过程中产生。 注意,clean
动作不能删除软件包的配置文件,同时也不能删除build时创建的那些文件(诸
如:目录、build生成的信息记录文件等) 。因为这些文件都是发布版本的一部分。
对于.dvi文件,当它不作为发布版本的一部分时,可以删除。

distclean
类似于目标clean, 但增加删除当前目录下的的配置文件、 build过程产生的文件。
目标“distclean”指定的删除命令应该删除软件包中所有非发布文件。

mostlyclean
类似于目标“clean” ,但是可保留一些编译生成的文件,避免在下次编译时对这
些文件重建。例如,对于gcc来说,此目标指定的命令不删除文件“libgcc.a” ,
因为在绝大多数情况下它都不需要重新编译。

maintainer-clean
此目标所定义的命令几乎会删除所有当前目录下能够由Makefile重建的文件。典
型的,包括目标“distclean”删除的文件、由Bison生成的.c源文件、tags记录
文件、Ifon文件等。但是有一个例外,就是执行“make maintainer-clean”不能
删除“configure”这个配置脚本文件,即使“configure”可以由Makefile生成。
因为“configure”是软件包的配置脚本。
目标“maintainer-clean”应该只能由维护软件包的用户使用,而不能被普通用
户使用。 因为它会删除一些软件包的发布文件, 而重建这些文件可能需要专门的
工具。因此我们在使用此目标是需要小心。
为了让用户能够在执行前得到提示,通常目标“maintainer-clean”的命令以下
两行为开始:
;
@echo“该命令用于维护此软件包的用户使用”
@echo“它删除的文件可能需要使用特殊的工具来重建。

TAGS
此目标所定义的命令完成对该程序的tags记录文件的更新。tags文件通常可被
编辑器作为符号记录文件,例如vim,Emacs等。

info
产生必要的Info文档。此目标应该按照如下书写:
info: foo.info
foo.info: foo.texi chap1.texi chap2.texi
$(MAKEINFO) $(srcdir)/foo.texi
必须在Makefile中定义变量“MAKEINFO” ,代表命令工具makeinfo,该工具是
发布软件Texinfo的一部分。
通常,GNU的发布程序会和Info文档会被一同创建,这意味着Info文档是在源文
件的目录下。用户在创建发布软件时,一般情况下,make不更新Info文档,因
为它们已经更新到最新了。

dvi
为所有的Texinfo文件创建对应的DVI文件。例如:
dvi: foo.dvi
foo.dvi: foo.texi chap1.texi chap2.texi
$(TEXI2DVI) $(srcdir)/foo.texi
必须在Makefile中定义变量“TEXI2DVI” 。它代表命令工具texi2dvi,该工具是发
布软件Texinfo一部分。
规则中也可以没有命令行,这样make程序会自动为它推导对应的命令。

dist
此目标指定的命令创建发布程序的tar文件。创建的tar文件应该是这个软件包的
目录,文件名中也可以包含版本号(就是说创建的tar文件在解包之后应该是一
个目录) 。例如,发布的gcc 1.40版的tar文件解包的目录为“gcc-1.40” 。
通常的做法是是创建一个空目录, 如使用ln或cp将所需要的文件加入到这个目录
中,之后对这个目录使用tar进行打包。打包之后的tar文件使用gzip压缩。例如,
实际的gcc 1.40版的发布文件叫“gcc-1.40.tar.gz” 。
目标“dist”的依赖文件为软件包中所有的非源代码的文件,因此在使用目标进
行发布软件打包压缩之前必须保证这些文件是最新的。

check
此目标指定的命令完成所有的自检功能。 在执行检查之前, 应确保所有程序已经
被创建,可以不安装。为了对它们进行测试,需要实现在程序没有安装的情况下
被执行的规则命令。

installcheck
执行安装检查。在执行安装检查之前,确保所有程序已经被创建并且被安装。需
要注意的是:安装目录“$(bindir)”是否在搜索路径中。

installdirs
使用目标“installdirs”创建安装目录以及它的子目录在很多场合是非常有用的。
脚本“mkinstalldirs”就是为了实现这个目的而编写的;发布的Texinfo软件包中
就包含了这个脚本文件。Makefile中的规则可以这样书写:
# 确保所有安装目录(例如 $(bindir))存在,如有必要则创建这些目录
installdirs: mkinstalldirs
$(srcdir)/mkinstalldirs $(bindir) $(datadir) \
$(libdir) $(infodir) \
$(mandir)
或者可以使用变量“DESTDIR” :
# 确保所有安装目录(例如 $(bindir))存在,如有必要则创建这些目录
installdirs: mkinstalldirs
$(srcdir)/mkinstalldirs \
$(DESTDIR)$(bindir) $(DESTDIR)$(datadir) \
$(DESTDIR)$(libdir) $(DESTDIR)$(infodir) \
$(DESTDIR)$(mandir)
该规则不能更改软件的编译目录,仅仅是创建程序的安装目录。

<---- 以上言论仅代表本人立场 ---->



__________________
你要想明白,
我喝的比较多!