This is an automated email from the git hooks/post-receive script. It was generated because a ref change was pushed to the repository containing the project "MPICH primary repository". The branch, master has been updated via 4d106d4b77560638cfae0c6b98259376d1394dbd (commit) from a80bf84aecfc6c6152474623d418b2a3cb71fd53 (commit) Those revisions listed above that are new to this repository have not appeared on any other notification email; so we list those revisions in full, below. - Log ----------------------------------------------------------------- http://git.mpich.org/mpich.git/commitdiff/4d106d4b77560638cfae0c6b98259376d1... commit 4d106d4b77560638cfae0c6b98259376d1394dbd Author: Pavan Balaji <[email protected]> Date: Wed Apr 9 16:21:37 2014 -0500 Added more information on mpiexec to the user guide. Signed-off-by: Wesley Bland <[email protected]> diff --git a/doc/userguide/user.tex.vin b/doc/userguide/user.tex.vin index 80c2e8b..21b2b89 100644 --- a/doc/userguide/user.tex.vin +++ b/doc/userguide/user.tex.vin @@ -236,33 +236,35 @@ provides some extensions. \label{sec:mpiexec-standard} Here we describe the standard \texttt{mpiexec} arguments from the MPI -Standard~\cite{mpi-forum:mpi2-journal}. The simplest form of a -command to start an MPI job is +Standard~\cite{mpi-forum:mpi2-journal}. To run a program with 'n' +processes on your local machine, you can use: \begin{verbatim} - mpiexec -f machinefile -n 32 a.out + mpiexec -n <number> ./a.out \end{verbatim} -to start the executable \texttt{a.out} with 32 processes (providing an -\texttt{MPI\_COMM\_WORLD} of size 32 inside the MPI application). -Other options are supported, for search paths for executables, working -directories, and even a more general way of specifying a number of -processes. Multiple sets of processes can be run with different -executables and different values for their arguments, with -``\texttt{:}'' separating the sets of processes, as in: +To test that you can run an 'n' process job on multiple nodes: \begin{verbatim} - mpiexec -f machinefile -n 1 ./master : -n 32 ./slave + mpiexec -f machinefile -n <number> ./a.out \end{verbatim} -It is also possible to start a one process MPI job (with a -\texttt{MPI\_COMM\_WORLD} whose size is equal to 1), without using -\texttt{mpiexec}. This process will become an MPI process when it -calls \texttt{MPI\_Init}, and it may then call other MPI functions. -Currently, MPICH does not fully support calling the dynamic process -routines from the MPI standard (e.g., \texttt{MPI\_Comm\_spawn} or -\texttt{MPI\_Comm\_accept}) from processes that are not started with -\texttt{mpiexec}. +The 'machinefile' is of the form: + +\begin{verbatim} + host1 + host2:2 + host3:4 # Random comments + host4:1 +\end{verbatim} + +'host1', 'host2', 'host3' and 'host4' are the hostnames of the +machines you want to run the job on. The ':2', ':4', ':1' segments +depict the number of processes you want to run on each node. If +nothing is specified, ':1' is assumed. + +More details on interacting with Hydra can be found at +\url{http://wiki.mpich.org/mpich/index.php/Using_the_Hydra_Process_Manager} \subsection{Extensions for All Process Management Environments} ----------------------------------------------------------------------- Summary of changes: doc/userguide/user.tex.vin | 40 +++++++++++++++++++++------------------- 1 files changed, 21 insertions(+), 19 deletions(-) hooks/post-receive -- MPICH primary repository