/* * Copyright (C) 2016 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ #pragma once #include #include #include #include #include #include #include #include #include namespace unwindstack { // Forward declarations. enum ArchEnum : uint8_t; class Memory; class Regs; template struct RegsInfo; class DwarfSection { public: DwarfSection(Memory* memory); virtual ~DwarfSection() = default; class iterator : public std::iterator { public: iterator(DwarfSection* section, size_t index) : index_(index) { section->GetFdes(&fdes_); if (index_ == static_cast(-1)) { index_ = fdes_.size(); } } iterator& operator++() { index_++; return *this; } iterator& operator++(int increment) { index_ += increment; return *this; } iterator& operator--() { index_--; return *this; } iterator& operator--(int decrement) { index_ -= decrement; return *this; } bool operator==(const iterator& rhs) { return this->index_ == rhs.index_; } bool operator!=(const iterator& rhs) { return this->index_ != rhs.index_; } const DwarfFde* operator*() { if (index_ > fdes_.size()) return nullptr; return fdes_[index_]; } private: std::vector fdes_; size_t index_ = 0; }; iterator begin() { return iterator(this, 0); } iterator end() { return iterator(this, static_cast(-1)); } DwarfErrorCode LastErrorCode() { return last_error_.code; } uint64_t LastErrorAddress() { return last_error_.address; } virtual bool Init(uint64_t offset, uint64_t size, int64_t section_bias) = 0; virtual bool Eval(const DwarfCie*, Memory*, const DwarfLocations&, Regs*, bool*) = 0; virtual bool Log(uint8_t indent, uint64_t pc, const DwarfFde* fde, ArchEnum arch) = 0; virtual void GetFdes(std::vector* fdes) = 0; virtual const DwarfFde* GetFdeFromPc(uint64_t pc) = 0; virtual bool GetCfaLocationInfo(uint64_t pc, const DwarfFde* fde, DwarfLocations* loc_regs, ArchEnum arch) = 0; virtual uint64_t GetCieOffsetFromFde32(uint32_t pointer) = 0; virtual uint64_t GetCieOffsetFromFde64(uint64_t pointer) = 0; virtual uint64_t AdjustPcFromFde(uint64_t pc) = 0; bool Step(uint64_t pc, Regs* regs, Memory* process_memory, bool* finished, bool* is_signal_frame); protected: DwarfMemory memory_; DwarfErrorData last_error_{DWARF_ERROR_NONE, 0}; uint32_t cie32_value_ = 0; uint64_t cie64_value_ = 0; std::unordered_map fde_entries_; std::unordered_map cie_entries_; std::unordered_map cie_loc_regs_; std::map loc_regs_; // Single row indexed by pc_end. }; template class DwarfSectionImpl : public DwarfSection { public: DwarfSectionImpl(Memory* memory) : DwarfSection(memory) {} virtual ~DwarfSectionImpl() = default; bool Init(uint64_t offset, uint64_t size, int64_t section_bias) override; const DwarfCie* GetCieFromOffset(uint64_t offset); const DwarfFde* GetFdeFromOffset(uint64_t offset); const DwarfFde* GetFdeFromPc(uint64_t pc) override; void GetFdes(std::vector* fdes) override; bool EvalRegister(const DwarfLocation* loc, uint32_t reg, AddressType* reg_ptr, void* info); bool Eval(const DwarfCie* cie, Memory* regular_memory, const DwarfLocations& loc_regs, Regs* regs, bool* finished) override; bool GetCfaLocationInfo(uint64_t pc, const DwarfFde* fde, DwarfLocations* loc_regs, ArchEnum arch) override; bool Log(uint8_t indent, uint64_t pc, const DwarfFde* fde, ArchEnum arch) override; protected: using DwarfFdeMap = std::map>; bool GetNextCieOrFde(/*inout*/ uint64_t& offset, /*out*/ std::optional& fde); bool FillInCieHeader(DwarfCie* cie); bool FillInCie(DwarfCie* cie); bool FillInFdeHeader(DwarfFde* fde); bool FillInFde(DwarfFde* fde); bool EvalExpression(const DwarfLocation& loc, Memory* regular_memory, AddressType* value, RegsInfo* regs_info, bool* is_dex_pc); static void InsertFde(uint64_t fde_offset, const DwarfFde* fde, /*out*/ DwarfFdeMap& fdes); void BuildFdeIndex(); int64_t section_bias_ = 0; uint64_t entries_offset_ = 0; uint64_t entries_end_ = 0; uint64_t pc_offset_ = 0; // Binary search table (similar to .eh_frame_hdr). Contains only FDE offsets to save memory. std::vector> fde_index_; }; } // namespace unwindstack