SimGrid
3.7
Scalable simulation of distributed systems
|
Functions to declare tracing categories. More...
Functions | |
void | TRACE_category (const char *category) |
Declare a new category with a random color. | |
void | TRACE_category_with_color (const char *category, const char *color) |
Declare a new category with a color. | |
xbt_dynar_t | TRACE_get_categories (void) |
Get declared categories. |
Functions to declare tracing categories.
void TRACE_category | ( | const char * | category | ) |
Declare a new category with a random color.
This function should be used to define a user category. The category can be used to differentiate the tasks that are created during the simulation (for example, tasks from server1, server2, or request tasks, computation tasks, communication tasks). All resource utilization (host power and link bandwidth) will be classified according to the task category. Tasks that do not belong to a category are not traced. The color for the category that is being declared is random. This function has no effect if a category with the same name has been already declared.
See Tracing Simulations for Visualization for details on how to trace the (categorized) resource utilization.
category | The name of the new tracing category to be created. |
void TRACE_category_with_color | ( | const char * | category, |
const char * | color | ||
) |
Declare a new category with a color.
Same as TRACE_category, but let user specify a color encoded as a RGB-like string with three floats from 0 to 1. So, to specify a red color, pass "1 0 0" as color parameter. A light-gray color can be specified using "0.7 0.7 0.7" as color. This function has no effect if a category with the same name has been already declared.
See Tracing Simulations for Visualization for details on how to trace the (categorized) resource utilization.
category | The name of the new tracing category to be created. |
color | The color of the category (see Tracing Simulations for Visualization to know how to correctly specify the color) |
xbt_dynar_t TRACE_get_categories | ( | void | ) |
Get declared categories.
This function should be used to get categories that were already declared with TRACE_category or with TRACE_category_with_color.
See Tracing Simulations for Visualization for details on how to trace the (categorized) resource utilization.
Back to the main Simgrid Documentation page |
The version of SimGrid documented here is v3.7. Documentation of other versions can be found in their respective archive files (directory doc/html). |
Generated by ![]() |