X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/d974764c400528dfd76c9a2ae6b7f26643fcc02f..2930c51f66caea16d89877478c071929bd151c68:/include/simgrid/s4u/engine.hpp diff --git a/include/simgrid/s4u/engine.hpp b/include/simgrid/s4u/engine.hpp index 0f7dca1fc0..71d5df2a51 100644 --- a/include/simgrid/s4u/engine.hpp +++ b/include/simgrid/s4u/engine.hpp @@ -6,46 +6,112 @@ #ifndef SIMGRID_S4U_ENGINE_HPP #define SIMGRID_S4U_ENGINE_HPP +#include +#include +#include + #include +#include + +#include + +#include namespace simgrid { +namespace kernel { +class EngineImpl; +} namespace s4u { /** @brief Simulation engine * * This class is an interface to the simulation engine. */ XBT_PUBLIC_CLASS Engine { +private: + ~Engine(); + public: - /** Constructor, taking the command line parameters of your main function */ - Engine(int *argc, char **argv); - - /** @brief Load a platform file describing the environment - * - * The environment is either a XML file following the simgrid.dtd formalism, or a lua file. - * Some examples can be found in the directory examples/platforms. - */ - void loadPlatform(const char *platf); - - /** Registers the main function of an actor that will be launched from the deployment file */ - void register_function(const char*name, int (*code)(int,char**)); - - /** Registers a function as the default main function of actors - * - * It will be used as fallback when the function requested from the deployment file was not registered. - * It is used for trace-based simulations (see examples/msg/actions). - */ - void register_default(int (*code)(int,char**)); - - /** @brief Load a deployment file and launch the actors that it contains */ - void loadDeployment(const char *deploy); - - /** @brief Run the simulation */ - void run(); - - /** @brief Retrieve the simulation time */ - static double getClock(); - + /** Constructor, taking the command line parameters of your main function */ + Engine(int *argc, char **argv); + + /** Finalize the default engine and all its dependencies */ + static void shutdown(); + + /** @brief Load a platform file describing the environment + * + * The environment is either a XML file following the simgrid.dtd formalism, or a lua file. + * Some examples can be found in the directory examples/platforms. + */ + void loadPlatform(const char *platf); + + /** Registers the main function of an actor that will be launched from the deployment file */ + void registerFunction(const char*name, int (*code)(int,char**)); + + /** Registers a function as the default main function of actors + * + * It will be used as fallback when the function requested from the deployment file was not registered. + * It is used for trace-based simulations (see examples/msg/actions). + */ + void registerDefault(int (*code)(int,char**)); + + /** @brief Load a deployment file and launch the actors that it contains */ + void loadDeployment(const char *deploy); + + /** @brief Run the simulation */ + void run(); + + /** @brief Retrieve the simulation time */ + static double getClock(); + + /** @brief Retrieve the engine singleton */ + static s4u::Engine *instance(); + + /** @brief Retrieve the root netzone, containing all others */ + simgrid::s4u::NetZone* netRoot(); + + /** @brief Retrieve the netzone of the given name (or nullptr if not found) */ + simgrid::s4u::NetZone* netzoneByNameOrNull(const char* name); + + /** @brief Retrieve the netcard of the given name (or nullptr if not found) */ + simgrid::kernel::routing::NetPoint* netpointByNameOrNull(const char* name); + void netpointList(std::vector * list); + void netpointRegister(simgrid::kernel::routing::NetPoint * card); + void netpointUnregister(simgrid::kernel::routing::NetPoint * card); + + template + void registerFunction(const char* name) + { + simgrid::simix::registerFunction(name, [](std::vector args){ + return simgrid::simix::ActorCode([args] { + F code(std::move(args)); + code(); + }); + }); + } + + template + void registerFunction(const char* name, F code) + { + simgrid::simix::registerFunction(name, [code](std::vector args){ + return simgrid::simix::ActorCode([code,args] { + code(std::move(args)); + }); + }); + } + + simgrid::kernel::EngineImpl* pimpl; + +private: + static s4u::Engine *instance_; }; -}} // namespace simgrid::sgo + +/** Callback called when the platform is created (ie, the xml file parsed), + * right before the actual simulation starts. + */ +extern XBT_PRIVATE xbt::signal onPlatformCreated; + +/** Callback called when the main simulation loop ends, just before MSG_run (or similar) ends */ +extern XBT_PRIVATE xbt::signal onSimulationEnd; +}} // namespace simgrid::s4u #endif /* SIMGRID_S4U_ENGINE_HPP */