include/instr/instr.h

   1 /* Copyright (c) 2010. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   4 /* This program is free software; you can redistribute it and/or modify it
   5  * under the terms of the license (GNU LGPL) which comes with this package. */
   6
   7 #ifndef INSTR_H_
   8 #define INSTR_H_
   9
  10 #include "simgrid_config.h"
  11
  12 #ifdef HAVE_TRACING
  13
  14 #include "xbt.h"
  15 #include "xbt/graph.h"
  16 #include "msg/msg.h"
  17 #include "simdag/simdag.h"
  18
  19 XBT_PUBLIC(void) TRACE_category(const char *category);
  20 XBT_PUBLIC(void) TRACE_category_with_color (const char *category, const char *color);
  21 XBT_PUBLIC(void) TRACE_msg_set_task_category(m_task_t task, const char *category);
  22 XBT_PUBLIC(void) TRACE_smpi_set_category(const char *category);
  23 XBT_PUBLIC(void) TRACE_sd_set_task_category(SD_task_t task, const char *category);
  24
  25 XBT_PUBLIC(void) TRACE_declare_mark(const char *mark_type);
  26 XBT_PUBLIC(void) TRACE_mark(const char *mark_type, const char *mark_value);
  27
  28 XBT_PUBLIC(const char *) TRACE_node_name (xbt_node_t node);
  29 XBT_PUBLIC(xbt_graph_t) TRACE_platform_graph (void);
  30 XBT_PUBLIC(void) TRACE_platform_graph_export_graphviz (xbt_graph_t g, const char *filename);
  31
  32 /*
  33  * User-variables related functions
  34  */
  35 /* for host variables */
  36 XBT_PUBLIC(void) TRACE_host_variable_declare (const char *var);
  37 XBT_PUBLIC(void) TRACE_host_variable_declare_with_color (const char *var, const char *color);
  38 XBT_PUBLIC(void) TRACE_host_variable_set (const char *host, const char *variable, double value);
  39 XBT_PUBLIC(void) TRACE_host_variable_add (const char *host, const char *variable, double value);
  40 XBT_PUBLIC(void) TRACE_host_variable_sub (const char *host, const char *variable, double value);
  41 XBT_PUBLIC(void) TRACE_host_variable_set_with_time (double time, const char *host, const char *variable, double value);
  42 XBT_PUBLIC(void) TRACE_host_variable_add_with_time (double time, const char *host, const char *variable, double value);
  43 XBT_PUBLIC(void) TRACE_host_variable_sub_with_time (double time, const char *host, const char *variable, double value);
  44
  45 /* for link variables */
  46 XBT_PUBLIC(void) TRACE_link_variable_declare (const char *var);
  47 XBT_PUBLIC(void) TRACE_link_variable_declare_with_color (const char *var, const char *color);
  48 XBT_PUBLIC(void) TRACE_link_variable_set (const char *link, const char *variable, double value);
  49 XBT_PUBLIC(void) TRACE_link_variable_add (const char *link, const char *variable, double value);
  50 XBT_PUBLIC(void) TRACE_link_variable_sub (const char *link, const char *variable, double value);
  51 XBT_PUBLIC(void) TRACE_link_variable_set_with_time (double time, const char *link, const char *variable, double value);
  52 XBT_PUBLIC(void) TRACE_link_variable_add_with_time (double time, const char *link, const char *variable, double value);
  53 XBT_PUBLIC(void) TRACE_link_variable_sub_with_time (double time, const char *link, const char *variable, double value);
  54
  55 /* for link variables, but with src and dst used for get_route */
  56 XBT_PUBLIC(void) TRACE_link_srcdst_variable_set (const char *src, const char *dst, const char *variable, double value);
  57 XBT_PUBLIC(void) TRACE_link_srcdst_variable_add (const char *src, const char *dst, const char *variable, double value);
  58 XBT_PUBLIC(void) TRACE_link_srcdst_variable_sub (const char *src, const char *dst, const char *variable, double value);
  59 XBT_PUBLIC(void) TRACE_link_srcdst_variable_set_with_time (double time, const char *src, const char *dst, const char *variable, double value);
  60 XBT_PUBLIC(void) TRACE_link_srcdst_variable_add_with_time (double time, const char *src, const char *dst, const char *variable, double value);
  61 XBT_PUBLIC(void) TRACE_link_srcdst_variable_sub_with_time (double time, const char *src, const char *dst, const char *variable, double value);
  62
  63 #else                           /* HAVE_TRACING */
  64
  65 #define TRACE_category(category)
  66 #define TRACE_category_with_color(category,color)
  67 #define TRACE_msg_set_task_category(task,category)
  68 #define TRACE_msg_set_process_category(process,category,color)
  69 #define TRACE_smpi_set_category(category)
  70 #define TRACE_sd_set_task_category(task,category)
  71
  72 #define TRACE_declare_mark(mark_type)
  73 #define TRACE_mark(mark_type,mark_value)
  74
  75 #define TRACE_node_name(node)
  76 #define TRACE_platform_graph(void)
  77 #define TRACE_platform_graph_export_graphviz(g,filename)
  78
  79 #define TRACE_host_variable_declare(var)
  80 #define TRACE_host_variable_declare_with_color(var,color)
  81 #define TRACE_host_variable_set(host,var,value)
  82 #define TRACE_host_variable_add(host,var,value)
  83 #define TRACE_host_variable_sub(host,var,value)
  84 #define TRACE_host_variable_set_with_time(time,host,var,value)
  85 #define TRACE_host_variable_add_with_time(time,host,var,value)
  86 #define TRACE_host_variable_sub_with_time(time,host,var,value)
  87
  88 #define TRACE_link_variable_declare(var)
  89 #define TRACE_link_variable_declare_with_color(var,color)
  90 #define TRACE_link_variable_set(link,var,value)
  91 #define TRACE_link_variable_add(link,var,value)
  92 #define TRACE_link_variable_sub(link,var,value)
  93 #define TRACE_link_variable_set_with_time(time,link,var,value)
  94 #define TRACE_link_variable_add_with_time(time,link,var,value)
  95 #define TRACE_link_variable_sub_with_time(time,link,var,value)
  96
  97 #define TRACE_link_srcdst_variable_set(src,dst,var,value)
  98 #define TRACE_link_srcdst_variable_add(src,dst,var,value)
  99 #define TRACE_link_srcdst_variable_sub(src,dst,var,value)
 100 #define TRACE_link_srcdst_variable_set_with_time(time,src,dst,var,value)
 101 #define TRACE_link_srcdst_variable_add_with_time(time,src,dst,var,value)
 102 #define TRACE_link_srcdst_variable_sub_with_time(time,src,dst,var,value)
 103
 104 #endif                          /* HAVE_TRACING */
 105
 106 #endif                          /* INSTR_H_ */