X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/76264ed1928b146602ee73794d86798739cd1209..901293dfbce6b7e0f555dbdc53358aa347fd1a3d:/include/simgrid/simix.hpp diff --git a/include/simgrid/simix.hpp b/include/simgrid/simix.hpp index 8888fb81ce..9720dc87c4 100644 --- a/include/simgrid/simix.hpp +++ b/include/simgrid/simix.hpp @@ -1,4 +1,4 @@ -/* Copyright (c) 2007-2010, 2012-2015. The SimGrid Team. +/* Copyright (c) 2007-2018. The SimGrid Team. * All rights reserved. */ /* This program is free software; you can redistribute it and/or modify it @@ -7,78 +7,111 @@ #ifndef SIMGRID_SIMIX_HPP #define SIMGRID_SIMIX_HPP -#include -#include - -#include #include +#include +#include +#include + +#include +#include + +XBT_PUBLIC void simcall_run_kernel(std::function const& code); + +/** Execute some code in the kernel and block + * + * run_blocking() is a generic blocking simcall. It is given a callback + * which is executed immediately in the SimGrid kernel. The callback is + * responsible for setting the suitable logic for waking up the process + * when needed. + * + * @ref simix::kernelSync() is a higher level wrapper for this. + */ +XBT_PUBLIC void simcall_run_blocking(std::function const& code); + +template inline +void simcall_run_kernel(F& f) +{ + simcall_run_kernel(std::function(std::ref(f))); +} +template inline +void simcall_run_blocking(F& f) +{ + simcall_run_blocking(std::function(std::ref(f))); +} namespace simgrid { + namespace simix { -class Context; -class ContextFactory; - -class ContextFactory { -private: - std::string name_; -public: - - ContextFactory(std::string name) : name_(std::move(name)) {} - virtual ~ContextFactory(); - virtual Context* create_context( - xbt_main_func_t, int, char **, void_pfn_smxprocess_t, - smx_process_t process - ) = 0; - virtual void run_all() = 0; - virtual Context* self(); - std::string const& name() const - { - return name_; - } -private: - void declare_context(void* T, std::size_t size); -protected: - template - T* new_context(Args&&... args) - { - T* context = new T(std::forward(args)...); - this->declare_context(context, sizeof(T)); - return context; - } -}; - -class Context { -protected: - xbt_main_func_t code_ = nullptr; - int argc_ = 0; - char **argv_ = nullptr; -private: - void_pfn_smxprocess_t cleanup_func_ = nullptr; - smx_process_t process_ = nullptr; -public: - bool iwannadie; -public: - Context(xbt_main_func_t code, - int argc, char **argv, - void_pfn_smxprocess_t cleanup_func, - smx_process_t process); - int operator()() - { - return code_(argc_, argv_); - } - smx_process_t process() - { - return this->process_; - } - - // Virtual methods - virtual ~Context(); - virtual void stop(); - virtual void suspend() = 0; -}; +/** Execute some code in the kernel/maestro + * + * This can be used to enforce mutual exclusion with other simcall. + * More importantly, this enforces a deterministic/reproducible ordering + * of the operation with respect to other simcalls. + */ +template typename std::result_of::type simcall(F&& code) +{ + // If we are in the maestro, we take the fast path and execute the + // code directly without simcall mashalling/unmarshalling/dispatch: + if (SIMIX_is_maestro()) + return std::forward(code)(); + // If we are in the application, pass the code to the maestro which + // executes it for us and reports the result. We use a std::future which + // conveniently handles the success/failure value for us. + typedef typename std::result_of::type R; + simgrid::xbt::Result result; + simcall_run_kernel([&] { simgrid::xbt::fulfill_promise(result, std::forward(code)); }); + return result.get(); } + +XBT_PUBLIC const std::vector& process_get_runnable(); + +// What's executed as SIMIX actor code: +typedef std::function ActorCode; + +// Create an ActorCode based on a std::string +typedef std::function args)> ActorCodeFactory; + +XBT_PUBLIC void register_function(std::string name, ActorCodeFactory factory); +} +} + +/* + * Type of function that creates a process. + * The function must accept the following parameters: + * void* process: the process created will be stored there + * const char *name: a name for the object. It is for user-level information and can be NULL + * xbt_main_func_t code: is a function describing the behavior of the process + * void *data: data a pointer to any data one may want to attach to the new object. + * sg_host_t host: the location where the new process is executed + * int argc, char **argv: parameters passed to code + * std::map* props: properties + */ +typedef smx_actor_t (*smx_creation_func_t)( + /* name */ std::string, simgrid::simix::ActorCode code, + /* userdata */ void*, + /* hostname */ sg_host_t, + /* props */ std::unordered_map*, + /* parent_process */ smx_actor_t); + +XBT_PUBLIC void SIMIX_function_register_process_create(smx_creation_func_t function); + +XBT_PUBLIC smx_actor_t simcall_process_create(std::string name, simgrid::simix::ActorCode code, void* data, + sg_host_t host, std::unordered_map* properties); + +XBT_PUBLIC smx_timer_t SIMIX_timer_set(double date, simgrid::xbt::Task callback); + +template inline +smx_timer_t SIMIX_timer_set(double date, F callback) +{ + return SIMIX_timer_set(date, simgrid::xbt::Task(std::move(callback))); +} + +template inline +smx_timer_t SIMIX_timer_set(double date, R(*callback)(T*), T* arg) +{ + return SIMIX_timer_set(date, [=](){ callback(arg); }); } -#endif \ No newline at end of file +#endif