Logo AND Algorithmique Numérique Distribuée

Public GIT Repository
Merge branch 'master' of scm.gforge.inria.fr:/gitroot/simgrid/simgrid
[simgrid.git] / src / mc / AddressSpace.hpp
1 /* Copyright (c) 2008-2015. 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 SIMGRID_MC_ADDRESS_SPACE_H
8 #define SIMGRID_MC_ADDRESS_SPACE_H
9
10 #include <cassert>
11 #include <cstddef>
12 #include <cstdint>
13 #include <cstring>
14 #include <type_traits>
15
16 #include <string>
17 #include <vector>
18
19 #include "src/mc/mc_forward.hpp"
20 #include "src/mc/remote/RemotePtr.hpp"
21
22 namespace simgrid {
23 namespace mc {
24
25 /** Process index used when no process is available (SMPI privatization)
26  *
27  *  The expected behavior is that if a process index is needed it will fail.
28  * */
29 const int ProcessIndexMissing = -1;
30
31 /** Process index used when we don't care about the process index (SMPI privatization)
32  * */
33 const int ProcessIndexDisabled = -2;
34
35 /** Constant used when any process will do (SMPI privatization)
36  *
37  *  Note: This is is index of the first process.
38  */
39 const int ProcessIndexAny = 0;
40
41 /** Options for read operations
42  *
43  *  This is a set of flags managed with bitwise operators. Only the
44  *  meaningful operations are defined: addition, conversions to/from
45  *  integers are not allowed.
46  */
47 class ReadOptions {
48   std::uint32_t value_;
49   constexpr explicit ReadOptions(std::uint32_t value) : value_(value) {}
50 public:
51   constexpr ReadOptions() : value_(0) {}
52
53   explicit constexpr operator bool() const { return value_ != 0; }
54   constexpr bool operator!() const { return value_ == 0; }
55
56   constexpr ReadOptions operator|(ReadOptions const& that) const
57   {
58     return ReadOptions(value_ | that.value_);
59   }
60   constexpr ReadOptions operator&(ReadOptions const& that) const
61   {
62     return ReadOptions(value_ & that.value_);
63   }
64   constexpr ReadOptions operator^(ReadOptions const& that) const
65   {
66     return ReadOptions(value_ ^ that.value_);
67   }
68   constexpr ReadOptions operator~() const
69   {
70     return ReadOptions(~value_);
71   }
72
73   ReadOptions& operator|=(ReadOptions const& that)
74   {
75     value_ |= that.value_;
76     return *this;
77   }
78   ReadOptions& operator&=(ReadOptions const& that)
79   {
80     value_ &= that.value_;
81     return *this;
82   }
83   ReadOptions& operator^=(ReadOptions const& that)
84   {
85     value_ &= that.value_;
86     return *this;
87   }
88
89   /** Copy the data to the given buffer */
90   static constexpr ReadOptions none() { return ReadOptions(0); }
91
92   /** Allows to return a pointer to another buffer where the data is
93    *  available instead of copying the data into the buffer
94    */
95   static constexpr ReadOptions lazy() { return ReadOptions(1); }
96 };
97
98 /** A given state of a given process (abstract base class)
99  *
100  *  Currently, this might either be:
101  *
102  *  * the current state of an existing process;
103  *
104  *  * a snapshot.
105  *
106  *  In order to support SMPI privatization, the can read the memory from the
107  *  context of a given SMPI process: if specified, the code reads data from the
108  *  correct SMPI privatization VMA.
109  */
110 class AddressSpace {
111 private:
112   Process* process_;
113 public:
114   explicit AddressSpace(Process* process) : process_(process) {}
115   virtual ~AddressSpace() = default;
116
117   /** The process of this addres space
118    *
119    *  This is where we can get debug informations, memory layout, etc.
120    */
121   simgrid::mc::Process* process() const { return process_; }
122
123   /** Read data from the address space
124    *
125    *  @param buffer        target buffer for the data
126    *  @param size          number of bytes to read
127    *  @param address       remote source address of the data
128    *  @param process_index which process (used for SMPI privatization)
129    *  @param options
130    */
131   virtual const void* read_bytes(void* buffer, std::size_t size,
132     RemotePtr<void> address, int process_index = ProcessIndexAny,
133     ReadOptions options = ReadOptions::none()) const = 0;
134
135   /** Read a given data structure from the address space */
136   template<class T> inline
137   void read(T *buffer, RemotePtr<T> ptr, int process_index = ProcessIndexAny) const
138   {
139     this->read_bytes(buffer, sizeof(T), ptr, process_index);
140   }
141
142   template<class T> inline
143   void read(Remote<T>& buffer, RemotePtr<T> ptr, int process_index = ProcessIndexAny) const
144   {
145     this->read_bytes(buffer.getBuffer(), sizeof(T), ptr, process_index);
146   }
147
148   /** Read a given data structure from the addres space
149    *
150    *  This version returns by value.
151    */
152   template<class T> inline
153   Remote<T> read(RemotePtr<T> ptr, int process_index = ProcessIndexMissing) const
154   {
155     Remote<T> res;
156     this->read_bytes(&res, sizeof(T), ptr, process_index);
157     return res;
158   }
159
160   /** Read a string of known size */
161   std::string read_string(RemotePtr<char> address, std::size_t len) const
162   {
163     std::string res;
164     res.resize(len);
165     this->read_bytes(&res[0], len, address);
166     return res;
167   }
168
169 };
170
171 }
172 }
173
174 #endif