@top_srcdir@/examples/msg/tracing/procmig.c \
@top_srcdir@/examples/msg/tracing/trace_platform.c \
@top_srcdir@/examples/msg/tracing/user_variables.c \
+ @top_srcdir@/examples/msg/tracing/link_user_variables.c \
+ @top_srcdir@/examples/msg/tracing/link_srcdst_user_variables.c \
@top_srcdir@/examples/msg/ns3 \
@top_srcdir@/examples/msg/gtnets \
@top_srcdir@/examples/msg/io \
/** @addtogroup MSG_examples
*
- * - <b>tracing/categories.c</b> example with the declaration of multiple categories
+ * - <b>tracing/categories.c</b> This is a master/slave program where the master creates
+ * tasks, send them to the slaves. For each task received, the slave executes
+ * it and then destroys it. This program declares several tracing categories that are
+ * used to classify tasks. When the program is executed, the tracing mechanism registers
+ * the resource utilization of hosts and links according to these categories. You might
+ * want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/categorized:1
+ * --cfg=tracing/uncategorized:1
+ * --cfg=triva/categorized:triva_cat.plist
+ * --cfg=triva/uncategorized:triva_uncat.plist
+ * (See \ref tracing_tracing_options for details)
*/
#include <stdio.h>
#include <msg/msg.h>
+/** @addtogroup MSG_examples
+ *
+ * - <b>tracing/link_srcdst_user_variables.c</b>: This program demonstrates how to
+ * trace user variables associated to the links of the platform file. Instead of
+ * providing the name of the link to update one of its variable, this example shows
+ * how to provide two hosts as parameter (source and destination, use their names as
+ * defined in the platform file). The tracing mechanism will get the route between
+ * these two hosts, if there is one defined in the platform file, and update the variable
+ * of all the links of that route to the value provided.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/platform:1
+ * (See \ref tracing_tracing_options for details)
+ */
+
int master(int argc, char *argv[]);
//dump function to create and execute a task
#include <msg/msg.h>
+/** @addtogroup MSG_examples
+ *
+ * - <b>tracing/link_user_variables.c</b>: This program demonstrates how to
+ * trace user variables associated to the links of the platform file. You need
+ * to provide the name of the link to update the value of the variable associated
+ * to that link.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/platform:1
+ * (See \ref tracing_tracing_options for details)
+ */
+
int master(int argc, char *argv[]);
//dump function to create and execute a task
/** @addtogroup MSG_examples
*
- * - <b>tracing/ms.c</b> TODO
+ * - <b>tracing/ms.c</b> This is a master/slave program where the master creates
+ * tasks, send them to the slaves. For each task received, the slave executes
+ * it and then destroys it. This program uses several tracing functions that
+ * enable the tracing of categorized resource utilization, the use of trace marks,
+ * and user variables associated to the hosts of the platform file.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing/categorized:1
+ * --cfg=tracing/uncategorized:1
+ * --cfg=triva/categorized:triva_cat.plist
+ * --cfg=triva/uncategorized:triva_uncat.plist
+ * (See \ref tracing_tracing_options for details)
*/
#include <stdio.h>
/** @addtogroup MSG_examples
*
- * - <b>tracing/procmig.c</b> example to trace process migration using the mask TRACE_PROCESS
+ * - <b>tracing/procmig.c</b> This program shows a process migration. Tracing
+ * this program with the options below enables a gantt-chart visualization
+ * of where the process has been during its execution. Migrations are represented by
+ * arrows from the origin to the destination host.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/msg/process:1
+ * (See \ref tracing_tracing_options for details)
*/
#include "msg/msg.h" /* core library */
*
* @section MSG_ex_tracing Tracing and vizualization features
*
- * - <b>tracing/simple.c</b> very simple program that creates, executes and destroy a task
+ * - <b>tracing/simple.c</b> very simple program where each process creates, executes and
+ * destroy a task. You might want to run this program with the following parameters:
+ * --cfg=tracing/uncategorized:1
+ * (See \ref tracing_tracing_options for details)
*/
/* Create a log channel to have nice outputs. */
/** @addtogroup MSG_examples
*
- * - <b>tracing/trace_platform.c</b>: Demonstrates how to trace the platform
+ * - <b>tracing/trace_platform.c</b>: This program demonstrates how a
+ * platform file is traced to a Paje trace file format using the tracing
+ * mechanism of Simgrid.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/categorized:1
+ * (See \ref tracing_tracing_options for details)
*/
#include <stdio.h>
/** @addtogroup MSG_examples
*
- * - <b>tracing/user_variables.c</b>: Demonstrates how to trace user-provided variables
+ * - <b>tracing/user_variables.c</b>: This program demonstrates how to
+ * trace user variables associated to the hosts of the platform file.
+ * You might want to run this program with the following parameters:
+ * --cfg=tracing:1
+ * --cfg=tracing/platform:1
+ * (See \ref tracing_tracing_options for details)
*/
#include <stdio.h>