Invoking

The usual way to invoke configure is as follows:

configure host

This prepares the source to be compiled in a host environment with programs and files to be installed in `/usr/local'.

configure prepares the source as you specify by selecting and using script and Makefile fragments prepared in advance, and stored with the source. configure's command line options also allow you to specify other aspects of the source configuration:

-exec_prefix=dir

Configure the source to install host dependent files in dir. This option sets the configure variable exec_prefix. Generated Makefiles will have their exec_prefix variables set to this value. (See section Full descriptions of all installation subdirectories.)

-gas

Configure to use the GNU assembler.

-help

Display a quick summary of how to invoke configure.

-host=host

FIXME-soon: I don't think this option should be documented.

-nfp

No floating point unit available on the target; configure to avoid dependencies on hardware floating point.

-norecursion

Configure only this directory; ignore any subdirectories. This is used by the executable shell script `config.status' to reconfigure the current directory. (see section config.status).

-prefix=dir

Configure the source to install programs and files under directory `dir'. This option sets the configure variable prefix. Generated Makefiles will have their prefix variables set to this value. (See section Full descriptions of all installation subdirectories.)

-program_prefix=string

Configure the source to install certain programs using string as a prefix. This applies to programs which might be used for cross-compilation, such as the compiler and the binutils, and also to programs which have the same name as a common Unix program, such as make. This option sets the configure variable program_prefix. Generated Makefiles will have their program_prefix variables set to this value. (See section Full descriptions of all installation subdirectories.)

-program_suffix=string

Configure the source to install certain programs using string as a suffix. This applies to programs which might be used for cross-compilation.

-program_transform_name=sed-pattern

Configure the source to install certain programs using the names that result from passing the usual name through sed invoked with sed-pattern. This option may be given multiple times; each sed-pattern will be applied in turn. This applies to programs which might be used for cross-compilation. This option sets the configure variable program_transform_name. Generated Makefiles will have their program_transform_name variables set to this value. (See section Full descriptions of all installation subdirectories.)

-recurring

This option is used internally by configure when recurring on subdirectories. Its sole purpose is to suppress status output. You can override this effect with the -verbose option.

-rm

Remove the configuration specified by host and the other command-line options, rather than creating it.

-site=site

Generate Makefiles using site specific Makefile fragments for site. See also section Adding site info.

-srcdir=_dir

Build Makefiles to use the sources located in directory `dir'. The build directory is assumed to be `.'.

-target=target

Requests that the sources be configured to target the target machine. If no target is specified explicitly, the target is assumed to be the same as the host.

-tmpdir=tmpdir

Use the directory tmpdir for configure's temporary files. The default is the value of the environment variable TMPDIR, or `/tmp' if the environment variable is not set.

-verbose

-v

Print status lines for each directory configured. Normally, only the status lines for the initial working directory are printed.

-x

Use MIT style X11 header files and libraries on the host, even if they are not normally available.