


Up: The MPE Library
Next: MPE Installation Instructions
Previous: The MPE Library
There are 3 types of configure options or switches:
1. MPI implementation switch (mandatory)
2. Generic configure flags (mandatory/optional)
3. User option switches/flags (optional)
By typing
./configure --help
in the top-level mpe directory, a list of flags/switches can be viewed.
Specific MPI implementation switches:
-
--with-mpich=DIR
-
Specifies the top-level directory where
mpich (version 1.0.13 or later) was installed
-
--with-mpichdev=subdir
-
Specifies the subdirectory of which
architecture/device you wish to use
-
--with-lam=DIR
-
Specifies the top-level directory where LAM'S MPI
was installed
-
--with-sp
-
Specifies use of the native IBM POE/MPI implementation
-
--with-sgi
-
Specifies use of the native SGI MPI implementation
-
--with-sgi64
-
Specifies use of the native SGI MPI implementation,
forcing it to compile in 64 bit mode
-
--with-cray
-
Specifies use of the native Cray MPI implementation
If you would like to configure mpe with a MPI implementation not listed
here, you might want to look at how the configure.in in the mpe
directory determines which compilers, libraries, etc. to use for the above MPI
implementations. You can then add your own MPI implementation section to
configure.in. Make sure you type
autoconf
to create a new configure script (The mpe configure script was created
using autoconf 2.13 (patched)). You will also need to add an MPI
implementation
switch. This is achieved through the macro AC_ARG_WITH.
Another option is to use the generic MPI switches which lets you specify your
own MPI include and library directories.
Generic MPI implementation switches:
-
--with-mpiinc=MPI_INC
-
Specifes the MPI include directory---for
example, -I/pkgs/MPI/include
-
--with-mpilibs=MPI_LIBS
-
Specifies MPI Profiling and MPI
libraries---for example, -L$MPI_LIB_DIR -lfmpich -lpmpich -lmpich
The following is not a complete list but some of the more common Generic
Flags:
-
-prefix=DIR
-
Specifies the destination install directory for the
mpeinstall script. If configuring with mpich, it must be the same
install directory as the one given as an option to mpich's configure
or the mpiinstall script in the mpich/util directory. If
omitted, and -prefix was given as an option to the mpich
configure, then this directory will automatically be configured. The
mpeinstall script installs into DIR only the required libraries
and include files, and a small subset of the examples.
(See Section mpeinstall
)
-
-libdir=DIR
-
Specifies the top-level directory where the
mpe libraries will be installed. If this directory does not exist,
it will be created. This flag is mandatory when not using mpich and
irrelevant when using mpich ( -libdir is replaced by
-mpichdev).
-
-bindir=DIR
-
This is only relevant if you will be installing
jumpshot along with the mpe library. This directory will be
passed to jumpshot's configure and will be where jumpshot's
executable will be installed. If configuring with mpich, this is
automatically configured for you. If not, and this flag is omitted, this
directory will be libdir/../bin. If this directory does not exist, it
will be created.
-
--x-includes=DIR
-
This is an optional flag which specifies that X
include files are in DIR. If omitted, the mpe configure will
attempt to locate them.
-
--x-libraries=DIR
-
This is an optional flag which specifies that X
library files are in DIR. If omitted, the mpe configure will
attempt to locate them.
User Option Switches:
-
--enable-echo
-
This switch will turn on strong echoing. The
default is enable=no.
-
--enable-mpe_graphics
-
This switch will allow the
mpe graphics routines to be built. If disabled, the mpe
routines that utilize the X11 graphics will not be built. This is
appropriate for systems that either do not have the X11 include files or
that do not support X11 graphics. The default is enable=yes.
-
--enable-f77
-
This switch will allow the compilation of routines
that require a Fortran compiler. If configuring with mpich, the configure
in the top-level mpich directory will choose the appropriate value
for you. However, it can also be overridden. The default is enable=yes.
-
--enable-debug
-
This switch turns on the debugging and diagnostic
message flags in MPE and SLOG-API code. The default is enable=no.
-
--enable-jumpshot
-
This switch will allow the configuration of the
graphical tool jumpshot. The default for this option is enable=yes.
If this option is enabled, and you are not configuring with mpich, you will
also need to supply the directory path where jumpshot has already been
installed ( --with-jumpshot_home).
-
-enable-buildingmpi
-
This switch indicates that MPE is being
built as part of a larger build of mpich. This turns off tests for the
existence of MPI libraries. This switch is not mandatory.
-
--with-tcldir=TCL_DIR
-
This switch specifies that
tcl is located in TCL_DIR. This can only be version 7
and TCL_DIR must have lib/libtcl.a and
include/tcl.h. These files are only used for nupshot. If
this switch is omitted, the configure in the mpe directory will
attempt to locate these files.
-
--with-tkdir=TK_DIR
-
This switch specifies that tk
is located in TK_DIR. This can only be version 3 if you want
to use nupshot and TK_DIR must have lib/libtcl.a
and include/tk.h. This may be the same as TCL_DIR. If
this switch is omitted, the configure in the mpe directory will
attempt to locate these files.
-
--with-wishloc=WISHLOC
-
This switch specifies the name of the
tcl/tk wish executable. If this switch is omitted, the configure in
the mpe directory will attempt to locate a version. This is used
only for nupshot and upshot. Note: Because tcl and
tk keep changing in incompatible ways, we will eventually be dropping
support for any tool that uses tcl/tk. The newest version of
upshot, jumpshot, is written in Java.
-
--with-jumpshot_home=JUMP_DIR
-
This switch
specifies the path of the top-level directory where jumpshot is
installed. When configuring with mpich, this option is automatically
configured by default. However, it can be overriden. If not configuring
with mpich, then you need to specify the JUMP_DIR in order to
configure jumpshot along with the mpe library.
-
--with-jumpshot_opts=JUMP_OPTS
-
This switch allows
you to pass specific options to jumpshot's configure. Unfortunately,
because of the way autoconf 2 processes multiple arguments with
AC_ARG_WITH, only 1 option may be passed to jumpshot's
configure. If more options are required, then configure jumpshot
separately (See Section MPE Installation Instructions
). To view the
jumpshot options, go to jumpshot's top-level directory and
type ./configure --help or read the INSTALL in that directory.
-
--with-slog_home=SLOG_HOME
-
This switch specifies the path of
the top-level directory where SLOG_API is installed. When configuring
SLOG_API with mpich, the option is automatically configured by default.
However, it can be overridden here.
-
--with-flib_path_leader=FLIB_PATH_LEADER
-
This switch shows
how to specify a Fortran library path. It is configured by default when
configuring with mpich.
-
--with-f77_extra_flag=F77_EXTRA_FLAG
-
This switch is used for
Fortran flags that are to be used for compiling but not linking. Currently,
this is used for the Absoft compiler -f option. If configuring with mpich,
this will be determined for you.
-
--with-cflags=MPE_CFLAGS
-
This is an optional switch for the user
to supply extra CFLAGS to the CC compiler.
-
--with-fflags=MPE_FFLAGS
-
This is an optional switch for the user
to supply extra FFLAGS to the Fortran compiler.



Up: The MPE Library
Next: MPE Installation Instructions
Previous: The MPE Library