xref: /aosp_15_r20/system/unwinding/libunwindstack/include/unwindstack/DwarfMemory.h (revision eb293b8f56ee8303637c5595cfcdeef8039e85c6)
1*eb293b8fSAndroid Build Coastguard Worker /*
2*eb293b8fSAndroid Build Coastguard Worker  * Copyright (C) 2016 The Android Open Source Project
3*eb293b8fSAndroid Build Coastguard Worker  *
4*eb293b8fSAndroid Build Coastguard Worker  * Licensed under the Apache License, Version 2.0 (the "License");
5*eb293b8fSAndroid Build Coastguard Worker  * you may not use this file except in compliance with the License.
6*eb293b8fSAndroid Build Coastguard Worker  * You may obtain a copy of the License at
7*eb293b8fSAndroid Build Coastguard Worker  *
8*eb293b8fSAndroid Build Coastguard Worker  *      http://www.apache.org/licenses/LICENSE-2.0
9*eb293b8fSAndroid Build Coastguard Worker  *
10*eb293b8fSAndroid Build Coastguard Worker  * Unless required by applicable law or agreed to in writing, software
11*eb293b8fSAndroid Build Coastguard Worker  * distributed under the License is distributed on an "AS IS" BASIS,
12*eb293b8fSAndroid Build Coastguard Worker  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13*eb293b8fSAndroid Build Coastguard Worker  * See the License for the specific language governing permissions and
14*eb293b8fSAndroid Build Coastguard Worker  * limitations under the License.
15*eb293b8fSAndroid Build Coastguard Worker  */
16*eb293b8fSAndroid Build Coastguard Worker 
17*eb293b8fSAndroid Build Coastguard Worker #pragma once
18*eb293b8fSAndroid Build Coastguard Worker 
19*eb293b8fSAndroid Build Coastguard Worker #include <stdint.h>
20*eb293b8fSAndroid Build Coastguard Worker 
21*eb293b8fSAndroid Build Coastguard Worker #include <memory>
22*eb293b8fSAndroid Build Coastguard Worker 
23*eb293b8fSAndroid Build Coastguard Worker namespace unwindstack {
24*eb293b8fSAndroid Build Coastguard Worker 
25*eb293b8fSAndroid Build Coastguard Worker // Forward declarations.
26*eb293b8fSAndroid Build Coastguard Worker class Memory;
27*eb293b8fSAndroid Build Coastguard Worker 
28*eb293b8fSAndroid Build Coastguard Worker class DwarfMemory {
29*eb293b8fSAndroid Build Coastguard Worker  public:
DwarfMemory(std::shared_ptr<Memory> & memory)30*eb293b8fSAndroid Build Coastguard Worker   DwarfMemory(std::shared_ptr<Memory>& memory) : memory_(memory) {}
31*eb293b8fSAndroid Build Coastguard Worker   virtual ~DwarfMemory() = default;
32*eb293b8fSAndroid Build Coastguard Worker 
33*eb293b8fSAndroid Build Coastguard Worker   bool ReadBytes(void* dst, size_t num_bytes);
34*eb293b8fSAndroid Build Coastguard Worker 
35*eb293b8fSAndroid Build Coastguard Worker   template <typename SignedType>
36*eb293b8fSAndroid Build Coastguard Worker   bool ReadSigned(uint64_t* value);
37*eb293b8fSAndroid Build Coastguard Worker 
38*eb293b8fSAndroid Build Coastguard Worker   bool ReadULEB128(uint64_t* value);
39*eb293b8fSAndroid Build Coastguard Worker 
40*eb293b8fSAndroid Build Coastguard Worker   bool ReadSLEB128(int64_t* value);
41*eb293b8fSAndroid Build Coastguard Worker 
42*eb293b8fSAndroid Build Coastguard Worker   template <typename AddressType>
43*eb293b8fSAndroid Build Coastguard Worker   size_t GetEncodedSize(uint8_t encoding);
44*eb293b8fSAndroid Build Coastguard Worker 
45*eb293b8fSAndroid Build Coastguard Worker   bool AdjustEncodedValue(uint8_t encoding, uint64_t* value);
46*eb293b8fSAndroid Build Coastguard Worker 
47*eb293b8fSAndroid Build Coastguard Worker   template <typename AddressType>
48*eb293b8fSAndroid Build Coastguard Worker   bool ReadEncodedValue(uint8_t encoding, uint64_t* value);
49*eb293b8fSAndroid Build Coastguard Worker 
cur_offset()50*eb293b8fSAndroid Build Coastguard Worker   uint64_t cur_offset() { return cur_offset_; }
set_cur_offset(uint64_t cur_offset)51*eb293b8fSAndroid Build Coastguard Worker   void set_cur_offset(uint64_t cur_offset) { cur_offset_ = cur_offset; }
52*eb293b8fSAndroid Build Coastguard Worker 
set_pc_offset(int64_t offset)53*eb293b8fSAndroid Build Coastguard Worker   void set_pc_offset(int64_t offset) { pc_offset_ = offset; }
clear_pc_offset()54*eb293b8fSAndroid Build Coastguard Worker   void clear_pc_offset() { pc_offset_ = INT64_MAX; }
55*eb293b8fSAndroid Build Coastguard Worker 
set_data_offset(uint64_t offset)56*eb293b8fSAndroid Build Coastguard Worker   void set_data_offset(uint64_t offset) { data_offset_ = offset; }
clear_data_offset()57*eb293b8fSAndroid Build Coastguard Worker   void clear_data_offset() { data_offset_ = static_cast<uint64_t>(-1); }
58*eb293b8fSAndroid Build Coastguard Worker 
set_func_offset(uint64_t offset)59*eb293b8fSAndroid Build Coastguard Worker   void set_func_offset(uint64_t offset) { func_offset_ = offset; }
clear_func_offset()60*eb293b8fSAndroid Build Coastguard Worker   void clear_func_offset() { func_offset_ = static_cast<uint64_t>(-1); }
61*eb293b8fSAndroid Build Coastguard Worker 
set_text_offset(uint64_t offset)62*eb293b8fSAndroid Build Coastguard Worker   void set_text_offset(uint64_t offset) { text_offset_ = offset; }
clear_text_offset()63*eb293b8fSAndroid Build Coastguard Worker   void clear_text_offset() { text_offset_ = static_cast<uint64_t>(-1); }
64*eb293b8fSAndroid Build Coastguard Worker 
65*eb293b8fSAndroid Build Coastguard Worker  private:
66*eb293b8fSAndroid Build Coastguard Worker   std::shared_ptr<Memory> memory_;
67*eb293b8fSAndroid Build Coastguard Worker   uint64_t cur_offset_ = 0;
68*eb293b8fSAndroid Build Coastguard Worker 
69*eb293b8fSAndroid Build Coastguard Worker   int64_t pc_offset_ = INT64_MAX;
70*eb293b8fSAndroid Build Coastguard Worker   uint64_t data_offset_ = static_cast<uint64_t>(-1);
71*eb293b8fSAndroid Build Coastguard Worker   uint64_t func_offset_ = static_cast<uint64_t>(-1);
72*eb293b8fSAndroid Build Coastguard Worker   uint64_t text_offset_ = static_cast<uint64_t>(-1);
73*eb293b8fSAndroid Build Coastguard Worker };
74*eb293b8fSAndroid Build Coastguard Worker 
75*eb293b8fSAndroid Build Coastguard Worker }  // namespace unwindstack
76