Configure options

The configure script documents itself in the following way. If you type

    configure -usage 

{ --prefix=dir}

The installation prefix. configure understands all of the usual GNU installation directory arguments, including --libdir and --mandir. We recommend that all users specify an installation directory with --prefix.

{ --with-device=devname}

Set the mpich device to use. devname must be the name of one of the directories in the mpid directory, such as ch_p4, ch_shmem, globus2, or ch_p4mpd.

{ --enable-g}

Add the -g option to the compile scripts. This is a prerequisite for using most debuggers, including dbx, and gdb. It is also needed for mpigdb.

{ --enable-debug}

Turn on support for the Totalview(c) Debugger. This allows Totalview to display information on message queues.

{ --enable-sharedlib}

Build both static and shared libraries for mpich. This supports only a few systems, including those using gcc (e.g., most Linux Beowulf systems).

{ -automountfix=program}

This is sometimes necessary for systems with automounter problems (see Section Dealing with automounters ).

Normally, you should use configure with as few arguments as you can. If you leave all arguments off, configure will usually guess the correct architecture (arch) unless you are in a cross-compiling environment, and will usually choose an appropriate device (device) as well. Where TCP/IP is an appropriate mechanism for communication, the TCP device (ch_p4) will be chosen by default.

MPI and PMPI routines

The MPI standard requires that each routine be available with both the MPI and PMPI prefix; for example, MPI_Send and PMPI_Send. Mpich attempts to use weak symbols to provide this feature; this reduces the size of the mpich library. You can force mpich to make separate libraries for the MPI and PMPI versions by adding the configure option --disable-weak-symbols:

   configure --disable-weak-symbols ... 

Configuring mpich for use with threads

The mpich implementation of MPI is currently not threadsafe. It may, however, be possible to use mpich in a threaded application as long as all mpich calls are made by a single thread. An example of this is OpenMP used for loop parallelism, combined with MPI.

Signals

In general, users should avoid using signals with MPI programs. The manual page for MPI_Init describes the signals that are used by the MPI implementation; these should not be changed by the user.

Because Unix does not chain signals, there is the possibility that several packages will attempt to use the same signal, causing the program to fail. For example, by default, the ch_p4 device uses SIGUSR1; some thread packages also use SIGUSR1.

In a few cases, you can change the signal before calling MPI_Init. In those cases, your signal handler will be called after the mpich implementation acts on the signal. For example, if you want to change the behavior of SIGSEGV to print a message, you can establish such a signal handler before calling MPI_Init. With devices such as the ch_p4 device that handle SIGSEGV, this will cause your signal handler to be called after mpich processes it.