src/mc/mc_api.hpp

   1 #ifndef SIMGRID_MC_API_HPP
   2 #define SIMGRID_MC_API_HPP
   3
   4 #include <memory>
   5 #include <vector>
   6
   7 #include "simgrid/forward.h"
   8 #include "src/mc/mc_forward.hpp"
   9 #include "src/mc/mc_request.hpp"
  10 #include "src/mc/mc_state.hpp"
  11 #include "xbt/base.h"
  12
  13 namespace simgrid {
  14 namespace mc {
  15
  16 /*
  17 ** This class aimes to implement FACADE APIs for simgrid. The FACADE layer sits between the CheckerSide
  18 ** (Unfolding_Checker, DPOR, ...) layer and the
  19 ** AppSide layer. The goal is to drill down into the entagled details in the CheckerSide layer and break down the
  20 ** detailes in a way that the CheckerSide eventually
  21 ** be capable to acquire the required information through the FACADE layer rather than the direct access to the AppSide.
  22 */
  23
  24 class mc_api {
  25 private:
  26   mc_api() = default;
  27
  28 public:
  29   // No copy:
  30   mc_api(mc_api const&) = delete;
  31   void operator=(mc_api const&) = delete;
  32
  33   static mc_api& get()
  34   {
  35     static mc_api mcapi;
  36     return mcapi;
  37   }
  38
  39   void initialize(char** argv);
  40
  41   // ACTOR FUNCTIONS
  42   std::vector<simgrid::mc::ActorInformation>& get_actors() const;
  43   bool actor_is_enabled(aid_t pid) const;
  44   unsigned long get_maxpid() const;
  45
  46   // COMM FUNCTIONS
  47   void copy_incomplete_comm_pattern(const simgrid::mc::State* state) const;
  48   void copy_index_comm_pattern(const simgrid::mc::State* state) const;
  49   kernel::activity::CommImpl* get_pattern_comm_addr(smx_simcall_t request) const;
  50   std::string get_pattern_comm_rdv(void* addr) const;
  51   unsigned long get_pattern_comm_src_proc(void* addr) const;
  52   std::vector<char> get_pattern_comm_data(void* addr) const;
  53   const char* get_actor_host_name(smx_actor_t actor) const;
  54
  55   // REMOTE
  56   std::size_t get_remote_heap_bytes() const;
  57
  58   // MODEL_CHECKER FUNCTIONS
  59   ModelChecker* get_model_checker() const;
  60   void mc_inc_visited_states() const;
  61   void mc_inc_executed_trans() const;
  62   unsigned long mc_get_visited_states() const;
  63   unsigned long mc_get_executed_trans() const;
  64   bool mc_check_deadlock() const;
  65   void mc_show_deadlock() const;
  66   smx_actor_t mc_smx_simcall_get_issuer(s_smx_simcall const* req) const;
  67   bool mc_is_null() const;
  68   Checker* mc_get_checker() const;
  69   RemoteSimulation& mc_get_remote_simulation() const;
  70   void handle_simcall(Transition const& transition) const;
  71   void mc_wait_for_requests() const;
  72   void mc_exit(int status) const;
  73   std::string const& mc_get_host_name(std::string const& hostname) const;
  74   void mc_dump_record_path() const;
  75   smx_simcall_t mc_state_choose_request(simgrid::mc::State* state) const;
  76
  77   // SIMCALL FUNCTIONS
  78   bool request_depend(smx_simcall_t req1, smx_simcall_t req2) const;
  79   std::string request_to_string(smx_simcall_t req, int value, RequestType request_type) const;
  80   std::string request_get_dot_output(smx_simcall_t req, int value) const;
  81   const char *simix_simcall_name(e_smx_simcall_t kind) const;
  82
  83   // SNAPSHOT FUNCTIONS
  84   bool snapshot_equal(const Snapshot* s1, const Snapshot* s2) const;
  85   simgrid::mc::Snapshot* take_snapshot(int num_state) const;
  86
  87   // SESSION FUNCTIONS
  88   void s_initialize() const;
  89   void s_close() const;
  90   void s_restore_initial_state() const;
  91   void execute(Transition const& transition);
  92   void s_log_state() const;
  93 };
  94
  95 } // namespace mc
  96 } // namespace simgrid
  97
  98 #endif