1 /* Copyright (c) 2009-2010, 2012-2013. 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 /* 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
33 * integrated also, platform construction ongoing or done.
34 * (Config cannot be changed anymore!)
36 int _sg_cfg_init_status = 0;
38 /* Parse the command line, looking for options */
39 static void sg_config_cmd_line(int *argc, char **argv)
45 for (j = i = 1; i < *argc; i++) {
46 if (!strncmp(argv[i], "--cfg=", strlen("--cfg="))) {
47 opt = strchr(argv[i], '=');
50 xbt_cfg_set_parse(_sg_cfg_set, opt);
51 XBT_DEBUG("Did apply '%s' as config setting", opt);
52 } else if (!strcmp(argv[i], "--cfg-help") || !strcmp(argv[i], "--help")) {
54 ("Description of the configuration accepted by this simulator:\n");
55 xbt_cfg_help(_sg_cfg_set);
58 "Each of these configurations can be used by adding\n"
59 " --cfg=<option name>:<option value>\n"
60 "to the command line.\n"
61 "You can also use --help-models to see the details of all models known by this simulator.\n"
64 "You can also use --help-tracing to see the details of all tracing options known by this simulator.\n"
67 "You can also use --help-logs and --help-log-categories to see the details of logging output.\n"
71 } else if (!strcmp(argv[i], "--help-models")) {
74 model_help("workstation", surf_workstation_model_description);
76 model_help("CPU", surf_cpu_model_description);
78 model_help("network", surf_network_model_description);
79 printf("\nLong description of all optimization levels accepted by the models of this simulator:\n");
80 for (k = 0; surf_optimization_mode_description[k].name; k++)
82 surf_optimization_mode_description[k].name,
83 surf_optimization_mode_description[k].description);
84 printf("Both network and CPU models have 'Lazy' as default optimization level\n\n");
87 } else if (!strcmp(argv[i], "--help-tracing")) {
100 _sg_cfg_init_status = 1; // get everything cleanly cleaned on exit
105 /* callback of the workstation/model variable */
106 static void _sg_cfg_cb__workstation_model(const char *name, int pos)
110 xbt_assert(_sg_cfg_init_status < 2,
111 "Cannot change the model after the initialization");
113 val = xbt_cfg_get_string(_sg_cfg_set, name);
115 if (!strcmp(val, "help")) {
116 model_help("workstation", surf_workstation_model_description);
120 /* Make sure that the model exists */
121 find_model_description(surf_workstation_model_description, val);
124 /* callback of the cpu/model variable */
125 static void _sg_cfg_cb__cpu_model(const char *name, int pos)
129 xbt_assert(_sg_cfg_init_status < 2,
130 "Cannot change the model after the initialization");
132 val = xbt_cfg_get_string(_sg_cfg_set, name);
134 if (!strcmp(val, "help")) {
135 model_help("CPU", surf_cpu_model_description);
139 /* New Module missing */
140 find_model_description(surf_cpu_model_description, val);
143 /* callback of the cpu/model variable */
144 static void _sg_cfg_cb__optimization_mode(const char *name, int pos)
148 xbt_assert(_sg_cfg_init_status < 2,
149 "Cannot change the model after the initialization");
151 val = xbt_cfg_get_string(_sg_cfg_set, name);
153 if (!strcmp(val, "help")) {
154 model_help("optimization", surf_optimization_mode_description);
158 /* New Module missing */
159 find_model_description(surf_optimization_mode_description, val);
162 /* callback of the cpu/model variable */
163 static void _sg_cfg_cb__storage_mode(const char *name, int pos)
167 xbt_assert(_sg_cfg_init_status < 2,
168 "Cannot change the model after the initialization");
170 val = xbt_cfg_get_string(_sg_cfg_set, name);
172 if (!strcmp(val, "help")) {
173 model_help("storage", surf_storage_model_description);
177 /* New Module missing */
178 find_model_description(surf_storage_model_description, val);
181 /* callback of the workstation_model variable */
182 static void _sg_cfg_cb__network_model(const char *name, int pos)
186 xbt_assert(_sg_cfg_init_status < 2,
187 "Cannot change the model after the initialization");
189 val = xbt_cfg_get_string(_sg_cfg_set, name);
191 if (!strcmp(val, "help")) {
192 model_help("network", surf_network_model_description);
196 /* New Module missing */
197 find_model_description(surf_network_model_description, val);
200 /* callbacks of the network models values */
201 static void _sg_cfg_cb__tcp_gamma(const char *name, int pos)
203 sg_tcp_gamma = xbt_cfg_get_double(_sg_cfg_set, name);
206 static void _sg_cfg_cb__maxmin_precision(const char* name, int pos)
208 sg_maxmin_precision = xbt_cfg_get_double(_sg_cfg_set, name);
211 static void _sg_cfg_cb__sender_gap(const char* name, int pos)
213 sg_sender_gap = xbt_cfg_get_double(_sg_cfg_set, name);
216 static void _sg_cfg_cb__latency_factor(const char *name, int pos)
218 sg_latency_factor = xbt_cfg_get_double(_sg_cfg_set, name);
221 static void _sg_cfg_cb__bandwidth_factor(const char *name, int pos)
223 sg_bandwidth_factor = xbt_cfg_get_double(_sg_cfg_set, name);
226 static void _sg_cfg_cb__weight_S(const char *name, int pos)
228 sg_weight_S_parameter = xbt_cfg_get_double(_sg_cfg_set, name);
232 /* callback of the mpi collectives */
233 static void _sg_cfg_cb__coll(const char *category,
234 s_mpi_coll_description_t * table,
235 const char *name, int pos)
239 xbt_assert(_sg_cfg_init_status < 2,
240 "Cannot change the model after the initialization");
242 val = xbt_cfg_get_string(_sg_cfg_set, name);
244 if (!strcmp(val, "help")) {
245 coll_help(category, table);
249 /* New Module missing */
250 find_coll_description(table, val);
252 static void _sg_cfg_cb__coll_gather(const char *name, int pos){
253 _sg_cfg_cb__coll("gather", mpi_coll_gather_description, name, pos);
255 static void _sg_cfg_cb__coll_allgather(const char *name, int pos){
256 _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
258 static void _sg_cfg_cb__coll_allgatherv(const char *name, int pos){
259 _sg_cfg_cb__coll("allgatherv", mpi_coll_allgatherv_description, name, pos);
261 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
263 _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
265 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
267 _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
269 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
271 _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
273 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
275 _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
277 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
279 _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
281 static void _sg_cfg_cb__coll_reduce_scatter(const char *name, int pos){
282 _sg_cfg_cb__coll("reduce_scatter", mpi_coll_reduce_scatter_description, name, pos);
284 static void _sg_cfg_cb__coll_scatter(const char *name, int pos){
285 _sg_cfg_cb__coll("scatter", mpi_coll_scatter_description, name, pos);
287 static void _sg_cfg_cb__coll_barrier(const char *name, int pos){
288 _sg_cfg_cb__coll("barrier", mpi_coll_barrier_description, name, pos);
292 /* callback of the inclusion path */
293 static void _sg_cfg_cb__surf_path(const char *name, int pos)
295 char *path = xbt_cfg_get_string_at(_sg_cfg_set, name, pos);
296 xbt_dynar_push(surf_path, &path);
299 /* callback to decide if we want to use the model-checking */
300 #include "xbt_modinter.h"
302 extern int _sg_do_model_check; /* this variable lives in xbt_main until I find a right location for it */
305 static void _sg_cfg_cb_model_check(const char *name, int pos)
308 _sg_do_model_check = xbt_cfg_get_boolean(_sg_cfg_set, name);
310 if (xbt_cfg_get_boolean(_sg_cfg_set, name)) {
311 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");
316 extern int _sg_do_verbose_exit;
318 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
320 _sg_do_verbose_exit = xbt_cfg_get_boolean(_sg_cfg_set, name);
323 extern int _sg_do_clean_atexit;
325 static void _sg_cfg_cb_clean_atexit(const char *name, int pos)
327 _sg_do_clean_atexit = xbt_cfg_get_boolean(_sg_cfg_set, name);
330 static void _sg_cfg_cb_context_factory(const char *name, int pos)
332 smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
335 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
337 smx_context_stack_size_was_set = 1;
338 smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
341 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
343 SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
346 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
348 SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
351 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
353 const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
354 if (!strcmp(mode_name, "posix")) {
355 SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
357 else if (!strcmp(mode_name, "futex")) {
358 SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
360 else if (!strcmp(mode_name, "busy_wait")) {
361 SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
364 xbt_die("Command line setting of the parallel synchronization mode should "
365 "be one of \"posix\", \"futex\" or \"busy_wait\"");
369 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
372 int val = xbt_cfg_get_boolean(_sg_cfg_set, name);
374 if (!COORD_HOST_LEVEL) {
375 COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp);
376 COORD_ASR_LEVEL = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
379 if (COORD_HOST_LEVEL)
380 xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
383 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
386 sg_network_crosstraffic = xbt_cfg_get_boolean(_sg_cfg_set, name);
390 static void _sg_cfg_cb__gtnets_jitter(const char *name, int pos)
392 sg_gtnets_jitter = xbt_cfg_get_double(_sg_cfg_set, name);
395 static void _sg_cfg_cb__gtnets_jitter_seed(const char *name, int pos)
397 sg_gtnets_jitter_seed = xbt_cfg_get_int(_sg_cfg_set, name);
401 /* create the config set, register what should be and parse the command line*/
402 void sg_config_init(int *argc, char **argv)
404 char *description = xbt_malloc(1024), *p = description;
407 /* Create the configuration support */
408 if (_sg_cfg_init_status == 0) { /* Only create stuff if not already inited */
410 "The model to use for the CPU. Possible values: ");
412 while (*(++p) != '\0');
413 for (i = 0; surf_cpu_model_description[i].name; i++)
414 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
415 surf_cpu_model_description[i].name);
417 ".\n (use 'help' as a value to see the long description of each model)");
418 xbt_cfg_register(&_sg_cfg_set, "cpu/model", description,
419 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__cpu_model, NULL);
420 xbt_cfg_setdefault_string(_sg_cfg_set, "cpu/model", "Cas01");
422 while (*(++p) != '\0');
423 for (i = 0; surf_optimization_mode_description[i].name; i++)
424 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
425 surf_optimization_mode_description[i].name);
427 ".\n (use 'help' as a value to see the long description of each optimization mode)");
428 xbt_cfg_register(&_sg_cfg_set, "cpu/optim", description,
429 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
430 xbt_cfg_setdefault_string(_sg_cfg_set, "cpu/optim", "Lazy");
433 "The model to use for the storage. Possible values: ");
435 while (*(++p) != '\0');
436 for (i = 0; surf_storage_model_description[i].name; i++)
437 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
438 surf_storage_model_description[i].name);
440 ".\n (use 'help' as a value to see the long description of each model)");
441 xbt_cfg_register(&_sg_cfg_set, "storage/model", description,
442 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__storage_mode, NULL);
443 xbt_cfg_setdefault_string(_sg_cfg_set, "storage/model", "default");
445 /* ********************************************************************* */
446 /* TUTORIAL: New model */
448 "The model to use for the New model. Possible values: ");
450 while (*(++p) != '\0');
451 for (i = 0; surf_new_model_description[i].name; i++)
452 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
453 surf_new_model_description[i].name);
455 ".\n (use 'help' as a value to see the long description of each model)");
456 xbt_cfg_register(&_sg_cfg_set, "new_model/model", description,
457 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__storage_mode, NULL);
458 xbt_cfg_setdefault_string(_sg_cfg_set, "new_model/model", "default");
459 /* ********************************************************************* */
462 "The model to use for the network. Possible values: ");
464 while (*(++p) != '\0');
465 for (i = 0; surf_network_model_description[i].name; i++)
466 p += sprintf(p, "%s%s", (i == 0 ? "" : ", "),
467 surf_network_model_description[i].name);
469 ".\n (use 'help' as a value to see the long description of each model)");
470 xbt_cfg_register(&_sg_cfg_set, "network/model", description,
471 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__network_model, NULL);
472 xbt_cfg_setdefault_string(_sg_cfg_set, "network/model", "LV08");
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 xbt_cfg_register(&_sg_cfg_set, "network/optim", description,
484 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
485 xbt_cfg_setdefault_string(_sg_cfg_set, "network/optim", "Lazy");
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 xbt_cfg_register(&_sg_cfg_set, "workstation/model", description,
497 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__workstation_model, NULL);
498 xbt_cfg_setdefault_string(_sg_cfg_set, "workstation/model", "default");
500 xbt_cfg_register(&_sg_cfg_set, "network/TCP_gamma",
501 "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)",
502 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__tcp_gamma, NULL);
503 xbt_cfg_setdefault_double(_sg_cfg_set, "network/TCP_gamma", 4194304.0);
505 xbt_cfg_register(&_sg_cfg_set, "maxmin/precision",
506 "Numerical precision used when updating simulation models (epsilon in double comparisons)",
507 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__maxmin_precision, NULL);
508 xbt_cfg_setdefault_double(_sg_cfg_set, "maxmin/precision", 0.00001);
510 /* The parameters of network models */
512 xbt_cfg_register(&_sg_cfg_set, "network/sender_gap",
513 "Minimum gap between two overlapping sends",
514 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__sender_gap, NULL);
515 /* default for "network/sender_gap" is set in network.c */
517 xbt_cfg_register(&_sg_cfg_set, "network/latency_factor",
518 "Correction factor to apply to the provided latency (default value set by network model)",
519 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__latency_factor, NULL);
520 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 1.0);
522 xbt_cfg_register(&_sg_cfg_set, "network/bandwidth_factor",
523 "Correction factor to apply to the provided bandwidth (default value set by network model)",
524 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__bandwidth_factor, NULL);
525 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor", 1.0);
527 xbt_cfg_register(&_sg_cfg_set, "network/weight_S",
528 "Correction factor to apply to the weight of competing streams (default value set by network model)",
529 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__weight_S, NULL);
530 /* default for "network/weight_S" is set in network.c */
533 xbt_cfg_register(&_sg_cfg_set, "path",
534 "Lookup path for inclusions in platform and deployment XML files",
535 xbt_cfgelm_string, 0, 0, _sg_cfg_cb__surf_path, NULL);
537 xbt_cfg_register(&_sg_cfg_set, "cpu/maxmin_selective_update",
538 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
539 xbt_cfgelm_boolean, 0, 1, NULL, NULL);
540 xbt_cfg_setdefault_boolean(_sg_cfg_set, "cpu/maxmin_selective_update", "no");
542 xbt_cfg_register(&_sg_cfg_set, "network/maxmin_selective_update",
543 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
544 xbt_cfgelm_boolean, 0, 1, NULL, NULL);
545 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/maxmin_selective_update", "no");
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_boolean, 0, 1, _sg_cfg_cb_model_check, NULL);
552 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check", "no");
554 /* do stateful model-checking */
555 xbt_cfg_register(&_sg_cfg_set, "model-check/checkpoint",
556 "Specify the amount of steps between checkpoints during stateful model-checking (default: 0 => stateless verification). "
557 "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.",
558 xbt_cfgelm_int, 0, 1, _mc_cfg_cb_checkpoint, NULL);
559 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/checkpoint", 0);
561 /* do liveness model-checking */
562 xbt_cfg_register(&_sg_cfg_set, "model-check/property",
563 "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
564 xbt_cfgelm_string, 0, 1, _mc_cfg_cb_property, NULL);
565 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
567 /* Specify the kind of model-checking reduction */
568 xbt_cfg_register(&_sg_cfg_set, "model-check/reduction",
569 "Specify the kind of exploration reduction (either none or DPOR)",
570 xbt_cfgelm_string, 0, 1, _mc_cfg_cb_reduce, NULL);
571 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/reduction", "dpor");
573 /* Enable/disable timeout for wait requests with model-checking */
574 xbt_cfg_register(&_sg_cfg_set, "model-check/timeout",
575 "Enable/Disable timeout for wait requests",
576 xbt_cfgelm_boolean, 0, 1, _mc_cfg_cb_timeout, NULL);
577 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/timeout", "no");
579 /* Set max depth exploration */
580 xbt_cfg_register(&_sg_cfg_set, "model-check/max_depth",
581 "Specify the max depth of exploration (default : 1000)",
582 xbt_cfgelm_int, 0, 1, _mc_cfg_cb_max_depth, NULL);
583 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/max_depth", 1000);
585 /* Set number of visited state stored for state comparison reduction*/
586 xbt_cfg_register(&_sg_cfg_set, "model-check/visited",
587 "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
588 xbt_cfgelm_int, 0, 1, _mc_cfg_cb_visited, NULL);
589 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/visited", 0);
591 /* Set file name for dot output of graph state */
592 xbt_cfg_register(&_sg_cfg_set, "model-check/dot_output",
593 "Specify the name of dot file corresponding to graph state",
594 xbt_cfgelm_string, 0, 1, _mc_cfg_cb_dot_output, NULL);
595 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/dot_output", "");
598 /* do verbose-exit */
599 xbt_cfg_register(&_sg_cfg_set, "verbose-exit",
600 "Activate the \"do nothing\" mode in Ctrl-C",
601 xbt_cfgelm_boolean, 0, 1, _sg_cfg_cb_verbose_exit, NULL);
602 xbt_cfg_setdefault_boolean(_sg_cfg_set, "verbose-exit", "yes");
604 /* context factory */
606 "Context factory to use in SIMIX. Possible values: thread");
607 const char *dflt_ctx_fact = "thread";
608 #ifdef CONTEXT_UCONTEXT
609 strcat(description, ", ucontext");
610 dflt_ctx_fact = "ucontext";
613 strcat(description, ", raw");
614 dflt_ctx_fact = "raw";
616 strcat(description, ".");
617 xbt_cfg_register(&_sg_cfg_set, "contexts/factory", description,
618 xbt_cfgelm_string, 1, 1, _sg_cfg_cb_context_factory, NULL);
619 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/factory", dflt_ctx_fact);
621 /* stack size of contexts in Ko */
622 xbt_cfg_register(&_sg_cfg_set, "contexts/stack_size",
623 "Stack size of contexts in Kib",
624 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_context_stack_size, NULL);
625 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/stack_size", 128);
627 /* number of parallel threads for user processes */
628 xbt_cfg_register(&_sg_cfg_set, "contexts/nthreads",
629 "Number of parallel threads used to execute user contexts",
630 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_contexts_nthreads, NULL);
631 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/nthreads", 1);
633 /* minimal number of user contexts to be run in parallel */
634 xbt_cfg_register(&_sg_cfg_set, "contexts/parallel_threshold",
635 "Minimal number of user contexts to be run in parallel (raw contexts only)",
636 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_contexts_parallel_threshold, NULL);
637 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/parallel_threshold", 2);
639 /* synchronization mode for parallel user contexts */
640 xbt_cfg_register(&_sg_cfg_set, "contexts/synchro",
641 "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
642 xbt_cfgelm_string, 1, 1, _sg_cfg_cb_contexts_parallel_mode, NULL);
644 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/synchro", "futex");
645 #else //No futex on mac and posix is unimplememted yet
646 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/synchro", "busy_wait");
649 xbt_cfg_register(&_sg_cfg_set, "network/coordinates",
650 "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
651 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb__surf_network_coordinates, NULL);
652 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/coordinates", "no");
654 xbt_cfg_register(&_sg_cfg_set, "network/crosstraffic",
655 "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
656 xbt_cfgelm_boolean, 0, 1, _sg_cfg_cb__surf_network_crosstraffic, NULL);
657 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/crosstraffic", "no");
660 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter",
661 "Double value to oscillate the link latency, uniformly in random interval [-latency*gtnets_jitter,latency*gtnets_jitter)",
662 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__gtnets_jitter, NULL);
663 xbt_cfg_setdefault_double(_sg_cfg_set, "gtnets/jitter", 0.0);
665 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter_seed",
666 "Use a positive seed to reproduce jitted results, value must be in [1,1e8], default is 10",
667 xbt_cfgelm_int, 0, 1, _sg_cfg_cb__gtnets_jitter_seed, NULL);
668 xbt_cfg_setdefault_int(_sg_cfg_set, "gtnets/jitter_seed", 10);
671 xbt_cfg_register(&_sg_cfg_set, "ns3/TcpModel",
672 "The ns3 tcp model can be : NewReno or Reno or Tahoe",
673 xbt_cfgelm_string, 1, 1, NULL, NULL);
674 xbt_cfg_setdefault_string(_sg_cfg_set, "ns3/TcpModel", "default");
678 xbt_cfg_register(&_sg_cfg_set, "smpi/running_power",
679 "Power of the host running the simulation (in flop/s). Used to bench the operations.",
680 xbt_cfgelm_double, 1, 1, NULL, NULL);
681 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/running_power", 20000.0);
683 xbt_cfg_register(&_sg_cfg_set, "smpi/display_timing",
684 "Boolean indicating whether we should display the timing after simulation.",
685 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
686 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/display_timing", "no");
688 xbt_cfg_register(&_sg_cfg_set, "smpi/use_shared_malloc",
689 "Boolean indicating whether we should use shared memory when using SMPI_SHARED_MALLOC. Allows user to disable it for debug purposes.",
690 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
691 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/use_shared_malloc", "yes");
693 xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
694 "Minimal computation time (in seconds) not discarded.",
695 xbt_cfgelm_double, 1, 1, NULL, NULL);
696 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/cpu_threshold", 1e-6);
698 xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thres",
699 "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
700 xbt_cfgelm_int, 1, 1, NULL, NULL);
701 xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/async_small_thres", 0);
703 xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thres",
704 "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
705 xbt_cfgelm_int, 1, 1, NULL, NULL);
706 xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/send_is_detached_thres", 65536);
708 //For smpi/bw_factor and smpi/lat_factor
709 //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
710 //test is if( size >= thresholdN ) return valueN;
711 //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
712 // or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
713 xbt_cfg_register(&_sg_cfg_set, "smpi/bw_factor",
714 "Bandwidth factors for smpi.",
715 xbt_cfgelm_string, 1, 1, NULL, NULL);
716 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");
718 xbt_cfg_register(&_sg_cfg_set, "smpi/lat_factor",
719 "Latency factors for smpi.",
720 xbt_cfgelm_string, 1, 1, NULL, NULL);
721 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");
723 xbt_cfg_register(&_sg_cfg_set, "smpi/os",
724 "Small messages timings (MPI_Send minimum time for small messages)",
725 xbt_cfgelm_string, 1, 1, NULL, NULL);
726 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
728 xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
729 "Small messages timings (MPI_Isend minimum time for small messages)",
730 xbt_cfgelm_string, 1, 1, NULL, NULL);
731 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
733 xbt_cfg_register(&_sg_cfg_set, "smpi/or",
734 "Small messages timings (MPI_Recv minimum time for small messages)",
735 xbt_cfgelm_string, 1, 1, NULL, NULL);
736 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
737 xbt_cfg_register(&_sg_cfg_set, "smpi/iprobe",
738 "Minimum time to inject inside a call to MPI_Iprobe",
739 xbt_cfgelm_double, 1, 1, NULL, NULL);
740 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/iprobe", 1e-4);
741 xbt_cfg_register(&_sg_cfg_set, "smpi/coll_selector",
742 "Which collective selector to use",
743 xbt_cfgelm_string, 1, 1, NULL, NULL);
744 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/coll_selector", "default");
746 xbt_cfg_register(&_sg_cfg_set, "smpi/gather",
747 "Which collective to use for gather",
748 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_gather, NULL);
750 xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
751 "Which collective to use for allgather",
752 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_allgather, NULL);
754 xbt_cfg_register(&_sg_cfg_set, "smpi/barrier",
755 "Which collective to use for barrier",
756 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_barrier, NULL);
758 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce_scatter",
759 "Which collective to use for reduce_scatter",
760 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_reduce_scatter, NULL);
762 xbt_cfg_register(&_sg_cfg_set, "smpi/scatter",
763 "Which collective to use for scatter",
764 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_scatter, NULL);
766 xbt_cfg_register(&_sg_cfg_set, "smpi/allgatherv",
767 "Which collective to use for allgatherv",
768 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_allgatherv, NULL);
770 xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
771 "Which collective to use for allreduce",
772 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_allreduce, NULL);
774 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
775 "Which collective to use for alltoall",
776 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_alltoall, NULL);
778 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
779 "Which collective to use for alltoallv",
780 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_alltoallv, NULL);
782 xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
783 "Which collective to use for bcast",
784 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_bcast, NULL);
786 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
787 "Which collective to use for reduce",
788 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__coll_reduce, NULL);
791 xbt_cfg_register(&_sg_cfg_set, "clean_atexit",
792 "\"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.",
793 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_clean_atexit, NULL);
794 xbt_cfg_setdefault_boolean(_sg_cfg_set, "clean_atexit", "yes");
797 /* retrieves the current directory of the current process */
798 const char *initial_path = __surf_get_initial_path();
799 xbt_assert((initial_path),
800 "__surf_get_initial_path() failed! Can't resolves current Windows directory");
802 surf_path = xbt_dynar_new(sizeof(char *), NULL);
803 xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
806 _sg_cfg_init_status = 1;
808 sg_config_cmd_line(argc, argv);
810 xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
813 XBT_WARN("Call to sg_config_init() after initialization ignored");
816 xbt_free(description);
819 void sg_config_finalize(void)
821 if (!_sg_cfg_init_status)
822 return; /* Not initialized yet. Nothing to do */
824 xbt_cfg_free(&_sg_cfg_set);
825 _sg_cfg_init_status = 0;
828 /* Pick the right models for CPU, net and workstation, and call their model_init_preparse */
829 void surf_config_models_setup()
831 const 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")) {
852 XBT_INFO("Switching workstation model to compound since you changed the network and/or cpu model(s)");
853 workstation_model_name = "compound";
854 xbt_cfg_set_string(_sg_cfg_set, "workstation/model", workstation_model_name);
857 XBT_DEBUG("Workstation model: %s", workstation_model_name);
859 find_model_description(surf_workstation_model_description,
860 workstation_model_name);
861 if (!strcmp(workstation_model_name, "compound")) {
865 xbt_assert(cpu_model_name,
866 "Set a cpu model to use with the 'compound' workstation model");
868 xbt_assert(network_model_name,
869 "Set a network model to use with the 'compound' workstation model");
872 find_model_description(surf_network_model_description,
875 find_model_description(surf_cpu_model_description, cpu_model_name);
877 surf_cpu_model_description[cpu_id].model_init_preparse();
878 surf_network_model_description[network_id].model_init_preparse();
881 XBT_DEBUG("Call workstation_model_init");
882 surf_workstation_model_description[workstation_id].model_init_preparse();
884 XBT_DEBUG("Call storage_model_init");
885 storage_id = find_model_description(surf_storage_model_description, storage_model_name);
886 surf_storage_model_description[storage_id].model_init_preparse();
888 /* ********************************************************************* */
889 /* TUTORIAL: New model */
890 int new_model_id = -1;
891 char *new_model_name = NULL;
892 new_model_name = xbt_cfg_get_string(_sg_cfg_set, "new_model/model");
893 XBT_DEBUG("Call new model_init");
894 new_model_id = find_model_description(surf_new_model_description, new_model_name);
895 surf_new_model_description[new_model_id].model_init_preparse();
896 /* ********************************************************************* */
899 int sg_cfg_get_int(const char* name)
901 return xbt_cfg_get_int(_sg_cfg_set,name);
904 double sg_cfg_get_double(const char* name)
906 return xbt_cfg_get_double(_sg_cfg_set,name);
909 char* sg_cfg_get_string(const char* name)
911 return xbt_cfg_get_string(_sg_cfg_set,name);
914 int sg_cfg_get_boolean(const char* name)
916 return xbt_cfg_get_boolean(_sg_cfg_set,name);
919 void sg_cfg_get_peer(const char *name, char **peer, int *port)
921 xbt_cfg_get_peer(_sg_cfg_set,name, peer, port);
924 xbt_dynar_t sg_cfg_get_dynar(const char* name)
926 return xbt_cfg_get_dynar(_sg_cfg_set,name);