X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/2885a82f962b6f72f3a3e334ddbf1cf65ec696a0..7b98df0790cc3fec26293ba257f64d94135098c4:/doc/options.doc?ds=sidebyside diff --git a/doc/options.doc b/doc/options.doc index 7ded23d5e7..66c9c9c3a9 100644 --- a/doc/options.doc +++ b/doc/options.doc @@ -205,7 +205,9 @@ pair of interconnected hosts. An example of usable platform is available in examples/msg/gtnets/crosstraffic-p.xml. This is activated through the \b network/crosstraffic item, that -can be set to 0 (disable this feature) or 1 (enable it). +can be set to 0 (disable this feature) or 1 (enable it). + +Note that with the default workstation model this option is activated by default. \subsubsection options_model_network_coord Coordinated-based network models @@ -341,7 +343,41 @@ which value is either: \section options_tracing Configuring the tracing subsystem -(TODO) +The \ref tracing "tracing subsystem" can be configured in several +different ways depending on the nature of the simulator (MSG, SimDag, +SMPI) and the kind of traces that need to be obtained. See the \ref +tracing_tracing_options "Tracing Configuration Options subsection" to +get a detailed description of each configuration option. + +We detail here a simple way to get the traces working for you, even if +you never used the tracing API. + + +- Any SimGrid-based simulator (MSG, SimDag, SMPI, ...) and raw traces: +\verbatim +--cfg=tracing:1 --cfg=tracing/uncategorized:1 --cfg=triva/uncategorized:uncat.plist +\endverbatim + The first parameter activates the tracing subsystem, the second + tells it to trace host and link utilization (without any + categorization) and the third creates a graph configuration file + to configure Triva when analysing the resulting trace file. + +- MSG or SimDag-based simulator and categorized traces (you need to declare categories and classify your tasks according to them) +\verbatim +--cfg=tracing:1 --cfg=tracing/categorized:1 --cfg=triva/categorized:cat.plist +\endverbatim + The first parameter activates the tracing subsystem, the second + tells it to trace host and link categorized utilization and the + third creates a graph configuration file to configure Triva when + analysing the resulting trace file. + +- SMPI simulator and traces for a space/time view: +\verbatim +smpirun -trace ... +\endverbatim + The -trace parameter for the smpirun script runs the +simulation with --cfg=tracing:1 and --cfg=tracing/smpi:1. Check the +smpirun's -help parameter for additional tracing options. \section options_smpi Configuring SMPI