src/simgrid/sg_config.cpp

   1 /* Copyright (c) 2009-2010, 2012-2015. 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 "simgrid_config.h" /* what was compiled in? */
  22 #if HAVE_SMPI
  23 #include "smpi/smpi_interface.h"
  24 #endif
  25 #include "mc/mc.h"
  26 #include "simgrid/instr.h"
  27 #include "src/mc/mc_replay.h"
  28
  29 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_config, surf, "About the configuration of SimGrid");
  30
  31 xbt_cfg_t _sg_cfg_set = NULL;
  32
  33 /* 0: beginning of time (config cannot be changed yet);
  34  * 1: initialized: cfg_set created (config can now be changed);
  35  * 2: configured: command line parsed and config part of platform file was
  36  *    integrated also, platform construction ongoing or done.
  37  *    (Config cannot be changed anymore!)
  38  */
  39 int _sg_cfg_init_status = 0;
  40
  41 /* instruct the upper layer (simix or simdag) to exit as soon as possible */
  42 int _sg_cfg_exit_asap = 0;
  43
  44 #define sg_cfg_exit_early() do { _sg_cfg_exit_asap = 1; return; } while (0)
  45
  46 /* Parse the command line, looking for options */
  47 static void sg_config_cmd_line(int *argc, char **argv)
  48 {
  49   int shall_exit = 0;
  50   int i, j;
  51   char *opt;
  52
  53   for (j = i = 1; i < *argc; i++) {
  54     if (!strncmp(argv[i], "--cfg=", strlen("--cfg="))) {
  55       opt = strchr(argv[i], '=');
  56       opt++;
  57
  58       xbt_cfg_set_parse(_sg_cfg_set, opt);
  59       XBT_DEBUG("Did apply '%s' as config setting", opt);
  60     } else if (!strcmp(argv[i], "--version")) {
  61       printf("%s\n", SIMGRID_VERSION_STRING);
  62       shall_exit = 1;
  63     } else if (!strcmp(argv[i], "--cfg-help") || !strcmp(argv[i], "--help")) {
  64       printf("Description of the configuration accepted by this simulator:\n");
  65       xbt_cfg_help(_sg_cfg_set);
  66       printf(
  67           "\n"
  68           "Each of these configurations can be used by adding\n"
  69           "    --cfg=<option name>:<option value>\n"
  70           "to the command line.\n"
  71           "\n"
  72           "For more information, please refer to:\n"
  73           "   --help-aliases for the list of all option aliases.\n"
  74           "   --help-logs and --help-log-categories for the details of logging output.\n"
  75           "   --help-models for a list of all models known by this simulator.\n"
  76           "   --help-tracing for the details of all tracing options known by this simulator.\n"
  77           "   --version to get SimGrid version information.\n"
  78           "\n"
  79         );
  80       shall_exit = 1;
  81     } else if (!strcmp(argv[i], "--help-aliases")) {
  82       printf("Here is a list of all deprecated option names, with their replacement.\n");
  83       xbt_cfg_aliases(_sg_cfg_set);
  84       printf("Please consider using the recent names\n");
  85       shall_exit = 1;
  86     } else if (!strcmp(argv[i], "--help-models")) {
  87       int k;
  88
  89       model_help("host", surf_host_model_description);
  90       printf("\n");
  91       model_help("CPU", surf_cpu_model_description);
  92       printf("\n");
  93       model_help("network", surf_network_model_description);
  94       printf("\nLong description of all optimization levels accepted by the models of this simulator:\n");
  95       for (k = 0; surf_optimization_mode_description[k].name; k++)
  96         printf("  %s: %s\n",
  97                surf_optimization_mode_description[k].name,
  98                surf_optimization_mode_description[k].description);
  99       printf("Both network and CPU models have 'Lazy' as default optimization level\n\n");
 100       shall_exit = 1;
 101     } else if (!strcmp(argv[i], "--help-tracing")) {
 102       TRACE_help (1);
 103       shall_exit = 1;
 104     } else {
 105       argv[j++] = argv[i];
 106     }
 107   }
 108   if (j < *argc) {
 109     argv[j] = NULL;
 110     *argc = j;
 111   }
 112   if (shall_exit)
 113     sg_cfg_exit_early();
 114 }
 115
 116 /* callback of the plugin variable */
 117 static void _sg_cfg_cb__plugin(const char *name, int pos)
 118 {
 119   char *val;
 120
 121   XBT_VERB("PLUGIN");
 122   xbt_assert(_sg_cfg_init_status < 2,
 123               "Cannot load a plugin after the initialization");
 124
 125   val = xbt_cfg_get_string(_sg_cfg_set, name);
 126
 127   if (!strcmp(val, "help")) {
 128     model_help("plugin", surf_plugin_description);
 129     sg_cfg_exit_early();
 130   }
 131
 132   /* New Module missing */
 133   int plugin_id = find_model_description(surf_plugin_description, val);
 134   surf_plugin_description[plugin_id].model_init_preparse();
 135 }
 136
 137 /* callback of the host/model variable */
 138 static void _sg_cfg_cb__host_model(const char *name, int pos)
 139 {
 140   char *val;
 141
 142   xbt_assert(_sg_cfg_init_status < 2,
 143               "Cannot change the model after the initialization");
 144
 145   val = xbt_cfg_get_string(_sg_cfg_set, name);
 146
 147   if (!strcmp(val, "help")) {
 148     model_help("host", surf_host_model_description);
 149     sg_cfg_exit_early();
 150   }
 151
 152   /* Make sure that the model exists */
 153   find_model_description(surf_host_model_description, val);
 154 }
 155
 156 /* callback of the vm/model variable */
 157 static void _sg_cfg_cb__vm_model(const char *name, int pos)
 158 {
 159   char *val;
 160
 161   xbt_assert(_sg_cfg_init_status < 2,
 162               "Cannot change the model after the initialization");
 163
 164   val = xbt_cfg_get_string(_sg_cfg_set, name);
 165
 166   if (!strcmp(val, "help")) {
 167     model_help("vm", surf_vm_model_description);
 168     sg_cfg_exit_early();
 169   }
 170
 171   /* Make sure that the model exists */
 172   find_model_description(surf_vm_model_description, val);
 173 }
 174
 175 /* callback of the cpu/model variable */
 176 static void _sg_cfg_cb__cpu_model(const char *name, int pos)
 177 {
 178   char *val;
 179
 180   xbt_assert(_sg_cfg_init_status < 2,
 181               "Cannot change the model after the initialization");
 182
 183   val = xbt_cfg_get_string(_sg_cfg_set, name);
 184
 185   if (!strcmp(val, "help")) {
 186     model_help("CPU", surf_cpu_model_description);
 187     sg_cfg_exit_early();
 188   }
 189
 190   /* New Module missing */
 191   find_model_description(surf_cpu_model_description, val);
 192 }
 193
 194 /* callback of the cpu/model variable */
 195 static void _sg_cfg_cb__optimization_mode(const char *name, int pos)
 196 {
 197   char *val;
 198
 199   xbt_assert(_sg_cfg_init_status < 2,
 200               "Cannot change the model after the initialization");
 201
 202   val = xbt_cfg_get_string(_sg_cfg_set, name);
 203
 204   if (!strcmp(val, "help")) {
 205     model_help("optimization", surf_optimization_mode_description);
 206     sg_cfg_exit_early();
 207   }
 208
 209   /* New Module missing */
 210   find_model_description(surf_optimization_mode_description, val);
 211 }
 212
 213 /* callback of the cpu/model variable */
 214 static void _sg_cfg_cb__storage_mode(const char *name, int pos)
 215 {
 216   char *val;
 217
 218   xbt_assert(_sg_cfg_init_status < 2,
 219               "Cannot change the model after the initialization");
 220
 221   val = xbt_cfg_get_string(_sg_cfg_set, name);
 222
 223   if (!strcmp(val, "help")) {
 224     model_help("storage", surf_storage_model_description);
 225     sg_cfg_exit_early();
 226   }
 227
 228   /* New Module missing */
 229   find_model_description(surf_storage_model_description, val);
 230 }
 231
 232 /* callback of the network_model variable */
 233 static void _sg_cfg_cb__network_model(const char *name, int pos)
 234 {
 235   char *val;
 236
 237   xbt_assert(_sg_cfg_init_status < 2,
 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     model_help("network", surf_network_model_description);
 244     sg_cfg_exit_early();
 245   }
 246
 247   /* New Module missing */
 248   find_model_description(surf_network_model_description, val);
 249 }
 250
 251 /* callbacks of the network models values */
 252 static void _sg_cfg_cb__tcp_gamma(const char *name, int pos)
 253 {
 254   sg_tcp_gamma = xbt_cfg_get_double(_sg_cfg_set, name);
 255 }
 256
 257 static void _sg_cfg_cb__maxmin_precision(const char* name, int pos)
 258 {
 259   sg_maxmin_precision = xbt_cfg_get_double(_sg_cfg_set, name);
 260 }
 261
 262 static void _sg_cfg_cb__surf_precision(const char* name, int pos)
 263 {
 264   sg_surf_precision = xbt_cfg_get_double(_sg_cfg_set, name);
 265 }
 266
 267 static void _sg_cfg_cb__sender_gap(const char* name, int pos)
 268 {
 269   sg_sender_gap = xbt_cfg_get_double(_sg_cfg_set, name);
 270 }
 271
 272 static void _sg_cfg_cb__latency_factor(const char *name, int pos)
 273 {
 274   sg_latency_factor = xbt_cfg_get_double(_sg_cfg_set, name);
 275 }
 276
 277 static void _sg_cfg_cb__bandwidth_factor(const char *name, int pos)
 278 {
 279   sg_bandwidth_factor = xbt_cfg_get_double(_sg_cfg_set, name);
 280 }
 281
 282 static void _sg_cfg_cb__weight_S(const char *name, int pos)
 283 {
 284   sg_weight_S_parameter = xbt_cfg_get_double(_sg_cfg_set, name);
 285 }
 286
 287 #if HAVE_SMPI
 288 /* callback of the mpi collectives */
 289 static void _sg_cfg_cb__coll(const char *category,
 290                              s_mpi_coll_description_t * table,
 291                              const char *name, int pos)
 292 {
 293   char *val;
 294
 295   xbt_assert(_sg_cfg_init_status < 2,
 296               "Cannot change the model after the initialization");
 297
 298   val = xbt_cfg_get_string(_sg_cfg_set, name);
 299
 300   if (!strcmp(val, "help")) {
 301     coll_help(category, table);
 302     sg_cfg_exit_early();
 303   }
 304
 305   /* New Module missing */
 306   find_coll_description(table, val, category);
 307 }
 308 static void _sg_cfg_cb__coll_gather(const char *name, int pos){
 309   _sg_cfg_cb__coll("gather", mpi_coll_gather_description, name, pos);
 310 }
 311 static void _sg_cfg_cb__coll_allgather(const char *name, int pos){
 312   _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
 313 }
 314 static void _sg_cfg_cb__coll_allgatherv(const char *name, int pos){
 315   _sg_cfg_cb__coll("allgatherv", mpi_coll_allgatherv_description, name, pos);
 316 }
 317 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
 318 {
 319   _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
 320 }
 321 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
 322 {
 323   _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
 324 }
 325 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
 326 {
 327   _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
 328 }
 329 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
 330 {
 331   _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
 332 }
 333 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
 334 {
 335   _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
 336 }
 337 static void _sg_cfg_cb__coll_reduce_scatter(const char *name, int pos){
 338   _sg_cfg_cb__coll("reduce_scatter", mpi_coll_reduce_scatter_description, name, pos);
 339 }
 340 static void _sg_cfg_cb__coll_scatter(const char *name, int pos){
 341   _sg_cfg_cb__coll("scatter", mpi_coll_scatter_description, name, pos);
 342 }
 343 static void _sg_cfg_cb__coll_barrier(const char *name, int pos){
 344   _sg_cfg_cb__coll("barrier", mpi_coll_barrier_description, name, pos);
 345 }
 346
 347 static void _sg_cfg_cb__wtime_sleep(const char *name, int pos){
 348   smpi_wtime_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
 349 }
 350
 351 static void _sg_cfg_cb__iprobe_sleep(const char *name, int pos){
 352   smpi_iprobe_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
 353 }
 354
 355 static void _sg_cfg_cb__test_sleep(const char *name, int pos){
 356   smpi_test_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
 357 }
 358
 359
 360
 361 #endif
 362
 363 /* callback of the inclusion path */
 364 static void _sg_cfg_cb__surf_path(const char *name, int pos)
 365 {
 366   char *path = xbt_strdup(xbt_cfg_get_string_at(_sg_cfg_set, name, pos));
 367   xbt_dynar_push(surf_path, &path);
 368 }
 369
 370 /* callback to decide if we want to use the model-checking */
 371 #include "src/xbt_modinter.h"
 372
 373 #if HAVE_MC
 374 extern int _sg_do_model_check;   /* this variable lives in xbt_main until I find a right location for it */
 375 extern int _sg_do_model_check_record;
 376 #endif
 377
 378 static void _sg_cfg_cb_model_check_replay(const char *name, int pos) {
 379   MC_record_path = xbt_cfg_get_string(_sg_cfg_set, name);
 380 }
 381
 382 #if HAVE_MC
 383 static void _sg_cfg_cb_model_check_record(const char *name, int pos) {
 384   _sg_do_model_check_record = xbt_cfg_get_boolean(_sg_cfg_set, name);
 385 }
 386 #endif
 387
 388 extern int _sg_do_verbose_exit;
 389
 390 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
 391 {
 392   _sg_do_verbose_exit = xbt_cfg_get_boolean(_sg_cfg_set, name);
 393 }
 394
 395 extern int _sg_do_clean_atexit;
 396
 397 static void _sg_cfg_cb_clean_atexit(const char *name, int pos)
 398 {
 399   _sg_do_clean_atexit = xbt_cfg_get_boolean(_sg_cfg_set, name);
 400 }
 401
 402 static void _sg_cfg_cb_context_factory(const char *name, int pos)
 403 {
 404   smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
 405 }
 406
 407 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
 408 {
 409   smx_context_stack_size_was_set = 1;
 410   smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
 411 }
 412
 413 static void _sg_cfg_cb_context_guard_size(const char *name, int pos)
 414 {
 415   smx_context_guard_size_was_set = 1;
 416   smx_context_guard_size = xbt_cfg_get_int(_sg_cfg_set, name) * xbt_pagesize;
 417 }
 418
 419 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
 420 {
 421   SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
 422 }
 423
 424 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
 425 {
 426   SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
 427 }
 428
 429 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
 430 {
 431   const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
 432   if (!strcmp(mode_name, "posix")) {
 433     SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
 434   }
 435   else if (!strcmp(mode_name, "futex")) {
 436     SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
 437   }
 438   else if (!strcmp(mode_name, "busy_wait")) {
 439     SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
 440   }
 441   else {
 442     xbt_die("Command line setting of the parallel synchronization mode should "
 443             "be one of \"posix\", \"futex\" or \"busy_wait\"");
 444   }
 445 }
 446
 447 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
 448                                                  int pos)
 449 {
 450   static int already_set = 0;
 451   int val = xbt_cfg_get_boolean(_sg_cfg_set, name);
 452   if (val) {
 453     if (!already_set) {
 454       COORD_HOST_LEVEL = sg_host_extension_create(xbt_dynar_free_voidp);
 455       COORD_ASR_LEVEL  = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
 456     }
 457     already_set = 1;
 458   } else
 459     if (already_set)
 460       xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
 461 }
 462
 463 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
 464                                                   int pos)
 465 {
 466   sg_network_crosstraffic = xbt_cfg_get_boolean(_sg_cfg_set, name);
 467 }
 468
 469 /* build description line with possible values */
 470 static void describe_model(char *result,
 471                            const s_surf_model_description_t model_description[],
 472                            const char *name,
 473                            const char *description)
 474 {
 475   char *p = result +
 476     sprintf(result, "%s. Possible values: %s", description,
 477             model_description[0].name ? model_description[0].name : "n/a");
 478   int i;
 479   for (i = 1; model_description[i].name; i++)
 480     p += sprintf(p, ", %s", model_description[i].name);
 481   sprintf(p,
 482       ".\n       (use 'help' as a value to see the long description of each %s)",
 483           name);
 484 }
 485
 486 /* create the config set, register what should be and parse the command line*/
 487 void sg_config_init(int *argc, char **argv)
 488 {
 489   char description[1024];
 490
 491   /* Create the configuration support */
 492   if (_sg_cfg_init_status == 0) { /* Only create stuff if not already inited */
 493
 494     /* Plugins configuration */
 495     describe_model(description, surf_plugin_description,
 496                    "plugin", "The plugins");
 497     xbt_cfg_register(&_sg_cfg_set, "plugin", description,
 498                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__plugin);
 499
 500     describe_model(description, surf_cpu_model_description, "model", "The model to use for the CPU");
 501     xbt_cfg_register_string(&_sg_cfg_set, "cpu/model", description, "Cas01", &_sg_cfg_cb__cpu_model);
 502
 503     describe_model(description, surf_optimization_mode_description, "optimization mode", "The optimization modes to use for the CPU");
 504     xbt_cfg_register_string(&_sg_cfg_set, "cpu/optim", description, "Lazy", &_sg_cfg_cb__optimization_mode);
 505
 506     describe_model(description, surf_storage_model_description, "model", "The model to use for the storage");
 507     xbt_cfg_register_string(&_sg_cfg_set, "storage/model", description, "default", &_sg_cfg_cb__storage_mode);
 508
 509     describe_model(description, surf_network_model_description, "model", "The model to use for the network");
 510     xbt_cfg_register_string(&_sg_cfg_set, "network/model", description, "LV08", &_sg_cfg_cb__network_model);
 511
 512     describe_model(description, surf_optimization_mode_description, "optimization mode", "The optimization modes to use for the network");
 513     xbt_cfg_register_string(&_sg_cfg_set, "network/optim", description, "Lazy", &_sg_cfg_cb__optimization_mode);
 514
 515     describe_model(description, surf_host_model_description, "model", "The model to use for the host");
 516     xbt_cfg_register_string(&_sg_cfg_set, "host/model", description, "default", &_sg_cfg_cb__host_model);
 517
 518     describe_model(description, surf_vm_model_description, "model", "The model to use for the vm");
 519     xbt_cfg_register_string(&_sg_cfg_set, "vm/model", description, "default", &_sg_cfg_cb__vm_model);
 520
 521     xbt_cfg_register_double(&_sg_cfg_set, "network/TCP_gamma",
 522         "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)",
 523         4194304.0, _sg_cfg_cb__tcp_gamma);
 524
 525     xbt_cfg_register_double(&_sg_cfg_set, "surf/precision", "Numerical precision used when updating simulation times (in seconds)",
 526         0.00001, _sg_cfg_cb__surf_precision);
 527
 528     xbt_cfg_register_double(&_sg_cfg_set, "maxmin/precision",
 529         "Numerical precision used when computing resource sharing (in ops/sec or bytes/sec)",
 530         0.00001, _sg_cfg_cb__maxmin_precision);
 531
 532     /* The parameters of network models */
 533
 534     xbt_cfg_register_double(&_sg_cfg_set, "network/sender_gap", "Minimum gap between two overlapping sends",
 535         NAN, _sg_cfg_cb__sender_gap); /* real default for "network/sender_gap" is set in network_smpi.cpp */
 536     xbt_cfg_register_double(&_sg_cfg_set, "network/latency_factor",
 537         "Correction factor to apply to the provided latency (default value set by network model)",
 538         1.0, _sg_cfg_cb__latency_factor);
 539     xbt_cfg_register_double(&_sg_cfg_set, "network/bandwidth_factor",
 540         "Correction factor to apply to the provided bandwidth (default value set by network model)",
 541         1.0, _sg_cfg_cb__bandwidth_factor);
 542     xbt_cfg_register_double(&_sg_cfg_set, "network/weight_S",
 543         "Correction factor to apply to the weight of competing streams (default value set by network model)",
 544         NAN, _sg_cfg_cb__weight_S); /* real default for "network/weight_S" is set in network_*.cpp */
 545
 546     /* Inclusion path */
 547     xbt_cfg_register(&_sg_cfg_set, "path",
 548                      "Lookup path for inclusions in platform and deployment XML files",
 549                      xbt_cfgelm_string, 1, 0, _sg_cfg_cb__surf_path);
 550
 551     xbt_cfg_register_boolean(&_sg_cfg_set, "cpu/maxmin_selective_update",
 552         "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
 553         "no", NULL);
 554     xbt_cfg_register_boolean(&_sg_cfg_set, "network/maxmin_selective_update",
 555         "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
 556         "no", NULL);
 557     /* Replay (this part is enabled even if MC it disabled) */
 558     xbt_cfg_register(&_sg_cfg_set, "model-check/replay",
 559       "Enable replay mode with the given path", xbt_cfgelm_string, 0, 1, _sg_cfg_cb_model_check_replay);
 560
 561 #if HAVE_MC
 562     /* do model-checking-record */
 563     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/record", "Record the model-checking paths",
 564         "no", _sg_cfg_cb_model_check_record);
 565
 566     /* do stateful model-checking */
 567     xbt_cfg_register_int(&_sg_cfg_set, "model-check/checkpoint",
 568                      "Specify the amount of steps between checkpoints during stateful model-checking (default: 0 => stateless verification). "
 569                      "If value=1, one checkpoint is saved for each step => faster verification, but huge memory consumption; higher values are good compromises between speed and memory consumption.",
 570                      0, _mc_cfg_cb_checkpoint);
 571
 572     /* do stateful model-checking */
 573     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/sparse_checkpoint", "Use sparse per-page snapshots.",
 574         "no", _mc_cfg_cb_sparse_checkpoint);
 575
 576     /* do stateful model-checking */
 577     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/soft-dirty", "Use sparse per-page snapshots.",
 578         "no", _mc_cfg_cb_soft_dirty);
 579
 580     xbt_cfg_register(&_sg_cfg_set, "model-check/ksm",
 581                      "Kernel same-page merging",
 582                      xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_ksm);
 583     xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/ksm", "no");
 584
 585     /* do liveness model-checking */
 586     xbt_cfg_register(&_sg_cfg_set, "model-check/property",
 587                      "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
 588                      xbt_cfgelm_string, 1, 1, _mc_cfg_cb_property);
 589     xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
 590
 591     /* do communications determinism model-checking */
 592     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/communications_determinism",
 593         "Enable/disable the detection of determinism in the communications schemes", "no", _mc_cfg_cb_comms_determinism);
 594
 595     /* do send determinism model-checking */
 596     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/send_determinism",
 597         "Enable/disable the detection of send-determinism in the communications schemes", "no", _mc_cfg_cb_send_determinism);
 598
 599     /* Specify the kind of model-checking reduction */
 600     xbt_cfg_register_string(&_sg_cfg_set, "model-check/reduction", "Specify the kind of exploration reduction (either none or DPOR)",
 601                      "dpor", _mc_cfg_cb_reduce);
 602
 603     /* Enable/disable timeout for wait requests with model-checking */
 604     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/timeout", "Enable/Disable timeout for wait requests", "no",
 605         _mc_cfg_cb_timeout);
 606
 607     /* Enable/disable global hash computation with model-checking */
 608     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/hash", "Enable/Disable state hash for state comparison (experimental)", "no",
 609         _mc_cfg_cb_hash);
 610
 611     /* Set max depth exploration */
 612     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/snapshot_fds", "Whether file descriptors must be snapshoted (currently unusable)", "no",
 613         _mc_cfg_cb_snapshot_fds);
 614
 615     /* Set max depth exploration */
 616     xbt_cfg_register_int(&_sg_cfg_set, "model-check/max_depth", "Specify the max depth of exploration (default: 1000)", 1000,
 617                      _mc_cfg_cb_max_depth);
 618
 619     /* Set number of visited state stored for state comparison reduction*/
 620     xbt_cfg_register_int(&_sg_cfg_set, "model-check/visited",
 621                      "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
 622                      0, _mc_cfg_cb_visited);
 623
 624     /* Set file name for dot output of graph state */
 625     xbt_cfg_register_string(&_sg_cfg_set, "model-check/dot_output",
 626                      "Specify the name of dot file corresponding to graph state",
 627                      "", _mc_cfg_cb_dot_output);
 628
 629      /* Enable/disable non progressive cycles detection with model-checking */
 630     xbt_cfg_register_boolean(&_sg_cfg_set, "model-check/termination",
 631                      "Enable/Disable non progressive cycle detection",
 632                      "no", _mc_cfg_cb_termination);
 633 #endif
 634
 635     /* do verbose-exit */
 636     xbt_cfg_register_boolean(&_sg_cfg_set, "verbose-exit", "Activate the \"do nothing\" mode in Ctrl-C",
 637                      "yes", _sg_cfg_cb_verbose_exit);
 638
 639     /* context factory */
 640     const char *dflt_ctx_fact = "thread";
 641     {
 642       char *p = description +
 643         sprintf(description,
 644                 "Context factory to use in SIMIX. Possible values: %s",
 645                 dflt_ctx_fact);
 646 #if HAVE_UCONTEXT_CONTEXTS
 647       dflt_ctx_fact = "ucontext";
 648       p += sprintf(p, ", %s", dflt_ctx_fact);
 649 #endif
 650 #if HAVE_RAW_CONTEXTS
 651       dflt_ctx_fact = "raw";
 652       p += sprintf(p, ", %s", dflt_ctx_fact);
 653 #endif
 654       sprintf(p, ".");
 655     }
 656     xbt_cfg_register_string(&_sg_cfg_set, "contexts/factory", description, dflt_ctx_fact, _sg_cfg_cb_context_factory);
 657
 658     /* stack size of contexts in KiB */
 659     xbt_cfg_register_int(&_sg_cfg_set, "contexts/stack_size", "Stack size of contexts in KiB",
 660                      8*1024, _sg_cfg_cb_context_stack_size);
 661     /* (FIXME: this is unpleasant) Reset this static variable that was altered when setting the default value. */
 662     smx_context_stack_size_was_set = 0;
 663
 664     /* guard size for contexts stacks in memory pages */
 665     xbt_cfg_register(&_sg_cfg_set, "contexts/guard_size",
 666                      "Guard size for contexts stacks in memory pages",
 667                      xbt_cfgelm_int, 1, 1, _sg_cfg_cb_context_guard_size);
 668 #if defined(_WIN32) || (PTH_STACKGROWTH != -1)
 669     xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/guard_size", 0);
 670 #else
 671     xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/guard_size", 1);
 672 #endif
 673     /* No, it was not set yet (the above setdefault() changed this to 1). */
 674     smx_context_guard_size_was_set = 0;
 675
 676     /* number of parallel threads for user processes */
 677     xbt_cfg_register_int(&_sg_cfg_set, "contexts/nthreads",
 678                      "Number of parallel threads used to execute user contexts",
 679                      1, _sg_cfg_cb_contexts_nthreads);
 680
 681     /* minimal number of user contexts to be run in parallel */
 682     xbt_cfg_register_int(&_sg_cfg_set, "contexts/parallel_threshold",
 683                      "Minimal number of user contexts to be run in parallel (raw contexts only)",
 684                      2, _sg_cfg_cb_contexts_parallel_threshold);
 685
 686     /* synchronization mode for parallel user contexts */
 687     xbt_cfg_register_string(&_sg_cfg_set, "contexts/synchro",
 688                      "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
 689 #if HAVE_FUTEX_H
 690     "futex",     _sg_cfg_cb_contexts_parallel_mode);
 691 #else //No futex on mac and posix is unimplememted yet
 692     "busy_wait", _sg_cfg_cb_contexts_parallel_mode);
 693 #endif
 694
 695     xbt_cfg_register_boolean(&_sg_cfg_set, "network/coordinates",
 696                      "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
 697                      "no", _sg_cfg_cb__surf_network_coordinates);
 698
 699     xbt_cfg_register_boolean(&_sg_cfg_set, "network/crosstraffic",
 700                      "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
 701                      "yes", _sg_cfg_cb__surf_network_crosstraffic);
 702
 703 #if HAVE_NS3
 704     xbt_cfg_register_string(&_sg_cfg_set, "ns3/TcpModel", "The ns3 tcp model can be : NewReno or Reno or Tahoe", "default", NULL);
 705 #endif
 706
 707     //For smpi/bw_factor and smpi/lat_factor
 708     //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
 709     //test is if( size >= thresholdN ) return valueN;
 710     //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
 711     //  or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
 712     // SMPI model can be used without enable_smpi, so keep this out of the ifdef.
 713     xbt_cfg_register_string(&_sg_cfg_set, "smpi/bw_factor", "Bandwidth factors for smpi.",
 714         "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", NULL);
 715
 716     xbt_cfg_register_string(&_sg_cfg_set, "smpi/lat_factor", "Latency factors for smpi.",
 717         "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", NULL);
 718
 719     xbt_cfg_register_string(&_sg_cfg_set, "smpi/IB_penalty_factors",
 720         "Correction factor to communications using Infiniband model with contention (default value based on Stampede cluster profiling)",
 721         "0.965;0.925;1.35", NULL);
 722
 723 #if HAVE_SMPI
 724     xbt_cfg_register_double(&_sg_cfg_set, "smpi/running_power",
 725         "Power of the host running the simulation (in flop/s). Used to bench the operations.", 20000.0, NULL);
 726
 727     xbt_cfg_register_boolean(&_sg_cfg_set, "smpi/display_timing",
 728         "Boolean indicating whether we should display the timing after simulation.", "no", NULL);
 729
 730     xbt_cfg_register_boolean(&_sg_cfg_set, "smpi/simulate_computation",
 731         "Boolean indicating whether the computational part of the simulated application should be simulated.", "yes", NULL);
 732
 733     xbt_cfg_register(&_sg_cfg_set, "smpi/use_shared_malloc",
 734                      "Boolean indicating whether we should use shared memory when using SMPI_SHARED_MALLOC. Allows user to disable it for debug purposes.",
 735                      xbt_cfgelm_boolean, 1, 1, NULL);
 736     xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/use_shared_malloc", "yes");
 737
 738     xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
 739                      "Minimal computation time (in seconds) not discarded, or -1 for infinity.",
 740                      xbt_cfgelm_double, 1, 1, NULL);
 741     xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/cpu_threshold", 1e-6);
 742
 743     xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thresh",
 744                      "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
 745                      xbt_cfgelm_int, 1, 1, NULL);
 746     xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/async_small_thresh", 0);
 747
 748     xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thresh",
 749                      "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
 750                      xbt_cfgelm_int, 1, 1, NULL);
 751     xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/send_is_detached_thresh", 65536);
 752
 753     xbt_cfg_register(&_sg_cfg_set, "smpi/privatize_global_variables",
 754                      "Boolean indicating whether we should privatize global variable at runtime.",
 755                      xbt_cfgelm_boolean, 1, 1, NULL);
 756     xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/privatize_global_variables", "no");
 757
 758     xbt_cfg_register(&_sg_cfg_set, "smpi/os",
 759                      "Small messages timings (MPI_Send minimum time for small messages)",
 760                      xbt_cfgelm_string, 1, 1, NULL);
 761     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
 762
 763     xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
 764                      "Small messages timings (MPI_Isend minimum time for small messages)",
 765                      xbt_cfgelm_string, 1, 1, NULL);
 766     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
 767
 768     xbt_cfg_register(&_sg_cfg_set, "smpi/or",
 769                      "Small messages timings (MPI_Recv minimum time for small messages)",
 770                      xbt_cfgelm_string, 1, 1, NULL);
 771     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
 772
 773     xbt_cfg_register(&_sg_cfg_set, "smpi/iprobe",
 774                      "Minimum time to inject inside a call to MPI_Iprobe",
 775                      xbt_cfgelm_double, 1, 1, _sg_cfg_cb__iprobe_sleep);
 776     xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/iprobe", 1e-4);
 777
 778     xbt_cfg_register(&_sg_cfg_set, "smpi/test",
 779                      "Minimum time to inject inside a call to MPI_Test",
 780                      xbt_cfgelm_double, 1, 1, _sg_cfg_cb__test_sleep);
 781     xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/test", 1e-4);
 782
 783     xbt_cfg_register(&_sg_cfg_set, "smpi/wtime",
 784                      "Minimum time to inject inside a call to MPI_Wtime",
 785                      xbt_cfgelm_double, 1, 1, _sg_cfg_cb__wtime_sleep);
 786     xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/wtime", 0.0);
 787
 788     xbt_cfg_register(&_sg_cfg_set, "smpi/coll_selector",
 789                      "Which collective selector to use",
 790                      xbt_cfgelm_string, 1, 1, NULL);
 791     xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/coll_selector", "default");
 792
 793     xbt_cfg_register(&_sg_cfg_set, "smpi/gather",
 794                      "Which collective to use for gather",
 795                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_gather);
 796
 797     xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
 798                      "Which collective to use for allgather",
 799                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allgather);
 800
 801     xbt_cfg_register(&_sg_cfg_set, "smpi/barrier",
 802                      "Which collective to use for barrier",
 803                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_barrier);
 804
 805     xbt_cfg_register(&_sg_cfg_set, "smpi/reduce_scatter",
 806                      "Which collective to use for reduce_scatter",
 807                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_reduce_scatter);
 808
 809     xbt_cfg_register(&_sg_cfg_set, "smpi/scatter",
 810                      "Which collective to use for scatter",
 811                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_scatter);
 812
 813     xbt_cfg_register(&_sg_cfg_set, "smpi/allgatherv",
 814                      "Which collective to use for allgatherv",
 815                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allgatherv);
 816
 817     xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
 818                      "Which collective to use for allreduce",
 819                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allreduce);
 820
 821     xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
 822                      "Which collective to use for alltoall",
 823                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_alltoall);
 824
 825     xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
 826                      "Which collective to use for alltoallv",
 827                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_alltoallv);
 828
 829     xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
 830                      "Which collective to use for bcast",
 831                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_bcast);
 832
 833     xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
 834                      "Which collective to use for reduce",
 835                      xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_reduce);
 836 #endif // HAVE_SMPI
 837
 838     xbt_cfg_register(&_sg_cfg_set, "exception/cutpath",
 839                      "\"yes\" or \"no\". \"yes\" will cut all path information from call traces, used e.g. in exceptions.",
 840                      xbt_cfgelm_boolean, 1, 1, NULL);
 841     xbt_cfg_setdefault_boolean(_sg_cfg_set, "exception/cutpath", "no");
 842
 843     xbt_cfg_register(&_sg_cfg_set, "clean_atexit",
 844                      "\"yes\" or \"no\". \"yes\" enables all the cleanups of SimGrid (XBT,SIMIX,MSG) to be registered with atexit. \"no\" may be useful if your code segfaults when calling the exit function.",
 845                      xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_clean_atexit);
 846     xbt_cfg_setdefault_boolean(_sg_cfg_set, "clean_atexit", "yes");
 847
 848     if (!surf_path) {
 849       /* retrieves the current directory of the current process */
 850       const char *initial_path = __surf_get_initial_path();
 851       xbt_assert((initial_path), "__surf_get_initial_path() failed! Can't resolve current Windows directory");
 852
 853       surf_path = xbt_dynar_new(sizeof(char *), &xbt_free_ref);
 854       xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
 855     }
 856
 857     xbt_cfg_check(_sg_cfg_set);
 858     _sg_cfg_init_status = 1;
 859
 860     sg_config_cmd_line(argc, argv);
 861
 862     xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
 863   } else {
 864     XBT_WARN("Call to sg_config_init() after initialization ignored");
 865   }
 866 }
 867
 868 void sg_config_finalize(void)
 869 {
 870   if (!_sg_cfg_init_status)
 871     return;                     /* Not initialized yet. Nothing to do */
 872
 873   xbt_cfg_free(&_sg_cfg_set);
 874   _sg_cfg_init_status = 0;
 875 }
 876
 877 int sg_cfg_is_default_value(const char *name)
 878 {
 879   return xbt_cfg_is_default_value(_sg_cfg_set, name);
 880 }
 881
 882 int sg_cfg_get_int(const char* name)
 883 {
 884   return xbt_cfg_get_int(_sg_cfg_set, name);
 885 }
 886
 887 double sg_cfg_get_double(const char* name)
 888 {
 889   return xbt_cfg_get_double(_sg_cfg_set, name);
 890 }
 891
 892 char* sg_cfg_get_string(const char* name)
 893 {
 894   return xbt_cfg_get_string(_sg_cfg_set, name);
 895 }
 896
 897 int sg_cfg_get_boolean(const char* name)
 898 {
 899   return xbt_cfg_get_boolean(_sg_cfg_set, name);
 900 }
 901
 902 xbt_dynar_t sg_cfg_get_dynar(const char* name)
 903 {
 904   return xbt_cfg_get_dynar(_sg_cfg_set, name);
 905 }