1//===-- DIContext.h ---------------------------------------------*- C++ -*-===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This file defines DIContext, an abstract data structure that holds
11// debug information data.
12//
13//===----------------------------------------------------------------------===//
14
15#ifndef LLVM_DEBUGINFO_DICONTEXT_H
16#define LLVM_DEBUGINFO_DICONTEXT_H
17
18#include "llvm/ADT/DenseMap.h"
19#include "llvm/ADT/SmallString.h"
20#include "llvm/ADT/SmallVector.h"
21#include "llvm/ADT/StringRef.h"
22#include "llvm/Object/ObjectFile.h"
23#include "llvm/Object/RelocVisitor.h"
24#include "llvm/Support/DataTypes.h"
25
26namespace llvm {
27
28class raw_ostream;
29
30/// DILineInfo - a format-neutral container for source line information.
31class DILineInfo {
32  SmallString<16> FileName;
33  SmallString<16> FunctionName;
34  uint32_t Line;
35  uint32_t Column;
36public:
37  DILineInfo()
38    : FileName("<invalid>"), FunctionName("<invalid>"),
39      Line(0), Column(0) {}
40  DILineInfo(const SmallString<16> &fileName,
41             const SmallString<16> &functionName,
42             uint32_t line, uint32_t column)
43    : FileName(fileName), FunctionName(functionName),
44      Line(line), Column(column) {}
45
46  const char *getFileName() { return FileName.c_str(); }
47  const char *getFunctionName() { return FunctionName.c_str(); }
48  uint32_t getLine() const { return Line; }
49  uint32_t getColumn() const { return Column; }
50
51  bool operator==(const DILineInfo &RHS) const {
52    return Line == RHS.Line && Column == RHS.Column &&
53           FileName.equals(RHS.FileName) &&
54           FunctionName.equals(RHS.FunctionName);
55  }
56  bool operator!=(const DILineInfo &RHS) const {
57    return !(*this == RHS);
58  }
59};
60
61typedef SmallVector<std::pair<uint64_t, DILineInfo>, 16> DILineInfoTable;
62
63/// DIInliningInfo - a format-neutral container for inlined code description.
64class DIInliningInfo {
65  SmallVector<DILineInfo, 4> Frames;
66 public:
67  DIInliningInfo() {}
68  DILineInfo getFrame(unsigned Index) const {
69    assert(Index < Frames.size());
70    return Frames[Index];
71  }
72  uint32_t getNumberOfFrames() const {
73    return Frames.size();
74  }
75  void addFrame(const DILineInfo &Frame) {
76    Frames.push_back(Frame);
77  }
78};
79
80/// DILineInfoSpecifier - controls which fields of DILineInfo container
81/// should be filled with data.
82class DILineInfoSpecifier {
83  const uint32_t Flags;  // Or'ed flags that set the info we want to fetch.
84public:
85  enum Specification {
86    FileLineInfo = 1 << 0,
87    AbsoluteFilePath = 1 << 1,
88    FunctionName = 1 << 2
89  };
90  // Use file/line info by default.
91  DILineInfoSpecifier(uint32_t flags = FileLineInfo) : Flags(flags) {}
92  bool needs(Specification spec) const {
93    return (Flags & spec) > 0;
94  }
95};
96
97/// Selects which debug sections get dumped.
98enum DIDumpType {
99  DIDT_Null,
100  DIDT_All,
101  DIDT_Abbrev,
102  DIDT_AbbrevDwo,
103  DIDT_Aranges,
104  DIDT_Frames,
105  DIDT_Info,
106  DIDT_InfoDwo,
107  DIDT_Line,
108  DIDT_Ranges,
109  DIDT_Pubnames,
110  DIDT_Str,
111  DIDT_StrDwo,
112  DIDT_StrOffsetsDwo
113};
114
115// In place of applying the relocations to the data we've read from disk we use
116// a separate mapping table to the side and checking that at locations in the
117// dwarf where we expect relocated values. This adds a bit of complexity to the
118// dwarf parsing/extraction at the benefit of not allocating memory for the
119// entire size of the debug info sections.
120typedef DenseMap<uint64_t, std::pair<uint8_t, int64_t> > RelocAddrMap;
121
122class DIContext {
123public:
124  virtual ~DIContext();
125
126  /// getDWARFContext - get a context for binary DWARF data.
127  static DIContext *getDWARFContext(object::ObjectFile *);
128
129  virtual void dump(raw_ostream &OS, DIDumpType DumpType = DIDT_All) = 0;
130
131  virtual DILineInfo getLineInfoForAddress(uint64_t Address,
132      DILineInfoSpecifier Specifier = DILineInfoSpecifier()) = 0;
133  virtual DILineInfoTable getLineInfoForAddressRange(uint64_t Address,
134      uint64_t Size, DILineInfoSpecifier Specifier = DILineInfoSpecifier()) = 0;
135  virtual DIInliningInfo getInliningInfoForAddress(uint64_t Address,
136      DILineInfoSpecifier Specifier = DILineInfoSpecifier()) = 0;
137};
138
139}
140
141#endif
142