src/mc/api/State.hpp

   1 /* Copyright (c) 2007-2023. The SimGrid Team. All rights reserved.          */
   2
   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. */
   5
   6 #ifndef SIMGRID_MC_STATE_HPP
   7 #define SIMGRID_MC_STATE_HPP
   8
   9 #include "src/mc/api/ActorState.hpp"
  10 #include "src/mc/api/RemoteApp.hpp"
  11 #include "src/mc/sosp/Snapshot.hpp"
  12 #include "src/mc/transition/Transition.hpp"
  13
  14 namespace simgrid::mc {
  15
  16 /* A node in the exploration graph (kind-of) */
  17 class XBT_PRIVATE State : public xbt::Extendable<State> {
  18   static long expended_states_; /* Count total amount of states, for stats */
  19
  20   /**
  21    * @brief The outgoing transition: what was the last transition that
  22    * we took to leave this state?
  23    *
  24    * The owner of the transition is the `ActorState` instance which exists in this state,
  25    * or a reference to the internal default transition `Transition()` if no transition has been
  26    * set
  27    */
  28   Transition* transition_ = nullptr;
  29
  30   /**
  31    * @brief An empty transition that leads to this state by default
  32    */
  33   const std::unique_ptr<Transition> default_transition;
  34
  35   /** Sequential state ID (used for debugging) */
  36   long num_ = 0;
  37
  38   /** State's exploration status by actor. Not all the actors are there, only the ones that are ready-to-run in this
  39    * state */
  40   std::map<aid_t, ActorState> actors_to_run_;
  41
  42   /** Snapshot of system state (if needed) */
  43   std::shared_ptr<Snapshot> system_state_;
  44
  45 public:
  46   explicit State(const RemoteApp& remote_app);
  47
  48   /* Returns a positive number if there is another transition to pick, or -1 if not */
  49   aid_t next_transition() const;
  50
  51   /* Explore a new path; the parameter must be the result of a previous call to next_transition() */
  52   void execute_next(aid_t next);
  53
  54   long get_num() const { return num_; }
  55   std::size_t count_todo() const;
  56   void mark_todo(aid_t actor) { actors_to_run_.at(actor).mark_todo(); }
  57   bool is_done(aid_t actor) const { return actors_to_run_.at(actor).is_done(); }
  58   Transition* get_transition() const;
  59   void set_transition(Transition* t) { transition_ = t; }
  60   std::map<aid_t, ActorState> const& get_actors_list() const { return actors_to_run_; }
  61
  62   unsigned long get_actor_count() const { return actors_to_run_.size(); }
  63   bool is_actor_enabled(aid_t actor) { return actors_to_run_.at(actor).is_enabled(); }
  64
  65   Snapshot* get_system_state() const { return system_state_.get(); }
  66   void set_system_state(std::shared_ptr<Snapshot> state) { system_state_ = std::move(state); }
  67
  68   /* Returns the total amount of states created so far (for statistics) */
  69   static long get_expanded_states() { return expended_states_; }
  70 };
  71 } // namespace simgrid::mc
  72
  73 #endif