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_allgather(const char *name, int pos){
251 _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
253 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
255 _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
257 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
259 _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
261 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
263 _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
265 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
267 _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
269 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
271 _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
275 /* callback of the inclusion path */
276 static void _sg_cfg_cb__surf_path(const char *name, int pos)
278 char *path = xbt_cfg_get_string_at(_sg_cfg_set, name, pos);
279 xbt_dynar_push(surf_path, &path);
282 /* callback to decide if we want to use the model-checking */
283 #include "xbt_modinter.h"
285 extern int _sg_do_model_check; /* this variable lives in xbt_main until I find a right location for it */
288 static void _sg_cfg_cb_model_check(const char *name, int pos)
291 _sg_do_model_check = xbt_cfg_get_int(_sg_cfg_set, name);
293 if (xbt_cfg_get_int(_sg_cfg_set, name)) {
294 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");
299 extern int _sg_do_verbose_exit;
301 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
303 _sg_do_verbose_exit = xbt_cfg_get_int(_sg_cfg_set, name);
307 static void _sg_cfg_cb_context_factory(const char *name, int pos) {
308 smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
311 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
313 smx_context_stack_size_was_set = 1;
314 smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
317 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
319 SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
322 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
324 SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
327 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
329 const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
330 if (!strcmp(mode_name, "posix")) {
331 SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
333 else if (!strcmp(mode_name, "futex")) {
334 SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
336 else if (!strcmp(mode_name, "busy_wait")) {
337 SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
340 xbt_die("Command line setting of the parallel synchronization mode should "
341 "be one of \"posix\", \"futex\" or \"busy_wait\"");
345 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
348 char *val = xbt_cfg_get_string(_sg_cfg_set, name);
349 if (!strcmp(val, "yes")) {
350 if (!COORD_HOST_LEVEL) {
351 COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp);
352 COORD_ASR_LEVEL = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
354 } else if (!strcmp(val, "no")) {
355 if (COORD_HOST_LEVEL)
356 xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
358 xbt_die("Command line setting of whether to use coordinates must be either \"yes\" or \"no\"");
362 static void _sg_cfg_cb_surf_nthreads(const char *name, int pos)
364 surf_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
367 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
370 sg_network_crosstraffic = xbt_cfg_get_int(_sg_cfg_set, name);
374 static void _sg_cfg_cb__gtnets_jitter(const char *name, int pos)
376 sg_gtnets_jitter = xbt_cfg_get_double(_sg_cfg_set, name);
379 static void _sg_cfg_cb__gtnets_jitter_seed(const char *name, int pos)
381 sg_gtnets_jitter_seed = xbt_cfg_get_int(_sg_cfg_set, name);
385 /* create the config set, register what should be and parse the command line*/
386 void sg_config_init(int *argc, char **argv)
388 char *description = xbt_malloc(1024), *p = description;
390 double double_default_value;
391 int default_value_int;
394 /* Create the configuration support */
395 if (_sg_init_status == 0) { /* Only create stuff if not already inited */
397 "The model to use for the CPU. Possible values: ");
399 while (*(++p) != '\0');
400 for (i = 0; surf_cpu_model_description[i].name; i++)
401 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
402 surf_cpu_model_description[i].name);
404 ".\n (use 'help' as a value to see the long description of each model)");
405 default_value = xbt_strdup("Cas01");
406 xbt_cfg_register(&_sg_cfg_set, "cpu/model", description, xbt_cfgelm_string,
407 &default_value, 1, 1, &_sg_cfg_cb__cpu_model, NULL);
410 "The optimization modes to use for the CPU. Possible values: ");
412 while (*(++p) != '\0');
413 for (i = 0; surf_optimization_mode_description[i].name; i++)
414 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
415 surf_optimization_mode_description[i].name);
417 ".\n (use 'help' as a value to see the long description of each optimization mode)");
418 default_value = xbt_strdup("Lazy");
419 xbt_cfg_register(&_sg_cfg_set, "cpu/optim", description, xbt_cfgelm_string,
420 &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
423 "The model to use for the storage. Possible values: ");
425 while (*(++p) != '\0');
426 for (i = 0; surf_storage_model_description[i].name; i++)
427 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
428 surf_storage_model_description[i].name);
430 ".\n (use 'help' as a value to see the long description of each model)");
431 default_value = xbt_strdup("default");
432 xbt_cfg_register(&_sg_cfg_set, "storage/model", description, xbt_cfgelm_string,
433 &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
436 /* ********************************************************************* */
437 /* TUTORIAL: New model */
439 "The model to use for the New model. Possible values: ");
441 while (*(++p) != '\0');
442 for (i = 0; surf_new_model_description[i].name; i++)
443 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
444 surf_new_model_description[i].name);
446 ".\n (use 'help' as a value to see the long description of each model)");
447 default_value = xbt_strdup("default");
448 xbt_cfg_register(&_sg_cfg_set, "new_model/model", description, xbt_cfgelm_string,
449 &default_value, 1, 1, &_sg_cfg_cb__storage_mode,
451 /* ********************************************************************* */
454 "The model to use for the network. Possible values: ");
456 while (*(++p) != '\0');
457 for (i = 0; surf_network_model_description[i].name; i++)
458 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
459 surf_network_model_description[i].name);
461 ".\n (use 'help' as a value to see the long description of each model)");
462 default_value = xbt_strdup("LV08");
463 xbt_cfg_register(&_sg_cfg_set, "network/model", description, xbt_cfgelm_string,
464 &default_value, 1, 1, &_sg_cfg_cb__network_model,
468 "The optimization modes to use for the network. Possible values: ");
470 while (*(++p) != '\0');
471 for (i = 0; surf_optimization_mode_description[i].name; i++)
472 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
473 surf_optimization_mode_description[i].name);
475 ".\n (use 'help' as a value to see the long description of each optimization mode)");
476 default_value = xbt_strdup("Lazy");
477 xbt_cfg_register(&_sg_cfg_set, "network/optim", description, xbt_cfgelm_string,
478 &default_value, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
481 "The model to use for the workstation. Possible values: ");
483 while (*(++p) != '\0');
484 for (i = 0; surf_workstation_model_description[i].name; i++)
485 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
486 surf_workstation_model_description[i].name);
488 ".\n (use 'help' as a value to see the long description of each model)");
489 default_value = xbt_strdup("default");
490 xbt_cfg_register(&_sg_cfg_set, "workstation/model", description, xbt_cfgelm_string,
491 &default_value, 1, 1,
492 &_sg_cfg_cb__workstation_model, NULL);
494 xbt_free(description);
496 xbt_cfg_register(&_sg_cfg_set, "network/TCP_gamma",
497 "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)",
498 xbt_cfgelm_double, NULL, 1, 1,
499 _sg_cfg_cb__tcp_gamma, NULL);
500 xbt_cfg_setdefault_double(_sg_cfg_set, "network/TCP_gamma", 4194304.0);
502 xbt_cfg_register(&_sg_cfg_set, "maxmin/precision",
503 "Numerical precision used when updating simulation models (epsilon in double comparisons)",
504 xbt_cfgelm_double, NULL, 1, 1, _sg_cfg_cb__maxmin_precision, NULL);
505 xbt_cfg_setdefault_double(_sg_cfg_set, "maxmin/precision", 0.00001);
507 /* The parameters of network models */
509 xbt_cfg_register(&_sg_cfg_set, "network/sender_gap",
510 "Minimum gap between two overlapping sends",
511 xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
512 _sg_cfg_cb__sender_gap, NULL);
514 double_default_value = 1.0; // FIXME use setdefault everywhere here!
515 xbt_cfg_register(&_sg_cfg_set, "network/latency_factor",
516 "Correction factor to apply to the provided latency (default value set by network model)",
517 xbt_cfgelm_double, &double_default_value, 1, 1,
518 _sg_cfg_cb__latency_factor, NULL);
519 double_default_value = 1.0;
520 xbt_cfg_register(&_sg_cfg_set, "network/bandwidth_factor",
521 "Correction factor to apply to the provided bandwidth (default value set by network model)",
522 xbt_cfgelm_double, &double_default_value, 1, 1,
523 _sg_cfg_cb__bandwidth_factor, NULL);
525 xbt_cfg_register(&_sg_cfg_set, "network/weight_S",
526 "Correction factor to apply to the weight of competing streams (default value set by network model)",
527 xbt_cfgelm_double, NULL, 1, 1, /* default is set in network.c */
528 _sg_cfg_cb__weight_S, NULL);
531 xbt_cfg_register(&_sg_cfg_set, "path",
532 "Lookup path for inclusions in platform and deployment XML files",
533 xbt_cfgelm_string, NULL, 0, 0,
534 _sg_cfg_cb__surf_path, NULL);
536 default_value_int = 0;
537 xbt_cfg_register(&_sg_cfg_set, "cpu/maxmin_selective_update",
538 "Update the constraint set propagating recursively to others constraints (1 by default when optim is set to lazy)",
539 xbt_cfgelm_int, &default_value_int, 0, 1,
541 default_value_int = 0;
542 xbt_cfg_register(&_sg_cfg_set, "network/maxmin_selective_update",
543 "Update the constraint set propagating recursively to others constraints (1 by default when optim is set to lazy)",
544 xbt_cfgelm_int, &default_value_int, 0, 1,
548 /* do model-checking */
549 xbt_cfg_register(&_sg_cfg_set, "model-check",
550 "Verify the system through model-checking instead of simulating it (EXPERIMENTAL)",
551 xbt_cfgelm_int, NULL, 0, 1,
552 _sg_cfg_cb_model_check, NULL);
553 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check", 0);
555 /* do stateful model-checking */
556 xbt_cfg_register(&_sg_cfg_set, "model-check/checkpoint",
557 "Specify the amount of steps between checkpoints during stateful model-checking (default: 0 => stateless verification). "
558 "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.",
559 xbt_cfgelm_int, NULL, 0, 1,
560 _mc_cfg_cb_checkpoint, NULL);
561 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/checkpoint", 0);
563 /* do liveness model-checking */
564 xbt_cfg_register(&_sg_cfg_set, "model-check/property",
565 "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
566 xbt_cfgelm_string, NULL, 0, 1,
567 _mc_cfg_cb_property, NULL);
568 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
570 /* Specify the kind of model-checking reduction */
571 xbt_cfg_register(&_sg_cfg_set, "model-check/reduction",
572 "Specify the kind of exploration reduction (either none or DPOR)",
573 xbt_cfgelm_string, NULL, 0, 1,
574 _mc_cfg_cb_reduce, NULL);
575 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/reduction", "dpor");
577 /* Enable/disable timeout for wait requests with model-checking */
578 xbt_cfg_register(&_sg_cfg_set, "model-check/timeout",
579 "Enable/Disable timeout for wait requests",
580 xbt_cfgelm_int, NULL, 0, 1,
581 _mc_cfg_cb_timeout, NULL);
582 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/timeout", 0);
584 /* Set max depth exploration */
585 xbt_cfg_register(&_sg_cfg_set, "model-check/max_depth",
586 "Specify the max depth of exploration (default : 1000)",
587 xbt_cfgelm_int, NULL, 0, 1,
588 _mc_cfg_cb_max_depth, NULL);
589 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/max_depth", 1000);
591 /* Set number of visited state stored for state comparison reduction*/
592 xbt_cfg_register(&_sg_cfg_set, "model-check/visited",
593 "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
594 xbt_cfgelm_int, NULL, 0, 1,
595 _mc_cfg_cb_visited, NULL);
596 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/visited", 0);
598 /* Set file name for dot output of graph state */
599 xbt_cfg_register(&_sg_cfg_set, "model-check/dot_output",
600 "Specify the name of dot file corresponding to graph state",
601 xbt_cfgelm_string, NULL, 0, 1,
602 _mc_cfg_cb_dot_output, NULL);
603 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/dot_output", "");
606 /* do verbose-exit */
607 default_value_int = 1;
608 xbt_cfg_register(&_sg_cfg_set, "verbose-exit",
609 "Activate the \"do nothing\" mode in Ctrl-C",
610 xbt_cfgelm_int, &default_value_int, 0, 1,
611 _sg_cfg_cb_verbose_exit, NULL);
614 /* context factory */
615 default_value = xbt_strdup("ucontext");
616 xbt_cfg_register(&_sg_cfg_set, "contexts/factory",
617 "Context factory to use in SIMIX (ucontext, thread or raw)",
618 xbt_cfgelm_string, &default_value, 1, 1, _sg_cfg_cb_context_factory, NULL);
620 /* stack size of contexts in Ko */
621 default_value_int = 128;
622 xbt_cfg_register(&_sg_cfg_set, "contexts/stack_size",
623 "Stack size of contexts in Kib (ucontext or raw only)",
624 xbt_cfgelm_int, &default_value_int, 1, 1,
625 _sg_cfg_cb_context_stack_size, NULL);
627 /* number of parallel threads for user processes */
628 default_value_int = 1;
629 xbt_cfg_register(&_sg_cfg_set, "contexts/nthreads",
630 "Number of parallel threads used to execute user contexts",
631 xbt_cfgelm_int, &default_value_int, 1, 1,
632 _sg_cfg_cb_contexts_nthreads, NULL);
634 /* minimal number of user contexts to be run in parallel */
635 default_value_int = 2;
636 xbt_cfg_register(&_sg_cfg_set, "contexts/parallel_threshold",
637 "Minimal number of user contexts to be run in parallel (raw contexts only)",
638 xbt_cfgelm_int, &default_value_int, 1, 1,
639 _sg_cfg_cb_contexts_parallel_threshold, NULL);
641 /* synchronization mode for parallel user contexts */
643 default_value = xbt_strdup("futex");
644 #else //No futex on mac and posix is unimplememted yet
645 default_value = xbt_strdup("busy_wait");
647 xbt_cfg_register(&_sg_cfg_set, "contexts/synchro",
648 "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
649 xbt_cfgelm_string, &default_value, 1, 1,
650 _sg_cfg_cb_contexts_parallel_mode, NULL);
652 /* number of parallel threads for Surf */
653 default_value_int = surf_get_nthreads();
654 xbt_cfg_register(&_sg_cfg_set, "surf/nthreads",
655 "Number of parallel threads used to update Surf models",
656 xbt_cfgelm_int, &default_value_int, 1, 1,
657 _sg_cfg_cb_surf_nthreads, NULL);
659 default_value = xbt_strdup("no");
660 xbt_cfg_register(&_sg_cfg_set, "network/coordinates",
661 "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
662 xbt_cfgelm_string, &default_value, 1, 1,
663 _sg_cfg_cb__surf_network_coordinates, NULL);
664 xbt_cfg_setdefault_string(_sg_cfg_set, "network/coordinates", default_value);
666 default_value_int = 0;
667 xbt_cfg_register(&_sg_cfg_set, "network/crosstraffic",
668 "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
669 xbt_cfgelm_int, &default_value_int, 0, 1,
670 _sg_cfg_cb__surf_network_crosstraffic, NULL);
671 xbt_cfg_setdefault_int(_sg_cfg_set, "network/crosstraffic", default_value_int);
674 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter",
675 "Double value to oscillate the link latency, uniformly in random interval [-latency*gtnets_jitter,latency*gtnets_jitter)",
676 xbt_cfgelm_double, NULL, 1, 1,
677 _sg_cfg_cb__gtnets_jitter, NULL);
678 xbt_cfg_setdefault_double(_sg_cfg_set, "gtnets/jitter", 0.0);
680 default_value_int = 10;
681 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter_seed",
682 "Use a positive seed to reproduce jitted results, value must be in [1,1e8], default is 10",
683 xbt_cfgelm_int, &default_value_int, 0, 1,
684 _sg_cfg_cb__gtnets_jitter_seed, NULL);
687 xbt_cfg_register(&_sg_cfg_set, "ns3/TcpModel",
688 "The ns3 tcp model can be : NewReno or Reno or Tahoe",
689 xbt_cfgelm_string, NULL, 1, 1,
691 xbt_cfg_setdefault_string(_sg_cfg_set, "ns3/TcpModel", "default");
695 double default_reference_speed = 20000.0;
696 xbt_cfg_register(&_sg_cfg_set, "smpi/running_power",
697 "Power of the host running the simulation (in flop/s). Used to bench the operations.",
698 xbt_cfgelm_double, &default_reference_speed, 1, 1, NULL,
701 int default_display_timing = 0;
702 xbt_cfg_register(&_sg_cfg_set, "smpi/display_timing",
703 "Boolean indicating whether we should display the timing after simulation.",
704 xbt_cfgelm_int, &default_display_timing, 1, 1, NULL,
707 double default_threshold = 1e-6;
708 xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
709 "Minimal computation time (in seconds) not discarded.",
710 xbt_cfgelm_double, &default_threshold, 1, 1, NULL,
713 int default_small_messages_threshold = 0;
714 xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thres",
715 "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
716 xbt_cfgelm_int, &default_small_messages_threshold, 1, 1, NULL,
719 int default_send_is_detached_threshold = 65536;
720 xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thres",
721 "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
722 xbt_cfgelm_int, &default_send_is_detached_threshold, 1, 1, NULL,
725 //For smpi/bw_factor and smpi/lat_factor
726 //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
727 //test is if( size >= thresholdN ) return valueN;
728 //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
729 // or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
730 xbt_cfg_register(&_sg_cfg_set, "smpi/bw_factor",
731 "Bandwidth factors for smpi.",
732 xbt_cfgelm_string, NULL, 1, 1, NULL,
734 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");
736 xbt_cfg_register(&_sg_cfg_set, "smpi/lat_factor",
737 "Latency factors for smpi.",
738 xbt_cfgelm_string, NULL, 1, 1, NULL,
740 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");
742 xbt_cfg_register(&_sg_cfg_set, "smpi/os",
743 "Small messages timings (MPI_Send minimum time for small messages)",
744 xbt_cfgelm_string, NULL, 1, 1, NULL,
746 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
748 xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
749 "Small messages timings (MPI_Isend minimum time for small messages)",
750 xbt_cfgelm_string, NULL, 1, 1, NULL,
752 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
754 xbt_cfg_register(&_sg_cfg_set, "smpi/or",
755 "Small messages timings (MPI_Recv minimum time for small messages)",
756 xbt_cfgelm_string, NULL, 1, 1, NULL,
758 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
760 default_value = xbt_strdup("default");
761 xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
762 "Which collective to use for allgather",
763 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_allgather,
766 default_value = xbt_strdup("default");
767 xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
768 "Which collective to use for allreduce",
769 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_allreduce,
772 default_value = xbt_strdup("ompi");
773 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
774 "Which collective to use for alltoall",
775 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_alltoall,
778 default_value = xbt_strdup("default");
779 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
780 "Which collective to use for alltoallv",
781 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_alltoallv,
784 default_value = xbt_strdup("default");
785 xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
786 "Which collective to use for bcast",
787 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_bcast,
791 default_value = xbt_strdup("default");
792 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
793 "Which collective to use for reduce",
794 xbt_cfgelm_string, &default_value, 1, 1, &_sg_cfg_cb__coll_reduce,
799 /* retrieves the current directory of the current process */
800 const char *initial_path = __surf_get_initial_path();
801 xbt_assert((initial_path),
802 "__surf_get_initial_path() failed! Can't resolves current Windows directory");
804 surf_path = xbt_dynar_new(sizeof(char *), NULL);
805 xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
810 sg_config_cmd_line(argc, argv);
812 xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
815 XBT_WARN("Call to sg_config_init() after initialization ignored");
819 void sg_config_finalize(void)
821 if (!_sg_init_status)
822 return; /* Not initialized yet. Nothing to do */
824 xbt_cfg_free(&_sg_cfg_set);
828 /* Pick the right models for CPU, net and workstation, and call their model_init_preparse */
829 void surf_config_models_setup()
831 char *workstation_model_name;
832 int workstation_id = -1;
833 char *network_model_name = NULL;
834 char *cpu_model_name = NULL;
836 char *storage_model_name = NULL;
838 workstation_model_name =
839 xbt_cfg_get_string(_sg_cfg_set, "workstation/model");
840 network_model_name = xbt_cfg_get_string(_sg_cfg_set, "network/model");
841 cpu_model_name = xbt_cfg_get_string(_sg_cfg_set, "cpu/model");
842 storage_model_name = xbt_cfg_get_string(_sg_cfg_set, "storage/model");
844 /* Check whether we use a net/cpu model differing from the default ones, in which case
845 * we should switch to the "compound" workstation model to correctly dispatch stuff to
846 * the right net/cpu models.
849 if((!xbt_cfg_is_default_value(_sg_cfg_set, "network/model") ||
850 !xbt_cfg_is_default_value(_sg_cfg_set, "cpu/model")) &&
851 xbt_cfg_is_default_value(_sg_cfg_set, "workstation/model"))
853 const char *val = "compound";
855 ("Switching workstation model to compound since you changed the network and/or cpu model(s)");
856 xbt_cfg_set_string(_sg_cfg_set, "workstation/model", val);
857 workstation_model_name = (char *) "compound";
860 XBT_DEBUG("Workstation model: %s", workstation_model_name);
862 find_model_description(surf_workstation_model_description,
863 workstation_model_name);
864 if (!strcmp(workstation_model_name, "compound")) {
868 xbt_assert(cpu_model_name,
869 "Set a cpu model to use with the 'compound' workstation model");
871 xbt_assert(network_model_name,
872 "Set a network model to use with the 'compound' workstation model");
875 find_model_description(surf_network_model_description,
878 find_model_description(surf_cpu_model_description, cpu_model_name);
880 surf_cpu_model_description[cpu_id].model_init_preparse();
881 surf_network_model_description[network_id].model_init_preparse();
884 XBT_DEBUG("Call workstation_model_init");
885 surf_workstation_model_description[workstation_id].model_init_preparse();
887 XBT_DEBUG("Call storage_model_init");
888 storage_id = find_model_description(surf_storage_model_description, storage_model_name);
889 surf_storage_model_description[storage_id].model_init_preparse();
891 /* ********************************************************************* */
892 /* TUTORIAL: New model */
893 int new_model_id = -1;
894 char *new_model_name = NULL;
895 new_model_name = xbt_cfg_get_string(_sg_cfg_set, "new_model/model");
896 XBT_DEBUG("Call new model_init");
897 new_model_id = find_model_description(surf_new_model_description, new_model_name);
898 surf_new_model_description[new_model_id].model_init_preparse();
899 /* ********************************************************************* */
902 int sg_cfg_get_int(const char* name)
904 return xbt_cfg_get_int(_sg_cfg_set,name);
906 double sg_cfg_get_double(const char* name)
908 return xbt_cfg_get_double(_sg_cfg_set,name);
910 char* sg_cfg_get_string(const char* name)
912 return xbt_cfg_get_string(_sg_cfg_set,name);
914 void sg_cfg_get_peer(const char *name, char **peer, int *port)
916 xbt_cfg_get_peer(_sg_cfg_set,name, peer, port);
918 xbt_dynar_t sg_cfg_get_dynar(const char* name)
920 return xbt_cfg_get_dynar(_sg_cfg_set,name);