From b21937249bc59f231dc189493c43e08ff91b0b8a Mon Sep 17 00:00:00 2001 From: Henri Casanova Date: Mon, 12 May 2014 09:30:23 -1000 Subject: [PATCH] Added documentation of the --cfg="smpi/simulation_computation" feature of mpirun --- doc/doxygen/options.doc | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/doc/doxygen/options.doc b/doc/doxygen/options.doc index edb44a13cd..ee5d6a25e9 100644 --- a/doc/doxygen/options.doc +++ b/doc/doxygen/options.doc @@ -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 . +\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 -- 2.20.1