1 /* Copyright (c) 2020-2022. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
6 #ifndef SIMGRID_MC_API_HPP
7 #define SIMGRID_MC_API_HPP
12 #include "simgrid/forward.h"
13 #include "src/mc/api/RemoteApp.hpp"
14 #include "src/mc/api/State.hpp"
15 #include "src/mc/mc_forward.hpp"
16 #include "src/mc/mc_record.hpp"
17 #include "xbt/automaton.hpp"
20 namespace simgrid::mc {
22 XBT_DECLARE_ENUM_CLASS(ExplorationAlgorithm, Safety, UDPOR, Liveness, CommDeterminism);
25 ** This class aimes to implement FACADE APIs for simgrid. The FACADE layer sits between the CheckerSide
26 ** (Unfolding_Checker, DPOR, ...) layer and the
27 ** AppSide layer. The goal is to drill down into the entagled details in the CheckerSide layer and break down the
28 ** detailes in a way that the CheckerSide eventually
29 ** be capable to acquire the required information through the FACADE layer rather than the direct access to the AppSide.
36 struct DerefAndCompareByActorsCountAndUsedHeap {
37 template <class X, class Y> bool operator()(X const& a, Y const& b) const
39 return std::make_pair(a->actor_count_, a->heap_bytes_used) < std::make_pair(b->actor_count_, b->heap_bytes_used);
43 std::unique_ptr<simgrid::mc::RemoteApp> remote_app_;
47 Api(Api const&) = delete;
48 void operator=(Api const&) = delete;
56 simgrid::mc::Exploration* initialize(char** argv, const std::unordered_map<std::string, std::string>& env,
57 simgrid::mc::ExplorationAlgorithm algo);
60 std::size_t get_remote_heap_bytes() const;
63 void mc_inc_visited_states() const;
64 unsigned long mc_get_visited_states() const;
67 void restore_state(const Snapshot* system_state) const;
70 bool snapshot_equal(const Snapshot* s1, const Snapshot* s2) const;
71 simgrid::mc::Snapshot* take_snapshot(long num_state) const;
77 void automaton_load(const char* file) const;
78 std::vector<int> automaton_propositional_symbol_evaluate() const;
79 std::vector<xbt_automaton_state_t> get_automaton_state() const;
80 int compare_automaton_exp_label(const xbt_automaton_exp_label* l) const;
81 void set_property_automaton(xbt_automaton_state_t const& automaton_state) const;
82 inline DerefAndCompareByActorsCountAndUsedHeap compare_pair() const
84 return DerefAndCompareByActorsCountAndUsedHeap();
86 xbt_automaton_exp_label_t get_automaton_transition_label(xbt_dynar_t const& dynar, int index) const;
87 xbt_automaton_state_t get_automaton_transition_dst(xbt_dynar_t const& dynar, int index) const;
90 } // namespace simgrid::mc