3 /* Copyright (c) 2002-2007 Arnaud Legrand. */
4 /* Copyright (c) 2007 Bruno Donassolo. */
5 /* All rights reserved. */
7 /* This program is free software; you can redistribute it and/or modify it
8 * under the terms of the license (GNU LGPL) which comes with this package. */
10 #include "msg/private.h"
11 #include "xbt/sysdep.h"
13 #include "xbt/virtu.h"
14 #include "xbt/ex.h" /* ex_backtrace_display */
16 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_kernel, msg, "Logging specific to MSG (kernel)");
18 MSG_Global_t msg_global = NULL;
21 /** \defgroup msg_simulation MSG simulation Functions
22 * \brief This section describes the functions you need to know to
23 * set up a simulation. You should have a look at \ref MSG_examples
24 * to have an overview of their usage.
26 /** @addtogroup msg_simulation
27 * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Simulation functions" --> \endhtmlonly
30 /********************************* MSG **************************************/
32 /** \ingroup msg_simulation
33 * \brief Initialize some MSG internal data.
35 void MSG_global_init_args(int *argc, char **argv)
37 MSG_global_init(argc,argv);
40 /** \ingroup msg_simulation
41 * \brief Initialize some MSG internal data.
43 void MSG_global_init(int *argc, char **argv)
45 xbt_getpid = & MSG_process_self_PID;
47 SIMIX_global_init(argc, argv);
49 msg_global = xbt_new0(s_MSG_Global_t,1);
51 msg_global->host = xbt_fifo_new();
52 msg_global->process_list = xbt_fifo_new();
53 msg_global->max_channel = 0;
59 /** \ingroup msg_easier_life
60 * \brief Traces MSG events in the Paje format.
63 void MSG_paje_output(const char *filename)
67 /** \defgroup m_channel_management Understanding channels
68 * \brief This section briefly describes the channel notion of MSG
71 /** @addtogroup m_channel_management
72 * \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Channels" --> \endhtmlonly
75 * For convenience, the simulator provides the notion of channel
76 * that is close to the tag notion in MPI. A channel is not a
77 * socket. It doesn't need to be opened neither closed. It rather
78 * corresponds to the ports opened on the different machines.
82 /** \ingroup m_channel_management
83 * \brief Set the number of channel in the simulation.
85 * This function has to be called to fix the number of channel in the
86 simulation before creating any host. Indeed, each channel is
87 represented by a different mailbox on each #m_host_t. This
88 function can then be called only once. This function takes only one
90 * \param number the number of channel in the simulation. It has to be >0
92 MSG_error_t MSG_set_channel_number(int number)
94 xbt_assert0((msg_global) && (msg_global->max_channel == 0), "Channel number already set!");
96 msg_global->max_channel = number;
101 /** \ingroup m_channel_management
102 * \brief Return the number of channel in the simulation.
104 * This function has to be called once the number of channel is fixed. I can't
105 figure out a reason why anyone would like to call this function but nevermind.
106 * \return the number of channel in the simulation.
108 int MSG_get_channel_number(void)
110 xbt_assert0((msg_global)&&(msg_global->max_channel != 0), "Channel number not set yet!");
112 return msg_global->max_channel;
115 void __MSG_display_process_status(void)
120 /* FIXME: Yeah, I'll do it in a portable maner one day [Mt] */
123 static void _XBT_CALL inthandler(int ignored)
125 INFO0("CTRL-C pressed. Displaying status and bailing out");
126 __MSG_display_process_status();
130 /** \ingroup msg_simulation
131 * \brief Launch the MSG simulation
133 MSG_error_t MSG_main(void)
135 smx_cond_t cond = NULL;
136 smx_action_t smx_action;
137 xbt_fifo_t actions_done = xbt_fifo_new();
138 xbt_fifo_t actions_failed = xbt_fifo_new();
140 /* Prepare to display some more info when dying on Ctrl-C pressing */
141 signal(SIGINT,inthandler);
143 /* Clean IO before the run */
147 //surf_solve(); /* Takes traces into account. Returns 0.0 */
148 /* xbt_fifo_size(msg_global->process_to_run) */
150 while (SIMIX_solve(actions_done, actions_failed) != -1.0) {
152 while ( (smx_action = xbt_fifo_pop(actions_failed)) ) {
155 DEBUG1("** %s failed **",smx_action->name);
156 while ( (cond = xbt_fifo_pop(smx_action->cond_list)) ) {
157 SIMIX_cond_broadcast(cond);
159 /* action finished, destroy it */
160 // SIMIX_action_destroy(smx_action);
163 while ( (smx_action = xbt_fifo_pop(actions_done)) ) {
165 DEBUG1("** %s done **",smx_action->name);
166 while ( (cond = xbt_fifo_pop(smx_action->cond_list)) ) {
167 SIMIX_cond_broadcast(cond);
169 /* action finished, destroy it */
170 //SIMIX_action_destroy(smx_action);
173 xbt_fifo_free(actions_failed);
174 xbt_fifo_free(actions_done);
178 /** \ingroup msg_simulation
179 * \brief Kill all running process
181 * \param reset_PIDs should we reset the PID numbers. A negative
182 * number means no reset and a positive number will be used to set the PID
183 * of the next newly created process.
185 int MSG_process_killall(int reset_PIDs)
187 m_process_t p = NULL;
188 m_process_t self = MSG_process_self();
190 while((p=xbt_fifo_pop(msg_global->process_list))) {
191 if(p!=self) MSG_process_kill(p);
195 msg_global->PID = reset_PIDs;
196 msg_global->session++;
199 return msg_global->PID;
203 /** \ingroup msg_simulation
204 * \brief Clean the MSG simulation
206 MSG_error_t MSG_clean(void)
208 xbt_fifo_item_t i = NULL;
210 m_process_t p = NULL;
213 while((p=xbt_fifo_pop(msg_global->process_list))) {
217 xbt_fifo_foreach(msg_global->host,i,h,m_host_t) {
218 __MSG_host_destroy(h);
220 xbt_fifo_free(msg_global->host);
221 xbt_fifo_free(msg_global->process_list);
230 /** \ingroup msg_easier_life
231 * \brief A clock (in second).
233 double MSG_get_clock(void)
235 return SIMIX_get_clock();