Chinaunix首页 | 论坛 | 博客
  • 博客访问: 104640986
  • 博文数量: 19283
  • 博客积分: 9968
  • 博客等级: 上将
  • 技术积分: 196062
  • 用 户 组: 普通用户
  • 注册时间: 2007-02-07 14:28
文章分类

全部博文(19283)

文章存档

2011年(1)

2009年(125)

2008年(19094)

2007年(63)

分类: C/C++

2008-04-16 17:41:09

 
 

现有的测试 
这些宏测试了包可能需要或者需要使用的特定的系统特征。如果你要测试这些宏所不能测试的特征,可能你可以用适当的参数调用主测试宏来达到目的(参见编写测试)。 

这些宏打印消息以告诉用户它们正在测试的特征,以及它们的测试结果。它们为未来运行的configure 储存测试结果(参见缓存结果)。 

在这些宏中,有的宏设置输出变量。关于如何获取它们的值,请参见Makefile中的替换。在下面出现的术语“定义name”是“把C预处理符号name定义成1”的简称。关于如何把这些符号的定义放入你的程序中,参见定义C预处理器符号。 

对程序的选择 
这些宏检查了特定程序的存在或者特定程序的特征。它们被用于在几个可以相互替代的程序间进行选择,并且在决定选用某一个的时候作些什么。如果没有为你要使用的程序定义特定的宏,并且你不需要检查它的任何特殊的特征,那么你就可以选用一个通用程序检查宏。 

对特定程序的检查 
这些宏检查特定的程序--它们是否存在,并且在某些情况下它们是否支持一些特征。 
宏: AC_DECL_YYTEXT 
如果yytext的类型是`char *'而不是`char []',就定义YYTEXT_POINTER。本宏还把输出变量LEX_OUTPUT_ROOT设置由lex生成的文件名的基文件名;通常是`lex.yy',但有时是其他的东西。它的结果依使用lex还是使用flex而定。 
宏: AC_PROG_AWK 
按顺序查找mawk、gawk、nawk和awk,并且把输出变量AWK 的值设置成第一个找到的程序名。首先寻找mawk是因为据说它是最快的实现。 
宏: AC_PROG_CC 
确定C的编译器。如果在环境中没有设定CC,就查找gcc,如果没有找到,就使用cc。把输出变量CC设置为找到的编译器的名字。 

如果要使用GNU C编译器,把shell变量GCC设置为`yes',否则就设置成空。如果还没有设置输出变量 CFLAGS,就为GNU C编译器把CFLAGS设置成`-g -O2'(在GCC不接受`-g' 的系统中就设置成`-O2'),为其他编译器把CFLAGS设置成`-g'。 

如果被使用的C编译器并不生成可以在configure运行的系统上运行的可执行文件,就把shell变量 cross_compiling设置成`yes',否则设置成`no'。换句话说,它检查创建系统类型是否与主机系统类型不同(目标系统与本测试无关)。关于对交叉编译的支持,参见手工配置。 

宏: AC_PROG_CC_C_O 
对于不能同时接受`-c'和`-o'选项的C编译器,定义NO_MINUS_C_MINUS_O。 
宏: AC_PROG_CPP 
把输出变量CPP设置成运行C预处理器的命令。如果`$CC -E'不能工作,就使用`/lib/cpp'。只有对以`.c'为扩展名的文件运行CPP才是可以移植的(portable)。 

如果当前语言是C(参见对语言的选择),许多特定的测试宏通过调用AC_TRY_CPP、 AC_CHECK_HEADER、AC_EGREP_HEADER或者AC_EGREP_CPP,间接地使用了CPP的值。 

宏: AC_PROG_CXX 
确定C++编译器。检查环境变量CXX或者CCC(按照这个顺序)是否被设置了;如果设置了,就把输出变量 CXX设置成它的值。否则就搜索类似名称(c++、g++、gcc、CC、 cxx和cc++)的C++编译器。如果上述测试都失败了,最后的办法就是把CXX设置成 gcc。 

如果使用GNU C++编译器,就把shell变量GXX设置成`yes',否则就设置成空。如果还没有设置输出变量CXXFLAGS,就为GNU C++编译器把CXXFLAGS设置成`-g -O2' (在G++不接受`-g'的系统上设置成`-O2'),或者为其他编译器把CXXFLAGS设置成 `-g'。 . 

如果使用的C++编译器并不生成在configure运行的系统上运行的可执行文件,就把shell变量cross_compiling 设置成`yes',否则就设置成`no'。换句话说,它检查创建系统类型是否与主机系统类型不同(目标系统类型与本测试无关)。关于对交叉编译的支持,参见手工配置。 

宏: AC_PROG_CXXCPP 
把输出变量CXXCPP设置成运行C++预处理器的命令。如果`$CXX -E'不能工作,使用`/lib/cpp'。只有对以`.c'、`.C'或者`.cc'为扩展名的文件运行CPP才是可以移植的(portable)。 

如果当前语言是C++(参见对语言的选择),许多特定的测试宏通过调用 AC_TRY_CPP、AC_CHECK_HEADER、AC_EGREP_HEADER或者AC_EGREP_CPP,间接地使用了CXXCPP的值。 

宏: AC_PROG_F77 
确定Fortran 77编译器。如果在环境中没有设置F77,就按顺序检查g77、f77和 f2c。把输出变量F77设置成找到的编译器的名字。 

如果使用g77(GNU Fortran 77编译器),那么AC_PROG_F77将把shell变量G77设置成 `yes',否则就设置成空。如果在环境中没有设置输出变量FFLAGS,那么就为g77 把FFLAGS设置成`-g -02'(或者在g77不支持`-g'的时候设置成 `-O2')。否则,就为所有其它的Fortran 77编译器把FFLAGS设置成`-g'。 

宏: AC_PROG_F77_C_O 
测试Fortran 77编译器是否能够同时接受选项`-c'和`-o',并且如果不能同时接受的话,就定义F77_NO_MINUS_C_MINUS_O。 
宏: AC_PROG_GCC_TRADITIONAL 
如果在没有给出`-traditional'的情况下,用GNU C和ioctl不能正确地工作,就把 `-traditional'添加到输出变量CC中。这通常发生在旧系统上没有安装修正了的头文件的时候。因为新版本的GNU C编译器在安装的时候自动地修正了头文件,它就不是一个普遍的问题了。 
宏: AC_PROG_INSTALL 
如果在当前PATH中找到了一个与BSD兼容的install程序,就把输出变量INSTALL设置成到该程序的路径。否则,就把INSTALL设置成`dir/install-sh -c',检查由 AC_CONFIG_AUX_DIR指明的目录(或者它的缺省目录)以确定dir(参见 创建输出文件)。本宏还把变量INSTALL_PROGRAM和INSTALL_script 设置成`${INSTALL}',并且把INSTALL_DATA设置成`${INSTALL} -m 644'。 

本宏忽略各种已经确认的不能工作的install程序。为了提高速度,它更希望找到一个C程序而不是shell脚本。除了`install-sh',它还能够使用`install.sh',但因为有些make含有一条在没有 `Makefile'的情况下,从`install.sh'创建`install'的规则,所以这个名字过时了。 

你可能使用的`install-sh'的一个副本来自于Autoconf。如果你使用AC_PROG_INSTALL,你必须在你的发布版本中包含`install-sh'或者`install.sh',否则即使你所在的系统含有一个好的install 程序,configure也将输出一条找不到它们的错误消息。 

如果你因为你自己的安装程序提供了一些在标准install程序中没有的特征,而需要使用你自己的安装程序,就没有必要使用AC_PROG_INSTALL;直接把你的程序的路径名放入你的`Makefile.in'文件即可。 

宏: AC_PROG_LEX 
如果找到了flex,就把输出变量LEX设置成`flex',并且在flex库在标准位置的时候,把LEXLIB设置成`-lfl'。否则,就把LEX设置成`lex'并且把 LEXLIB设置成`-ll'。 
宏: AC_PROG_LN_S 
如果`ln -s'能够在当前文件系统中工作(操作系统和文件系统支持符号连接),就把输出变量 LN_S设置成`ln -s',否则就把它设置成`ln'。 

如果连接出现在其他目录而不是在当前目录中,它的含义依赖于是使用了`ln',还是使用了`ln -s'。为了用`$(LN_S)'安全地创建连接,既可以找到正在使用的形式并且调整参数,也可以总是在创建连接的目录中调用ln。 

换句话说,它不能像下面那样工作: 

$(LN_S) foo /x/bar 

而是要: 

(cd /x && $(LN_S) foo bar) 
宏: AC_PROG_RANLIB 
如果找到了ranlib,就把输出变量RANLIB设置成`ranlib',否则就设置成 `:'(什么也不作)。 
宏: AC_PROG_YACC 
如果找到了bison,就把输出变量YACC设置成`bison -y'。否则,如果找到了byacc。就把YACC设置成`byacc'。否则,就把YACC设置成`yacc'。 

对普通程序和文件的检查 
这些宏用于寻找没有包含在特定程序测试宏中的程序。如果你除了需要确定程序是否存在,还需要检测程序的行为,你就不得不为它编写你自己的测试了(参见编写测试)。在缺省情况下,这些宏使用环境变量PATH。如果你需要检查可能不会出现在PATH中的程序,你可能要按照下面的方式给出修改了的路径: 

AC_PATH_PROG(INETD, inetd, /usr/libexec/inetd, 
 $PATH:/usr/libexec:/usr/sbin:/usr/etc:etc) 
宏: AC_CHECK_FILE (file [, action-if-found [, action-if-not-found]]) 
检查文件file是否出现在本地系统中。如果找到了,就执行action-if-found。否则,就在给出了 action-if-not-found的时候执行action-if-not-found。 
宏: AC_CHECK_FILES (files[, action-if-found [, action-if-not-found]]) 
为每个在files中给出的文件运行AC_CHECK_FILE。并且为每个找到的文件定义 `HAVEfile',定义成1。 
宏: AC_CHECK_PROG (variable, prog-to-check-for, value-if-found [, value-if-not-found [, path, [ reject ]]]) 
检查程序prog-to-check-for是否存在于PATH之中。如果找到了,就把变量 variable设置成value-if-found,否则就在给出了value-if-not-found的时候把variable设置成它。即使首先在搜索路径中找到reject(一个绝对文件名),本宏也会忽略它;在那种情况下,用找到的prog-to-check-for,不同于reject的绝对文件名来设置variable。如果variable已经被设置了,就什么也不作。为variable调用AC_SUBST。 
宏: AC_CHECK_PROGS (variable, progs-to-check-for [, value-if-not-found [, path]]) 
在PATH中寻找每个出现在以空格分隔的列表progs-to-check-for中的程序。如果找到了,就把variable设置成那个程序的名字。否则,继续寻找列表中的下一个程序。如果列表中的任何一个程序都没有被找到,就把variable设置成value-if-not-found;如果没有给出value-if-not-found,variable的值就不会被改变。为variable调用 AC_SUBST。 
宏: AC_CHECK_TOOL (variable, prog-to-check-for [, value-if-not-found [, path]]) 
除了把AC_CANONICAL_HOST确定的主机类型和破折号作为前缀之外,类似于AC_CHECK_PROG,寻找prog-to-check-for(参见获取规范的系统类型)。例如,如果用户运行`configure --host=i386-gnu',那么下列调用: 
AC_CHECK_TOOL(RANLIB, ranlib, :) 

当`i386-gnu-ranlib'在PATH中存在的时候,就把RANLIB设置成`i386-gnu-ranlib',或者当`ranlib'在PATH中存在的时候,就把RANLIB设置成`ranlib',或者在上述两个程序都不存在的时候,把RANLIB设置成`:'。 

宏: AC_PATH_PROG (variable, prog-to-check-for [, value-if-not-found [, path]]) 
类似于AC_CHECK_PROG,但在找到prog-to-check-for的时候,把variable设置成prog-to-check-for的完整路径。 
宏: AC_PATH_PROGS (variable, progs-to-check-for [, value-if-not-found [, path]]) 
类似于AC_CHECK_PROGS,但在找到任何一个progs-to-check-for的时候,把variable 设置成找到的程序的完整路径。 

库文件 
下列的宏检查某些C、C++或者Fortran 77库文件是否存在。 
宏: AC_CHECK_LIB (library, function [, action-if-found [, action-if-not-found [, other-libraries]]]) 
依赖于当前的语言(参见对语言的选择),试图通过检查一个测试程序是否可以和库library进行连接以获取C、C++或者Fortran 77函数function,从而确认函数function 是可以使用的。library是库的基本名字;例如,为了检查`-lmp',就把`mp'作为参数library。 

action-if-found是一个在与库成功地进行了连接的时候运行的shell命令列表; action-if-not-found是一个在与库的连接失败的时候运行的shell命令列表。如果没有给出action-if-found,缺省的动作就是把`-llibrary'添加到 LIBS中,并且定义`HAVE_LIBlibrary'(全部使用大写字母)。 

如果与library的连接导致了未定义符号错误(unresolved symbols),而这些错误可以通过与其他库的连接来解决,就把这些库用空格分隔,并作为other-libraries参数给出:`-lXt -lX11'。否则,本宏对library是否存在的检测将会失败,这是因为对测试程序的连接将总是因为含有未定义符号错误而失败。 

宏: AC_HAVE_LIBRARY (library, [, action-if-found [, action-if-not-found [, other-libraries]]]) 
本宏等价于function参数为main的,对AC_CHECK_LIB的调用。此外,library可以写作`foo'、`-lfoo'或者`libfoo.a'。对于以上任一种形式,编译器都使用`-lfoo'。但是,library不能是一个shell变量;它必须是一个文字名(literal name)。本宏是一个过时的宏。 
宏: AC_SEARCH_LIBS (function, search-libs [, action-if-found [, action-if-not-found [, other-libraries]]]) 
如果function还不可用,就寻找一个定义了function的库。这等同于首先不带库调用 AC_TRY_LINK_FUNC,而后为每个在search-libs中列举的库调用AC_TRY_LINK_FUNC。 

如果找到了函数,就运行action-if-found。否则运行action-if-not-found。 

如果与库library的连接导致了未定义符号错误,而这些错误可以通过与附加的库进行连接来解决,就把这些库用空格分隔,并作为other-libraries参数给出:`-lXt -lX11'。否则,本宏对function 是否存在的检测将总是失败,这是因为对测试程序的连接将总是因为含有未定义符号错误而失败。 

宏: AC_SEARCH_LIBS (function, search-libs[, action-if-found [, action-if-not-found]]) 
本宏等价于为每个在search-libs中列举的库调用一次AC_TRY_LINK_FUNC。为找到的第一个含有 function的库,把`-llibrary'添加到LIBS中,并且执行 action-if-found。否则就执行action-if-not-found。 

库函数 
以下的宏用于检测特定的C库函数。如果没有为你需要的函数定义特定的宏,而且你不需要检查它的任何特殊性质,那么你可以使用一个通用函数检测宏。 

对特定函数的检查 
这些宏用于检测特定的C函数--它们是否存在,以及在某些情况下,当给出了特定的参数时,它们是如何响应的。 
宏: AC_FUNC_ALLOCA 
检测如何获得alloca。本宏试图通过检查`alloca.h'或者预定义C预处理器宏 __GNUC__和_AIX来获得alloca的内置(builtin)版本。如果本宏找到了`alloca.h',它就定义HAVE_ALLOCA_H。 

如果上述尝试失败了,本宏就在标准C库中寻找函数。如果下列任何方法成功了,本宏就定义HAVE_ALLOCA。否则,它把输出变量ALLOCA设置成`alloca.o'并且定义C_ALLOCA (这样程序就可以周期性地调用`alloca(0)'以进行垃圾的收集)。本变量是从LIBOBJS中分离出来的,因此在只有一部分程序使用LIBOBJS中的代码时,多个程序就可以不必创建实际的库而共享ALLOCA的值。 

本宏并不试图从System V R3的`libPW'中,或者从System V R4的`libucb'中获取alloca,这是因为这些库包含了一些造成麻烦的不兼容的函数。有些版本甚至不含有alloca或者含有带bug的版本。如果你仍然需要使用它们的alloca,用ar把`alloca.o'从这些库中提取出来,而不是编译`alloca.c'。 

使用alloca的源文件应该以如下一段代码开头,以正确地声明它。在某些AIX版本中,对alloca 的声明必须在除了注释和预处理指令之前的任何东西之前出现。#pragma指令被缩进(indented),以便让预标准C编译器(pre-ANSI C compiler)忽略它,而不是导致错误(choke on it)。 

/* AIX requires this to be the first thing in the file. */ 
#ifndef __GNUC__ 
# if HAVE_ALLOCA_H 
# include 
# else 
# ifdef _AIX 
#pragma alloca 
# else 
#  ifndef alloca /* predefined by HP cc +Olibcalls */ 
char *alloca (); 
#  endif 
# endif 
# endif 
#endif 
宏: AC_FUNC_CLOSEDIR_VOID 
如果函数closedir不返回有意义的值,就定义CLOSEDIR_VOID。否则,调用者就应该把它的返回值作为错误指示器来进行检查。 
宏: AC_FUNC_FNMATCH 
如果可以使用fnmatch函数,并且能够工作(不象SunOS 5.4中的fnmatch那样),就定义HAVE_FNMATCH。 
宏: AC_FUNC_GETLOADAVG 
检查如何才能获得系统平均负载。如果系统含有getloadavg函数,本宏就定义HAVE_GETLOADAVG,并且把为了获得该函数而需要的库添加到LIBS中。 

否则,它就把`getloadavg.o'添加到输出变量LIBOBJS之中,并且可能定义几个其他的C预处理器宏和输出变量: 

如果在相应的系统中,就根据系统类型定义宏SVR4、DGUX、UMAX或者UMAX4_3。 
如果它找到了`nlist.h',就定义NLIST_STRUCT。 
如果结构`struct nlist'含有成员`n_un',就定义NLIST_NAME_UNION。 
如果在编译`getloadavg.c'时定义了LDAV_PRIVILEGED,为了使getloadavg能够工作,程序就必须特殊地安装在系统中,并且本宏定义GETLOADAVG_PRIVILEGED。 
本宏设置输出变量NEED_SETGID。如果需要进行特别的安装,它的值就是`true',否则值就是`false'。如果NEED_SETGID为`true',本宏把KMEM_GROUP 设置成将拥有被安装的程序的组(group)的名字。 

宏: AC_FUNC_GETMNTENT 
为Irix 4、PTX和Unixware在库`sun'、`seq'和`gen'中分别查找getmntent函数。那么,如果可以使用getmntent,就定义HAVE_GETMNTENT。 
宏: AC_FUNC_GETPGRP 
如果getpgrp不接受参数(POSIX.1版),就定义GETPGRP_VOID。否则,它就是一个把进程ID作为参数的BSD版本。本宏根本不检查getpgrp是否存在;如果你需要检查它的存在性,就首先为 getpgrp函数调用AC_CHECK_FUNC。 
宏: AC_FUNC_MEMCMP 
如果不能使用memcmp函数,或者不能处理8位数据(就像SunOS 4.1.3中的那样),就把`memcmp.o' 添加到输出变量LIBOBJS中去。 
宏: AC_FUNC_MMAP 
如果函数mmap存在并且能够正确地工作,就定义HAVE_MMAP。只检查已经映射(already-mapped)的内存的私有固定映射(private fixed mapping)。 
宏: AC_FUNC_SELECT_ARGTYPES 
确定函数select的每个参数的正确类型,并且把这些类型分别定义成SELECT_TYPE_ARG1、 SELECT_TYPE_ARG234和SELECT_TYPE_ARG5。SELECT_TYPE_ARG1的缺省值是`int',SELECT_TYPE_ARG234的缺省值是`int *', SELECT_TYPE_ARG5的缺省值是`struct timeval *'。 
宏: AC_FUNC_SETPGRP 
如果setpgrp不接受参数(POSIX.1版),就定义SETPGRP_VOID。否则,该函数就是一个把两个进程ID作为参数的BSD版本。本宏并不检查函数setpgrp是否存在;如果你需要检查该函数的存在性,就首先为setpgrp调用AC_CHECK_FUNC。 
宏: AC_FUNC_SETVBUF_REVERSED 
如果函数setvbuf的第二个参数是缓冲区的类型并且第三个参数是缓冲区指针,而不是其他形式,就定义SETVBUF_REVERSED。这是在System V第3版以前的情况。 
宏: AC_FUNC_STRCOLL 
如果函数strcoll存在并且可以正确地工作,就定义HAVE_STRCOLL。由于有些系统包含了错误定义的strcoll,这时就不应该使用strcoll,因此本宏要比`AC_CHECK_FUNCS(strcoll)'多作一些检查。 
宏: AC_FUNC_STRFTIME 
对于SCO UNIX,在库`intl'中查找strftime。而后,如果可以使用strftime,就定义HAVE_STRFTIME。 
宏: AC_FUNC_UTIME_NULL 
如果`utime(file, NULL)'把file的时间标记设置成现在,就定义 HAVE_UTIME_NULL。 
宏: AC_FUNC_VFORK 
如果找到了`vfork.h',就定义HAVE_VFORK_H。如果找不到可以工作的vfork,就把vfork定义成fork。本宏检查一些已知的vfork实现中的错误并且认为如果vfork的实现含有任何一个错误,系统就不含有可以工作的vfork。由于子进程很少改变它们的信号句柄(signal handler),所以如果子进程的signal调用(invocation)修改了父进程的信号句柄,将不会被当作实现的错误。 
宏: AC_FUNC_VPRINTF 
如果找到了vprintf,就定义HAVE_VPRINTF。否则,如果找到了_doprnt,就定义HAVE_DOPRNT。(如果可以使用vprintf,你就可以假定也可以使用vfprintf 和vsprintf。) 
宏: AC_FUNC_WAIT3 
如果找到了wait3并且该函数填充它的第三个参数的内容(`struct rusage *'),就定义HAVE_WAIT3。在HP-UX中,该函数并不这样做。 
 
阅读(208) | 评论(0) | 转发(0) |
给主人留下些什么吧!~~