src/mc/Session.hpp

   1 /* Copyright (c) 2016-2020. 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_SESSION_HPP
   7 #define SIMGRID_MC_SESSION_HPP
   8
   9 #include "simgrid/forward.h"
  10 #include "src/mc/ModelChecker.hpp"
  11
  12 #include <functional>
  13
  14 namespace simgrid {
  15 namespace mc {
  16
  17 /** A model-checking session
  18  *
  19  *  This is expected to become the interface used by model-checking
  20  *  algorithms to control the execution of the model-checked process
  21  *  and the exploration of the execution graph. Model-checking
  22  *  algorithms should be able to be written in high-level languages
  23  *  (e.g. Python) using bindings on this interface.
  24  */
  25 class XBT_PUBLIC Session {
  26 private:
  27   std::unique_ptr<ModelChecker> model_checker_;
  28   std::shared_ptr<simgrid::mc::Snapshot> initial_snapshot_;
  29
  30   // No copy:
  31   Session(Session const&) = delete;
  32   Session& operator=(Session const&) = delete;
  33
  34 public:
  35   /** Create a new session by executing the provided code in a fork()
  36    *
  37    *  This sets up the environment for the model-checked process
  38    *  (environment variables, sockets, etc.).
  39    *
  40    *  The code is expected to `exec` the model-checked application.
  41    */
  42   explicit Session(const std::function<void()>& code);
  43
  44   ~Session();
  45   void close();
  46
  47   void initialize();
  48   void execute(Transition const& transition) const;
  49   void log_state() const;
  50
  51   void restore_initial_state() const;
  52   bool actor_is_enabled(aid_t pid) const;
  53 };
  54
  55 // Temporary :)
  56 extern simgrid::mc::Session* session;
  57
  58 }
  59 }
  60
  61 #endif