Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
SimDag instrumentation for categorized resource utilization
[simgrid.git] / 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 "msg/msg.h"
16 #include "simdag/simdag.h"
17
18 /* Trace error codes (used in exceptions) */
19 #define TRACE_ERROR_COMPLEX_ROUTES 100
20 #define TRACE_ERROR_TYPE_NOT_DEFINED 200
21 #define TRACE_ERROR_TYPE_ALREADY_DEFINED 201
22 #define TRACE_ERROR_CATEGORY_NOT_DEFINED 300
23 #define TRACE_ERROR_CATEGORY_ALREADY_DEFINED 301
24 #define TRACE_ERROR_MASK 400
25 #define TRACE_ERROR_FILE_OPEN 401
26 #define TRACE_ERROR_START 500
27
28 XBT_PUBLIC(int) TRACE_start (void);
29 XBT_PUBLIC(int) TRACE_end (void);
30 XBT_PUBLIC(int) TRACE_category (const char *category);
31 XBT_PUBLIC(void) TRACE_define_type (const char *type, const char *parent_type, int final);
32 XBT_PUBLIC(int) TRACE_create_category (const char *category, const char *type, const char *parent_category);
33 XBT_PUBLIC(void) TRACE_msg_set_task_category (m_task_t task, const char *category);
34 XBT_PUBLIC(void) TRACE_msg_set_process_category (m_process_t process, const char *category);
35 XBT_PUBLIC(void) TRACE_set_mask (int mask);
36 XBT_PUBLIC(void) TRACE_user_host_variable (double time, const char *variable, double value, const char *what);
37 XBT_PUBLIC(void) TRACE_user_link_variable (double time, const char *src, const char *dst, const char *variable, double value, const char *what);
38 XBT_PUBLIC(void) TRACE_declare_mark (const char *mark_type);
39 XBT_PUBLIC(void) TRACE_mark (const char *mark_type, const char *mark_value);
40 XBT_PUBLIC(int) TRACE_smpi_set_category (const char *category);
41 XBT_PUBLIC(void) TRACE_sd_set_task_category(SD_task_t task, const char *category);
42
43 #define TRACE_host_variable_declare(var) \
44         TRACE_user_host_variable(0,var,0,"declare");
45
46 #define TRACE_host_variable_set_with_time(time,var,value) \
47         TRACE_user_host_variable(time,var,value,"set");
48
49 #define TRACE_host_variable_add_with_time(time,var,value) \
50         TRACE_user_host_variable(time,var,value,"add");
51
52 #define TRACE_host_variable_sub_with_time(time,var,value) \
53         TRACE_user_host_variable(time,var,value,"sub");
54
55 #define TRACE_host_variable_set(var,value) \
56         TRACE_user_host_variable(MSG_get_clock(),var,value,"set");
57
58 #define TRACE_host_variable_add(var,value) \
59         TRACE_user_host_variable(MSG_get_clock(),var,value,"add");
60
61 #define TRACE_host_variable_sub(var,value) \
62         TRACE_user_host_variable(MSG_get_clock(),var,value,"sub");
63
64 #define TRACE_link_variable_declare(var) \
65         TRACE_user_link_variable(0,NULL,NULL,var,0,"declare");
66
67 #define TRACE_link_variable_set_with_time(time,src,dst,var,value) \
68         TRACE_user_link_variable(time,src,dst,var,value,"set");
69
70 #define TRACE_link_variable_add_with_time(time,src,dst,var,value) \
71         TRACE_user_link_variable(time,src,dst,var,value,"add");
72
73 #define TRACE_link_variable_sub_with_time(time,src,dst,var,value) \
74         TRACE_user_link_variable(time,src,dst,var,value,"sub");
75
76 #define TRACE_link_variable_set(src,dst,var,value) \
77         TRACE_user_link_variable(MSG_get_clock(),src,dst,var,value,"set");
78
79 #define TRACE_link_variable_add(src,dst,var,value) \
80         TRACE_user_link_variable(MSG_get_clock(),src,dst,var,value,"add");
81
82 #define TRACE_link_variable_sub(src,dst,var,value) \
83         TRACE_user_link_variable(MSG_get_clock(),src,dst,var,value,"sub");
84
85 #else /* HAVE_TRACING */
86
87 #define TRACE_start()
88 #define TRACE_end()
89 #define TRACE_category(cat)
90 #define TRACE_define_type(cat,supercat,final)
91 #define TRACE_create_category(inst,cat)
92 #define TRACE_msg_set_task_category(task,cat)
93 #define TRACE_msg_set_process_category(proc,cat)
94 #define TRACE_set_mask(mask)
95
96 #define TRACE_host_variable_declare(var)
97 #define TRACE_host_variable_set_with_time(time,var,value)
98 #define TRACE_host_variable_add_with_time(time,var,value)
99 #define TRACE_host_variable_sub_with_time(time,var,value)
100 #define TRACE_host_variable_set(var,value)
101 #define TRACE_host_variable_add(var,value)
102 #define TRACE_host_variable_sub(var,value)
103 #define TRACE_link_variable_declare(var)
104 #define TRACE_link_variable_set_with_time(time,src,dst,var,value)
105 #define TRACE_link_variable_add_with_time(time,src,dst,var,value)
106 #define TRACE_link_variable_sub_with_time(time,src,dst,var,value)
107 #define TRACE_link_variable_set(src,dst,var,value)
108 #define TRACE_link_variable_add(src,dst,var,value)
109 #define TRACE_link_variable_sub(src,dst,var,value)
110 #define TRACE_declare_mark(type)
111 #define TRACE_mark(type,value)
112 #define TRACE_smpi_set_category(cat)
113 #define TRACE_sd_set_task_category(task,cat)
114
115 #endif /* HAVE_TRACING */
116
117 #endif /* INSTR_H_ */