1 /* Copyright (c) 2004-2015. 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 "simgrid/msg.h"
8 #include "instr/instr_interface.h"
9 #include "msg_private.h"
10 #include "msg_mailbox.h"
12 #include "xbt/sysdep.h"
14 #include "xbt/virtu.h"
15 #include "xbt/ex.h" /* ex_backtrace_display */
16 #include "xbt/replay.h"
17 #include "simgrid/sg_config.h" /* Configuration mechanism of SimGrid */
18 #include "src/surf/callbacks.h"
19 #include "src/surf/platform.hpp"
21 XBT_LOG_NEW_CATEGORY(msg, "All MSG categories");
22 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(msg_kernel, msg,
23 "Logging specific to MSG (kernel)");
25 MSG_Global_t msg_global = NULL;
26 static void MSG_exit(void);
28 /********************************* MSG **************************************/
30 static void _sg_cfg_cb_msg_debug_multiple_use(const char *name, int pos)
32 msg_global->debug_multiple_use = xbt_cfg_get_boolean(_sg_cfg_set, name);
35 static void MSG_host_create_(sg_host_t host)
37 __MSG_host_create(host);
41 * \ingroup msg_simulation
42 * \brief Initialize MSG with less verifications
43 * You should use the MSG_init() function instead. Failing to do so may turn into PEBKAC some day. You've been warned.
45 void MSG_init_nocheck(int *argc, char **argv) {
47 TRACE_global_init(argc, argv);
49 xbt_getpid = MSG_process_self_PID;
52 msg_global = xbt_new0(s_MSG_Global_t, 1);
54 xbt_cfg_register(&_sg_cfg_set, "msg/debug_multiple_use",
55 "Print backtraces of both processes when there is a conflict of multiple use of a task",
56 xbt_cfgelm_boolean, 1, 1, _sg_cfg_cb_msg_debug_multiple_use, NULL);
57 xbt_cfg_setdefault_boolean(_sg_cfg_set, "msg/debug_multiple_use", "no");
59 SIMIX_global_init(argc, argv);
61 #ifdef MSG_USE_DEPRECATED
62 msg_global->max_channel = 0;
64 msg_global->sent_msg = 0;
65 msg_global->task_copy_callback = NULL;
66 msg_global->process_data_cleanup = NULL;
68 SIMIX_function_register_process_create(MSG_process_create_from_SIMIX);
69 SIMIX_function_register_process_cleanup(MSG_process_cleanup_from_SIMIX);
71 simgrid::surf::on_postparse.connect(MSG_post_create_environment);
72 simgrid::s4u::Host::onCreation.connect([](simgrid::s4u::Host& host) {
73 MSG_host_create_(&host);
78 /* Ignore total amount of messages sent during the simulation for heap comparison */
79 MC_ignore_heap(&(msg_global->sent_msg), sizeof(msg_global->sent_msg));
82 XBT_DEBUG("ADD MSG LEVELS");
83 MSG_STORAGE_LEVEL = xbt_lib_add_level(storage_lib, (void_f_pvoid_t) __MSG_storage_destroy);
84 MSG_FILE_LEVEL = xbt_lib_add_level(file_lib, (void_f_pvoid_t) __MSG_file_destroy);
85 if(sg_cfg_get_boolean("clean_atexit")) atexit(MSG_exit);
88 #ifdef MSG_USE_DEPRECATED
90 /* This deprecated function has to be called to fix the number of channel in the
91 simulation before creating any host. Indeed, each channel is
92 represented by a different mailbox on each #m_host_t. This
93 function can then be called only once. This function takes only one
95 * \param number the number of channel in the simulation. It has to be >0
97 msg_error_t MSG_set_channel_number(int number)
99 XBT_WARN("DEPRECATED! Please use aliases instead");
100 xbt_assert((msg_global)
101 && (msg_global->max_channel == 0),
102 "Channel number already set!");
104 msg_global->max_channel = number;
109 /* This deprecated function has to be called once the number of channel is fixed. I can't
110 figure out a reason why anyone would like to call this function but nevermind.
111 * \return the number of channel in the simulation.
113 int MSG_get_channel_number(void)
115 XBT_WARN("DEPRECATED! Please use aliases instead");
116 xbt_assert((msg_global)
117 && (msg_global->max_channel != 0),
118 "Channel number not set yet!");
120 return msg_global->max_channel;
124 /** \ingroup msg_simulation
125 * \brief Launch the MSG simulation
127 msg_error_t MSG_main(void)
129 /* Clean IO before the run */
133 if (MC_is_active()) {
141 /** \ingroup msg_simulation
142 * \brief set a configuration variable
144 * Do --help on any simgrid binary to see the list of currently existing configuration variables, and see Section @ref options.
147 * MSG_config("host/model","ptask_L07");
149 void MSG_config(const char *key, const char *value){
150 xbt_assert(msg_global,"ERROR: Please call MSG_init() before using MSG_config()");
151 xbt_cfg_set_as_string(_sg_cfg_set, key, value);
155 /** \ingroup msg_simulation
156 * \brief Kill all running process
158 * \param reset_PIDs should we reset the PID numbers. A negative
159 * number means no reset and a positive number will be used to set the PID
160 * of the next newly created process.
162 int MSG_process_killall(int reset_PIDs)
164 simcall_process_killall(reset_PIDs);
167 msg_global->session++;
173 static void MSG_exit(void) {
174 if (msg_global==NULL)
177 TRACE_surf_resource_utilization_release();
184 /** \ingroup msg_simulation
185 * \brief A clock (in second).
187 double MSG_get_clock(void)
189 return SIMIX_get_clock();
192 unsigned long int MSG_get_sent_msg()
194 return msg_global->sent_msg;
197 #ifdef MSG_USE_DEPRECATED
198 msg_error_t MSG_clean(void) {