1 #ifndef SIMGRID_MC_API_HPP
2 #define SIMGRID_MC_API_HPP
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"
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.
30 mc_api(mc_api const&) = delete;
31 void operator=(mc_api const&) = delete;
39 void initialize(char** argv);
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 int get_actors_size() const;
48 void copy_incomplete_comm_pattern(const simgrid::mc::State* state) const;
49 void copy_index_comm_pattern(const simgrid::mc::State* state) const;
50 kernel::activity::CommImpl* get_pattern_comm_addr(smx_simcall_t request) const;
51 std::string get_pattern_comm_rdv(void* addr) const;
52 unsigned long get_pattern_comm_src_proc(void* addr) const;
53 unsigned long get_pattern_comm_dst_proc(void* addr) const;
54 std::vector<char> get_pattern_comm_data(void* addr) const;
55 std::vector<char> get_pattern_comm_data(mc::RemotePtr<kernel::activity::CommImpl> const& comm_addr) const;
56 const char* get_actor_host_name(smx_actor_t actor) const;
57 bool check_send_request_detached(smx_simcall_t const& simcall) const;
58 smx_actor_t get_src_actor(mc::RemotePtr<kernel::activity::CommImpl> const& comm_addr) const;
59 smx_actor_t get_dst_actor(mc::RemotePtr<kernel::activity::CommImpl> const& comm_addr) const;
62 std::size_t get_remote_heap_bytes() const;
65 ModelChecker* get_model_checker() const;
66 void mc_inc_visited_states() const;
67 void mc_inc_executed_trans() const;
68 unsigned long mc_get_visited_states() const;
69 unsigned long mc_get_executed_trans() const;
70 bool mc_check_deadlock() const;
71 void mc_show_deadlock() const;
72 smx_actor_t mc_smx_simcall_get_issuer(s_smx_simcall const* req) const;
73 bool mc_is_null() const;
74 Checker* mc_get_checker() const;
75 RemoteSimulation& mc_get_remote_simulation() const;
76 void handle_simcall(Transition const& transition) const;
77 void mc_wait_for_requests() const;
78 void mc_exit(int status) const;
79 std::string const& mc_get_host_name(std::string const& hostname) const;
80 void mc_dump_record_path() const;
81 smx_simcall_t mc_state_choose_request(simgrid::mc::State* state) const;
84 bool request_depend(smx_simcall_t req1, smx_simcall_t req2) const;
85 std::string request_to_string(smx_simcall_t req, int value, RequestType request_type) const;
86 std::string request_get_dot_output(smx_simcall_t req, int value) const;
87 const char *simix_simcall_name(simgrid::simix::Simcall kind) const;
89 int get_smpi_request_tag(smx_simcall_t const& simcall, simgrid::simix::Simcall type) const;
93 void restore_state(std::shared_ptr<simgrid::mc::Snapshot> system_state) const;
94 void log_state() const;
95 void restore_initial_state() const;
98 bool snapshot_equal(const Snapshot* s1, const Snapshot* s2) const;
99 simgrid::mc::Snapshot* take_snapshot(int num_state) const;
102 void s_initialize() const;
103 void s_close() const;
104 void execute(Transition const& transition);
108 } // namespace simgrid