X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/253aec39d6b6cdae39cd320f47f952b7cd665048..df016dbb4c27e8824d3f108cec36e76cf35eeb06:/doc/doxygen/tracing.doc diff --git a/doc/doxygen/tracing.doc b/doc/doxygen/tracing.doc index 2c4a4d894c..d5f2d01246 100644 --- a/doc/doxygen/tracing.doc +++ b/doc/doxygen/tracing.doc @@ -12,22 +12,6 @@ and analyze them. This part of the user manual explains how the tracing-related features can be enabled and used during the development of simulators using the SimGrid library. -\section tracing_tracing_enabling Enabling using CMake - -With the sources of SimGrid, it is possible to enable the tracing -using the parameter -Denable_tracing=ON when the cmake is -executed. The sections \ref instr_category_functions, \ref -instr_mark_functions, and \ref instr_uservariables_functions describe -all the functions available when this Cmake options is -activated. These functions will have no effect if SimGrid is -configured without this option (they are wiped-out by the -C-preprocessor). - -\verbatim -$ cmake -Denable_tracing=ON . -$ make -\endverbatim - \section instr_category_functions Tracing categories functions The SimGrid library is instrumented so users can trace the platform @@ -143,17 +127,6 @@ tracing/filename \endverbatim If you do not provide this parameter, the trace file will be named simgrid.trace. -\li \c -tracing/onelink_only -: - By default, the tracing system uses all routes in the platform file - to re-create a "graph" of the platform and register it in the trace file. - This option let the user tell the tracing system to use only the routes - that are composed with just one link. -\verbatim ---cfg=tracing/onelink_only:yes -\endverbatim - \li \c tracing/smpi : @@ -201,6 +174,38 @@ exchanged in the trace, both in the links and on the states. For collective, siz --cfg=tracing/smpi/display_sizes:yes \endverbatim +\li \c +tracing/smpi/sleeping +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/smpi/format +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/smpi/format/ti_one_file +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/msg/vm +: +TODO +\verbatim +TODO +\endverbatim + \li \c tracing/msg/process : @@ -237,6 +242,22 @@ traced as usual. --cfg=tracing/onelink_only:yes \endverbatim +\li \c +tracing/disable_link +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/disable_power +: +TODO +\verbatim +TODO +\endverbatim + \li \c tracing/disable_destroy : @@ -274,6 +295,30 @@ Use this to add the contents of a file to the top of the trace file as comment. --cfg=tracing/comment_file:textual_file.txt \endverbatim +\li \c +tracing/precision +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/platform +: +TODO +\verbatim +TODO +\endverbatim + +\li \c +tracing/platform/topology +: +TODO +\verbatim +TODO +\endverbatim + \li \c viva/categorized : @@ -452,7 +497,7 @@ the beggining and size of the time slice. \subsubsection tracing_viva_graph Hierarchical Graph View -As stated above (see section \ref tracing_tracing_analyzing), one +%As stated above (see section \ref tracing_tracing_analyzing), one possibility to analyze SimGrid traces is to use Viva's graph view with a graph configuration to customize the graph according to the traces. A valid graph configuration (we are using the non-XML