1 /* Copyright (c) 2009, 2010. The SimGrid Team.
2 * All rights reserved. */
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. */
7 /* sg_config: configuration infrastructure for the simulation world */
10 #include "xbt/config.h"
12 #include "xbt/mallocator.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"
23 #include "instr/instr.h"
25 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_config, surf,
26 "About the configuration of simgrid");
28 xbt_cfg_t _sg_cfg_set = NULL;
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!) */
35 /* Parse the command line, looking for options */
36 static void sg_config_cmd_line(int *argc, char **argv)
42 for (j = i = 1; i < *argc; i++) {
43 if (!strncmp(argv[i], "--cfg=", strlen("--cfg="))) {
44 opt = strchr(argv[i], '=');
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")) {
51 ("Description of the configuration accepted by this simulator:\n");
52 xbt_cfg_help(_sg_cfg_set);
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"
61 "You can also use --help-tracing to see the details of all tracing options known by this simulator.\n"
64 "You can also use --help-logs and --help-log-categories to see the details of logging output.\n"
68 } else if (!strcmp(argv[i], "--help-models")) {
71 model_help("workstation", surf_workstation_model_description);
73 model_help("CPU", surf_cpu_model_description);
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++)
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");
84 } else if (!strcmp(argv[i], "--help-tracing")) {
97 _sg_init_status=1; // get everything cleanly cleaned on exit
102 /* callback of the workstation/model variable */
103 static void _sg_cfg_cb__workstation_model(const char *name, int pos)
107 xbt_assert(_sg_init_status == 1,
108 "Cannot change the model after the initialization");
110 val = xbt_cfg_get_string(_sg_cfg_set, name);
112 if (!strcmp(val, "help")) {
113 model_help("workstation", surf_workstation_model_description);
117 /* Make sure that the model exists */
118 find_model_description(surf_workstation_model_description, val);
121 /* callback of the cpu/model variable */
122 static void _sg_cfg_cb__cpu_model(const char *name, int pos)
126 xbt_assert(_sg_init_status == 1,
127 "Cannot change the model after the initialization");
129 val = xbt_cfg_get_string(_sg_cfg_set, name);
131 if (!strcmp(val, "help")) {
132 model_help("CPU", surf_cpu_model_description);
136 /* New Module missing */
137 find_model_description(surf_cpu_model_description, val);
140 /* callback of the cpu/model variable */
141 static void _sg_cfg_cb__optimization_mode(const char *name, int pos)
145 xbt_assert(_sg_init_status == 1,
146 "Cannot change the model after the initialization");
148 val = xbt_cfg_get_string(_sg_cfg_set, name);
150 if (!strcmp(val, "help")) {
151 model_help("optimization", surf_optimization_mode_description);
155 /* New Module missing */
156 find_model_description(surf_optimization_mode_description, val);
159 /* callback of the cpu/model variable */
160 static void _sg_cfg_cb__storage_mode(const char *name, int pos)
164 xbt_assert(_sg_init_status == 1,
165 "Cannot change the model after the initialization");
167 val = xbt_cfg_get_string(_sg_cfg_set, name);
169 if (!strcmp(val, "help")) {
170 model_help("storage", surf_storage_model_description);
174 /* New Module missing */
175 find_model_description(surf_storage_model_description, val);
178 /* callback of the workstation_model variable */
179 static void _sg_cfg_cb__network_model(const char *name, int pos)
183 xbt_assert(_sg_init_status == 1,
184 "Cannot change the model after the initialization");
186 val = xbt_cfg_get_string(_sg_cfg_set, name);
188 if (!strcmp(val, "help")) {
189 model_help("network", surf_network_model_description);
193 /* New Module missing */
194 find_model_description(surf_network_model_description, val);
198 /* callbacks of the network models values */
199 static void _sg_cfg_cb__tcp_gamma(const char *name, int pos)
201 sg_tcp_gamma = xbt_cfg_get_double(_sg_cfg_set, name);
204 static void _sg_cfg_cb__maxmin_precision(const char* name, int pos)
206 sg_maxmin_precision = xbt_cfg_get_double(_sg_cfg_set, name);
209 static void _sg_cfg_cb__sender_gap(const char* name, int pos)
211 sg_sender_gap = xbt_cfg_get_double(_sg_cfg_set, name);
214 static void _sg_cfg_cb__latency_factor(const char *name, int pos)
216 sg_latency_factor = xbt_cfg_get_double(_sg_cfg_set, name);
219 static void _sg_cfg_cb__bandwidth_factor(const char *name, int pos)
221 sg_bandwidth_factor = xbt_cfg_get_double(_sg_cfg_set, name);
224 static void _sg_cfg_cb__weight_S(const char *name, int pos)
226 sg_weight_S_parameter = xbt_cfg_get_double(_sg_cfg_set, name);
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)
237 xbt_assert(_sg_init_status == 1,
238 "Cannot change the model after the initialization");
240 val = xbt_cfg_get_string(_sg_cfg_set, name);
242 if (!strcmp(val, "help")) {
243 coll_help(category, table);
247 /* New Module missing */
248 find_coll_description(table, val);
250 static void _sg_cfg_cb__coll_gather(const char *name, int pos){
251 _sg_cfg_cb__coll("gather", mpi_coll_gather_description, name, pos);
253 static void _sg_cfg_cb__coll_allgather(const char *name, int pos){
254 _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
256 static void _sg_cfg_cb__coll_allgatherv(const char *name, int pos){
257 _sg_cfg_cb__coll("allgatherv", mpi_coll_allgatherv_description, name, pos);
259 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
261 _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
263 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
265 _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
267 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
269 _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
271 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
273 _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
275 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
277 _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
279 static void _sg_cfg_cb__coll_reduce_scatter(const char *name, int pos){
280 _sg_cfg_cb__coll("reduce_scatter", mpi_coll_reduce_scatter_description, name, pos);
282 static void _sg_cfg_cb__coll_scatter(const char *name, int pos){
283 _sg_cfg_cb__coll("scatter", mpi_coll_scatter_description, name, pos);
285 static void _sg_cfg_cb__coll_barrier(const char *name, int pos){
286 _sg_cfg_cb__coll("barrier", mpi_coll_barrier_description, name, pos);
290 /* callback of the inclusion path */
291 static void _sg_cfg_cb__surf_path(const char *name, int pos)
293 char *path = xbt_cfg_get_string_at(_sg_cfg_set, name, pos);
294 xbt_dynar_push(surf_path, &path);
297 /* callback to decide if we want to use the model-checking */
298 #include "xbt_modinter.h"
300 extern int _sg_do_model_check; /* this variable lives in xbt_main until I find a right location for it */
303 static void _sg_cfg_cb_model_check(const char *name, int pos)
306 _sg_do_model_check = xbt_cfg_get_boolean(_sg_cfg_set, name);
308 if (xbt_cfg_get_boolean(_sg_cfg_set, name)) {
309 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");
314 extern int _sg_do_verbose_exit;
316 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
318 _sg_do_verbose_exit = xbt_cfg_get_boolean(_sg_cfg_set, name);
322 static void _sg_cfg_cb_context_factory(const char *name, int pos) {
323 smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
326 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
328 smx_context_stack_size_was_set = 1;
329 smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
332 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
334 SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
337 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
339 SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
342 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
344 const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
345 if (!strcmp(mode_name, "posix")) {
346 SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
348 else if (!strcmp(mode_name, "futex")) {
349 SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
351 else if (!strcmp(mode_name, "busy_wait")) {
352 SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
355 xbt_die("Command line setting of the parallel synchronization mode should "
356 "be one of \"posix\", \"futex\" or \"busy_wait\"");
360 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
363 int val = xbt_cfg_get_boolean(_sg_cfg_set, name);
365 if (!COORD_HOST_LEVEL) {
366 COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp);
367 COORD_ASR_LEVEL = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
370 if (COORD_HOST_LEVEL)
371 xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
374 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
377 sg_network_crosstraffic = xbt_cfg_get_boolean(_sg_cfg_set, name);
381 static void _sg_cfg_cb__gtnets_jitter(const char *name, int pos)
383 sg_gtnets_jitter = xbt_cfg_get_double(_sg_cfg_set, name);
386 static void _sg_cfg_cb__gtnets_jitter_seed(const char *name, int pos)
388 sg_gtnets_jitter_seed = xbt_cfg_get_int(_sg_cfg_set, name);
392 /* create the config set, register what should be and parse the command line*/
393 void sg_config_init(int *argc, char **argv)
395 char *description = xbt_malloc(1024), *p = description;
397 double double_default_value;
398 int default_value_int;
401 /* Create the configuration support */
402 if (_sg_init_status == 0) { /* Only create stuff if not already inited */
404 "The model to use for the CPU. Possible values: ");
406 while (*(++p) != '\0');
407 for (i = 0; surf_cpu_model_description[i].name; i++)
408 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
409 surf_cpu_model_description[i].name);
411 ".\n (use 'help' as a value to see the long description of each model)");
412 default_value = xbt_strdup("Cas01");
413 xbt_cfg_register(&_sg_cfg_set, "cpu/model", description, xbt_cfgelm_string,
414 &default_value, 1, 1, &_sg_cfg_cb__cpu_model, NULL);
417 "The optimization modes to use for the CPU. Possible values: ");
419 while (*(++p) != '\0');
420 for (i = 0; surf_optimization_mode_description[i].name; i++)
421 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
422 surf_optimization_mode_description[i].name);
424 ".\n (use 'help' as a value to see the long description of each optimization mode)");
425 default_value = xbt_strdup("Lazy");
426 xbt_cfg_register(&_sg_cfg_set, "cpu/optim", description, xbt_cfgelm_string,
427 &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
430 "The model to use for the storage. Possible values: ");
432 while (*(++p) != '\0');
433 for (i = 0; surf_storage_model_description[i].name; i++)
434 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
435 surf_storage_model_description[i].name);
437 ".\n (use 'help' as a value to see the long description of each model)");
438 default_value = xbt_strdup("default");
439 xbt_cfg_register(&_sg_cfg_set, "storage/model", description, xbt_cfgelm_string,
440 &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
443 /* ********************************************************************* */
444 /* TUTORIAL: New model */
446 "The model to use for the New model. Possible values: ");
448 while (*(++p) != '\0');
449 for (i = 0; surf_new_model_description[i].name; i++)
450 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
451 surf_new_model_description[i].name);
453 ".\n (use 'help' as a value to see the long description of each model)");
454 default_value = xbt_strdup("default");
455 xbt_cfg_register(&_sg_cfg_set, "new_model/model", description, xbt_cfgelm_string,
456 &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
458 /* ********************************************************************* */
461 "The model to use for the network. Possible values: ");
463 while (*(++p) != '\0');
464 for (i = 0; surf_network_model_description[i].name; i++)
465 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
466 surf_network_model_description[i].name);
468 ".\n (use 'help' as a value to see the long description of each model)");
469 default_value = xbt_strdup("LV08");
470 xbt_cfg_register(&_sg_cfg_set, "network/model", description, xbt_cfgelm_string,
471 &default_value, 1, 1, &_sg_cfg_cb__network_model,
475 "The optimization modes to use for the network. Possible values: ");
477 while (*(++p) != '\0');
478 for (i = 0; surf_optimization_mode_description[i].name; i++)
479 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
480 surf_optimization_mode_description[i].name);
482 ".\n (use 'help' as a value to see the long description of each optimization mode)");
483 default_value = xbt_strdup("Lazy");
484 xbt_cfg_register(&_sg_cfg_set, "network/optim", description, xbt_cfgelm_string,
485 &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
488 "The model to use for the workstation. Possible values: ");
490 while (*(++p) != '\0');
491 for (i = 0; surf_workstation_model_description[i].name; i++)
492 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
493 surf_workstation_model_description[i].name);
495 ".\n (use 'help' as a value to see the long description of each model)");
496 default_value = xbt_strdup("default");
497 xbt_cfg_register(&_sg_cfg_set, "workstation/model", description, xbt_cfgelm_string,
498 &default_value, 1, 1,
499 &_sg_cfg_cb__workstation_model, NULL);
501 xbt_free(description);
503 xbt_cfg_register(&_sg_cfg_set, "network/TCP_gamma",
504 "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)",
505 xbt_cfgelm_double, NULL, 1, 1,
506 _sg_cfg_cb__tcp_gamma, NULL);
507 xbt_cfg_setdefault_double(_sg_cfg_set, "network/TCP_gamma", 4194304.0);
509 xbt_cfg_register(&_sg_cfg_set, "maxmin/precision",
510 "Numerical precision used when updating simulation models (epsilon in double comparisons)",
511 xbt_cfgelm_double, NULL, 1, 1, _sg_cfg_cb__maxmin_precision, NULL);
512 xbt_cfg_setdefault_double(_sg_cfg_set, "maxmin/precision", 0.00001);
514 /* The parameters of network models */
516 xbt_cfg_register(&_sg_cfg_set, "network/sender_gap",
517 "Minimum gap between two overlapping sends",
518 xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
519 _sg_cfg_cb__sender_gap, NULL);
521 double_default_value = 1.0; // FIXME use setdefault everywhere here!
522 xbt_cfg_register(&_sg_cfg_set, "network/latency_factor",
523 "Correction factor to apply to the provided latency (default value set by network model)",
524 xbt_cfgelm_double, &double_default_value, 1, 1,
525 _sg_cfg_cb__latency_factor, NULL);
526 double_default_value = 1.0;
527 xbt_cfg_register(&_sg_cfg_set, "network/bandwidth_factor",
528 "Correction factor to apply to the provided bandwidth (default value set by network model)",
529 xbt_cfgelm_double, &double_default_value, 1, 1,
530 _sg_cfg_cb__bandwidth_factor, NULL);
532 xbt_cfg_register(&_sg_cfg_set, "network/weight_S",
533 "Correction factor to apply to the weight of competing streams (default value set by network model)",
534 xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
535 _sg_cfg_cb__weight_S, NULL);
538 xbt_cfg_register(&_sg_cfg_set, "path",
539 "Lookup path for inclusions in platform and deployment XML files",
540 xbt_cfgelm_string, NULL, 0, 0,
541 _sg_cfg_cb__surf_path, NULL);
543 default_value = xbt_strdup("off");
544 xbt_cfg_register(&_sg_cfg_set, "cpu/maxmin_selective_update",
545 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
546 xbt_cfgelm_boolean, &default_value, 0, 1,
548 default_value = xbt_strdup("off");
549 xbt_cfg_register(&_sg_cfg_set, "network/maxmin_selective_update",
550 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
551 xbt_cfgelm_boolean, &default_value, 0, 1,
555 /* do model-checking */
556 default_value = xbt_strdup("off");
557 xbt_cfg_register(&_sg_cfg_set, "model-check",
558 "Verify the system through model-checking instead of simulating it (EXPERIMENTAL)",
559 xbt_cfgelm_boolean, NULL, 0, 1,
560 _sg_cfg_cb_model_check, NULL);
561 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check", default_value);
563 /* do stateful model-checking */
564 default_value = xbt_strdup("off");
565 xbt_cfg_register(&_sg_cfg_set, "model-check/checkpoint",
566 "Specify the amount of steps between checkpoints during stateful model-checking (default: off => stateless verification). "
567 "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.",
568 xbt_cfgelm_boolean, NULL, 0, 1,
569 _mc_cfg_cb_checkpoint, NULL);
570 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/checkpoint", default_value);
572 /* do liveness model-checking */
573 xbt_cfg_register(&_sg_cfg_set, "model-check/property",
574 "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
575 xbt_cfgelm_string, NULL, 0, 1,
576 _mc_cfg_cb_property, NULL);
577 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
579 /* Specify the kind of model-checking reduction */
580 xbt_cfg_register(&_sg_cfg_set, "model-check/reduction",
581 "Specify the kind of exploration reduction (either none or DPOR)",
582 xbt_cfgelm_string, NULL, 0, 1,
583 _mc_cfg_cb_reduce, NULL);
584 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/reduction", "dpor");
586 /* Enable/disable timeout for wait requests with model-checking */
587 default_value = xbt_strdup("off");
588 xbt_cfg_register(&_sg_cfg_set, "model-check/timeout",
589 "Enable/Disable timeout for wait requests",
590 xbt_cfgelm_boolean, NULL, 0, 1,
591 _mc_cfg_cb_timeout, NULL);
592 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/timeout", default_value);
594 /* Set max depth exploration */
595 xbt_cfg_register(&_sg_cfg_set, "model-check/max_depth",
596 "Specify the max depth of exploration (default : 1000)",
597 xbt_cfgelm_int, NULL, 0, 1,
598 _mc_cfg_cb_max_depth, NULL);
599 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/max_depth", 1000);
601 /* Set number of visited state stored for state comparison reduction*/
602 xbt_cfg_register(&_sg_cfg_set, "model-check/visited",
603 "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
604 xbt_cfgelm_int, NULL, 0, 1,
605 _mc_cfg_cb_visited, NULL);
606 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/visited", 0);
608 /* Set file name for dot output of graph state */
609 xbt_cfg_register(&_sg_cfg_set, "model-check/dot_output",
610 "Specify the name of dot file corresponding to graph state",
611 xbt_cfgelm_string, NULL, 0, 1,
612 _mc_cfg_cb_dot_output, NULL);
613 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/dot_output", "");
616 /* do verbose-exit */
617 default_value = xbt_strdup("on");
618 xbt_cfg_register(&_sg_cfg_set, "verbose-exit",
619 "Activate the \"do nothing\" mode in Ctrl-C",
620 xbt_cfgelm_boolean, &default_value, 0, 1,
621 _sg_cfg_cb_verbose_exit, NULL);
624 /* context factory */
625 default_value = xbt_strdup("ucontext");
626 xbt_cfg_register(&_sg_cfg_set, "contexts/factory",
627 "Context factory to use in SIMIX (ucontext, thread or raw)",
628 xbt_cfgelm_string, &default_value, 1, 1, _sg_cfg_cb_context_factory, NULL);
630 /* stack size of contexts in Ko */
631 default_value_int = 128;
632 xbt_cfg_register(&_sg_cfg_set, "contexts/stack_size",
633 "Stack size of contexts in Kib (ucontext or raw only)",
634 xbt_cfgelm_int, &default_value_int, 1, 1,
635 _sg_cfg_cb_context_stack_size, NULL);
637 /* number of parallel threads for user processes */
638 default_value_int = 1;
639 xbt_cfg_register(&_sg_cfg_set, "contexts/nthreads",
640 "Number of parallel threads used to execute user contexts",
641 xbt_cfgelm_int, &default_value_int, 1, 1,
642 _sg_cfg_cb_contexts_nthreads, NULL);
644 /* minimal number of user contexts to be run in parallel */
645 default_value_int = 2;
646 xbt_cfg_register(&_sg_cfg_set, "contexts/parallel_threshold",
647 "Minimal number of user contexts to be run in parallel (raw contexts only)",
648 xbt_cfgelm_int, &default_value_int, 1, 1,
649 _sg_cfg_cb_contexts_parallel_threshold, NULL);
651 /* synchronization mode for parallel user contexts */
653 default_value = xbt_strdup("futex");
654 #else //No futex on mac and posix is unimplememted yet
655 default_value = xbt_strdup("busy_wait");
657 xbt_cfg_register(&_sg_cfg_set, "contexts/synchro",
658 "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
659 xbt_cfgelm_string, &default_value, 1, 1,
660 _sg_cfg_cb_contexts_parallel_mode, NULL);
662 default_value = xbt_strdup("no");
663 xbt_cfg_register(&_sg_cfg_set, "network/coordinates",
664 "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
665 xbt_cfgelm_boolean, &default_value, 1, 1,
666 _sg_cfg_cb__surf_network_coordinates, NULL);
667 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/coordinates", default_value);
669 default_value = xbt_strdup("no");
670 xbt_cfg_register(&_sg_cfg_set, "network/crosstraffic",
671 "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
672 xbt_cfgelm_boolean, &default_value, 0, 1,
673 _sg_cfg_cb__surf_network_crosstraffic, NULL);
674 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/crosstraffic", default_value);
677 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter",
678 "Double value to oscillate the link latency, uniformly in random interval [-latency*gtnets_jitter,latency*gtnets_jitter)",
679 xbt_cfgelm_double, NULL, 1, 1,
680 _sg_cfg_cb__gtnets_jitter, NULL);
681 xbt_cfg_setdefault_double(_sg_cfg_set, "gtnets/jitter", 0.0);
683 default_value_int = 10;
684 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter_seed",
685 "Use a positive seed to reproduce jitted results, value must be in [1,1e8], default is 10",
686 xbt_cfgelm_int, &default_value_int, 0, 1,
687 _sg_cfg_cb__gtnets_jitter_seed, NULL);
690 xbt_cfg_register(&_sg_cfg_set, "ns3/TcpModel",
691 "The ns3 tcp model can be : NewReno or Reno or Tahoe",
692 xbt_cfgelm_string, NULL, 1, 1,
694 xbt_cfg_setdefault_string(_sg_cfg_set, "ns3/TcpModel", "default");
698 double default_reference_speed = 20000.0;
699 xbt_cfg_register(&_sg_cfg_set, "smpi/running_power",
700 "Power of the host running the simulation (in flop/s). Used to bench the operations.",
701 xbt_cfgelm_double, &default_reference_speed, 1, 1, NULL,
704 default_value = xbt_strdup("no");
705 xbt_cfg_register(&_sg_cfg_set, "smpi/display_timing",
706 "Boolean indicating whether we should display the timing after simulation.",
707 xbt_cfgelm_boolean, &default_value, 1, 1, NULL,
709 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/display_timing", default_value);
711 default_value = xbt_strdup("yes");
712 xbt_cfg_register(&_sg_cfg_set, "smpi/use_shared_malloc",
713 "Boolean indicating whether we should use shared memory when using SMPI_SHARED_MALLOC. Allows user to disable it for debug purposes.",
714 xbt_cfgelm_boolean, &default_value, 1, 1, NULL,
716 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/use_shared_malloc", default_value);
718 double default_threshold = 1e-6;
719 xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
720 "Minimal computation time (in seconds) not discarded.",
721 xbt_cfgelm_double, &default_threshold, 1, 1, NULL,
724 int default_small_messages_threshold = 0;
725 xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thres",
726 "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
727 xbt_cfgelm_int, &default_small_messages_threshold, 1, 1, NULL,
730 int default_send_is_detached_threshold = 65536;
731 xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thres",
732 "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
733 xbt_cfgelm_int, &default_send_is_detached_threshold, 1, 1, NULL,
736 //For smpi/bw_factor and smpi/lat_factor
737 //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
738 //test is if( size >= thresholdN ) return valueN;
739 //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
740 // or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
741 xbt_cfg_register(&_sg_cfg_set, "smpi/bw_factor",
742 "Bandwidth factors for smpi.",
743 xbt_cfgelm_string, NULL, 1, 1, NULL,
745 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");
747 xbt_cfg_register(&_sg_cfg_set, "smpi/lat_factor",
748 "Latency factors for smpi.",
749 xbt_cfgelm_string, NULL, 1, 1, NULL,
751 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");
753 xbt_cfg_register(&_sg_cfg_set, "smpi/os",
754 "Small messages timings (MPI_Send minimum time for small messages)",
755 xbt_cfgelm_string, NULL, 1, 1, NULL,
757 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
759 xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
760 "Small messages timings (MPI_Isend minimum time for small messages)",
761 xbt_cfgelm_string, NULL, 1, 1, NULL,
763 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
765 xbt_cfg_register(&_sg_cfg_set, "smpi/or",
766 "Small messages timings (MPI_Recv minimum time for small messages)",
767 xbt_cfgelm_string, NULL, 1, 1, NULL,
769 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
770 double default_iprobe_time = 1e-4;
771 xbt_cfg_register(&_sg_cfg_set, "smpi/iprobe",
772 "Minimum time to inject inside a call to MPI_Iprobe",
773 xbt_cfgelm_double, &default_iprobe_time, 1, 1, NULL,
775 default_value = xbt_strdup("default");
776 xbt_cfg_register(&_sg_cfg_set, "smpi/coll_selector",
777 "Which collective selector to use",
778 xbt_cfgelm_string, &default_value, 1, 1, NULL,
781 xbt_cfg_register(&_sg_cfg_set, "smpi/gather",
782 "Which collective to use for gather",
783 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_gather,
786 xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
787 "Which collective to use for allgather",
788 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allgather,
791 xbt_cfg_register(&_sg_cfg_set, "smpi/barrier",
792 "Which collective to use for barrier",
793 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_barrier,
796 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce_scatter",
797 "Which collective to use for reduce_scatter",
798 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_reduce_scatter,
801 xbt_cfg_register(&_sg_cfg_set, "smpi/scatter",
802 "Which collective to use for scatter",
803 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_scatter,
806 xbt_cfg_register(&_sg_cfg_set, "smpi/allgatherv",
807 "Which collective to use for allgatherv",
808 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allgatherv,
811 xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
812 "Which collective to use for allreduce",
813 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_allreduce,
816 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
817 "Which collective to use for alltoall",
818 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_alltoall,
821 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
822 "Which collective to use for alltoallv",
823 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_alltoallv,
826 xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
827 "Which collective to use for bcast",
828 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_bcast,
831 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
832 "Which collective to use for reduce",
833 xbt_cfgelm_string, NULL, 1, 1, &_sg_cfg_cb__coll_reduce,
837 default_value = xbt_strdup("yes");
838 xbt_cfg_register(&_sg_cfg_set, "clean_atexit",
839 "\"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.",
840 xbt_cfgelm_boolean, &default_value, 1, 1,
842 xbt_cfg_setdefault_boolean(_sg_cfg_set, "clean_atexit", default_value);
845 /* retrieves the current directory of the current process */
846 const char *initial_path = __surf_get_initial_path();
847 xbt_assert((initial_path),
848 "__surf_get_initial_path() failed! Can't resolves current Windows directory");
850 surf_path = xbt_dynar_new(sizeof(char *), NULL);
851 xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
856 sg_config_cmd_line(argc, argv);
858 xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
861 XBT_WARN("Call to sg_config_init() after initialization ignored");
865 void sg_config_finalize(void)
867 if (!_sg_init_status)
868 return; /* Not initialized yet. Nothing to do */
870 xbt_cfg_free(&_sg_cfg_set);
874 /* Pick the right models for CPU, net and workstation, and call their model_init_preparse */
875 void surf_config_models_setup()
877 char *workstation_model_name;
878 int workstation_id = -1;
879 char *network_model_name = NULL;
880 char *cpu_model_name = NULL;
882 char *storage_model_name = NULL;
884 workstation_model_name =
885 xbt_cfg_get_string(_sg_cfg_set, "workstation/model");
886 network_model_name = xbt_cfg_get_string(_sg_cfg_set, "network/model");
887 cpu_model_name = xbt_cfg_get_string(_sg_cfg_set, "cpu/model");
888 storage_model_name = xbt_cfg_get_string(_sg_cfg_set, "storage/model");
890 /* Check whether we use a net/cpu model differing from the default ones, in which case
891 * we should switch to the "compound" workstation model to correctly dispatch stuff to
892 * the right net/cpu models.
895 if((!xbt_cfg_is_default_value(_sg_cfg_set, "network/model") ||
896 !xbt_cfg_is_default_value(_sg_cfg_set, "cpu/model")) &&
897 xbt_cfg_is_default_value(_sg_cfg_set, "workstation/model"))
899 const char *val = "compound";
901 ("Switching workstation model to compound since you changed the network and/or cpu model(s)");
902 xbt_cfg_set_string(_sg_cfg_set, "workstation/model", val);
903 workstation_model_name = (char *) "compound";
906 XBT_DEBUG("Workstation model: %s", workstation_model_name);
908 find_model_description(surf_workstation_model_description,
909 workstation_model_name);
910 if (!strcmp(workstation_model_name, "compound")) {
914 xbt_assert(cpu_model_name,
915 "Set a cpu model to use with the 'compound' workstation model");
917 xbt_assert(network_model_name,
918 "Set a network model to use with the 'compound' workstation model");
921 find_model_description(surf_network_model_description,
924 find_model_description(surf_cpu_model_description, cpu_model_name);
926 surf_cpu_model_description[cpu_id].model_init_preparse();
927 surf_network_model_description[network_id].model_init_preparse();
930 XBT_DEBUG("Call workstation_model_init");
931 surf_workstation_model_description[workstation_id].model_init_preparse();
933 XBT_DEBUG("Call storage_model_init");
934 storage_id = find_model_description(surf_storage_model_description, storage_model_name);
935 surf_storage_model_description[storage_id].model_init_preparse();
937 /* ********************************************************************* */
938 /* TUTORIAL: New model */
939 int new_model_id = -1;
940 char *new_model_name = NULL;
941 new_model_name = xbt_cfg_get_string(_sg_cfg_set, "new_model/model");
942 XBT_DEBUG("Call new model_init");
943 new_model_id = find_model_description(surf_new_model_description, new_model_name);
944 surf_new_model_description[new_model_id].model_init_preparse();
945 /* ********************************************************************* */
948 int sg_cfg_get_int(const char* name)
950 return xbt_cfg_get_int(_sg_cfg_set,name);
952 double sg_cfg_get_double(const char* name)
954 return xbt_cfg_get_double(_sg_cfg_set,name);
956 char* sg_cfg_get_string(const char* name)
958 return xbt_cfg_get_string(_sg_cfg_set,name);
960 int sg_cfg_get_boolean(const char* name)
962 return xbt_cfg_get_boolean(_sg_cfg_set,name);
964 void sg_cfg_get_peer(const char *name, char **peer, int *port)
966 xbt_cfg_get_peer(_sg_cfg_set,name, peer, port);
968 xbt_dynar_t sg_cfg_get_dynar(const char* name)
970 return xbt_cfg_get_dynar(_sg_cfg_set,name);