X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/0098cdf969c368d2b3202cdb2e4e11e1a592ab2e..534d31e4fc62b248c646ad6e19518e8a7b11e048:/doc/tracing.doc diff --git a/doc/tracing.doc b/doc/tracing.doc index 6b61e35da6..b9bdcc848d 100644 --- a/doc/tracing.doc +++ b/doc/tracing.doc @@ -34,11 +34,13 @@ of resource utilization by using a special parameter that is detailed below. \subsection tracing_tracing_enabling Enabling using CMake -With the sources of SimGrid, it is possible to enable the tracing -using the parameter -Denable_tracing=ON when the cmake is executed. -The section \ref tracing_tracing_functions describes all the functions available -when this Cmake options is activated. These functions will have no effect -if SimGrid is configured without this option (they are wiped-out by the +With the sources of SimGrid, it is possible to enable the tracing +using the parameter -Denable_tracing=ON when the cmake is +executed. The sections \ref instr_category_functions, \ref +instr_mark_functions, and \ref instr_uservariables_functions describe +all the functions available when this Cmake options is +activated. These functions will have no effect if SimGrid is +configured without this option (they are wiped-out by the C-preprocessor). \verbatim @@ -51,13 +53,8 @@ $ make \li \c TRACE_category_with_color(const char *category, const char *color) \li \c MSG_task_set_category(m_task_t task, const char *category) \li \c MSG_task_get_category(m_task_t task) - -\li \c TRACE_sd_set_task_category (SD_task_t task, const char *category): -This function should be called after the creation of a SimDAG task, to define the -category of that task. The first parameter \c task must contain a task that was -created with the function \c MSG_task_create. The second parameter -\c category must contain a category that was previously defined by the function -\c TRACE_category. +\li \c SD_task_set_category(SD_task_t task, const char *category) +\li \c SD_task_get_category(SD_task_t task) \subsection instr_mark_functions Tracing marks functions \li \c TRACE_declare_mark(const char *mark_type) @@ -261,8 +258,8 @@ simulator): For that, you will need to create tracing categories using the TRACE_category (...) function (as explained above), and then classify your tasks to a previously declared category -using the TRACE_msg_set_task_category (...) -(or TRACE_sd_set_task_category (...) for SimDAG tasks). After +using the MSG_task_set_category (...) +(or SD_task_set_category (...) for SimDAG tasks). After recompiling, run your simulator with the following parameters: \verbatim ./your_simulator \ @@ -293,16 +290,16 @@ int main (int argc, char **argv) m_task_t req2 = MSG_task_create("2nd_request_task", 10, 10, NULL); m_task_t req3 = MSG_task_create("3rd_request_task", 10, 10, NULL); m_task_t req4 = MSG_task_create("4th_request_task", 10, 10, NULL); - TRACE_msg_set_task_category (req1, "request"); - TRACE_msg_set_task_category (req2, "request"); - TRACE_msg_set_task_category (req3, "request"); - TRACE_msg_set_task_category (req4, "request"); + MSG_task_set_category (req1, "request"); + MSG_task_set_category (req2, "request"); + MSG_task_set_category (req3, "request"); + MSG_task_set_category (req4, "request"); m_task_t comp = MSG_task_create ("comp_task", 100, 100, NULL); - TRACE_msg_set_task_category (comp, "computation"); + MSG_task_set_category (comp, "computation"); m_task_t finalize = MSG_task_create ("finalize", 0, 0, NULL); - TRACE_msg_set_task_category (finalize, "finalize"); + MSG_task_set_category (finalize, "finalize"); //(...)