Next: Obsolete Constructs Prev: Running configure Scripts Up: Top
16 config.status Invocation
The `configure' script creates a file named `config.status', which
actually configures, "instantiates", the template files. It also
records the configuration options that were specified when the package
was last configured in case reconfiguring is needed.
./config.status OPTION... [FILE...]
It configures the FILES; if none are specified, all the templates
are instantiated. The files must be specified without their
dependencies, as in
The supported options are:
Print a summary of the command line options, the list of the
template files, and exit.
Print the version number of Autoconf and the configuration
settings, and exit.
Do not print progress messages.
Don't remove the temporary files.
Require that FILE be instantiated as if
`AC_CONFIG_FILES(FILE:TEMPLATE)' was used. Both FILE and TEMPLATE
may be `-' in which case the standard output and/or standard
input, respectively, is used. If a TEMPLATE file name is
relative, it is first looked for in the build tree, and then in
the source tree. Note: Configuration Actions, for more details.
This option and the following ones provide one way for separately
distributed packages to share the values computed by `configure'.
Doing so can be useful if some of the packages need a superset of
the features that one of them, perhaps a common library, does.
These options allow a `config.status' file to create files other
than the ones that its `configure.ac' specifies, so it can be used
for a different package.
Same as `--file' above, but with `AC_CONFIG_HEADERS'.
Ask `config.status' to update itself and exit (no instantiation).
This option is useful if you change `configure', so that the
results of some tests might be different from the previous run.
The `--recheck' option reruns `configure' with the same arguments
you used before, plus the `--no-create' option, which prevents
`configure' from running `config.status' and creating `Makefile'
and other files, and the `--no-recursion' option, which prevents
`configure' from running other `configure' scripts in
subdirectories. (This is so other Make rules can run
`config.status' when it changes; Note: Automatic Remaking, for
`config.status' checks several optional environment variables that
can alter its behavior:
-- Variable: CONFIG_SHELL
The shell with which to run `configure' for the `--recheck'
option. It must be Bourne-compatible. The default is a shell that
supports `LINENO' if available, and `/bin/sh' otherwise. Invoking
`configure' by hand bypasses this setting, so you may need to use
a command like `CONFIG_SHELL=/bin/bash /bin/bash ./configure' to
insure that the same shell is used everywhere. The absolute name
of the shell should be passed.
-- Variable: CONFIG_STATUS
The file name to use for the shell script that records the
configuration. The default is `./config.status'. This variable is
useful when one package uses parts of another and the `configure'
scripts shouldn't be merged because they are maintained separately.
You can use `./config.status' in your makefiles. For example, in
the dependencies given above (Note: Automatic Remaking),
`config.status' is run twice when `configure.ac' has changed. If that
bothers you, you can make each run only regenerate the files for that
stamp-h: config.h.in config.status
echo > stamp-h
Makefile: Makefile.in config.status
The calling convention of `config.status' has changed; see *Note
Obsolete config.status Use::, for details.
automatically generated by info2www