X-Git-Url: http://bilbo.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/1f7b8e8c82729f1d274419748e04fcca6b909d3b..77acc38a35db79181c828c39e056c890462ab70b:/src/kernel/resource/Resource.hpp diff --git a/src/kernel/resource/Resource.hpp b/src/kernel/resource/Resource.hpp new file mode 100644 index 0000000000..1d0e92ebf2 --- /dev/null +++ b/src/kernel/resource/Resource.hpp @@ -0,0 +1,127 @@ +/* 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. */ + +#ifndef SIMGRID_KERNEL_RESOURCE_RESOURCE_HPP +#define SIMGRID_KERNEL_RESOURCE_RESOURCE_HPP + +#include "simgrid/forward.h" +#include "src/kernel/lmm/maxmin.hpp" // Constraint +#include "src/kernel/resource/profile/Event.hpp" +#include "src/kernel/resource/profile/FutureEvtSet.hpp" +#include "src/kernel/resource/profile/Profile.hpp" +#include "xbt/signal.hpp" +#include "xbt/str.h" +#include "xbt/utility.hpp" + +#include + +namespace simgrid { +namespace kernel { +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 disk + */ +class XBT_PUBLIC Resource { + std::string name_ = "unnamed"; + bool is_on_ = true; + bool sealed_ = false; + profile::Event* state_event_ = nullptr; + +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 */ + }; + + virtual profile::Event* get_state_event() const { return state_event_; } + virtual void set_state_event(profile::Event* evt) { state_event_ = evt; } + virtual void unref_state_event() { tmgr_trace_event_unref(&state_event_); } + +public: + explicit 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 { return name_; } + /** @brief Get the name of the current Resource */ + const char* get_cname() const { return name_.c_str(); } + + 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(profile::Event* event, double value) = 0; + + /** @brief Check if the current Resource is active */ + virtual bool is_on() const { return is_on_; } + virtual bool is_sealed() const { return sealed_; } + + /** @brief Check if the current Resource is used (if it currently serves an action) */ + virtual bool is_used() const = 0; + /** @brief Turn on the current Resource */ + virtual void turn_on() { is_on_ = true; } + /** @brief Turn off the current Resource */ + virtual void turn_off() { is_on_ = false; } +}; + +template class Resource_T : public Resource { + Model* model_ = nullptr; + lmm::Constraint* constraint_ = nullptr; + +public: + using Resource::Resource; + /** @brief setup the profile file with states events (ON or OFF). The profile must contain boolean values. */ + AnyResource* set_state_profile(profile::Profile* profile) + { + if (profile) { + xbt_assert(get_state_event() == nullptr, "Cannot set a second state profile to %s", get_cname()); + set_state_event(profile->schedule(&profile::future_evt_set, this)); + } + + return static_cast(this); + } + + AnyResource* set_model(Model* model) + { + model_ = model; + return static_cast(this); + } + + Model* get_model() const { return model_; } + + AnyResource* set_constraint(lmm::Constraint* constraint) + { + constraint_ = constraint; + return static_cast(this); + } + + lmm::Constraint* get_constraint() const { return constraint_; } + + /** @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(); } + + bool is_used() const override { return model_->get_maxmin_system()->constraint_used(constraint_); } +}; + +} // namespace resource +} // namespace kernel +} // namespace simgrid + +namespace std { +template <> class hash { +public: + std::size_t operator()(const simgrid::kernel::resource::Resource& r) const + { + return (std::size_t)xbt_str_hash(r.get_cname()); + } +}; +} // namespace std + +#endif