From 274e3445992148101b29ae7ca4bb1c7d7ea660e6 Mon Sep 17 00:00:00 2001 From: suter Date: Mon, 12 May 2014 14:44:51 +0200 Subject: [PATCH] document the smpi/simulation_computation option and list it in the index (with the one on privatization too) --- doc/doxygen/options.doc | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/doc/doxygen/options.doc b/doc/doxygen/options.doc index edb44a13cd..f098946ac8 100644 --- a/doc/doxygen/options.doc +++ b/doc/doxygen/options.doc @@ -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 -- 2.20.1