Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
document the smpi/simulation_computation option and list it in the
authorsuter <frederic.suter@cc.in2p3.fr>
Mon, 12 May 2014 12:44:51 +0000 (14:44 +0200)
committersuter <frederic.suter@cc.in2p3.fr>
Mon, 12 May 2014 12:44:51 +0000 (14:44 +0200)
index (with the one on privatization too)

doc/doxygen/options.doc

index edb44a1..f098946 100644 (file)
@@ -518,6 +518,16 @@ second) under which the execution chunks are not reported to the
 simulation kernel (default value: 1e-6). Please note that in some
 circonstances, this optimization can hinder the simulation accuracy.
 
+If the "application" is in fact doing a "live replay" of another MPI
+app (e.g., ScalaTrace's replay tool, various on-line simulators that
+run an app at scale), the computation due to the replay logic should
+not be simulated by SMPI. In that case the \b
+smpi/simulation_computation item can be set to 'no' causing all the
+compute bursts between MPI calls to be ignored by SMPI. Then only the
+communications are simulated. This implies to add explicit calls to \c
+smpi_execute() in the "application" to simulate computations.
+
+
 \subsection options_smpi_timing Reporting simulation time
 
 Most of the time, you run MPI code through SMPI to compute the time it
@@ -555,7 +565,7 @@ To avoid this, several options are possible :
   linking is advised (but not with the simgrid library, to avoid replicating 
   its own global variables). 
 
-  To use this runtime automatic switching, the variable \b smpi/privatize_global_variables 
+  To use this runtime automatic switching, the variable \b smpi/privatize_global_variables
   should be set to yes
 
 
@@ -638,12 +648,14 @@ It can be done by using XBT. Go to \ref XBT_log for more details.
 
 - \c surf/nthreads: \ref options_model_nthreads
 
+- \c smpi/simulation_computation: \ref options_smpi_bench
 - \c smpi/running_power: \ref options_smpi_bench
 - \c smpi/display_timing: \ref options_smpi_timing
 - \c smpi/cpu_threshold: \ref options_smpi_bench
 - \c smpi/async_small_thres: \ref options_model_network_asyncsend
 - \c smpi/send_is_detached: \ref options_model_smpi_detached
 - \c smpi/coll_selector: \ref options_model_smpi_collectives
+- \c smpi/privatize_global_variables: \ref options_smpi_global
 
 - \c path: \ref options_generic_path
 - \c verbose-exit: \ref options_generic_exit