X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/251b0d76ec452c40978a1176bfa53818279f6492..be9e2448e349241982731436b921edb8b09cd146:/doc/doxygen/options.doc diff --git a/doc/doxygen/options.doc b/doc/doxygen/options.doc index b17f065a65..45b5624a56 100644 --- a/doc/doxygen/options.doc +++ b/doc/doxygen/options.doc @@ -139,7 +139,8 @@ when using SimDag. - \b compound: Host model that is automatically chosen if you change the network and CPU models - \b ptask_L07: Host model somehow similar to Cas01+CM02 but - allowing parallel tasks + allowing "parallel tasks", that are intended to model the moldable + tasks of the grid scheduling literature. \subsection options_generic_plugin Plugins @@ -844,6 +845,30 @@ This is the default value: 1. http://simgrid.gforge.inria.fr/contrib/smpi-calibration-doc.html 2. http://simgrid.gforge.inria.fr/contrib/smpi-saturation-doc.html +\subsection options_smpi_papi_events smpi/papi-events: Trace hardware counters with PAPI + +\warning + This option is experimental and will be subject to change. + This feature currently requires superuser privileges, as registers are queried. + Only use this feature with code you trust! Call smpirun for instance via + smpirun -wrapper "sudo " + or run sudo sh -c "echo 0 > /proc/sys/kernel/perf_event_paranoid" + In the later case, sudo will not be required. + +\note + This option is only available when SimGrid was compiled with PAPI support. + +This option takes the names of PAPI counters and adds their respective values +to the trace files. (See Section \ref tracing_tracing_options.) + +It is planned to make this feature available on a per-process (or per-thread?) basis. +The first draft, however, just implements a "global" (i.e., for all processes) set +of counters, the "default" set. + +\verbatim +--cfg=smpi/papi-events:"default:PAPI_L3_LDM:PAPI_L2_LDM" +\endverbatim + \subsection options_smpi_global smpi/privatize-global-variables: Automatic privatization of global variables MPI executables are meant to be executed in separated processes, but SMPI is @@ -873,6 +898,9 @@ To avoid this, several options are possible : To use this runtime automatic switching, the variable \b smpi/privatize-global-variables should be set to yes +\warning + This configuration option cannot be set in your platform file. You can only + pass it as an argument to smpirun. \subsection options_model_smpi_detached Simulating MPI detached send @@ -1051,13 +1079,16 @@ when \b verbose-exit is set to 0 (it is to 1 by default). \subsection options_exception_cutpath Truncate local path from exception backtrace -This configuration option is an internal option and should normally not be used -by the user. It is used to remove the path from the backtrace -shown when an exception is thrown; if we didn't remove this part, the tests -testing the exception parts of simgrid would fail on most machines, as we are -currently comparing output. Clearly, the path used on different machines are almost -guaranteed to be different and hence, the output would -mismatch, causing the test to fail. +\verbatim +--cfg=exceptions/cutpath:1 +\endverbatim + +This configuration option is used to remove the path from the +backtrace shown when an exception is thrown. This is mainly useful for +the tests: the full file path makes the tests not reproducible, and +thus failing as we are currently comparing output. Clearly, the path +used on different machines are almost guaranteed to be different and +hence, the output would mismatch, causing the test to fail. \section options_log Logging Configuration @@ -1161,6 +1192,7 @@ silently overflow on other parts of the memory. - \c smpi/ois: \ref options_model_smpi_ois - \c smpi/or: \ref options_model_smpi_or - \c smpi/os: \ref options_model_smpi_os +- \c smpi/papi-events: \ref options_smpi_papi_events - \c smpi/privatize-global-variables: \ref options_smpi_global - \c smpi/running-power: \ref options_smpi_bench - \c smpi/send-is-detached-thresh: \ref options_model_smpi_detached