Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
add boolean state to resources and protect set_core_count
[simgrid.git] / include / simgrid / kernel / resource / Resource.hpp
index 3ae1096..9be92f6 100644 (file)
@@ -1,4 +1,4 @@
-/* Copyright (c) 2004-2018. The SimGrid Team. All rights reserved.          */
+/* Copyright (c) 2004-2021. The SimGrid Team. All rights reserved.          */
 
 /* This program is free software; you can redistribute it and/or modify it
  * under the terms of the license (GNU LGPL) which comes with this package. */
@@ -6,6 +6,7 @@
 #ifndef SIMGRID_KERNEL_RESOURCE_RESOURCE_HPP
 #define SIMGRID_KERNEL_RESOURCE_RESOURCE_HPP
 
+#include "src/kernel/lmm/maxmin.hpp" // Constraint
 #include <simgrid/forward.h>
 #include <xbt/signal.hpp>
 #include <xbt/str.h>
@@ -19,75 +20,79 @@ namespace resource {
 
 /** @ingroup SURF_interface
  * @brief SURF resource interface class
- * @details This is the ancestor class of every resources in SimGrid, such as links, CPU or storage
+ * @details This is the ancestor class of every resources in SimGrid, such as links, CPU or disk
  */
 class XBT_PUBLIC Resource {
-public:
-  /**
-   * @brief Constructor of LMM Resources
-   *
-   * @param model Model associated to this Resource
-   * @param name The name of the Resource
-   * @param constraint The lmm constraint associated to this Resource if it is part of a LMM component
-   */
-  Resource(Model* model, const std::string& name, lmm::Constraint* constraint);
+  std::string name_ = "unnamed";
+  bool is_on_       = true;
+  bool sealed_      = false;
 
-  virtual ~Resource();
+protected:
+  struct Metric {
+    double peak;           /**< The peak of the metric, ie its max value */
+    double scale;          /**< Current availability of the metric according to the profiles, in [0,1] */
+    profile::Event* event; /**< The associated profile event associated to the metric */
+  };
+  profile::Event* state_event_ = nullptr;
 
-  /** @brief Get the Model of the current Resource */
-  Model* get_model() const;
+public:
+  Resource(const std::string& name) : name_(name){};
+  virtual ~Resource() = default;
+  virtual void seal() { sealed_ = true; }
 
   /** @brief Get the name of the current Resource */
-  const std::string& get_name() const;
+  const std::string& get_name() const { return name_; }
   /** @brief Get the name of the current Resource */
-  const char* get_cname() const;
+  const char* get_cname() const { return name_.c_str(); }
 
-  bool operator==(const Resource& other) const;
+  bool operator==(const Resource& other) const { return name_ == other.name_; }
 
   /** @brief Apply an event of external load event to that resource */
-  virtual void apply_event(TraceEvent* event, double value) = 0;
+  virtual void apply_event(profile::Event* event, double value) = 0;
 
   /** @brief Check if the current Resource is used (if it currently serves an action) */
-  virtual bool is_used() = 0;
-
-  /** @brief returns the current load due to activities (in flops per second, byte per second or similar)
-   *
-   * The load due to external usages modeled by trace files is ignored.*/
-  virtual double get_load();
+  virtual bool is_used() const = 0;
 
   /** @brief Check if the current Resource is active */
-  virtual bool is_on() const;
-  /** @brief Check if the current Resource is shut down */
-  virtual bool is_off() const;
+  virtual bool is_on() const { return is_on_; }
+  virtual bool is_sealed() const { return sealed_; }
+
   /** @brief Turn on the current Resource */
-  virtual void turn_on();
+  virtual void turn_on() { is_on_ = true; }
   /** @brief Turn off the current Resource */
-  virtual void turn_off();
-  /** @brief setup the trace file with states events (ON or OFF). Trace must contain boolean values. */
-  virtual void set_state_trace(tmgr_trace_t trace);
+  virtual void turn_off() { is_on_ = false; }
+  /** @brief setup the profile file with states events (ON or OFF). The profile must contain boolean values. */
+  virtual void set_state_profile(profile::Profile* profile);
+};
+
+template <class AnyResource> class Resource_T : public Resource {
+  Model* model_                = nullptr;
+  lmm::Constraint* constraint_ = nullptr;
 
-private:
-  std::string name_;
-  Model* model_;
-  bool is_on_ = true;
+public:
+  using Resource::Resource;
+  AnyResource* set_model(Model* model)
+  {
+    model_ = model;
+    return static_cast<AnyResource*>(this);
+  }
 
-public: /* LMM */
-  /** @brief Get the lmm constraint associated to this Resource if it is part of a LMM component (or null if none) */
-  lmm::Constraint* get_constraint() const;
+  Model* get_model() const { return model_; }
 
-private:
-  kernel::lmm::Constraint* const constraint_ = nullptr;
+  AnyResource* set_constraint(lmm::Constraint* constraint)
+  {
+    constraint_ = constraint;
+    return static_cast<AnyResource*>(this);
+  }
 
-public:
-  TraceEvent* state_event_ = nullptr;
+  lmm::Constraint* get_constraint() const { return constraint_; }
 
-protected:
-  struct Metric {
-    double peak;       /**< The peak of the metric, ie its max value */
-    double scale;      /**< Current availability of the metric according to the traces, in [0,1] */
-    TraceEvent* event; /**< The associated trace event associated to the metric */
-  };
+  /** @brief returns the current load due to activities (in flops per second, byte per second or similar)
+   *
+   * The load due to external usages modeled by profile files is ignored.*/
+  virtual double get_load() const { return constraint_->get_usage(); }
 };
+
 } // namespace resource
 } // namespace kernel
 } // namespace simgrid