Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Fix the doc of S4U: s/process/actor/
[simgrid.git] / include / simgrid / s4u / Storage.hpp
1 /* Copyright (c) 2006-2015, 2017. The SimGrid Team.
2  * All rights reserved.                                                     */
3
4 /* This program is free software; you can redistribute it and/or modify it
5  * under the terms of the license (GNU LGPL) which comes with this package. */
6
7 #ifndef INCLUDE_SIMGRID_S4U_STORAGE_HPP_
8 #define INCLUDE_SIMGRID_S4U_STORAGE_HPP_
9
10 #include <map>
11 #include <simgrid/s4u/forward.hpp>
12 #include <simgrid/simix.h>
13 #include <string>
14 #include <unordered_map>
15 #include <xbt/base.h>
16
17 namespace simgrid {
18 namespace s4u {
19
20 XBT_ATTRIB_PUBLIC std::map<std::string, Storage*>* allStorages();
21
22 XBT_PUBLIC_CLASS Storage
23 {
24   friend s4u::Engine;
25   friend simgrid::surf::StorageImpl;
26
27 public:
28   explicit Storage(surf::StorageImpl * pimpl) : pimpl_(pimpl) {}
29   virtual ~Storage() = default;
30   /** Retrieve a Storage by its name. It must exist in the platform file */
31   static Storage* byName(std::string name);
32   /** @brief Retrieves the name of that storage as a C++ string */
33   std::string const& getName() const;
34   /** @brief Retrieves the name of that storage as a C string */
35   const char* getCname() const;
36   const char* getType();
37   Host* getHost();
38   sg_size_t getSize(); /** Retrieve the total amount of space of this storage element */
39   sg_size_t getSizeFree();
40   sg_size_t getSizeUsed();
41
42   std::map<std::string, std::string>* getProperties();
43   const char* getProperty(std::string key);
44   void setProperty(std::string, std::string value);
45   std::map<std::string, sg_size_t>* getContent();
46
47   void setUserdata(void* data) { userdata_ = data; }
48   void* getUserdata() { return userdata_; }
49
50   surf::StorageImpl* getImpl() { return pimpl_; }
51
52   /* The signals */
53   /** @brief Callback signal fired when a new Link is created */
54   static simgrid::xbt::signal<void(s4u::Storage&)> onCreation;
55
56   /** @brief Callback signal fired when a Link is destroyed */
57   static simgrid::xbt::signal<void(s4u::Storage&)> onDestruction;
58
59   Host* attached_to_              = nullptr;
60
61 private:
62   surf::StorageImpl* const pimpl_ = nullptr;
63   std::string name_;
64   void* userdata_ = nullptr;
65 };
66
67 } /* namespace s4u */
68 } /* namespace simgrid */
69
70 #endif /* INCLUDE_SIMGRID_S4U_STORAGE_HPP_ */