Configure Options


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.12). You will also need to add a 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.12 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