Configure文件学习

Linux安装软件有一种方式就是通过源码安装,源码通常是一个压缩包,打开压缩包,经常会看到一个叫configure的文件,而不见makefile文件。通常我们在自己的电脑写应用的时候都是通过makefile来生成可执行的文件,但是为什么源码里面没有呢。实际上,编译器在开始工作前要知道当前的系统环境,比如安装的位置要在哪里、要依赖什么组件等等,由于每台电脑的环境不一样,可以通过configure配置文件指定编译参数。运行这个脚本就可以获知编译参数,编译器就可以灵活地实现针对你个人电脑的“私人定制”,这也是linux源码安装的一个优势。用户也可以自定义参数,比如假设我们要自定义安装目录,可以./configure  --prefix=/usr/local/apache2。又比如假如要动态库和静态库一起编译,使用./config shared --prefix=/usr/local --openssldir=/usr/local/ssl,假如我们要加入一些模块支持(如mysql),使用

./configure --prefix=/www --with-mysql

configure通常是由autoconf这个工具生成的,下载:

sudo  apt-get  install  autoconf

autoconf:只是autotools系列工具中的一个,运行之后可对configure.in脚本配置文件进行处理进而生成configure可执行文件,其他还包括了-----

aclocal:生成一个名称为aclocal.m4的用于处理本地宏定义的文件

autoscan:在给定目录以及其子目录树中检测源文件,若没有给定目录,就是在当前目录及其子目录树中检查。
autoheader:负责生成config.in文件,该工具通常从“acconfig.h”文件中复制用户附加的符号定义。
automake:它要用到的脚本配置文件是makefile.am,用户需要自己创建相应的文件,然后利用automake工具转换成makefile.in,此时运行configure自动配置设置文件就可将该.in文件生成makefile文件

网上摘取的一种图,解释了这套工具的工作流程:

这里写图片描述

运行autoscan,它会自动搜寻指定目录(默认是当前或者当前目录的子目录)的源文件,并且创建configure.scan文件

autoscan会尝试读入”configure.ac”(同configure.in的配置文件)文件,此时没有创建该配置文件,于是它会自动生成“configure.in”的原型文件“configure.scan”,该文件和源文件是在同一个目录下的,用户可以通过cat命令查看:

AC_PREREQ(2.61)
AC_INIT(hello, 1.0)
AM_INIT_AUTOMAKE(hello, 1.0)
AC_CONFIG_SRCDIR([hello.c])
AC_CONFIG_HEADER([config.h])
# Checks for programs.
AC_PROG_CC
# Checks for libraries.
# Checks for header files.
AC_CHECK_HEADERS([sys/time.h])
# Checks for typedefs, structures, and compiler characteristics.
AC_HEADER_TIME
# Checks for library functions.
AC_CHECK_FUNCS([gettimeofday])
AC_CONFIG_FILES([Makefile])
AC_OUTPUT

解释-----

AC_PREREQ:这个宏用于声明本文件要求的autoconf版本

AC_INIT:总是configure.in中的第一个宏,可以拓展为许多可由其他configure脚本共享的模板文件代码,这些代码解析传到configure的命令行参数。这个宏的一个参数是一个文件名,这个文件应该在源代码目录中,用于健全性检查,以保证configure脚本已正确定位源文件目录

AM_INIT_AUTOMAKE:automake必备的宏,使automake自动生成Makefile

AC_CONFIG_SRCDIR:检查所指定的源文件是否存在,以及源代码目录的有效性。

AC_CHECK_HEADERS:用于生产config.h文件供autoheader使用

AC_CONFIG_FILES:用于生成相应的Makefile

AC_PROG_CC:使配置脚本搜索C编译器并使用其名称定义变量CC。 Automake生成的src / Makefile.in文件使用变量CC构建hello,因此当配置从src / Makefile.in创建src / Makefile时,它将使用它找到的值定义CC。如果要求Automake创建一个使用CC的Makefile.in,但是configure.ac没有定义它,它会建议你添加一个调用AC_PROG_CC

AC_OUTPUT:是一个关闭命令,实际上产生脚本的一部分,负责创建用AC_CONFIG_HEADERS和AC_CONFIG_FILES注册的文件

AC_CHECK_FUNCS:检查C标准库中是否存在函数。 如果找到,则定义预处理器宏HAVE_ [function]。它生成一个测试程序,声明一个具有相同名称的函数,然后编译并链接它。更改函数名称中的几个字符(使测试失败)并检查config.log,当测试程序失败时,您将看到测试程序的源代码。假如缺失这个宏,会遇到下面的警告:

configure.ac: warning: missing AC_CHECK_FUNCS(gettimeofday)

这是autoscan告诉你,因为gettimeofday是一个潜在的可移植性问题,你应该有一个配置检查它。所以你需要做的是添加 AC_CHECK_FUNCS(gettimeofday) 配置.ac,重新运行autoreconf,然后装饰你的C代码 #ifdef HAVE_GETTIMEOFDAY ,这是一般的过程

AC_HEADER_TIME:这个不是必要宏,当源代码中有依赖于time.h和sys/time.h时,则定义TIME_WITH_SYS_TIME,这个宏在使用例如struct timeval和struct  tm的程序中很有用,它最好结合HAVE_SYS_TIME_H一起使用,可以使用AC_CHECK_HEADERS检查它

你的c程序就可以添加下面的一段:
#if TIME_WITH_SYS_TIME
# include <sys/time.h>
# include <time.h>
#else
# if HAVE_SYS_TIME_H
#  include <sys/time.h>
# else
#  include <time.h>
# endif
#endif

环境:ubuntu14.04

编辑一个文件,命名为hello.c

#include<stdio.h>

#include<sys/time.h>

int main(int argc,char *argv)

{

float sec;

struct timeval time;

gettimeofday(&time,NULL);

sec=time.tv_sec;

sec+=time.tv_usec/1000000.0;

printf("hello-world sec=%e ",sec);

return 0;

}

执行autoscan(如果是sudo权限执行新生成的两个文件所有者和所属组都是root,不能编辑),生成两个文件:

image

其中autoscan.log显示一个宏被请求的信息日志

configure.scan原文件内容:

#                                               -*- Autoconf -*-

# Process this file with autoconf to produce a configure script.

AC_PREREQ([2.69])

AC_INIT([FULL-PACKAGE-NAME], [VERSION], [BUG-REPORT-ADDRESS])

AC_CONFIG_SRCDIR([hello.c])

AC_CONFIG_HEADERS([config.h])

# Checks for programs.

AC_PROG_CC

# Checks for libraries.

# Checks for header files.

AC_CHECK_HEADERS([sys/time.h])

# Checks for typedefs, structures, and compiler characteristics.

# Checks for library functions.

AC_CHECK_FUNCS([gettimeofday])

AC_OUTPUT

修改一下

红色部分改为AC_INIT(hello, 1.0)

并且在AC_CONFIG_SRCDIR([hello.c])之后加上
AM_INIT_AUTOMAKE(hello, 1.0)

AC_OUTPUT之前加上

AC_CONFIG_FILES([Makefile])

修改完后执行mv  configure.scan   configure.ac

旧版本的autoconf编译是用configure.in,但是现在推荐使用configure.ac。另外注意configure.ac中的宏最好是单独成行的,AC_INIT必须在check之前调用,而AC_OUTPUT必须在结尾调用,某些宏在运行的时候会检查一些另外宏是否已经先运行。

宏的顺序一般是这样的:

AC_INIT

测试程序

测试函数库

测试头文件

测试类型定义

测试结构

测试编译器特性

测试库函数

测试系统调用

AC_OUTPUT

该文件包含autoconf宏的调用,其实configure.ac里面的内容也可以包含shell指令

执行aclocal,此时会生成一个叫aclocal.m4的新文件(告诉autoconf如何找到新的宏)

执行autoconf或autoconf  --install

假如遇到错误:

image

试试:

image

解决:

sudo  apt-get  install   libtool

然后再autoconf

image

执行autoheader,会生成一个config.h.in文件

创建一个脚本配置文件Makefile.am

AUTOMAKE_OPTIONS=foreign

bin_PROGRAMS=hello

hello_SOURCES=hello.c

说明:AUTOMAKE_OPTIONS为设置automake的选项。GNU对自己发布的软件有严格的规范,例如必须附带许可证声明文件COPYING等,否则automake执行时会报错。automake提供了3种软件等级:foreign、gnu和gnits,默认为gnu。这里使用foreign,只检测必须的文件

bin_PROGRAMS定义要生成的可执行文件名。如果要产生多个可执行文件,每个可执行文件的文件名要用空格隔开 .对于可执行文件和静态库类型,如果只想编译,不想安装到系统中,可以用noinst_PROGRAMS代替bin_PROGRAMS,noinst_LIBRARIES代替lib_LIBRARIES。

hello_SOURCES用于定义“hello”这个可执行程序所需要的依赖文件,如果有多个,要全部列出来,用空格隔开。如果要生成多个执行程序,那么要定义多个filename_SOURCES

 

然后执行automake  -a,自动添加一些脚本并生成configure.in文件

如果遇到警告:

configure.ac:7: warning: AM_INIT_AUTOMAKE: two- and three-arguments forms are deprecated.  For more info, see:

configure.ac:7: http://www.gnu.org/software/automake/manual/automake.html#Modernize-AM_005fINIT_005fAUTOMAKE-invocation

configure.ac:12: installing './compile'

configure.ac:7: installing './install-sh'

configure.ac:7: installing './missing'

Makefile.am: installing './depcomp'

先到http://www.gnu.org/software/automake/manual/automake.html#Modernize-AM_005fINIT_005fAUTOMAKE-invocation 查看一下问题:

现在AM_INIT_AUTOMAKE只需要引入一个参数

一个空格分隔的automake选项列表应该应用到项目树中的每个Makefile.am,效果如同每个选项在AUTOMAKE_OPTIONS中列出。

之前使用的AM_INIT_AUTOMAKE是一种比较老旧的配置:

AM_INIT_AUTOMAKE(PACKAGE,VERSION,[NO-DEFINE])

在这种形式中,有两个必需要的参数:PACKAGE,VERSION

包和版本已经可以从autoconf的AC_INIT宏获得。但是和AC_INIT调用发生的情况不同,此时AM_INIT_AUTOMAKE调用支持包和版本参数中的shell变量扩展(否则分别为通过AC_INIT调用定义的PACKAGE_TARNAME和PACKAGE_VERSION),也就是AM_INIT_AUTOMAKE支持Makefile中引入shell指令

image

解决:编辑configure.ac

方法1:将AM_INIT_AUTOMAKE的参数取消

方法2:默认情况下,这个宏AC_DEFINE的PACKAGE和VERSION。这可以通过传递no-define选项来避免

AM_INIT_AUTOMAKE([no-define ...])

不过这样也不是最稳妥的,链接的文章后面提到

如果您从早期版本的Automake升级configure.ac,将包和版本参数从AM_INIT_AUTOMAKE直接移动到AC_INIT并不总是正确的,如上例所示。 AC_INIT的第一个参数应该是程序包的名称(例如“GNU Automake”),而不是您传递给AM_INIT_AUTOMAKE的tarball名称(例如“automake”)。 Autoconf尝试从软件包名称派生tarball名称,该名称应该适用于大多数但不是所有软件包名称。 (如果它不适用于你,你可以使用AC_INIT的四参数形式明确地提供tarball名称)。

 

然后执行./configure

它将makefile.in文件生成Makefile文件

最后执行make,生成了可执行文件hello

 

资料

GNU Autoconf, Automake and Libtool(http://www.shlomifish.org/lecture/Autotools/slides/

automake(http://www.gnu.org/software/automake/manual/automake.html#index-AC_005fINIT

autoconf(https://www.gnu.org/software/autoconf/manual/autoconf.html#Shell-Script-Compiler

GNU Document(http://www.delorie.com/gnu/docs/)

使用autotools生成makefile文件入门http://www.cnblogs.com/flatfoosie/archive/2010/12/21/1912946.html

Makefile学习与进阶之Makefile.am和$$(M)的意思(http://www.cnblogs.com/zmlctt/p/4161547.html

GNU  AutoMake的中文翻译(http://blog.csdn.net/brace/article/details/726168

Autoconf学习---编写configure脚本(http://www.cnblogs.com/flyfish10000/articles/1986054.html

例解autoconf和automake生成makefile文件(https://www.ibm.com/developerworks/cn/linux/l-makefile/

configure.ac(configure.in)详解(http://www.ivpeng.com/pblog/configure-ac.html

Makefile.am规则和实例详解(http://www.ivpeng.com/pblog/makefile-am.html

Technorati Tags:
原文地址:https://www.cnblogs.com/simonid/p/6374306.html