Docs: expand coverage of +pemap, including new run addition
authorPhil Miller <mille121@illinois.edu>
Thu, 1 Jul 2010 18:57:51 +0000 (13:57 -0500)
committerPhil Miller <mille121@illinois.edu>
Mon, 5 Jul 2010 19:17:20 +0000 (14:17 -0500)
doc/install/run.tex

index f5c13ba632aec014be91b23bfe7041fae752bd9b..30554e92aff326a8dd262a26abc62ace827fa5ce 100644 (file)
@@ -178,14 +178,22 @@ network and MPI versions, smp and non-smp versions.
 
 \item[{\tt +excludecore <core \#>}]       does not set cpu affinity for the given core number. One can use this option multiple times to provide a list of core numbers to avoid.
 
-\item[{\tt +pemap lb-ub[:s][,...]}] Bind the execution threads to the
-  sequence of cores described by the arguments using the operating
-  system's CPU affinity functions. A single number identifies a
-  particular core. Two numbers separated by a dash identify an
-  inclusive range. If they are followed by a colon and another number,
-  that range will be stepped through in increments of the additional
-  number. For example, the sequence {\tt 0-8:2,16,20-24} includes
-  cores 0, 2, 4, 6, 8, 16, 20, 21, 22, 23, 24.
+\item[{\tt +pemap L[-U[:S[.R]]][,...]}] Bind the execution threads to
+  the sequence of cores described by the arguments using the operating
+  system's CPU affinity functions.
+
+A single number identifies a particular core. Two numbers separated by
+a dash identify an inclusive range (\emph{lower bound} and \emph{upper
+  bound}). If they are followed by a colon and another number (a
+\emph{stride}), that range will be stepped through in increments of
+the additional number. Within each stride, a dot followed by a
+\emph{run} will indicate how many cores to use from that starting
+point.
+
+For example, the sequence {\tt 0-8:2,16,20-24} includes cores 0, 2, 4,
+6, 8, 16, 20, 21, 22, 23, 24. On a 4-way quad-core system, if one
+wanted to use 3 cores from each socket, one could write this as {\tt
+  0-15:4.3}.
 
 \item[{\tt +commap p[,q,...]}] Bind communication threads to the
   listed cores, one per process.