1 //===-- llvm/CodeGen/DwarfDebug.cpp - Dwarf Debug Framework ---------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file contains support for writing dwarf debug info into asm files.
12 //===----------------------------------------------------------------------===//
13 #define DEBUG_TYPE "dwarfdebug"
14 #include "DwarfDebug.h"
15 #include "llvm/Module.h"
16 #include "llvm/CodeGen/MachineFunction.h"
17 #include "llvm/CodeGen/MachineModuleInfo.h"
18 #include "llvm/MC/MCSection.h"
19 #include "llvm/MC/MCStreamer.h"
20 #include "llvm/MC/MCAsmInfo.h"
21 #include "llvm/Target/TargetData.h"
22 #include "llvm/Target/TargetFrameInfo.h"
23 #include "llvm/Target/TargetLoweringObjectFile.h"
24 #include "llvm/Target/TargetRegisterInfo.h"
25 #include "llvm/ADT/StringExtras.h"
26 #include "llvm/Support/Mangler.h"
27 #include "llvm/Support/Timer.h"
28 #include "llvm/Support/Debug.h"
29 #include "llvm/System/Path.h"
32 static TimerGroup &getDwarfTimerGroup() {
33 static TimerGroup DwarfTimerGroup("Dwarf Debugging");
34 return DwarfTimerGroup;
37 //===----------------------------------------------------------------------===//
39 /// Configuration values for initial hash set sizes (log2).
41 static const unsigned InitDiesSetSize = 9; // log2(512)
42 static const unsigned InitAbbreviationsSetSize = 9; // log2(512)
43 static const unsigned InitValuesSetSize = 9; // log2(512)
47 //===----------------------------------------------------------------------===//
48 /// CompileUnit - This dwarf writer support class manages information associate
49 /// with a source file.
50 class VISIBILITY_HIDDEN CompileUnit {
51 /// ID - File identifier for source.
55 /// Die - Compile unit debug information entry.
59 /// GVToDieMap - Tracks the mapping of unit level debug informaton
60 /// variables to debug information entries.
61 /// FIXME : Rename GVToDieMap -> NodeToDieMap
62 std::map<MDNode *, DIE *> GVToDieMap;
64 /// GVToDIEEntryMap - Tracks the mapping of unit level debug informaton
65 /// descriptors to debug information entries using a DIEEntry proxy.
67 std::map<MDNode *, DIEEntry *> GVToDIEEntryMap;
69 /// Globals - A map of globally visible named entities for this unit.
71 StringMap<DIE*> Globals;
73 /// DiesSet - Used to uniquely define dies within the compile unit.
75 FoldingSet<DIE> DiesSet;
77 CompileUnit(unsigned I, DIE *D)
78 : ID(I), Die(D), DiesSet(InitDiesSetSize) {}
79 ~CompileUnit() { delete Die; }
82 unsigned getID() const { return ID; }
83 DIE* getDie() const { return Die; }
84 StringMap<DIE*> &getGlobals() { return Globals; }
86 /// hasContent - Return true if this compile unit has something to write out.
88 bool hasContent() const { return !Die->getChildren().empty(); }
90 /// AddGlobal - Add a new global entity to the compile unit.
92 void AddGlobal(const std::string &Name, DIE *Die) { Globals[Name] = Die; }
94 /// getDieMapSlotFor - Returns the debug information entry map slot for the
95 /// specified debug variable.
96 DIE *&getDieMapSlotFor(MDNode *N) { return GVToDieMap[N]; }
98 /// getDIEEntrySlotFor - Returns the debug information entry proxy slot for
99 /// the specified debug variable.
100 DIEEntry *&getDIEEntrySlotFor(MDNode *N) {
101 return GVToDIEEntryMap[N];
104 /// AddDie - Adds or interns the DIE to the compile unit.
106 DIE *AddDie(DIE &Buffer) {
110 DIE *Die = DiesSet.FindNodeOrInsertPos(ID, Where);
113 Die = new DIE(Buffer);
114 DiesSet.InsertNode(Die, Where);
115 this->Die->AddChild(Die);
123 //===----------------------------------------------------------------------===//
124 /// DbgVariable - This class is used to track local variable information.
126 class VISIBILITY_HIDDEN DbgVariable {
127 DIVariable Var; // Variable Descriptor.
128 unsigned FrameIndex; // Variable frame index.
129 bool InlinedFnVar; // Variable for an inlined function.
131 DbgVariable(DIVariable V, unsigned I, bool IFV)
132 : Var(V), FrameIndex(I), InlinedFnVar(IFV) {}
135 DIVariable getVariable() const { return Var; }
136 unsigned getFrameIndex() const { return FrameIndex; }
137 bool isInlinedFnVar() const { return InlinedFnVar; }
140 //===----------------------------------------------------------------------===//
141 /// DbgScope - This class is used to track scope information.
143 class DbgConcreteScope;
144 class VISIBILITY_HIDDEN DbgScope {
145 DbgScope *Parent; // Parent to this scope.
146 DIDescriptor Desc; // Debug info descriptor for scope.
147 // Either subprogram or block.
148 unsigned StartLabelID; // Label ID of the beginning of scope.
149 unsigned EndLabelID; // Label ID of the end of scope.
150 const MachineInstr *LastInsn; // Last instruction of this scope.
151 const MachineInstr *FirstInsn; // First instruction of this scope.
152 SmallVector<DbgScope *, 4> Scopes; // Scopes defined in scope.
153 SmallVector<DbgVariable *, 8> Variables;// Variables declared in scope.
154 SmallVector<DbgConcreteScope *, 8> ConcreteInsts;// Concrete insts of funcs.
156 // Private state for dump()
157 mutable unsigned IndentLevel;
159 DbgScope(DbgScope *P, DIDescriptor D)
160 : Parent(P), Desc(D), StartLabelID(0), EndLabelID(0), LastInsn(0),
161 FirstInsn(0), IndentLevel(0) {}
165 DbgScope *getParent() const { return Parent; }
166 DIDescriptor getDesc() const { return Desc; }
167 unsigned getStartLabelID() const { return StartLabelID; }
168 unsigned getEndLabelID() const { return EndLabelID; }
169 SmallVector<DbgScope *, 4> &getScopes() { return Scopes; }
170 SmallVector<DbgVariable *, 8> &getVariables() { return Variables; }
171 SmallVector<DbgConcreteScope*,8> &getConcreteInsts() { return ConcreteInsts; }
172 void setStartLabelID(unsigned S) { StartLabelID = S; }
173 void setEndLabelID(unsigned E) { EndLabelID = E; }
174 void setLastInsn(const MachineInstr *MI) { LastInsn = MI; }
175 const MachineInstr *getLastInsn() { return LastInsn; }
176 void setFirstInsn(const MachineInstr *MI) { FirstInsn = MI; }
177 const MachineInstr *getFirstInsn() { return FirstInsn; }
178 /// AddScope - Add a scope to the scope.
180 void AddScope(DbgScope *S) { Scopes.push_back(S); }
182 /// AddVariable - Add a variable to the scope.
184 void AddVariable(DbgVariable *V) { Variables.push_back(V); }
186 /// AddConcreteInst - Add a concrete instance to the scope.
188 void AddConcreteInst(DbgConcreteScope *C) { ConcreteInsts.push_back(C); }
190 void FixInstructionMarkers() {
191 assert (getFirstInsn() && "First instruction is missing!");
195 // If a scope does not have an instruction to mark an end then use
196 // the end of last child scope.
197 SmallVector<DbgScope *, 4> &Scopes = getScopes();
198 assert (!Scopes.empty() && "Inner most scope does not have last insn!");
199 DbgScope *L = Scopes.back();
200 if (!L->getLastInsn())
201 L->FixInstructionMarkers();
202 setLastInsn(L->getLastInsn());
211 void DbgScope::dump() const {
212 raw_ostream &err = errs();
213 err.indent(IndentLevel);
215 err << " [" << StartLabelID << ", " << EndLabelID << "]\n";
219 for (unsigned i = 0, e = Scopes.size(); i != e; ++i)
220 if (Scopes[i] != this)
227 //===----------------------------------------------------------------------===//
228 /// DbgConcreteScope - This class is used to track a scope that holds concrete
229 /// instance information.
231 class VISIBILITY_HIDDEN DbgConcreteScope : public DbgScope {
233 DIE *Die; // Debug info for this concrete scope.
235 DbgConcreteScope(DIDescriptor D) : DbgScope(NULL, D) {}
238 DIE *getDie() const { return Die; }
239 void setDie(DIE *D) { Die = D; }
242 DbgScope::~DbgScope() {
243 for (unsigned i = 0, N = Scopes.size(); i < N; ++i)
245 for (unsigned j = 0, M = Variables.size(); j < M; ++j)
247 for (unsigned k = 0, O = ConcreteInsts.size(); k < O; ++k)
248 delete ConcreteInsts[k];
251 } // end llvm namespace
253 DwarfDebug::DwarfDebug(raw_ostream &OS, AsmPrinter *A, const MCAsmInfo *T)
254 : Dwarf(OS, A, T, "dbg"), ModuleCU(0),
255 AbbreviationsSet(InitAbbreviationsSetSize), Abbreviations(),
256 ValuesSet(InitValuesSetSize), Values(), StringPool(),
257 SectionSourceLines(), didInitial(false), shouldEmit(false),
258 FunctionDbgScope(0), DebugTimer(0) {
259 if (TimePassesIsEnabled)
260 DebugTimer = new Timer("Dwarf Debug Writer",
261 getDwarfTimerGroup());
263 DwarfDebug::~DwarfDebug() {
264 for (unsigned j = 0, M = Values.size(); j < M; ++j)
267 for (DenseMap<const MDNode *, DbgScope *>::iterator
268 I = AbstractInstanceRootMap.begin(),
269 E = AbstractInstanceRootMap.end(); I != E;++I)
275 /// AssignAbbrevNumber - Define a unique number for the abbreviation.
277 void DwarfDebug::AssignAbbrevNumber(DIEAbbrev &Abbrev) {
278 // Profile the node so that we can make it unique.
282 // Check the set for priors.
283 DIEAbbrev *InSet = AbbreviationsSet.GetOrInsertNode(&Abbrev);
285 // If it's newly added.
286 if (InSet == &Abbrev) {
287 // Add to abbreviation list.
288 Abbreviations.push_back(&Abbrev);
290 // Assign the vector position + 1 as its number.
291 Abbrev.setNumber(Abbreviations.size());
293 // Assign existing abbreviation number.
294 Abbrev.setNumber(InSet->getNumber());
298 /// CreateDIEEntry - Creates a new DIEEntry to be a proxy for a debug
299 /// information entry.
300 DIEEntry *DwarfDebug::CreateDIEEntry(DIE *Entry) {
305 DIEEntry::Profile(ID, Entry);
307 Value = static_cast<DIEEntry *>(ValuesSet.FindNodeOrInsertPos(ID, Where));
309 if (Value) return Value;
311 Value = new DIEEntry(Entry);
312 ValuesSet.InsertNode(Value, Where);
314 Value = new DIEEntry(Entry);
317 Values.push_back(Value);
321 /// SetDIEEntry - Set a DIEEntry once the debug information entry is defined.
323 void DwarfDebug::SetDIEEntry(DIEEntry *Value, DIE *Entry) {
324 Value->setEntry(Entry);
326 // Add to values set if not already there. If it is, we merely have a
327 // duplicate in the values list (no harm.)
328 ValuesSet.GetOrInsertNode(Value);
331 /// AddUInt - Add an unsigned integer attribute data and value.
333 void DwarfDebug::AddUInt(DIE *Die, unsigned Attribute,
334 unsigned Form, uint64_t Integer) {
335 if (!Form) Form = DIEInteger::BestForm(false, Integer);
338 DIEInteger::Profile(ID, Integer);
340 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
343 Value = new DIEInteger(Integer);
344 ValuesSet.InsertNode(Value, Where);
345 Values.push_back(Value);
348 Die->AddValue(Attribute, Form, Value);
351 /// AddSInt - Add an signed integer attribute data and value.
353 void DwarfDebug::AddSInt(DIE *Die, unsigned Attribute,
354 unsigned Form, int64_t Integer) {
355 if (!Form) Form = DIEInteger::BestForm(true, Integer);
358 DIEInteger::Profile(ID, (uint64_t)Integer);
360 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
363 Value = new DIEInteger(Integer);
364 ValuesSet.InsertNode(Value, Where);
365 Values.push_back(Value);
368 Die->AddValue(Attribute, Form, Value);
371 /// AddString - Add a string attribute data and value.
373 void DwarfDebug::AddString(DIE *Die, unsigned Attribute, unsigned Form,
374 const std::string &String) {
376 DIEString::Profile(ID, String);
378 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
381 Value = new DIEString(String);
382 ValuesSet.InsertNode(Value, Where);
383 Values.push_back(Value);
386 Die->AddValue(Attribute, Form, Value);
389 /// AddLabel - Add a Dwarf label attribute data and value.
391 void DwarfDebug::AddLabel(DIE *Die, unsigned Attribute, unsigned Form,
392 const DWLabel &Label) {
394 DIEDwarfLabel::Profile(ID, Label);
396 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
399 Value = new DIEDwarfLabel(Label);
400 ValuesSet.InsertNode(Value, Where);
401 Values.push_back(Value);
404 Die->AddValue(Attribute, Form, Value);
407 /// AddObjectLabel - Add an non-Dwarf label attribute data and value.
409 void DwarfDebug::AddObjectLabel(DIE *Die, unsigned Attribute, unsigned Form,
410 const std::string &Label) {
412 DIEObjectLabel::Profile(ID, Label);
414 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
417 Value = new DIEObjectLabel(Label);
418 ValuesSet.InsertNode(Value, Where);
419 Values.push_back(Value);
422 Die->AddValue(Attribute, Form, Value);
425 /// AddSectionOffset - Add a section offset label attribute data and value.
427 void DwarfDebug::AddSectionOffset(DIE *Die, unsigned Attribute, unsigned Form,
428 const DWLabel &Label, const DWLabel &Section,
429 bool isEH, bool useSet) {
431 DIESectionOffset::Profile(ID, Label, Section);
433 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
436 Value = new DIESectionOffset(Label, Section, isEH, useSet);
437 ValuesSet.InsertNode(Value, Where);
438 Values.push_back(Value);
441 Die->AddValue(Attribute, Form, Value);
444 /// AddDelta - Add a label delta attribute data and value.
446 void DwarfDebug::AddDelta(DIE *Die, unsigned Attribute, unsigned Form,
447 const DWLabel &Hi, const DWLabel &Lo) {
449 DIEDelta::Profile(ID, Hi, Lo);
451 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
454 Value = new DIEDelta(Hi, Lo);
455 ValuesSet.InsertNode(Value, Where);
456 Values.push_back(Value);
459 Die->AddValue(Attribute, Form, Value);
462 /// AddBlock - Add block data.
464 void DwarfDebug::AddBlock(DIE *Die, unsigned Attribute, unsigned Form,
466 Block->ComputeSize(TD);
470 DIEValue *Value = ValuesSet.FindNodeOrInsertPos(ID, Where);
474 ValuesSet.InsertNode(Value, Where);
475 Values.push_back(Value);
477 // Already exists, reuse the previous one.
479 Block = cast<DIEBlock>(Value);
482 Die->AddValue(Attribute, Block->BestForm(), Value);
485 /// AddSourceLine - Add location information to specified debug information
487 void DwarfDebug::AddSourceLine(DIE *Die, const DIVariable *V) {
488 // If there is no compile unit specified, don't add a line #.
489 if (V->getCompileUnit().isNull())
492 unsigned Line = V->getLineNumber();
493 unsigned FileID = FindCompileUnit(V->getCompileUnit()).getID();
494 assert(FileID && "Invalid file id");
495 AddUInt(Die, dwarf::DW_AT_decl_file, 0, FileID);
496 AddUInt(Die, dwarf::DW_AT_decl_line, 0, Line);
499 /// AddSourceLine - Add location information to specified debug information
501 void DwarfDebug::AddSourceLine(DIE *Die, const DIGlobal *G) {
502 // If there is no compile unit specified, don't add a line #.
503 if (G->getCompileUnit().isNull())
506 unsigned Line = G->getLineNumber();
507 unsigned FileID = FindCompileUnit(G->getCompileUnit()).getID();
508 assert(FileID && "Invalid file id");
509 AddUInt(Die, dwarf::DW_AT_decl_file, 0, FileID);
510 AddUInt(Die, dwarf::DW_AT_decl_line, 0, Line);
513 /// AddSourceLine - Add location information to specified debug information
515 void DwarfDebug::AddSourceLine(DIE *Die, const DISubprogram *SP) {
516 // If there is no compile unit specified, don't add a line #.
517 if (SP->getCompileUnit().isNull())
519 // If the line number is 0, don't add it.
520 if (SP->getLineNumber() == 0)
524 unsigned Line = SP->getLineNumber();
525 unsigned FileID = FindCompileUnit(SP->getCompileUnit()).getID();
526 assert(FileID && "Invalid file id");
527 AddUInt(Die, dwarf::DW_AT_decl_file, 0, FileID);
528 AddUInt(Die, dwarf::DW_AT_decl_line, 0, Line);
531 /// AddSourceLine - Add location information to specified debug information
533 void DwarfDebug::AddSourceLine(DIE *Die, const DIType *Ty) {
534 // If there is no compile unit specified, don't add a line #.
535 DICompileUnit CU = Ty->getCompileUnit();
539 unsigned Line = Ty->getLineNumber();
540 unsigned FileID = FindCompileUnit(CU).getID();
541 assert(FileID && "Invalid file id");
542 AddUInt(Die, dwarf::DW_AT_decl_file, 0, FileID);
543 AddUInt(Die, dwarf::DW_AT_decl_line, 0, Line);
546 /* Byref variables, in Blocks, are declared by the programmer as
547 "SomeType VarName;", but the compiler creates a
548 __Block_byref_x_VarName struct, and gives the variable VarName
549 either the struct, or a pointer to the struct, as its type. This
550 is necessary for various behind-the-scenes things the compiler
551 needs to do with by-reference variables in blocks.
553 However, as far as the original *programmer* is concerned, the
554 variable should still have type 'SomeType', as originally declared.
556 The following function dives into the __Block_byref_x_VarName
557 struct to find the original type of the variable. This will be
558 passed back to the code generating the type for the Debug
559 Information Entry for the variable 'VarName'. 'VarName' will then
560 have the original type 'SomeType' in its debug information.
562 The original type 'SomeType' will be the type of the field named
563 'VarName' inside the __Block_byref_x_VarName struct.
565 NOTE: In order for this to not completely fail on the debugger
566 side, the Debug Information Entry for the variable VarName needs to
567 have a DW_AT_location that tells the debugger how to unwind through
568 the pointers and __Block_byref_x_VarName struct to find the actual
569 value of the variable. The function AddBlockByrefType does this. */
571 /// Find the type the programmer originally declared the variable to be
572 /// and return that type.
574 DIType DwarfDebug::GetBlockByrefType(DIType Ty, std::string Name) {
577 unsigned tag = Ty.getTag();
579 if (tag == dwarf::DW_TAG_pointer_type) {
580 DIDerivedType DTy = DIDerivedType(Ty.getNode());
581 subType = DTy.getTypeDerivedFrom();
584 DICompositeType blockStruct = DICompositeType(subType.getNode());
586 DIArray Elements = blockStruct.getTypeArray();
588 if (Elements.isNull())
591 for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) {
592 DIDescriptor Element = Elements.getElement(i);
593 DIDerivedType DT = DIDerivedType(Element.getNode());
594 if (strcmp(Name.c_str(), DT.getName()) == 0)
595 return (DT.getTypeDerivedFrom());
601 /// AddComplexAddress - Start with the address based on the location provided,
602 /// and generate the DWARF information necessary to find the actual variable
603 /// given the extra address information encoded in the DIVariable, starting from
604 /// the starting location. Add the DWARF information to the die.
606 void DwarfDebug::AddComplexAddress(DbgVariable *&DV, DIE *Die,
608 const MachineLocation &Location) {
609 const DIVariable &VD = DV->getVariable();
610 DIType Ty = VD.getType();
612 // Decode the original location, and use that as the start of the byref
613 // variable's location.
614 unsigned Reg = RI->getDwarfRegNum(Location.getReg(), false);
615 DIEBlock *Block = new DIEBlock();
617 if (Location.isReg()) {
619 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_reg0 + Reg);
621 Reg = Reg - dwarf::DW_OP_reg0;
622 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_breg0 + Reg);
623 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
627 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_breg0 + Reg);
629 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_bregx);
630 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
633 AddUInt(Block, 0, dwarf::DW_FORM_sdata, Location.getOffset());
636 for (unsigned i = 0, N = VD.getNumAddrElements(); i < N; ++i) {
637 uint64_t Element = VD.getAddrElement(i);
639 if (Element == DIFactory::OpPlus) {
640 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_plus_uconst);
641 AddUInt(Block, 0, dwarf::DW_FORM_udata, VD.getAddrElement(++i));
642 } else if (Element == DIFactory::OpDeref) {
643 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_deref);
644 } else llvm_unreachable("unknown DIFactory Opcode");
647 // Now attach the location information to the DIE.
648 AddBlock(Die, Attribute, 0, Block);
651 /* Byref variables, in Blocks, are declared by the programmer as "SomeType
652 VarName;", but the compiler creates a __Block_byref_x_VarName struct, and
653 gives the variable VarName either the struct, or a pointer to the struct, as
654 its type. This is necessary for various behind-the-scenes things the
655 compiler needs to do with by-reference variables in Blocks.
657 However, as far as the original *programmer* is concerned, the variable
658 should still have type 'SomeType', as originally declared.
660 The function GetBlockByrefType dives into the __Block_byref_x_VarName
661 struct to find the original type of the variable, which is then assigned to
662 the variable's Debug Information Entry as its real type. So far, so good.
663 However now the debugger will expect the variable VarName to have the type
664 SomeType. So we need the location attribute for the variable to be an
665 expression that explains to the debugger how to navigate through the
666 pointers and struct to find the actual variable of type SomeType.
668 The following function does just that. We start by getting
669 the "normal" location for the variable. This will be the location
670 of either the struct __Block_byref_x_VarName or the pointer to the
671 struct __Block_byref_x_VarName.
673 The struct will look something like:
675 struct __Block_byref_x_VarName {
677 struct __Block_byref_x_VarName *forwarding;
678 ... <various other fields>
680 ... <maybe more fields>
683 If we are given the struct directly (as our starting point) we
684 need to tell the debugger to:
686 1). Add the offset of the forwarding field.
688 2). Follow that pointer to get the the real __Block_byref_x_VarName
689 struct to use (the real one may have been copied onto the heap).
691 3). Add the offset for the field VarName, to find the actual variable.
693 If we started with a pointer to the struct, then we need to
694 dereference that pointer first, before the other steps.
695 Translating this into DWARF ops, we will need to append the following
696 to the current location description for the variable:
698 DW_OP_deref -- optional, if we start with a pointer
699 DW_OP_plus_uconst <forward_fld_offset>
701 DW_OP_plus_uconst <varName_fld_offset>
703 That is what this function does. */
705 /// AddBlockByrefAddress - Start with the address based on the location
706 /// provided, and generate the DWARF information necessary to find the
707 /// actual Block variable (navigating the Block struct) based on the
708 /// starting location. Add the DWARF information to the die. For
709 /// more information, read large comment just above here.
711 void DwarfDebug::AddBlockByrefAddress(DbgVariable *&DV, DIE *Die,
713 const MachineLocation &Location) {
714 const DIVariable &VD = DV->getVariable();
715 DIType Ty = VD.getType();
717 unsigned Tag = Ty.getTag();
718 bool isPointer = false;
720 const char *varName = VD.getName();
722 if (Tag == dwarf::DW_TAG_pointer_type) {
723 DIDerivedType DTy = DIDerivedType(Ty.getNode());
724 TmpTy = DTy.getTypeDerivedFrom();
728 DICompositeType blockStruct = DICompositeType(TmpTy.getNode());
730 // Find the __forwarding field and the variable field in the __Block_byref
732 DIArray Fields = blockStruct.getTypeArray();
733 DIDescriptor varField = DIDescriptor();
734 DIDescriptor forwardingField = DIDescriptor();
737 for (unsigned i = 0, N = Fields.getNumElements(); i < N; ++i) {
738 DIDescriptor Element = Fields.getElement(i);
739 DIDerivedType DT = DIDerivedType(Element.getNode());
740 const char *fieldName = DT.getName();
741 if (strcmp(fieldName, "__forwarding") == 0)
742 forwardingField = Element;
743 else if (strcmp(fieldName, varName) == 0)
747 assert(!varField.isNull() && "Can't find byref variable in Block struct");
748 assert(!forwardingField.isNull()
749 && "Can't find forwarding field in Block struct");
751 // Get the offsets for the forwarding field and the variable field.
752 unsigned int forwardingFieldOffset =
753 DIDerivedType(forwardingField.getNode()).getOffsetInBits() >> 3;
754 unsigned int varFieldOffset =
755 DIDerivedType(varField.getNode()).getOffsetInBits() >> 3;
757 // Decode the original location, and use that as the start of the byref
758 // variable's location.
759 unsigned Reg = RI->getDwarfRegNum(Location.getReg(), false);
760 DIEBlock *Block = new DIEBlock();
762 if (Location.isReg()) {
764 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_reg0 + Reg);
766 Reg = Reg - dwarf::DW_OP_reg0;
767 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_breg0 + Reg);
768 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
772 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_breg0 + Reg);
774 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_bregx);
775 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
778 AddUInt(Block, 0, dwarf::DW_FORM_sdata, Location.getOffset());
781 // If we started with a pointer to the __Block_byref... struct, then
782 // the first thing we need to do is dereference the pointer (DW_OP_deref).
784 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_deref);
786 // Next add the offset for the '__forwarding' field:
787 // DW_OP_plus_uconst ForwardingFieldOffset. Note there's no point in
788 // adding the offset if it's 0.
789 if (forwardingFieldOffset > 0) {
790 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_plus_uconst);
791 AddUInt(Block, 0, dwarf::DW_FORM_udata, forwardingFieldOffset);
794 // Now dereference the __forwarding field to get to the real __Block_byref
795 // struct: DW_OP_deref.
796 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_deref);
798 // Now that we've got the real __Block_byref... struct, add the offset
799 // for the variable's field to get to the location of the actual variable:
800 // DW_OP_plus_uconst varFieldOffset. Again, don't add if it's 0.
801 if (varFieldOffset > 0) {
802 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_plus_uconst);
803 AddUInt(Block, 0, dwarf::DW_FORM_udata, varFieldOffset);
806 // Now attach the location information to the DIE.
807 AddBlock(Die, Attribute, 0, Block);
810 /// AddAddress - Add an address attribute to a die based on the location
812 void DwarfDebug::AddAddress(DIE *Die, unsigned Attribute,
813 const MachineLocation &Location) {
814 unsigned Reg = RI->getDwarfRegNum(Location.getReg(), false);
815 DIEBlock *Block = new DIEBlock();
817 if (Location.isReg()) {
819 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_reg0 + Reg);
821 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_regx);
822 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
826 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_breg0 + Reg);
828 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_bregx);
829 AddUInt(Block, 0, dwarf::DW_FORM_udata, Reg);
832 AddUInt(Block, 0, dwarf::DW_FORM_sdata, Location.getOffset());
835 AddBlock(Die, Attribute, 0, Block);
838 /// AddType - Add a new type attribute to the specified entity.
839 void DwarfDebug::AddType(CompileUnit *DW_Unit, DIE *Entity, DIType Ty) {
843 // Check for pre-existence.
844 DIEEntry *&Slot = DW_Unit->getDIEEntrySlotFor(Ty.getNode());
846 // If it exists then use the existing value.
848 Entity->AddValue(dwarf::DW_AT_type, dwarf::DW_FORM_ref4, Slot);
853 Slot = CreateDIEEntry();
856 DIE Buffer(dwarf::DW_TAG_base_type);
857 if (Ty.isBasicType())
858 ConstructTypeDIE(DW_Unit, Buffer, DIBasicType(Ty.getNode()));
859 else if (Ty.isCompositeType())
860 ConstructTypeDIE(DW_Unit, Buffer, DICompositeType(Ty.getNode()));
862 assert(Ty.isDerivedType() && "Unknown kind of DIType");
863 ConstructTypeDIE(DW_Unit, Buffer, DIDerivedType(Ty.getNode()));
866 // Add debug information entry to entity and appropriate context.
868 DIDescriptor Context = Ty.getContext();
869 if (!Context.isNull())
870 Die = DW_Unit->getDieMapSlotFor(Context.getNode());
873 DIE *Child = new DIE(Buffer);
874 Die->AddChild(Child);
876 SetDIEEntry(Slot, Child);
878 Die = DW_Unit->AddDie(Buffer);
879 SetDIEEntry(Slot, Die);
882 Entity->AddValue(dwarf::DW_AT_type, dwarf::DW_FORM_ref4, Slot);
885 /// ConstructTypeDIE - Construct basic type die from DIBasicType.
886 void DwarfDebug::ConstructTypeDIE(CompileUnit *DW_Unit, DIE &Buffer,
888 // Get core information.
889 const char *Name = BTy.getName();
890 Buffer.setTag(dwarf::DW_TAG_base_type);
891 AddUInt(&Buffer, dwarf::DW_AT_encoding, dwarf::DW_FORM_data1,
894 // Add name if not anonymous or intermediate type.
896 AddString(&Buffer, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
897 uint64_t Size = BTy.getSizeInBits() >> 3;
898 AddUInt(&Buffer, dwarf::DW_AT_byte_size, 0, Size);
901 /// ConstructTypeDIE - Construct derived type die from DIDerivedType.
902 void DwarfDebug::ConstructTypeDIE(CompileUnit *DW_Unit, DIE &Buffer,
904 // Get core information.
905 const char *Name = DTy.getName();
906 uint64_t Size = DTy.getSizeInBits() >> 3;
907 unsigned Tag = DTy.getTag();
909 // FIXME - Workaround for templates.
910 if (Tag == dwarf::DW_TAG_inheritance) Tag = dwarf::DW_TAG_reference_type;
914 // Map to main type, void will not have a type.
915 DIType FromTy = DTy.getTypeDerivedFrom();
916 AddType(DW_Unit, &Buffer, FromTy);
918 // Add name if not anonymous or intermediate type.
920 AddString(&Buffer, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
922 // Add size if non-zero (derived types might be zero-sized.)
924 AddUInt(&Buffer, dwarf::DW_AT_byte_size, 0, Size);
926 // Add source line info if available and TyDesc is not a forward declaration.
927 if (!DTy.isForwardDecl())
928 AddSourceLine(&Buffer, &DTy);
931 /// ConstructTypeDIE - Construct type DIE from DICompositeType.
932 void DwarfDebug::ConstructTypeDIE(CompileUnit *DW_Unit, DIE &Buffer,
933 DICompositeType CTy) {
934 // Get core information.
935 const char *Name = CTy.getName();
937 uint64_t Size = CTy.getSizeInBits() >> 3;
938 unsigned Tag = CTy.getTag();
942 case dwarf::DW_TAG_vector_type:
943 case dwarf::DW_TAG_array_type:
944 ConstructArrayTypeDIE(DW_Unit, Buffer, &CTy);
946 case dwarf::DW_TAG_enumeration_type: {
947 DIArray Elements = CTy.getTypeArray();
949 // Add enumerators to enumeration type.
950 for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) {
952 DIEnumerator Enum(Elements.getElement(i).getNode());
953 ElemDie = ConstructEnumTypeDIE(DW_Unit, &Enum);
954 Buffer.AddChild(ElemDie);
958 case dwarf::DW_TAG_subroutine_type: {
960 DIArray Elements = CTy.getTypeArray();
961 DIDescriptor RTy = Elements.getElement(0);
962 AddType(DW_Unit, &Buffer, DIType(RTy.getNode()));
964 // Add prototype flag.
965 AddUInt(&Buffer, dwarf::DW_AT_prototyped, dwarf::DW_FORM_flag, 1);
968 for (unsigned i = 1, N = Elements.getNumElements(); i < N; ++i) {
969 DIE *Arg = new DIE(dwarf::DW_TAG_formal_parameter);
970 DIDescriptor Ty = Elements.getElement(i);
971 AddType(DW_Unit, Arg, DIType(Ty.getNode()));
972 Buffer.AddChild(Arg);
976 case dwarf::DW_TAG_structure_type:
977 case dwarf::DW_TAG_union_type:
978 case dwarf::DW_TAG_class_type: {
979 // Add elements to structure type.
980 DIArray Elements = CTy.getTypeArray();
982 // A forward struct declared type may not have elements available.
983 if (Elements.isNull())
986 // Add elements to structure type.
987 for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) {
988 DIDescriptor Element = Elements.getElement(i);
989 if (Element.isNull())
992 if (Element.getTag() == dwarf::DW_TAG_subprogram)
993 ElemDie = CreateSubprogramDIE(DW_Unit,
994 DISubprogram(Element.getNode()));
996 ElemDie = CreateMemberDIE(DW_Unit,
997 DIDerivedType(Element.getNode()));
998 Buffer.AddChild(ElemDie);
1001 if (CTy.isAppleBlockExtension())
1002 AddUInt(&Buffer, dwarf::DW_AT_APPLE_block, dwarf::DW_FORM_flag, 1);
1004 unsigned RLang = CTy.getRunTimeLang();
1006 AddUInt(&Buffer, dwarf::DW_AT_APPLE_runtime_class,
1007 dwarf::DW_FORM_data1, RLang);
1014 // Add name if not anonymous or intermediate type.
1016 AddString(&Buffer, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
1018 if (Tag == dwarf::DW_TAG_enumeration_type ||
1019 Tag == dwarf::DW_TAG_structure_type || Tag == dwarf::DW_TAG_union_type) {
1020 // Add size if non-zero (derived types might be zero-sized.)
1022 AddUInt(&Buffer, dwarf::DW_AT_byte_size, 0, Size);
1024 // Add zero size if it is not a forward declaration.
1025 if (CTy.isForwardDecl())
1026 AddUInt(&Buffer, dwarf::DW_AT_declaration, dwarf::DW_FORM_flag, 1);
1028 AddUInt(&Buffer, dwarf::DW_AT_byte_size, 0, 0);
1031 // Add source line info if available.
1032 if (!CTy.isForwardDecl())
1033 AddSourceLine(&Buffer, &CTy);
1037 /// ConstructSubrangeDIE - Construct subrange DIE from DISubrange.
1038 void DwarfDebug::ConstructSubrangeDIE(DIE &Buffer, DISubrange SR, DIE *IndexTy){
1039 int64_t L = SR.getLo();
1040 int64_t H = SR.getHi();
1041 DIE *DW_Subrange = new DIE(dwarf::DW_TAG_subrange_type);
1043 AddDIEEntry(DW_Subrange, dwarf::DW_AT_type, dwarf::DW_FORM_ref4, IndexTy);
1045 AddSInt(DW_Subrange, dwarf::DW_AT_lower_bound, 0, L);
1047 AddSInt(DW_Subrange, dwarf::DW_AT_upper_bound, 0, H);
1049 Buffer.AddChild(DW_Subrange);
1052 /// ConstructArrayTypeDIE - Construct array type DIE from DICompositeType.
1053 void DwarfDebug::ConstructArrayTypeDIE(CompileUnit *DW_Unit, DIE &Buffer,
1054 DICompositeType *CTy) {
1055 Buffer.setTag(dwarf::DW_TAG_array_type);
1056 if (CTy->getTag() == dwarf::DW_TAG_vector_type)
1057 AddUInt(&Buffer, dwarf::DW_AT_GNU_vector, dwarf::DW_FORM_flag, 1);
1059 // Emit derived type.
1060 AddType(DW_Unit, &Buffer, CTy->getTypeDerivedFrom());
1061 DIArray Elements = CTy->getTypeArray();
1063 // Construct an anonymous type for index type.
1064 DIE IdxBuffer(dwarf::DW_TAG_base_type);
1065 AddUInt(&IdxBuffer, dwarf::DW_AT_byte_size, 0, sizeof(int32_t));
1066 AddUInt(&IdxBuffer, dwarf::DW_AT_encoding, dwarf::DW_FORM_data1,
1067 dwarf::DW_ATE_signed);
1068 DIE *IndexTy = DW_Unit->AddDie(IdxBuffer);
1070 // Add subranges to array type.
1071 for (unsigned i = 0, N = Elements.getNumElements(); i < N; ++i) {
1072 DIDescriptor Element = Elements.getElement(i);
1073 if (Element.getTag() == dwarf::DW_TAG_subrange_type)
1074 ConstructSubrangeDIE(Buffer, DISubrange(Element.getNode()), IndexTy);
1078 /// ConstructEnumTypeDIE - Construct enum type DIE from DIEnumerator.
1079 DIE *DwarfDebug::ConstructEnumTypeDIE(CompileUnit *DW_Unit, DIEnumerator *ETy) {
1080 DIE *Enumerator = new DIE(dwarf::DW_TAG_enumerator);
1081 const char *Name = ETy->getName();
1082 AddString(Enumerator, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
1083 int64_t Value = ETy->getEnumValue();
1084 AddSInt(Enumerator, dwarf::DW_AT_const_value, dwarf::DW_FORM_sdata, Value);
1088 /// CreateGlobalVariableDIE - Create new DIE using GV.
1089 DIE *DwarfDebug::CreateGlobalVariableDIE(CompileUnit *DW_Unit,
1090 const DIGlobalVariable &GV) {
1091 DIE *GVDie = new DIE(dwarf::DW_TAG_variable);
1092 AddString(GVDie, dwarf::DW_AT_name, dwarf::DW_FORM_string,
1093 GV.getDisplayName());
1095 const char *LinkageName = GV.getLinkageName();
1097 // Skip special LLVM prefix that is used to inform the asm printer to not
1098 // emit usual symbol prefix before the symbol name. This happens for
1099 // Objective-C symbol names and symbol whose name is replaced using GCC's
1100 // __asm__ attribute.
1101 if (LinkageName[0] == 1)
1102 LinkageName = &LinkageName[1];
1103 AddString(GVDie, dwarf::DW_AT_MIPS_linkage_name, dwarf::DW_FORM_string,
1106 AddType(DW_Unit, GVDie, GV.getType());
1107 if (!GV.isLocalToUnit())
1108 AddUInt(GVDie, dwarf::DW_AT_external, dwarf::DW_FORM_flag, 1);
1109 AddSourceLine(GVDie, &GV);
1112 DIEBlock *Block = new DIEBlock();
1113 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_addr);
1114 AddObjectLabel(Block, 0, dwarf::DW_FORM_udata,
1115 Asm->Mang->getMangledName(GV.getGlobal()));
1116 AddBlock(GVDie, dwarf::DW_AT_location, 0, Block);
1121 /// CreateMemberDIE - Create new member DIE.
1122 DIE *DwarfDebug::CreateMemberDIE(CompileUnit *DW_Unit, const DIDerivedType &DT){
1123 DIE *MemberDie = new DIE(DT.getTag());
1124 if (const char *Name = DT.getName())
1125 AddString(MemberDie, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
1127 AddType(DW_Unit, MemberDie, DT.getTypeDerivedFrom());
1129 AddSourceLine(MemberDie, &DT);
1131 uint64_t Size = DT.getSizeInBits();
1132 uint64_t FieldSize = DT.getOriginalTypeSize();
1134 if (Size != FieldSize) {
1136 AddUInt(MemberDie, dwarf::DW_AT_byte_size, 0, DT.getOriginalTypeSize()>>3);
1137 AddUInt(MemberDie, dwarf::DW_AT_bit_size, 0, DT.getSizeInBits());
1139 uint64_t Offset = DT.getOffsetInBits();
1140 uint64_t FieldOffset = Offset;
1141 uint64_t AlignMask = ~(DT.getAlignInBits() - 1);
1142 uint64_t HiMark = (Offset + FieldSize) & AlignMask;
1143 FieldOffset = (HiMark - FieldSize);
1144 Offset -= FieldOffset;
1146 // Maybe we need to work from the other end.
1147 if (TD->isLittleEndian()) Offset = FieldSize - (Offset + Size);
1148 AddUInt(MemberDie, dwarf::DW_AT_bit_offset, 0, Offset);
1151 DIEBlock *Block = new DIEBlock();
1152 AddUInt(Block, 0, dwarf::DW_FORM_data1, dwarf::DW_OP_plus_uconst);
1153 AddUInt(Block, 0, dwarf::DW_FORM_udata, DT.getOffsetInBits() >> 3);
1154 AddBlock(MemberDie, dwarf::DW_AT_data_member_location, 0, Block);
1156 if (DT.isProtected())
1157 AddUInt(MemberDie, dwarf::DW_AT_accessibility, 0,
1158 dwarf::DW_ACCESS_protected);
1159 else if (DT.isPrivate())
1160 AddUInt(MemberDie, dwarf::DW_AT_accessibility, 0,
1161 dwarf::DW_ACCESS_private);
1166 /// CreateSubprogramDIE - Create new DIE using SP.
1167 DIE *DwarfDebug::CreateSubprogramDIE(CompileUnit *DW_Unit,
1168 const DISubprogram &SP,
1171 DIE *SPDie = new DIE(dwarf::DW_TAG_subprogram);
1173 const char * Name = SP.getName();
1174 AddString(SPDie, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
1176 const char *LinkageName = SP.getLinkageName();
1178 // Skip special LLVM prefix that is used to inform the asm printer to not emit
1179 // usual symbol prefix before the symbol name. This happens for Objective-C
1180 // symbol names and symbol whose name is replaced using GCC's __asm__ attribute.
1181 if (LinkageName[0] == 1)
1182 LinkageName = &LinkageName[1];
1183 AddString(SPDie, dwarf::DW_AT_MIPS_linkage_name, dwarf::DW_FORM_string,
1186 AddSourceLine(SPDie, &SP);
1188 DICompositeType SPTy = SP.getType();
1189 DIArray Args = SPTy.getTypeArray();
1191 // Add prototyped tag, if C or ObjC.
1192 unsigned Lang = SP.getCompileUnit().getLanguage();
1193 if (Lang == dwarf::DW_LANG_C99 || Lang == dwarf::DW_LANG_C89 ||
1194 Lang == dwarf::DW_LANG_ObjC)
1195 AddUInt(SPDie, dwarf::DW_AT_prototyped, dwarf::DW_FORM_flag, 1);
1198 unsigned SPTag = SPTy.getTag();
1199 if (!IsConstructor) {
1200 if (Args.isNull() || SPTag != dwarf::DW_TAG_subroutine_type)
1201 AddType(DW_Unit, SPDie, SPTy);
1203 AddType(DW_Unit, SPDie, DIType(Args.getElement(0).getNode()));
1206 if (!SP.isDefinition()) {
1207 AddUInt(SPDie, dwarf::DW_AT_declaration, dwarf::DW_FORM_flag, 1);
1209 // Add arguments. Do not add arguments for subprogram definition. They will
1210 // be handled through RecordVariable.
1211 if (SPTag == dwarf::DW_TAG_subroutine_type)
1212 for (unsigned i = 1, N = Args.getNumElements(); i < N; ++i) {
1213 DIE *Arg = new DIE(dwarf::DW_TAG_formal_parameter);
1214 AddType(DW_Unit, Arg, DIType(Args.getElement(i).getNode()));
1215 AddUInt(Arg, dwarf::DW_AT_artificial, dwarf::DW_FORM_flag, 1); // ??
1216 SPDie->AddChild(Arg);
1220 if (!SP.isLocalToUnit() && !IsInlined)
1221 AddUInt(SPDie, dwarf::DW_AT_external, dwarf::DW_FORM_flag, 1);
1223 // DW_TAG_inlined_subroutine may refer to this DIE.
1224 DIE *&Slot = DW_Unit->getDieMapSlotFor(SP.getNode());
1229 /// FindCompileUnit - Get the compile unit for the given descriptor.
1231 CompileUnit &DwarfDebug::FindCompileUnit(DICompileUnit Unit) const {
1232 DenseMap<Value *, CompileUnit *>::const_iterator I =
1233 CompileUnitMap.find(Unit.getNode());
1234 assert(I != CompileUnitMap.end() && "Missing compile unit.");
1238 /// CreateDbgScopeVariable - Create a new scope variable.
1240 DIE *DwarfDebug::CreateDbgScopeVariable(DbgVariable *DV, CompileUnit *Unit) {
1241 // Get the descriptor.
1242 const DIVariable &VD = DV->getVariable();
1244 // Translate tag to proper Dwarf tag. The result variable is dropped for
1247 switch (VD.getTag()) {
1248 case dwarf::DW_TAG_return_variable:
1250 case dwarf::DW_TAG_arg_variable:
1251 Tag = dwarf::DW_TAG_formal_parameter;
1253 case dwarf::DW_TAG_auto_variable: // fall thru
1255 Tag = dwarf::DW_TAG_variable;
1259 // Define variable debug information entry.
1260 DIE *VariableDie = new DIE(Tag);
1261 const char *Name = VD.getName();
1262 AddString(VariableDie, dwarf::DW_AT_name, dwarf::DW_FORM_string, Name);
1264 // Add source line info if available.
1265 AddSourceLine(VariableDie, &VD);
1267 // Add variable type.
1268 // FIXME: isBlockByrefVariable should be reformulated in terms of complex addresses instead.
1269 if (VD.isBlockByrefVariable())
1270 AddType(Unit, VariableDie, GetBlockByrefType(VD.getType(), Name));
1272 AddType(Unit, VariableDie, VD.getType());
1274 // Add variable address.
1275 if (!DV->isInlinedFnVar()) {
1276 // Variables for abstract instances of inlined functions don't get a
1278 MachineLocation Location;
1279 Location.set(RI->getFrameRegister(*MF),
1280 RI->getFrameIndexOffset(*MF, DV->getFrameIndex()));
1283 if (VD.hasComplexAddress())
1284 AddComplexAddress(DV, VariableDie, dwarf::DW_AT_location, Location);
1285 else if (VD.isBlockByrefVariable())
1286 AddBlockByrefAddress(DV, VariableDie, dwarf::DW_AT_location, Location);
1288 AddAddress(VariableDie, dwarf::DW_AT_location, Location);
1294 /// getOrCreateScope - Returns the scope associated with the given descriptor.
1296 DbgScope *DwarfDebug::getDbgScope(MDNode *N, const MachineInstr *MI) {
1297 DbgScope *&Slot = DbgScopeMap[N];
1298 if (Slot) return Slot;
1300 DbgScope *Parent = NULL;
1302 DIDescriptor Scope(N);
1303 if (Scope.isCompileUnit()) {
1305 } else if (Scope.isSubprogram()) {
1307 DIDescriptor ParentDesc = SP.getContext();
1308 if (!ParentDesc.isNull() && !ParentDesc.isCompileUnit())
1309 Parent = getDbgScope(ParentDesc.getNode(), MI);
1310 } else if (Scope.isLexicalBlock()) {
1311 DILexicalBlock DB(N);
1312 DIDescriptor ParentDesc = DB.getContext();
1313 if (!ParentDesc.isNull())
1314 Parent = getDbgScope(ParentDesc.getNode(), MI);
1316 assert (0 && "Unexpected scope info");
1318 Slot = new DbgScope(Parent, DIDescriptor(N));
1319 Slot->setFirstInsn(MI);
1322 Parent->AddScope(Slot);
1324 // First function is top level function.
1325 // FIXME - Dpatel - What is FunctionDbgScope ?
1326 if (!FunctionDbgScope)
1327 FunctionDbgScope = Slot;
1333 /// getOrCreateScope - Returns the scope associated with the given descriptor.
1334 /// FIXME - Remove this method.
1335 DbgScope *DwarfDebug::getOrCreateScope(MDNode *N) {
1336 DbgScope *&Slot = DbgScopeMap[N];
1337 if (Slot) return Slot;
1339 DbgScope *Parent = NULL;
1340 DILexicalBlock Block(N);
1342 // Don't create a new scope if we already created one for an inlined function.
1343 DenseMap<const MDNode *, DbgScope *>::iterator
1344 II = AbstractInstanceRootMap.find(N);
1345 if (II != AbstractInstanceRootMap.end())
1346 return LexicalScopeStack.back();
1348 if (!Block.isNull()) {
1349 DIDescriptor ParentDesc = Block.getContext();
1351 ParentDesc.isNull() ? NULL : getOrCreateScope(ParentDesc.getNode());
1354 Slot = new DbgScope(Parent, DIDescriptor(N));
1357 Parent->AddScope(Slot);
1359 // First function is top level function.
1360 FunctionDbgScope = Slot;
1365 /// ConstructDbgScope - Construct the components of a scope.
1367 void DwarfDebug::ConstructDbgScope(DbgScope *ParentScope,
1368 unsigned ParentStartID,
1369 unsigned ParentEndID,
1370 DIE *ParentDie, CompileUnit *Unit) {
1371 // Add variables to scope.
1372 SmallVector<DbgVariable *, 8> &Variables = ParentScope->getVariables();
1373 for (unsigned i = 0, N = Variables.size(); i < N; ++i) {
1374 DIE *VariableDie = CreateDbgScopeVariable(Variables[i], Unit);
1375 if (VariableDie) ParentDie->AddChild(VariableDie);
1378 // Add concrete instances to scope.
1379 SmallVector<DbgConcreteScope *, 8> &ConcreteInsts =
1380 ParentScope->getConcreteInsts();
1381 for (unsigned i = 0, N = ConcreteInsts.size(); i < N; ++i) {
1382 DbgConcreteScope *ConcreteInst = ConcreteInsts[i];
1383 DIE *Die = ConcreteInst->getDie();
1385 unsigned StartID = ConcreteInst->getStartLabelID();
1386 unsigned EndID = ConcreteInst->getEndLabelID();
1388 // Add the scope bounds.
1390 AddLabel(Die, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1391 DWLabel("label", StartID));
1393 AddLabel(Die, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1394 DWLabel("func_begin", SubprogramCount));
1397 AddLabel(Die, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1398 DWLabel("label", EndID));
1400 AddLabel(Die, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1401 DWLabel("func_end", SubprogramCount));
1403 ParentDie->AddChild(Die);
1406 // Add nested scopes.
1407 SmallVector<DbgScope *, 4> &Scopes = ParentScope->getScopes();
1408 for (unsigned j = 0, M = Scopes.size(); j < M; ++j) {
1409 // Define the Scope debug information entry.
1410 DbgScope *Scope = Scopes[j];
1412 unsigned StartID = MMI->MappedLabel(Scope->getStartLabelID());
1413 unsigned EndID = MMI->MappedLabel(Scope->getEndLabelID());
1415 // Ignore empty scopes.
1416 if (StartID == EndID && StartID != 0) continue;
1418 // Do not ignore inlined scopes even if they don't have any variables or
1420 if (Scope->getScopes().empty() && Scope->getVariables().empty() &&
1421 Scope->getConcreteInsts().empty())
1424 if (StartID == ParentStartID && EndID == ParentEndID) {
1425 // Just add stuff to the parent scope.
1426 ConstructDbgScope(Scope, ParentStartID, ParentEndID, ParentDie, Unit);
1428 DIE *ScopeDie = new DIE(dwarf::DW_TAG_lexical_block);
1430 // Add the scope bounds.
1432 AddLabel(ScopeDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1433 DWLabel("label", StartID));
1435 AddLabel(ScopeDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1436 DWLabel("func_begin", SubprogramCount));
1439 AddLabel(ScopeDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1440 DWLabel("label", EndID));
1442 AddLabel(ScopeDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1443 DWLabel("func_end", SubprogramCount));
1445 // Add the scope's contents.
1446 ConstructDbgScope(Scope, StartID, EndID, ScopeDie, Unit);
1447 ParentDie->AddChild(ScopeDie);
1452 /// ConstructFunctionDbgScope - Construct the scope for the subprogram.
1454 void DwarfDebug::ConstructFunctionDbgScope(DbgScope *RootScope,
1455 bool AbstractScope) {
1456 // Exit if there is no root scope.
1457 if (!RootScope) return;
1458 DIDescriptor Desc = RootScope->getDesc();
1462 // Get the subprogram debug information entry.
1463 DISubprogram SPD(Desc.getNode());
1465 // Get the subprogram die.
1466 DIE *SPDie = ModuleCU->getDieMapSlotFor(SPD.getNode());
1468 ConstructSubprogram(SPD.getNode());
1469 SPDie = ModuleCU->getDieMapSlotFor(SPD.getNode());
1471 assert(SPDie && "Missing subprogram descriptor");
1473 if (!AbstractScope) {
1474 // Add the function bounds.
1475 AddLabel(SPDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1476 DWLabel("func_begin", SubprogramCount));
1477 AddLabel(SPDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1478 DWLabel("func_end", SubprogramCount));
1479 MachineLocation Location(RI->getFrameRegister(*MF));
1480 AddAddress(SPDie, dwarf::DW_AT_frame_base, Location);
1483 ConstructDbgScope(RootScope, 0, 0, SPDie, ModuleCU);
1484 // If there are global variables at this scope then add their dies.
1485 for (SmallVector<WeakVH, 4>::iterator SGI = ScopedGVs.begin(),
1486 SGE = ScopedGVs.end(); SGI != SGE; ++SGI) {
1487 MDNode *N = dyn_cast_or_null<MDNode>(*SGI);
1489 DIGlobalVariable GV(N);
1490 if (GV.getContext().getNode() == RootScope->getDesc().getNode()) {
1491 DIE *ScopedGVDie = CreateGlobalVariableDIE(ModuleCU, GV);
1492 SPDie->AddChild(ScopedGVDie);
1497 /// ConstructDefaultDbgScope - Construct a default scope for the subprogram.
1499 void DwarfDebug::ConstructDefaultDbgScope(MachineFunction *MF) {
1500 StringMap<DIE*> &Globals = ModuleCU->getGlobals();
1501 StringMap<DIE*>::iterator GI = Globals.find(MF->getFunction()->getName());
1502 if (GI != Globals.end()) {
1503 DIE *SPDie = GI->second;
1505 // Add the function bounds.
1506 AddLabel(SPDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1507 DWLabel("func_begin", SubprogramCount));
1508 AddLabel(SPDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1509 DWLabel("func_end", SubprogramCount));
1511 MachineLocation Location(RI->getFrameRegister(*MF));
1512 AddAddress(SPDie, dwarf::DW_AT_frame_base, Location);
1516 /// GetOrCreateSourceID - Look up the source id with the given directory and
1517 /// source file names. If none currently exists, create a new id and insert it
1518 /// in the SourceIds map. This can update DirectoryNames and SourceFileNames
1520 unsigned DwarfDebug::GetOrCreateSourceID(const char *DirName,
1521 const char *FileName) {
1523 StringMap<unsigned>::iterator DI = DirectoryIdMap.find(DirName);
1524 if (DI != DirectoryIdMap.end()) {
1525 DId = DI->getValue();
1527 DId = DirectoryNames.size() + 1;
1528 DirectoryIdMap[DirName] = DId;
1529 DirectoryNames.push_back(DirName);
1533 StringMap<unsigned>::iterator FI = SourceFileIdMap.find(FileName);
1534 if (FI != SourceFileIdMap.end()) {
1535 FId = FI->getValue();
1537 FId = SourceFileNames.size() + 1;
1538 SourceFileIdMap[FileName] = FId;
1539 SourceFileNames.push_back(FileName);
1542 DenseMap<std::pair<unsigned, unsigned>, unsigned>::iterator SI =
1543 SourceIdMap.find(std::make_pair(DId, FId));
1544 if (SI != SourceIdMap.end())
1547 unsigned SrcId = SourceIds.size() + 1; // DW_AT_decl_file cannot be 0.
1548 SourceIdMap[std::make_pair(DId, FId)] = SrcId;
1549 SourceIds.push_back(std::make_pair(DId, FId));
1554 void DwarfDebug::ConstructCompileUnit(MDNode *N) {
1555 DICompileUnit DIUnit(N);
1556 const char *FN = DIUnit.getFilename();
1557 const char *Dir = DIUnit.getDirectory();
1558 unsigned ID = GetOrCreateSourceID(Dir, FN);
1560 DIE *Die = new DIE(dwarf::DW_TAG_compile_unit);
1561 AddSectionOffset(Die, dwarf::DW_AT_stmt_list, dwarf::DW_FORM_data4,
1562 DWLabel("section_line", 0), DWLabel("section_line", 0),
1564 AddString(Die, dwarf::DW_AT_producer, dwarf::DW_FORM_string,
1565 DIUnit.getProducer());
1566 AddUInt(Die, dwarf::DW_AT_language, dwarf::DW_FORM_data1,
1567 DIUnit.getLanguage());
1568 AddString(Die, dwarf::DW_AT_name, dwarf::DW_FORM_string, FN);
1571 AddString(Die, dwarf::DW_AT_comp_dir, dwarf::DW_FORM_string, Dir);
1572 if (DIUnit.isOptimized())
1573 AddUInt(Die, dwarf::DW_AT_APPLE_optimized, dwarf::DW_FORM_flag, 1);
1575 if (const char *Flags = DIUnit.getFlags())
1576 AddString(Die, dwarf::DW_AT_APPLE_flags, dwarf::DW_FORM_string, Flags);
1578 unsigned RVer = DIUnit.getRunTimeVersion();
1580 AddUInt(Die, dwarf::DW_AT_APPLE_major_runtime_vers,
1581 dwarf::DW_FORM_data1, RVer);
1583 CompileUnit *Unit = new CompileUnit(ID, Die);
1584 if (!ModuleCU && DIUnit.isMain()) {
1585 // Use first compile unit marked as isMain as the compile unit
1590 CompileUnitMap[DIUnit.getNode()] = Unit;
1591 CompileUnits.push_back(Unit);
1594 void DwarfDebug::ConstructGlobalVariableDIE(MDNode *N) {
1595 DIGlobalVariable DI_GV(N);
1597 // If debug information is malformed then ignore it.
1598 if (DI_GV.Verify() == false)
1601 // Check for pre-existence.
1602 DIE *&Slot = ModuleCU->getDieMapSlotFor(DI_GV.getNode());
1606 DIE *VariableDie = CreateGlobalVariableDIE(ModuleCU, DI_GV);
1611 // Add to context owner.
1612 ModuleCU->getDie()->AddChild(VariableDie);
1614 // Expose as global. FIXME - need to check external flag.
1615 ModuleCU->AddGlobal(DI_GV.getName(), VariableDie);
1619 void DwarfDebug::ConstructSubprogram(MDNode *N) {
1622 // Check for pre-existence.
1623 DIE *&Slot = ModuleCU->getDieMapSlotFor(N);
1627 if (!SP.isDefinition())
1628 // This is a method declaration which will be handled while constructing
1632 DIE *SubprogramDie = CreateSubprogramDIE(ModuleCU, SP);
1635 Slot = SubprogramDie;
1637 // Add to context owner.
1638 ModuleCU->getDie()->AddChild(SubprogramDie);
1640 // Expose as global.
1641 ModuleCU->AddGlobal(SP.getName(), SubprogramDie);
1645 /// BeginModule - Emit all Dwarf sections that should come prior to the
1646 /// content. Create global DIEs and emit initial debug info sections.
1647 /// This is inovked by the target AsmPrinter.
1648 void DwarfDebug::BeginModule(Module *M, MachineModuleInfo *mmi) {
1651 if (TimePassesIsEnabled)
1652 DebugTimer->startTimer();
1654 DebugInfoFinder DbgFinder;
1655 DbgFinder.processModule(*M);
1657 // Create all the compile unit DIEs.
1658 for (DebugInfoFinder::iterator I = DbgFinder.compile_unit_begin(),
1659 E = DbgFinder.compile_unit_end(); I != E; ++I)
1660 ConstructCompileUnit(*I);
1662 if (CompileUnits.empty()) {
1663 if (TimePassesIsEnabled)
1664 DebugTimer->stopTimer();
1669 // If main compile unit for this module is not seen than randomly
1670 // select first compile unit.
1672 ModuleCU = CompileUnits[0];
1674 // Create DIEs for each of the externally visible global variables.
1675 for (DebugInfoFinder::iterator I = DbgFinder.global_variable_begin(),
1676 E = DbgFinder.global_variable_end(); I != E; ++I) {
1677 DIGlobalVariable GV(*I);
1678 if (GV.getContext().getNode() != GV.getCompileUnit().getNode())
1679 ScopedGVs.push_back(*I);
1681 ConstructGlobalVariableDIE(*I);
1684 // Create DIEs for each of the externally visible subprograms.
1685 for (DebugInfoFinder::iterator I = DbgFinder.subprogram_begin(),
1686 E = DbgFinder.subprogram_end(); I != E; ++I)
1687 ConstructSubprogram(*I);
1691 MMI->setDebugInfoAvailability(true);
1693 // Prime section data.
1694 SectionMap.insert(Asm->getObjFileLowering().getTextSection());
1696 // Print out .file directives to specify files for .loc directives. These are
1697 // printed out early so that they precede any .loc directives.
1698 if (MAI->hasDotLocAndDotFile()) {
1699 for (unsigned i = 1, e = getNumSourceIds()+1; i != e; ++i) {
1700 // Remember source id starts at 1.
1701 std::pair<unsigned, unsigned> Id = getSourceDirectoryAndFileIds(i);
1702 sys::Path FullPath(getSourceDirectoryName(Id.first));
1704 FullPath.appendComponent(getSourceFileName(Id.second));
1705 assert(AppendOk && "Could not append filename to directory!");
1707 Asm->EmitFile(i, FullPath.str());
1712 // Emit initial sections
1715 if (TimePassesIsEnabled)
1716 DebugTimer->stopTimer();
1719 /// EndModule - Emit all Dwarf sections that should come after the content.
1721 void DwarfDebug::EndModule() {
1725 if (TimePassesIsEnabled)
1726 DebugTimer->startTimer();
1728 // Standard sections final addresses.
1729 Asm->OutStreamer.SwitchSection(Asm->getObjFileLowering().getTextSection());
1730 EmitLabel("text_end", 0);
1731 Asm->OutStreamer.SwitchSection(Asm->getObjFileLowering().getDataSection());
1732 EmitLabel("data_end", 0);
1734 // End text sections.
1735 for (unsigned i = 1, N = SectionMap.size(); i <= N; ++i) {
1736 Asm->OutStreamer.SwitchSection(SectionMap[i]);
1737 EmitLabel("section_end", i);
1740 // Emit common frame information.
1741 EmitCommonDebugFrame();
1743 // Emit function debug frame information
1744 for (std::vector<FunctionDebugFrameInfo>::iterator I = DebugFrames.begin(),
1745 E = DebugFrames.end(); I != E; ++I)
1746 EmitFunctionDebugFrame(*I);
1748 // Compute DIE offsets and sizes.
1751 // Emit all the DIEs into a debug info section
1754 // Corresponding abbreviations into a abbrev section.
1755 EmitAbbreviations();
1757 // Emit source line correspondence into a debug line section.
1760 // Emit info into a debug pubnames section.
1761 EmitDebugPubNames();
1763 // Emit info into a debug str section.
1766 // Emit info into a debug loc section.
1769 // Emit info into a debug aranges section.
1772 // Emit info into a debug ranges section.
1775 // Emit info into a debug macinfo section.
1778 // Emit inline info.
1779 EmitDebugInlineInfo();
1781 if (TimePassesIsEnabled)
1782 DebugTimer->stopTimer();
1785 /// ExtractScopeInformation - Scan machine instructions in this function
1786 /// and collect DbgScopes. Return true, if atleast one scope was found.
1787 bool DwarfDebug::ExtractScopeInformation(MachineFunction *MF) {
1788 // If scope information was extracted using .dbg intrinsics then there is not
1789 // any need to extract these information by scanning each instruction.
1790 if (!DbgScopeMap.empty())
1793 // Scan each instruction and create scopes.
1794 for (MachineFunction::const_iterator I = MF->begin(), E = MF->end();
1796 for (MachineBasicBlock::const_iterator II = I->begin(), IE = I->end();
1798 const MachineInstr *MInsn = II;
1799 DebugLoc DL = MInsn->getDebugLoc();
1802 DebugLocTuple DLT = MF->getDebugLocTuple(DL);
1803 if (!DLT.CompileUnit)
1805 // There is no need to create another DIE for compile unit. For all
1806 // other scopes, create one DbgScope now. This will be translated
1807 // into a scope DIE at the end.
1808 DIDescriptor D(DLT.CompileUnit);
1809 if (!D.isCompileUnit()) {
1810 DbgScope *Scope = getDbgScope(DLT.CompileUnit, MInsn);
1811 Scope->setLastInsn(MInsn);
1816 // If a scope's last instruction is not set then use its child scope's
1817 // last instruction as this scope's last instrunction.
1818 for (DenseMap<MDNode *, DbgScope *>::iterator DI = DbgScopeMap.begin(),
1819 DE = DbgScopeMap.end(); DI != DE; ++DI) {
1820 assert (DI->second->getFirstInsn() && "Invalid first instruction!");
1821 DI->second->FixInstructionMarkers();
1822 assert (DI->second->getLastInsn() && "Invalid last instruction!");
1825 // Each scope has first instruction and last instruction to mark beginning
1826 // and end of a scope respectively. Create an inverse map that list scopes
1827 // starts (and ends) with an instruction. One instruction may start (or end)
1829 for (DenseMap<MDNode *, DbgScope *>::iterator DI = DbgScopeMap.begin(),
1830 DE = DbgScopeMap.end(); DI != DE; ++DI) {
1831 DbgScope *S = DI->second;
1832 assert (S && "DbgScope is missing!");
1833 const MachineInstr *MI = S->getFirstInsn();
1834 assert (MI && "DbgScope does not have first instruction!");
1836 InsnToDbgScopeMapTy::iterator IDI = DbgScopeBeginMap.find(MI);
1837 if (IDI != DbgScopeBeginMap.end())
1838 IDI->second.push_back(S);
1840 DbgScopeBeginMap.insert(std::make_pair(MI,
1841 SmallVector<DbgScope *, 2>(2, S)));
1843 MI = S->getLastInsn();
1844 assert (MI && "DbgScope does not have last instruction!");
1845 IDI = DbgScopeEndMap.find(MI);
1846 if (IDI != DbgScopeEndMap.end())
1847 IDI->second.push_back(S);
1849 DbgScopeEndMap.insert(std::make_pair(MI,
1850 SmallVector<DbgScope *, 2>(2, S)));
1853 return !DbgScopeMap.empty();
1856 /// BeginFunction - Gather pre-function debug information. Assumes being
1857 /// emitted immediately after the function entry point.
1858 void DwarfDebug::BeginFunction(MachineFunction *MF) {
1861 if (!ShouldEmitDwarfDebug()) return;
1863 if (TimePassesIsEnabled)
1864 DebugTimer->startTimer();
1866 // Begin accumulating function debug information.
1867 MMI->BeginFunction(MF);
1869 // Assumes in correct section after the entry point.
1870 EmitLabel("func_begin", ++SubprogramCount);
1872 // Emit label for the implicitly defined dbg.stoppoint at the start of the
1874 DebugLoc FDL = MF->getDefaultDebugLoc();
1875 if (!FDL.isUnknown()) {
1876 DebugLocTuple DLT = MF->getDebugLocTuple(FDL);
1877 unsigned LabelID = RecordSourceLine(DLT.Line, DLT.Col, DLT.CompileUnit);
1878 Asm->printLabel(LabelID);
1882 if (TimePassesIsEnabled)
1883 DebugTimer->stopTimer();
1886 /// EndFunction - Gather and emit post-function debug information.
1888 void DwarfDebug::EndFunction(MachineFunction *MF) {
1889 if (!ShouldEmitDwarfDebug()) return;
1891 if (TimePassesIsEnabled)
1892 DebugTimer->startTimer();
1894 // Define end label for subprogram.
1895 EmitLabel("func_end", SubprogramCount);
1897 // Get function line info.
1898 if (!Lines.empty()) {
1899 // Get section line info.
1900 unsigned ID = SectionMap.insert(Asm->getCurrentSection());
1901 if (SectionSourceLines.size() < ID) SectionSourceLines.resize(ID);
1902 std::vector<SrcLineInfo> &SectionLineInfos = SectionSourceLines[ID-1];
1903 // Append the function info to section info.
1904 SectionLineInfos.insert(SectionLineInfos.end(),
1905 Lines.begin(), Lines.end());
1908 // Construct the DbgScope for abstract instances.
1909 for (SmallVector<DbgScope *, 32>::iterator
1910 I = AbstractInstanceRootList.begin(),
1911 E = AbstractInstanceRootList.end(); I != E; ++I)
1912 ConstructFunctionDbgScope(*I);
1914 // Construct scopes for subprogram.
1915 if (FunctionDbgScope)
1916 ConstructFunctionDbgScope(FunctionDbgScope);
1918 // FIXME: This is wrong. We are essentially getting past a problem with
1919 // debug information not being able to handle unreachable blocks that have
1920 // debug information in them. In particular, those unreachable blocks that
1921 // have "region end" info in them. That situation results in the "root
1922 // scope" not being created. If that's the case, then emit a "default"
1923 // scope, i.e., one that encompasses the whole function. This isn't
1924 // desirable. And a better way of handling this (and all of the debugging
1925 // information) needs to be explored.
1926 ConstructDefaultDbgScope(MF);
1928 DebugFrames.push_back(FunctionDebugFrameInfo(SubprogramCount,
1929 MMI->getFrameMoves()));
1932 if (FunctionDbgScope) {
1933 delete FunctionDbgScope;
1934 DbgScopeMap.clear();
1935 DbgScopeBeginMap.clear();
1936 DbgScopeEndMap.clear();
1937 DbgAbstractScopeMap.clear();
1938 DbgConcreteScopeMap.clear();
1939 FunctionDbgScope = NULL;
1940 LexicalScopeStack.clear();
1941 AbstractInstanceRootList.clear();
1942 AbstractInstanceRootMap.clear();
1947 if (TimePassesIsEnabled)
1948 DebugTimer->stopTimer();
1951 /// RecordSourceLine - Records location information and associates it with a
1952 /// label. Returns a unique label ID used to generate a label and provide
1953 /// correspondence to the source line list.
1954 unsigned DwarfDebug::RecordSourceLine(Value *V, unsigned Line, unsigned Col) {
1955 if (TimePassesIsEnabled)
1956 DebugTimer->startTimer();
1958 CompileUnit *Unit = CompileUnitMap[V];
1959 assert(Unit && "Unable to find CompileUnit");
1960 unsigned ID = MMI->NextLabelID();
1961 Lines.push_back(SrcLineInfo(Line, Col, Unit->getID(), ID));
1963 if (TimePassesIsEnabled)
1964 DebugTimer->stopTimer();
1969 /// RecordSourceLine - Records location information and associates it with a
1970 /// label. Returns a unique label ID used to generate a label and provide
1971 /// correspondence to the source line list.
1972 unsigned DwarfDebug::RecordSourceLine(unsigned Line, unsigned Col,
1977 if (TimePassesIsEnabled)
1978 DebugTimer->startTimer();
1980 const char *Dir = NULL;
1981 const char *Fn = NULL;
1983 DIDescriptor Scope(S);
1984 if (Scope.isCompileUnit()) {
1985 DICompileUnit CU(S);
1986 Dir = CU.getDirectory();
1987 Fn = CU.getFilename();
1988 } else if (Scope.isSubprogram()) {
1990 Dir = SP.getDirectory();
1991 Fn = SP.getFilename();
1992 } else if (Scope.isLexicalBlock()) {
1993 DILexicalBlock DB(S);
1994 Dir = DB.getDirectory();
1995 Fn = DB.getFilename();
1997 assert (0 && "Unexpected scope info");
1999 unsigned Src = GetOrCreateSourceID(Dir, Fn);
2000 unsigned ID = MMI->NextLabelID();
2001 Lines.push_back(SrcLineInfo(Line, Col, Src, ID));
2003 if (TimePassesIsEnabled)
2004 DebugTimer->stopTimer();
2009 /// getOrCreateSourceID - Public version of GetOrCreateSourceID. This can be
2010 /// timed. Look up the source id with the given directory and source file
2011 /// names. If none currently exists, create a new id and insert it in the
2012 /// SourceIds map. This can update DirectoryNames and SourceFileNames maps as
2014 unsigned DwarfDebug::getOrCreateSourceID(const std::string &DirName,
2015 const std::string &FileName) {
2016 if (TimePassesIsEnabled)
2017 DebugTimer->startTimer();
2019 unsigned SrcId = GetOrCreateSourceID(DirName.c_str(), FileName.c_str());
2021 if (TimePassesIsEnabled)
2022 DebugTimer->stopTimer();
2027 /// RecordRegionStart - Indicate the start of a region.
2028 unsigned DwarfDebug::RecordRegionStart(MDNode *N) {
2029 if (TimePassesIsEnabled)
2030 DebugTimer->startTimer();
2032 DbgScope *Scope = getOrCreateScope(N);
2033 unsigned ID = MMI->NextLabelID();
2034 if (!Scope->getStartLabelID()) Scope->setStartLabelID(ID);
2035 LexicalScopeStack.push_back(Scope);
2037 if (TimePassesIsEnabled)
2038 DebugTimer->stopTimer();
2043 /// RecordRegionEnd - Indicate the end of a region.
2044 unsigned DwarfDebug::RecordRegionEnd(MDNode *N) {
2045 if (TimePassesIsEnabled)
2046 DebugTimer->startTimer();
2048 DbgScope *Scope = getOrCreateScope(N);
2049 unsigned ID = MMI->NextLabelID();
2050 Scope->setEndLabelID(ID);
2051 // FIXME : region.end() may not be in the last basic block.
2052 // For now, do not pop last lexical scope because next basic
2053 // block may start new inlined function's body.
2054 unsigned LSSize = LexicalScopeStack.size();
2055 if (LSSize != 0 && LSSize != 1)
2056 LexicalScopeStack.pop_back();
2058 if (TimePassesIsEnabled)
2059 DebugTimer->stopTimer();
2064 /// RecordVariable - Indicate the declaration of a local variable.
2065 void DwarfDebug::RecordVariable(MDNode *N, unsigned FrameIndex) {
2066 if (TimePassesIsEnabled)
2067 DebugTimer->startTimer();
2069 DIDescriptor Desc(N);
2070 DbgScope *Scope = NULL;
2071 bool InlinedFnVar = false;
2073 if (Desc.getTag() == dwarf::DW_TAG_variable)
2074 Scope = getOrCreateScope(DIGlobalVariable(N).getContext().getNode());
2076 bool InlinedVar = false;
2077 MDNode *Context = DIVariable(N).getContext().getNode();
2078 DISubprogram SP(Context);
2080 // SP is inserted into DbgAbstractScopeMap when inlined function
2081 // start was recorded by RecordInlineFnStart.
2082 DenseMap<MDNode *, DbgScope *>::iterator
2083 I = DbgAbstractScopeMap.find(SP.getNode());
2084 if (I != DbgAbstractScopeMap.end()) {
2090 Scope = getOrCreateScope(Context);
2093 assert(Scope && "Unable to find the variable's scope");
2094 DbgVariable *DV = new DbgVariable(DIVariable(N), FrameIndex, InlinedFnVar);
2095 Scope->AddVariable(DV);
2097 if (TimePassesIsEnabled)
2098 DebugTimer->stopTimer();
2101 //// RecordInlinedFnStart - Indicate the start of inlined subroutine.
2102 unsigned DwarfDebug::RecordInlinedFnStart(DISubprogram &SP, DICompileUnit CU,
2103 unsigned Line, unsigned Col) {
2104 unsigned LabelID = MMI->NextLabelID();
2106 if (!MAI->doesDwarfUsesInlineInfoSection())
2109 if (TimePassesIsEnabled)
2110 DebugTimer->startTimer();
2112 MDNode *Node = SP.getNode();
2113 DenseMap<const MDNode *, DbgScope *>::iterator
2114 II = AbstractInstanceRootMap.find(Node);
2116 if (II == AbstractInstanceRootMap.end()) {
2117 // Create an abstract instance entry for this inlined function if it doesn't
2119 DbgScope *Scope = new DbgScope(NULL, DIDescriptor(Node));
2121 // Get the compile unit context.
2122 DIE *SPDie = ModuleCU->getDieMapSlotFor(Node);
2124 SPDie = CreateSubprogramDIE(ModuleCU, SP, false, true);
2126 // Mark as being inlined. This makes this subprogram entry an abstract
2128 // FIXME: Our debugger doesn't care about the value of DW_AT_inline, only
2129 // that it's defined. That probably won't change in the future. However,
2130 // this could be more elegant.
2131 AddUInt(SPDie, dwarf::DW_AT_inline, 0, dwarf::DW_INL_declared_not_inlined);
2133 // Keep track of the abstract scope for this function.
2134 DbgAbstractScopeMap[Node] = Scope;
2136 AbstractInstanceRootMap[Node] = Scope;
2137 AbstractInstanceRootList.push_back(Scope);
2140 // Create a concrete inlined instance for this inlined function.
2141 DbgConcreteScope *ConcreteScope = new DbgConcreteScope(DIDescriptor(Node));
2142 DIE *ScopeDie = new DIE(dwarf::DW_TAG_inlined_subroutine);
2143 ScopeDie->setAbstractCompileUnit(ModuleCU);
2145 DIE *Origin = ModuleCU->getDieMapSlotFor(Node);
2146 AddDIEEntry(ScopeDie, dwarf::DW_AT_abstract_origin,
2147 dwarf::DW_FORM_ref4, Origin);
2148 AddUInt(ScopeDie, dwarf::DW_AT_call_file, 0, ModuleCU->getID());
2149 AddUInt(ScopeDie, dwarf::DW_AT_call_line, 0, Line);
2150 AddUInt(ScopeDie, dwarf::DW_AT_call_column, 0, Col);
2152 ConcreteScope->setDie(ScopeDie);
2153 ConcreteScope->setStartLabelID(LabelID);
2154 MMI->RecordUsedDbgLabel(LabelID);
2156 LexicalScopeStack.back()->AddConcreteInst(ConcreteScope);
2158 // Keep track of the concrete scope that's inlined into this function.
2159 DenseMap<MDNode *, SmallVector<DbgScope *, 8> >::iterator
2160 SI = DbgConcreteScopeMap.find(Node);
2162 if (SI == DbgConcreteScopeMap.end())
2163 DbgConcreteScopeMap[Node].push_back(ConcreteScope);
2165 SI->second.push_back(ConcreteScope);
2167 // Track the start label for this inlined function.
2168 DenseMap<MDNode *, SmallVector<unsigned, 4> >::iterator
2169 I = InlineInfo.find(Node);
2171 if (I == InlineInfo.end())
2172 InlineInfo[Node].push_back(LabelID);
2174 I->second.push_back(LabelID);
2176 if (TimePassesIsEnabled)
2177 DebugTimer->stopTimer();
2182 /// RecordInlinedFnEnd - Indicate the end of inlined subroutine.
2183 unsigned DwarfDebug::RecordInlinedFnEnd(DISubprogram &SP) {
2184 if (!MAI->doesDwarfUsesInlineInfoSection())
2187 if (TimePassesIsEnabled)
2188 DebugTimer->startTimer();
2190 MDNode *Node = SP.getNode();
2191 DenseMap<MDNode *, SmallVector<DbgScope *, 8> >::iterator
2192 I = DbgConcreteScopeMap.find(Node);
2194 if (I == DbgConcreteScopeMap.end()) {
2195 // FIXME: Can this situation actually happen? And if so, should it?
2196 if (TimePassesIsEnabled)
2197 DebugTimer->stopTimer();
2202 SmallVector<DbgScope *, 8> &Scopes = I->second;
2203 if (Scopes.empty()) {
2204 // Returned ID is 0 if this is unbalanced "end of inlined
2205 // scope". This could happen if optimizer eats dbg intrinsics
2206 // or "beginning of inlined scope" is not recoginized due to
2207 // missing location info. In such cases, ignore this region.end.
2211 DbgScope *Scope = Scopes.back(); Scopes.pop_back();
2212 unsigned ID = MMI->NextLabelID();
2213 MMI->RecordUsedDbgLabel(ID);
2214 Scope->setEndLabelID(ID);
2216 if (TimePassesIsEnabled)
2217 DebugTimer->stopTimer();
2222 //===----------------------------------------------------------------------===//
2224 //===----------------------------------------------------------------------===//
2226 /// SizeAndOffsetDie - Compute the size and offset of a DIE.
2228 unsigned DwarfDebug::SizeAndOffsetDie(DIE *Die, unsigned Offset, bool Last) {
2229 // Get the children.
2230 const std::vector<DIE *> &Children = Die->getChildren();
2232 // If not last sibling and has children then add sibling offset attribute.
2233 if (!Last && !Children.empty()) Die->AddSiblingOffset();
2235 // Record the abbreviation.
2236 AssignAbbrevNumber(Die->getAbbrev());
2238 // Get the abbreviation for this DIE.
2239 unsigned AbbrevNumber = Die->getAbbrevNumber();
2240 const DIEAbbrev *Abbrev = Abbreviations[AbbrevNumber - 1];
2243 Die->setOffset(Offset);
2245 // Start the size with the size of abbreviation code.
2246 Offset += MCAsmInfo::getULEB128Size(AbbrevNumber);
2248 const SmallVector<DIEValue*, 32> &Values = Die->getValues();
2249 const SmallVector<DIEAbbrevData, 8> &AbbrevData = Abbrev->getData();
2251 // Size the DIE attribute values.
2252 for (unsigned i = 0, N = Values.size(); i < N; ++i)
2253 // Size attribute value.
2254 Offset += Values[i]->SizeOf(TD, AbbrevData[i].getForm());
2256 // Size the DIE children if any.
2257 if (!Children.empty()) {
2258 assert(Abbrev->getChildrenFlag() == dwarf::DW_CHILDREN_yes &&
2259 "Children flag not set");
2261 for (unsigned j = 0, M = Children.size(); j < M; ++j)
2262 Offset = SizeAndOffsetDie(Children[j], Offset, (j + 1) == M);
2264 // End of children marker.
2265 Offset += sizeof(int8_t);
2268 Die->setSize(Offset - Die->getOffset());
2272 /// SizeAndOffsets - Compute the size and offset of all the DIEs.
2274 void DwarfDebug::SizeAndOffsets() {
2275 // Compute size of compile unit header.
2276 static unsigned Offset =
2277 sizeof(int32_t) + // Length of Compilation Unit Info
2278 sizeof(int16_t) + // DWARF version number
2279 sizeof(int32_t) + // Offset Into Abbrev. Section
2280 sizeof(int8_t); // Pointer Size (in bytes)
2282 SizeAndOffsetDie(ModuleCU->getDie(), Offset, true);
2283 CompileUnitOffsets[ModuleCU] = 0;
2286 /// EmitInitial - Emit initial Dwarf declarations. This is necessary for cc
2287 /// tools to recognize the object file contains Dwarf information.
2288 void DwarfDebug::EmitInitial() {
2289 // Check to see if we already emitted intial headers.
2290 if (didInitial) return;
2293 const TargetLoweringObjectFile &TLOF = Asm->getObjFileLowering();
2295 // Dwarf sections base addresses.
2296 if (MAI->doesDwarfRequireFrameSection()) {
2297 Asm->OutStreamer.SwitchSection(TLOF.getDwarfFrameSection());
2298 EmitLabel("section_debug_frame", 0);
2301 Asm->OutStreamer.SwitchSection(TLOF.getDwarfInfoSection());
2302 EmitLabel("section_info", 0);
2303 Asm->OutStreamer.SwitchSection(TLOF.getDwarfAbbrevSection());
2304 EmitLabel("section_abbrev", 0);
2305 Asm->OutStreamer.SwitchSection(TLOF.getDwarfARangesSection());
2306 EmitLabel("section_aranges", 0);
2308 if (const MCSection *LineInfoDirective = TLOF.getDwarfMacroInfoSection()) {
2309 Asm->OutStreamer.SwitchSection(LineInfoDirective);
2310 EmitLabel("section_macinfo", 0);
2313 Asm->OutStreamer.SwitchSection(TLOF.getDwarfLineSection());
2314 EmitLabel("section_line", 0);
2315 Asm->OutStreamer.SwitchSection(TLOF.getDwarfLocSection());
2316 EmitLabel("section_loc", 0);
2317 Asm->OutStreamer.SwitchSection(TLOF.getDwarfPubNamesSection());
2318 EmitLabel("section_pubnames", 0);
2319 Asm->OutStreamer.SwitchSection(TLOF.getDwarfStrSection());
2320 EmitLabel("section_str", 0);
2321 Asm->OutStreamer.SwitchSection(TLOF.getDwarfRangesSection());
2322 EmitLabel("section_ranges", 0);
2324 Asm->OutStreamer.SwitchSection(TLOF.getTextSection());
2325 EmitLabel("text_begin", 0);
2326 Asm->OutStreamer.SwitchSection(TLOF.getDataSection());
2327 EmitLabel("data_begin", 0);
2330 /// EmitDIE - Recusively Emits a debug information entry.
2332 void DwarfDebug::EmitDIE(DIE *Die) {
2333 // Get the abbreviation for this DIE.
2334 unsigned AbbrevNumber = Die->getAbbrevNumber();
2335 const DIEAbbrev *Abbrev = Abbreviations[AbbrevNumber - 1];
2339 // Emit the code (index) for the abbreviation.
2340 Asm->EmitULEB128Bytes(AbbrevNumber);
2342 if (Asm->isVerbose())
2343 Asm->EOL(std::string("Abbrev [" +
2344 utostr(AbbrevNumber) +
2345 "] 0x" + utohexstr(Die->getOffset()) +
2346 ":0x" + utohexstr(Die->getSize()) + " " +
2347 dwarf::TagString(Abbrev->getTag())));
2351 SmallVector<DIEValue*, 32> &Values = Die->getValues();
2352 const SmallVector<DIEAbbrevData, 8> &AbbrevData = Abbrev->getData();
2354 // Emit the DIE attribute values.
2355 for (unsigned i = 0, N = Values.size(); i < N; ++i) {
2356 unsigned Attr = AbbrevData[i].getAttribute();
2357 unsigned Form = AbbrevData[i].getForm();
2358 assert(Form && "Too many attributes for DIE (check abbreviation)");
2361 case dwarf::DW_AT_sibling:
2362 Asm->EmitInt32(Die->SiblingOffset());
2364 case dwarf::DW_AT_abstract_origin: {
2365 DIEEntry *E = cast<DIEEntry>(Values[i]);
2366 DIE *Origin = E->getEntry();
2368 CompileUnitOffsets[Die->getAbstractCompileUnit()] +
2369 Origin->getOffset();
2371 Asm->EmitInt32(Addr);
2375 // Emit an attribute using the defined form.
2376 Values[i]->EmitValue(this, Form);
2380 Asm->EOL(dwarf::AttributeString(Attr));
2383 // Emit the DIE children if any.
2384 if (Abbrev->getChildrenFlag() == dwarf::DW_CHILDREN_yes) {
2385 const std::vector<DIE *> &Children = Die->getChildren();
2387 for (unsigned j = 0, M = Children.size(); j < M; ++j)
2388 EmitDIE(Children[j]);
2390 Asm->EmitInt8(0); Asm->EOL("End Of Children Mark");
2394 /// EmitDebugInfo / EmitDebugInfoPerCU - Emit the debug info section.
2396 void DwarfDebug::EmitDebugInfoPerCU(CompileUnit *Unit) {
2397 DIE *Die = Unit->getDie();
2399 // Emit the compile units header.
2400 EmitLabel("info_begin", Unit->getID());
2402 // Emit size of content not including length itself
2403 unsigned ContentSize = Die->getSize() +
2404 sizeof(int16_t) + // DWARF version number
2405 sizeof(int32_t) + // Offset Into Abbrev. Section
2406 sizeof(int8_t) + // Pointer Size (in bytes)
2407 sizeof(int32_t); // FIXME - extra pad for gdb bug.
2409 Asm->EmitInt32(ContentSize); Asm->EOL("Length of Compilation Unit Info");
2410 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF version number");
2411 EmitSectionOffset("abbrev_begin", "section_abbrev", 0, 0, true, false);
2412 Asm->EOL("Offset Into Abbrev. Section");
2413 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Address Size (in bytes)");
2416 // FIXME - extra padding for gdb bug.
2417 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2418 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2419 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2420 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2421 EmitLabel("info_end", Unit->getID());
2426 void DwarfDebug::EmitDebugInfo() {
2427 // Start debug info section.
2428 Asm->OutStreamer.SwitchSection(
2429 Asm->getObjFileLowering().getDwarfInfoSection());
2431 EmitDebugInfoPerCU(ModuleCU);
2434 /// EmitAbbreviations - Emit the abbreviation section.
2436 void DwarfDebug::EmitAbbreviations() const {
2437 // Check to see if it is worth the effort.
2438 if (!Abbreviations.empty()) {
2439 // Start the debug abbrev section.
2440 Asm->OutStreamer.SwitchSection(
2441 Asm->getObjFileLowering().getDwarfAbbrevSection());
2443 EmitLabel("abbrev_begin", 0);
2445 // For each abbrevation.
2446 for (unsigned i = 0, N = Abbreviations.size(); i < N; ++i) {
2447 // Get abbreviation data
2448 const DIEAbbrev *Abbrev = Abbreviations[i];
2450 // Emit the abbrevations code (base 1 index.)
2451 Asm->EmitULEB128Bytes(Abbrev->getNumber());
2452 Asm->EOL("Abbreviation Code");
2454 // Emit the abbreviations data.
2460 // Mark end of abbreviations.
2461 Asm->EmitULEB128Bytes(0); Asm->EOL("EOM(3)");
2463 EmitLabel("abbrev_end", 0);
2468 /// EmitEndOfLineMatrix - Emit the last address of the section and the end of
2469 /// the line matrix.
2471 void DwarfDebug::EmitEndOfLineMatrix(unsigned SectionEnd) {
2472 // Define last address of section.
2473 Asm->EmitInt8(0); Asm->EOL("Extended Op");
2474 Asm->EmitInt8(TD->getPointerSize() + 1); Asm->EOL("Op size");
2475 Asm->EmitInt8(dwarf::DW_LNE_set_address); Asm->EOL("DW_LNE_set_address");
2476 EmitReference("section_end", SectionEnd); Asm->EOL("Section end label");
2478 // Mark end of matrix.
2479 Asm->EmitInt8(0); Asm->EOL("DW_LNE_end_sequence");
2480 Asm->EmitULEB128Bytes(1); Asm->EOL();
2481 Asm->EmitInt8(1); Asm->EOL();
2484 /// EmitDebugLines - Emit source line information.
2486 void DwarfDebug::EmitDebugLines() {
2487 // If the target is using .loc/.file, the assembler will be emitting the
2488 // .debug_line table automatically.
2489 if (MAI->hasDotLocAndDotFile())
2492 // Minimum line delta, thus ranging from -10..(255-10).
2493 const int MinLineDelta = -(dwarf::DW_LNS_fixed_advance_pc + 1);
2494 // Maximum line delta, thus ranging from -10..(255-10).
2495 const int MaxLineDelta = 255 + MinLineDelta;
2497 // Start the dwarf line section.
2498 Asm->OutStreamer.SwitchSection(
2499 Asm->getObjFileLowering().getDwarfLineSection());
2501 // Construct the section header.
2502 EmitDifference("line_end", 0, "line_begin", 0, true);
2503 Asm->EOL("Length of Source Line Info");
2504 EmitLabel("line_begin", 0);
2506 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF version number");
2508 EmitDifference("line_prolog_end", 0, "line_prolog_begin", 0, true);
2509 Asm->EOL("Prolog Length");
2510 EmitLabel("line_prolog_begin", 0);
2512 Asm->EmitInt8(1); Asm->EOL("Minimum Instruction Length");
2514 Asm->EmitInt8(1); Asm->EOL("Default is_stmt_start flag");
2516 Asm->EmitInt8(MinLineDelta); Asm->EOL("Line Base Value (Special Opcodes)");
2518 Asm->EmitInt8(MaxLineDelta); Asm->EOL("Line Range Value (Special Opcodes)");
2520 Asm->EmitInt8(-MinLineDelta); Asm->EOL("Special Opcode Base");
2522 // Line number standard opcode encodings argument count
2523 Asm->EmitInt8(0); Asm->EOL("DW_LNS_copy arg count");
2524 Asm->EmitInt8(1); Asm->EOL("DW_LNS_advance_pc arg count");
2525 Asm->EmitInt8(1); Asm->EOL("DW_LNS_advance_line arg count");
2526 Asm->EmitInt8(1); Asm->EOL("DW_LNS_set_file arg count");
2527 Asm->EmitInt8(1); Asm->EOL("DW_LNS_set_column arg count");
2528 Asm->EmitInt8(0); Asm->EOL("DW_LNS_negate_stmt arg count");
2529 Asm->EmitInt8(0); Asm->EOL("DW_LNS_set_basic_block arg count");
2530 Asm->EmitInt8(0); Asm->EOL("DW_LNS_const_add_pc arg count");
2531 Asm->EmitInt8(1); Asm->EOL("DW_LNS_fixed_advance_pc arg count");
2533 // Emit directories.
2534 for (unsigned DI = 1, DE = getNumSourceDirectories()+1; DI != DE; ++DI) {
2535 Asm->EmitString(getSourceDirectoryName(DI));
2536 Asm->EOL("Directory");
2539 Asm->EmitInt8(0); Asm->EOL("End of directories");
2542 for (unsigned SI = 1, SE = getNumSourceIds()+1; SI != SE; ++SI) {
2543 // Remember source id starts at 1.
2544 std::pair<unsigned, unsigned> Id = getSourceDirectoryAndFileIds(SI);
2545 Asm->EmitString(getSourceFileName(Id.second));
2547 Asm->EmitULEB128Bytes(Id.first);
2548 Asm->EOL("Directory #");
2549 Asm->EmitULEB128Bytes(0);
2550 Asm->EOL("Mod date");
2551 Asm->EmitULEB128Bytes(0);
2552 Asm->EOL("File size");
2555 Asm->EmitInt8(0); Asm->EOL("End of files");
2557 EmitLabel("line_prolog_end", 0);
2559 // A sequence for each text section.
2560 unsigned SecSrcLinesSize = SectionSourceLines.size();
2562 for (unsigned j = 0; j < SecSrcLinesSize; ++j) {
2563 // Isolate current sections line info.
2564 const std::vector<SrcLineInfo> &LineInfos = SectionSourceLines[j];
2566 /*if (Asm->isVerbose()) {
2567 const MCSection *S = SectionMap[j + 1];
2568 O << '\t' << MAI->getCommentString() << " Section"
2569 << S->getName() << '\n';
2573 // Dwarf assumes we start with first line of first source file.
2574 unsigned Source = 1;
2577 // Construct rows of the address, source, line, column matrix.
2578 for (unsigned i = 0, N = LineInfos.size(); i < N; ++i) {
2579 const SrcLineInfo &LineInfo = LineInfos[i];
2580 unsigned LabelID = MMI->MappedLabel(LineInfo.getLabelID());
2581 if (!LabelID) continue;
2583 if (LineInfo.getLine() == 0) continue;
2585 if (!Asm->isVerbose())
2588 std::pair<unsigned, unsigned> SourceID =
2589 getSourceDirectoryAndFileIds(LineInfo.getSourceID());
2590 O << '\t' << MAI->getCommentString() << ' '
2591 << getSourceDirectoryName(SourceID.first) << ' '
2592 << getSourceFileName(SourceID.second)
2593 <<" :" << utostr_32(LineInfo.getLine()) << '\n';
2596 // Define the line address.
2597 Asm->EmitInt8(0); Asm->EOL("Extended Op");
2598 Asm->EmitInt8(TD->getPointerSize() + 1); Asm->EOL("Op size");
2599 Asm->EmitInt8(dwarf::DW_LNE_set_address); Asm->EOL("DW_LNE_set_address");
2600 EmitReference("label", LabelID); Asm->EOL("Location label");
2602 // If change of source, then switch to the new source.
2603 if (Source != LineInfo.getSourceID()) {
2604 Source = LineInfo.getSourceID();
2605 Asm->EmitInt8(dwarf::DW_LNS_set_file); Asm->EOL("DW_LNS_set_file");
2606 Asm->EmitULEB128Bytes(Source); Asm->EOL("New Source");
2609 // If change of line.
2610 if (Line != LineInfo.getLine()) {
2611 // Determine offset.
2612 int Offset = LineInfo.getLine() - Line;
2613 int Delta = Offset - MinLineDelta;
2616 Line = LineInfo.getLine();
2618 // If delta is small enough and in range...
2619 if (Delta >= 0 && Delta < (MaxLineDelta - 1)) {
2620 // ... then use fast opcode.
2621 Asm->EmitInt8(Delta - MinLineDelta); Asm->EOL("Line Delta");
2623 // ... otherwise use long hand.
2624 Asm->EmitInt8(dwarf::DW_LNS_advance_line);
2625 Asm->EOL("DW_LNS_advance_line");
2626 Asm->EmitSLEB128Bytes(Offset); Asm->EOL("Line Offset");
2627 Asm->EmitInt8(dwarf::DW_LNS_copy); Asm->EOL("DW_LNS_copy");
2630 // Copy the previous row (different address or source)
2631 Asm->EmitInt8(dwarf::DW_LNS_copy); Asm->EOL("DW_LNS_copy");
2635 EmitEndOfLineMatrix(j + 1);
2638 if (SecSrcLinesSize == 0)
2639 // Because we're emitting a debug_line section, we still need a line
2640 // table. The linker and friends expect it to exist. If there's nothing to
2641 // put into it, emit an empty table.
2642 EmitEndOfLineMatrix(1);
2644 EmitLabel("line_end", 0);
2648 /// EmitCommonDebugFrame - Emit common frame info into a debug frame section.
2650 void DwarfDebug::EmitCommonDebugFrame() {
2651 if (!MAI->doesDwarfRequireFrameSection())
2655 Asm->TM.getFrameInfo()->getStackGrowthDirection() ==
2656 TargetFrameInfo::StackGrowsUp ?
2657 TD->getPointerSize() : -TD->getPointerSize();
2659 // Start the dwarf frame section.
2660 Asm->OutStreamer.SwitchSection(
2661 Asm->getObjFileLowering().getDwarfFrameSection());
2663 EmitLabel("debug_frame_common", 0);
2664 EmitDifference("debug_frame_common_end", 0,
2665 "debug_frame_common_begin", 0, true);
2666 Asm->EOL("Length of Common Information Entry");
2668 EmitLabel("debug_frame_common_begin", 0);
2669 Asm->EmitInt32((int)dwarf::DW_CIE_ID);
2670 Asm->EOL("CIE Identifier Tag");
2671 Asm->EmitInt8(dwarf::DW_CIE_VERSION);
2672 Asm->EOL("CIE Version");
2673 Asm->EmitString("");
2674 Asm->EOL("CIE Augmentation");
2675 Asm->EmitULEB128Bytes(1);
2676 Asm->EOL("CIE Code Alignment Factor");
2677 Asm->EmitSLEB128Bytes(stackGrowth);
2678 Asm->EOL("CIE Data Alignment Factor");
2679 Asm->EmitInt8(RI->getDwarfRegNum(RI->getRARegister(), false));
2680 Asm->EOL("CIE RA Column");
2682 std::vector<MachineMove> Moves;
2683 RI->getInitialFrameState(Moves);
2685 EmitFrameMoves(NULL, 0, Moves, false);
2687 Asm->EmitAlignment(2, 0, 0, false);
2688 EmitLabel("debug_frame_common_end", 0);
2693 /// EmitFunctionDebugFrame - Emit per function frame info into a debug frame
2696 DwarfDebug::EmitFunctionDebugFrame(const FunctionDebugFrameInfo&DebugFrameInfo){
2697 if (!MAI->doesDwarfRequireFrameSection())
2700 // Start the dwarf frame section.
2701 Asm->OutStreamer.SwitchSection(
2702 Asm->getObjFileLowering().getDwarfFrameSection());
2704 EmitDifference("debug_frame_end", DebugFrameInfo.Number,
2705 "debug_frame_begin", DebugFrameInfo.Number, true);
2706 Asm->EOL("Length of Frame Information Entry");
2708 EmitLabel("debug_frame_begin", DebugFrameInfo.Number);
2710 EmitSectionOffset("debug_frame_common", "section_debug_frame",
2712 Asm->EOL("FDE CIE offset");
2714 EmitReference("func_begin", DebugFrameInfo.Number);
2715 Asm->EOL("FDE initial location");
2716 EmitDifference("func_end", DebugFrameInfo.Number,
2717 "func_begin", DebugFrameInfo.Number);
2718 Asm->EOL("FDE address range");
2720 EmitFrameMoves("func_begin", DebugFrameInfo.Number, DebugFrameInfo.Moves,
2723 Asm->EmitAlignment(2, 0, 0, false);
2724 EmitLabel("debug_frame_end", DebugFrameInfo.Number);
2729 void DwarfDebug::EmitDebugPubNamesPerCU(CompileUnit *Unit) {
2730 EmitDifference("pubnames_end", Unit->getID(),
2731 "pubnames_begin", Unit->getID(), true);
2732 Asm->EOL("Length of Public Names Info");
2734 EmitLabel("pubnames_begin", Unit->getID());
2736 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF Version");
2738 EmitSectionOffset("info_begin", "section_info",
2739 Unit->getID(), 0, true, false);
2740 Asm->EOL("Offset of Compilation Unit Info");
2742 EmitDifference("info_end", Unit->getID(), "info_begin", Unit->getID(),
2744 Asm->EOL("Compilation Unit Length");
2746 StringMap<DIE*> &Globals = Unit->getGlobals();
2747 for (StringMap<DIE*>::const_iterator
2748 GI = Globals.begin(), GE = Globals.end(); GI != GE; ++GI) {
2749 const char *Name = GI->getKeyData();
2750 DIE * Entity = GI->second;
2752 Asm->EmitInt32(Entity->getOffset()); Asm->EOL("DIE offset");
2753 Asm->EmitString(Name, strlen(Name)); Asm->EOL("External Name");
2756 Asm->EmitInt32(0); Asm->EOL("End Mark");
2757 EmitLabel("pubnames_end", Unit->getID());
2762 /// EmitDebugPubNames - Emit visible names into a debug pubnames section.
2764 void DwarfDebug::EmitDebugPubNames() {
2765 // Start the dwarf pubnames section.
2766 Asm->OutStreamer.SwitchSection(
2767 Asm->getObjFileLowering().getDwarfPubNamesSection());
2769 EmitDebugPubNamesPerCU(ModuleCU);
2772 /// EmitDebugStr - Emit visible names into a debug str section.
2774 void DwarfDebug::EmitDebugStr() {
2775 // Check to see if it is worth the effort.
2776 if (!StringPool.empty()) {
2777 // Start the dwarf str section.
2778 Asm->OutStreamer.SwitchSection(
2779 Asm->getObjFileLowering().getDwarfStrSection());
2781 // For each of strings in the string pool.
2782 for (unsigned StringID = 1, N = StringPool.size();
2783 StringID <= N; ++StringID) {
2784 // Emit a label for reference from debug information entries.
2785 EmitLabel("string", StringID);
2787 // Emit the string itself.
2788 const std::string &String = StringPool[StringID];
2789 Asm->EmitString(String); Asm->EOL();
2796 /// EmitDebugLoc - Emit visible names into a debug loc section.
2798 void DwarfDebug::EmitDebugLoc() {
2799 // Start the dwarf loc section.
2800 Asm->OutStreamer.SwitchSection(
2801 Asm->getObjFileLowering().getDwarfLocSection());
2805 /// EmitDebugARanges - Emit visible names into a debug aranges section.
2807 void DwarfDebug::EmitDebugARanges() {
2808 // Start the dwarf aranges section.
2809 Asm->OutStreamer.SwitchSection(
2810 Asm->getObjFileLowering().getDwarfARangesSection());
2814 CompileUnit *Unit = GetBaseCompileUnit();
2816 // Don't include size of length
2817 Asm->EmitInt32(0x1c); Asm->EOL("Length of Address Ranges Info");
2819 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("Dwarf Version");
2821 EmitReference("info_begin", Unit->getID());
2822 Asm->EOL("Offset of Compilation Unit Info");
2824 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Size of Address");
2826 Asm->EmitInt8(0); Asm->EOL("Size of Segment Descriptor");
2828 Asm->EmitInt16(0); Asm->EOL("Pad (1)");
2829 Asm->EmitInt16(0); Asm->EOL("Pad (2)");
2832 EmitReference("text_begin", 0); Asm->EOL("Address");
2833 EmitDifference("text_end", 0, "text_begin", 0, true); Asm->EOL("Length");
2835 Asm->EmitInt32(0); Asm->EOL("EOM (1)");
2836 Asm->EmitInt32(0); Asm->EOL("EOM (2)");
2842 /// EmitDebugRanges - Emit visible names into a debug ranges section.
2844 void DwarfDebug::EmitDebugRanges() {
2845 // Start the dwarf ranges section.
2846 Asm->OutStreamer.SwitchSection(
2847 Asm->getObjFileLowering().getDwarfRangesSection());
2851 /// EmitDebugMacInfo - Emit visible names into a debug macinfo section.
2853 void DwarfDebug::EmitDebugMacInfo() {
2854 if (const MCSection *LineInfo =
2855 Asm->getObjFileLowering().getDwarfMacroInfoSection()) {
2856 // Start the dwarf macinfo section.
2857 Asm->OutStreamer.SwitchSection(LineInfo);
2862 /// EmitDebugInlineInfo - Emit inline info using following format.
2864 /// 1. length of section
2865 /// 2. Dwarf version number
2866 /// 3. address size.
2868 /// Entries (one "entry" for each function that was inlined):
2870 /// 1. offset into __debug_str section for MIPS linkage name, if exists;
2871 /// otherwise offset into __debug_str for regular function name.
2872 /// 2. offset into __debug_str section for regular function name.
2873 /// 3. an unsigned LEB128 number indicating the number of distinct inlining
2874 /// instances for the function.
2876 /// The rest of the entry consists of a {die_offset, low_pc} pair for each
2877 /// inlined instance; the die_offset points to the inlined_subroutine die in the
2878 /// __debug_info section, and the low_pc is the starting address for the
2879 /// inlining instance.
2880 void DwarfDebug::EmitDebugInlineInfo() {
2881 if (!MAI->doesDwarfUsesInlineInfoSection())
2887 Asm->OutStreamer.SwitchSection(
2888 Asm->getObjFileLowering().getDwarfDebugInlineSection());
2890 EmitDifference("debug_inlined_end", 1,
2891 "debug_inlined_begin", 1, true);
2892 Asm->EOL("Length of Debug Inlined Information Entry");
2894 EmitLabel("debug_inlined_begin", 1);
2896 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("Dwarf Version");
2897 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Address Size (in bytes)");
2899 for (DenseMap<MDNode *, SmallVector<unsigned, 4> >::iterator
2900 I = InlineInfo.begin(), E = InlineInfo.end(); I != E; ++I) {
2901 MDNode *Node = I->first;
2902 SmallVector<unsigned, 4> &Labels = I->second;
2903 DISubprogram SP(Node);
2904 const char *LName = SP.getLinkageName();
2905 const char *Name = SP.getName();
2908 Asm->EmitString(Name);
2910 // Skip special LLVM prefix that is used to inform the asm printer to not
2911 // emit usual symbol prefix before the symbol name. This happens for
2912 // Objective-C symbol names and symbol whose name is replaced using GCC's
2913 // __asm__ attribute.
2916 Asm->EmitString(LName);
2918 Asm->EOL("MIPS linkage name");
2920 Asm->EmitString(Name); Asm->EOL("Function name");
2922 Asm->EmitULEB128Bytes(Labels.size()); Asm->EOL("Inline count");
2924 for (SmallVector<unsigned, 4>::iterator LI = Labels.begin(),
2925 LE = Labels.end(); LI != LE; ++LI) {
2926 DIE *SP = ModuleCU->getDieMapSlotFor(Node);
2927 Asm->EmitInt32(SP->getOffset()); Asm->EOL("DIE offset");
2929 if (TD->getPointerSize() == sizeof(int32_t))
2930 O << MAI->getData32bitsDirective();
2932 O << MAI->getData64bitsDirective();
2934 PrintLabelName("label", *LI); Asm->EOL("low_pc");
2938 EmitLabel("debug_inlined_end", 1);