Autoconf
Creating Automatic Configuration Scripts
Edition 2.13, for Autoconf version 2.13
December 1998
by David MacKenzie and Ben Elliston
--------------------------------------------------------------------------------
Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Free Software Foundation.
只要版权声明和本许可声明保留在全部副本中,您就被受权制做和发行本手册的原文副本。 中国网管论坛bbs.bitsCN.com
只要整个最终派生工做按照与本手册相同的许可声明发行,您就被受权按照与发行原文相同的条件复制和发行本手册的修改版本。
除了本许可声明应该使用由基金会批准的译文以外,您被受权按照与上述修改版本相同的条件复制和发行本手册的其它语言的译文。
--------------------------------------------------------------------------------
本文档由王立翻译。 1999.12.16
译者在此声明:不对任何由译文错误或者对译文的误解承担任何责任。
--------------------------------------------------------------------------------
介绍
A physicist, an engineer, and a computer scientist were
discussing the nature of God.?Surely a Physicist, said the
physicist, because early in the Creation, God made Light; and you
know, Maxwell's equations, the dual nature of electro-magnetic
waves, the relativist consequences... An Engineer!, said the
engineer, because before making Light, God split the Chaos into
Land and Water; it takes a hell of an engineer to handle that big
网管联盟bitsCN_com
amount of mud, and orderly separation of solids from
liquids... The computer scientist shouted: And the Chaos,
where do you think it was coming from, hmm?
---Anonymous
Autoconf是一个用于生成能够自动地配置软件源代码包以适应多种Unix类系统的 shell脚本的工具。由Autoconf生成的配置脚本在运行的时候与Autoconf是无关的,就是说配置脚本的用户并不须要拥有Autoconf。
由Autoconf生成的配置脚本在运行的时候不须要用户的手工干预;一般它们甚至不须要经过给出参数以肯定系统的类型。相反,它们对软件包可能须要的各类特征进行独立的测试。(在每一个测试以前,它们打印一个单行的消息以说明它们正在进行的检测,以使得用户不会由于等待脚本执行完毕而焦躁。)所以,它们在混合系统或者从各类常见Unix变种定制而成的系统中工做的很好。没有必要维护文件以储存由各个Unix变种、各个发行版本所支持的特征的列表。
对于每一个使用了Autoconf的软件包,Autoconf从一个列举了该软件包须要的,或者可使用的系统特征的列表的模板文件中生成配置脚本。在shell代码识别并响应了一个被列出的系统特征以后,Autoconf容许多个可能使用(或者须要)该特征的软件包共享该特征。若是后来由于某些缘由须要调整shell代码,就只要在一个地方进行修改;全部的配置脚本都将被自动地从新生成以使用更新了的代码。 网管网www_bitscn_com
Metaconfig包在目的上与Autoconf很类似,但它生成的脚本须要用户的手工干预,在配置一个大的源代码树的时候这是十分不方便的。不象Metaconfig脚本,若是在编写脚本时当心谨慎, Autoconf能够支持交叉编译(cross-compiling)。
Autoconf目前还不能完成几项使软件包可移植的工做。其中包括为全部标准的目标自动建立`Makefile'文件,包括在缺乏标准库函数和头文件的系统上提供替代品。目前正在为在未来添加这些特征而工做。
对于在C程序中的#ifdef中使用的宏的名字,Autoconf施加了一些限制(参见预处理器符号索引)。
Autoconf须要GNU m4以便于生成脚本。它使用了某些UNIX版本的m4 所不支持的特征。它还会超出包括GNU m4 1.0在内的某些m4版本的内部限制。你必须使用GNU m4的1.1版或者更新的版本。使用1.3版或者更新的版本将比1.1 或1.2版快许多。
关于从版本1中升级的详情,参见从版本1中升级。关于Autoconf的开发历史,参见Autoconf的历史。对与Autoconf有关的常见问题的回答,参见关于Autoconf的问题。
把关于Autoconf的建议和bug报告发送到
bug-gnu-utils@prep.ai.mit.edu。请把你经过运行`autoconf --version'而得到的Autoconf的版本号包括在内。
网管联盟bitsCN_com
建立configure脚本
由Autoconf生成的配置脚本一般被称为configure。在运行的时候,configure 建立一些文件,在这些文件中以适当的值替换配置参数。由configure建立的文件有:
一个或者多个`Makefile'文件,在包的每一个子目录中都有一个(参见 Makefile中的替换);
有时建立一个C头文件,它的名字能够被配置,该头文件包含一些#define命令(参见配置头文件);
一个名为`config.status'的shell脚本,在运行时,它将从新建立上述文件。(参见从新建立一个配置);
一个名为`config.cache'的shell脚本,它储存了许多测试的运行结果(参见缓存文件);
一个名为`config.log'的文件,它包含了由编译器生成的许多消息,以便于在configure出现错误时进行调试。
为了使用Autoconf建立一个configure脚本,你须要编写一个Autoconf的输入文件 `configure.in'而且对它运行autoconf。若是你自行编写了特征测试以补充 Autoconf所提供的测试,你可能还要编写一个名为`aclocal.m4'的文件和一个名为 `acsite.m4'的文件。若是你使用了包含#define指令的C头文件,你可能还要编写`acconfig.h',而且你须要与软件包一同发布由Autoconf生成的文件 `config.h.in'。
网管bitscn_com
下面是一个说明了在配置中使用的文件是如何生成的图。运行的程序都标之后缀`*'。可能出现的文件被方括号(`[]')括起来。autoconf和autoheader 还读取安装了的Autoconf宏文件(经过读取`autoconf.m4')。
在准备发布软件包的过程当中使用的文件:
你的源文件 --> [autoscan*] --> [configure.scan] --> configure.in
configure.in --.? .------> autoconf* -----> configure
??????? +---+
[aclocal.m4] --+? `---.
[acsite.m4] ---'??? |
??????????? +--> [autoheader*] -> [config.h.in]
[acconfig.h] ----.?? |
???????? +-----'
[config.h.top] --+
[config.h.bot] --'
Makefile.in -------------------------------> Makefile.in
在配置软件包的过程当中使用的文件:
??????????? .-------------> config.cache
configure* ------------+-------------> config.log
??????????? |
[config.h.in] -.??? v??????.-> [config.h] -.
网管论坛bbs_bitsCN_com
??????? +--> config.status* -+??????? +--> make*
Makefile.in ---'??????????`-> Makefile ---'
编写`configure.in'
为了为软件包建立configure脚本,须要编写一个名为`configure.in' 的文件,该文件包含了对那些你的软件包须要或者可使用的系统特征进行测试的Autoconf宏的调用。现有的Autoconf宏能够检测许多特征; 对于它们的描述能够参见现有的测试。对于大部分其余特征,你可使用Autconf模板宏以建立定制的测试;关于它们的详情,参见 编写测试。对于特别古怪或者特殊的特征,`configure.in' 可能须要包含一些手工编写的shell命令。程序autoscan能够为你编写`configure.in' 开个好头(详情请参见用autoscan建立`configure.in')。
除了少数特殊状况以外,在`configure.in'中调用Autoconf宏的顺序并不重要。在每一个`configure.in'中,必须在进行任何测试之间包含一个对AC_INIT的调用,而且在结尾处包含一个对AC_OUTPUT的调用(参见建立输出文件)。此外,有些宏要求其余的宏在它们以前被调用,这是由于它们经过检查某些变量在前面设定的值以决定做些什么。这些宏在独立的说明中给出(参见现有的测试),并且若是没有按照顺序调用宏,在生成configure时会向你发出警告。 网管朋友网www_bitscn_net
为了提升一致性,下面是调用Autoconf宏的推荐顺序。一般,在本列表中靠后的项目依赖于表中靠前的项目。例如,库函数可能受到typedefs和库的影响。
AC_INIT(file)
checks for programs
checks for libraries
checks for header files
checks for typedefs
checks for structures
checks for compiler characteris 【转自
www.bitsCN.com】
阅读(372) | 评论(0) | 转发(0) |