src/mc/checker/SimcallInspector.hpp

   1 /* Copyright (c) 2019-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_SIMCALL_INSPECTOR_HPP
   7 #define SIMGRID_MC_SIMCALL_INSPECTOR_HPP
   8
   9 #include <string>
  10
  11 namespace simgrid {
  12 namespace mc {
  13
  14 class SimcallInspector {
  15 public:
  16   /** Whether this transition can currently be taken without blocking.
  17    *
  18    * For example, a mutex_lock is not enabled when the mutex is not free.
  19    * A comm_receive is not enabled before the corresponding send has been issued.
  20    */
  21   virtual bool is_enabled() { return true; }
  22
  23   /** Prepare the simcall to be executed
  24    *
  25    * Do the choices that the platform would have done in non-MC settings.
  26    * For example if it's a waitany, pick the communication that should finish first.
  27    * If it's a random(), choose the next value to explore.
  28    */
  29   virtual void arm() {}
  30
  31   /** Some simcalls may only be observable under some circumstances.
  32    * Most simcalls are not visible from the MC because they don't have an inspector at all. */
  33   virtual bool is_visible() { return true; }
  34   virtual std::string to_string() = 0;
  35   virtual std::string dot_label() = 0;
  36 };
  37 } // namespace mc
  38 } // namespace simgrid
  39
  40 #endif