autobook_283.html

Autoconf使用手册

<P>

<DT><CODE>AC_CHECK_PROG(<VAR>variable</VAR>, <VAR>program-name</VAR>, <VAR>value-if-found</VAR>, [<VAR>value-if-not-found</VAR>], [<VAR>path</VAR>], [<VAR>reject</VAR>])</CODE>
<DD>Checks to see if the program named by <VAR>program-name</VAR> exists in the
path <VAR>path</VAR>.  If found, it sets the shell variable <VAR>variable</VAR> to
the value <VAR>value-if-found</VAR>; if not it uses the value
<VAR>value-if-not-found</VAR>.  If <VAR>variable</VAR> is already set at runtime,
this macro does nothing.
<P>

<DT><CODE>AC_CHECK_SIZEOF(<VAR>type</VAR>, [<VAR>size-if-cross-compiling</VAR>])</CODE>
<DD>This macro determines the size of C and C++ built-in types and defines
<CODE>SIZEOF_type</CODE> to the size, where <CODE>type</CODE> is transformed--all
characters to upper case, spaces to underscores and <SAMP>`*'</SAMP> to
<SAMP>`P'</SAMP>.  If the type is unknown to the compiler, the size is set to 0.
An optional argument specifies a default size when cross-compiling.  The
<TT>`configure'</TT> script will abort with an error message if it tries to
cross-compile without this default size.
<P>

<DT><CODE>AC_CONFIG_AUX_DIR(<VAR>directory</VAR>)</CODE>
<DD>This macro allows an alternative directory to be specified for the
location of auxiliary scripts such as <TT>`config.guess'</TT>,
<TT>`config.sub'</TT> and <TT>`install-sh'</TT>.  By default, <TT>`$srcdir'</TT>,
<TT>`$srcdir/..'</TT> and <TT>`$srcdir/../..'</TT> are searched for these files.
<P>

<DT><CODE>AC_CONFIG_HEADER(<VAR>header-list</VAR>)</CODE>
<DD>This indicates that you want to use a config header, as opposed to
having all the C preprocessor macros defined via <CODE>-D</CODE> options in
the <CODE>DEFS</CODE> <TT>`Makefile'</TT> variable.  Each header named in
<VAR>header-list</VAR> is created at runtime by <TT>`configure'</TT> (via
<CODE>AC_OUTPUT</CODE>).  There are a variety of optional features for use
with config headers (different naming schemes and so forth); see the
reference manual for more information.
<P>

<DT><CODE>AC_C_CONST</CODE>
<DD>This macro defines the C preprocessor macro <CODE>const</CODE> to the string
<CODE>const</CODE> if the C compiler supports the <CODE>const</CODE> keyword.
Otherwise it is defined to be the empty string.
<P>

<DT><CODE>AC_C_INLINE</CODE>
<DD>This macro tests if the C compiler can accept the <CODE>inline</CODE> keyword.
It defines the C preprocessor macro <CODE>inline</CODE> to be the keyword
accepted by the compiler or the empty string if it is not accepted at
all.
<P>

<DT><CODE>AC_DEFINE(<VAR>variable</VAR>, [<VAR>value</VAR>], [<VAR>description</VAR>])</CODE>
<DD>This is used to define C preprocessor macros.  The first argument is the
name of the macro to define.  The <VAR>value</VAR> argument, if given, is the
value of the macro.  The final argument can be used to avoid adding an
<SAMP>`#undef'</SAMP> for the macro to <TT>`acconfig.h'</TT>.
<P>

<DT><CODE>AC_DEFINE_UNQUOTED(<VAR>variable</VAR>, [<VAR>value</VAR>], [<VAR>description</VAR>])</CODE>
<DD>This is like <CODE>AC_DEFINE</CODE>, but it handles the quoting of <VAR>value</VAR>
differently.  This macro is used when you want to compute the value
instead of having it used verbatim.
<P>

<DT><CODE>AC_DEFUN(<VAR>name</VAR>, <VAR>body</VAR>)</CODE>
<DD>This macro is used to define new macros.  It is similar to M4's
<CODE>define</CODE> macro, except that it performs additional internal
functions.
<P>

<DT><CODE>AC_DISABLE_FAST_INSTALL</CODE>
<DD>This macro can be used to disable Libtool's `fast install' feature.
<P>

<DT><CODE>AC_DISABLE_SHARED</CODE>
<DD>This macro changes the default behavior of <CODE>AC_PROG_LIBTOOL</CODE> so
that shared libraries will not be built by default.  The user can still
override this new default by using <SAMP>`--enable-shared'</SAMP>.
<P>

<DT><CODE>AC_DISABLE_STATIC</CODE>
<DD>This macro changes the default behavior of <CODE>AC_PROG_LIBTOOL</CODE> so
that static libraries will not be built by default.  The user can still
override this new default by using <SAMP>`--enable-static'</SAMP>.
<P>

<DT><CODE>AC_EXEEXT</CODE>
<DD>Sets the output variable <CODE>EXEEXT</CODE> to the extension of executables
produced by the compiler.  It is usually set to the empty string on Unix
systems and <SAMP>`.exe'</SAMP> on Windows.
<P>

<DT><CODE>AC_FUNC_ALLOCA</CODE>
<DD>This macro defines the C preprocessor macro <CODE>HAVE_ALLOCA</CODE> if the
various tests indicate that the C compiler has built-in <CODE>alloca</CODE>
support.  If there is an <TT>`alloca.h'</TT> header file, this macro defines
<CODE>HAVE_ALLOCA_H</CODE>.  If, instead, the <CODE>alloca</CODE> function is found
in the standard C library, this macro defines <CODE>C_ALLOCA</CODE> and sets
the output variable <CODE>ALLOCA</CODE> to <CODE>alloca.o</CODE>.
<P>

<DT><CODE>AC_FUNC_GETPGRP</CODE>
<DD>This macro tests if the <CODE>getpgrp</CODE> function takes a process ID as an
argument or not.  If it does not, the C preprocessor macro
<CODE>GETPGRP_VOID</CODE> is defined.
<P>

<DT><CODE>AC_FUNC_MEMCMP</CODE>
<DD>This macro tests for a working version of the <CODE>memcmp</CODE> function.
If absent, or it does not work correctly, <TT>`memcmp.o'</TT> is added to
the <CODE>LIBOBJS</CODE> output variable.
<P>

<DT><CODE>AC_FUNC_MMAP</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_MMAP</CODE> if the <CODE>mmap</CODE>
function exists and works.
<P>

<DT><CODE>AC_FUNC_SETVBUF_REVERSED</CODE>
<DD>On some systems, the order of the <CODE>mode</CODE> and <CODE>buf</CODE> arguments
is reversed with respect to the ANSI C standard.  If so, this macro
defines the C preprocessor macro <CODE>SETVBUF_REVERSED</CODE>.
<P>

<DT><CODE>AC_FUNC_UTIME_NULL</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_UTIME_NULL</CODE> if a call to
<CODE>utime</CODE> with a NULL <CODE>utimbuf</CODE> pointer sets the file's
timestamp to the current time.
<P>

<DT><CODE>AC_FUNC_VPRINTF</CODE>
<DD>Defines the C preprocessor macro <CODE>HAVE_VPRINTF</CODE> if the
<CODE>vprintf</CODE> function is available.  If not and the <CODE>_doprnt</CODE>
function is available instead, this macro defines <CODE>HAVE_DOPRNT</CODE>.
<P>

<DT><CODE>AC_HEADER_DIRENT</CODE>
<DD>This macro searches a number of specific header files for a declaration
of the C type <CODE>DIR</CODE>.  Depending on which header file the
declaration is found in, this macro may define one of the C preprocessor
macros <CODE>HAVE_DIRENT_H</CODE>, <CODE>HAVE_SYS_NDIR_H</CODE>,
<CODE>HAVE_SYS_DIR_H</CODE> or <CODE>HAVE_NDIR_H</CODE>.  Refer to the Autoconf
manual for an example of how these macros should be used in your source
code.
<P>

<DT><CODE>AC_HEADER_STDC</CODE>
<DD>This macro defines the C preprocessor macro <CODE>STDC_HEADERS</CODE> if the
system has the ANSI standard C header files.  It determines this by
testing for the existence of the <TT>`stdlib.h'</TT>, <TT>`stdarg.h'</TT>,
<TT>`string.h'</TT> and <TT>`float.h'</TT> header files and testing if
<TT>`string.h'</TT> declares <CODE>memchr</CODE>, <TT>`stdlib.h'</TT> declares
<CODE>free</CODE>, and <TT>`ctype.h'</TT> macros such as <CODE>isdigit</CODE> work with
8-bit characters.
<P>

<DT><CODE>AC_INIT(<VAR>filename</VAR>)</CODE>
<DD>This macro performs essential initialization for the generated
<TT>`configure'</TT> script.  An optional argument may provide the name of a
file from the source directory to ensure that the directory has been
specified correctly.
<P>

<DT><CODE>AC_LIBTOOL_DLOPEN</CODE>
<DD>Call this macro before <CODE>AC_PROG_LIBTOOL</CODE> to indicate that your
package wants to use Libtool's support for <CODE>dlopen</CODE>ed modules.
<P>

<DT><CODE>AC_LIBTOOL_WIN32_DLL</CODE>
<DD>Call this macro before <CODE>AC_PROG_LIBTOOL</CODE> to indicate that your
package has been written to build DLLs on Windows.  If this macro
is not called, Libtool will only build static libraries on Windows.
<P>

<DT><CODE>AC_LIB_LTDL</CODE>
<DD>This macro does the <CODE>configure</CODE>-time checks needed to cause
<TT>`ltdl.c'</TT> to be compiled correctly.  That is, this is used to enable
dynamic loading via <CODE>libltdl</CODE>.
<P>

<DT><CODE>AC_LINK_FILES(<VAR>source-list</VAR>, <VAR>dest-list</VAR>)</CODE>
<DD>Use this macro to create a set of links; if possible, symlinks are made.
The two arguments are parallel lists: the first element of
<VAR>dest-list</VAR> is the name of a to-be-created link whose target is the
first element of <VAR>source-list</VAR>.
<P>

<DT><CODE>AC_MSG_CHECKING(<VAR>message</VAR>)</CODE>
<DD>This macro outputs a message to the user in the usual style of
<TT>`configure'</TT> scripts: leading with the word <SAMP>`checking'</SAMP> and
ending in <SAMP>`...'</SAMP>.  This message gives the user an indication that
the <TT>`configure'</TT> script is still working.  A subsequent invocation
of <CODE>AC_MSG_RESULT</CODE> should be used to output the result of a test.
<P>

<DT><CODE>AC_MSG_ERROR(<VAR>message</VAR>)</CODE>
<DD>This macro outputs an error message to standard error and aborts the
<TT>`configure'</TT> script.  It should only be used for fatal error
conditions.
<P>

<DT><CODE>AC_MSG_RESULT(<VAR>message</VAR>)</CODE>
<DD>This macro should be invoked after a corresponding invocation of
<CODE>AC_MSG_CHECKING</CODE> with the result of a test.  Often the result
string can be as simple as <SAMP>`yes'</SAMP> or <SAMP>`no'</SAMP>.
<P>

<DT><CODE>AC_MSG_WARN(<VAR>message</VAR>)</CODE>
<DD>This macro outputs a warning to standard error, but allows the
<TT>`configure'</TT> script to continue.  It should be used to notify the
user of abnormal, but non-fatal, conditions.
<P>

<DT><CODE>AC_OBJEXT</CODE>
<DD>Sets the output variable <CODE>OBJEXT</CODE> to the extension of object files
produced by the compiler.  Usually, it is set to <SAMP>`.o'</SAMP> on Unix
systems and <SAMP>`.obj'</SAMP> on Windows.
<P>

<DT><CODE>AC_OUTPUT(<VAR>files</VAR>, [<VAR>extra-commands</VAR>], [<VAR>init-commands</VAR>])</CODE>
<DD>This macro must be called at the end of every <TT>`configure.in'</TT>.  It
creates each file listed in <VAR>files</VAR>.  For a given file, by default,
<CODE>configure</CODE> reads the template file whose name is the name of the
input file with <SAMP>`.in'</SAMP> appended -- for instance, <TT>`Makefile'</TT> is
generated from <TT>`Makefile.in'</TT>.  This default can be overridden by
using a special naming convention for the file.
<P>

For each name <SAMP>`foo'</SAMP> given as an argument to <CODE>AC_SUBST</CODE>,
<CODE>configure</CODE> will replace any occurrence of <SAMP>`@foo@'</SAMP> in the
template file with the value of the shell variable <SAMP>`foo'</SAMP> in the
generated file.  This macro also generates the config header, if
<CODE>AC_CONFIG_HEADER</CODE> was called, and any links, if
<CODE>AC_LINK_FILES</CODE> was called.  The additional arguments can be used
to further tailor the output processing.
</P><P>

<DT><CODE>AC_OUTPUT_COMMANDS(<VAR>extra-commands</VAR>, [<VAR>init-commands</VAR>])</CODE>
<DD>This macro works like the optional final arguments of <CODE>AC_OUTPUT</CODE>,
except that it can be called more than once from <TT>`configure.in'</TT>.
(This makes it possible for macros to use this feature and yet remain
modular.)  See the reference manual for the precise definition of this
macro.
<P>