Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Merge branch 'master' of git+ssh://scm.gforge.inria.fr//gitroot/simgrid/simgrid
authorHenri Casanova <henric@hawaii.edu>
Mon, 12 May 2014 19:30:55 +0000 (09:30 -1000)
committerHenri Casanova <henric@hawaii.edu>
Mon, 12 May 2014 19:30:55 +0000 (09:30 -1000)
1  2 
doc/doxygen/options.doc

diff --combined doc/doxygen/options.doc
@@@ -518,6 -518,16 +518,16 @@@ second) under which the execution chunk
  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 +565,7 @@@ To avoid this, several options are poss
    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
  
  
@@@ -576,21 -586,6 +586,21 @@@ simulate the behavior of most of the ex
  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
@@@ -653,12 -648,14 +663,14 @@@ It can be done by using XBT. Go to \re
  
  - \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