1 /* Copyright (c) 2016-2021. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
6 #ifndef SIMGRID_KERNEL_ENGINEIMPL_HPP
7 #define SIMGRID_KERNEL_ENGINEIMPL_HPP
9 #include <simgrid/kernel/resource/Model.hpp>
10 #include <simgrid/s4u/Engine.hpp>
11 #include <simgrid/s4u/NetZone.hpp>
12 #include <simgrid/simix.hpp>
13 #include <xbt/dynar.h>
14 #include <xbt/functional.hpp>
16 #include "src/kernel/activity/ExecImpl.hpp"
17 #include "src/kernel/activity/IoImpl.hpp"
18 #include "src/kernel/activity/MailboxImpl.hpp"
19 #include "src/kernel/activity/SleepImpl.hpp"
20 #include "src/kernel/activity/SynchroRaw.hpp"
21 #include "src/kernel/actor/ActorImpl.hpp"
22 #include "src/surf/SplitDuplexLinkImpl.hpp"
24 #include <boost/intrusive/list.hpp>
29 #include <unordered_map>
34 // In MC mode, the application sends these pointers to the MC
35 xbt_dynar_t get_actors_addr();
36 xbt_dynar_t get_dead_actors_addr();
39 std::map<std::string, s4u::Host*, std::less<>> hosts_;
40 std::map<std::string, resource::LinkImpl*, std::less<>> links_;
41 /* save split-duplex links separately, keep links_ with only LinkImpl* seen by the user
42 * members of a split-duplex are saved in the links_ */
43 std::map<std::string, std::unique_ptr<resource::SplitDuplexLinkImpl>, std::less<>> split_duplex_links_;
44 std::unordered_map<std::string, routing::NetPoint*> netpoints_;
45 std::unordered_map<std::string, activity::MailboxImpl*> mailboxes_;
47 std::unordered_map<std::string, actor::ActorCodeFactory> registered_functions; // Maps function names to actor code
48 actor::ActorCodeFactory default_function; // Function to use as a fallback when the provided name matches nothing
49 std::vector<resource::Model*> models_;
50 std::unordered_map<std::string, std::shared_ptr<resource::Model>> models_prio_;
51 routing::NetZoneImpl* netzone_root_ = nullptr;
52 std::set<actor::ActorImpl*> daemons_;
53 std::vector<actor::ActorImpl*> actors_to_run_;
54 std::vector<actor::ActorImpl*> actors_that_ran_;
55 std::map<aid_t, actor::ActorImpl*> actor_list_;
56 boost::intrusive::list<actor::ActorImpl,
57 boost::intrusive::member_hook<actor::ActorImpl, boost::intrusive::list_member_hook<>,
58 &actor::ActorImpl::kernel_destroy_list_hook>>
61 /* MCer cannot read members actor_list_ and actors_to_destroy_ above in the remote process, so we copy the info it
63 * FIXME: This is supposed to be a temporary hack.
64 * A better solution would be to change the split between MCer and MCed, where the responsibility
65 * to compute the list of the enabled transitions goes to the MCed.
66 * That way, the MCer would not need to have the list of actors on its side.
67 * These info could be published by the MCed to the MCer in a way inspired of vd.so
69 xbt_dynar_t actors_vector_ = xbt_dynar_new(sizeof(actor::ActorImpl*), nullptr);
70 xbt_dynar_t dead_actors_vector_ = xbt_dynar_new(sizeof(actor::ActorImpl*), nullptr);
73 std::vector<xbt::Task<void()>> tasks;
76 static EngineImpl* instance_;
77 actor::ActorImpl* maestro_ = nullptr;
78 context::ContextFactory* context_factory_ = nullptr;
80 std::unique_ptr<void, std::function<int(void*)>> platf_handle_; //!< handle for platform library
84 EngineImpl() = default;
86 /* Currently, only one instance is allowed to exist. This is why you can't copy or move it */
88 EngineImpl(const EngineImpl&) = delete;
89 EngineImpl& operator=(const EngineImpl&) = delete;
90 virtual ~EngineImpl();
91 static void shutdown();
94 void initialize(int* argc, char** argv);
95 void load_platform(const std::string& platf);
96 void load_deployment(const std::string& file) const;
97 void register_function(const std::string& name, const actor::ActorCodeFactory& code);
98 void register_default(const actor::ActorCodeFactory& code);
100 bool is_maestro(const actor::ActorImpl* actor) const { return actor == maestro_; }
101 void set_maestro(actor::ActorImpl* actor) { maestro_ = actor; }
102 actor::ActorImpl* get_maestro() const { return maestro_; }
104 context::ContextFactory* get_context_factory() const { return context_factory_; }
105 void set_context_factory(context::ContextFactory* factory) { context_factory_ = factory; }
106 bool has_context_factory() const { return context_factory_ != nullptr; }
107 void destroy_context_factory()
109 delete context_factory_;
110 context_factory_ = nullptr;
113 void context_mod_init() const;
115 * @brief Add a model to engine list
117 * @param model Pointer to model
118 * @param list List of dependencies for this model
120 void add_model(std::shared_ptr<simgrid::kernel::resource::Model> model,
121 const std::vector<resource::Model*>& dep_models = {});
123 /** @brief Get list of all models managed by this engine */
124 const std::vector<resource::Model*>& get_all_models() const { return models_; }
126 static bool has_instance() { return s4u::Engine::has_instance(); }
127 static EngineImpl* get_instance() { return s4u::Engine::get_instance()->pimpl; }
128 static EngineImpl* get_instance(int* argc, char** argv) { return s4u::Engine::get_instance(argc, argv)->pimpl; }
130 actor::ActorCodeFactory get_function(const std::string& name)
132 auto res = registered_functions.find(name);
133 if (res == registered_functions.end())
134 return default_function;
139 routing::NetZoneImpl* get_netzone_root() const { return netzone_root_; }
141 void add_daemon(actor::ActorImpl* d) { daemons_.insert(d); }
142 void remove_daemon(actor::ActorImpl* d);
143 void add_actor_to_run_list(actor::ActorImpl* actor);
144 void add_actor_to_run_list_no_check(actor::ActorImpl* actor);
145 void add_actor_to_destroy_list(actor::ActorImpl& actor) { actors_to_destroy_.push_back(actor); }
147 bool has_actors_to_run() const { return not actors_to_run_.empty(); }
148 const actor::ActorImpl* get_first_actor_to_run() const { return actors_to_run_.front(); }
149 const actor::ActorImpl* get_actor_to_run_at(unsigned long int i) const { return actors_to_run_[i]; }
150 unsigned long int get_actor_to_run_count() const { return actors_to_run_.size(); }
151 size_t get_actor_count() const { return actor_list_.size(); }
152 actor::ActorImpl* get_actor_by_pid(aid_t pid);
153 void add_actor(aid_t pid, actor::ActorImpl* actor) { actor_list_[pid] = actor; }
154 void remove_actor(aid_t pid) { actor_list_.erase(pid); }
155 void add_split_duplex_link(const std::string& name, std::unique_ptr<resource::SplitDuplexLinkImpl> link);
158 xbt_dynar_t get_actors_vector() const { return actors_vector_; }
159 xbt_dynar_t get_dead_actors_vector() const { return dead_actors_vector_; }
160 void reset_actor_dynar() { xbt_dynar_reset(actors_vector_); }
161 void add_actor_to_dynar(actor::ActorImpl* actor) { xbt_dynar_push_as(actors_vector_, actor::ActorImpl*, actor); }
162 void add_dead_actor_to_dynar(actor::ActorImpl* actor)
164 xbt_dynar_push_as(dead_actors_vector_, actor::ActorImpl*, actor);
168 const std::map<aid_t, actor::ActorImpl*>& get_actor_list() const { return actor_list_; }
169 const std::vector<actor::ActorImpl*>& get_actors_to_run() const { return actors_to_run_; }
170 const std::vector<actor::ActorImpl*>& get_actors_that_ran() const { return actors_that_ran_; }
172 std::mutex& get_mutex() { return mutex_; }
173 bool execute_tasks();
174 void add_task(xbt::Task<void()>&& t) { tasks.push_back(std::move(t)); }
175 void wake_all_waiting_actors() const;
179 * Should be called some time to time to free the memory allocated for actors that have finished (or killed).
182 void display_all_actor_status() const;
183 void run_all_actors();
185 /* @brief Finish simulation initialization
186 * This function must be called before the first call to solve()
188 void presolve() const;
189 /** @brief Performs a part of the simulation
190 * @param max_date Maximum date to update the simulation to, or -1
191 * @return the elapsed time, or -1.0 if no event could be executed
193 * This function execute all possible events, update the action states and returns the time elapsed.
194 * When you call execute or communicate on a model, the corresponding actions are not executed immediately but only
195 * when you call solve().
196 * Note that the returned elapsed time can be zero.
198 double solve(double max_date) const;
200 /** @brief Run the main simulation loop until the specified date (or infinitly if max_date is negative). */
201 void run(double max_date);
203 /** @brief Return the current time in milliseconds. */
204 static double get_clock();
207 } // namespace kernel
208 } // namespace simgrid