/* Don't forget to update the option description in smx_config when you change this */
s_surf_model_description_t surf_network_model_description[] = {
- {"Constant", NULL, surf_network_model_init_Constant},
- {"CM02", NULL, surf_network_model_init_CM02},
- {"LV08", NULL, surf_network_model_init_LegrandVelho},
+ {"Constant", "Simplistic network model where all communication take a constant time (one second)", NULL, surf_network_model_init_Constant},
+ {"CM02", "Realistic network model with lmm_solve and no correction factors", NULL, surf_network_model_init_CM02},
+ {"LV08", "Realistic network model with lmm_solve and these correction factors: latency*=10.4, bandwidth*=.92, S=8775" , NULL, surf_network_model_init_LegrandVelho},
#ifdef HAVE_GTNETS
- {"GTNets", NULL, surf_network_model_init_GTNETS},
+ {"GTNets", "Network Pseudo-model using the GTNets simulator instead of an analytic model", NULL, surf_network_model_init_GTNETS},
#endif
- {"Reno", NULL, surf_network_model_init_Reno},
- {"Reno2", NULL, surf_network_model_init_Reno2},
- {"Vegas", NULL, surf_network_model_init_Vegas},
- {NULL, NULL, NULL} /* this array must be NULL terminated */
+ {"Reno", "Model using lagrange_solve instead of lmm_solve (experts only)", NULL, surf_network_model_init_Reno},
+ {"Reno2", "Model using lagrange_solve instead of lmm_solve (experts only)", NULL, surf_network_model_init_Reno2},
+ {"Vegas", "Model using lagrange_solve instead of lmm_solve (experts only)", NULL, surf_network_model_init_Vegas},
+ {NULL, NULL, NULL, NULL} /* this array must be NULL terminated */
};
s_surf_model_description_t surf_cpu_model_description[] = {
- {"Cas01_fullupdate", NULL, surf_cpu_model_init_Cas01},
- {"Cas01", NULL, surf_cpu_model_init_Cas01_im},
- {"CpuTI", NULL, surf_cpu_model_init_ti},
- {NULL, NULL, NULL} /* this array must be NULL terminated */
+ {"Cas01_fullupdate", "CPU classical model time=size/power", NULL, surf_cpu_model_init_Cas01},
+ {"Cas01", "Variation of Cas01_fullupdate with partial invalidation optimization of lmm system. Should produce the same values, only faster", NULL, surf_cpu_model_init_Cas01_im},
+ {"CpuTI", "Variation of Cas01 with also trace integration. Should produce the same values, only faster if you use availability traces", NULL, surf_cpu_model_init_ti},
+ {NULL, NULL, NULL, NULL} /* this array must be NULL terminated */
};
s_surf_model_description_t surf_workstation_model_description[] = {
- {"CLM03", NULL, surf_workstation_model_init_CLM03, create_workstations},
- {"compound", NULL, surf_workstation_model_init_compound,
- create_workstations},
- {"ptask_L07", NULL, surf_workstation_model_init_ptask_L07, NULL},
- {NULL, NULL, NULL} /* this array must be NULL terminated */
+ {"CLM03", "Default workstation model, using LV08 and CM02 as network and CPU", NULL, surf_workstation_model_init_CLM03, create_workstations},
+ {"compound", "Workstation model allowing you to use other network and CPU models", NULL, surf_workstation_model_init_compound, create_workstations},
+ {"ptask_L07", "Workstation model with better parallel task modeling", NULL, surf_workstation_model_init_ptask_L07, NULL},
+ {NULL, NULL, NULL, NULL} /* this array must be NULL terminated */
};
void update_model_description(s_surf_model_description_t * table,
table[i].model = model;
}
+/** Displays the long description of all registered models, and quit */
+void model_help(const char* category, s_surf_model_description_t * table) {
+ int i;
+ printf("Long description of the %s models accepted by this simulator:\n",category);
+ for (i = 0; table[i].name; i++)
+ printf(" %s: %s\n", table[i].name, table[i].description);
+ exit(0);
+}
+
int find_model_description(s_surf_model_description_t * table,
const char *name)
{
remove_it = 1;
} else if (!strncmp(argv[i], "--cfg-help", strlen("--cfg-help") + 1) ||
!strncmp(argv[i], "--help", strlen("--help") + 1)) {
- printf
- ("Description of the configuration accepted by this simulator:\n");
+ printf("Description of the configuration accepted by this simulator:\n");
xbt_cfg_help(_surf_cfg_set);
remove_it = 1;
exit(0);
"Cannot change the model after the initialization");
val = xbt_cfg_get_string(_surf_cfg_set, name);
- /* New Module missing */
+ if (!strcmp(val,"help"))
+ model_help("workstation",surf_workstation_model_description);
+
+ /* Make sure that the model exists */
find_model_description(surf_workstation_model_description, val);
}
"Cannot change the model after the initialization");
val = xbt_cfg_get_string(_surf_cfg_set, name);
+
+ if (!strcmp(val,"help"))
+ model_help("CPU",surf_cpu_model_description);
+
/* New Module missing */
find_model_description(surf_cpu_model_description, val);
}
"Cannot change the model after the initialization");
val = xbt_cfg_get_string(_surf_cfg_set, name);
+
+ if (!strcmp(val,"help"))
+ model_help("network",surf_network_model_description);
+
/* New Module missing */
find_model_description(surf_network_model_description, val);
}
p +=
sprintf(p, "%s%s", (i == 0 ? "" : ", "),
surf_cpu_model_description[i].name);
+ sprintf(p,".\n (use 'help' as a value to see the long description of each model)");
default_value = xbt_strdup("Cas01");
xbt_cfg_register(&_surf_cfg_set,
"cpu/model", description, xbt_cfgelm_string,
p +=
sprintf(p, "%s%s", (i == 0 ? "" : ", "),
surf_network_model_description[i].name);
+ sprintf(p,".\n (use 'help' as a value to see the long description of each model)");
default_value = xbt_strdup("LV08");
xbt_cfg_register(&_surf_cfg_set,
"network/model", description, xbt_cfgelm_string,
p +=
sprintf(p, "%s%s", (i == 0 ? "" : ", "),
surf_workstation_model_description[i].name);
+ sprintf(p,".\n (use 'help' as a value to see the long description of each model)");
default_value = xbt_strdup("CLM03");
xbt_cfg_register(&_surf_cfg_set,
"workstation/model", description, xbt_cfgelm_string,
surf_config_cmd_line(argc, argv);
+ } else {
+ WARN0("Call to surf_config_init() after initialization ignored");
}
}