Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Added documentation of the --cfg="smpi/simulation_computation" feature of mpirun
authorHenri Casanova <henric@hawaii.edu>
Mon, 12 May 2014 19:30:23 +0000 (09:30 -1000)
committerHenri Casanova <henric@hawaii.edu>
Mon, 12 May 2014 19:30:23 +0000 (09:30 -1000)
doc/doxygen/options.doc

index edb44a1..ee5d6a2 100644 (file)
@@ -576,6 +576,21 @@ simulate the behavior of most of the existing MPI libraries. The \b smpi/coll_se
 uses naive version of collective operations). Each collective operation can be manually selected with a 
 \b smpi/collective_name:algo_name. Available algorithms are listed in \ref SMPI_collective_algorithms .
 
 uses naive version of collective operations). Each collective operation can be manually selected with a 
 \b smpi/collective_name:algo_name. Available algorithms are listed in \ref SMPI_collective_algorithms .
 
+\subsection options_model_smpi_computation_simulation Benchmarking/simulating application computation
+
+By default, SMPI benchmarks computational phases of the simulated application (i.e., CPU bursts in 
+between MPI calls) so that these phases can be simulated. In some cases, however, one may wish to
+disable simulation of application computation. This is the case when SMPI is used not to simulate
+an MPI applications, but instead an MPI code that performs "live replay" of another MPI app (e.g., 
+ScalaTrace's replay tool, various on-line simulators that run an app at scale). In this case the 
+computation of the replay/simulation logic should not be simulated by SMPI. Instead, the replay 
+tool or on-line simulator will issue "computation events", which correspond to the actual MPI simulation 
+being replayed/simulated. At the moment, these computation events can be simulated using SMPI by 
+calling internal smpi_execute*() functions. 
+
+To disable the benchmarking/simulation of computation in the simulated application via this runtime automatic 
+switching, the variable \b smpi/privatize_global_variables should be set to no
+
 \section options_generic Configuring other aspects of SimGrid
 
 \subsection options_generic_path XML file inclusion path
 \section options_generic Configuring other aspects of SimGrid
 
 \subsection options_generic_path XML file inclusion path