3 /* Copyright (c) 2007 Arnaud Legrand, Bruno Donassolo.
4 All rights reserved. */
6 /* This program is free software; you can redistribute it and/or modify it
7 * under the terms of the license (GNU LGPL) which comes with this package. */
10 #include "xbt/sysdep.h"
13 #include "xbt/ex.h" /* ex_backtrace_display */
14 XBT_LOG_EXTERNAL_CATEGORY(simix);
15 XBT_LOG_EXTERNAL_CATEGORY(simix_action);
16 XBT_LOG_EXTERNAL_CATEGORY(simix_deployment);
17 XBT_LOG_EXTERNAL_CATEGORY(simix_environment);
18 XBT_LOG_EXTERNAL_CATEGORY(simix_host);
19 XBT_LOG_EXTERNAL_CATEGORY(simix_process);
20 XBT_LOG_EXTERNAL_CATEGORY(simix_synchro);
21 XBT_LOG_EXTERNAL_CATEGORY(simix_context);
22 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(simix_kernel, simix,
23 "Logging specific to SIMIX (kernel)");
25 SIMIX_Global_t simix_global = NULL;
28 /* FIXME: Yeah, I'll do it in a portable maner one day [Mt] */
31 static void _XBT_CALL inthandler(int ignored)
33 INFO0("CTRL-C pressed. Displaying status and bailing out");
34 SIMIX_display_process_status();
38 /********************************* SIMIX **************************************/
41 * \brief Initialize SIMIX internal data.
46 void SIMIX_global_init(int *argc, char **argv)
51 /* Connect our log channels: that must be done manually under windows */
52 XBT_LOG_CONNECT(simix_action, simix);
53 XBT_LOG_CONNECT(simix_deployment, simix);
54 XBT_LOG_CONNECT(simix_environment, simix);
55 XBT_LOG_CONNECT(simix_host, simix);
56 XBT_LOG_CONNECT(simix_kernel, simix);
57 XBT_LOG_CONNECT(simix_process, simix);
58 XBT_LOG_CONNECT(simix_synchro, simix);
59 XBT_LOG_CONNECT(simix_context, simix);
61 simix_global = xbt_new0(s_SIMIX_Global_t, 1);
63 simix_global->host = xbt_dict_new();
64 simix_global->process_to_run =
65 xbt_swag_new(xbt_swag_offset(proc, synchro_hookup));
66 simix_global->process_list =
67 xbt_swag_new(xbt_swag_offset(proc, process_hookup));
68 simix_global->process_to_destroy =
69 xbt_swag_new(xbt_swag_offset(proc, destroy_hookup));
71 simix_global->current_process = NULL;
72 simix_global->maestro_process = NULL;
73 simix_global->registered_functions = xbt_dict_new();
75 simix_global->create_process_function = NULL;
76 simix_global->kill_process_function = NULL;
77 simix_global->cleanup_process_function = SIMIX_process_cleanup;
79 SIMIX_context_mod_init();
80 SIMIX_create_maestro_process();
82 /* context exception handlers */
83 __xbt_ex_ctx = SIMIX_process_get_exception;
84 __xbt_ex_terminate = SIMIX_process_exception_terminate;
87 /* Prepare to display some more info when dying on Ctrl-C pressing */
88 signal(SIGINT, inthandler);
89 surf_init(argc, argv); /* Initialize SURF structures */
93 /* Debug purpose, incomplete */
94 void SIMIX_display_process_status(void)
96 smx_process_t process = NULL;
97 xbt_fifo_item_t item = NULL;
99 int nbprocess = xbt_swag_size(simix_global->process_list);
101 INFO1("%d processes are still running, waiting for something.", nbprocess);
102 /* List the process and their state */
104 ("Legend of the following listing: \"<process> on <host>: <status>.\"");
105 xbt_swag_foreach(process, simix_global->process_list) {
108 asprintf(&who, "%s on %s: %s",
110 process->smx_host->name,
111 (process->blocked) ? "[BLOCKED] "
112 : ((process->suspended) ? "[SUSPENDED] " : ""));
114 if (process->mutex) {
116 bprintf("%s Blocked on mutex %p", who,
117 (XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_verbose)) ?
118 process->mutex : (void *) 0xdead);
121 } else if (process->cond) {
124 ("%s Blocked on condition %p; Waiting for the following actions:",
126 (XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_verbose)) ?
127 process->cond : (void *) 0xdead);
130 xbt_fifo_foreach(process->cond->actions, item, act, smx_action_t) {
132 bprintf("%s '%s'(%p)", who, act->name,
133 (XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_verbose))
134 ? act : (void *) 0xdead);
138 } else if (process->sem) {
141 ("%s Blocked on semaphore %p; Waiting for the following actions:",
143 (XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_verbose)) ?
144 process->sem : (void *) 0xdead);
147 xbt_fifo_foreach(process->sem->actions, item, act, smx_action_t) {
149 bprintf("%s '%s'(%p)", who, act->name,
150 (XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_verbose))
151 ? act : (void *) 0xdead);
159 ("%s Blocked in an unknown status (please report this bug)", who);
170 * \brief Launch the SIMIX simulation, debug purpose
172 void __SIMIX_main(void)
174 smx_process_t process = NULL;
175 smx_cond_t cond = NULL;
176 smx_action_t smx_action;
177 xbt_fifo_t actions_done = xbt_fifo_new();
178 xbt_fifo_t actions_failed = xbt_fifo_new();
180 /* Clean IO before the run */
184 //surf_solve(); /* Takes traces into account. Returns 0.0 */
185 /* xbt_fifo_size(msg_global->process_to_run) */
187 while (SIMIX_solve(actions_done, actions_failed) != -1.0) {
189 while ((smx_action = xbt_fifo_pop(actions_failed))) {
191 xbt_fifo_item_t _cursor;
193 DEBUG1("** %s failed **", smx_action->name);
194 xbt_fifo_foreach(smx_action->cond_list, _cursor, cond, smx_cond_t) {
195 xbt_swag_foreach(process, cond->sleeping) {
196 DEBUG2("\t preparing to wake up %s on %s",
197 process->name, process->smx_host->name);
199 SIMIX_cond_broadcast(cond);
200 /* remove conditional from action */
201 SIMIX_unregister_action_to_condition(smx_action, cond);
205 while ((smx_action = xbt_fifo_pop(actions_done))) {
206 xbt_fifo_item_t _cursor;
208 DEBUG1("** %s done **", smx_action->name);
209 xbt_fifo_foreach(smx_action->cond_list, _cursor, cond, smx_cond_t) {
210 xbt_swag_foreach(process, cond->sleeping) {
211 DEBUG2("\t preparing to wake up %s on %s",
212 process->name, process->smx_host->name);
214 SIMIX_cond_broadcast(cond);
215 /* remove conditional from action */
216 SIMIX_unregister_action_to_condition(smx_action, cond);
224 * \brief Kill all running process
225 * Only maestro can kill everyone :)
227 void SIMIX_process_killall()
229 smx_process_t p = NULL;
230 xbt_assert0((simix_global->current_process ==
231 simix_global->maestro_process),
232 "You are not supposed to run this function here!");
234 while ((p = xbt_swag_extract(simix_global->process_list)))
235 SIMIX_process_kill(p);
237 SIMIX_process_empty_trash();
243 * \brief Clean the SIMIX simulation
245 * This functions remove the memory used by SIMIX
247 void SIMIX_clean(void)
249 /* Kill everyone (except maestro) */
250 SIMIX_process_killall();
252 /* Free the remaining data structures */
253 xbt_swag_free(simix_global->process_to_run);
254 xbt_swag_free(simix_global->process_to_destroy);
255 xbt_swag_free(simix_global->process_list);
256 simix_global->process_list = NULL;
257 simix_global->process_to_destroy = NULL;
258 xbt_dict_free(&(simix_global->registered_functions));
259 xbt_dict_free(&(simix_global->host));
261 /* Let's free maestro now */
262 SIMIX_context_free(simix_global->maestro_process->context);
263 xbt_free(simix_global->maestro_process->exception);
264 xbt_free(simix_global->maestro_process);
265 simix_global->maestro_process = NULL;
267 /* Restore the default exception setup */
268 __xbt_ex_ctx = &__xbt_ex_ctx_default;
269 __xbt_ex_terminate = &__xbt_ex_terminate_default;
271 /* Finish context module and SURF */
272 SIMIX_context_mod_exit();
276 xbt_free(simix_global);
284 * \brief A clock (in second).
286 * \return Return the clock.
288 XBT_INLINE double SIMIX_get_clock(void)
290 return surf_get_clock();
294 * \brief Finish the simulation initialization
296 * Must be called before the first call to SIMIX_solve()
298 XBT_INLINE void SIMIX_init(void)
304 * \brief Does a turn of the simulation
306 * Executes a step in the surf simulation, adding to the two lists all the actions that finished on this turn. Schedules all processus in the process_to_run list.
307 * \param actions_done List of actions done
308 * \param actions_failed List of actions failed
309 * \return The time spent to execute the simulation or -1 if the simulation ended
311 double SIMIX_solve(xbt_fifo_t actions_done, xbt_fifo_t actions_failed)
314 smx_process_t process = NULL;
316 double elapsed_time = 0.0;
317 static int state_modifications = 1;
318 int actions_on_system = 0;
320 SIMIX_process_empty_trash();
321 if (XBT_LOG_ISENABLED(simix_kernel,xbt_log_priority_debug) &&
322 xbt_swag_size(simix_global->process_to_run) && (elapsed_time > 0)) {
323 DEBUG0("**************************************************");
326 while ((process = xbt_swag_extract(simix_global->process_to_run))) {
327 DEBUG2("Scheduling %s on %s", process->name, process->smx_host->name);
328 SIMIX_process_schedule(process);
332 surf_action_t action = NULL;
333 surf_model_t model = NULL;
334 smx_action_t smx_action = NULL;
339 xbt_dynar_foreach(model_list, iter, model) {
340 if (xbt_swag_size(model->states.failed_action_set)
341 || xbt_swag_size(model->states.done_action_set)) {
342 state_modifications = 1;
345 if (xbt_swag_size(model->states.running_action_set)
346 || xbt_swag_size(model->states.ready_action_set)) {
347 actions_on_system = 1;
350 /* only calls surf_solve if there are actions to run */
351 if (!state_modifications && actions_on_system) {
352 DEBUG1("%f : Calling surf_solve", SIMIX_get_clock());
353 elapsed_time = surf_solve();
354 DEBUG1("Elapsed_time %f", elapsed_time);
357 actions_on_system = 0;
358 while (surf_timer_model->extension.timer.get(&fun, (void *) &arg)) {
359 /* change in process, don't quit */
360 actions_on_system = 1;
361 DEBUG2("got %p %p", fun, arg);
362 if (fun == SIMIX_process_create) {
363 smx_process_arg_t args = arg;
364 DEBUG2("Launching %s on %s", args->name, args->hostname);
365 process = SIMIX_process_create(args->name, args->code,
366 args->data, args->hostname,
367 args->argc, args->argv,
369 /* verify if process has been created */
375 if (args->kill_time > SIMIX_get_clock()) {
376 surf_timer_model->extension.timer.set(args->kill_time, (void *)
381 } else if (fun == simix_global->create_process_function) {
382 smx_process_arg_t args = arg;
383 DEBUG2("Launching %s on %s", args->name, args->hostname);
385 (*simix_global->create_process_function) (args->name, args->code,
388 args->argc, args->argv,
390 /* verify if process has been created */
395 if (args->kill_time > SIMIX_get_clock()) {
396 if (simix_global->kill_process_function)
397 surf_timer_model->extension.timer.set(args->kill_time, (void *)
399 kill_process_function,
402 surf_timer_model->extension.timer.set(args->kill_time, (void *)
407 } else if (fun == SIMIX_process_kill) {
409 DEBUG2("Killing %s on %s", process->name, process->smx_host->name);
410 SIMIX_process_kill(process);
411 } else if (fun == simix_global->kill_process_function) {
413 (*simix_global->kill_process_function) (process);
419 /* Wake up all process waiting for the action finish */
420 xbt_dynar_foreach(model_list, iter, model) {
421 /* stop simulation case there are no actions to run */
422 if ((xbt_swag_size(model->states.running_action_set)) ||
423 (xbt_swag_size(model->states.ready_action_set)) ||
424 (xbt_swag_size(model->states.done_action_set)) ||
425 (xbt_swag_size(model->states.failed_action_set)))
426 actions_on_system = 1;
428 while ((action = xbt_swag_extract(model->states.failed_action_set))) {
429 smx_action = action->data;
431 SIMIX_action_signal_all(smx_action);
434 while ((action = xbt_swag_extract(model->states.done_action_set))) {
435 smx_action = action->data;
437 /* Copy the transfered data of the completed communication actions */
438 /* FIXME: find a better way to determine if its a comm action */
439 if(smx_action->data != NULL)
440 SIMIX_network_copy_data((smx_comm_t)smx_action->data);
441 SIMIX_action_signal_all(smx_action);
446 state_modifications = 0;
447 if (!actions_on_system)
450 if (elapsed_time == -1) {
451 if (xbt_swag_size(simix_global->process_list) == 0) {
452 /* INFO0("Congratulations ! Simulation terminated : all processes are over"); */
454 INFO0("Oops ! Deadlock or code not perfectly clean.");
455 SIMIX_display_process_status();
456 if (XBT_LOG_ISENABLED(simix, xbt_log_priority_debug) ||
457 XBT_LOG_ISENABLED(simix_kernel, xbt_log_priority_debug)) {
461 INFO0("Return a Warning.");
468 * \brief Set the date to execute a function
470 * Set the date to execute the function on the surf.
471 * \param date Date to execute function
472 * \param function Function to be executed
473 * \param arg Parameters of the function
476 XBT_INLINE void SIMIX_timer_set(double date, void *function, void *arg)
478 surf_timer_model->extension.timer.set(date, function, arg);
481 XBT_INLINE int SIMIX_timer_get(void **function, void **arg)
483 return surf_timer_model->extension.timer.get(function, arg);
487 * \brief Registers a function to create a process.
489 * This function registers an user function to be called when a new process is created. The user function have to call the SIMIX_create_process function.
490 * \param function Create process function
493 XBT_INLINE void SIMIX_function_register_process_create(smx_creation_func_t function)
495 xbt_assert0((simix_global->create_process_function == NULL),
498 simix_global->create_process_function = function;
502 * \brief Registers a function to kill a process.
504 * This function registers an user function to be called when a new process is killed. The user function have to call the SIMIX_kill_process function.
505 * \param function Kill process function
508 XBT_INLINE void SIMIX_function_register_process_kill(void_f_pvoid_t function)
510 xbt_assert0((simix_global->kill_process_function == NULL),
513 simix_global->kill_process_function = function;
517 * \brief Registers a function to cleanup a process.
519 * This function registers an user function to be called when a new process ends properly.
520 * \param function cleanup process function
523 XBT_INLINE void SIMIX_function_register_process_cleanup(void_f_pvoid_t function)
525 simix_global->cleanup_process_function = function;