autobook_283.html

Autoconf使用手册

<DT><CODE>AC_PROG_AWK</CODE>
<DD>This macro searches for an <CODE>awk</CODE> program and sets the output
variable <CODE>AWK</CODE> to be the best one it finds.
<P>

<DT><CODE>AC_PROG_CC</CODE>
<DD>This checks for the C compiler to use and sets the shell variable
<CODE>CC</CODE> to the value.  If the GNU C compiler is being used, this
sets the shell variable <CODE>GCC</CODE> to <SAMP>`yes'</SAMP>.  This macro sets the
shell variable <CODE>CFLAGS</CODE> if it has not already been set.  It also
calls <CODE>AC_SUBST</CODE> on <CODE>CC</CODE> and <CODE>CFLAGS</CODE>.
<P>

<DT><CODE>AC_PROG_CC_STDC</CODE>
<DD>This macro attempts to discover a necessary command line option to have
the C compiler accept ANSI C.  If so, it adds the option to the
<CODE>CC</CODE>.  If it were not possible to get the C compiler to accept
ANSI, the shell variable <CODE>ac_cv_prog_cc_stdc</CODE> will be set to
<SAMP>`no'</SAMP>.
<P>

<DT><CODE>AC_PROG_CPP</CODE>
<DD>This macro sets the output variable <CODE>CPP</CODE> to a command that runs
the C preprocessor.  If <SAMP>`$CC -E'</SAMP> does not work, it will set the
variable to <TT>`/lib/cpp'</TT>.
<P>

<DT><CODE>AC_PROG_CXX</CODE>
<DD>This is like <CODE>AC_PROG_CC</CODE>, but it checks for the C++ compiler, and
sets the variables <CODE>CXX</CODE>, <CODE>GXX</CODE> and <CODE>CXXFLAGS</CODE>.
<P>

<DT><CODE>AC_PROG_GCC_TRADITIONAL</CODE>
<DD>This macro determines if GCC requires the <SAMP>`-traditional'</SAMP>
option in order to compile code that uses <CODE>ioctl</CODE> and, if so, adds
<SAMP>`-traditional'</SAMP> to the <CODE>CC</CODE> output variable.  This condition is
rarely encountered, thought mostly on old systems.
<P>

<DT><CODE>AC_PROG_INSTALL</CODE>
<DD>This looks for an <CODE>install</CODE> program and sets the output variables
<CODE>INSTALL</CODE>, <CODE>INSTALL_DATA</CODE>, <CODE>INSTALL_PROGRAM</CODE>, and
<CODE>INSTALL_SCRIPT</CODE>.  This macro assumes that if an <CODE>install</CODE>
program cannot be found on the system, your package will have
<TT>`install-sh'</TT> available in the directory chosen by
<CODE>AC_CONFIG_AUX_DIR</CODE>.
<P>

<DT><CODE>AC_PROG_LEX</CODE>
<DD>This looks for a <CODE>lex</CODE>-like program and sets the <TT>`Makefile'</TT>
variable <CODE>LEX</CODE> to the result.  It also sets <CODE>LEXLIB</CODE> to
whatever might be needed to link against <CODE>lex</CODE> output.
<P>

<DT><CODE>AC_PROG_LIBTOOL</CODE>
<DD>This macro is the primary way to integrate Libtool support into
<TT>`configure'</TT>.  If you are using Libtool, you should call this macro
in <TT>`configure.in'</TT>.  Among other things, it adds support for the
<SAMP>`--enable-shared'</SAMP> <CODE>configure</CODE> flag.
<P>

<DT><CODE>AC_PROG_LN_S</CODE>
<DD>This sets the <TT>`Makefile'</TT> variable <CODE>LN_S</CODE> to <SAMP>`ln -s'</SAMP> if
symbolic links work in the current working directory.  Otherwise it sets
<CODE>LN_S</CODE> to just <SAMP>`ln'</SAMP>.
<P>

<DT><CODE>AC_PROG_MAKE_SET</CODE>
<DD>Some versions of <CODE>make</CODE> need to have the <TT>`Makefile'</TT> variable
<CODE>MAKE</CODE> set in <TT>`Makefile'</TT> in order for recursive builds to
work.  This macro checks whether this is needed, and, if so, it sets the
<TT>`Makefile'</TT> variable <CODE>SET_MAKE</CODE> to the result.
<CODE>AM_INIT_AUTOMAKE</CODE> calls this macro, so if you are using Automake,
you don't need to call it or use <CODE>SET_MAKE</CODE> in <TT>`Makefile.am'</TT>.
<P>

<DT><CODE>AC_PROG_RANLIB</CODE>
<DD>This searches for the <CODE>ranlib</CODE> program.  It sets the
<TT>`Makefile'</TT> variable <CODE>RANLIB</CODE> to the result.  If <CODE>ranlib</CODE> is
not found, or not needed on the system, then the result is <CODE>:</CODE>.
<P>

<DT><CODE>AC_PROG_YACC</CODE>
<DD>This searches for the <CODE>yacc</CODE> program -- it tries <CODE>bison</CODE>,
<CODE>byacc</CODE>, and <CODE>yacc</CODE>.  It sets the <TT>`Makefile'</TT> variable
<CODE>YACC</CODE> to the result.
<P>

<DT><CODE>AC_REPLACE_FUNCS(<VAR>function list</VAR>)</CODE>
<DD>This macro takes a single argument, which is a list of functions.  For a
given function <SAMP>`func'</SAMP>, <TT>`configure'</TT> will do a link test to try
to find it.  If the function cannot be found, then <SAMP>`func.o'</SAMP> will be
added to <CODE>LIBOBJS</CODE>.  If function can be found, then
<TT>`configure'</TT> will define the C preprocessor symbol <CODE>HAVE_FUNC</CODE>.
<P>

<DT><CODE>AC_REQUIRE(<VAR>macro-name</VAR>)</CODE>
<DD>This macro takes a single argument, which is the name of another macro.
(Note that you must quote the argument correctly:
<CODE>AC_REQUIRE([FOO])</CODE> is correct, while <CODE>AC_REQUIRE(FOO)</CODE> is
not.)  If the named macro has already been invoked, then
<CODE>AC_REQUIRE</CODE> does nothing.  Otherwise, it invokes the named macro
with no arguments.
<P>

<DT><CODE>AC_REVISION(<VAR>revision</VAR>)</CODE>
<DD>This macro takes a single argument, a version string.  Autoconf will
copy this string into the generated <TT>`configure'</TT> file.
<P>

<DT><CODE>AC_STRUCT_ST_BLKSIZE</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_ST_BLKSIZE</CODE> if <CODE>struct
stat</CODE> has an <CODE>st_blksize</CODE> member.
<P>

<DT><CODE>AC_STRUCT_ST_BLOCKS</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_ST_BLOCKS</CODE> if <CODE>struct
stat</CODE> has an <CODE>st_blocks</CODE> member.
<P>

<DT><CODE>AC_STRUCT_ST_RDEV</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_ST_RDEV</CODE> if <CODE>struct
stat</CODE> has an <CODE>st_rdev</CODE> member.
<P>

<DT><CODE>AC_STRUCT_TM</CODE>
<DD>This macro looks for <CODE>struct tm</CODE> in <TT>`time.h'</TT> and defines
<CODE>TM_IN_SYS_TIME</CODE> if it is not found there.
<P>

<DT><CODE>AC_SUBST(<VAR>name</VAR>)</CODE>
<DD>This macro takes a single argument, which is the name of a shell
variable.  When <CODE>configure</CODE> generates the files listed in
<CODE>AC_OUTPUT</CODE> (e.g., <TT>`Makefile'</TT>), it will substitute the
variable's value (at the end of the <CODE>configure</CODE> run -- the value
can be changed after <CODE>AC_SUBST</CODE> is called) anywhere a string of the
form <SAMP>`@<VAR>name</VAR>@'</SAMP> is seen.
<P>

<DT><CODE>AC_TRY_COMPILE(<VAR>includes</VAR>, <VAR>body</VAR>, [<VAR>if-ok</VAR>], [<VAR>if-not-ok</VAR>])</CODE>
<DD>This macro is used to try to compile a given function, whose body is
given in <VAR>body</VAR>.  <VAR>includes</VAR> lists any <SAMP>`#include'</SAMP>
statements needed to compile the function.  If the code compiles
correctly, the shell commands in <VAR>if-ok</VAR> are run; if not,
<VAR>if-not-ok</VAR> is run.  Note that this macro will not try to link the
test program -- it will only try to compile it.
<P>

<DT><CODE>AC_TRY_LINK(<VAR>includes</VAR>, <VAR>body</VAR>, [<VAR>if-found</VAR>], [<VAR>if-not-found</VAR>])</CODE>
<DD>This is used like <CODE>AC_TRY_COMPILE</CODE>, but it tries to link the
resulting program.  The libraries and options in the <CODE>LIBS</CODE> shell
variable are passed to the link.
<P>

<DT><CODE>AC_TRY_RUN(<VAR>program</VAR>, [<VAR>if-true</VAR>, [<VAR>if-false</VAR>], [<VAR>if-cross-compiling</VAR>])</CODE>
<DD>This macro tries to compile and link the program whose text is in
<VAR>program</VAR>.  If the program compiles, links, and runs successfully,
the shell code <VAR>if-true</VAR> is run.  Otherwise, the shell code
<VAR>if-false</VAR> is run.  If the current configure is a cross-configure,
then the program is not run, and on a successful compile and link, the
shell code <VAR>if-cross-compiling</VAR> is run.
<P>

<DT><CODE>AC_TYPE_SIGNAL</CODE>
<DD>This macro defines the C preprocessor macro <CODE>RETSIGTYPE</CODE> to be the
correct return type of signal handlers.  For instance, it might be
<SAMP>`void'</SAMP> or <SAMP>`int'</SAMP>.
<P>

<DT><CODE>AC_TYPE_SIZE_T</CODE>
<DD>This macro looks for the type <CODE>size_t</CODE>.  If not defined on the
system, it defines it (as a macro) to be <SAMP>`unsigned'</SAMP>.
<P>

<DT><CODE>AM_CONDITIONAL(<VAR>name</VAR>, <VAR>testcode</VAR>)</CODE>
<DD>This Automake macro takes two arguments: the name of a conditional and a
shell statement that is used to determine whether the conditional should
be true or false.  If the shell code returns a successful (0) status,
then the conditional will be true.  Any conditional in your
<TT>`configure.in'</TT> is automatically available for use in any
<TT>`Makefile.am'</TT> in that project.
<P>

<DT><CODE>AM_CONFIG_HEADER(<VAR>header</VAR>)</CODE>
<DD>This is just like <CODE>AC_CONFIG_HEADER</CODE>, but does some additional
setup required by Automake.  If you are using Automake, use this macro.
Otherwise, use <CODE>AC_CONFIG_HEADER</CODE>.
<P>

<DT><CODE>AM_INIT_AUTOMAKE(<VAR>package</VAR>, <VAR>version</VAR>, [<VAR>nodefine</VAR>])</CODE>
<DD>This macro is used to do all the standard initialization required by
Automake.  It has two required arguments: the package name and the
version number.  This macro sets and calls <CODE>AC_SUBST</CODE> on the shell
variables <CODE>PACKAGE</CODE> and <CODE>VERSION</CODE>.  By default it also defines
these variables (via <CODE>AC_DEFINE_UNQUOTED</CODE>).  However, this macro
also accepts an optional third argument which, if not empty, means that
the <CODE>AC_DEFINE_UNQUOTED</CODE> calls for <CODE>PACKAGE</CODE> and
<CODE>VERSION</CODE> should be suppressed.
<P>

<DT><CODE>AM_MAINTAINER_MODE</CODE>
<DD>This macro is used to enable a special Automake feature, maintainer
mode, which we've documented elsewhere (see section <A HREF="autobook_26.html#SEC26">5.3 Maintaining Input Files</A>).
<P>

<DT><CODE>AM_PROG_CC_STDC</CODE>
<DD>This macro takes no arguments.  It is used to try to get the C compiler
to be ANSI compatible.  It does this by adding different options
known to work with various system compilers.  This macro is most
typically used in conjunction with Automake when you want to use the
automatic de-ANSI-fication feature.
<P>

<DT><CODE>AM_PROG_LEX</CODE>
<DD>This is like <CODE>AC_PROG_LEX</CODE>, but it does some additional processing
used by Automake-generated <TT>`Makefile'</TT>s.  If you are using Automake,
then you should use this.  Otherwise, you should use <CODE>AC_PROG_LEX</CODE>
(and perhaps <CODE>AC_DECL_YYTEXT</CODE>, which <CODE>AM_PROG_LEX</CODE> calls).
<P>

<DT><CODE>AM_WITH_DMALLOC</CODE>
<DD>This macro adds support for the <SAMP>`--with-dmalloc'</SAMP> flag to
<CODE>configure</CODE>.  If the user chooses to enable <CODE>dmalloc</CODE> support,
then this macro will define the preprocessor symbol <SAMP>`WITH_DMALLOC'</SAMP>
and will add <SAMP>`-ldmalloc'</SAMP> to the <TT>`Makefile'</TT> variable
<SAMP>`LIBS'</SAMP>.
<P>

</DL>
<P>

<A NAME="OPL"></A>
</TR></TABLE>
<BR>  
<FONT SIZE="-1">
This document was generated
by <I>Gary V. Vaughan</I> on <I>September, 12  2004</I>
using <A HREF="http://www.mathematik.uni-kl.de/~obachman/Texi2html
"><I>texi2html</I></A>

</BODY>
</HTML>