src/msg/global.c

   1 /* Copyright (c) 2004, 2005, 2006, 2007, 2008, 2009, 2010. The SimGrid Team.
   2  * All rights reserved.                                                     */
   3
   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. */
   6
   7 #include "msg/private.h"
   8 #include "mc/mc.h"
   9 #include "xbt/sysdep.h"
  10 #include "xbt/log.h"
  11 #include "xbt/virtu.h"
  12 #include "xbt/ex.h"             /* ex_backtrace_display */
  13 #include "mailbox.h"
  14
  15 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_kernel, msg,
  16                                 "Logging specific to MSG (kernel)");
  17
  18 MSG_Global_t msg_global = NULL;
  19
  20
  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.
  25  */
  26 /** @addtogroup msg_simulation
  27  *    \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Simulation functions" --> \endhtmlonly
  28  */
  29
  30 /********************************* MSG **************************************/
  31
  32 /** \ingroup msg_simulation
  33  * \brief Initialize some MSG internal data.
  34  */
  35 void MSG_global_init_args(int *argc, char **argv)
  36 {
  37   MSG_global_init(argc, argv);
  38 }
  39
  40
  41 XBT_LOG_EXTERNAL_CATEGORY(msg_gos);
  42 XBT_LOG_EXTERNAL_CATEGORY(msg_kernel);
  43 XBT_LOG_EXTERNAL_CATEGORY(msg_mailbox);
  44 XBT_LOG_EXTERNAL_CATEGORY(msg_process);
  45
  46 /** \ingroup msg_simulation
  47  * \brief Initialize some MSG internal data.
  48  */
  49 void MSG_global_init(int *argc, char **argv)
  50 {
  51 #ifdef HAVE_TRACING
  52   TRACE_global_init (argc, argv);
  53 #endif
  54
  55   xbt_getpid = MSG_process_self_PID;
  56   if (!msg_global) {
  57     /* Connect our log channels: that must be done manually under windows */
  58     XBT_LOG_CONNECT(msg_gos, msg);
  59     XBT_LOG_CONNECT(msg_kernel, msg);
  60     XBT_LOG_CONNECT(msg_mailbox, msg);
  61     XBT_LOG_CONNECT(msg_process, msg);
  62
  63     SIMIX_global_init(argc, argv);
  64
  65     msg_global = xbt_new0(s_MSG_Global_t, 1);
  66
  67     msg_global->host = xbt_fifo_new();
  68     msg_global->process_list = xbt_fifo_new();
  69     msg_global->max_channel = 0;
  70     msg_global->PID = 1;
  71     msg_global->sent_msg = 0;
  72
  73     /* initialization of the mailbox module */
  74     MSG_mailbox_mod_init();
  75
  76     /* initialization of the action module */
  77     _MSG_action_init();
  78
  79     SIMIX_function_register_process_create(_MSG_process_create_from_SIMIX);
  80     SIMIX_function_register_process_cleanup(__MSG_process_cleanup);
  81     SIMIX_function_register_process_kill(_MSG_process_kill_from_SIMIX);
  82   }
  83 }
  84
  85 /** \defgroup m_channel_management    Understanding channels
  86  *  \brief This section briefly describes the channel notion of MSG
  87  *  (#m_channel_t).
  88  */
  89 /** @addtogroup m_channel_management
  90  *    \htmlonly <!-- DOXYGEN_NAVBAR_LABEL="Channels" --> \endhtmlonly
  91  *
  92  *
  93  *  For convenience, the simulator provides the notion of channel
  94  *  that is close to the tag notion in MPI. A channel is not a
  95  *  socket. It doesn't need to be opened neither closed. It rather
  96  *  corresponds to the ports opened on the different machines.
  97  */
  98
  99
 100 /** \ingroup m_channel_management
 101  * \brief Set the number of channel in the simulation.
 102  *
 103  * This function has to be called to fix the number of channel in the
 104    simulation before creating any host. Indeed, each channel is
 105    represented by a different mailbox on each #m_host_t. This
 106    function can then be called only once. This function takes only one
 107    parameter.
 108  * \param number the number of channel in the simulation. It has to be >0
 109  */
 110 MSG_error_t MSG_set_channel_number(int number)
 111 {
 112   xbt_assert0((msg_global)
 113               && (msg_global->max_channel == 0),
 114               "Channel number already set!");
 115
 116   msg_global->max_channel = number;
 117
 118   return MSG_OK;
 119 }
 120
 121 /** \ingroup m_channel_management
 122  * \brief Return the number of channel in the simulation.
 123  *
 124  * This function has to be called once the number of channel is fixed. I can't
 125    figure out a reason why anyone would like to call this function but nevermind.
 126  * \return the number of channel in the simulation.
 127  */
 128 int MSG_get_channel_number(void)
 129 {
 130   xbt_assert0((msg_global)
 131               && (msg_global->max_channel != 0),
 132               "Channel number not set yet!");
 133
 134   return msg_global->max_channel;
 135 }
 136
 137 /** \ingroup msg_simulation
 138  * \brief Launch the MSG simulation
 139  */
 140 MSG_error_t MSG_main(void)
 141 {
 142   /* Clean IO before the run */
 143   fflush(stdout);
 144   fflush(stderr);
 145   SIMIX_init();
 146
 147 #ifdef HAVE_MC
 148   if (_surf_do_model_check)
 149     MC_modelcheck(1);
 150   else
 151 #endif
 152     while (SIMIX_solve(NULL, NULL) != -1.0);
 153
 154   return MSG_OK;
 155 }
 156
 157 /** \ingroup msg_simulation
 158  * \brief Kill all running process
 159
 160  * \param reset_PIDs should we reset the PID numbers. A negative
 161  *   number means no reset and a positive number will be used to set the PID
 162  *   of the next newly created process.
 163  */
 164 int MSG_process_killall(int reset_PIDs)
 165 {
 166   m_process_t p = NULL;
 167   m_process_t self = MSG_process_self();
 168
 169   while ((p = xbt_fifo_pop(msg_global->process_list))) {
 170     if (p != self)
 171       MSG_process_kill(p);
 172   }
 173
 174   if (reset_PIDs > 0) {
 175     msg_global->PID = reset_PIDs;
 176     msg_global->session++;
 177   }
 178
 179   return msg_global->PID;
 180
 181 }
 182
 183 /** \ingroup msg_simulation
 184  * \brief Clean the MSG simulation
 185  */
 186 MSG_error_t MSG_clean(void)
 187 {
 188   xbt_fifo_item_t i = NULL;
 189   m_host_t h = NULL;
 190   m_process_t p = NULL;
 191
 192 #ifdef HAVE_TRACING
 193   TRACE_surf_release ();
 194 #endif
 195
 196   while ((p = xbt_fifo_pop(msg_global->process_list))) {
 197     MSG_process_kill(p);
 198   }
 199
 200   xbt_fifo_foreach(msg_global->host, i, h, m_host_t) {
 201     __MSG_host_destroy(h);
 202   }
 203   xbt_fifo_free(msg_global->host);
 204   xbt_fifo_free(msg_global->process_list);
 205
 206   free(msg_global);
 207   msg_global = NULL;
 208
 209   /* cleanup all resources in the mailbox module */
 210   MSG_mailbox_mod_exit();
 211
 212   /* initialization of the action module */
 213   _MSG_action_exit();
 214
 215   SIMIX_clean();
 216
 217   return MSG_OK;
 218 }
 219
 220
 221 /** \ingroup msg_easier_life
 222  * \brief A clock (in second).
 223  */
 224 double MSG_get_clock(void)
 225 {
 226   return SIMIX_get_clock();
 227 }
 228
 229 unsigned long int MSG_get_sent_msg()
 230 {
 231   return msg_global->sent_msg;
 232 }