|
|
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
|
|
|
|
|
|
|
|
|
|
<!--Converted with LaTeX2HTML 2012 (1.2)
|
|
|
|
|
original version by: Nikos Drakos, CBLU, University of Leeds
|
|
|
|
|
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
|
|
|
|
|
* with significant contributions from:
|
|
|
|
|
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
|
|
|
|
|
<HTML>
|
|
|
|
|
<HEAD>
|
|
|
|
|
<TITLE>Configuration options</TITLE>
|
|
|
|
|
<META NAME="description" CONTENT="Configuration options">
|
|
|
|
|
<META NAME="keywords" CONTENT="userhtml">
|
|
|
|
|
<META NAME="resource-type" CONTENT="document">
|
|
|
|
|
<META NAME="distribution" CONTENT="global">
|
|
|
|
|
|
|
|
|
|
<META NAME="Generator" CONTENT="LaTeX2HTML v2012">
|
|
|
|
|
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
|
|
|
|
|
|
|
|
|
|
<LINK REL="STYLESHEET" HREF="userhtml.css">
|
|
|
|
|
|
|
|
|
|
<LINK REL="next" HREF="node9.html">
|
|
|
|
|
<LINK REL="previous" HREF="node7.html">
|
|
|
|
|
<LINK REL="up" HREF="node5.html">
|
|
|
|
|
<LINK REL="next" HREF="node9.html">
|
|
|
|
|
</HEAD>
|
|
|
|
|
|
|
|
|
|
<BODY >
|
|
|
|
|
<!--Navigation Panel-->
|
|
|
|
|
<A NAME="tex2html163"
|
|
|
|
|
HREF="node9.html">
|
|
|
|
|
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
|
|
|
|
<A NAME="tex2html159"
|
|
|
|
|
HREF="node5.html">
|
|
|
|
|
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
|
|
|
|
<A NAME="tex2html153"
|
|
|
|
|
HREF="node7.html">
|
|
|
|
|
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
|
|
|
|
<A NAME="tex2html161"
|
|
|
|
|
HREF="node2.html">
|
|
|
|
|
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
|
|
|
|
<BR>
|
|
|
|
|
<B> Next:</B> <A NAME="tex2html164"
|
|
|
|
|
HREF="node9.html">Bug reporting</A>
|
|
|
|
|
<B> Up:</B> <A NAME="tex2html160"
|
|
|
|
|
HREF="node5.html">Configuring and Building MLD2P4</A>
|
|
|
|
|
<B> Previous:</B> <A NAME="tex2html154"
|
|
|
|
|
HREF="node7.html">Optional third party libraries</A>
|
|
|
|
|
<B> <A NAME="tex2html162"
|
|
|
|
|
HREF="node2.html">Contents</A></B>
|
|
|
|
|
<BR>
|
|
|
|
|
<BR>
|
|
|
|
|
<!--End of Navigation Panel-->
|
|
|
|
|
|
|
|
|
|
<H2><A NAME="SECTION00053000000000000000">
|
|
|
|
|
Configuration options</A>
|
|
|
|
|
</H2>
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
|
To build MLD2P4 the first step is to use the <code>configure</code> script
|
|
|
|
|
in the main directory to generate the necessary makefile(s).
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
|
As a minimal example consider the following:
|
|
|
|
|
<PRE>
|
|
|
|
|
./configure --with-psblas=PSB-INSTALL-DIR
|
|
|
|
|
</PRE>
|
|
|
|
|
which assumes that the various MPI compilers and support libraries are
|
|
|
|
|
available in the standard directories on the system, and specifies
|
|
|
|
|
only the PSBLAS install directory (note that the latter directory must
|
|
|
|
|
be specified with an <EM>absolute</EM> path).
|
|
|
|
|
The full set of options may be looked at by issuing the command
|
|
|
|
|
<code>./configure --help</code>, which produces:
|
|
|
|
|
<PRE>
|
|
|
|
|
`configure' configures MLD2P4 2.0 to adapt to many kinds of systems.
|
|
|
|
|
|
|
|
|
|
Usage: ./configure [OPTION]... [VAR=VALUE]...
|
|
|
|
|
|
|
|
|
|
To assign environment variables (e.g., CC, CFLAGS...), specify them as
|
|
|
|
|
VAR=VALUE. See below for descriptions of some of the useful variables.
|
|
|
|
|
|
|
|
|
|
Defaults for the options are specified in brackets.
|
|
|
|
|
|
|
|
|
|
Configuration:
|
|
|
|
|
-h, --help display this help and exit
|
|
|
|
|
--help=short display options specific to this package
|
|
|
|
|
--help=recursive display the short help of all the included packages
|
|
|
|
|
-V, --version display version information and exit
|
|
|
|
|
-q, --quiet, --silent do not print `checking...' messages
|
|
|
|
|
--cache-file=FILE cache test results in FILE [disabled]
|
|
|
|
|
-C, --config-cache alias for `--cache-file=config.cache'
|
|
|
|
|
-n, --no-create do not create output files
|
|
|
|
|
--srcdir=DIR find the sources in DIR [configure dir or `..']
|
|
|
|
|
|
|
|
|
|
Installation directories:
|
|
|
|
|
--prefix=PREFIX install architecture-independent files in PREFIX
|
|
|
|
|
[/usr/local]
|
|
|
|
|
--exec-prefix=EPREFIX install architecture-dependent files in EPREFIX
|
|
|
|
|
[PREFIX]
|
|
|
|
|
|
|
|
|
|
By default, `make install' will install all the files in
|
|
|
|
|
`/usr/local/bin', `/usr/local/lib' etc. You can specify
|
|
|
|
|
an installation prefix other than `/usr/local' using `--prefix',
|
|
|
|
|
for instance `--prefix=$HOME'.
|
|
|
|
|
|
|
|
|
|
For better control, use the options below.
|
|
|
|
|
|
|
|
|
|
Fine tuning of the installation directories:
|
|
|
|
|
--bindir=DIR user executables [EPREFIX/bin]
|
|
|
|
|
--sbindir=DIR system admin executables [EPREFIX/sbin]
|
|
|
|
|
--libexecdir=DIR program executables [EPREFIX/libexec]
|
|
|
|
|
--sysconfdir=DIR read-only single-machine data [PREFIX/etc]
|
|
|
|
|
--sharedstatedir=DIR modifiable architecture-independent data [PREFIX/com]
|
|
|
|
|
--localstatedir=DIR modifiable single-machine data [PREFIX/var]
|
|
|
|
|
--libdir=DIR object code libraries [EPREFIX/lib]
|
|
|
|
|
--includedir=DIR C header files [PREFIX/include]
|
|
|
|
|
--oldincludedir=DIR C header files for non-gcc [/usr/include]
|
|
|
|
|
--datarootdir=DIR read-only arch.-independent data root [PREFIX/share]
|
|
|
|
|
--datadir=DIR read-only architecture-independent data [DATAROOTDIR]
|
|
|
|
|
--infodir=DIR info documentation [DATAROOTDIR/info]
|
|
|
|
|
--localedir=DIR locale-dependent data [DATAROOTDIR/locale]
|
|
|
|
|
--mandir=DIR man documentation [DATAROOTDIR/man]
|
|
|
|
|
--docdir=DIR documentation root [DATAROOTDIR/doc/mld2p4]
|
|
|
|
|
--htmldir=DIR html documentation [DOCDIR]
|
|
|
|
|
--dvidir=DIR dvi documentation [DOCDIR]
|
|
|
|
|
--pdfdir=DIR pdf documentation [DOCDIR]
|
|
|
|
|
--psdir=DIR ps documentation [DOCDIR]
|
|
|
|
|
|
|
|
|
|
Optional Features:
|
|
|
|
|
--disable-option-checking ignore unrecognized --enable/--with options
|
|
|
|
|
--disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no)
|
|
|
|
|
--enable-FEATURE[=ARG] include FEATURE [ARG=yes]
|
|
|
|
|
--enable-serial Specify whether to enable a fake mpi library to run
|
|
|
|
|
in serial mode.
|
|
|
|
|
|
|
|
|
|
Optional Packages:
|
|
|
|
|
--with-PACKAGE[=ARG] use PACKAGE [ARG=yes]
|
|
|
|
|
--without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no)
|
|
|
|
|
--with-psblas=DIR The install directory for PSBLAS, for example,
|
|
|
|
|
--with-psblas=/opt/packages/psblas-3.3
|
|
|
|
|
--with-psblas-incdir=DIR
|
|
|
|
|
Specify the directory for PSBLAS includes.
|
|
|
|
|
--with-psblas-libdir=DIR
|
|
|
|
|
Specify the directory for PSBLAS library.
|
|
|
|
|
--with-extra-libs List additional link flags here. For example,
|
|
|
|
|
--with-extra-libs=-lspecial_system_lib or
|
|
|
|
|
--with-extra-libs=-L/path/to/libs
|
|
|
|
|
--with-mumps=LIBNAME Specify the libname for MUMPS. Default: "-lsmumps
|
|
|
|
|
-ldmumps -lcmumps -lzmumps -lmumps_common -lpord"
|
|
|
|
|
--with-mumpsdir=DIR Specify the directory for MUMPS library and
|
|
|
|
|
includes. Note: you will need to add auxiliary
|
|
|
|
|
libraries with --extra-libs; this depends on how
|
|
|
|
|
MUMPS was configured and installed, at a minimum you
|
|
|
|
|
will need SCALAPACK and BLAS
|
|
|
|
|
--with-mumpsincdir=DIR Specify the directory for MUMPS includes.
|
|
|
|
|
--with-mumpslibdir=DIR Specify the directory for MUMPS library.
|
|
|
|
|
--with-umfpack=LIBNAME Specify the library name for UMFPACK and its support
|
|
|
|
|
libraries. Default: "-lumfpack -lamd"
|
|
|
|
|
--with-umfpackdir=DIR Specify the directory for UMFPACK library and
|
|
|
|
|
includes.
|
|
|
|
|
--with-umfpackincdir=DIR
|
|
|
|
|
Specify the directory for UMFPACK includes.
|
|
|
|
|
--with-umfpacklibdir=DIR
|
|
|
|
|
Specify the directory for UMFPACK library.
|
|
|
|
|
--with-superlu=LIBNAME Specify the library name for SUPERLU library.
|
|
|
|
|
Default: "-lsuperlu"
|
|
|
|
|
--with-superludir=DIR Specify the directory for SUPERLU library and
|
|
|
|
|
includes.
|
|
|
|
|
--with-superluincdir=DIR
|
|
|
|
|
Specify the directory for SUPERLU includes.
|
|
|
|
|
--with-superlulibdir=DIR
|
|
|
|
|
Specify the directory for SUPERLU library.
|
|
|
|
|
--with-superludist=LIBNAME
|
|
|
|
|
Specify the libname for SUPERLUDIST library.
|
|
|
|
|
Requires you also specify SuperLU. Default:
|
|
|
|
|
"-lsuperlu_dist"
|
|
|
|
|
--with-superludistdir=DIR
|
|
|
|
|
Specify the directory for SUPERLUDIST library and
|
|
|
|
|
includes.
|
|
|
|
|
--with-superludistincdir=DIR
|
|
|
|
|
Specify the directory for SUPERLUDIST includes.
|
|
|
|
|
--with-superludistlibdir=DIR
|
|
|
|
|
Specify the directory for SUPERLUDIST library.
|
|
|
|
|
|
|
|
|
|
Some influential environment variables:
|
|
|
|
|
FC Fortran compiler command
|
|
|
|
|
FCFLAGS Fortran compiler flags
|
|
|
|
|
LDFLAGS linker flags, e.g. -L<lib dir> if you have libraries in a
|
|
|
|
|
nonstandard directory <lib dir>
|
|
|
|
|
LIBS libraries to pass to the linker, e.g. -l<library>
|
|
|
|
|
CC C compiler command
|
|
|
|
|
CFLAGS C compiler flags
|
|
|
|
|
CPPFLAGS C/C++/Objective C preprocessor flags, e.g. -I<include dir> if
|
|
|
|
|
you have headers in a nonstandard directory <include dir>
|
|
|
|
|
CPP C preprocessor
|
|
|
|
|
MPICC MPI C compiler command
|
|
|
|
|
F77 Fortran 77 compiler command
|
|
|
|
|
FFLAGS Fortran 77 compiler flags
|
|
|
|
|
MPIF77 MPI Fortran 77 compiler command
|
|
|
|
|
MPIFC MPI Fortran compiler command
|
|
|
|
|
|
|
|
|
|
Use these variables to override the choices made by `configure' or to help
|
|
|
|
|
it to find libraries and programs with nonstandard names/locations.
|
|
|
|
|
|
|
|
|
|
Report bugs to <bugreport@mld2p4.it>.
|
|
|
|
|
</PRE>
|
|
|
|
|
For instance, if a user has built and installed PSBLAS 3.4 under the
|
|
|
|
|
<code>/opt</code> directory and is
|
|
|
|
|
using the SuiteSparse package (which includes UMFPACK), then MLD2P4
|
|
|
|
|
might be configured with:
|
|
|
|
|
<PRE>
|
|
|
|
|
./configure --with-psblas=/opt/psblas-3.4/ \
|
|
|
|
|
--with-umfpackincdir=/usr/include/suitesparse
|
|
|
|
|
</PRE>
|
|
|
|
|
Once the configure script has completed execution, it will have
|
|
|
|
|
generated the file <code>Make.inc</code> which will then be used by all
|
|
|
|
|
Makefiles in the directory tree; this file will be copied in the
|
|
|
|
|
install directory under the name <code>Make.inc.MLD2P4</code>.
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
|
To use the MUMPS solver package,
|
|
|
|
|
the user has to add the appropriate options to the configure script;
|
|
|
|
|
by default we are looking for the libraries
|
|
|
|
|
<code>-ldmumps -lsmumps -lzmumps -lzmumps -mumps_common -lpord</code>.
|
|
|
|
|
MUMPS often uses additional packages such as ScaLAPACK, ParMETIS,
|
|
|
|
|
SCOTCH, as well as enabling OpenMP; in such cases it is necessary to
|
|
|
|
|
add linker options with the <code>--with-extra-libs</code> configure option.
|
|
|
|
|
|
|
|
|
|
<P>
|
|
|
|
|
To build the library the user will now enter
|
|
|
|
|
<PRE>
|
|
|
|
|
make
|
|
|
|
|
</PRE>
|
|
|
|
|
followed (optionally) by
|
|
|
|
|
<PRE>
|
|
|
|
|
make install
|
|
|
|
|
</PRE><HR>
|
|
|
|
|
<!--Navigation Panel-->
|
|
|
|
|
<A NAME="tex2html163"
|
|
|
|
|
HREF="node9.html">
|
|
|
|
|
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A>
|
|
|
|
|
<A NAME="tex2html159"
|
|
|
|
|
HREF="node5.html">
|
|
|
|
|
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A>
|
|
|
|
|
<A NAME="tex2html153"
|
|
|
|
|
HREF="node7.html">
|
|
|
|
|
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A>
|
|
|
|
|
<A NAME="tex2html161"
|
|
|
|
|
HREF="node2.html">
|
|
|
|
|
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A>
|
|
|
|
|
<BR>
|
|
|
|
|
<B> Next:</B> <A NAME="tex2html164"
|
|
|
|
|
HREF="node9.html">Bug reporting</A>
|
|
|
|
|
<B> Up:</B> <A NAME="tex2html160"
|
|
|
|
|
HREF="node5.html">Configuring and Building MLD2P4</A>
|
|
|
|
|
<B> Previous:</B> <A NAME="tex2html154"
|
|
|
|
|
HREF="node7.html">Optional third party libraries</A>
|
|
|
|
|
<B> <A NAME="tex2html162"
|
|
|
|
|
HREF="node2.html">Contents</A></B>
|
|
|
|
|
<!--End of Navigation Panel-->
|
|
|
|
|
|
|
|
|
|
</BODY>
|
|
|
|
|
</HTML>
|
