1 /* Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011. 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 #include "surf_private.h"
8 #include "xbt/module.h"
10 #include "simix/smx_host_private.h"
11 #include "surf/surf_resource.h"
12 #include "xbt/xbt_os_thread.h"
13 #include "simgrid/sg_config.h"
17 XBT_LOG_NEW_CATEGORY(surf, "All SURF categories");
18 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(surf_kernel, surf,
19 "Logging specific to SURF (kernel)");
21 /* Additional declarations for Windows portability. */
29 static const char *disk_drives_letter_table[MAX_DRIVE] = {
57 #endif /* #ifdef _XBT_WIN32 */
60 * Returns the initial path. On Windows the initial path is
61 * the current directory for the current process in the other
62 * case the function returns "./" that represents the current
63 * directory on Unix/Linux platforms.
66 const char *__surf_get_initial_path(void)
71 char current_directory[MAX_PATH + 1] = { 0 };
72 unsigned int len = GetCurrentDirectory(MAX_PATH + 1, current_directory);
78 strncpy(root, current_directory, 3);
80 for (i = 0; i < MAX_DRIVE; i++) {
81 if (toupper(root[0]) == disk_drives_letter_table[i][0])
82 return disk_drives_letter_table[i];
91 /* The __surf_is_absolute_file_path() returns 1 if
92 * file_path is a absolute file path, in the other
93 * case the function returns 0.
95 int __surf_is_absolute_file_path(const char *file_path)
98 WIN32_FIND_DATA wfd = { 0 };
99 HANDLE hFile = FindFirstFile(file_path, &wfd);
101 if (INVALID_HANDLE_VALUE == hFile)
107 return (file_path[0] == '/');
113 xbt_dynar_t model_list = NULL;
114 tmgr_history_t history = NULL;
115 lmm_system_t maxmin_system = NULL;
116 xbt_dynar_t surf_path = NULL;
117 xbt_dict_t watched_hosts_lib;
119 /* Don't forget to update the option description in smx_config when you change this */
120 s_surf_model_description_t surf_network_model_description[] = {
122 "Realistic network analytic model (slow-start modeled by multiplying latency by 10.4, bandwidth by .92; bottleneck sharing uses a payload of S=8775 for evaluating RTT). ",
123 surf_network_model_init_LegrandVelho},
125 "Simplistic network model where all communication take a constant time (one second). This model provides the lowest realism, but is (marginally) faster.",
126 surf_network_model_init_Constant},
128 "Realistic network model specifically tailored for HPC settings (accurate modeling of slow start with correction factors on three intervals: < 1KiB, < 64 KiB, >= 64 KiB)",
129 surf_network_model_init_SMPI},
131 "Legacy network analytic model (Very similar to LV08, but without corrective factors. The timings of small messages are thus poorly modeled).",
132 surf_network_model_init_CM02},
135 "Network pseudo-model using the GTNets simulator instead of an analytic model",
136 surf_network_model_init_GTNETS},
140 "Network pseudo-model using the NS3 tcp model instead of an analytic model",
141 surf_network_model_init_NS3},
144 "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
145 surf_network_model_init_Reno},
147 "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
148 surf_network_model_init_Reno2},
150 "Model from Steven H. Low using lagrange_solve instead of lmm_solve (experts only; check the code for more info).",
151 surf_network_model_init_Vegas},
152 {NULL, NULL, NULL} /* this array must be NULL terminated */
155 s_surf_model_description_t surf_cpu_model_description[] = {
157 "Simplistic CPU model (time=size/power).",
158 surf_cpu_model_init_Cas01},
159 {NULL, NULL, NULL} /* this array must be NULL terminated */
162 s_surf_model_description_t surf_workstation_model_description[] = {
164 "Default workstation model. Currently, CPU:Cas01 and network:LV08 (with cross traffic enabled)",
165 surf_workstation_model_init_current_default},
167 "Workstation model that is automatically chosen if you change the network and CPU models",
168 surf_workstation_model_init_compound},
169 {"ptask_L07", "Workstation model somehow similar to Cas01+CM02 but allowing parallel tasks",
170 surf_workstation_model_init_ptask_L07},
171 {NULL, NULL, NULL} /* this array must be NULL terminated */
174 s_surf_model_description_t surf_optimization_mode_description[] = {
176 "Lazy action management (partial invalidation in lmm + heap in action remaining).",
179 "Trace integration. Highly optimized mode when using availability traces (only available for the Cas01 CPU model for now).",
182 "Full update of remaining and variables. Slow but may be useful when debugging.",
184 {NULL, NULL, NULL} /* this array must be NULL terminated */
187 s_surf_model_description_t surf_storage_model_description[] = {
189 "Simplistic storage model.",
190 surf_storage_model_init_default},
191 {NULL, NULL, NULL} /* this array must be NULL terminated */
194 /* ********************************************************************* */
195 /* TUTORIAL: New model */
196 s_surf_model_description_t surf_new_model_description[] = {
199 surf_new_model_init_default},
200 {NULL, NULL, NULL} /* this array must be NULL terminated */
202 /* ********************************************************************* */
204 #ifdef CONTEXT_THREADS
205 static xbt_parmap_t surf_parmap = NULL; /* parallel map on models */
208 static double *surf_mins = NULL; /* return value of share_resources for each model */
209 static int surf_min_index; /* current index in surf_mins */
210 static double min; /* duration determined by surf_solve */
212 static void surf_share_resources(surf_model_t model);
213 static void surf_update_actions_state(surf_model_t model);
215 /** Displays the long description of all registered models, and quit */
216 void model_help(const char *category, s_surf_model_description_t * table)
219 printf("Long description of the %s models accepted by this simulator:\n",
221 for (i = 0; table[i].name; i++)
222 printf(" %s: %s\n", table[i].name, table[i].description);
225 int find_model_description(s_surf_model_description_t * table,
229 char *name_list = NULL;
231 for (i = 0; table[i].name; i++)
232 if (!strcmp(name, table[i].name)) {
235 name_list = strdup(table[0].name);
236 for (i = 1; table[i].name; i++) {
238 xbt_realloc(name_list,
239 strlen(name_list) + strlen(table[i].name) + 3);
240 strcat(name_list, ", ");
241 strcat(name_list, table[i].name);
243 xbt_die("Model '%s' is invalid! Valid models are: %s.", name, name_list);
247 double generic_maxmin_share_resources(xbt_swag_t running_actions,
250 void (*solve) (lmm_system_t))
252 surf_action_t action = NULL;
255 #define VARIABLE(action) (*((lmm_variable_t*)(((char *) (action)) + (offset))))
259 xbt_swag_foreach(action, running_actions) {
260 value = lmm_variable_getvalue(VARIABLE(action));
261 if ((value > 0) || (action->max_duration >= 0))
269 if (action->remains > 0)
270 min = action->remains / value;
273 if ((action->max_duration >= 0) && (action->max_duration < min))
274 min = action->max_duration;
276 min = action->max_duration;
279 for (action = xbt_swag_getNext(action, running_actions->offset);
281 action = xbt_swag_getNext(action, running_actions->offset)) {
282 value = lmm_variable_getvalue(VARIABLE(action));
284 if (action->remains > 0)
285 value = action->remains / value;
290 XBT_DEBUG("Updating min (value) with %p: %f", action, min);
293 if ((action->max_duration >= 0) && (action->max_duration < min)) {
294 min = action->max_duration;
295 XBT_DEBUG("Updating min (duration) with %p: %f", action, min);
298 XBT_DEBUG("min value : %f", min);
304 double generic_share_resources_lazy(double now, surf_model_t model)
306 surf_action_lmm_t action = NULL;
311 ("Before share resources, the size of modified actions set is %d",
312 xbt_swag_size(model->model_private->modified_set));
314 lmm_solve(model->model_private->maxmin_system);
317 ("After share resources, The size of modified actions set is %d",
318 xbt_swag_size(model->model_private->modified_set));
320 while((action = xbt_swag_extract(model->model_private->modified_set))) {
321 int max_dur_flag = 0;
323 if (action->generic_action.state_set !=
324 model->states.running_action_set)
327 /* bogus priority, skip it */
328 if (action->generic_action.priority <= 0)
331 generic_update_action_remaining_lazy(action,now);
334 value = lmm_variable_getvalue(action->variable);
336 if (action->generic_action.remains > 0) {
337 value = action->generic_action.remains / value;
345 if ((action->generic_action.max_duration != NO_MAX_DURATION)
347 || action->generic_action.start +
348 action->generic_action.max_duration < min)) {
349 min = action->generic_action.start +
350 action->generic_action.max_duration;
354 XBT_DEBUG("Action(%p) Start %lf Finish %lf Max_duration %lf", action,
355 action->generic_action.start, now + value,
356 action->generic_action.max_duration);
359 surf_action_lmm_heap_remove(model->model_private->action_heap,action);
360 surf_action_lmm_heap_insert(model->model_private->action_heap,action, min, max_dur_flag ? MAX_DURATION : NORMAL);
361 XBT_DEBUG("Insert at heap action(%p) min %lf now %lf", action, min,
363 } else DIE_IMPOSSIBLE;
366 //hereafter must have already the min value for this resource model
367 if (xbt_heap_size(model->model_private->action_heap) > 0)
368 min = xbt_heap_maxkey(model->model_private->action_heap) - now;
372 XBT_DEBUG("The minimum with the HEAP %lf", min);
376 static XBT_INLINE void routing_asr_host_free(void *p)
378 sg_routing_edge_t elm = p;
383 static XBT_INLINE void routing_asr_prop_free(void *p)
389 void sg_version(int *ver_major,int *ver_minor,int *ver_patch) {
390 *ver_major = SIMGRID_VERSION_MAJOR;
391 *ver_minor = SIMGRID_VERSION_MINOR;
392 *ver_patch = SIMGRID_VERSION_PATCH;
395 void surf_init(int *argc, char **argv)
397 XBT_DEBUG("Create all Libs");
398 host_lib = xbt_lib_new();
399 link_lib = xbt_lib_new();
400 as_router_lib = xbt_lib_new();
401 storage_lib = xbt_lib_new();
402 storage_type_lib = xbt_lib_new();
403 watched_hosts_lib = xbt_dict_new();
405 XBT_DEBUG("Add routing levels");
406 ROUTING_HOST_LEVEL = xbt_lib_add_level(host_lib,routing_asr_host_free);
407 ROUTING_ASR_LEVEL = xbt_lib_add_level(as_router_lib,routing_asr_host_free);
408 ROUTING_PROP_ASR_LEVEL = xbt_lib_add_level(as_router_lib,routing_asr_prop_free);
410 XBT_DEBUG("Add SURF levels");
411 SURF_CPU_LEVEL = xbt_lib_add_level(host_lib,surf_resource_free);
412 SURF_WKS_LEVEL = xbt_lib_add_level(host_lib,surf_resource_free);
413 SURF_LINK_LEVEL = xbt_lib_add_level(link_lib,surf_resource_free);
415 xbt_init(argc, argv);
417 model_list = xbt_dynar_new(sizeof(surf_model_private_t), NULL);
419 history = tmgr_history_new();
422 TRACE_add_start_function(TRACE_surf_alloc);
423 TRACE_add_end_function(TRACE_surf_release);
426 sg_config_init(argc, argv);
434 # define FILE_DELIM "\\"
436 # define FILE_DELIM "/" /* FIXME: move to better location */
439 FILE *surf_fopen(const char *name, const char *mode)
442 char *path_elm = NULL;
448 if (__surf_is_absolute_file_path(name)) /* don't mess with absolute file names */
449 return fopen(name, mode);
451 /* search relative files in the path */
452 xbt_dynar_foreach(surf_path, cpt, path_elm) {
453 buff = bprintf("%s" FILE_DELIM "%s", path_elm, name);
454 file = fopen(buff, mode);
466 surf_model_t model = NULL;
468 sg_config_finalize();
470 xbt_dynar_foreach(model_list, iter, model)
471 model->model_private->finalize();
472 xbt_dynar_free(&model_list);
476 lmm_system_free(maxmin_system);
477 maxmin_system = NULL;
480 tmgr_history_free(history);
485 #ifdef CONTEXT_THREADS
486 xbt_parmap_destroy(surf_parmap);
491 xbt_dynar_free(&surf_path);
493 xbt_lib_free(&host_lib);
494 xbt_lib_free(&link_lib);
495 xbt_lib_free(&as_router_lib);
496 xbt_lib_free(&storage_lib);
497 xbt_lib_free(&storage_type_lib);
499 xbt_dict_free(&watched_hosts_lib);
502 surf_parse_lex_destroy();
503 surf_parse_free_callbacks();
505 NOW = 0; /* Just in case the user plans to restart the simulation afterward */
508 void surf_presolve(void)
510 double next_event_date = -1.0;
511 tmgr_trace_event_t event = NULL;
513 surf_resource_t resource = NULL;
514 surf_model_t model = NULL;
518 ("First Run! Let's \"purge\" events and put models in the right state");
519 while ((next_event_date = tmgr_history_next_date(history)) != -1.0) {
520 if (next_event_date > NOW)
523 tmgr_history_get_next_event_leq(history, next_event_date,
525 (void **) &resource))) {
527 resource->model->model_private->update_resource_state(resource,
533 xbt_dynar_foreach(model_list, iter, model)
534 model->model_private->update_actions_state(NOW, 0.0);
537 double surf_solve(double max_date)
539 min = -1.0; /* duration */
540 double next_event_date = -1.0;
541 double model_next_action_end = -1.0;
543 surf_resource_t resource = NULL;
544 surf_model_t model = NULL;
545 tmgr_trace_event_t event = NULL;
548 if (max_date != -1.0 && max_date != NOW) {
549 min = max_date - NOW;
552 XBT_DEBUG("Looking for next action end for all models except NS3");
554 if (surf_mins == NULL) {
555 surf_mins = xbt_new(double, xbt_dynar_length(model_list));
559 /* sequential version */
560 xbt_dynar_foreach(model_list, iter, model) {
561 surf_share_resources(model);
565 for (i = 0; i < xbt_dynar_length(model_list); i++) {
566 if ((min < 0.0 || surf_mins[i] < min)
567 && surf_mins[i] >= 0.0) {
572 XBT_DEBUG("Min for resources (remember that NS3 don't update that value) : %f", min);
574 XBT_DEBUG("Looking for next trace event");
577 XBT_DEBUG("Next TRACE event : %f", next_event_date);
579 next_event_date = tmgr_history_next_date(history);
581 if(surf_network_model->name && !strcmp(surf_network_model->name,"network NS3")){
582 if(next_event_date!=-1.0 && min!=-1.0) {
583 min = MIN(next_event_date - NOW, min);
585 min = MAX(next_event_date - NOW, min);
588 XBT_DEBUG("Run for network at most %f", min);
589 // run until min or next flow
590 model_next_action_end = surf_network_model->model_private->share_resources(min);
592 XBT_DEBUG("Min for network : %f", model_next_action_end);
593 if(model_next_action_end>=0.0)
594 min = model_next_action_end;
597 if (next_event_date < 0.0) {
598 XBT_DEBUG("no next TRACE event. Stop searching for it");
602 if ((min == -1.0) || (next_event_date > NOW + min)) break;
604 XBT_DEBUG("Updating models (min = %g, NOW = %g, next_event_date = %g)",min, NOW, next_event_date);
606 tmgr_history_get_next_event_leq(history, next_event_date,
608 (void **) &resource))) {
609 if (resource->model->model_private->resource_used(resource)) {
610 min = next_event_date - NOW;
612 ("This event will modify model state. Next event set to %f",
615 /* update state of model_obj according to new value. Does not touch lmm.
616 It will be modified if needed when updating actions */
617 XBT_DEBUG("Calling update_resource_state for resource %s with min %lf",
618 resource->model->name, min);
619 resource->model->model_private->update_resource_state(resource,
625 /* FIXME: Moved this test to here to avoid stopping simulation if there are actions running on cpus and all cpus are with availability = 0.
626 * This may cause an infinite loop if one cpu has a trace with periodicity = 0 and the other a trace with periodicity > 0.
627 * The options are: all traces with same periodicity(0 or >0) or we need to change the way how the events are managed */
629 XBT_DEBUG("No next event at all. Bail out now.");
633 XBT_DEBUG("Duration set to %f", min);
637 /* sequential version */
638 xbt_dynar_foreach(model_list, iter, model) {
639 surf_update_actions_state(model);
643 TRACE_paje_dump_buffer (0);
649 XBT_INLINE double surf_get_clock(void)
654 static void surf_share_resources(surf_model_t model)
656 double next_action_end = -1.0;
657 int i = __sync_fetch_and_add(&surf_min_index, 1);
658 if (strcmp(model->name,"network NS3")) {
659 XBT_DEBUG("Running for Resource [%s]", model->name);
660 next_action_end = model->model_private->share_resources(NOW);
661 XBT_DEBUG("Resource [%s] : next action end = %f",
662 model->name, next_action_end);
664 surf_mins[i] = next_action_end;
667 static void surf_update_actions_state(surf_model_t model)
669 model->model_private->update_actions_state(NOW, min);
673 /* This function is a pimple that we ought to fix. But it won't be easy.
675 * The surf_solve() function does properly return the set of actions that changed.
676 * Instead, each model change a global data, and then the caller of surf_solve must
677 * pick into these sets of action_failed and action_done.
679 * This was not clean but ok as long as we didn't had to restart the processes when the resource comes back up.
680 * We worked by putting sentinel actions on every resources we are interested in,
681 * so that surf informs us if/when the corresponding resource fails.
683 * But this does not work to get Simix informed of when a resource comes back up, and this is where this pimple comes.
684 * We have a set of resources that are currently down and for which simix needs to know when it comes back up.
685 * And the current function is called *at every simulation step* to sweep over that set, searching for a resource
686 * that was turned back up in the meanwhile. This is UGLY and slow.
688 * The proper solution would be to not rely on globals for the action_failed and action_done swags.
689 * They must be passed as parameter by the caller (the handling of these actions in simix may let you
690 * think that these two sets can be merged, but their handling in SimDag induce the contrary unless this
691 * simdag code can check by itself whether the action is done of failed -- seems very doable, but yet more
694 * Once surf_solve() is passed the set of actions that changed, you want to add a new set of resources back up
695 * as parameter to this function. You also want to add a boolean field "restart_watched" to each resource, and
696 * make sure that whenever a resource with this field enabled comes back up, it's added to that set so that Simix
697 * sees it and react accordingly. This would kill that need for surf to call simix.
701 static void remove_watched_host(void *key)
703 xbt_dict_remove(watched_hosts_lib, *(char**)key);
706 void surf_watched_hosts(void)
710 xbt_dict_cursor_t cursor;
711 xbt_dynar_t hosts = xbt_dynar_new(sizeof(char*), NULL);
713 XBT_DEBUG("Check for host SURF_RESOURCE_ON on watched_hosts_lib");
714 xbt_dict_foreach(watched_hosts_lib,cursor,key,host)
716 if(SIMIX_host_get_state(host) == SURF_RESOURCE_ON){
717 XBT_INFO("Restart processes on host: %s",SIMIX_host_get_name(host));
718 SIMIX_host_autorestart(host);
719 xbt_dynar_push_as(hosts, char*, key);
722 XBT_DEBUG("See SURF_RESOURCE_OFF on host: %s",key);
724 xbt_dynar_map(hosts, remove_watched_host);
725 xbt_dynar_free(&hosts);