Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | File List | Namespace Members | Class Members | File Members | Related Pages

# Configure Options

The following detail the configure options for APPSPACK. A complete list of configure options can be generated by typing `configure --help`. See also Configuration, Compilation, and Installation.

## Influential Environmental Variables

- `CXX`

  C++ compiler command

- `CXXFLAGS`

  C++ compiler flags

- `LDFLAGS`

  Specify linker flags

- `CPPFLAGS`

  C/C++ preprocessor flags

- `CXXCPP`

  C++ preprocessor

- `F77`

  Fortran 77 compiler command (used only in configure tests)

- `FFLAGS`

  Fortran 77 compiler flags (used only in configure tests)

## Basic Configure Options

- `--with-cppflags`

  Specify additional preprocessor flags (e.g., "-Dflag -Idir")

- `--with-cxxflags`

  Specify additional C++ flags

- `--with-ldflags`

  Specify additional linker flags (e.g., "-Ldir")

- `--with-libs`

  Specify additional libraries (e.g., "-lfoo")

- `--with-ar`

  Specify a special archiver command, the default is "ar cru".

## MPI Configure Options

MPI is not enabled by default; it must be enabled by specifying appropriate configure options.

Enabling MPI has the following effects.

1. Configure will test for the ability to preprocess the MPI header file. It will also test the ability to link with MPI (unless the `--disable-executables` configure option is specified).

2. Defines HAVE_MPI in the APPSPACK_Config.hpp file that is created by configure.

3. Portions of the APPSPACK library that depends on MPI will then function correctly. This includes the APPSPACK::GCI wrapper for MPI commands, the APPSPACK::Executor::MPI, and pack/unpack functions for the APPSPACK::Parameter objects.

4. The MPI executable will be compiled (unless the `--disable-executables` configure option is specified); see Using the APPSPACK Executables.

MPI can be enabled by using one of the three options below.

- `--with-mpi-compilers[=DIR]` (preferred option)

  Use the MPI compilers (mpicxx or mpiCC, mpicc, and mpif77). If the optional DIR is used to specify a directory, then the MPI compilers in DIR are used.

  Note that for the C++ compiler, it looks for mpicxx first. If it doesn't find that, it defaults to mpiCC.

  If this does not work for your system (i.e., the names are different), each compiler may be specified directly by using the CXX, CC, and F77 environmental variables and then using the `--enable-mpi` option.

  No other MPI configure options should be used with this one.

  Example:

      configure --with-mpi-compilers=/usr/local/mpich-1.2.4/bin

- `--with-mpi=MPIROOT`

  Specify the MPI root directory.

  The include directory is assumed to be `MPIROOT/include` unless `--with-mpi-incdir=DIR` is specified.

  The lib directory is assumed to be `MPIROOT/lib` unless `--with-mpi-libdir=DIR` is specified.

  The library is assumed to be `"-lmpi"` unless ``--with-mpi-libs="LIBS"`` is specified.

  Do not use this with `--with-mpi-compilers` or `--enable-mpi` with this option.

  Example:

      configure --with-mpi=/usr/local/mpich-1.2.4 --with-mpi-libs="-lmpich"

- `--enable-mpi`

  Enables MPI mode. Assumes that the appropriate compilers and libraries have been specified.

  No other MPI configure options should be used with this one.

  Examples:

      configure CXX=/usr/local/mpich-1.2.4/bin/mpiCC CC=/usr/local/mpich-1.2.4/bin/mpicc --enable-mpi

      configure --with-ldflags="-L/usr/local/mpich-1.2.4/lib" \
      --with-cppflags="-I/usr/local/mpich-1.2.4/include" \
      --with-libs="-lmpich" --enable-mpi

## Turning the Executables On or Off

- `--disable-executables`

  No executables are built, only the library. Avoids all the configure tests having to do with linking.

- `--disable-serial`

  The serial executable (`appspack_serial`) is not built.

## Installation-Related Configure Options

- `--prefix=PREFIX`

  Location to install architecture-independent files (like header files).

- `--exec-prefix=PREFIX`

  Location to install architecutre-dependent files (like libraries and executables).

- For more options, type `configure --help` and look at "Fine tuning of the installation directories".

© Sandia Corporation | Site Contact | Privacy and Security

Generated on Wed Dec 14 18:41:05 2005 for APPSPACK 4.0.2 by 1.3.8 written by Dimitri van Heesch, © 1997-2002