DwarfDebug.h revision 12188d5bab61d27a61e0a1ad41c28f929d6837a7
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 "llvm/CodeGen/AsmPrinter.h" 18#include "llvm/CodeGen/MachineLocation.h" 19#include "DIE.h" 20#include "llvm/ADT/DenseMap.h" 21#include "llvm/ADT/FoldingSet.h" 22#include "llvm/ADT/SmallPtrSet.h" 23#include "llvm/ADT/StringMap.h" 24#include "llvm/ADT/UniqueVector.h" 25#include "llvm/Support/Allocator.h" 26 27namespace llvm { 28 29class CompileUnit; 30class DbgConcreteScope; 31class DbgScope; 32class DbgVariable; 33class MachineFrameInfo; 34class MachineModuleInfo; 35class MachineOperand; 36class MCAsmInfo; 37class DIEAbbrev; 38class DIE; 39class DIEBlock; 40class DIEEntry; 41 42class DIEnumerator; 43class DIDescriptor; 44class DIVariable; 45class DIGlobal; 46class DIGlobalVariable; 47class DISubprogram; 48class DIBasicType; 49class DIDerivedType; 50class DIType; 51class DINameSpace; 52class DISubrange; 53class DICompositeType; 54 55//===----------------------------------------------------------------------===// 56/// SrcLineInfo - This class is used to record source line correspondence. 57/// 58class SrcLineInfo { 59 unsigned Line; // Source line number. 60 unsigned Column; // Source column. 61 unsigned SourceID; // Source ID number. 62 MCSymbol *Label; // Label in code ID number. 63public: 64 SrcLineInfo(unsigned L, unsigned C, unsigned S, MCSymbol *label) 65 : Line(L), Column(C), SourceID(S), Label(label) {} 66 67 // Accessors 68 unsigned getLine() const { return Line; } 69 unsigned getColumn() const { return Column; } 70 unsigned getSourceID() const { return SourceID; } 71 MCSymbol *getLabel() const { return Label; } 72}; 73 74class DwarfDebug { 75 /// Asm - Target of Dwarf emission. 76 AsmPrinter *Asm; 77 78 /// MMI - Collected machine module information. 79 MachineModuleInfo *MMI; 80 81 //===--------------------------------------------------------------------===// 82 // Attributes used to construct specific Dwarf sections. 83 // 84 85 CompileUnit *FirstCU; 86 DenseMap <const MDNode *, CompileUnit *> CUMap; 87 88 /// AbbreviationsSet - Used to uniquely define abbreviations. 89 /// 90 FoldingSet<DIEAbbrev> AbbreviationsSet; 91 92 /// Abbreviations - A list of all the unique abbreviations in use. 93 /// 94 std::vector<DIEAbbrev *> Abbreviations; 95 96 /// DirectoryIdMap - Directory name to directory id map. 97 /// 98 StringMap<unsigned> DirectoryIdMap; 99 100 /// DirectoryNames - A list of directory names. 101 SmallVector<std::string, 8> DirectoryNames; 102 103 /// SourceFileIdMap - Source file name to source file id map. 104 /// 105 StringMap<unsigned> SourceFileIdMap; 106 107 /// SourceFileNames - A list of source file names. 108 SmallVector<std::string, 8> SourceFileNames; 109 110 /// SourceIdMap - Source id map, i.e. pair of directory id and source file 111 /// id mapped to a unique id. 112 DenseMap<std::pair<unsigned, unsigned>, unsigned> SourceIdMap; 113 114 /// SourceIds - Reverse map from source id to directory id + file id pair. 115 /// 116 SmallVector<std::pair<unsigned, unsigned>, 8> SourceIds; 117 118 /// Lines - List of source line correspondence. 119 std::vector<SrcLineInfo> Lines; 120 121 /// DIEBlocks - A list of all the DIEBlocks in use. 122 std::vector<DIEBlock *> DIEBlocks; 123 124 // DIEValueAllocator - All DIEValues are allocated through this allocator. 125 BumpPtrAllocator DIEValueAllocator; 126 127 /// StringPool - A String->Symbol mapping of strings used by indirect 128 /// references. 129 StringMap<std::pair<MCSymbol*, unsigned> > StringPool; 130 unsigned NextStringPoolNumber; 131 132 MCSymbol *getStringPoolEntry(StringRef Str); 133 134 /// SectionMap - Provides a unique id per text section. 135 /// 136 UniqueVector<const MCSection*> SectionMap; 137 138 /// SectionSourceLines - Tracks line numbers per text section. 139 /// 140 std::vector<std::vector<SrcLineInfo> > SectionSourceLines; 141 142 // CurrentFnDbgScope - Top level scope for the current function. 143 // 144 DbgScope *CurrentFnDbgScope; 145 146 /// DbgScopeMap - Tracks the scopes in the current function. Owns the 147 /// contained DbgScope*s. 148 /// 149 DenseMap<const MDNode *, DbgScope *> DbgScopeMap; 150 151 /// ConcreteScopes - Tracks the concrete scopees in the current function. 152 /// These scopes are also included in DbgScopeMap. 153 DenseMap<const MDNode *, DbgScope *> ConcreteScopes; 154 155 /// AbstractScopes - Tracks the abstract scopes a module. These scopes are 156 /// not included DbgScopeMap. AbstractScopes owns its DbgScope*s. 157 DenseMap<const MDNode *, DbgScope *> AbstractScopes; 158 159 /// AbstractScopesList - Tracks abstract scopes constructed while processing 160 /// a function. This list is cleared during endFunction(). 161 SmallVector<DbgScope *, 4>AbstractScopesList; 162 163 /// AbstractVariables - Collection on abstract variables. Owned by the 164 /// DbgScopes in AbstractScopes. 165 DenseMap<const MDNode *, DbgVariable *> AbstractVariables; 166 167 /// DbgValueStartMap - Tracks starting scope of variable DIEs. 168 /// If the scope of an object begins sometime after the low pc value for the 169 /// scope most closely enclosing the object, the object entry may have a 170 /// DW_AT_start_scope attribute. 171 DenseMap<const MachineInstr *, DbgVariable *> DbgValueStartMap; 172 173 /// DbgVariableToFrameIndexMap - Tracks frame index used to find 174 /// variable's value. 175 DenseMap<const DbgVariable *, int> DbgVariableToFrameIndexMap; 176 177 /// DbgVariableToDbgInstMap - Maps DbgVariable to corresponding DBG_VALUE 178 /// machine instruction. 179 DenseMap<const DbgVariable *, const MachineInstr *> DbgVariableToDbgInstMap; 180 181 /// DbgVariableLabelsMap - Maps DbgVariable to corresponding MCSymbol. 182 DenseMap<const DbgVariable *, const MCSymbol *> DbgVariableLabelsMap; 183 184 /// DotDebugLocEntry - This struct describes location entries emitted in 185 /// .debug_loc section. 186 typedef struct DotDebugLocEntry { 187 const MCSymbol *Begin; 188 const MCSymbol *End; 189 MachineLocation Loc; 190 DotDebugLocEntry() : Begin(0), End(0) {} 191 DotDebugLocEntry(const MCSymbol *B, const MCSymbol *E, 192 MachineLocation &L) : Begin(B), End(E), Loc(L) {} 193 /// Empty entries are also used as a trigger to emit temp label. Such 194 /// labels are referenced is used to find debug_loc offset for a given DIE. 195 bool isEmpty() { return Begin == 0 && End == 0; } 196 } DotDebugLocEntry; 197 198 /// DotDebugLocEntries - Collection of DotDebugLocEntry. 199 SmallVector<DotDebugLocEntry, 4> DotDebugLocEntries; 200 201 /// UseDotDebugLocEntry - DW_AT_location attributes for the DIEs in this set 202 /// idetifies corresponding .debug_loc entry offset. 203 SmallPtrSet<const DIE *, 4> UseDotDebugLocEntry; 204 205 /// VarToAbstractVarMap - Maps DbgVariable with corresponding Abstract 206 /// DbgVariable, if any. 207 DenseMap<const DbgVariable *, const DbgVariable *> VarToAbstractVarMap; 208 209 /// InliendSubprogramDIEs - Collection of subprgram DIEs that are marked 210 /// (at the end of the module) as DW_AT_inline. 211 SmallPtrSet<DIE *, 4> InlinedSubprogramDIEs; 212 213 /// ContainingTypeMap - This map is used to keep track of subprogram DIEs that 214 /// need DW_AT_containing_type attribute. This attribute points to a DIE that 215 /// corresponds to the MDNode mapped with the subprogram DIE. 216 DenseMap<DIE *, const MDNode *> ContainingTypeMap; 217 218 typedef SmallVector<DbgScope *, 2> ScopeVector; 219 SmallPtrSet<const MachineInstr *, 8> InsnsBeginScopeSet; 220 SmallPtrSet<const MachineInstr *, 8> InsnsEndScopeSet; 221 222 /// InlineInfo - Keep track of inlined functions and their location. This 223 /// information is used to populate debug_inlined section. 224 typedef std::pair<const MCSymbol *, DIE *> InlineInfoLabels; 225 DenseMap<const MDNode *, SmallVector<InlineInfoLabels, 4> > InlineInfo; 226 SmallVector<const MDNode *, 4> InlinedSPNodes; 227 228 /// LabelsBeforeInsn - Maps instruction with label emitted before 229 /// instruction. 230 DenseMap<const MachineInstr *, MCSymbol *> LabelsBeforeInsn; 231 232 /// LabelsAfterInsn - Maps instruction with label emitted after 233 /// instruction. 234 DenseMap<const MachineInstr *, MCSymbol *> LabelsAfterInsn; 235 236 SmallVector<const MCSymbol *, 8> DebugRangeSymbols; 237 238 /// Previous instruction's location information. This is used to determine 239 /// label location to indicate scope boundries in dwarf debug info. 240 DebugLoc PrevInstLoc; 241 MCSymbol *PrevLabel; 242 243 struct FunctionDebugFrameInfo { 244 unsigned Number; 245 std::vector<MachineMove> Moves; 246 247 FunctionDebugFrameInfo(unsigned Num, const std::vector<MachineMove> &M) 248 : Number(Num), Moves(M) {} 249 }; 250 251 std::vector<FunctionDebugFrameInfo> DebugFrames; 252 253 // Section Symbols: these are assembler temporary labels that are emitted at 254 // the beginning of each supported dwarf section. These are used to form 255 // section offsets and are created by EmitSectionLabels. 256 MCSymbol *DwarfFrameSectionSym, *DwarfInfoSectionSym, *DwarfAbbrevSectionSym; 257 MCSymbol *DwarfStrSectionSym, *TextSectionSym, *DwarfDebugRangeSectionSym; 258 MCSymbol *DwarfDebugLocSectionSym; 259 MCSymbol *FunctionBeginSym, *FunctionEndSym; 260private: 261 262 /// getSourceDirectoryAndFileIds - Return the directory and file ids that 263 /// maps to the source id. Source id starts at 1. 264 std::pair<unsigned, unsigned> 265 getSourceDirectoryAndFileIds(unsigned SId) const { 266 return SourceIds[SId-1]; 267 } 268 269 /// getNumSourceDirectories - Return the number of source directories in the 270 /// debug info. 271 unsigned getNumSourceDirectories() const { 272 return DirectoryNames.size(); 273 } 274 275 /// getSourceDirectoryName - Return the name of the directory corresponding 276 /// to the id. 277 const std::string &getSourceDirectoryName(unsigned Id) const { 278 return DirectoryNames[Id - 1]; 279 } 280 281 /// getSourceFileName - Return the name of the source file corresponding 282 /// to the id. 283 const std::string &getSourceFileName(unsigned Id) const { 284 return SourceFileNames[Id - 1]; 285 } 286 287 /// getNumSourceIds - Return the number of unique source ids. 288 unsigned getNumSourceIds() const { 289 return SourceIds.size(); 290 } 291 292 /// assignAbbrevNumber - Define a unique number for the abbreviation. 293 /// 294 void assignAbbrevNumber(DIEAbbrev &Abbrev); 295 296 /// createDIEEntry - Creates a new DIEEntry to be a proxy for a debug 297 /// information entry. 298 DIEEntry *createDIEEntry(DIE *Entry); 299 300 /// addUInt - Add an unsigned integer attribute data and value. 301 /// 302 void addUInt(DIE *Die, unsigned Attribute, unsigned Form, uint64_t Integer); 303 304 /// addSInt - Add an signed integer attribute data and value. 305 /// 306 void addSInt(DIE *Die, unsigned Attribute, unsigned Form, int64_t Integer); 307 308 /// addString - Add a string attribute data and value. 309 /// 310 void addString(DIE *Die, unsigned Attribute, unsigned Form, 311 const StringRef Str); 312 313 /// addLabel - Add a Dwarf label attribute data and value. 314 /// 315 void addLabel(DIE *Die, unsigned Attribute, unsigned Form, 316 const MCSymbol *Label); 317 318 /// addDelta - Add a label delta attribute data and value. 319 /// 320 void addDelta(DIE *Die, unsigned Attribute, unsigned Form, 321 const MCSymbol *Hi, const MCSymbol *Lo); 322 323 /// addDIEEntry - Add a DIE attribute data and value. 324 /// 325 void addDIEEntry(DIE *Die, unsigned Attribute, unsigned Form, DIE *Entry); 326 327 /// addBlock - Add block data. 328 /// 329 void addBlock(DIE *Die, unsigned Attribute, unsigned Form, DIEBlock *Block); 330 331 /// addSourceLine - Add location information to specified debug information 332 /// entry. 333 void addSourceLine(DIE *Die, const DIVariable *V); 334 void addSourceLine(DIE *Die, const DIGlobalVariable *G); 335 void addSourceLine(DIE *Die, const DISubprogram *SP); 336 void addSourceLine(DIE *Die, const DIType *Ty); 337 void addSourceLine(DIE *Die, const DINameSpace *NS); 338 339 /// addAddress - Add an address attribute to a die based on the location 340 /// provided. 341 void addAddress(DIE *Die, unsigned Attribute, 342 const MachineLocation &Location); 343 344 /// addRegisterAddress - Add register location entry in variable DIE. 345 bool addRegisterAddress(DIE *Die, const MCSymbol *VS, const MachineOperand &MO); 346 347 /// addConstantValue - Add constant value entry in variable DIE. 348 bool addConstantValue(DIE *Die, const MCSymbol *VS, const MachineOperand &MO); 349 350 /// addConstantFPValue - Add constant value entry in variable DIE. 351 bool addConstantFPValue(DIE *Die, const MCSymbol *VS, const MachineOperand &MO); 352 353 /// addComplexAddress - Start with the address based on the location provided, 354 /// and generate the DWARF information necessary to find the actual variable 355 /// (navigating the extra location information encoded in the type) based on 356 /// the starting location. Add the DWARF information to the die. 357 /// 358 void addComplexAddress(DbgVariable *&DV, DIE *Die, unsigned Attribute, 359 const MachineLocation &Location); 360 361 // FIXME: Should be reformulated in terms of addComplexAddress. 362 /// addBlockByrefAddress - Start with the address based on the location 363 /// provided, and generate the DWARF information necessary to find the 364 /// actual Block variable (navigating the Block struct) based on the 365 /// starting location. Add the DWARF information to the die. Obsolete, 366 /// please use addComplexAddress instead. 367 /// 368 void addBlockByrefAddress(DbgVariable *&DV, DIE *Die, unsigned Attribute, 369 const MachineLocation &Location); 370 371 /// addToContextOwner - Add Die into the list of its context owner's children. 372 void addToContextOwner(DIE *Die, DIDescriptor Context); 373 374 /// addType - Add a new type attribute to the specified entity. 375 void addType(DIE *Entity, DIType Ty); 376 377 378 /// getOrCreateNameSpace - Create a DIE for DINameSpace. 379 DIE *getOrCreateNameSpace(DINameSpace NS); 380 381 /// getOrCreateTypeDIE - Find existing DIE or create new DIE for the 382 /// given DIType. 383 DIE *getOrCreateTypeDIE(DIType Ty); 384 385 void addPubTypes(DISubprogram SP); 386 387 /// constructTypeDIE - Construct basic type die from DIBasicType. 388 void constructTypeDIE(DIE &Buffer, 389 DIBasicType BTy); 390 391 /// constructTypeDIE - Construct derived type die from DIDerivedType. 392 void constructTypeDIE(DIE &Buffer, 393 DIDerivedType DTy); 394 395 /// constructTypeDIE - Construct type DIE from DICompositeType. 396 void constructTypeDIE(DIE &Buffer, 397 DICompositeType CTy); 398 399 /// constructSubrangeDIE - Construct subrange DIE from DISubrange. 400 void constructSubrangeDIE(DIE &Buffer, DISubrange SR, DIE *IndexTy); 401 402 /// constructArrayTypeDIE - Construct array type DIE from DICompositeType. 403 void constructArrayTypeDIE(DIE &Buffer, 404 DICompositeType *CTy); 405 406 /// constructEnumTypeDIE - Construct enum type DIE from DIEnumerator. 407 DIE *constructEnumTypeDIE(DIEnumerator ETy); 408 409 /// createGlobalVariableDIE - Create new DIE using GV. 410 DIE *createGlobalVariableDIE(const DIGlobalVariable &GV); 411 412 /// createMemberDIE - Create new member DIE. 413 DIE *createMemberDIE(const DIDerivedType &DT); 414 415 /// createSubprogramDIE - Create new DIE using SP. 416 DIE *createSubprogramDIE(const DISubprogram &SP, bool MakeDecl = false); 417 418 /// getOrCreateDbgScope - Create DbgScope for the scope. 419 DbgScope *getOrCreateDbgScope(const MDNode *Scope, const MDNode *InlinedAt); 420 421 DbgScope *getOrCreateAbstractScope(const MDNode *N); 422 423 /// findAbstractVariable - Find abstract variable associated with Var. 424 DbgVariable *findAbstractVariable(DIVariable &Var, DebugLoc Loc); 425 426 /// updateSubprogramScopeDIE - Find DIE for the given subprogram and 427 /// attach appropriate DW_AT_low_pc and DW_AT_high_pc attributes. 428 /// If there are global variables in this scope then create and insert 429 /// DIEs for these variables. 430 DIE *updateSubprogramScopeDIE(const MDNode *SPNode); 431 432 /// constructLexicalScope - Construct new DW_TAG_lexical_block 433 /// for this scope and attach DW_AT_low_pc/DW_AT_high_pc labels. 434 DIE *constructLexicalScopeDIE(DbgScope *Scope); 435 436 /// constructInlinedScopeDIE - This scope represents inlined body of 437 /// a function. Construct DIE to represent this concrete inlined copy 438 /// of the function. 439 DIE *constructInlinedScopeDIE(DbgScope *Scope); 440 441 /// constructVariableDIE - Construct a DIE for the given DbgVariable. 442 DIE *constructVariableDIE(DbgVariable *DV, DbgScope *S); 443 444 /// constructScopeDIE - Construct a DIE for this scope. 445 DIE *constructScopeDIE(DbgScope *Scope); 446 447 /// EmitSectionLabels - Emit initial Dwarf sections with a label at 448 /// the start of each one. 449 void EmitSectionLabels(); 450 451 /// emitDIE - Recusively Emits a debug information entry. 452 /// 453 void emitDIE(DIE *Die); 454 455 /// computeSizeAndOffset - Compute the size and offset of a DIE. 456 /// 457 unsigned computeSizeAndOffset(DIE *Die, unsigned Offset, bool Last); 458 459 /// computeSizeAndOffsets - Compute the size and offset of all the DIEs. 460 /// 461 void computeSizeAndOffsets(); 462 463 /// EmitDebugInfo - Emit the debug info section. 464 /// 465 void emitDebugInfo(); 466 467 /// emitAbbreviations - Emit the abbreviation section. 468 /// 469 void emitAbbreviations() const; 470 471 /// emitEndOfLineMatrix - Emit the last address of the section and the end of 472 /// the line matrix. 473 /// 474 void emitEndOfLineMatrix(unsigned SectionEnd); 475 476 /// emitDebugLines - Emit source line information. 477 /// 478 void emitDebugLines(); 479 480 /// emitCommonDebugFrame - Emit common frame info into a debug frame section. 481 /// 482 void emitCommonDebugFrame(); 483 484 /// emitFunctionDebugFrame - Emit per function frame info into a debug frame 485 /// section. 486 void emitFunctionDebugFrame(const FunctionDebugFrameInfo &DebugFrameInfo); 487 488 /// emitDebugPubNames - Emit visible names into a debug pubnames section. 489 /// 490 void emitDebugPubNames(); 491 492 /// emitDebugPubTypes - Emit visible types into a debug pubtypes section. 493 /// 494 void emitDebugPubTypes(); 495 496 /// emitDebugStr - Emit visible names into a debug str section. 497 /// 498 void emitDebugStr(); 499 500 /// emitDebugLoc - Emit visible names into a debug loc section. 501 /// 502 void emitDebugLoc(); 503 504 /// EmitDebugARanges - Emit visible names into a debug aranges section. 505 /// 506 void EmitDebugARanges(); 507 508 /// emitDebugRanges - Emit visible names into a debug ranges section. 509 /// 510 void emitDebugRanges(); 511 512 /// emitDebugMacInfo - Emit visible names into a debug macinfo section. 513 /// 514 void emitDebugMacInfo(); 515 516 /// emitDebugInlineInfo - Emit inline info using following format. 517 /// Section Header: 518 /// 1. length of section 519 /// 2. Dwarf version number 520 /// 3. address size. 521 /// 522 /// Entries (one "entry" for each function that was inlined): 523 /// 524 /// 1. offset into __debug_str section for MIPS linkage name, if exists; 525 /// otherwise offset into __debug_str for regular function name. 526 /// 2. offset into __debug_str section for regular function name. 527 /// 3. an unsigned LEB128 number indicating the number of distinct inlining 528 /// instances for the function. 529 /// 530 /// The rest of the entry consists of a {die_offset, low_pc} pair for each 531 /// inlined instance; the die_offset points to the inlined_subroutine die in 532 /// the __debug_info section, and the low_pc is the starting address for the 533 /// inlining instance. 534 void emitDebugInlineInfo(); 535 536 /// GetOrCreateSourceID - Look up the source id with the given directory and 537 /// source file names. If none currently exists, create a new id and insert it 538 /// in the SourceIds map. This can update DirectoryNames and SourceFileNames 539 /// maps as well. 540 unsigned GetOrCreateSourceID(StringRef DirName, StringRef FileName); 541 542 /// constructCompileUnit - Create new CompileUnit for the given 543 /// metadata node with tag DW_TAG_compile_unit. 544 void constructCompileUnit(const MDNode *N); 545 546 /// getCompielUnit - Get CompileUnit DIE. 547 CompileUnit *getCompileUnit(const MDNode *N) const; 548 549 /// constructGlobalVariableDIE - Construct global variable DIE. 550 void constructGlobalVariableDIE(const MDNode *N); 551 552 /// construct SubprogramDIE - Construct subprogram DIE. 553 void constructSubprogramDIE(const MDNode *N); 554 555 // FIXME: This should go away in favor of complex addresses. 556 /// Find the type the programmer originally declared the variable to be 557 /// and return that type. Obsolete, use GetComplexAddrType instead. 558 /// 559 DIType getBlockByrefType(DIType Ty, std::string Name); 560 561 /// recordSourceLine - Register a source line with debug info. Returns the 562 /// unique label that was emitted and which provides correspondence to 563 /// the source line list. 564 MCSymbol *recordSourceLine(unsigned Line, unsigned Col, const MDNode *Scope); 565 566 /// getSourceLineCount - Return the number of source lines in the debug 567 /// info. 568 unsigned getSourceLineCount() const { 569 return Lines.size(); 570 } 571 572 /// recordVariableFrameIndex - Record a variable's index. 573 void recordVariableFrameIndex(const DbgVariable *V, int Index); 574 575 /// findVariableFrameIndex - Return true if frame index for the variable 576 /// is found. Update FI to hold value of the index. 577 bool findVariableFrameIndex(const DbgVariable *V, int *FI); 578 579 /// findVariableLabel - Find MCSymbol for the variable. 580 const MCSymbol *findVariableLabel(const DbgVariable *V); 581 582 /// findDbgScope - Find DbgScope for the debug loc attached with an 583 /// instruction. 584 DbgScope *findDbgScope(const MachineInstr *MI); 585 586 /// identifyScopeMarkers() - Indentify instructions that are marking 587 /// beginning of or end of a scope. 588 void identifyScopeMarkers(); 589 590 /// extractScopeInformation - Scan machine instructions in this function 591 /// and collect DbgScopes. Return true, if atleast one scope was found. 592 bool extractScopeInformation(); 593 594 /// collectVariableInfo - Populate DbgScope entries with variables' info. 595 void collectVariableInfo(const MachineFunction *); 596 597 /// collectVariableInfoFromMMITable - Collect variable information from 598 /// side table maintained by MMI. 599 void collectVariableInfoFromMMITable(const MachineFunction * MF, 600 SmallPtrSet<const MDNode *, 16> &P); 601public: 602 //===--------------------------------------------------------------------===// 603 // Main entry points. 604 // 605 DwarfDebug(AsmPrinter *A, Module *M); 606 ~DwarfDebug(); 607 608 /// beginModule - Emit all Dwarf sections that should come prior to the 609 /// content. 610 void beginModule(Module *M); 611 612 /// endModule - Emit all Dwarf sections that should come after the content. 613 /// 614 void endModule(); 615 616 /// beginFunction - Gather pre-function debug information. Assumes being 617 /// emitted immediately after the function entry point. 618 void beginFunction(const MachineFunction *MF); 619 620 /// endFunction - Gather and emit post-function debug information. 621 /// 622 void endFunction(const MachineFunction *MF); 623 624 /// getLabelBeforeInsn - Return Label preceding the instruction. 625 const MCSymbol *getLabelBeforeInsn(const MachineInstr *MI); 626 627 /// getLabelAfterInsn - Return Label immediately following the instruction. 628 const MCSymbol *getLabelAfterInsn(const MachineInstr *MI); 629 630 /// beginScope - Process beginning of a scope. 631 void beginScope(const MachineInstr *MI); 632 633 /// endScope - Prcess end of a scope. 634 void endScope(const MachineInstr *MI); 635}; 636} // End of namespace llvm 637 638#endif 639