src/simgrid/sg_config.c

   1 /* Copyright (c) 2009, 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 /* sg_config: configuration infrastructure for the simulation world       */
   8
   9 #include "xbt/misc.h"
  10 #include "xbt/config.h"
  11 #include "xbt/log.h"
  12 #include "xbt/mallocator.h"
  13 #include "xbt/str.h"
  14 #include "xbt/lib.h"
  15 #include "xbt/sysdep.h"
  16 #include "surf/surf.h"
  17 #include "surf/maxmin.h"
  18 #include "instr/instr_interface.h"
  19 #include "simgrid/simix.h"
  20 #include "simgrid/sg_config.h"
  21 #include "smpi/smpi_interface.h"
  22 #include "mc/mc.h"
  23 #include "instr/instr.h"
  24
  25 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_config, surf,
  26                                 "About the configuration of simgrid");
  27
  28 xbt_cfg_t _sg_cfg_set = NULL;
  29
  30 int _sg_init_status = 0;      /* 0: beginning of time (config cannot be changed yet);
  31                                   1: initialized: cfg_set created (config can now be changed);
  32                                   2: configured: command line parsed and config part of platform file was integrated also, platform construction ongoing or done.
  33                                      (Config cannot be changed anymore!) */
  34
  35 /* Parse the command line, looking for options */
  36 static void sg_config_cmd_line(int *argc, char **argv)
  37 {
  38   int shall_exit = 0;
  39   int i, j;
  40   char *opt;
  41
  42   for (j = i = 1; i < *argc; i++) {
  43     if (!strncmp(argv[i], "--cfg=", strlen("--cfg="))) {
  44       opt = strchr(argv[i], '=');
  45       opt++;
  46
  47       xbt_cfg_set_parse(_sg_cfg_set, opt);
  48       XBT_DEBUG("Did apply '%s' as config setting", opt);
  49     } else if (!strcmp(argv[i], "--cfg-help") || !strcmp(argv[i], "--help")) {
  50       printf
  51           ("Description of the configuration accepted by this simulator:\n");
  52       xbt_cfg_help(_sg_cfg_set);
  53       printf(
  54 "\n"
  55 "Each of these configurations can be used by adding\n"
  56 "    --cfg=<option name>:<option value>\n"
  57 "to the command line.\n"
  58 "You can also use --help-models to see the details of all models known by this simulator.\n"
  59 #ifdef HAVE_TRACING
  60 "\n"
  61 "You can also use --help-tracing to see the details of all tracing options known by this simulator.\n"
  62 #endif
  63 "\n"
  64 "You can also use --help-logs and --help-log-categories to see the details of logging output.\n"
  65 "\n"
  66         );
  67       shall_exit = 1;
  68     } else if (!strcmp(argv[i], "--help-models")) {
  69       int k;
  70
  71       model_help("workstation", surf_workstation_model_description);
  72       printf("\n");
  73       model_help("CPU", surf_cpu_model_description);
  74       printf("\n");
  75       model_help("network", surf_network_model_description);
  76       printf("\nLong description of all optimization levels accepted by the models of this simulator:\n");
  77       for (k = 0; surf_optimization_mode_description[k].name; k++)
  78         printf("  %s: %s\n",
  79                surf_optimization_mode_description[k].name,
  80                surf_optimization_mode_description[k].description);
  81       printf("Both network and CPU models have 'Lazy' as default optimization level\n\n");
  82       shall_exit = 1;
  83 #ifdef HAVE_TRACING
  84     } else if (!strcmp(argv[i], "--help-tracing")) {
  85       TRACE_help (1);
  86       shall_exit = 1;
  87 #endif
  88     } else {
  89       argv[j++] = argv[i];
  90     }
  91   }
  92   if (j < *argc) {
  93     argv[j] = NULL;
  94     *argc = j;
  95   }
  96   if (shall_exit) {
  97     _sg_init_status=1; // get everything cleanly cleaned on exit
  98     exit(0);
  99   }
 100 }
 101
 102 /* callback of the workstation/model variable */
 103 static void _sg_cfg_cb__workstation_model(const char *name, int pos)
 104 {
 105   char *val;
 106
 107   xbt_assert(_sg_init_status == 1,
 108               "Cannot change the model after the initialization");
 109
 110   val = xbt_cfg_get_string(_sg_cfg_set, name);
 111
 112   if (!strcmp(val, "help")) {
 113     model_help("workstation", surf_workstation_model_description);
 114     exit(0);
 115   }
 116
 117   /* Make sure that the model exists */
 118   find_model_description(surf_workstation_model_description, val);
 119 }
 120
 121 /* callback of the cpu/model variable */
 122 static void _sg_cfg_cb__cpu_model(const char *name, int pos)
 123 {
 124   char *val;
 125
 126   xbt_assert(_sg_init_status == 1,
 127               "Cannot change the model after the initialization");
 128
 129   val = xbt_cfg_get_string(_sg_cfg_set, name);
 130
 131   if (!strcmp(val, "help")) {
 132     model_help("CPU", surf_cpu_model_description);
 133     exit(0);
 134   }
 135
 136   /* New Module missing */
 137   find_model_description(surf_cpu_model_description, val);
 138 }
 139
 140 /* callback of the cpu/model variable */
 141 static void _sg_cfg_cb__optimization_mode(const char *name, int pos)
 142 {
 143   char *val;
 144
 145   xbt_assert(_sg_init_status == 1,
 146               "Cannot change the model after the initialization");
 147
 148   val = xbt_cfg_get_string(_sg_cfg_set, name);
 149
 150   if (!strcmp(val, "help")) {
 151     model_help("optimization", surf_optimization_mode_description);
 152     exit(0);
 153   }
 154
 155   /* New Module missing */
 156   find_model_description(surf_optimization_mode_description, val);
 157 }
 158
 159 /* callback of the cpu/model variable */
 160 static void _sg_cfg_cb__storage_mode(const char *name, int pos)
 161 {
 162   char *val;
 163
 164   xbt_assert(_sg_init_status == 1,
 165               "Cannot change the model after the initialization");
 166
 167   val = xbt_cfg_get_string(_sg_cfg_set, name);
 168
 169   if (!strcmp(val, "help")) {
 170     model_help("storage", surf_storage_model_description);
 171     exit(0);
 172   }
 173
 174   /* New Module missing */
 175   find_model_description(surf_storage_model_description, val);
 176 }
 177
 178 /* callback of the workstation_model variable */
 179 static void _sg_cfg_cb__network_model(const char *name, int pos)
 180 {
 181   char *val;
 182
 183   xbt_assert(_sg_init_status == 1,
 184               "Cannot change the model after the initialization");
 185
 186   val = xbt_cfg_get_string(_sg_cfg_set, name);
 187
 188   if (!strcmp(val, "help")) {
 189     model_help("network", surf_network_model_description);
 190     exit(0);
 191   }
 192
 193   /* New Module missing */
 194   find_model_description(surf_network_model_description, val);
 195 }
 196
 197
 198 /* callbacks of the network models values */
 199 static void _sg_cfg_cb__tcp_gamma(const char *name, int pos)
 200 {
 201   sg_tcp_gamma = xbt_cfg_get_double(_sg_cfg_set, name);
 202 }
 203
 204 static void _sg_cfg_cb__maxmin_precision(const char* name, int pos)
 205 {
 206   sg_maxmin_precision = xbt_cfg_get_double(_sg_cfg_set, name);
 207 }
 208
 209 static void _sg_cfg_cb__sender_gap(const char* name, int pos)
 210 {
 211   sg_sender_gap = xbt_cfg_get_double(_sg_cfg_set, name);
 212 }
 213
 214 static void _sg_cfg_cb__latency_factor(const char *name, int pos)
 215 {
 216   sg_latency_factor = xbt_cfg_get_double(_sg_cfg_set, name);
 217 }
 218
 219 static void _sg_cfg_cb__bandwidth_factor(const char *name, int pos)
 220 {
 221   sg_bandwidth_factor = xbt_cfg_get_double(_sg_cfg_set, name);
 222 }
 223
 224 static void _sg_cfg_cb__weight_S(const char *name, int pos)
 225 {
 226   sg_weight_S_parameter = xbt_cfg_get_double(_sg_cfg_set, name);
 227 }
 228
 229 #ifdef HAVE_SMPI
 230 /* callback of the mpi collectives */
 231 static void _sg_cfg_cb__coll(const char *category,
 232                              s_mpi_coll_description_t * table,
 233                              const char *name, int pos)
 234 {
 235   char *val;
 236
 237   xbt_assert(_sg_init_status == 1,
 238               "Cannot change the model after the initialization");
 239
 240   val = xbt_cfg_get_string(_sg_cfg_set, name);
 241
 242   if (!strcmp(val, "help")) {
 243     coll_help(category, table);
 244     exit(0);
 245   }
 246
 247   /* New Module missing */
 248   find_coll_description(table, val);
 249 }
 250 static void _sg_cfg_cb__coll_allgather(const char *name, int pos){
 251   _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
 252 }
 253 static void _sg_cfg_cb__coll_allgatherv(const char *name, int pos){
 254   _sg_cfg_cb__coll("allgatherv", mpi_coll_allgatherv_description, name, pos);
 255 }
 256 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
 257 {
 258   _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
 259 }
 260 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
 261 {
 262   _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
 263 }
 264 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
 265 {
 266   _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
 267 }
 268 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
 269 {
 270   _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
 271 }
 272 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
 273 {
 274   _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
 275 }
 276 #endif
 277
 278 /* callback of the inclusion path */
 279 static void _sg_cfg_cb__surf_path(const char *name, int pos)
 280 {
 281   char *path = xbt_cfg_get_string_at(_sg_cfg_set, name, pos);
 282   xbt_dynar_push(surf_path, &path);
 283 }
 284
 285 /* callback to decide if we want to use the model-checking */
 286 #include "xbt_modinter.h"
 287 #ifdef HAVE_MC
 288 extern int _sg_do_model_check;   /* this variable lives in xbt_main until I find a right location for it */
 289 #endif
 290
 291 static void _sg_cfg_cb_model_check(const char *name, int pos)
 292 {
 293 #ifdef HAVE_MC
 294   _sg_do_model_check = xbt_cfg_get_boolean(_sg_cfg_set, name);
 295 #else
 296   if (xbt_cfg_get_boolean(_sg_cfg_set, name)) {
 297     xbt_die("You tried to activate the model-checking from the command line, but it was not compiled in. Change your settings in cmake, recompile and try again");
 298   }
 299 #endif
 300 }
 301
 302 extern int _sg_do_verbose_exit;
 303
 304 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
 305 {
 306   _sg_do_verbose_exit = xbt_cfg_get_boolean(_sg_cfg_set, name);
 307 }
 308
 309
 310 static void _sg_cfg_cb_context_factory(const char *name, int pos) {
 311   smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
 312 }
 313
 314 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
 315 {
 316   smx_context_stack_size_was_set = 1;
 317   smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
 318 }
 319
 320 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
 321 {
 322   SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
 323 }
 324
 325 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
 326 {
 327   SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
 328 }
 329
 330 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
 331 {
 332   const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
 333   if (!strcmp(mode_name, "posix")) {
 334     SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
 335   }
 336   else if (!strcmp(mode_name, "futex")) {
 337     SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
 338   }
 339   else if (!strcmp(mode_name, "busy_wait")) {
 340     SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
 341   }
 342   else {
 343     xbt_die("Command line setting of the parallel synchronization mode should "
 344         "be one of \"posix\", \"futex\" or \"busy_wait\"");
 345   }
 346 }
 347
 348 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
 349                                                    int pos)
 350 {
 351   int val = xbt_cfg_get_boolean(_sg_cfg_set, name);
 352   if (val) {
 353     if (!COORD_HOST_LEVEL) {
 354       COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp);
 355       COORD_ASR_LEVEL  = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
 356     }
 357   } else
 358     if (COORD_HOST_LEVEL)
 359       xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
 360 }
 361
 362 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
 363                                                   int pos)
 364 {
 365   sg_network_crosstraffic = xbt_cfg_get_boolean(_sg_cfg_set, name);
 366 }
 367
 368 #ifdef HAVE_GTNETS
 369 static void _sg_cfg_cb__gtnets_jitter(const char *name, int pos)
 370 {
 371   sg_gtnets_jitter = xbt_cfg_get_double(_sg_cfg_set, name);
 372 }
 373
 374 static void _sg_cfg_cb__gtnets_jitter_seed(const char *name, int pos)
 375 {
 376   sg_gtnets_jitter_seed = xbt_cfg_get_int(_sg_cfg_set, name);
 377 }
 378 #endif
 379
 380 /* create the config set, register what should be and parse the command line*/
 381 void sg_config_init(int *argc, char **argv)
 382 {
 383   char *description = xbt_malloc(1024), *p = description;
 384   char *default_value;
 385   double double_default_value;
 386   int default_value_int;
 387   int i;
 388
 389   /* Create the configuration support */
 390   if (_sg_init_status == 0) { /* Only create stuff if not already inited */
 391     sprintf(description,
 392             "The model to use for the CPU. Possible values: ");
 393     p = description;
 394     while (*(++p) != '\0');
 395     for (i = 0; surf_cpu_model_description[i].name; i++)
 396       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 397                    surf_cpu_model_description[i].name);
 398     sprintf(p,
 399             ".\n       (use 'help' as a value to see the long description of each model)");
 400     default_value = xbt_strdup("Cas01");
 401     xbt_cfg_register(&_sg_cfg_set, "cpu/model", description, xbt_cfgelm_string,
 402                      &default_value, 1, 1, &_sg_cfg_cb__cpu_model, NULL);
 403
 404     sprintf(description,
 405             "The optimization modes to use for the CPU. Possible values: ");
 406     p = description;
 407     while (*(++p) != '\0');
 408     for (i = 0; surf_optimization_mode_description[i].name; i++)
 409       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 410                    surf_optimization_mode_description[i].name);
 411     sprintf(p,
 412             ".\n       (use 'help' as a value to see the long description of each optimization mode)");
 413     default_value = xbt_strdup("Lazy");
 414     xbt_cfg_register(&_sg_cfg_set, "cpu/optim", description, xbt_cfgelm_string,
 415                      &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
 416
 417     sprintf(description,
 418             "The model to use for the storage. Possible values: ");
 419     p = description;
 420     while (*(++p) != '\0');
 421     for (i = 0; surf_storage_model_description[i].name; i++)
 422       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 423                    surf_storage_model_description[i].name);
 424     sprintf(p,
 425             ".\n       (use 'help' as a value to see the long description of each model)");
 426     default_value = xbt_strdup("default");
 427     xbt_cfg_register(&_sg_cfg_set, "storage/model", description, xbt_cfgelm_string,
 428                      &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
 429                      NULL);
 430
 431     /* ********************************************************************* */
 432     /* TUTORIAL: New model                                                   */
 433     sprintf(description,
 434             "The model to use for the New model. Possible values: ");
 435     p = description;
 436     while (*(++p) != '\0');
 437     for (i = 0; surf_new_model_description[i].name; i++)
 438       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 439                    surf_new_model_description[i].name);
 440     sprintf(p,
 441             ".\n       (use 'help' as a value to see the long description of each model)");
 442     default_value = xbt_strdup("default");
 443     xbt_cfg_register(&_sg_cfg_set, "new_model/model", description, xbt_cfgelm_string,
 444                      &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
 445                      NULL);
 446     /* ********************************************************************* */
 447
 448     sprintf(description,
 449             "The model to use for the network. Possible values: ");
 450     p = description;
 451     while (*(++p) != '\0');
 452     for (i = 0; surf_network_model_description[i].name; i++)
 453       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 454                    surf_network_model_description[i].name);
 455     sprintf(p,
 456             ".\n       (use 'help' as a value to see the long description of each model)");
 457     default_value = xbt_strdup("LV08");
 458     xbt_cfg_register(&_sg_cfg_set, "network/model", description, xbt_cfgelm_string,
 459                      &default_value, 1, 1, &_sg_cfg_cb__network_model,
 460                      NULL);
 461
 462     sprintf(description,
 463             "The optimization modes to use for the network. Possible values: ");
 464     p = description;
 465     while (*(++p) != '\0');
 466     for (i = 0; surf_optimization_mode_description[i].name; i++)
 467       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 468                    surf_optimization_mode_description[i].name);
 469     sprintf(p,
 470             ".\n       (use 'help' as a value to see the long description of each optimization mode)");
 471     default_value = xbt_strdup("Lazy");
 472     xbt_cfg_register(&_sg_cfg_set, "network/optim", description, xbt_cfgelm_string,
 473                      &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
 474
 475     sprintf(description,
 476             "The model to use for the workstation. Possible values: ");
 477     p = description;
 478     while (*(++p) != '\0');
 479     for (i = 0; surf_workstation_model_description[i].name; i++)
 480       p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
 481                    surf_workstation_model_description[i].name);
 482     sprintf(p,
 483             ".\n       (use 'help' as a value to see the long description of each model)");
 484     default_value = xbt_strdup("default");
 485     xbt_cfg_register(&_sg_cfg_set, "workstation/model", description, xbt_cfgelm_string,
 486                      &default_value, 1, 1,
 487                      &_sg_cfg_cb__workstation_model, NULL);
 488
 489     xbt_free(description);
 490
 491     xbt_cfg_register(&_sg_cfg_set, "network/TCP_gamma",
 492                      "Size of the biggest TCP window (cat /proc/sys/net/ipv4/tcp_[rw]mem for recv/send window; Use the last given value, which is the max window size)",
 493                      xbt_cfgelm_double, NULL, 1, 1,
 494                      _sg_cfg_cb__tcp_gamma, NULL);
 495     xbt_cfg_setdefault_double(_sg_cfg_set, "network/TCP_gamma", 4194304.0);
 496
 497     xbt_cfg_register(&_sg_cfg_set, "maxmin/precision",
 498                      "Numerical precision used when updating simulation models (epsilon in double comparisons)",
 499                      xbt_cfgelm_double, NULL, 1, 1, _sg_cfg_cb__maxmin_precision, NULL);
 500     xbt_cfg_setdefault_double(_sg_cfg_set, "maxmin/precision", 0.00001);
 501
 502     /* The parameters of network models */
 503
 504     xbt_cfg_register(&_sg_cfg_set, "network/sender_gap",
 505                      "Minimum gap between two overlapping sends",
 506                      xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
 507                      _sg_cfg_cb__sender_gap, NULL);
 508
 509     double_default_value = 1.0; // FIXME use setdefault everywhere here!
 510     xbt_cfg_register(&_sg_cfg_set, "network/latency_factor",
 511                      "Correction factor to apply to the provided latency (default value set by network model)",
 512                      xbt_cfgelm_double, &double_default_value, 1, 1,
 513                      _sg_cfg_cb__latency_factor, NULL);
 514     double_default_value = 1.0;
 515     xbt_cfg_register(&_sg_cfg_set, "network/bandwidth_factor",
 516                      "Correction factor to apply to the provided bandwidth (default value set by network model)",
 517                      xbt_cfgelm_double, &double_default_value, 1, 1,
 518                      _sg_cfg_cb__bandwidth_factor, NULL);
 519
 520     xbt_cfg_register(&_sg_cfg_set, "network/weight_S",
 521                      "Correction factor to apply to the weight of competing streams (default value set by network model)",
 522                      xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
 523                      _sg_cfg_cb__weight_S, NULL);
 524
 525     /* Inclusion path */
 526     xbt_cfg_register(&_sg_cfg_set, "path",
 527                      "Lookup path for inclusions in platform and deployment XML files",
 528                      xbt_cfgelm_string, NULL, 0, 0,
 529                      _sg_cfg_cb__surf_path, NULL);
 530
 531     default_value = xbt_strdup("off");
 532     xbt_cfg_register(&_sg_cfg_set, "cpu/maxmin_selective_update",
 533                      "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
 534                      xbt_cfgelm_boolean, &default_value, 0, 1,
 535                      NULL, NULL);
 536     default_value = xbt_strdup("off");
 537     xbt_cfg_register(&_sg_cfg_set, "network/maxmin_selective_update",
 538                      "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
 539                      xbt_cfgelm_boolean, &default_value, 0, 1,
 540                      NULL, NULL);
 541
 542 #ifdef HAVE_MC
 543     /* do model-checking */
 544     default_value = xbt_strdup("off");
 545     xbt_cfg_register(&_sg_cfg_set, "model-check",
 546                      "Verify the system through model-checking instead of simulating it (EXPERIMENTAL)",
 547                      xbt_cfgelm_boolean, NULL, 0, 1,
 548                      _sg_cfg_cb_model_check, NULL);
 549     xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check", default_value);
 550
 551     /* do stateful model-checking */
 552     default_value = xbt_strdup("off");
 553     xbt_cfg_register(&_sg_cfg_set, "model-check/checkpoint",
 554                      "Specify the amount of steps between checkpoints during stateful model-checking (default: off => stateless verification). "
 555                      "If value=on, one checkpoint is saved for each step => faster verification, but huge memory consumption; higher values are good compromises between speed and memory consumption.",
 556                      xbt_cfgelm_boolean, NULL, 0, 1,
 557                      _mc_cfg_cb_checkpoint, NULL);
 558     xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/checkpoint", default_value);
 559
 560     /* do liveness model-checking */
 561     xbt_cfg_register(&_sg_cfg_set, "model-check/property",
 562                      "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
 563                      xbt_cfgelm_string, NULL, 0, 1,
 564                      _mc_cfg_cb_property, NULL);
 565     xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
 566
 567     /* Specify the kind of model-checking reduction */
 568     xbt_cfg_register(&_sg_cfg_set, "model-check/reduction",
 569                      "Specify the kind of exploration reduction (either none or DPOR)",
 570                      xbt_cfgelm_string, NULL, 0, 1,
 571                      _mc_cfg_cb_reduce, NULL);
 572     xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/reduction", "dpor");
 573
 574     /* Enable/disable timeout for wait requests with model-checking */
 575     default_value = xbt_strdup("off");
 576     xbt_cfg_register(&_sg_cfg_set, "model-check/timeout",
 577                      "Enable/Disable timeout for wait requests",
 578                      xbt_cfgelm_boolean, NULL, 0, 1,
 579                      _mc_cfg_cb_timeout, NULL);
 580     xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/timeout", default_value);
 581
 582     /* Set max depth exploration */
 583     xbt_cfg_register(&_sg_cfg_set, "model-check/max_depth",
 584                      "Specify the max depth of exploration (default : 1000)",
 585                      xbt_cfgelm_int, NULL, 0, 1,
 586                      _mc_cfg_cb_max_depth, NULL);
 587     xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/max_depth", 1000);
 588
 589     /* Set number of visited state stored for state comparison reduction*/
 590     xbt_cfg_register(&_sg_cfg_set, "model-check/visited",
 591                      "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
 592                      xbt_cfgelm_int, NULL, 0, 1,
 593                      _mc_cfg_cb_visited, NULL);
 594     xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/visited", 0);
 595
 596     /* Set file name for dot output of graph state */
 597     xbt_cfg_register(&_sg_cfg_set, "model-check/dot_output",
 598                      "Specify the name of dot file corresponding to graph state",
 599                      xbt_cfgelm_string, NULL, 0, 1,
 600                      _mc_cfg_cb_dot_output, NULL);
 601     xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/dot_output", "");
 602 #endif
 603
 604     /* do verbose-exit */
 605     default_value = xbt_strdup("on");
 606     xbt_cfg_register(&_sg_cfg_set, "verbose-exit",
 607                      "Activate the \"do nothing\" mode in Ctrl-C",
 608                      xbt_cfgelm_boolean, &default_value, 0, 1,
 609                      _sg_cfg_cb_verbose_exit, NULL);
 610
 611
 612     /* context factory */
 613     default_value = xbt_strdup("ucontext");
 614     xbt_cfg_register(&_sg_cfg_set, "contexts/factory",
 615                      "Context factory to use in SIMIX (ucontext, thread or raw)",
 616                      xbt_cfgelm_string, &default_value, 1, 1, _sg_cfg_cb_context_factory, NULL);
 617
 618     /* stack size of contexts in Ko */
 619     default_value_int = 128;
 620     xbt_cfg_register(&_sg_cfg_set, "contexts/stack_size",
 621                      "Stack size of contexts in Kib (ucontext or raw only)",
 622                      xbt_cfgelm_int, &default_value_int, 1, 1,
 623                      _sg_cfg_cb_context_stack_size, NULL);
 624
 625     /* number of parallel threads for user processes */
 626     default_value_int = 1;
 627     xbt_cfg_register(&_sg_cfg_set, "contexts/nthreads",
 628                      "Number of parallel threads used to execute user contexts",
 629                      xbt_cfgelm_int, &default_value_int, 1, 1,
 630                      _sg_cfg_cb_contexts_nthreads, NULL);
 631
 632     /* minimal number of user contexts to be run in parallel */
 633     default_value_int = 2;
 634     xbt_cfg_register(&_sg_cfg_set, "contexts/parallel_threshold",
 635         "Minimal number of user contexts to be run in parallel (raw contexts only)",
 636         xbt_cfgelm_int, &default_value_int, 1, 1,
 637         _sg_cfg_cb_contexts_parallel_threshold, NULL);
 638
 639     /* synchronization mode for parallel user contexts */
 640 #ifdef HAVE_FUTEX_H
 641     default_value = xbt_strdup("futex");
 642 #else //No futex on mac and posix is unimplememted yet
 643     default_value = xbt_strdup("busy_wait");
 644 #endif
 645     xbt_cfg_register(&_sg_cfg_set, "contexts/synchro",
 646         "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
 647         xbt_cfgelm_string, &default_value, 1, 1,
 648         _sg_cfg_cb_contexts_parallel_mode, NULL);
 649
 650     default_value = xbt_strdup("no");
 651     xbt_cfg_register(&_sg_cfg_set, "network/coordinates",
 652                      "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
 653                      xbt_cfgelm_boolean, &default_value, 1, 1,
 654                      _sg_cfg_cb__surf_network_coordinates, NULL);
 655     xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/coordinates", default_value);
 656
 657     default_value = xbt_strdup("no");
 658     xbt_cfg_register(&_sg_cfg_set, "network/crosstraffic",
 659                      "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
 660                      xbt_cfgelm_boolean, &default_value, 0, 1,
 661                      _sg_cfg_cb__surf_network_crosstraffic, NULL);
 662     xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/crosstraffic", default_value);
 663
 664 #ifdef HAVE_GTNETS
 665     xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter",
 666                      "Double value to oscillate the link latency, uniformly in random interval [-latency*gtnets_jitter,latency*gtnets_jitter)",
 667                      xbt_cfgelm_double, NULL, 1, 1,
 668                      _sg_cfg_cb__gtnets_jitter, NULL);
 669     xbt_cfg_setdefault_double(_sg_cfg_set, "gtnets/jitter", 0.0);
 670
 671     default_value_int = 10;
 672     xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter_seed",
 673                      "Use a positive seed to reproduce jitted results, value must be in [1,1e8], default is 10",
 674                      xbt_cfgelm_int, &default_value_int, 0, 1,
 675                      _sg_cfg_cb__gtnets_jitter_seed, NULL);
 676 #endif
 677 #ifdef HAVE_NS3
 678     xbt_cfg_register(&_sg_cfg_set, "ns3/TcpModel",
 679                      "The ns3 tcp model can be : NewReno or Reno or Tahoe",
 680                      xbt_cfgelm_string, NULL, 1, 1,
 681                      NULL, NULL);
 682     xbt_cfg_setdefault_string(_sg_cfg_set, "ns3/TcpModel", "default");
 683 #endif
 684
 685 #ifdef HAVE_SMPI
 686     double default_reference_speed = 20000.0;
 687     xbt_cfg_register(&_sg_cfg_set, "smpi/running_power",
 688                      "Power of the host running the simulation (in flop/s). Used to bench the operations.",
 689                      xbt_cfgelm_double, &default_reference_speed, 1, 1, NULL,
 690                      NULL);
 691
 692     default_value = xbt_strdup("no");
 693     xbt_cfg_register(&_sg_cfg_set, "smpi/display_timing",
 694                      "Boolean indicating whether we should display the timing after simulation.",
 695                      xbt_cfgelm_boolean, &default_value, 1, 1, NULL,
 696                      NULL);
 697     xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/display_timing", default_value);
 698
 699     double default_threshold = 1e-6;
 700     xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
 701                      "Minimal computation time (in seconds) not discarded.",
 702                      xbt_cfgelm_double, &default_threshold, 1, 1, NULL,
 703                      NULL);
 704
 705     int default_small_messages_threshold = 0;
 706     xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thres",
 707                      "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
 708                      xbt_cfgelm_int, &default_small_messages_threshold, 1, 1, NULL,
 709                      NULL);
 710
 711     int default_send_is_detached_threshold = 65536;
 712     xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thres",
 713                      "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
 714                      xbt_cfgelm_int, &default_send_is_detached_threshold, 1, 1, NULL,
 715                      NULL);
 716
 717     //For smpi/bw_factor and smpi/lat_factor
 718     //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
 719     //test is if( size >= thresholdN ) return valueN;
 720     //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
 721     //  or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
 722     xbt_cfg_register(&_sg_cfg_set, "smpi/bw_factor",
 723                      "Bandwidth factors for smpi.",
 724                      xbt_cfgelm_string, NULL, 1, 1, NULL,
 725                      NULL);
 726     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/bw_factor", "65472:0.940694;15424:0.697866;9376:0.58729;5776:1.08739;3484:0.77493;1426:0.608902;732:0.341987;257:0.338112;0:0.812084");
 727
 728     xbt_cfg_register(&_sg_cfg_set, "smpi/lat_factor",
 729                      "Latency factors for smpi.",
 730                      xbt_cfgelm_string, NULL, 1, 1, NULL,
 731                      NULL);
 732     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/lat_factor", "65472:11.6436;15424:3.48845;9376:2.59299;5776:2.18796;3484:1.88101;1426:1.61075;732:1.9503;257:1.95341;0:2.01467");
 733
 734     xbt_cfg_register(&_sg_cfg_set, "smpi/os",
 735                      "Small messages timings (MPI_Send minimum time for small messages)",
 736                      xbt_cfgelm_string, NULL, 1, 1, NULL,
 737                      NULL);
 738     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
 739
 740     xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
 741                      "Small messages timings (MPI_Isend minimum time for small messages)",
 742                      xbt_cfgelm_string, NULL, 1, 1, NULL,
 743                      NULL);
 744     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
 745
 746     xbt_cfg_register(&_sg_cfg_set, "smpi/or",
 747                      "Small messages timings (MPI_Recv minimum time for small messages)",
 748                      xbt_cfgelm_string, NULL, 1, 1, NULL,
 749                      NULL);
 750     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
 751     double default_iprobe_time = 1e-4;
 752     xbt_cfg_register(&_sg_cfg_set, "smpi/iprobe",
 753                      "Minimum time to inject inside a call to MPI_Iprobe",
 754                      xbt_cfgelm_double, &default_iprobe_time, 1, 1, NULL,
 755                      NULL);
 756     default_value = xbt_strdup("default");
 757     xbt_cfg_register(&_sg_cfg_set, "smpi/coll_selector",
 758                      "Which collective selector to use",
 759                      xbt_cfgelm_string, &default_value, 1, 1, NULL,
 760                      NULL);
 761     xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
 762                      "Which collective to use for allgather",
 763                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allgather,
 764                      NULL);
 765
 766     xbt_cfg_register(&_sg_cfg_set, "smpi/allgatherv",
 767                      "Which collective to use for allgatherv",
 768                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allgatherv,
 769                      NULL);
 770
 771     xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
 772                      "Which collective to use for allreduce",
 773                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allreduce,
 774                      NULL);
 775
 776     xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
 777                      "Which collective to use for alltoall",
 778                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_alltoall,
 779                      NULL);
 780
 781     xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
 782                      "Which collective to use for alltoallv",
 783                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_alltoallv,
 784                      NULL);
 785
 786     xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
 787                      "Which collective to use for bcast",
 788                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_bcast,
 789                      NULL);
 790
 791     xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
 792                      "Which collective to use for reduce",
 793                      xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_reduce,
 794                      NULL);
 795 #endif // HAVE_SMPI
 796
 797     if (!surf_path) {
 798       /* retrieves the current directory of the        current process */
 799       const char *initial_path = __surf_get_initial_path();
 800       xbt_assert((initial_path),
 801                   "__surf_get_initial_path() failed! Can't resolves current Windows directory");
 802
 803       surf_path = xbt_dynar_new(sizeof(char *), NULL);
 804       xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
 805     }
 806
 807     _sg_init_status = 1;
 808
 809     sg_config_cmd_line(argc, argv);
 810
 811     xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
 812
 813   } else {
 814     XBT_WARN("Call to sg_config_init() after initialization ignored");
 815   }
 816 }
 817
 818 void sg_config_finalize(void)
 819 {
 820   if (!_sg_init_status)
 821     return;                     /* Not initialized yet. Nothing to do */
 822
 823   xbt_cfg_free(&_sg_cfg_set);
 824   _sg_init_status = 0;
 825 }
 826
 827 /* Pick the right models for CPU, net and workstation, and call their model_init_preparse */
 828 void surf_config_models_setup()
 829 {
 830   char *workstation_model_name;
 831   int workstation_id = -1;
 832   char *network_model_name = NULL;
 833   char *cpu_model_name = NULL;
 834   int storage_id = -1;
 835   char *storage_model_name = NULL;
 836
 837   workstation_model_name =
 838       xbt_cfg_get_string(_sg_cfg_set, "workstation/model");
 839   network_model_name = xbt_cfg_get_string(_sg_cfg_set, "network/model");
 840   cpu_model_name = xbt_cfg_get_string(_sg_cfg_set, "cpu/model");
 841   storage_model_name = xbt_cfg_get_string(_sg_cfg_set, "storage/model");
 842
 843   /* Check whether we use a net/cpu model differing from the default ones, in which case
 844    * we should switch to the "compound" workstation model to correctly dispatch stuff to
 845    * the right net/cpu models.
 846    */
 847
 848   if((!xbt_cfg_is_default_value(_sg_cfg_set, "network/model") ||
 849     !xbt_cfg_is_default_value(_sg_cfg_set, "cpu/model")) &&
 850     xbt_cfg_is_default_value(_sg_cfg_set, "workstation/model"))
 851   {
 852       const char *val = "compound";
 853       XBT_INFO
 854           ("Switching workstation model to compound since you changed the network and/or cpu model(s)");
 855       xbt_cfg_set_string(_sg_cfg_set, "workstation/model", val);
 856       workstation_model_name = (char *) "compound";
 857   }
 858
 859   XBT_DEBUG("Workstation model: %s", workstation_model_name);
 860   workstation_id =
 861       find_model_description(surf_workstation_model_description,
 862                              workstation_model_name);
 863   if (!strcmp(workstation_model_name, "compound")) {
 864     int network_id = -1;
 865     int cpu_id = -1;
 866
 867     xbt_assert(cpu_model_name,
 868                 "Set a cpu model to use with the 'compound' workstation model");
 869
 870     xbt_assert(network_model_name,
 871                 "Set a network model to use with the 'compound' workstation model");
 872
 873     network_id =
 874         find_model_description(surf_network_model_description,
 875                                network_model_name);
 876     cpu_id =
 877         find_model_description(surf_cpu_model_description, cpu_model_name);
 878
 879     surf_cpu_model_description[cpu_id].model_init_preparse();
 880     surf_network_model_description[network_id].model_init_preparse();
 881   }
 882
 883   XBT_DEBUG("Call workstation_model_init");
 884   surf_workstation_model_description[workstation_id].model_init_preparse();
 885
 886   XBT_DEBUG("Call storage_model_init");
 887   storage_id = find_model_description(surf_storage_model_description, storage_model_name);
 888   surf_storage_model_description[storage_id].model_init_preparse();
 889
 890   /* ********************************************************************* */
 891   /* TUTORIAL: New model                                                   */
 892   int new_model_id = -1;
 893   char *new_model_name = NULL;
 894   new_model_name = xbt_cfg_get_string(_sg_cfg_set, "new_model/model");
 895   XBT_DEBUG("Call new model_init");
 896   new_model_id = find_model_description(surf_new_model_description, new_model_name);
 897   surf_new_model_description[new_model_id].model_init_preparse();
 898   /* ********************************************************************* */
 899 }
 900
 901 int sg_cfg_get_int(const char* name)
 902 {
 903         return xbt_cfg_get_int(_sg_cfg_set,name);
 904 }
 905 double sg_cfg_get_double(const char* name)
 906 {
 907         return xbt_cfg_get_double(_sg_cfg_set,name);
 908 }
 909 char* sg_cfg_get_string(const char* name)
 910 {
 911         return xbt_cfg_get_string(_sg_cfg_set,name);
 912 }
 913 int sg_cfg_get_boolean(const char* name)
 914 {
 915         return xbt_cfg_get_boolean(_sg_cfg_set,name);
 916 }
 917 void sg_cfg_get_peer(const char *name, char **peer, int *port)
 918 {
 919         xbt_cfg_get_peer(_sg_cfg_set,name, peer, port);
 920 }
 921 xbt_dynar_t sg_cfg_get_dynar(const char* name)
 922 {
 923         return xbt_cfg_get_dynar(_sg_cfg_set,name);
 924 }