王立翻譯
現有的測試
這些宏測試了包可能需要或者需要使用的特定的系統特徵.如果你要測試這些宏所不能測試的特徵,可能你可以用適當的參數調用主測試宏來達到目的（參見編寫測試）.
這些宏列印消息以告訴用戶它們正在測試的特徵,以及它們的測試結果.它們為未來運行的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中,該函數並不這樣做.
