ArmUnwindInfo.h

Go to the documentation of this file.

//===-- ArmUnwindInfo.h -----------------------------------------*- C++ -*-===//
//
// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
//
//===----------------------------------------------------------------------===//
 
#ifndef LLDB_SYMBOL_ARMUNWINDINFO_H
#define LLDB_SYMBOL_ARMUNWINDINFO_H
 
#include "lldb/Symbol/ObjectFile.h"
#include "lldb/Utility/DataExtractor.h"
#include "lldb/Utility/RangeMap.h"
#include "lldb/lldb-private.h"
#include <vector>
 
/*
 * Unwind information reader and parser for the ARM exception handling ABI
 *
 * Implemented based on:
 *     Exception Handling ABI for the ARM Architecture
 *     Document number: ARM IHI 0038A (current through ABI r2.09)
 *     Date of Issue: 25th January 2007, reissued 30th November 2012
 *     http://infocenter.arm.com/help/topic/com.arm.doc.ihi0038a/IHI0038A_ehabi.pdf
 */
 
namespace lldb_private {
 
class ArmUnwindInfo {
public:
  ArmUnwindInfo(ObjectFile &objfile, lldb::SectionSP &arm_exidx,
                lldb::SectionSP &arm_extab);
 
  ~ArmUnwindInfo();
 
  bool GetUnwindPlan(Target &target, const Address &addr,
                     UnwindPlan &unwind_plan);
 
private:
  struct ArmExidxEntry {
    ArmExidxEntry(uint32_t f, lldb::addr_t a, uint32_t d);
 
    bool operator<(const ArmExidxEntry &other) const;
 
    uint32_t file_address;
    lldb::addr_t address;
    uint32_t data;
  };
 
  const uint8_t *GetExceptionHandlingTableEntry(const Address &addr);
 
  uint8_t GetByteAtOffset(const uint32_t *data, uint16_t offset) const;
 
  uint64_t GetULEB128(const uint32_t *data, uint16_t &offset,
                      uint16_t max_offset) const;
 
  const lldb::ByteOrder m_byte_order;
  lldb::SectionSP m_arm_exidx_sp; // .ARM.exidx section
  lldb::SectionSP m_arm_extab_sp; // .ARM.extab section
  DataExtractor m_arm_exidx_data; // .ARM.exidx section data
  DataExtractor m_arm_extab_data; // .ARM.extab section data
  std::vector<ArmExidxEntry> m_exidx_entries;
};
 
} // namespace lldb_private
 
#endif // LLDB_SYMBOL_ARMUNWINDINFO_H