X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/b16f3d6a14798bcac4e8203cc40975c16cf85f5a..41dd9405e023a6edd042bc02e5fd48c90aee5d56:/src/instr/instr_config.c diff --git a/src/instr/instr_config.c b/src/instr/instr_config.c index dc6576023e..718c92c5f0 100644 --- a/src/instr/instr_config.c +++ b/src/instr/instr_config.c @@ -5,12 +5,15 @@ * under the terms of the license (GNU LGPL) which comes with this package. */ -#include "instr/private.h" +#include "instr/instr_private.h" #ifdef HAVE_TRACING +#define OPT_TRACING "tracing" #define OPT_TRACING_SMPI "tracing/smpi" +#define OPT_TRACING_SMPI_GROUP "tracing/smpi/group" #define OPT_TRACING_PLATFORM "tracing/platform" +#define OPT_TRACING_UNCATEGORIZED "tracing/uncategorized" #define OPT_TRACING_MSG_TASK "tracing/msg/task" #define OPT_TRACING_MSG_PROCESS "tracing/msg/process" #define OPT_TRACING_MSG_VOLUME "tracing/msg/volume" @@ -19,44 +22,59 @@ static int trace_configured = 0; -int _TRACE_configured (void) +int TRACE_is_enabled(void) +{ + return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING); +} + +int TRACE_is_configured(void) { return trace_configured; } -int _TRACE_smpi_enabled (void) +int TRACE_smpi_is_enabled(void) { return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_SMPI); } -int _TRACE_platform_enabled (void) +int TRACE_smpi_is_grouped(void) +{ + return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_SMPI_GROUP); +} + +int TRACE_platform_is_enabled(void) { return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_PLATFORM); } -int _TRACE_msg_task_enabled (void) +int TRACE_uncategorized (void) +{ + return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_UNCATEGORIZED); +} + +int TRACE_msg_task_is_enabled(void) { return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_MSG_TASK); } -int _TRACE_msg_process_enabled (void) +int TRACE_msg_process_is_enabled(void) { return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_MSG_PROCESS); } -int _TRACE_msg_volume_enabled (void) +int TRACE_msg_volume_is_enabled(void) { return xbt_cfg_get_int(_surf_cfg_set, OPT_TRACING_MSG_VOLUME); } -char *_TRACE_filename (void) +char *TRACE_get_filename(void) { - return xbt_cfg_get_string (_surf_cfg_set, OPT_TRACING_FILENAME); + return xbt_cfg_get_string(_surf_cfg_set, OPT_TRACING_FILENAME); } -char *_TRACE_platform_method (void) +char *TRACE_get_platform_method(void) { - return xbt_cfg_get_string (_surf_cfg_set, OPT_TRACING_PLATFORM_METHOD); + return xbt_cfg_get_string(_surf_cfg_set, OPT_TRACING_PLATFORM_METHOD); } void TRACE_global_init(int *argc, char **argv) @@ -64,9 +82,16 @@ void TRACE_global_init(int *argc, char **argv) /* name of the tracefile */ char *default_tracing_filename = xbt_strdup("simgrid.trace"); xbt_cfg_register(&_surf_cfg_set, OPT_TRACING_FILENAME, - "Trace file created by the instrumented SimGrid.", - xbt_cfgelm_string, &default_tracing_filename, 1, 1, - NULL, NULL); + "Trace file created by the instrumented SimGrid.", + xbt_cfgelm_string, &default_tracing_filename, 1, 1, + NULL, NULL); + + /* tracing */ + int default_tracing = 0; + xbt_cfg_register(&_surf_cfg_set, OPT_TRACING, + "Enable Tracing.", + xbt_cfgelm_int, &default_tracing, 0, 1, + NULL, NULL); /* smpi */ int default_tracing_smpi = 0; @@ -75,6 +100,14 @@ void TRACE_global_init(int *argc, char **argv) xbt_cfgelm_int, &default_tracing_smpi, 0, 1, NULL, NULL); + /* smpi grouped */ + int default_tracing_smpi_grouped = 0; + xbt_cfg_register(&_surf_cfg_set, OPT_TRACING_SMPI_GROUP, + "Group MPI processes by host.", + xbt_cfgelm_int, &default_tracing_smpi_grouped, 0, 1, + NULL, NULL); + + /* platform */ int default_tracing_platform = 0; xbt_cfg_register(&_surf_cfg_set, OPT_TRACING_PLATFORM, @@ -82,12 +115,19 @@ void TRACE_global_init(int *argc, char **argv) xbt_cfgelm_int, &default_tracing_platform, 0, 1, NULL, NULL); + /* tracing uncategorized resource utilization */ + int default_tracing_uncategorized = 0; + xbt_cfg_register(&_surf_cfg_set, OPT_TRACING_UNCATEGORIZED, + "Tracing of uncategorized resource (host and link) utilization.", + xbt_cfgelm_int, &default_tracing_uncategorized, 0, 1, + NULL, NULL); + /* platform method */ - char *default_tracing_platform_method = xbt_strdup ("b"); + char *default_tracing_platform_method = xbt_strdup("a"); xbt_cfg_register(&_surf_cfg_set, OPT_TRACING_PLATFORM_METHOD, "Tracing method used to register categorized resource behavior.", - xbt_cfgelm_string, &default_tracing_platform_method, 1, 1, - NULL, NULL); + xbt_cfgelm_string, &default_tracing_platform_method, 1, + 1, NULL, NULL); /* msg task */ int default_tracing_msg_task = 0; @@ -114,4 +154,88 @@ void TRACE_global_init(int *argc, char **argv) trace_configured = 1; } -#endif +static void print_line (const char *option, const char *desc, const char *longdesc, int detailed) +{ + char str[INSTR_DEFAULT_STR_SIZE]; + snprintf (str, INSTR_DEFAULT_STR_SIZE, "--cfg=%s ", option); + + int len = strlen (str); + printf ("%s%*.*s %s\n", str, 30-len, 30-len, "", desc); + if (!!longdesc && detailed){ + printf ("%s\n\n", longdesc); + } +} + +void TRACE_help (int detailed) +{ + printf( + "Description of the tracing options accepted by this simulator:\n\n"); + print_line (OPT_TRACING, "Enable the tracing system", + " It activates the tracing system and register the simulation platform\n" + " in the trace file. You have to enable this option to others take effect.", + detailed); + print_line (OPT_TRACING_PLATFORM, "Trace categorized resource utilization", + " It activates the categorized resource utilization tracing. It should\n" + " be enabled if tracing categories are used by this simulator.", + detailed); + print_line (OPT_TRACING_UNCATEGORIZED, "Trace uncategorized resource utilization", + " It activates the uncategorized resource utilization tracing. Use it if\n" + " this simulator do not use tracing categories and resource use have to be\n" + " traced.", + detailed); + print_line (OPT_TRACING_PLATFORM_METHOD, "Change the resource utilization tracing method", + " It changes the way resource utilization (categorized or not) is traced\n" + " inside the simulation core. Method 'a' (default) traces all updates defined\n" + " by the CPU/network model of a given resource. Depending on the interface used\n" + " by this simulator (MSG, SMPI, SimDAG), the default method can generate large\n" + " trace files. Method 'b' tries to make smaller tracefiles using clever updates,\n" + " without losing details of resource utilization. Method 'c' generates even\n" + " smaller files by doing time integration during the simulation, but it loses\n" + " precision. If this last method is used, the smallest timeslice used in the\n" + " tracefile analysis must be bigger than the smaller resource utilization. If\n" + " unsure, do not change this option.", + detailed); + print_line (OPT_TRACING_FILENAME, "Filename to register traces", + " A file with this name will be created to register the simulation. The file\n" + " is in the Paje format and can be analyzed using Triva or Paje visualization\n" + " tools. More information can be found in these webpages:\n" + " http://triva.gforge.inria.fr/\n" + " http://paje.sourceforge.net/", + detailed); + print_line (OPT_TRACING_SMPI, "Trace the MPI Interface (SMPI)", + " This option only has effect if this simulator is SMPI-based. Traces the MPI\n" + " interface and generates a trace that can be analyzed using Gantt-like\n" + " visualizations. Every MPI function (implemented by SMPI) is transformed in a\n" + " state, and point-to-point communications can be analyzed with arrows.", + detailed); + print_line (OPT_TRACING_SMPI_GROUP, "Group MPI processes by host (SMPI)", + " This option only has effect if this simulator is SMPI-based. The processes\n" + " are grouped by the hosts where they were executed.", + detailed); + print_line (OPT_TRACING_MSG_TASK, "Trace task behavior (MSG)", + " This option only has effect if this simulator is MSG-based. It traces the\n" + " behavior of all categorized MSG tasks, grouping them by hosts.", + detailed); + print_line (OPT_TRACING_MSG_PROCESS, "Trace processes behavior (MSG)", + " This option only has effect if this simulator is MSG-based. It traces the\n" + " behavior of all categorized MSG processes, grouping them by hosts. This option\n" + " can be used to track process location if this simulator has process migration.", + detailed); + print_line (OPT_TRACING_MSG_VOLUME, "Tracing of communication volume (MSG)", + " This experimental option only has effect if this simulator is MSG-based.\n" + " It traces the communication volume of MSG send/receive.", + detailed); +} + +#undef OPT_TRACING +#undef OPT_TRACING_SMPI +#undef OPT_TRACING_SMPI_GROUP +#undef OPT_TRACING_PLATFORM +#undef OPT_TRACING_UNCATEGORIZED +#undef OPT_TRACING_MSG_TASK +#undef OPT_TRACING_MSG_PROCESS +#undef OPT_TRACING_MSG_VOLUME +#undef OPT_TRACING_FILENAME +#undef OPT_TRACING_PLATFORM_METHOD + +#endif /* HAVE_TRACING */