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"
11 #include "src/mc/mc_record.hpp"
12 #include "xbt/automaton.hpp"
19 ** This class aimes to implement FACADE APIs for simgrid. The FACADE layer sits between the CheckerSide
20 ** (Unfolding_Checker, DPOR, ...) layer and the
21 ** AppSide layer. The goal is to drill down into the entagled details in the CheckerSide layer and break down the
22 ** detailes in a way that the CheckerSide eventually
23 ** be capable to acquire the required information through the FACADE layer rather than the direct access to the AppSide.
30 struct DerefAndCompareByActorsCountAndUsedHeap {
31 template <class X, class Y> bool operator()(X const& a, Y const& b) const
33 return std::make_pair(a->actors_count, a->heap_bytes_used) < std::make_pair(b->actors_count, b->heap_bytes_used);
40 Api(Api const&) = delete;
41 void operator=(Api const&) = delete;
49 void initialize(char** argv) const;
52 std::vector<simgrid::mc::ActorInformation>& get_actors() const;
53 bool actor_is_enabled(aid_t pid) const;
54 unsigned long get_maxpid() const;
55 int get_actors_size() const;
58 bool comm_addr_equal(const kernel::activity::CommImpl* comm_addr1, const kernel::activity::CommImpl* comm_addr2) const;
59 RemotePtr<kernel::activity::CommImpl> get_comm_isend_raw_addr(smx_simcall_t request) const;
60 kernel::activity::CommImpl* get_comm_wait_raw_addr(smx_simcall_t request) const;
61 kernel::activity::CommImpl* get_comm_waitany_raw_addr(smx_simcall_t request, int value) const;
62 std::string get_pattern_comm_rdv(RemotePtr<kernel::activity::CommImpl> const& addr) const;
63 unsigned long get_pattern_comm_src_proc(void* addr) const;
64 unsigned long get_pattern_comm_dst_proc(void* addr) const;
65 std::vector<char> get_pattern_comm_data(RemotePtr<kernel::activity::CommImpl> const& addr) const;
66 const char* get_actor_host_name(smx_actor_t actor) const;
68 bool check_send_request_detached(smx_simcall_t const& simcall) const;
70 smx_actor_t get_src_actor(const kernel::activity::CommImpl* comm_addr) const;
71 smx_actor_t get_dst_actor(const kernel::activity::CommImpl* comm_addr) const;
74 std::size_t get_remote_heap_bytes() const;
77 void mc_inc_visited_states() const;
78 void mc_inc_executed_trans() const;
79 unsigned long mc_get_visited_states() const;
80 unsigned long mc_get_executed_trans() const;
81 bool mc_check_deadlock() const;
82 void mc_show_deadlock() const;
83 bool mc_is_null() const;
84 Checker* mc_get_checker() const;
85 void set_checker(Checker* const checker) const;
86 void handle_simcall(Transition const& transition) const;
87 void mc_wait_for_requests() const;
88 XBT_ATTRIB_NORETURN void mc_exit(int status) const;
89 std::string const& mc_get_host_name(std::string const& hostname) const;
90 void dump_record_path() const;
91 smx_simcall_t mc_state_choose_request(simgrid::mc::State* state) const;
94 std::string request_to_string(smx_simcall_t req, int value, RequestType request_type) const;
95 std::string request_get_dot_output(smx_simcall_t req, int value) const;
96 const char *simcall_get_name(simgrid::simix::Simcall kind) const;
97 smx_actor_t simcall_get_issuer(s_smx_simcall const* req) const;
98 long simcall_get_actor_id(s_smx_simcall const* req) const;
99 smx_mailbox_t simcall_get_mbox(smx_simcall_t const req) const;
100 bool simcall_check_dependency(smx_simcall_t const req1, smx_simcall_t const req2) const;
103 int get_smpi_request_tag(smx_simcall_t const& simcall, simgrid::simix::Simcall type) const;
107 void restore_state(std::shared_ptr<simgrid::mc::Snapshot> system_state) const;
108 void log_state() const;
109 void restore_initial_state() const;
112 bool snapshot_equal(const Snapshot* s1, const Snapshot* s2) const;
113 simgrid::mc::Snapshot* take_snapshot(int num_state) const;
116 void session_initialize() const;
117 void s_close() const;
118 void execute(Transition const& transition) const;
122 void automaton_load(const char *file) const;
124 std::vector<int> automaton_propositional_symbol_evaluate() const;
125 std::vector<xbt_automaton_state_t> get_automaton_state() const;
126 int compare_automaton_exp_label(const xbt_automaton_exp_label* l) const;
127 void set_property_automaton(xbt_automaton_state_t const& automaton_state) const;
128 inline DerefAndCompareByActorsCountAndUsedHeap compare_pair() const {
129 return DerefAndCompareByActorsCountAndUsedHeap();
131 inline int automaton_state_compare(const_xbt_automaton_state_t const& s1, const_xbt_automaton_state_t const& s2) const {
132 return xbt_automaton_state_compare(s1, s2);
134 xbt_automaton_exp_label_t get_automaton_transition_label(xbt_dynar_t const& dynar, int index) const;
135 xbt_automaton_state_t get_automaton_transition_dst(xbt_dynar_t const& dynar, int index) const;
138 inline unsigned long get_dynar_length(const_xbt_dynar_t const& dynar) const {
139 return xbt_dynar_length(dynar);
144 } // namespace simgrid