X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/d155fd69fa99c97b3a9c86bb7f2e472c2e7332df..43dbd9c095917af4d42088ffd086f6f759ece83c:/doc/doxygen/tracing.doc
diff --git a/doc/doxygen/tracing.doc b/doc/doxygen/tracing.doc
index 418b1037b8..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
@@ -108,7 +92,7 @@ tracing
Safe switch. It activates (or deactivates) the tracing system.
No other tracing options take effect if this one is not activated.
\verbatim
---cfg=tracing:1
+--cfg=tracing:yes
\endverbatim
\li \c
@@ -117,7 +101,7 @@ tracing/categorized
It activates the categorized resource utilization tracing. It should
be enabled if tracing categories are used by this simulator.
\verbatim
---cfg=tracing/categorized:1
+--cfg=tracing/categorized:yes
\endverbatim
\li \c
@@ -127,7 +111,7 @@ tracing/uncategorized
this simulator do not use tracing categories and resource use have to be
traced.
\verbatim
---cfg=tracing/uncategorized:1
+--cfg=tracing/uncategorized:yes
\endverbatim
\li \c
@@ -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:1
-\endverbatim
-
\li \c
tracing/smpi
:
@@ -162,7 +135,7 @@ tracing/smpi
visualizations. Every MPI function (implemented by SMPI) is transformed in a
state, and point-to-point communications can be analyzed with arrows.
\verbatim
---cfg=tracing/smpi:1
+--cfg=tracing/smpi:yes
\endverbatim
\li \c
@@ -171,7 +144,66 @@ tracing/smpi/group
This option only has effect if this simulator is SMPI-based. The processes
are grouped by the hosts where they were executed.
\verbatim
---cfg=tracing/smpi/group:1
+--cfg=tracing/smpi/group:yes
+\endverbatim
+
+\li \c
+tracing/smpi/computing
+:
+ This option only has effect if this simulator is SMPI-based. The parts external
+to SMPI are also outputted to the trace. Provides better way to analyze the data automatically.
+\verbatim
+--cfg=tracing/smpi/computing:yes
+\endverbatim
+
+\li \c
+tracing/smpi/internals
+:
+ This option only has effect if this simulator is SMPI-based. Display internal communications
+happening during a collective MPI call.
+\verbatim
+--cfg=tracing/smpi/internals:yes
+\endverbatim
+
+\li \c
+tracing/smpi/display_sizes
+:
+ This option only has effect if this simulator is SMPI-based. Display the sizes of the messages
+exchanged in the trace, both in the links and on the states. For collective, size means the global size of data sent by the process in general.
+\verbatim
+--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
@@ -181,7 +213,7 @@ tracing/msg/process
behavior of all categorized MSG processes, grouping them by hosts. This option
can be used to track process location if this simulator has process migration.
\verbatim
---cfg=tracing/msg/process:1
+--cfg=tracing/msg/process:yes
\endverbatim
\li \c
@@ -194,7 +226,7 @@ tracing/buffer
impacted if this option is activated, but you are sure to get a trace
file with events sorted.
\verbatim
---cfg=tracing/buffer:1
+--cfg=tracing/buffer:yes
\endverbatim
\li \c
@@ -207,7 +239,23 @@ option is activated, only the routes with one link are used to
register the topology within an AS. Routes among AS continue to be
traced as usual.
\verbatim
---cfg=tracing/onelink_only:1
+--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
@@ -217,7 +265,7 @@ Disable the destruction of containers at the end of simulation. This
can be used with simulators that have a different notion of time
(different from the simulated time).
\verbatim
---cfg=tracing/disable_destroy:1
+--cfg=tracing/disable_destroy:yes
\endverbatim
\li \c
@@ -228,7 +276,7 @@ Use this option if you are using one of these tools to visualize the simulation
trace. Keep in mind that the trace might be incomplete, without all the
information that would be registered otherwise.
\verbatim
---cfg=tracing/basic:1
+--cfg=tracing/basic:yes
\endverbatim
\li \c
@@ -247,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
:
@@ -280,8 +352,8 @@ with the following parameters (it will work with any Simgrid
simulator):
\verbatim
./your_simulator \
- --cfg=tracing:1 \
- --cfg=tracing/uncategorized:1 \
+ --cfg=tracing:yes \
+ --cfg=tracing/uncategorized:yes \
--cfg=tracing/filename:mytracefile.trace \
--cfg=viva/uncategorized:uncat.plist
\endverbatim
@@ -295,8 +367,8 @@ using the MSG_task_set_category (...)
recompiling, run your simulator with the following parameters:
\verbatim
./your_simulator \
- --cfg=tracing:1 \
- --cfg=tracing/categorized:1 \
+ --cfg=tracing:yes \
+ --cfg=tracing/categorized:yes \
--cfg=tracing/filename:mytracefile.trace \
--cfg=viva/categorized:cat.plist
\endverbatim
@@ -425,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