Docs: refer to illinois.edu, not uiuc.edu
[charm.git] / doc / charm++ / run.tex
index 967417bfb9c18366cec0d48dc07d3ac61eb7c116..c62b6f30d5e290f880911ed8efc564efa3a6f02c 100644 (file)
@@ -1,8 +1,8 @@
-\section{Executing \charmpp{} Programs}
-\label{executing charm programs}
+\section{Launching Programs with \kw{charmrun}}
+\label{charmrun}
 
 When compiling \charmpp{} programs, the charmc linker produces 
-both an executable file and a program called {\tt charmrun},
+both an executable file and an utility called {\tt charmrun},
 which is used to load the executable onto the parallel machine.
 
 To run a \charmpp{} program named ``pgm'' on four processors, type:
@@ -10,6 +10,10 @@ To run a \charmpp{} program named ``pgm'' on four processors, type:
 charmrun pgm +p4
 \end{alltt}
 
+Execution on platforms which use platform specific launchers, (i.e.,
+{\bf aprun}, {\bf ibrun}), can proceed without charmrun, or charmrun can be used
+in coordination with those launchers via the {\tt ++mpiexec} (see
+\ref{mpiexec} parameter.
 
 Programs built using the network version of \charmpp{} can be run
 alone, without charmrun.  This restricts you to using the processors
@@ -27,7 +31,7 @@ to be set for its execution on compute nodes
 .charmrunrc under home directory. charmrun
 will run that shell script before running the executable.
 
-\subsection[Command Line Options]{Command Line Options}
+\section[Command Line Options]{Command Line Options}
 \label{command line options}
 \index{command line options}
 
@@ -60,7 +64,7 @@ entry point of the main chare.
 
 
 
-\subsubsection{Additional Network Options}
+\subsection{Additional Network Options}
 \label{network command line options}
 
 The following {\tt ++} command line options are available in
@@ -74,7 +78,7 @@ the network version:
 
 
 \item[{\tt ++mpiexec}]
-
+\label{mpiexec}
 Use the cluster's {\tt mpiexec} job launcher instead of the built in rsh/ssh
 method.
 
@@ -164,7 +168,7 @@ time.
 
 \end{description}
 
-\subsubsection{Multicore Options}
+\subsection{Multicore Options}
 
 On multicore platforms, operating systems (by default) are free to move
 processes and threads among cores to balance load. This however sometimes can
@@ -206,7 +210,21 @@ wanted to use 3 cores from each socket, one could write this as {\tt
 
 \end{description}
 
-\subsection{Nodelist file}
+\subsection{IO buffering options}
+\label{io buffer options}
+There may be circumstances where a \charmpp{} application may want to take
+or relinquish control of stdout buffer flushing. Most systems default to
+giving the \charmpp{} runtime control over stdout but a few default to
+giving the application that control. The user can override these system
+defaults with the following runtime options:
+
+\begin{description}
+\item[{\tt +io\_flush\_user}]     User (application) controls stdout flushing
+\item[{\tt +io\_flush\_system}]   The \charmpp{} runtime controls flushing
+\end{description}
+
+
+\section{Nodelist file}
 
 For network of workstations,
 the list of machines to run the program can be specified in a file.  
@@ -262,12 +280,12 @@ Here is a simple nodes file:
 
 \begin{alltt}
         group kale-sun ++cpus 1
-          host charm.cs.uiuc.edu ++shell ssh
-          host dp.cs.uiuc.edu
-          host grace.cs.uiuc.edu
-          host dagger.cs.uiuc.edu
+          host charm.cs.illinois.edu ++shell ssh
+          host dp.cs.illinois.edu
+          host grace.cs.illinois.edu
+          host dagger.cs.illinois.edu
         group kale-sol
-          host beauty.cs.uiuc.edu ++cpus 2
+          host beauty.cs.illinois.edu ++cpus 2
         group main
           host localhost
 \end{alltt}
@@ -321,15 +339,3 @@ follows:
        pathname and appended extension if specified) on all nodes.
 \end{enumerate}
 
-\subsubsection{IO buffering options}
-\label{io buffer options}
-There may be circumstances where a \charmpp{} application may want to take
-or relinquish control of stdout buffer flushing. Most systems default to
-giving the \charmpp{} runtime control over stdout but a few default to
-giving the application that control. The user can override these system
-defaults with the following runtime options:
-
-\begin{description}
-\item[{\tt +io\_flush\_user}]     User (application) controls stdout flushing
-\item[{\tt +io\_flush\_system}]   The \charmpp{} runtime controls flushing
-\end{description}