DwarfDebug.h revision 6b6345f0167fb9ddf60bdc51d616d7a9ae590442
1//===-- llvm/CodeGen/DwarfDebug.h - Dwarf Debug Framework ------*- 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 contains support for writing dwarf debug info into asm files.
11//
12//===----------------------------------------------------------------------===//
13
14#ifndef CODEGEN_ASMPRINTER_DWARFDEBUG_H__
15#define CODEGEN_ASMPRINTER_DWARFDEBUG_H__
16
17#include "DIE.h"
18#include "llvm/ADT/DenseMap.h"
19#include "llvm/ADT/FoldingSet.h"
20#include "llvm/ADT/SetVector.h"
21#include "llvm/ADT/SmallPtrSet.h"
22#include "llvm/ADT/StringMap.h"
23#include "llvm/CodeGen/AsmPrinter.h"
24#include "llvm/CodeGen/LexicalScopes.h"
25#include "llvm/DebugInfo.h"
26#include "llvm/MC/MachineLocation.h"
27#include "llvm/Support/Allocator.h"
28#include "llvm/Support/DebugLoc.h"
29
30namespace llvm {
31
32class CompileUnit;
33class ConstantInt;
34class ConstantFP;
35class DbgVariable;
36class MachineFrameInfo;
37class MachineModuleInfo;
38class MachineOperand;
39class MCAsmInfo;
40class DIEAbbrev;
41class DIE;
42class DIEBlock;
43class DIEEntry;
44
45//===----------------------------------------------------------------------===//
46/// \brief This class is used to record source line correspondence.
47class SrcLineInfo {
48  unsigned Line;                     // Source line number.
49  unsigned Column;                   // Source column.
50  unsigned SourceID;                 // Source ID number.
51  MCSymbol *Label;                   // Label in code ID number.
52public:
53  SrcLineInfo(unsigned L, unsigned C, unsigned S, MCSymbol *label)
54    : Line(L), Column(C), SourceID(S), Label(label) {}
55
56  // Accessors
57  unsigned getLine() const { return Line; }
58  unsigned getColumn() const { return Column; }
59  unsigned getSourceID() const { return SourceID; }
60  MCSymbol *getLabel() const { return Label; }
61};
62
63/// \brief This struct describes location entries emitted in the .debug_loc
64/// section.
65class DotDebugLocEntry {
66  // Begin and end symbols for the address range that this location is valid.
67  const MCSymbol *Begin;
68  const MCSymbol *End;
69
70  // Type of entry that this represents.
71  enum EntryType {
72    E_Location,
73    E_Integer,
74    E_ConstantFP,
75    E_ConstantInt
76  };
77  enum EntryType EntryKind;
78
79  union {
80    int64_t Int;
81    const ConstantFP *CFP;
82    const ConstantInt *CIP;
83  } Constants;
84
85  // The location in the machine frame.
86  MachineLocation Loc;
87
88  // The variable to which this location entry corresponds.
89  const MDNode *Variable;
90
91  // Whether this location has been merged.
92  bool Merged;
93
94public:
95  DotDebugLocEntry() : Begin(0), End(0), Variable(0), Merged(false) {
96    Constants.Int = 0;
97  }
98  DotDebugLocEntry(const MCSymbol *B, const MCSymbol *E, MachineLocation &L,
99                   const MDNode *V)
100      : Begin(B), End(E), Loc(L), Variable(V), Merged(false) {
101    Constants.Int = 0;
102    EntryKind = E_Location;
103  }
104  DotDebugLocEntry(const MCSymbol *B, const MCSymbol *E, int64_t i)
105      : Begin(B), End(E), Variable(0), Merged(false) {
106    Constants.Int = i;
107    EntryKind = E_Integer;
108  }
109  DotDebugLocEntry(const MCSymbol *B, const MCSymbol *E, const ConstantFP *FPtr)
110      : Begin(B), End(E), Variable(0), Merged(false) {
111    Constants.CFP = FPtr;
112    EntryKind = E_ConstantFP;
113  }
114  DotDebugLocEntry(const MCSymbol *B, const MCSymbol *E,
115                   const ConstantInt *IPtr)
116      : Begin(B), End(E), Variable(0), Merged(false) {
117    Constants.CIP = IPtr;
118    EntryKind = E_ConstantInt;
119  }
120
121  /// \brief Empty entries are also used as a trigger to emit temp label. Such
122  /// labels are referenced is used to find debug_loc offset for a given DIE.
123  bool isEmpty() { return Begin == 0 && End == 0; }
124  bool isMerged() { return Merged; }
125  void Merge(DotDebugLocEntry *Next) {
126    if (!(Begin && Loc == Next->Loc && End == Next->Begin))
127      return;
128    Next->Begin = Begin;
129    Merged = true;
130  }
131  bool isLocation() const    { return EntryKind == E_Location; }
132  bool isInt() const         { return EntryKind == E_Integer; }
133  bool isConstantFP() const  { return EntryKind == E_ConstantFP; }
134  bool isConstantInt() const { return EntryKind == E_ConstantInt; }
135  int64_t getInt() const                    { return Constants.Int; }
136  const ConstantFP *getConstantFP() const   { return Constants.CFP; }
137  const ConstantInt *getConstantInt() const { return Constants.CIP; }
138  const MDNode *getVariable() const { return Variable; }
139  const MCSymbol *getBeginSym() const { return Begin; }
140  const MCSymbol *getEndSym() const { return End; }
141  MachineLocation getLoc() const { return Loc; }
142};
143
144//===----------------------------------------------------------------------===//
145/// \brief This class is used to track local variable information.
146class DbgVariable {
147  DIVariable Var;                    // Variable Descriptor.
148  DIE *TheDIE;                       // Variable DIE.
149  unsigned DotDebugLocOffset;        // Offset in DotDebugLocEntries.
150  DbgVariable *AbsVar;               // Corresponding Abstract variable, if any.
151  const MachineInstr *MInsn;         // DBG_VALUE instruction of the variable.
152  int FrameIndex;
153public:
154  // AbsVar may be NULL.
155  DbgVariable(DIVariable V, DbgVariable *AV)
156    : Var(V), TheDIE(0), DotDebugLocOffset(~0U), AbsVar(AV), MInsn(0),
157      FrameIndex(~0) {}
158
159  // Accessors.
160  DIVariable getVariable()           const { return Var; }
161  void setDIE(DIE *D)                      { TheDIE = D; }
162  DIE *getDIE()                      const { return TheDIE; }
163  void setDotDebugLocOffset(unsigned O)    { DotDebugLocOffset = O; }
164  unsigned getDotDebugLocOffset()    const { return DotDebugLocOffset; }
165  StringRef getName()                const { return Var.getName(); }
166  DbgVariable *getAbstractVariable() const { return AbsVar; }
167  const MachineInstr *getMInsn()     const { return MInsn; }
168  void setMInsn(const MachineInstr *M)     { MInsn = M; }
169  int getFrameIndex()                const { return FrameIndex; }
170  void setFrameIndex(int FI)               { FrameIndex = FI; }
171  // Translate tag to proper Dwarf tag.
172  uint16_t getTag()                  const {
173    if (Var.getTag() == dwarf::DW_TAG_arg_variable)
174      return dwarf::DW_TAG_formal_parameter;
175
176    return dwarf::DW_TAG_variable;
177  }
178  /// \brief Return true if DbgVariable is artificial.
179  bool isArtificial()                const {
180    if (Var.isArtificial())
181      return true;
182    if (getType().isArtificial())
183      return true;
184    return false;
185  }
186
187  bool isObjectPointer()             const {
188    if (Var.isObjectPointer())
189      return true;
190    if (getType().isObjectPointer())
191      return true;
192    return false;
193  }
194
195  bool variableHasComplexAddress()   const {
196    assert(Var.isVariable() && "Invalid complex DbgVariable!");
197    return Var.hasComplexAddress();
198  }
199  bool isBlockByrefVariable()        const {
200    assert(Var.isVariable() && "Invalid complex DbgVariable!");
201    return Var.isBlockByrefVariable();
202  }
203  unsigned getNumAddrElements()      const {
204    assert(Var.isVariable() && "Invalid complex DbgVariable!");
205    return Var.getNumAddrElements();
206  }
207  uint64_t getAddrElement(unsigned i) const {
208    return Var.getAddrElement(i);
209  }
210  DIType getType() const;
211};
212
213/// \brief Collects and handles information specific to a particular
214/// collection of units.
215class DwarfUnits {
216  // Target of Dwarf emission, used for sizing of abbreviations.
217  AsmPrinter *Asm;
218
219  // Used to uniquely define abbreviations.
220  FoldingSet<DIEAbbrev> *AbbreviationsSet;
221
222  // A list of all the unique abbreviations in use.
223  std::vector<DIEAbbrev *> *Abbreviations;
224
225  // A pointer to all units in the section.
226  SmallVector<CompileUnit *, 1> CUs;
227
228  // Collection of strings for this unit and assorted symbols.
229  // A String->Symbol mapping of strings used by indirect
230  // references.
231  typedef StringMap<std::pair<MCSymbol*, unsigned>,
232                    BumpPtrAllocator&> StrPool;
233  StrPool StringPool;
234  unsigned NextStringPoolNumber;
235  std::string StringPref;
236
237  // Collection of addresses for this unit and assorted labels.
238  // A Symbol->unsigned mapping of addresses used by indirect
239  // references.
240  typedef DenseMap<const MCExpr *, unsigned> AddrPool;
241  AddrPool AddressPool;
242  unsigned NextAddrPoolNumber;
243
244public:
245  DwarfUnits(AsmPrinter *AP, FoldingSet<DIEAbbrev> *AS,
246             std::vector<DIEAbbrev *> *A, const char *Pref,
247             BumpPtrAllocator &DA)
248      : Asm(AP), AbbreviationsSet(AS), Abbreviations(A), StringPool(DA),
249        NextStringPoolNumber(0), StringPref(Pref), AddressPool(),
250        NextAddrPoolNumber(0) {}
251
252  /// \brief Compute the size and offset of a DIE given an incoming Offset.
253  unsigned computeSizeAndOffset(DIE *Die, unsigned Offset);
254
255  /// \brief Compute the size and offset of all the DIEs.
256  void computeSizeAndOffsets();
257
258  /// \brief Define a unique number for the abbreviation.
259  void assignAbbrevNumber(DIEAbbrev &Abbrev);
260
261  /// \brief Add a unit to the list of CUs.
262  void addUnit(CompileUnit *CU) { CUs.push_back(CU); }
263
264  /// \brief Emit all of the units to the section listed with the given
265  /// abbreviation section.
266  void emitUnits(DwarfDebug *DD, const MCSection *USection,
267                 const MCSection *ASection, const MCSymbol *ASectionSym);
268
269  /// \brief Emit all of the strings to the section given.
270  void emitStrings(const MCSection *StrSection, const MCSection *OffsetSection,
271                   const MCSymbol *StrSecSym);
272
273  /// \brief Emit all of the addresses to the section given.
274  void emitAddresses(const MCSection *AddrSection);
275
276  /// \brief Returns the entry into the start of the pool.
277  MCSymbol *getStringPoolSym();
278
279  /// \brief Returns an entry into the string pool with the given
280  /// string text.
281  MCSymbol *getStringPoolEntry(StringRef Str);
282
283  /// \brief Returns the index into the string pool with the given
284  /// string text.
285  unsigned getStringPoolIndex(StringRef Str);
286
287  /// \brief Returns the string pool.
288  StrPool *getStringPool() { return &StringPool; }
289
290  /// \brief Returns the index into the address pool with the given
291  /// label/symbol.
292  unsigned getAddrPoolIndex(const MCExpr *Sym);
293  unsigned getAddrPoolIndex(const MCSymbol *Sym);
294
295  /// \brief Returns the address pool.
296  AddrPool *getAddrPool() { return &AddressPool; }
297
298  /// \brief for a given compile unit DIE, returns offset from beginning of
299  /// debug info.
300  unsigned getCUOffset(DIE *Die);
301};
302
303/// \brief Collects and handles dwarf debug information.
304class DwarfDebug {
305  // Target of Dwarf emission.
306  AsmPrinter *Asm;
307
308  // Collected machine module information.
309  MachineModuleInfo *MMI;
310
311  // All DIEValues are allocated through this allocator.
312  BumpPtrAllocator DIEValueAllocator;
313
314  // Handle to the a compile unit used for the inline extension handling.
315  CompileUnit *FirstCU;
316
317  // Maps MDNode with its corresponding CompileUnit.
318  DenseMap <const MDNode *, CompileUnit *> CUMap;
319
320  // Maps subprogram MDNode with its corresponding CompileUnit.
321  DenseMap <const MDNode *, CompileUnit *> SPMap;
322
323  // Used to uniquely define abbreviations.
324  FoldingSet<DIEAbbrev> AbbreviationsSet;
325
326  // A list of all the unique abbreviations in use.
327  std::vector<DIEAbbrev *> Abbreviations;
328
329  // Stores the current file ID for a given compile unit.
330  DenseMap <unsigned, unsigned> FileIDCUMap;
331  // Source id map, i.e. CUID, source filename and directory,
332  // separated by a zero byte, mapped to a unique id.
333  StringMap<unsigned, BumpPtrAllocator&> SourceIdMap;
334
335  // Provides a unique id per text section.
336  SetVector<const MCSection*> SectionMap;
337
338  // List of arguments for current function.
339  SmallVector<DbgVariable *, 8> CurrentFnArguments;
340
341  LexicalScopes LScopes;
342
343  // Collection of abstract subprogram DIEs.
344  DenseMap<const MDNode *, DIE *> AbstractSPDies;
345
346  // Collection of dbg variables of a scope.
347  typedef DenseMap<LexicalScope *,
348                   SmallVector<DbgVariable *, 8> > ScopeVariablesMap;
349  ScopeVariablesMap ScopeVariables;
350
351  // Collection of abstract variables.
352  DenseMap<const MDNode *, DbgVariable *> AbstractVariables;
353
354  // Collection of DotDebugLocEntry.
355  SmallVector<DotDebugLocEntry, 4> DotDebugLocEntries;
356
357  // Collection of subprogram DIEs that are marked (at the end of the module)
358  // as DW_AT_inline.
359  SmallPtrSet<DIE *, 4> InlinedSubprogramDIEs;
360
361  // This is a collection of subprogram MDNodes that are processed to
362  // create DIEs.
363  SmallPtrSet<const MDNode *, 16> ProcessedSPNodes;
364
365  // Maps instruction with label emitted before instruction.
366  DenseMap<const MachineInstr *, MCSymbol *> LabelsBeforeInsn;
367
368  // Maps instruction with label emitted after instruction.
369  DenseMap<const MachineInstr *, MCSymbol *> LabelsAfterInsn;
370
371  // Every user variable mentioned by a DBG_VALUE instruction in order of
372  // appearance.
373  SmallVector<const MDNode*, 8> UserVariables;
374
375  // For each user variable, keep a list of DBG_VALUE instructions in order.
376  // The list can also contain normal instructions that clobber the previous
377  // DBG_VALUE.
378  typedef DenseMap<const MDNode*, SmallVector<const MachineInstr*, 4> >
379    DbgValueHistoryMap;
380  DbgValueHistoryMap DbgValues;
381
382  SmallVector<const MCSymbol *, 8> DebugRangeSymbols;
383
384  // Previous instruction's location information. This is used to determine
385  // label location to indicate scope boundries in dwarf debug info.
386  DebugLoc PrevInstLoc;
387  MCSymbol *PrevLabel;
388
389  // This location indicates end of function prologue and beginning of function
390  // body.
391  DebugLoc PrologEndLoc;
392
393  // Section Symbols: these are assembler temporary labels that are emitted at
394  // the beginning of each supported dwarf section.  These are used to form
395  // section offsets and are created by EmitSectionLabels.
396  MCSymbol *DwarfInfoSectionSym, *DwarfAbbrevSectionSym;
397  MCSymbol *DwarfStrSectionSym, *TextSectionSym, *DwarfDebugRangeSectionSym;
398  MCSymbol *DwarfDebugLocSectionSym, *DwarfLineSectionSym, *DwarfAddrSectionSym;
399  MCSymbol *FunctionBeginSym, *FunctionEndSym;
400  MCSymbol *DwarfAbbrevDWOSectionSym, *DwarfStrDWOSectionSym;
401
402  // As an optimization, there is no need to emit an entry in the directory
403  // table for the same directory as DW_AT_comp_dir.
404  StringRef CompilationDir;
405
406  // Counter for assigning globally unique IDs for CUs.
407  unsigned GlobalCUIndexCount;
408
409  // Holder for the file specific debug information.
410  DwarfUnits InfoHolder;
411
412  // Holders for the various debug information flags that we might need to
413  // have exposed. See accessor functions below for description.
414
415  // Whether or not we're emitting info for older versions of gdb on darwin.
416  bool IsDarwinGDBCompat;
417
418  // Holder for imported entities.
419  typedef SmallVector<std::pair<const MDNode *, const MDNode *>, 32>
420    ImportedEntityMap;
421  ImportedEntityMap ScopesWithImportedEntities;
422
423  // Holder for types that are going to be extracted out into a type unit.
424  std::vector<DIE *> TypeUnits;
425
426  // Whether to emit the pubnames/pubtypes sections.
427  bool HasDwarfPubSections;
428
429  // Version of dwarf we're emitting.
430  unsigned DwarfVersion;
431
432  // DWARF5 Experimental Options
433  bool HasDwarfAccelTables;
434  bool HasSplitDwarf;
435
436  // Separated Dwarf Variables
437  // In general these will all be for bits that are left in the
438  // original object file, rather than things that are meant
439  // to be in the .dwo sections.
440
441  // The CUs left in the original object file for separated debug info.
442  SmallVector<CompileUnit *, 1> SkeletonCUs;
443
444  // Used to uniquely define abbreviations for the skeleton emission.
445  FoldingSet<DIEAbbrev> SkeletonAbbrevSet;
446
447  // A list of all the unique abbreviations in use.
448  std::vector<DIEAbbrev *> SkeletonAbbrevs;
449
450  // Holder for the skeleton information.
451  DwarfUnits SkeletonHolder;
452
453private:
454
455  void addScopeVariable(LexicalScope *LS, DbgVariable *Var);
456
457  /// \brief Find abstract variable associated with Var.
458  DbgVariable *findAbstractVariable(DIVariable &Var, DebugLoc Loc);
459
460  /// \brief Find DIE for the given subprogram and attach appropriate
461  /// DW_AT_low_pc and DW_AT_high_pc attributes. If there are global
462  /// variables in this scope then create and insert DIEs for these
463  /// variables.
464  DIE *updateSubprogramScopeDIE(CompileUnit *SPCU, const MDNode *SPNode);
465
466  /// \brief Construct new DW_TAG_lexical_block for this scope and
467  /// attach DW_AT_low_pc/DW_AT_high_pc labels.
468  DIE *constructLexicalScopeDIE(CompileUnit *TheCU, LexicalScope *Scope);
469
470  /// \brief This scope represents inlined body of a function. Construct
471  /// DIE to represent this concrete inlined copy of the function.
472  DIE *constructInlinedScopeDIE(CompileUnit *TheCU, LexicalScope *Scope);
473
474  /// \brief Construct a DIE for this scope.
475  DIE *constructScopeDIE(CompileUnit *TheCU, LexicalScope *Scope);
476
477  /// \brief Emit initial Dwarf sections with a label at the start of each one.
478  void emitSectionLabels();
479
480  /// \brief Compute the size and offset of a DIE given an incoming Offset.
481  unsigned computeSizeAndOffset(DIE *Die, unsigned Offset);
482
483  /// \brief Compute the size and offset of all the DIEs.
484  void computeSizeAndOffsets();
485
486  /// \brief Attach DW_AT_inline attribute with inlined subprogram DIEs.
487  void computeInlinedDIEs();
488
489  /// \brief Collect info for variables that were optimized out.
490  void collectDeadVariables();
491
492  /// \brief Finish off debug information after all functions have been
493  /// processed.
494  void finalizeModuleInfo();
495
496  /// \brief Emit labels to close any remaining sections that have been left
497  /// open.
498  void endSections();
499
500  /// \brief Emit a set of abbreviations to the specific section.
501  void emitAbbrevs(const MCSection *, std::vector<DIEAbbrev*> *);
502
503  /// \brief Emit the debug info section.
504  void emitDebugInfo();
505
506  /// \brief Emit the abbreviation section.
507  void emitAbbreviations();
508
509  /// \brief Emit the last address of the section and the end of
510  /// the line matrix.
511  void emitEndOfLineMatrix(unsigned SectionEnd);
512
513  /// \brief Emit visible names into a hashed accelerator table section.
514  void emitAccelNames();
515
516  /// \brief Emit objective C classes and categories into a hashed
517  /// accelerator table section.
518  void emitAccelObjC();
519
520  /// \brief Emit namespace dies into a hashed accelerator table.
521  void emitAccelNamespaces();
522
523  /// \brief Emit type dies into a hashed accelerator table.
524  void emitAccelTypes();
525
526  /// \brief Emit visible names into a debug pubnames section.
527  void emitDebugPubnames();
528
529  /// \brief Emit visible types into a debug pubtypes section.
530  void emitDebugPubTypes();
531
532  /// \brief Emit visible names into a debug str section.
533  void emitDebugStr();
534
535  /// \brief Emit visible names into a debug loc section.
536  void emitDebugLoc();
537
538  /// \brief Emit visible names into a debug aranges section.
539  void emitDebugARanges();
540
541  /// \brief Emit visible names into a debug ranges section.
542  void emitDebugRanges();
543
544  /// \brief Emit visible names into a debug macinfo section.
545  void emitDebugMacInfo();
546
547  /// \brief Emit inline info using custom format.
548  void emitDebugInlineInfo();
549
550  /// DWARF 5 Experimental Split Dwarf Emitters
551
552  /// \brief Construct the split debug info compile unit for the debug info
553  /// section.
554  CompileUnit *constructSkeletonCU(const CompileUnit *CU);
555
556  /// \brief Emit the local split abbreviations.
557  void emitSkeletonAbbrevs(const MCSection *);
558
559  /// \brief Emit the debug info dwo section.
560  void emitDebugInfoDWO();
561
562  /// \brief Emit the debug abbrev dwo section.
563  void emitDebugAbbrevDWO();
564
565  /// \brief Emit the debug str dwo section.
566  void emitDebugStrDWO();
567
568  /// \brief Create new CompileUnit for the given metadata node with tag
569  /// DW_TAG_compile_unit.
570  CompileUnit *constructCompileUnit(const MDNode *N);
571
572  /// \brief Construct subprogram DIE.
573  void constructSubprogramDIE(CompileUnit *TheCU, const MDNode *N);
574
575  /// \brief Construct imported_module or imported_declaration DIE.
576  void constructImportedEntityDIE(CompileUnit *TheCU, const MDNode *N);
577
578  /// \brief Construct import_module DIE.
579  void constructImportedEntityDIE(CompileUnit *TheCU, const MDNode *N,
580                                  DIE *Context);
581
582  /// \brief Construct import_module DIE.
583  void constructImportedEntityDIE(CompileUnit *TheCU,
584                                  const DIImportedEntity &Module,
585                                  DIE *Context);
586
587  /// \brief Register a source line with debug info. Returns the unique
588  /// label that was emitted and which provides correspondence to the
589  /// source line list.
590  void recordSourceLine(unsigned Line, unsigned Col, const MDNode *Scope,
591                        unsigned Flags);
592
593  /// \brief Indentify instructions that are marking the beginning of or
594  /// ending of a scope.
595  void identifyScopeMarkers();
596
597  /// \brief If Var is an current function argument that add it in
598  /// CurrentFnArguments list.
599  bool addCurrentFnArgument(const MachineFunction *MF,
600                            DbgVariable *Var, LexicalScope *Scope);
601
602  /// \brief Populate LexicalScope entries with variables' info.
603  void collectVariableInfo(const MachineFunction *,
604                           SmallPtrSet<const MDNode *, 16> &ProcessedVars);
605
606  /// \brief Collect variable information from the side table maintained
607  /// by MMI.
608  void collectVariableInfoFromMMITable(const MachineFunction * MF,
609                                       SmallPtrSet<const MDNode *, 16> &P);
610
611  /// \brief Ensure that a label will be emitted before MI.
612  void requestLabelBeforeInsn(const MachineInstr *MI) {
613    LabelsBeforeInsn.insert(std::make_pair(MI, (MCSymbol*)0));
614  }
615
616  /// \brief Return Label preceding the instruction.
617  MCSymbol *getLabelBeforeInsn(const MachineInstr *MI);
618
619  /// \brief Ensure that a label will be emitted after MI.
620  void requestLabelAfterInsn(const MachineInstr *MI) {
621    LabelsAfterInsn.insert(std::make_pair(MI, (MCSymbol*)0));
622  }
623
624  /// \brief Return Label immediately following the instruction.
625  MCSymbol *getLabelAfterInsn(const MachineInstr *MI);
626
627public:
628  //===--------------------------------------------------------------------===//
629  // Main entry points.
630  //
631  DwarfDebug(AsmPrinter *A, Module *M);
632  ~DwarfDebug();
633
634  /// \brief Emit all Dwarf sections that should come prior to the
635  /// content.
636  void beginModule();
637
638  /// \brief Emit all Dwarf sections that should come after the content.
639  void endModule();
640
641  /// \brief Gather pre-function debug information.
642  void beginFunction(const MachineFunction *MF);
643
644  /// \brief Gather and emit post-function debug information.
645  void endFunction(const MachineFunction *MF);
646
647  /// \brief Process beginning of an instruction.
648  void beginInstruction(const MachineInstr *MI);
649
650  /// \brief Process end of an instruction.
651  void endInstruction(const MachineInstr *MI);
652
653  /// \brief Add a DIE to the set of types that we're going to pull into
654  /// type units.
655  void addTypeUnitType(DIE *Die) { TypeUnits.push_back(Die); }
656
657  /// \brief Look up the source id with the given directory and source file
658  /// names. If none currently exists, create a new id and insert it in the
659  /// SourceIds map.
660  unsigned getOrCreateSourceID(StringRef DirName, StringRef FullName,
661                               unsigned CUID);
662
663  /// \brief Recursively Emits a debug information entry.
664  void emitDIE(DIE *Die, std::vector<DIEAbbrev *> *Abbrevs);
665
666  /// \brief Returns whether or not to limit some of our debug
667  /// output to the limitations of darwin gdb.
668  bool useDarwinGDBCompat() { return IsDarwinGDBCompat; }
669
670  // Experimental DWARF5 features.
671
672  /// \brief Returns whether or not to emit tables that dwarf consumers can
673  /// use to accelerate lookup.
674  bool useDwarfAccelTables() { return HasDwarfAccelTables; }
675
676  /// \brief Returns whether or not to change the current debug info for the
677  /// split dwarf proposal support.
678  bool useSplitDwarf() { return HasSplitDwarf; }
679
680  /// Returns the Dwarf Version.
681  unsigned getDwarfVersion() const { return DwarfVersion; }
682};
683} // End of namespace llvm
684
685#endif
686