1 /* Copyright (c) 2009-2010, 2012-2014. 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 "mc/mc_record.h"
24 #include "instr/instr.h"
26 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_config, surf,
27 "About the configuration of simgrid");
29 xbt_cfg_t _sg_cfg_set = NULL;
31 /* 0: beginning of time (config cannot be changed yet);
32 * 1: initialized: cfg_set created (config can now be changed);
33 * 2: configured: command line parsed and config part of platform file was
34 * integrated also, platform construction ongoing or done.
35 * (Config cannot be changed anymore!)
37 int _sg_cfg_init_status = 0;
39 /* instruct the upper layer (simix or simdag) to exit as soon as possible
41 int _sg_cfg_exit_asap = 0;
43 #define sg_cfg_exit_early() do { _sg_cfg_exit_asap = 1; return; } while (0)
45 /* Parse the command line, looking for options */
46 static void sg_config_cmd_line(int *argc, char **argv)
52 for (j = i = 1; i < *argc; i++) {
53 if (!strncmp(argv[i], "--cfg=", strlen("--cfg="))) {
54 opt = strchr(argv[i], '=');
57 xbt_cfg_set_parse(_sg_cfg_set, opt);
58 XBT_DEBUG("Did apply '%s' as config setting", opt);
59 } else if (!strcmp(argv[i], "--version")) {
60 printf("%s\n", SIMGRID_VERSION_STRING);
62 } else if (!strcmp(argv[i], "--cfg-help") || !strcmp(argv[i], "--help")) {
64 ("Description of the configuration accepted by this simulator:\n");
65 xbt_cfg_help(_sg_cfg_set);
68 "Each of these configurations can be used by adding\n"
69 " --cfg=<option name>:<option value>\n"
70 "to the command line.\n"
72 "You can also use --help-models to see the details of all models known by this simulator.\n"
75 "You can also use --help-tracing to see the details of all tracing options known by this simulator.\n"
78 "You can also use --help-logs and --help-log-categories to see the details of logging output.\n"
80 "You can also use --version to get SimGrid version information.\n"
84 } else if (!strcmp(argv[i], "--help-models")) {
87 model_help("workstation", surf_workstation_model_description);
89 model_help("CPU", surf_cpu_model_description);
91 model_help("network", surf_network_model_description);
92 printf("\nLong description of all optimization levels accepted by the models of this simulator:\n");
93 for (k = 0; surf_optimization_mode_description[k].name; k++)
95 surf_optimization_mode_description[k].name,
96 surf_optimization_mode_description[k].description);
97 printf("Both network and CPU models have 'Lazy' as default optimization level\n\n");
100 } else if (!strcmp(argv[i], "--help-tracing")) {
116 /* callback of the plugin variable */
117 static void _sg_cfg_cb__plugin(const char *name, int pos)
122 xbt_assert(_sg_cfg_init_status < 2,
123 "Cannot load a plugin after the initialization");
125 val = xbt_cfg_get_string(_sg_cfg_set, name);
127 if (!strcmp(val, "help")) {
128 model_help("plugin", surf_plugin_description);
132 /* New Module missing */
133 int plugin_id = find_model_description(surf_plugin_description, val);
134 surf_plugin_description[plugin_id].model_init_preparse();
137 /* callback of the workstation/model variable */
138 static void _sg_cfg_cb__workstation_model(const char *name, int pos)
142 xbt_assert(_sg_cfg_init_status < 2,
143 "Cannot change the model after the initialization");
145 val = xbt_cfg_get_string(_sg_cfg_set, name);
147 if (!strcmp(val, "help")) {
148 model_help("workstation", surf_workstation_model_description);
152 /* Make sure that the model exists */
153 find_model_description(surf_workstation_model_description, val);
156 /* callback of the vm_workstation/model variable */
157 static void _sg_cfg_cb__vm_workstation_model(const char *name, int pos)
161 xbt_assert(_sg_cfg_init_status < 2,
162 "Cannot change the model after the initialization");
164 val = xbt_cfg_get_string(_sg_cfg_set, name);
166 if (!strcmp(val, "help")) {
167 model_help("vm_workstation", surf_vm_workstation_model_description);
171 /* Make sure that the model exists */
172 find_model_description(surf_vm_workstation_model_description, val);
175 /* callback of the cpu/model variable */
176 static void _sg_cfg_cb__cpu_model(const char *name, int pos)
180 xbt_assert(_sg_cfg_init_status < 2,
181 "Cannot change the model after the initialization");
183 val = xbt_cfg_get_string(_sg_cfg_set, name);
185 if (!strcmp(val, "help")) {
186 model_help("CPU", surf_cpu_model_description);
190 /* New Module missing */
191 find_model_description(surf_cpu_model_description, val);
194 /* callback of the cpu/model variable */
195 static void _sg_cfg_cb__optimization_mode(const char *name, int pos)
199 xbt_assert(_sg_cfg_init_status < 2,
200 "Cannot change the model after the initialization");
202 val = xbt_cfg_get_string(_sg_cfg_set, name);
204 if (!strcmp(val, "help")) {
205 model_help("optimization", surf_optimization_mode_description);
209 /* New Module missing */
210 find_model_description(surf_optimization_mode_description, val);
213 /* callback of the cpu/model variable */
214 static void _sg_cfg_cb__storage_mode(const char *name, int pos)
218 xbt_assert(_sg_cfg_init_status < 2,
219 "Cannot change the model after the initialization");
221 val = xbt_cfg_get_string(_sg_cfg_set, name);
223 if (!strcmp(val, "help")) {
224 model_help("storage", surf_storage_model_description);
228 /* New Module missing */
229 find_model_description(surf_storage_model_description, val);
232 /* callback of the workstation_model variable */
233 static void _sg_cfg_cb__network_model(const char *name, int pos)
237 xbt_assert(_sg_cfg_init_status < 2,
238 "Cannot change the model after the initialization");
240 val = xbt_cfg_get_string(_sg_cfg_set, name);
242 if (!strcmp(val, "help")) {
243 model_help("network", surf_network_model_description);
247 /* New Module missing */
248 find_model_description(surf_network_model_description, val);
251 /* callbacks of the network models values */
252 static void _sg_cfg_cb__tcp_gamma(const char *name, int pos)
254 sg_tcp_gamma = xbt_cfg_get_double(_sg_cfg_set, name);
257 static void _sg_cfg_cb__maxmin_precision(const char* name, int pos)
259 sg_maxmin_precision = xbt_cfg_get_double(_sg_cfg_set, name);
262 static void _sg_cfg_cb__surf_precision(const char* name, int pos)
264 sg_surf_precision = xbt_cfg_get_double(_sg_cfg_set, name);
267 static void _sg_cfg_cb__sender_gap(const char* name, int pos)
269 sg_sender_gap = xbt_cfg_get_double(_sg_cfg_set, name);
272 static void _sg_cfg_cb__latency_factor(const char *name, int pos)
274 sg_latency_factor = xbt_cfg_get_double(_sg_cfg_set, name);
277 static void _sg_cfg_cb__bandwidth_factor(const char *name, int pos)
279 sg_bandwidth_factor = xbt_cfg_get_double(_sg_cfg_set, name);
282 static void _sg_cfg_cb__weight_S(const char *name, int pos)
284 sg_weight_S_parameter = xbt_cfg_get_double(_sg_cfg_set, name);
288 /* callback of the mpi collectives */
289 static void _sg_cfg_cb__coll(const char *category,
290 s_mpi_coll_description_t * table,
291 const char *name, int pos)
295 xbt_assert(_sg_cfg_init_status < 2,
296 "Cannot change the model after the initialization");
298 val = xbt_cfg_get_string(_sg_cfg_set, name);
300 if (!strcmp(val, "help")) {
301 coll_help(category, table);
305 /* New Module missing */
306 find_coll_description(table, val, category);
308 static void _sg_cfg_cb__coll_gather(const char *name, int pos){
309 _sg_cfg_cb__coll("gather", mpi_coll_gather_description, name, pos);
311 static void _sg_cfg_cb__coll_allgather(const char *name, int pos){
312 _sg_cfg_cb__coll("allgather", mpi_coll_allgather_description, name, pos);
314 static void _sg_cfg_cb__coll_allgatherv(const char *name, int pos){
315 _sg_cfg_cb__coll("allgatherv", mpi_coll_allgatherv_description, name, pos);
317 static void _sg_cfg_cb__coll_allreduce(const char *name, int pos)
319 _sg_cfg_cb__coll("allreduce", mpi_coll_allreduce_description, name, pos);
321 static void _sg_cfg_cb__coll_alltoall(const char *name, int pos)
323 _sg_cfg_cb__coll("alltoall", mpi_coll_alltoall_description, name, pos);
325 static void _sg_cfg_cb__coll_alltoallv(const char *name, int pos)
327 _sg_cfg_cb__coll("alltoallv", mpi_coll_alltoallv_description, name, pos);
329 static void _sg_cfg_cb__coll_bcast(const char *name, int pos)
331 _sg_cfg_cb__coll("bcast", mpi_coll_bcast_description, name, pos);
333 static void _sg_cfg_cb__coll_reduce(const char *name, int pos)
335 _sg_cfg_cb__coll("reduce", mpi_coll_reduce_description, name, pos);
337 static void _sg_cfg_cb__coll_reduce_scatter(const char *name, int pos){
338 _sg_cfg_cb__coll("reduce_scatter", mpi_coll_reduce_scatter_description, name, pos);
340 static void _sg_cfg_cb__coll_scatter(const char *name, int pos){
341 _sg_cfg_cb__coll("scatter", mpi_coll_scatter_description, name, pos);
343 static void _sg_cfg_cb__coll_barrier(const char *name, int pos){
344 _sg_cfg_cb__coll("barrier", mpi_coll_barrier_description, name, pos);
347 static void _sg_cfg_cb__wtime_sleep(const char *name, int pos){
348 smpi_wtime_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
351 static void _sg_cfg_cb__iprobe_sleep(const char *name, int pos){
352 smpi_iprobe_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
355 static void _sg_cfg_cb__test_sleep(const char *name, int pos){
356 smpi_test_sleep = xbt_cfg_get_double(_sg_cfg_set, name);
363 /* callback of the inclusion path */
364 static void _sg_cfg_cb__surf_path(const char *name, int pos)
366 char *path = xbt_cfg_get_string_at(_sg_cfg_set, name, pos);
367 xbt_dynar_push(surf_path, &path);
370 /* callback to decide if we want to use the model-checking */
371 #include "xbt_modinter.h"
374 extern int _sg_do_model_check; /* this variable lives in xbt_main until I find a right location for it */
375 extern int _sg_do_model_check_record;
378 static void _sg_cfg_cb_model_check_replay(const char *name, int pos)
380 MC_record_path = xbt_cfg_get_string(_sg_cfg_set, name);
383 static void _sg_cfg_cb_model_check(const char *name, int pos)
386 _sg_do_model_check = xbt_cfg_get_boolean(_sg_cfg_set, name);
388 if (xbt_cfg_get_boolean(_sg_cfg_set, name)) {
389 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");
394 static void _sg_cfg_cb_model_check_record(const char *name, int pos)
397 _sg_do_model_check_record = xbt_cfg_get_boolean(_sg_cfg_set, name);
399 if (xbt_cfg_get_boolean(_sg_cfg_set, name)) {
400 xbt_die("You tried to activate the model-checking record from the command line, but it was not compiled in. Change your settings in cmake, recompile and try again");
405 extern int _sg_do_verbose_exit;
407 static void _sg_cfg_cb_verbose_exit(const char *name, int pos)
409 _sg_do_verbose_exit = xbt_cfg_get_boolean(_sg_cfg_set, name);
412 extern int _sg_do_clean_atexit;
414 static void _sg_cfg_cb_clean_atexit(const char *name, int pos)
416 _sg_do_clean_atexit = xbt_cfg_get_boolean(_sg_cfg_set, name);
419 static void _sg_cfg_cb_context_factory(const char *name, int pos)
421 smx_context_factory_name = xbt_cfg_get_string(_sg_cfg_set, name);
424 static void _sg_cfg_cb_context_stack_size(const char *name, int pos)
426 smx_context_stack_size_was_set = 1;
427 smx_context_stack_size = xbt_cfg_get_int(_sg_cfg_set, name) * 1024;
430 static void _sg_cfg_cb_context_guard_size(const char *name, int pos)
432 smx_context_guard_size_was_set = 1;
433 smx_context_guard_size = xbt_cfg_get_int(_sg_cfg_set, name) * xbt_pagesize;
436 static void _sg_cfg_cb_contexts_nthreads(const char *name, int pos)
438 SIMIX_context_set_nthreads(xbt_cfg_get_int(_sg_cfg_set, name));
441 static void _sg_cfg_cb_contexts_parallel_threshold(const char *name, int pos)
443 SIMIX_context_set_parallel_threshold(xbt_cfg_get_int(_sg_cfg_set, name));
446 static void _sg_cfg_cb_contexts_parallel_mode(const char *name, int pos)
448 const char* mode_name = xbt_cfg_get_string(_sg_cfg_set, name);
449 if (!strcmp(mode_name, "posix")) {
450 SIMIX_context_set_parallel_mode(XBT_PARMAP_POSIX);
452 else if (!strcmp(mode_name, "futex")) {
453 SIMIX_context_set_parallel_mode(XBT_PARMAP_FUTEX);
455 else if (!strcmp(mode_name, "busy_wait")) {
456 SIMIX_context_set_parallel_mode(XBT_PARMAP_BUSY_WAIT);
459 xbt_die("Command line setting of the parallel synchronization mode should "
460 "be one of \"posix\", \"futex\" or \"busy_wait\"");
464 static void _sg_cfg_cb__surf_network_coordinates(const char *name,
467 int val = xbt_cfg_get_boolean(_sg_cfg_set, name);
469 if (!COORD_HOST_LEVEL) {
470 COORD_HOST_LEVEL = xbt_lib_add_level(host_lib,xbt_dynar_free_voidp);
471 COORD_ASR_LEVEL = xbt_lib_add_level(as_router_lib,xbt_dynar_free_voidp);
474 if (COORD_HOST_LEVEL)
475 xbt_die("Setting of whether to use coordinate cannot be disabled once set.");
478 static void _sg_cfg_cb__surf_network_crosstraffic(const char *name,
481 sg_network_crosstraffic = xbt_cfg_get_boolean(_sg_cfg_set, name);
485 static void _sg_cfg_cb__gtnets_jitter(const char *name, int pos)
487 sg_gtnets_jitter = xbt_cfg_get_double(_sg_cfg_set, name);
490 static void _sg_cfg_cb__gtnets_jitter_seed(const char *name, int pos)
492 sg_gtnets_jitter_seed = xbt_cfg_get_int(_sg_cfg_set, name);
496 /* build description line with possible values */
497 static void describe_model(char *result,
498 const s_surf_model_description_t model_description[],
500 const char *description)
503 sprintf(result, "%s. Possible values: %s", description,
504 model_description[0].name ? model_description[0].name : "n/a");
506 for (i = 1; model_description[i].name; i++)
507 p += sprintf(p, ", %s", model_description[i].name);
509 ".\n (use 'help' as a value to see the long description of each %s)",
513 /* create the config set, register what should be and parse the command line*/
514 void sg_config_init(int *argc, char **argv)
516 char description[1024];
518 /* Create the configuration support */
519 if (_sg_cfg_init_status == 0) { /* Only create stuff if not already inited */
521 /* Plugins configuration */
522 describe_model(description, surf_plugin_description,
523 "plugin", "The plugins");
524 xbt_cfg_register(&_sg_cfg_set, "plugin", description,
525 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__plugin, NULL);
527 describe_model(description, surf_cpu_model_description,
528 "model", "The model to use for the CPU");
529 xbt_cfg_register(&_sg_cfg_set, "cpu/model", description,
530 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__cpu_model, NULL);
531 xbt_cfg_setdefault_string(_sg_cfg_set, "cpu/model", "Cas01");
533 describe_model(description, surf_optimization_mode_description,
535 "The optimization modes to use for the CPU");
536 xbt_cfg_register(&_sg_cfg_set, "cpu/optim", description,
537 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
538 xbt_cfg_setdefault_string(_sg_cfg_set, "cpu/optim", "Lazy");
540 describe_model(description, surf_storage_model_description,
541 "model", "The model to use for the storage");
542 xbt_cfg_register(&_sg_cfg_set, "storage/model", description,
543 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__storage_mode, NULL);
544 xbt_cfg_setdefault_string(_sg_cfg_set, "storage/model", "default");
546 describe_model(description, surf_network_model_description,
547 "model", "The model to use for the network");
548 xbt_cfg_register(&_sg_cfg_set, "network/model", description,
549 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__network_model, NULL);
550 xbt_cfg_setdefault_string(_sg_cfg_set, "network/model", "LV08");
552 describe_model(description, surf_optimization_mode_description,
554 "The optimization modes to use for the network");
555 xbt_cfg_register(&_sg_cfg_set, "network/optim", description,
556 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__optimization_mode, NULL);
557 xbt_cfg_setdefault_string(_sg_cfg_set, "network/optim", "Lazy");
559 describe_model(description, surf_workstation_model_description,
560 "model", "The model to use for the workstation");
561 xbt_cfg_register(&_sg_cfg_set, "workstation/model", description,
562 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__workstation_model, NULL);
563 xbt_cfg_setdefault_string(_sg_cfg_set, "workstation/model", "default");
565 describe_model(description, surf_vm_workstation_model_description,
566 "model", "The model to use for the vm workstation");
567 xbt_cfg_register(&_sg_cfg_set, "vm_workstation/model", description,
568 xbt_cfgelm_string, 1, 1, &_sg_cfg_cb__vm_workstation_model, NULL);
569 xbt_cfg_setdefault_string(_sg_cfg_set, "vm_workstation/model", "default");
571 xbt_cfg_register(&_sg_cfg_set, "network/TCP_gamma",
572 "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)",
573 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__tcp_gamma, NULL);
574 xbt_cfg_setdefault_double(_sg_cfg_set, "network/TCP_gamma", 4194304.0);
576 xbt_cfg_register(&_sg_cfg_set, "surf/precision",
577 "Numerical precision used when updating simulation times (hence this value is expressed in seconds)",
578 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__surf_precision, NULL);
579 xbt_cfg_setdefault_double(_sg_cfg_set, "surf/precision", 0.00001);
581 xbt_cfg_register(&_sg_cfg_set, "maxmin/precision",
582 "Numerical precision used when computing resource sharing (hence this value is expressed in ops/sec or bytes/sec)",
583 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__maxmin_precision, NULL);
584 xbt_cfg_setdefault_double(_sg_cfg_set, "maxmin/precision", 0.00001);
586 /* The parameters of network models */
588 xbt_cfg_register(&_sg_cfg_set, "network/sender_gap",
589 "Minimum gap between two overlapping sends",
590 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__sender_gap, NULL);
591 /* real default for "network/sender_gap" is set in network_smpi.cpp */
592 xbt_cfg_setdefault_double(_sg_cfg_set, "network/sender_gap", NAN);
594 xbt_cfg_register(&_sg_cfg_set, "network/latency_factor",
595 "Correction factor to apply to the provided latency (default value set by network model)",
596 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__latency_factor, NULL);
597 xbt_cfg_setdefault_double(_sg_cfg_set, "network/latency_factor", 1.0);
599 xbt_cfg_register(&_sg_cfg_set, "network/bandwidth_factor",
600 "Correction factor to apply to the provided bandwidth (default value set by network model)",
601 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__bandwidth_factor, NULL);
602 xbt_cfg_setdefault_double(_sg_cfg_set, "network/bandwidth_factor", 1.0);
604 xbt_cfg_register(&_sg_cfg_set, "network/weight_S",
605 "Correction factor to apply to the weight of competing streams (default value set by network model)",
606 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__weight_S, NULL);
607 /* real default for "network/weight_S" is set in network_*.cpp */
608 xbt_cfg_setdefault_double(_sg_cfg_set, "network/weight_S", NAN);
611 xbt_cfg_register(&_sg_cfg_set, "path",
612 "Lookup path for inclusions in platform and deployment XML files",
613 xbt_cfgelm_string, 1, 0, _sg_cfg_cb__surf_path, NULL);
615 xbt_cfg_register(&_sg_cfg_set, "cpu/maxmin_selective_update",
616 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
617 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
618 xbt_cfg_setdefault_boolean(_sg_cfg_set, "cpu/maxmin_selective_update", "no");
620 xbt_cfg_register(&_sg_cfg_set, "network/maxmin_selective_update",
621 "Update the constraint set propagating recursively to others constraints (off by default when optim is set to lazy)",
622 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
623 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/maxmin_selective_update", "no");
625 /* Replay (this part is enabled event if MC it disabled) */
626 xbt_cfg_register(&_sg_cfg_set, "model-check/replay",
627 "Uenable replay mode with the given path",
628 xbt_cfgelm_string, 0, 1, _sg_cfg_cb_model_check_replay, NULL);
631 /* do model-checking */
632 xbt_cfg_register(&_sg_cfg_set, "model-check",
633 "Verify the system through model-checking instead of simulating it (EXPERIMENTAL)",
634 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_model_check, NULL);
635 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check", "no");
637 /* do model-checking-record */
638 xbt_cfg_register(&_sg_cfg_set, "model-check/record",
639 "Record the model-checking paths",
640 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_model_check_record, NULL);
641 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/record", "no");
643 /* do stateful model-checking */
644 xbt_cfg_register(&_sg_cfg_set, "model-check/checkpoint",
645 "Specify the amount of steps between checkpoints during stateful model-checking (default: 0 => stateless verification). "
646 "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.",
647 xbt_cfgelm_int, 1, 1, _mc_cfg_cb_checkpoint, NULL);
648 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/checkpoint", 0);
650 /* do stateful model-checking */
651 xbt_cfg_register(&_sg_cfg_set, "model-check/sparse-checkpoint",
652 "Use sparse per-page snapshots.",
653 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_sparse_checkpoint, NULL);
654 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/sparse-checkpoint", "no");
656 /* do stateful model-checking */
657 xbt_cfg_register(&_sg_cfg_set, "model-check/soft-dirty",
658 "Use sparse per-page snapshots.",
659 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_soft_dirty, NULL);
660 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/soft-dirty", "no");
662 /* do liveness model-checking */
663 xbt_cfg_register(&_sg_cfg_set, "model-check/property",
664 "Specify the name of the file containing the property. It must be the result of the ltl2ba program.",
665 xbt_cfgelm_string, 1, 1, _mc_cfg_cb_property, NULL);
666 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/property", "");
668 /* do communications determinism model-checking */
669 xbt_cfg_register(&_sg_cfg_set, "model-check/communications_determinism",
670 "Enable/disable the detection of determinism in the communications schemes",
671 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_comms_determinism, NULL);
672 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/communications_determinism", "no");
674 /* do send determinism model-checking */
675 xbt_cfg_register(&_sg_cfg_set, "model-check/send_determinism",
676 "Enable/disable the detection of send-determinism in the communications schemes",
677 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_send_determinism, NULL);
678 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/send_determinism", "no");
680 /* Specify the kind of model-checking reduction */
681 xbt_cfg_register(&_sg_cfg_set, "model-check/reduction",
682 "Specify the kind of exploration reduction (either none or DPOR)",
683 xbt_cfgelm_string, 1, 1, _mc_cfg_cb_reduce, NULL);
684 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/reduction", "dpor");
686 /* Enable/disable timeout for wait requests with model-checking */
687 xbt_cfg_register(&_sg_cfg_set, "model-check/timeout",
688 "Enable/Disable timeout for wait requests",
689 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_timeout, NULL);
690 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/timeout", "no");
692 /* Enable/disable global hash computation with model-checking */
693 xbt_cfg_register(&_sg_cfg_set, "model-check/hash",
694 "Enable/Disable state hash for state comparison (exprimental)",
695 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_hash, NULL);
696 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/hash", "no");
698 /* Set max depth exploration */
699 xbt_cfg_register(&_sg_cfg_set, "model-check/max_depth",
700 "Specify the max depth of exploration (default : 1000)",
701 xbt_cfgelm_int, 1, 1, _mc_cfg_cb_max_depth, NULL);
702 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/max_depth", 1000);
704 /* Set number of visited state stored for state comparison reduction*/
705 xbt_cfg_register(&_sg_cfg_set, "model-check/visited",
706 "Specify the number of visited state stored for state comparison reduction. If value=5, the last 5 visited states are stored",
707 xbt_cfgelm_int, 1, 1, _mc_cfg_cb_visited, NULL);
708 xbt_cfg_setdefault_int(_sg_cfg_set, "model-check/visited", 0);
710 /* Set file name for dot output of graph state */
711 xbt_cfg_register(&_sg_cfg_set, "model-check/dot_output",
712 "Specify the name of dot file corresponding to graph state",
713 xbt_cfgelm_string, 1, 1, _mc_cfg_cb_dot_output, NULL);
714 xbt_cfg_setdefault_string(_sg_cfg_set, "model-check/dot_output", "");
716 /* Enable/disable non progressive cycles detection with model-checking */
717 xbt_cfg_register(&_sg_cfg_set, "model-check/termination",
718 "Enable/Disable non progressive cycle detection",
719 xbt_cfgelm_boolean, 1, 1, _mc_cfg_cb_termination, NULL);
720 xbt_cfg_setdefault_boolean(_sg_cfg_set, "model-check/termination", "no");
723 /* do verbose-exit */
724 xbt_cfg_register(&_sg_cfg_set, "verbose-exit",
725 "Activate the \"do nothing\" mode in Ctrl-C",
726 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_verbose_exit, NULL);
727 xbt_cfg_setdefault_boolean(_sg_cfg_set, "verbose-exit", "yes");
729 /* context factory */
730 const char *dflt_ctx_fact = "thread";
732 char *p = description +
734 "Context factory to use in SIMIX. Possible values: %s",
736 #ifdef CONTEXT_UCONTEXT
737 dflt_ctx_fact = "ucontext";
738 p += sprintf(p, ", %s", dflt_ctx_fact);
741 dflt_ctx_fact = "raw";
742 p += sprintf(p, ", %s", dflt_ctx_fact);
746 xbt_cfg_register(&_sg_cfg_set, "contexts/factory", description,
747 xbt_cfgelm_string, 1, 1, _sg_cfg_cb_context_factory, NULL);
748 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/factory", dflt_ctx_fact);
750 /* stack size of contexts in KiB */
751 xbt_cfg_register(&_sg_cfg_set, "contexts/stack_size",
752 "Stack size of contexts in KiB",
753 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_context_stack_size, NULL);
754 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/stack_size", 8*1024);
755 /* No, it was not set yet (the above setdefault() changed this to 1). */
756 smx_context_stack_size_was_set = 0;
758 /* guard size for contexts stacks in memory pages */
759 xbt_cfg_register(&_sg_cfg_set, "contexts/guard_size",
760 "Guard size for contexts stacks in memory pages",
761 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_context_guard_size, NULL);
762 #if defined(_XBT_WIN32) || (PTH_STACKGROWTH != -1)
763 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/guard_size", 0);
765 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/guard_size", 1);
767 /* No, it was not set yet (the above setdefault() changed this to 1). */
768 smx_context_guard_size_was_set = 0;
770 /* number of parallel threads for user processes */
771 xbt_cfg_register(&_sg_cfg_set, "contexts/nthreads",
772 "Number of parallel threads used to execute user contexts",
773 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_contexts_nthreads, NULL);
774 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/nthreads", 1);
776 /* minimal number of user contexts to be run in parallel */
777 xbt_cfg_register(&_sg_cfg_set, "contexts/parallel_threshold",
778 "Minimal number of user contexts to be run in parallel (raw contexts only)",
779 xbt_cfgelm_int, 1, 1, _sg_cfg_cb_contexts_parallel_threshold, NULL);
780 xbt_cfg_setdefault_int(_sg_cfg_set, "contexts/parallel_threshold", 2);
782 /* synchronization mode for parallel user contexts */
783 xbt_cfg_register(&_sg_cfg_set, "contexts/synchro",
784 "Synchronization mode to use when running contexts in parallel (either futex, posix or busy_wait)",
785 xbt_cfgelm_string, 1, 1, _sg_cfg_cb_contexts_parallel_mode, NULL);
787 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/synchro", "futex");
788 #else //No futex on mac and posix is unimplememted yet
789 xbt_cfg_setdefault_string(_sg_cfg_set, "contexts/synchro", "busy_wait");
792 xbt_cfg_register(&_sg_cfg_set, "network/coordinates",
793 "\"yes\" or \"no\", specifying whether we use a coordinate-based routing (as Vivaldi)",
794 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb__surf_network_coordinates, NULL);
795 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/coordinates", "no");
797 xbt_cfg_register(&_sg_cfg_set, "network/crosstraffic",
798 "Activate the interferences between uploads and downloads for fluid max-min models (LV08, CM02)",
799 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb__surf_network_crosstraffic, NULL);
800 xbt_cfg_setdefault_boolean(_sg_cfg_set, "network/crosstraffic", "no");
803 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter",
804 "Double value to oscillate the link latency, uniformly in random interval [-latency*gtnets_jitter,latency*gtnets_jitter)",
805 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__gtnets_jitter, NULL);
806 xbt_cfg_setdefault_double(_sg_cfg_set, "gtnets/jitter", 0.0);
808 xbt_cfg_register(&_sg_cfg_set, "gtnets/jitter_seed",
809 "Use a positive seed to reproduce jitted results, value must be in [1,1e8], default is 10",
810 xbt_cfgelm_int, 0, 1, _sg_cfg_cb__gtnets_jitter_seed, NULL);
811 xbt_cfg_setdefault_int(_sg_cfg_set, "gtnets/jitter_seed", 10);
814 xbt_cfg_register(&_sg_cfg_set, "ns3/TcpModel",
815 "The ns3 tcp model can be : NewReno or Reno or Tahoe",
816 xbt_cfgelm_string, 1, 1, NULL, NULL);
817 xbt_cfg_setdefault_string(_sg_cfg_set, "ns3/TcpModel", "default");
820 //For smpi/bw_factor and smpi/lat_factor
821 //Default value have to be "threshold0:value0;threshold1:value1;...;thresholdN:valueN"
822 //test is if( size >= thresholdN ) return valueN;
823 //Values can be modified with command line --cfg=smpi/bw_factor:"threshold0:value0;threshold1:value1;...;thresholdN:valueN"
824 // or with tag config put line <prop id="smpi/bw_factor" value="threshold0:value0;threshold1:value1;...;thresholdN:valueN"></prop>
825 // SMPI model can be used without enable_smpi, so keep this the ifdef.
826 xbt_cfg_register(&_sg_cfg_set, "smpi/bw_factor",
827 "Bandwidth factors for smpi.",
828 xbt_cfgelm_string, 1, 1, NULL, NULL);
829 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");
831 xbt_cfg_register(&_sg_cfg_set, "smpi/lat_factor",
832 "Latency factors for smpi.",
833 xbt_cfgelm_string, 1, 1, NULL, NULL);
834 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");
836 xbt_cfg_register(&_sg_cfg_set, "smpi/IB_penalty_factors",
837 "Correction factor to communications using Infiniband model with contention (default value based on Stampede cluster profiling)",
838 xbt_cfgelm_string, 1, 1, NULL, NULL);
839 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/IB_penalty_factors", "0.965;0.925;1.35");
842 xbt_cfg_register(&_sg_cfg_set, "smpi/running_power",
843 "Power of the host running the simulation (in flop/s). Used to bench the operations.",
844 xbt_cfgelm_double, 1, 1, NULL, NULL);
845 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/running_power", 20000.0);
847 xbt_cfg_register(&_sg_cfg_set, "smpi/display_timing",
848 "Boolean indicating whether we should display the timing after simulation.",
849 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
850 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/display_timing", "no");
852 xbt_cfg_register(&_sg_cfg_set, "smpi/simulate_computation",
853 "Boolean indicating whether the computational part of the simulated application should be simulated.",
854 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
855 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/simulate_computation", "yes");
857 xbt_cfg_register(&_sg_cfg_set, "smpi/use_shared_malloc",
858 "Boolean indicating whether we should use shared memory when using SMPI_SHARED_MALLOC. Allows user to disable it for debug purposes.",
859 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
860 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/use_shared_malloc", "yes");
862 xbt_cfg_register(&_sg_cfg_set, "smpi/cpu_threshold",
863 "Minimal computation time (in seconds) not discarded, or -1 for infinity.",
864 xbt_cfgelm_double, 1, 1, NULL, NULL);
865 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/cpu_threshold", 1e-6);
867 xbt_cfg_register(&_sg_cfg_set, "smpi/async_small_thres",
868 "Maximal size of messages that are to be sent asynchronously, without waiting for the receiver",
869 xbt_cfgelm_int, 1, 1, NULL, NULL);
870 xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/async_small_thres", 0);
872 xbt_cfg_register(&_sg_cfg_set, "smpi/send_is_detached_thres",
873 "Threshold of message size where MPI_Send stops behaving like MPI_Isend and becomes MPI_Ssend",
874 xbt_cfgelm_int, 1, 1, NULL, NULL);
875 xbt_cfg_setdefault_int(_sg_cfg_set, "smpi/send_is_detached_thres", 65536);
877 xbt_cfg_register(&_sg_cfg_set, "smpi/privatize_global_variables",
878 "Boolean indicating whether we should privatize global variable at runtime.",
879 xbt_cfgelm_boolean, 1, 1, NULL, NULL);
880 xbt_cfg_setdefault_boolean(_sg_cfg_set, "smpi/privatize_global_variables", "no");
882 xbt_cfg_register(&_sg_cfg_set, "smpi/os",
883 "Small messages timings (MPI_Send minimum time for small messages)",
884 xbt_cfgelm_string, 1, 1, NULL, NULL);
885 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/os", "1:0:0:0:0");
887 xbt_cfg_register(&_sg_cfg_set, "smpi/ois",
888 "Small messages timings (MPI_Isend minimum time for small messages)",
889 xbt_cfgelm_string, 1, 1, NULL, NULL);
890 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/ois", "1:0:0:0:0");
892 xbt_cfg_register(&_sg_cfg_set, "smpi/or",
893 "Small messages timings (MPI_Recv minimum time for small messages)",
894 xbt_cfgelm_string, 1, 1, NULL, NULL);
895 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/or", "1:0:0:0:0");
897 xbt_cfg_register(&_sg_cfg_set, "smpi/iprobe",
898 "Minimum time to inject inside a call to MPI_Iprobe",
899 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__iprobe_sleep, NULL);
900 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/iprobe", 1e-4);
902 xbt_cfg_register(&_sg_cfg_set, "smpi/test",
903 "Minimum time to inject inside a call to MPI_Test",
904 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__test_sleep, NULL);
905 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/test", 1e-4);
907 xbt_cfg_register(&_sg_cfg_set, "smpi/wtime",
908 "Minimum time to inject inside a call to MPI_Wtime",
909 xbt_cfgelm_double, 1, 1, _sg_cfg_cb__wtime_sleep, NULL);
910 xbt_cfg_setdefault_double(_sg_cfg_set, "smpi/wtime", 0.0);
912 xbt_cfg_register(&_sg_cfg_set, "smpi/coll_selector",
913 "Which collective selector to use",
914 xbt_cfgelm_string, 1, 1, NULL, NULL);
915 xbt_cfg_setdefault_string(_sg_cfg_set, "smpi/coll_selector", "default");
917 xbt_cfg_register(&_sg_cfg_set, "smpi/gather",
918 "Which collective to use for gather",
919 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_gather, NULL);
921 xbt_cfg_register(&_sg_cfg_set, "smpi/allgather",
922 "Which collective to use for allgather",
923 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allgather, NULL);
925 xbt_cfg_register(&_sg_cfg_set, "smpi/barrier",
926 "Which collective to use for barrier",
927 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_barrier, NULL);
929 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce_scatter",
930 "Which collective to use for reduce_scatter",
931 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_reduce_scatter, NULL);
933 xbt_cfg_register(&_sg_cfg_set, "smpi/scatter",
934 "Which collective to use for scatter",
935 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_scatter, NULL);
937 xbt_cfg_register(&_sg_cfg_set, "smpi/allgatherv",
938 "Which collective to use for allgatherv",
939 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allgatherv, NULL);
941 xbt_cfg_register(&_sg_cfg_set, "smpi/allreduce",
942 "Which collective to use for allreduce",
943 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_allreduce, NULL);
945 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoall",
946 "Which collective to use for alltoall",
947 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_alltoall, NULL);
949 xbt_cfg_register(&_sg_cfg_set, "smpi/alltoallv",
950 "Which collective to use for alltoallv",
951 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_alltoallv, NULL);
953 xbt_cfg_register(&_sg_cfg_set, "smpi/bcast",
954 "Which collective to use for bcast",
955 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_bcast, NULL);
957 xbt_cfg_register(&_sg_cfg_set, "smpi/reduce",
958 "Which collective to use for reduce",
959 xbt_cfgelm_string, 0, 1, &_sg_cfg_cb__coll_reduce, NULL);
962 xbt_cfg_register(&_sg_cfg_set, "clean_atexit",
963 "\"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.",
964 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_clean_atexit, NULL);
965 xbt_cfg_setdefault_boolean(_sg_cfg_set, "clean_atexit", "yes");
968 /* retrieves the current directory of the current process */
969 const char *initial_path = __surf_get_initial_path();
970 xbt_assert((initial_path),
971 "__surf_get_initial_path() failed! Can't resolves current Windows directory");
973 surf_path = xbt_dynar_new(sizeof(char *), NULL);
974 xbt_cfg_setdefault_string(_sg_cfg_set, "path", initial_path);
977 xbt_cfg_check(_sg_cfg_set);
978 _sg_cfg_init_status = 1;
980 sg_config_cmd_line(argc, argv);
982 xbt_mallocator_initialization_is_done(SIMIX_context_is_parallel());
985 XBT_WARN("Call to sg_config_init() after initialization ignored");
989 void sg_config_finalize(void)
991 if (!_sg_cfg_init_status)
992 return; /* Not initialized yet. Nothing to do */
994 xbt_cfg_free(&_sg_cfg_set);
995 _sg_cfg_init_status = 0;
998 /* Pick the right models for CPU, net and workstation, and call their model_init_preparse */
999 void surf_config_models_setup()
1001 const char *workstation_model_name;
1002 const char *vm_workstation_model_name;
1003 int workstation_id = -1;
1004 int vm_workstation_id = -1;
1005 char *network_model_name = NULL;
1006 char *cpu_model_name = NULL;
1007 int storage_id = -1;
1008 char *storage_model_name = NULL;
1010 workstation_model_name =
1011 xbt_cfg_get_string(_sg_cfg_set, "workstation/model");
1012 vm_workstation_model_name =
1013 xbt_cfg_get_string(_sg_cfg_set, "vm_workstation/model");
1014 network_model_name = xbt_cfg_get_string(_sg_cfg_set, "network/model");
1015 cpu_model_name = xbt_cfg_get_string(_sg_cfg_set, "cpu/model");
1016 storage_model_name = xbt_cfg_get_string(_sg_cfg_set, "storage/model");
1018 /* Check whether we use a net/cpu model differing from the default ones, in which case
1019 * we should switch to the "compound" workstation model to correctly dispatch stuff to
1020 * the right net/cpu models.
1023 if ((!xbt_cfg_is_default_value(_sg_cfg_set, "network/model") ||
1024 !xbt_cfg_is_default_value(_sg_cfg_set, "cpu/model")) &&
1025 xbt_cfg_is_default_value(_sg_cfg_set, "workstation/model")) {
1026 XBT_INFO("Switching workstation model to compound since you changed the network and/or cpu model(s)");
1027 workstation_model_name = "compound";
1028 xbt_cfg_set_string(_sg_cfg_set, "workstation/model", workstation_model_name);
1031 XBT_DEBUG("Workstation model: %s", workstation_model_name);
1033 find_model_description(surf_workstation_model_description,
1034 workstation_model_name);
1035 if (!strcmp(workstation_model_name, "compound")) {
1036 int network_id = -1;
1039 xbt_assert(cpu_model_name,
1040 "Set a cpu model to use with the 'compound' workstation model");
1042 xbt_assert(network_model_name,
1043 "Set a network model to use with the 'compound' workstation model");
1045 if(surf_cpu_model_init_preparse){
1046 surf_cpu_model_init_preparse();
1049 find_model_description(surf_cpu_model_description, cpu_model_name);
1050 surf_cpu_model_description[cpu_id].model_init_preparse();
1054 find_model_description(surf_network_model_description,
1055 network_model_name);
1056 surf_network_model_description[network_id].model_init_preparse();
1059 XBT_DEBUG("Call workstation_model_init");
1060 surf_workstation_model_description[workstation_id].model_init_preparse();
1062 XBT_DEBUG("Call vm_workstation_model_init");
1063 vm_workstation_id = find_model_description(surf_vm_workstation_model_description,
1064 vm_workstation_model_name);
1065 surf_vm_workstation_model_description[vm_workstation_id].model_init_preparse();
1067 XBT_DEBUG("Call storage_model_init");
1068 storage_id = find_model_description(surf_storage_model_description, storage_model_name);
1069 surf_storage_model_description[storage_id].model_init_preparse();
1073 int sg_cfg_is_default_value(const char *name)
1075 return xbt_cfg_is_default_value(_sg_cfg_set, name);
1078 int sg_cfg_get_int(const char* name)
1080 return xbt_cfg_get_int(_sg_cfg_set, name);
1083 double sg_cfg_get_double(const char* name)
1085 return xbt_cfg_get_double(_sg_cfg_set, name);
1088 char* sg_cfg_get_string(const char* name)
1090 return xbt_cfg_get_string(_sg_cfg_set, name);
1093 int sg_cfg_get_boolean(const char* name)
1095 return xbt_cfg_get_boolean(_sg_cfg_set, name);
1098 void sg_cfg_get_peer(const char *name, char **peer, int *port)
1100 xbt_cfg_get_peer(_sg_cfg_set, name, peer, port);
1103 xbt_dynar_t sg_cfg_get_dynar(const char* name)
1105 return xbt_cfg_get_dynar(_sg_cfg_set, name);