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 if (!FunctionDbgScope)
1326 FunctionDbgScope = Slot;
1332 /// getOrCreateScope - Returns the scope associated with the given descriptor.
1333 /// FIXME - Remove this method.
1334 DbgScope *DwarfDebug::getOrCreateScope(MDNode *N) {
1335 DbgScope *&Slot = DbgScopeMap[N];
1336 if (Slot) return Slot;
1338 DbgScope *Parent = NULL;
1339 DILexicalBlock Block(N);
1341 // Don't create a new scope if we already created one for an inlined function.
1342 DenseMap<const MDNode *, DbgScope *>::iterator
1343 II = AbstractInstanceRootMap.find(N);
1344 if (II != AbstractInstanceRootMap.end())
1345 return LexicalScopeStack.back();
1347 if (!Block.isNull()) {
1348 DIDescriptor ParentDesc = Block.getContext();
1350 ParentDesc.isNull() ? NULL : getOrCreateScope(ParentDesc.getNode());
1353 Slot = new DbgScope(Parent, DIDescriptor(N));
1356 Parent->AddScope(Slot);
1358 // First function is top level function.
1359 FunctionDbgScope = Slot;
1364 /// ConstructDbgScope - Construct the components of a scope.
1366 void DwarfDebug::ConstructDbgScope(DbgScope *ParentScope,
1367 unsigned ParentStartID,
1368 unsigned ParentEndID,
1369 DIE *ParentDie, CompileUnit *Unit) {
1370 // Add variables to scope.
1371 SmallVector<DbgVariable *, 8> &Variables = ParentScope->getVariables();
1372 for (unsigned i = 0, N = Variables.size(); i < N; ++i) {
1373 DIE *VariableDie = CreateDbgScopeVariable(Variables[i], Unit);
1374 if (VariableDie) ParentDie->AddChild(VariableDie);
1377 // Add concrete instances to scope.
1378 SmallVector<DbgConcreteScope *, 8> &ConcreteInsts =
1379 ParentScope->getConcreteInsts();
1380 for (unsigned i = 0, N = ConcreteInsts.size(); i < N; ++i) {
1381 DbgConcreteScope *ConcreteInst = ConcreteInsts[i];
1382 DIE *Die = ConcreteInst->getDie();
1384 unsigned StartID = ConcreteInst->getStartLabelID();
1385 unsigned EndID = ConcreteInst->getEndLabelID();
1387 // Add the scope bounds.
1389 AddLabel(Die, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1390 DWLabel("label", StartID));
1392 AddLabel(Die, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1393 DWLabel("func_begin", SubprogramCount));
1396 AddLabel(Die, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1397 DWLabel("label", EndID));
1399 AddLabel(Die, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1400 DWLabel("func_end", SubprogramCount));
1402 ParentDie->AddChild(Die);
1405 // Add nested scopes.
1406 SmallVector<DbgScope *, 4> &Scopes = ParentScope->getScopes();
1407 for (unsigned j = 0, M = Scopes.size(); j < M; ++j) {
1408 // Define the Scope debug information entry.
1409 DbgScope *Scope = Scopes[j];
1411 unsigned StartID = MMI->MappedLabel(Scope->getStartLabelID());
1412 unsigned EndID = MMI->MappedLabel(Scope->getEndLabelID());
1414 // Ignore empty scopes.
1415 if (StartID == EndID && StartID != 0) continue;
1417 // Do not ignore inlined scopes even if they don't have any variables or
1419 if (Scope->getScopes().empty() && Scope->getVariables().empty() &&
1420 Scope->getConcreteInsts().empty())
1423 if (StartID == ParentStartID && EndID == ParentEndID) {
1424 // Just add stuff to the parent scope.
1425 ConstructDbgScope(Scope, ParentStartID, ParentEndID, ParentDie, Unit);
1427 DIE *ScopeDie = new DIE(dwarf::DW_TAG_lexical_block);
1429 // Add the scope bounds.
1431 AddLabel(ScopeDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1432 DWLabel("label", StartID));
1434 AddLabel(ScopeDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1435 DWLabel("func_begin", SubprogramCount));
1438 AddLabel(ScopeDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1439 DWLabel("label", EndID));
1441 AddLabel(ScopeDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1442 DWLabel("func_end", SubprogramCount));
1444 // Add the scope's contents.
1445 ConstructDbgScope(Scope, StartID, EndID, ScopeDie, Unit);
1446 ParentDie->AddChild(ScopeDie);
1451 /// ConstructFunctionDbgScope - Construct the scope for the subprogram.
1453 void DwarfDebug::ConstructFunctionDbgScope(DbgScope *RootScope,
1454 bool AbstractScope) {
1455 // Exit if there is no root scope.
1456 if (!RootScope) return;
1457 DIDescriptor Desc = RootScope->getDesc();
1461 // Get the subprogram debug information entry.
1462 DISubprogram SPD(Desc.getNode());
1464 // Get the subprogram die.
1465 DIE *SPDie = ModuleCU->getDieMapSlotFor(SPD.getNode());
1467 ConstructSubprogram(SPD.getNode());
1468 SPDie = ModuleCU->getDieMapSlotFor(SPD.getNode());
1470 assert(SPDie && "Missing subprogram descriptor");
1472 if (!AbstractScope) {
1473 // Add the function bounds.
1474 AddLabel(SPDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1475 DWLabel("func_begin", SubprogramCount));
1476 AddLabel(SPDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1477 DWLabel("func_end", SubprogramCount));
1478 MachineLocation Location(RI->getFrameRegister(*MF));
1479 AddAddress(SPDie, dwarf::DW_AT_frame_base, Location);
1482 ConstructDbgScope(RootScope, 0, 0, SPDie, ModuleCU);
1483 // If there are global variables at this scope then add their dies.
1484 for (SmallVector<WeakVH, 4>::iterator SGI = ScopedGVs.begin(),
1485 SGE = ScopedGVs.end(); SGI != SGE; ++SGI) {
1486 MDNode *N = dyn_cast_or_null<MDNode>(*SGI);
1488 DIGlobalVariable GV(N);
1489 if (GV.getContext().getNode() == RootScope->getDesc().getNode()) {
1490 DIE *ScopedGVDie = CreateGlobalVariableDIE(ModuleCU, GV);
1491 SPDie->AddChild(ScopedGVDie);
1496 /// ConstructDefaultDbgScope - Construct a default scope for the subprogram.
1498 void DwarfDebug::ConstructDefaultDbgScope(MachineFunction *MF) {
1499 StringMap<DIE*> &Globals = ModuleCU->getGlobals();
1500 StringMap<DIE*>::iterator GI = Globals.find(MF->getFunction()->getName());
1501 if (GI != Globals.end()) {
1502 DIE *SPDie = GI->second;
1504 // Add the function bounds.
1505 AddLabel(SPDie, dwarf::DW_AT_low_pc, dwarf::DW_FORM_addr,
1506 DWLabel("func_begin", SubprogramCount));
1507 AddLabel(SPDie, dwarf::DW_AT_high_pc, dwarf::DW_FORM_addr,
1508 DWLabel("func_end", SubprogramCount));
1510 MachineLocation Location(RI->getFrameRegister(*MF));
1511 AddAddress(SPDie, dwarf::DW_AT_frame_base, Location);
1515 /// GetOrCreateSourceID - Look up the source id with the given directory and
1516 /// source file names. If none currently exists, create a new id and insert it
1517 /// in the SourceIds map. This can update DirectoryNames and SourceFileNames
1519 unsigned DwarfDebug::GetOrCreateSourceID(const char *DirName,
1520 const char *FileName) {
1522 StringMap<unsigned>::iterator DI = DirectoryIdMap.find(DirName);
1523 if (DI != DirectoryIdMap.end()) {
1524 DId = DI->getValue();
1526 DId = DirectoryNames.size() + 1;
1527 DirectoryIdMap[DirName] = DId;
1528 DirectoryNames.push_back(DirName);
1532 StringMap<unsigned>::iterator FI = SourceFileIdMap.find(FileName);
1533 if (FI != SourceFileIdMap.end()) {
1534 FId = FI->getValue();
1536 FId = SourceFileNames.size() + 1;
1537 SourceFileIdMap[FileName] = FId;
1538 SourceFileNames.push_back(FileName);
1541 DenseMap<std::pair<unsigned, unsigned>, unsigned>::iterator SI =
1542 SourceIdMap.find(std::make_pair(DId, FId));
1543 if (SI != SourceIdMap.end())
1546 unsigned SrcId = SourceIds.size() + 1; // DW_AT_decl_file cannot be 0.
1547 SourceIdMap[std::make_pair(DId, FId)] = SrcId;
1548 SourceIds.push_back(std::make_pair(DId, FId));
1553 void DwarfDebug::ConstructCompileUnit(MDNode *N) {
1554 DICompileUnit DIUnit(N);
1555 const char *FN = DIUnit.getFilename();
1556 const char *Dir = DIUnit.getDirectory();
1557 unsigned ID = GetOrCreateSourceID(Dir, FN);
1559 DIE *Die = new DIE(dwarf::DW_TAG_compile_unit);
1560 AddSectionOffset(Die, dwarf::DW_AT_stmt_list, dwarf::DW_FORM_data4,
1561 DWLabel("section_line", 0), DWLabel("section_line", 0),
1563 AddString(Die, dwarf::DW_AT_producer, dwarf::DW_FORM_string,
1564 DIUnit.getProducer());
1565 AddUInt(Die, dwarf::DW_AT_language, dwarf::DW_FORM_data1,
1566 DIUnit.getLanguage());
1567 AddString(Die, dwarf::DW_AT_name, dwarf::DW_FORM_string, FN);
1570 AddString(Die, dwarf::DW_AT_comp_dir, dwarf::DW_FORM_string, Dir);
1571 if (DIUnit.isOptimized())
1572 AddUInt(Die, dwarf::DW_AT_APPLE_optimized, dwarf::DW_FORM_flag, 1);
1574 if (const char *Flags = DIUnit.getFlags())
1575 AddString(Die, dwarf::DW_AT_APPLE_flags, dwarf::DW_FORM_string, Flags);
1577 unsigned RVer = DIUnit.getRunTimeVersion();
1579 AddUInt(Die, dwarf::DW_AT_APPLE_major_runtime_vers,
1580 dwarf::DW_FORM_data1, RVer);
1582 CompileUnit *Unit = new CompileUnit(ID, Die);
1583 if (!ModuleCU && DIUnit.isMain()) {
1584 // Use first compile unit marked as isMain as the compile unit
1589 CompileUnitMap[DIUnit.getNode()] = Unit;
1590 CompileUnits.push_back(Unit);
1593 void DwarfDebug::ConstructGlobalVariableDIE(MDNode *N) {
1594 DIGlobalVariable DI_GV(N);
1596 // If debug information is malformed then ignore it.
1597 if (DI_GV.Verify() == false)
1600 // Check for pre-existence.
1601 DIE *&Slot = ModuleCU->getDieMapSlotFor(DI_GV.getNode());
1605 DIE *VariableDie = CreateGlobalVariableDIE(ModuleCU, DI_GV);
1610 // Add to context owner.
1611 ModuleCU->getDie()->AddChild(VariableDie);
1613 // Expose as global. FIXME - need to check external flag.
1614 ModuleCU->AddGlobal(DI_GV.getName(), VariableDie);
1618 void DwarfDebug::ConstructSubprogram(MDNode *N) {
1621 // Check for pre-existence.
1622 DIE *&Slot = ModuleCU->getDieMapSlotFor(N);
1626 if (!SP.isDefinition())
1627 // This is a method declaration which will be handled while constructing
1631 DIE *SubprogramDie = CreateSubprogramDIE(ModuleCU, SP);
1634 Slot = SubprogramDie;
1636 // Add to context owner.
1637 ModuleCU->getDie()->AddChild(SubprogramDie);
1639 // Expose as global.
1640 ModuleCU->AddGlobal(SP.getName(), SubprogramDie);
1644 /// BeginModule - Emit all Dwarf sections that should come prior to the
1645 /// content. Create global DIEs and emit initial debug info sections.
1646 /// This is inovked by the target AsmPrinter.
1647 void DwarfDebug::BeginModule(Module *M, MachineModuleInfo *mmi) {
1650 if (TimePassesIsEnabled)
1651 DebugTimer->startTimer();
1653 DebugInfoFinder DbgFinder;
1654 DbgFinder.processModule(*M);
1656 // Create all the compile unit DIEs.
1657 for (DebugInfoFinder::iterator I = DbgFinder.compile_unit_begin(),
1658 E = DbgFinder.compile_unit_end(); I != E; ++I)
1659 ConstructCompileUnit(*I);
1661 if (CompileUnits.empty()) {
1662 if (TimePassesIsEnabled)
1663 DebugTimer->stopTimer();
1668 // If main compile unit for this module is not seen than randomly
1669 // select first compile unit.
1671 ModuleCU = CompileUnits[0];
1673 // Create DIEs for each of the externally visible global variables.
1674 for (DebugInfoFinder::iterator I = DbgFinder.global_variable_begin(),
1675 E = DbgFinder.global_variable_end(); I != E; ++I) {
1676 DIGlobalVariable GV(*I);
1677 if (GV.getContext().getNode() != GV.getCompileUnit().getNode())
1678 ScopedGVs.push_back(*I);
1680 ConstructGlobalVariableDIE(*I);
1683 // Create DIEs for each of the externally visible subprograms.
1684 for (DebugInfoFinder::iterator I = DbgFinder.subprogram_begin(),
1685 E = DbgFinder.subprogram_end(); I != E; ++I)
1686 ConstructSubprogram(*I);
1690 MMI->setDebugInfoAvailability(true);
1692 // Prime section data.
1693 SectionMap.insert(Asm->getObjFileLowering().getTextSection());
1695 // Print out .file directives to specify files for .loc directives. These are
1696 // printed out early so that they precede any .loc directives.
1697 if (MAI->hasDotLocAndDotFile()) {
1698 for (unsigned i = 1, e = getNumSourceIds()+1; i != e; ++i) {
1699 // Remember source id starts at 1.
1700 std::pair<unsigned, unsigned> Id = getSourceDirectoryAndFileIds(i);
1701 sys::Path FullPath(getSourceDirectoryName(Id.first));
1703 FullPath.appendComponent(getSourceFileName(Id.second));
1704 assert(AppendOk && "Could not append filename to directory!");
1706 Asm->EmitFile(i, FullPath.str());
1711 // Emit initial sections
1714 if (TimePassesIsEnabled)
1715 DebugTimer->stopTimer();
1718 /// EndModule - Emit all Dwarf sections that should come after the content.
1720 void DwarfDebug::EndModule() {
1724 if (TimePassesIsEnabled)
1725 DebugTimer->startTimer();
1727 // Standard sections final addresses.
1728 Asm->OutStreamer.SwitchSection(Asm->getObjFileLowering().getTextSection());
1729 EmitLabel("text_end", 0);
1730 Asm->OutStreamer.SwitchSection(Asm->getObjFileLowering().getDataSection());
1731 EmitLabel("data_end", 0);
1733 // End text sections.
1734 for (unsigned i = 1, N = SectionMap.size(); i <= N; ++i) {
1735 Asm->OutStreamer.SwitchSection(SectionMap[i]);
1736 EmitLabel("section_end", i);
1739 // Emit common frame information.
1740 EmitCommonDebugFrame();
1742 // Emit function debug frame information
1743 for (std::vector<FunctionDebugFrameInfo>::iterator I = DebugFrames.begin(),
1744 E = DebugFrames.end(); I != E; ++I)
1745 EmitFunctionDebugFrame(*I);
1747 // Compute DIE offsets and sizes.
1750 // Emit all the DIEs into a debug info section
1753 // Corresponding abbreviations into a abbrev section.
1754 EmitAbbreviations();
1756 // Emit source line correspondence into a debug line section.
1759 // Emit info into a debug pubnames section.
1760 EmitDebugPubNames();
1762 // Emit info into a debug str section.
1765 // Emit info into a debug loc section.
1768 // Emit info into a debug aranges section.
1771 // Emit info into a debug ranges section.
1774 // Emit info into a debug macinfo section.
1777 // Emit inline info.
1778 EmitDebugInlineInfo();
1780 if (TimePassesIsEnabled)
1781 DebugTimer->stopTimer();
1784 /// CollectVariableInfo - Populate DbgScope entries with variables' info.
1785 bool DwarfDebug::CollectVariableInfo() {
1786 if (!MMI) return false;
1787 bool ArgsCollected = false;
1788 MachineModuleInfo::VariableDbgInfoMapTy &VMap = MMI->getVariableDbgInfo();
1789 for (MachineModuleInfo::VariableDbgInfoMapTy::iterator VI = VMap.begin(),
1790 VE = VMap.end(); VI != VE; ++VI) {
1791 MDNode *Var = VI->first;
1792 DIVariable DV (Var);
1793 if (DV.isNull()) continue;
1794 if (DV.getTag() == dwarf::DW_TAG_arg_variable)
1795 ArgsCollected = true;
1796 DILocation VLoc(VI->second.first);
1797 unsigned VSlot = VI->second.second;
1798 DbgScope *Scope = getDbgScope(VLoc.getScope().getNode(), NULL);
1799 Scope->AddVariable(new DbgVariable(DV, VSlot, false));
1801 return ArgsCollected;
1804 /// SetDbgScopeBeginLabels - Update DbgScope begin labels for the scopes that
1805 /// start with this machine instruction.
1806 void DwarfDebug::SetDbgScopeBeginLabels(const MachineInstr *MI, unsigned Label) {
1807 InsnToDbgScopeMapTy::iterator I = DbgScopeBeginMap.find(MI);
1808 if (I == DbgScopeBeginMap.end())
1810 SmallVector<DbgScope *, 2> &SD = I->second;
1811 for (SmallVector<DbgScope *, 2>::iterator SDI = SD.begin(), SDE = SD.end();
1813 (*SDI)->setStartLabelID(Label);
1816 /// SetDbgScopeEndLabels - Update DbgScope end labels for the scopes that
1817 /// end with this machine instruction.
1818 void DwarfDebug::SetDbgScopeEndLabels(const MachineInstr *MI, unsigned Label) {
1819 InsnToDbgScopeMapTy::iterator I = DbgScopeEndMap.find(MI);
1820 if (I == DbgScopeEndMap.end())
1822 SmallVector<DbgScope *, 2> &SD = I->second;
1823 for (SmallVector<DbgScope *, 2>::iterator SDI = SD.begin(), SDE = SD.end();
1825 (*SDI)->setEndLabelID(Label);
1828 /// ExtractScopeInformation - Scan machine instructions in this function
1829 /// and collect DbgScopes. Return true, if atleast one scope was found.
1830 bool DwarfDebug::ExtractScopeInformation(MachineFunction *MF) {
1831 // If scope information was extracted using .dbg intrinsics then there is not
1832 // any need to extract these information by scanning each instruction.
1833 if (!DbgScopeMap.empty())
1836 // Scan each instruction and create scopes.
1837 for (MachineFunction::const_iterator I = MF->begin(), E = MF->end();
1839 for (MachineBasicBlock::const_iterator II = I->begin(), IE = I->end();
1841 const MachineInstr *MInsn = II;
1842 DebugLoc DL = MInsn->getDebugLoc();
1845 DebugLocTuple DLT = MF->getDebugLocTuple(DL);
1846 if (!DLT.CompileUnit)
1848 // There is no need to create another DIE for compile unit. For all
1849 // other scopes, create one DbgScope now. This will be translated
1850 // into a scope DIE at the end.
1851 DIDescriptor D(DLT.CompileUnit);
1852 if (!D.isCompileUnit()) {
1853 DbgScope *Scope = getDbgScope(DLT.CompileUnit, MInsn);
1854 Scope->setLastInsn(MInsn);
1859 // If a scope's last instruction is not set then use its child scope's
1860 // last instruction as this scope's last instrunction.
1861 for (DenseMap<MDNode *, DbgScope *>::iterator DI = DbgScopeMap.begin(),
1862 DE = DbgScopeMap.end(); DI != DE; ++DI) {
1863 assert (DI->second->getFirstInsn() && "Invalid first instruction!");
1864 DI->second->FixInstructionMarkers();
1865 assert (DI->second->getLastInsn() && "Invalid last instruction!");
1868 // Each scope has first instruction and last instruction to mark beginning
1869 // and end of a scope respectively. Create an inverse map that list scopes
1870 // starts (and ends) with an instruction. One instruction may start (or end)
1872 for (DenseMap<MDNode *, DbgScope *>::iterator DI = DbgScopeMap.begin(),
1873 DE = DbgScopeMap.end(); DI != DE; ++DI) {
1874 DbgScope *S = DI->second;
1875 assert (S && "DbgScope is missing!");
1876 const MachineInstr *MI = S->getFirstInsn();
1877 assert (MI && "DbgScope does not have first instruction!");
1879 InsnToDbgScopeMapTy::iterator IDI = DbgScopeBeginMap.find(MI);
1880 if (IDI != DbgScopeBeginMap.end())
1881 IDI->second.push_back(S);
1883 DbgScopeBeginMap.insert(std::make_pair(MI,
1884 SmallVector<DbgScope *, 2>(2, S)));
1886 MI = S->getLastInsn();
1887 assert (MI && "DbgScope does not have last instruction!");
1888 IDI = DbgScopeEndMap.find(MI);
1889 if (IDI != DbgScopeEndMap.end())
1890 IDI->second.push_back(S);
1892 DbgScopeEndMap.insert(std::make_pair(MI,
1893 SmallVector<DbgScope *, 2>(2, S)));
1896 return !DbgScopeMap.empty();
1899 /// BeginFunction - Gather pre-function debug information. Assumes being
1900 /// emitted immediately after the function entry point.
1901 void DwarfDebug::BeginFunction(MachineFunction *MF) {
1904 if (!ShouldEmitDwarfDebug()) return;
1906 if (TimePassesIsEnabled)
1907 DebugTimer->startTimer();
1909 #ifdef ATTACH_DEBUG_INFO_TO_AN_INSN
1910 if (!ExtractScopeInformation(MF))
1912 bool ArgsCollected = CollectVariableInfo();
1915 // Begin accumulating function debug information.
1916 MMI->BeginFunction(MF);
1918 // Assumes in correct section after the entry point.
1919 EmitLabel("func_begin", ++SubprogramCount);
1921 // Emit label for the implicitly defined dbg.stoppoint at the start of the
1923 #ifdef ATTACH_DEBUG_INFO_TO_AN_INSN
1924 if (!ArgsCollected) {
1928 DebugLoc FDL = MF->getDefaultDebugLoc();
1929 if (!FDL.isUnknown()) {
1930 DebugLocTuple DLT = MF->getDebugLocTuple(FDL);
1931 unsigned LabelID = RecordSourceLine(DLT.Line, DLT.Col, DLT.CompileUnit);
1932 Asm->printLabel(LabelID);
1936 if (TimePassesIsEnabled)
1937 DebugTimer->stopTimer();
1940 /// EndFunction - Gather and emit post-function debug information.
1942 void DwarfDebug::EndFunction(MachineFunction *MF) {
1943 if (!ShouldEmitDwarfDebug()) return;
1945 if (TimePassesIsEnabled)
1946 DebugTimer->startTimer();
1948 // Define end label for subprogram.
1949 EmitLabel("func_end", SubprogramCount);
1951 // Get function line info.
1952 if (!Lines.empty()) {
1953 // Get section line info.
1954 unsigned ID = SectionMap.insert(Asm->getCurrentSection());
1955 if (SectionSourceLines.size() < ID) SectionSourceLines.resize(ID);
1956 std::vector<SrcLineInfo> &SectionLineInfos = SectionSourceLines[ID-1];
1957 // Append the function info to section info.
1958 SectionLineInfos.insert(SectionLineInfos.end(),
1959 Lines.begin(), Lines.end());
1962 // Construct the DbgScope for abstract instances.
1963 for (SmallVector<DbgScope *, 32>::iterator
1964 I = AbstractInstanceRootList.begin(),
1965 E = AbstractInstanceRootList.end(); I != E; ++I)
1966 ConstructFunctionDbgScope(*I);
1968 // Construct scopes for subprogram.
1969 if (FunctionDbgScope)
1970 ConstructFunctionDbgScope(FunctionDbgScope);
1972 // FIXME: This is wrong. We are essentially getting past a problem with
1973 // debug information not being able to handle unreachable blocks that have
1974 // debug information in them. In particular, those unreachable blocks that
1975 // have "region end" info in them. That situation results in the "root
1976 // scope" not being created. If that's the case, then emit a "default"
1977 // scope, i.e., one that encompasses the whole function. This isn't
1978 // desirable. And a better way of handling this (and all of the debugging
1979 // information) needs to be explored.
1980 ConstructDefaultDbgScope(MF);
1982 DebugFrames.push_back(FunctionDebugFrameInfo(SubprogramCount,
1983 MMI->getFrameMoves()));
1986 if (FunctionDbgScope) {
1987 delete FunctionDbgScope;
1988 DbgScopeMap.clear();
1989 DbgScopeBeginMap.clear();
1990 DbgScopeEndMap.clear();
1991 DbgAbstractScopeMap.clear();
1992 DbgConcreteScopeMap.clear();
1993 FunctionDbgScope = NULL;
1994 LexicalScopeStack.clear();
1995 AbstractInstanceRootList.clear();
1996 AbstractInstanceRootMap.clear();
2001 if (TimePassesIsEnabled)
2002 DebugTimer->stopTimer();
2005 /// RecordSourceLine - Records location information and associates it with a
2006 /// label. Returns a unique label ID used to generate a label and provide
2007 /// correspondence to the source line list.
2008 unsigned DwarfDebug::RecordSourceLine(unsigned Line, unsigned Col,
2013 if (TimePassesIsEnabled)
2014 DebugTimer->startTimer();
2016 const char *Dir = NULL;
2017 const char *Fn = NULL;
2019 DIDescriptor Scope(S);
2020 if (Scope.isCompileUnit()) {
2021 DICompileUnit CU(S);
2022 Dir = CU.getDirectory();
2023 Fn = CU.getFilename();
2024 } else if (Scope.isSubprogram()) {
2026 Dir = SP.getDirectory();
2027 Fn = SP.getFilename();
2028 } else if (Scope.isLexicalBlock()) {
2029 DILexicalBlock DB(S);
2030 Dir = DB.getDirectory();
2031 Fn = DB.getFilename();
2033 assert (0 && "Unexpected scope info");
2035 unsigned Src = GetOrCreateSourceID(Dir, Fn);
2036 unsigned ID = MMI->NextLabelID();
2037 Lines.push_back(SrcLineInfo(Line, Col, Src, ID));
2039 if (TimePassesIsEnabled)
2040 DebugTimer->stopTimer();
2045 /// getOrCreateSourceID - Public version of GetOrCreateSourceID. This can be
2046 /// timed. Look up the source id with the given directory and source file
2047 /// names. If none currently exists, create a new id and insert it in the
2048 /// SourceIds map. This can update DirectoryNames and SourceFileNames maps as
2050 unsigned DwarfDebug::getOrCreateSourceID(const std::string &DirName,
2051 const std::string &FileName) {
2052 if (TimePassesIsEnabled)
2053 DebugTimer->startTimer();
2055 unsigned SrcId = GetOrCreateSourceID(DirName.c_str(), FileName.c_str());
2057 if (TimePassesIsEnabled)
2058 DebugTimer->stopTimer();
2063 /// RecordRegionStart - Indicate the start of a region.
2064 unsigned DwarfDebug::RecordRegionStart(MDNode *N) {
2065 if (TimePassesIsEnabled)
2066 DebugTimer->startTimer();
2068 DbgScope *Scope = getOrCreateScope(N);
2069 unsigned ID = MMI->NextLabelID();
2070 if (!Scope->getStartLabelID()) Scope->setStartLabelID(ID);
2071 LexicalScopeStack.push_back(Scope);
2073 if (TimePassesIsEnabled)
2074 DebugTimer->stopTimer();
2079 /// RecordRegionEnd - Indicate the end of a region.
2080 unsigned DwarfDebug::RecordRegionEnd(MDNode *N) {
2081 if (TimePassesIsEnabled)
2082 DebugTimer->startTimer();
2084 DbgScope *Scope = getOrCreateScope(N);
2085 unsigned ID = MMI->NextLabelID();
2086 Scope->setEndLabelID(ID);
2087 // FIXME : region.end() may not be in the last basic block.
2088 // For now, do not pop last lexical scope because next basic
2089 // block may start new inlined function's body.
2090 unsigned LSSize = LexicalScopeStack.size();
2091 if (LSSize != 0 && LSSize != 1)
2092 LexicalScopeStack.pop_back();
2094 if (TimePassesIsEnabled)
2095 DebugTimer->stopTimer();
2100 /// RecordVariable - Indicate the declaration of a local variable.
2101 void DwarfDebug::RecordVariable(MDNode *N, unsigned FrameIndex) {
2102 if (TimePassesIsEnabled)
2103 DebugTimer->startTimer();
2105 DIDescriptor Desc(N);
2106 DbgScope *Scope = NULL;
2107 bool InlinedFnVar = false;
2109 if (Desc.getTag() == dwarf::DW_TAG_variable)
2110 Scope = getOrCreateScope(DIGlobalVariable(N).getContext().getNode());
2112 bool InlinedVar = false;
2113 MDNode *Context = DIVariable(N).getContext().getNode();
2114 DISubprogram SP(Context);
2116 // SP is inserted into DbgAbstractScopeMap when inlined function
2117 // start was recorded by RecordInlineFnStart.
2118 DenseMap<MDNode *, DbgScope *>::iterator
2119 I = DbgAbstractScopeMap.find(SP.getNode());
2120 if (I != DbgAbstractScopeMap.end()) {
2126 Scope = getOrCreateScope(Context);
2129 assert(Scope && "Unable to find the variable's scope");
2130 DbgVariable *DV = new DbgVariable(DIVariable(N), FrameIndex, InlinedFnVar);
2131 Scope->AddVariable(DV);
2133 if (TimePassesIsEnabled)
2134 DebugTimer->stopTimer();
2137 //// RecordInlinedFnStart - Indicate the start of inlined subroutine.
2138 unsigned DwarfDebug::RecordInlinedFnStart(DISubprogram &SP, DICompileUnit CU,
2139 unsigned Line, unsigned Col) {
2140 unsigned LabelID = MMI->NextLabelID();
2142 if (!MAI->doesDwarfUsesInlineInfoSection())
2145 if (TimePassesIsEnabled)
2146 DebugTimer->startTimer();
2148 MDNode *Node = SP.getNode();
2149 DenseMap<const MDNode *, DbgScope *>::iterator
2150 II = AbstractInstanceRootMap.find(Node);
2152 if (II == AbstractInstanceRootMap.end()) {
2153 // Create an abstract instance entry for this inlined function if it doesn't
2155 DbgScope *Scope = new DbgScope(NULL, DIDescriptor(Node));
2157 // Get the compile unit context.
2158 DIE *SPDie = ModuleCU->getDieMapSlotFor(Node);
2160 SPDie = CreateSubprogramDIE(ModuleCU, SP, false, true);
2162 // Mark as being inlined. This makes this subprogram entry an abstract
2164 // FIXME: Our debugger doesn't care about the value of DW_AT_inline, only
2165 // that it's defined. That probably won't change in the future. However,
2166 // this could be more elegant.
2167 AddUInt(SPDie, dwarf::DW_AT_inline, 0, dwarf::DW_INL_declared_not_inlined);
2169 // Keep track of the abstract scope for this function.
2170 DbgAbstractScopeMap[Node] = Scope;
2172 AbstractInstanceRootMap[Node] = Scope;
2173 AbstractInstanceRootList.push_back(Scope);
2176 // Create a concrete inlined instance for this inlined function.
2177 DbgConcreteScope *ConcreteScope = new DbgConcreteScope(DIDescriptor(Node));
2178 DIE *ScopeDie = new DIE(dwarf::DW_TAG_inlined_subroutine);
2179 ScopeDie->setAbstractCompileUnit(ModuleCU);
2181 DIE *Origin = ModuleCU->getDieMapSlotFor(Node);
2182 AddDIEEntry(ScopeDie, dwarf::DW_AT_abstract_origin,
2183 dwarf::DW_FORM_ref4, Origin);
2184 AddUInt(ScopeDie, dwarf::DW_AT_call_file, 0, ModuleCU->getID());
2185 AddUInt(ScopeDie, dwarf::DW_AT_call_line, 0, Line);
2186 AddUInt(ScopeDie, dwarf::DW_AT_call_column, 0, Col);
2188 ConcreteScope->setDie(ScopeDie);
2189 ConcreteScope->setStartLabelID(LabelID);
2190 MMI->RecordUsedDbgLabel(LabelID);
2192 LexicalScopeStack.back()->AddConcreteInst(ConcreteScope);
2194 // Keep track of the concrete scope that's inlined into this function.
2195 DenseMap<MDNode *, SmallVector<DbgScope *, 8> >::iterator
2196 SI = DbgConcreteScopeMap.find(Node);
2198 if (SI == DbgConcreteScopeMap.end())
2199 DbgConcreteScopeMap[Node].push_back(ConcreteScope);
2201 SI->second.push_back(ConcreteScope);
2203 // Track the start label for this inlined function.
2204 DenseMap<MDNode *, SmallVector<unsigned, 4> >::iterator
2205 I = InlineInfo.find(Node);
2207 if (I == InlineInfo.end())
2208 InlineInfo[Node].push_back(LabelID);
2210 I->second.push_back(LabelID);
2212 if (TimePassesIsEnabled)
2213 DebugTimer->stopTimer();
2218 /// RecordInlinedFnEnd - Indicate the end of inlined subroutine.
2219 unsigned DwarfDebug::RecordInlinedFnEnd(DISubprogram &SP) {
2220 if (!MAI->doesDwarfUsesInlineInfoSection())
2223 if (TimePassesIsEnabled)
2224 DebugTimer->startTimer();
2226 MDNode *Node = SP.getNode();
2227 DenseMap<MDNode *, SmallVector<DbgScope *, 8> >::iterator
2228 I = DbgConcreteScopeMap.find(Node);
2230 if (I == DbgConcreteScopeMap.end()) {
2231 // FIXME: Can this situation actually happen? And if so, should it?
2232 if (TimePassesIsEnabled)
2233 DebugTimer->stopTimer();
2238 SmallVector<DbgScope *, 8> &Scopes = I->second;
2239 if (Scopes.empty()) {
2240 // Returned ID is 0 if this is unbalanced "end of inlined
2241 // scope". This could happen if optimizer eats dbg intrinsics
2242 // or "beginning of inlined scope" is not recoginized due to
2243 // missing location info. In such cases, ignore this region.end.
2247 DbgScope *Scope = Scopes.back(); Scopes.pop_back();
2248 unsigned ID = MMI->NextLabelID();
2249 MMI->RecordUsedDbgLabel(ID);
2250 Scope->setEndLabelID(ID);
2252 if (TimePassesIsEnabled)
2253 DebugTimer->stopTimer();
2258 //===----------------------------------------------------------------------===//
2260 //===----------------------------------------------------------------------===//
2262 /// SizeAndOffsetDie - Compute the size and offset of a DIE.
2264 unsigned DwarfDebug::SizeAndOffsetDie(DIE *Die, unsigned Offset, bool Last) {
2265 // Get the children.
2266 const std::vector<DIE *> &Children = Die->getChildren();
2268 // If not last sibling and has children then add sibling offset attribute.
2269 if (!Last && !Children.empty()) Die->AddSiblingOffset();
2271 // Record the abbreviation.
2272 AssignAbbrevNumber(Die->getAbbrev());
2274 // Get the abbreviation for this DIE.
2275 unsigned AbbrevNumber = Die->getAbbrevNumber();
2276 const DIEAbbrev *Abbrev = Abbreviations[AbbrevNumber - 1];
2279 Die->setOffset(Offset);
2281 // Start the size with the size of abbreviation code.
2282 Offset += MCAsmInfo::getULEB128Size(AbbrevNumber);
2284 const SmallVector<DIEValue*, 32> &Values = Die->getValues();
2285 const SmallVector<DIEAbbrevData, 8> &AbbrevData = Abbrev->getData();
2287 // Size the DIE attribute values.
2288 for (unsigned i = 0, N = Values.size(); i < N; ++i)
2289 // Size attribute value.
2290 Offset += Values[i]->SizeOf(TD, AbbrevData[i].getForm());
2292 // Size the DIE children if any.
2293 if (!Children.empty()) {
2294 assert(Abbrev->getChildrenFlag() == dwarf::DW_CHILDREN_yes &&
2295 "Children flag not set");
2297 for (unsigned j = 0, M = Children.size(); j < M; ++j)
2298 Offset = SizeAndOffsetDie(Children[j], Offset, (j + 1) == M);
2300 // End of children marker.
2301 Offset += sizeof(int8_t);
2304 Die->setSize(Offset - Die->getOffset());
2308 /// SizeAndOffsets - Compute the size and offset of all the DIEs.
2310 void DwarfDebug::SizeAndOffsets() {
2311 // Compute size of compile unit header.
2312 static unsigned Offset =
2313 sizeof(int32_t) + // Length of Compilation Unit Info
2314 sizeof(int16_t) + // DWARF version number
2315 sizeof(int32_t) + // Offset Into Abbrev. Section
2316 sizeof(int8_t); // Pointer Size (in bytes)
2318 SizeAndOffsetDie(ModuleCU->getDie(), Offset, true);
2319 CompileUnitOffsets[ModuleCU] = 0;
2322 /// EmitInitial - Emit initial Dwarf declarations. This is necessary for cc
2323 /// tools to recognize the object file contains Dwarf information.
2324 void DwarfDebug::EmitInitial() {
2325 // Check to see if we already emitted intial headers.
2326 if (didInitial) return;
2329 const TargetLoweringObjectFile &TLOF = Asm->getObjFileLowering();
2331 // Dwarf sections base addresses.
2332 if (MAI->doesDwarfRequireFrameSection()) {
2333 Asm->OutStreamer.SwitchSection(TLOF.getDwarfFrameSection());
2334 EmitLabel("section_debug_frame", 0);
2337 Asm->OutStreamer.SwitchSection(TLOF.getDwarfInfoSection());
2338 EmitLabel("section_info", 0);
2339 Asm->OutStreamer.SwitchSection(TLOF.getDwarfAbbrevSection());
2340 EmitLabel("section_abbrev", 0);
2341 Asm->OutStreamer.SwitchSection(TLOF.getDwarfARangesSection());
2342 EmitLabel("section_aranges", 0);
2344 if (const MCSection *LineInfoDirective = TLOF.getDwarfMacroInfoSection()) {
2345 Asm->OutStreamer.SwitchSection(LineInfoDirective);
2346 EmitLabel("section_macinfo", 0);
2349 Asm->OutStreamer.SwitchSection(TLOF.getDwarfLineSection());
2350 EmitLabel("section_line", 0);
2351 Asm->OutStreamer.SwitchSection(TLOF.getDwarfLocSection());
2352 EmitLabel("section_loc", 0);
2353 Asm->OutStreamer.SwitchSection(TLOF.getDwarfPubNamesSection());
2354 EmitLabel("section_pubnames", 0);
2355 Asm->OutStreamer.SwitchSection(TLOF.getDwarfStrSection());
2356 EmitLabel("section_str", 0);
2357 Asm->OutStreamer.SwitchSection(TLOF.getDwarfRangesSection());
2358 EmitLabel("section_ranges", 0);
2360 Asm->OutStreamer.SwitchSection(TLOF.getTextSection());
2361 EmitLabel("text_begin", 0);
2362 Asm->OutStreamer.SwitchSection(TLOF.getDataSection());
2363 EmitLabel("data_begin", 0);
2366 /// EmitDIE - Recusively Emits a debug information entry.
2368 void DwarfDebug::EmitDIE(DIE *Die) {
2369 // Get the abbreviation for this DIE.
2370 unsigned AbbrevNumber = Die->getAbbrevNumber();
2371 const DIEAbbrev *Abbrev = Abbreviations[AbbrevNumber - 1];
2375 // Emit the code (index) for the abbreviation.
2376 Asm->EmitULEB128Bytes(AbbrevNumber);
2378 if (Asm->isVerbose())
2379 Asm->EOL(std::string("Abbrev [" +
2380 utostr(AbbrevNumber) +
2381 "] 0x" + utohexstr(Die->getOffset()) +
2382 ":0x" + utohexstr(Die->getSize()) + " " +
2383 dwarf::TagString(Abbrev->getTag())));
2387 SmallVector<DIEValue*, 32> &Values = Die->getValues();
2388 const SmallVector<DIEAbbrevData, 8> &AbbrevData = Abbrev->getData();
2390 // Emit the DIE attribute values.
2391 for (unsigned i = 0, N = Values.size(); i < N; ++i) {
2392 unsigned Attr = AbbrevData[i].getAttribute();
2393 unsigned Form = AbbrevData[i].getForm();
2394 assert(Form && "Too many attributes for DIE (check abbreviation)");
2397 case dwarf::DW_AT_sibling:
2398 Asm->EmitInt32(Die->SiblingOffset());
2400 case dwarf::DW_AT_abstract_origin: {
2401 DIEEntry *E = cast<DIEEntry>(Values[i]);
2402 DIE *Origin = E->getEntry();
2404 CompileUnitOffsets[Die->getAbstractCompileUnit()] +
2405 Origin->getOffset();
2407 Asm->EmitInt32(Addr);
2411 // Emit an attribute using the defined form.
2412 Values[i]->EmitValue(this, Form);
2416 Asm->EOL(dwarf::AttributeString(Attr));
2419 // Emit the DIE children if any.
2420 if (Abbrev->getChildrenFlag() == dwarf::DW_CHILDREN_yes) {
2421 const std::vector<DIE *> &Children = Die->getChildren();
2423 for (unsigned j = 0, M = Children.size(); j < M; ++j)
2424 EmitDIE(Children[j]);
2426 Asm->EmitInt8(0); Asm->EOL("End Of Children Mark");
2430 /// EmitDebugInfo / EmitDebugInfoPerCU - Emit the debug info section.
2432 void DwarfDebug::EmitDebugInfoPerCU(CompileUnit *Unit) {
2433 DIE *Die = Unit->getDie();
2435 // Emit the compile units header.
2436 EmitLabel("info_begin", Unit->getID());
2438 // Emit size of content not including length itself
2439 unsigned ContentSize = Die->getSize() +
2440 sizeof(int16_t) + // DWARF version number
2441 sizeof(int32_t) + // Offset Into Abbrev. Section
2442 sizeof(int8_t) + // Pointer Size (in bytes)
2443 sizeof(int32_t); // FIXME - extra pad for gdb bug.
2445 Asm->EmitInt32(ContentSize); Asm->EOL("Length of Compilation Unit Info");
2446 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF version number");
2447 EmitSectionOffset("abbrev_begin", "section_abbrev", 0, 0, true, false);
2448 Asm->EOL("Offset Into Abbrev. Section");
2449 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Address Size (in bytes)");
2452 // FIXME - extra padding for gdb bug.
2453 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2454 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2455 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2456 Asm->EmitInt8(0); Asm->EOL("Extra Pad For GDB");
2457 EmitLabel("info_end", Unit->getID());
2462 void DwarfDebug::EmitDebugInfo() {
2463 // Start debug info section.
2464 Asm->OutStreamer.SwitchSection(
2465 Asm->getObjFileLowering().getDwarfInfoSection());
2467 EmitDebugInfoPerCU(ModuleCU);
2470 /// EmitAbbreviations - Emit the abbreviation section.
2472 void DwarfDebug::EmitAbbreviations() const {
2473 // Check to see if it is worth the effort.
2474 if (!Abbreviations.empty()) {
2475 // Start the debug abbrev section.
2476 Asm->OutStreamer.SwitchSection(
2477 Asm->getObjFileLowering().getDwarfAbbrevSection());
2479 EmitLabel("abbrev_begin", 0);
2481 // For each abbrevation.
2482 for (unsigned i = 0, N = Abbreviations.size(); i < N; ++i) {
2483 // Get abbreviation data
2484 const DIEAbbrev *Abbrev = Abbreviations[i];
2486 // Emit the abbrevations code (base 1 index.)
2487 Asm->EmitULEB128Bytes(Abbrev->getNumber());
2488 Asm->EOL("Abbreviation Code");
2490 // Emit the abbreviations data.
2496 // Mark end of abbreviations.
2497 Asm->EmitULEB128Bytes(0); Asm->EOL("EOM(3)");
2499 EmitLabel("abbrev_end", 0);
2504 /// EmitEndOfLineMatrix - Emit the last address of the section and the end of
2505 /// the line matrix.
2507 void DwarfDebug::EmitEndOfLineMatrix(unsigned SectionEnd) {
2508 // Define last address of section.
2509 Asm->EmitInt8(0); Asm->EOL("Extended Op");
2510 Asm->EmitInt8(TD->getPointerSize() + 1); Asm->EOL("Op size");
2511 Asm->EmitInt8(dwarf::DW_LNE_set_address); Asm->EOL("DW_LNE_set_address");
2512 EmitReference("section_end", SectionEnd); Asm->EOL("Section end label");
2514 // Mark end of matrix.
2515 Asm->EmitInt8(0); Asm->EOL("DW_LNE_end_sequence");
2516 Asm->EmitULEB128Bytes(1); Asm->EOL();
2517 Asm->EmitInt8(1); Asm->EOL();
2520 /// EmitDebugLines - Emit source line information.
2522 void DwarfDebug::EmitDebugLines() {
2523 // If the target is using .loc/.file, the assembler will be emitting the
2524 // .debug_line table automatically.
2525 if (MAI->hasDotLocAndDotFile())
2528 // Minimum line delta, thus ranging from -10..(255-10).
2529 const int MinLineDelta = -(dwarf::DW_LNS_fixed_advance_pc + 1);
2530 // Maximum line delta, thus ranging from -10..(255-10).
2531 const int MaxLineDelta = 255 + MinLineDelta;
2533 // Start the dwarf line section.
2534 Asm->OutStreamer.SwitchSection(
2535 Asm->getObjFileLowering().getDwarfLineSection());
2537 // Construct the section header.
2538 EmitDifference("line_end", 0, "line_begin", 0, true);
2539 Asm->EOL("Length of Source Line Info");
2540 EmitLabel("line_begin", 0);
2542 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF version number");
2544 EmitDifference("line_prolog_end", 0, "line_prolog_begin", 0, true);
2545 Asm->EOL("Prolog Length");
2546 EmitLabel("line_prolog_begin", 0);
2548 Asm->EmitInt8(1); Asm->EOL("Minimum Instruction Length");
2550 Asm->EmitInt8(1); Asm->EOL("Default is_stmt_start flag");
2552 Asm->EmitInt8(MinLineDelta); Asm->EOL("Line Base Value (Special Opcodes)");
2554 Asm->EmitInt8(MaxLineDelta); Asm->EOL("Line Range Value (Special Opcodes)");
2556 Asm->EmitInt8(-MinLineDelta); Asm->EOL("Special Opcode Base");
2558 // Line number standard opcode encodings argument count
2559 Asm->EmitInt8(0); Asm->EOL("DW_LNS_copy arg count");
2560 Asm->EmitInt8(1); Asm->EOL("DW_LNS_advance_pc arg count");
2561 Asm->EmitInt8(1); Asm->EOL("DW_LNS_advance_line arg count");
2562 Asm->EmitInt8(1); Asm->EOL("DW_LNS_set_file arg count");
2563 Asm->EmitInt8(1); Asm->EOL("DW_LNS_set_column arg count");
2564 Asm->EmitInt8(0); Asm->EOL("DW_LNS_negate_stmt arg count");
2565 Asm->EmitInt8(0); Asm->EOL("DW_LNS_set_basic_block arg count");
2566 Asm->EmitInt8(0); Asm->EOL("DW_LNS_const_add_pc arg count");
2567 Asm->EmitInt8(1); Asm->EOL("DW_LNS_fixed_advance_pc arg count");
2569 // Emit directories.
2570 for (unsigned DI = 1, DE = getNumSourceDirectories()+1; DI != DE; ++DI) {
2571 Asm->EmitString(getSourceDirectoryName(DI));
2572 Asm->EOL("Directory");
2575 Asm->EmitInt8(0); Asm->EOL("End of directories");
2578 for (unsigned SI = 1, SE = getNumSourceIds()+1; SI != SE; ++SI) {
2579 // Remember source id starts at 1.
2580 std::pair<unsigned, unsigned> Id = getSourceDirectoryAndFileIds(SI);
2581 Asm->EmitString(getSourceFileName(Id.second));
2583 Asm->EmitULEB128Bytes(Id.first);
2584 Asm->EOL("Directory #");
2585 Asm->EmitULEB128Bytes(0);
2586 Asm->EOL("Mod date");
2587 Asm->EmitULEB128Bytes(0);
2588 Asm->EOL("File size");
2591 Asm->EmitInt8(0); Asm->EOL("End of files");
2593 EmitLabel("line_prolog_end", 0);
2595 // A sequence for each text section.
2596 unsigned SecSrcLinesSize = SectionSourceLines.size();
2598 for (unsigned j = 0; j < SecSrcLinesSize; ++j) {
2599 // Isolate current sections line info.
2600 const std::vector<SrcLineInfo> &LineInfos = SectionSourceLines[j];
2602 /*if (Asm->isVerbose()) {
2603 const MCSection *S = SectionMap[j + 1];
2604 O << '\t' << MAI->getCommentString() << " Section"
2605 << S->getName() << '\n';
2609 // Dwarf assumes we start with first line of first source file.
2610 unsigned Source = 1;
2613 // Construct rows of the address, source, line, column matrix.
2614 for (unsigned i = 0, N = LineInfos.size(); i < N; ++i) {
2615 const SrcLineInfo &LineInfo = LineInfos[i];
2616 unsigned LabelID = MMI->MappedLabel(LineInfo.getLabelID());
2617 if (!LabelID) continue;
2619 if (LineInfo.getLine() == 0) continue;
2621 if (!Asm->isVerbose())
2624 std::pair<unsigned, unsigned> SourceID =
2625 getSourceDirectoryAndFileIds(LineInfo.getSourceID());
2626 O << '\t' << MAI->getCommentString() << ' '
2627 << getSourceDirectoryName(SourceID.first) << ' '
2628 << getSourceFileName(SourceID.second)
2629 <<" :" << utostr_32(LineInfo.getLine()) << '\n';
2632 // Define the line address.
2633 Asm->EmitInt8(0); Asm->EOL("Extended Op");
2634 Asm->EmitInt8(TD->getPointerSize() + 1); Asm->EOL("Op size");
2635 Asm->EmitInt8(dwarf::DW_LNE_set_address); Asm->EOL("DW_LNE_set_address");
2636 EmitReference("label", LabelID); Asm->EOL("Location label");
2638 // If change of source, then switch to the new source.
2639 if (Source != LineInfo.getSourceID()) {
2640 Source = LineInfo.getSourceID();
2641 Asm->EmitInt8(dwarf::DW_LNS_set_file); Asm->EOL("DW_LNS_set_file");
2642 Asm->EmitULEB128Bytes(Source); Asm->EOL("New Source");
2645 // If change of line.
2646 if (Line != LineInfo.getLine()) {
2647 // Determine offset.
2648 int Offset = LineInfo.getLine() - Line;
2649 int Delta = Offset - MinLineDelta;
2652 Line = LineInfo.getLine();
2654 // If delta is small enough and in range...
2655 if (Delta >= 0 && Delta < (MaxLineDelta - 1)) {
2656 // ... then use fast opcode.
2657 Asm->EmitInt8(Delta - MinLineDelta); Asm->EOL("Line Delta");
2659 // ... otherwise use long hand.
2660 Asm->EmitInt8(dwarf::DW_LNS_advance_line);
2661 Asm->EOL("DW_LNS_advance_line");
2662 Asm->EmitSLEB128Bytes(Offset); Asm->EOL("Line Offset");
2663 Asm->EmitInt8(dwarf::DW_LNS_copy); Asm->EOL("DW_LNS_copy");
2666 // Copy the previous row (different address or source)
2667 Asm->EmitInt8(dwarf::DW_LNS_copy); Asm->EOL("DW_LNS_copy");
2671 EmitEndOfLineMatrix(j + 1);
2674 if (SecSrcLinesSize == 0)
2675 // Because we're emitting a debug_line section, we still need a line
2676 // table. The linker and friends expect it to exist. If there's nothing to
2677 // put into it, emit an empty table.
2678 EmitEndOfLineMatrix(1);
2680 EmitLabel("line_end", 0);
2684 /// EmitCommonDebugFrame - Emit common frame info into a debug frame section.
2686 void DwarfDebug::EmitCommonDebugFrame() {
2687 if (!MAI->doesDwarfRequireFrameSection())
2691 Asm->TM.getFrameInfo()->getStackGrowthDirection() ==
2692 TargetFrameInfo::StackGrowsUp ?
2693 TD->getPointerSize() : -TD->getPointerSize();
2695 // Start the dwarf frame section.
2696 Asm->OutStreamer.SwitchSection(
2697 Asm->getObjFileLowering().getDwarfFrameSection());
2699 EmitLabel("debug_frame_common", 0);
2700 EmitDifference("debug_frame_common_end", 0,
2701 "debug_frame_common_begin", 0, true);
2702 Asm->EOL("Length of Common Information Entry");
2704 EmitLabel("debug_frame_common_begin", 0);
2705 Asm->EmitInt32((int)dwarf::DW_CIE_ID);
2706 Asm->EOL("CIE Identifier Tag");
2707 Asm->EmitInt8(dwarf::DW_CIE_VERSION);
2708 Asm->EOL("CIE Version");
2709 Asm->EmitString("");
2710 Asm->EOL("CIE Augmentation");
2711 Asm->EmitULEB128Bytes(1);
2712 Asm->EOL("CIE Code Alignment Factor");
2713 Asm->EmitSLEB128Bytes(stackGrowth);
2714 Asm->EOL("CIE Data Alignment Factor");
2715 Asm->EmitInt8(RI->getDwarfRegNum(RI->getRARegister(), false));
2716 Asm->EOL("CIE RA Column");
2718 std::vector<MachineMove> Moves;
2719 RI->getInitialFrameState(Moves);
2721 EmitFrameMoves(NULL, 0, Moves, false);
2723 Asm->EmitAlignment(2, 0, 0, false);
2724 EmitLabel("debug_frame_common_end", 0);
2729 /// EmitFunctionDebugFrame - Emit per function frame info into a debug frame
2732 DwarfDebug::EmitFunctionDebugFrame(const FunctionDebugFrameInfo&DebugFrameInfo){
2733 if (!MAI->doesDwarfRequireFrameSection())
2736 // Start the dwarf frame section.
2737 Asm->OutStreamer.SwitchSection(
2738 Asm->getObjFileLowering().getDwarfFrameSection());
2740 EmitDifference("debug_frame_end", DebugFrameInfo.Number,
2741 "debug_frame_begin", DebugFrameInfo.Number, true);
2742 Asm->EOL("Length of Frame Information Entry");
2744 EmitLabel("debug_frame_begin", DebugFrameInfo.Number);
2746 EmitSectionOffset("debug_frame_common", "section_debug_frame",
2748 Asm->EOL("FDE CIE offset");
2750 EmitReference("func_begin", DebugFrameInfo.Number);
2751 Asm->EOL("FDE initial location");
2752 EmitDifference("func_end", DebugFrameInfo.Number,
2753 "func_begin", DebugFrameInfo.Number);
2754 Asm->EOL("FDE address range");
2756 EmitFrameMoves("func_begin", DebugFrameInfo.Number, DebugFrameInfo.Moves,
2759 Asm->EmitAlignment(2, 0, 0, false);
2760 EmitLabel("debug_frame_end", DebugFrameInfo.Number);
2765 void DwarfDebug::EmitDebugPubNamesPerCU(CompileUnit *Unit) {
2766 EmitDifference("pubnames_end", Unit->getID(),
2767 "pubnames_begin", Unit->getID(), true);
2768 Asm->EOL("Length of Public Names Info");
2770 EmitLabel("pubnames_begin", Unit->getID());
2772 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("DWARF Version");
2774 EmitSectionOffset("info_begin", "section_info",
2775 Unit->getID(), 0, true, false);
2776 Asm->EOL("Offset of Compilation Unit Info");
2778 EmitDifference("info_end", Unit->getID(), "info_begin", Unit->getID(),
2780 Asm->EOL("Compilation Unit Length");
2782 StringMap<DIE*> &Globals = Unit->getGlobals();
2783 for (StringMap<DIE*>::const_iterator
2784 GI = Globals.begin(), GE = Globals.end(); GI != GE; ++GI) {
2785 const char *Name = GI->getKeyData();
2786 DIE * Entity = GI->second;
2788 Asm->EmitInt32(Entity->getOffset()); Asm->EOL("DIE offset");
2789 Asm->EmitString(Name, strlen(Name)); Asm->EOL("External Name");
2792 Asm->EmitInt32(0); Asm->EOL("End Mark");
2793 EmitLabel("pubnames_end", Unit->getID());
2798 /// EmitDebugPubNames - Emit visible names into a debug pubnames section.
2800 void DwarfDebug::EmitDebugPubNames() {
2801 // Start the dwarf pubnames section.
2802 Asm->OutStreamer.SwitchSection(
2803 Asm->getObjFileLowering().getDwarfPubNamesSection());
2805 EmitDebugPubNamesPerCU(ModuleCU);
2808 /// EmitDebugStr - Emit visible names into a debug str section.
2810 void DwarfDebug::EmitDebugStr() {
2811 // Check to see if it is worth the effort.
2812 if (!StringPool.empty()) {
2813 // Start the dwarf str section.
2814 Asm->OutStreamer.SwitchSection(
2815 Asm->getObjFileLowering().getDwarfStrSection());
2817 // For each of strings in the string pool.
2818 for (unsigned StringID = 1, N = StringPool.size();
2819 StringID <= N; ++StringID) {
2820 // Emit a label for reference from debug information entries.
2821 EmitLabel("string", StringID);
2823 // Emit the string itself.
2824 const std::string &String = StringPool[StringID];
2825 Asm->EmitString(String); Asm->EOL();
2832 /// EmitDebugLoc - Emit visible names into a debug loc section.
2834 void DwarfDebug::EmitDebugLoc() {
2835 // Start the dwarf loc section.
2836 Asm->OutStreamer.SwitchSection(
2837 Asm->getObjFileLowering().getDwarfLocSection());
2841 /// EmitDebugARanges - Emit visible names into a debug aranges section.
2843 void DwarfDebug::EmitDebugARanges() {
2844 // Start the dwarf aranges section.
2845 Asm->OutStreamer.SwitchSection(
2846 Asm->getObjFileLowering().getDwarfARangesSection());
2850 CompileUnit *Unit = GetBaseCompileUnit();
2852 // Don't include size of length
2853 Asm->EmitInt32(0x1c); Asm->EOL("Length of Address Ranges Info");
2855 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("Dwarf Version");
2857 EmitReference("info_begin", Unit->getID());
2858 Asm->EOL("Offset of Compilation Unit Info");
2860 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Size of Address");
2862 Asm->EmitInt8(0); Asm->EOL("Size of Segment Descriptor");
2864 Asm->EmitInt16(0); Asm->EOL("Pad (1)");
2865 Asm->EmitInt16(0); Asm->EOL("Pad (2)");
2868 EmitReference("text_begin", 0); Asm->EOL("Address");
2869 EmitDifference("text_end", 0, "text_begin", 0, true); Asm->EOL("Length");
2871 Asm->EmitInt32(0); Asm->EOL("EOM (1)");
2872 Asm->EmitInt32(0); Asm->EOL("EOM (2)");
2878 /// EmitDebugRanges - Emit visible names into a debug ranges section.
2880 void DwarfDebug::EmitDebugRanges() {
2881 // Start the dwarf ranges section.
2882 Asm->OutStreamer.SwitchSection(
2883 Asm->getObjFileLowering().getDwarfRangesSection());
2887 /// EmitDebugMacInfo - Emit visible names into a debug macinfo section.
2889 void DwarfDebug::EmitDebugMacInfo() {
2890 if (const MCSection *LineInfo =
2891 Asm->getObjFileLowering().getDwarfMacroInfoSection()) {
2892 // Start the dwarf macinfo section.
2893 Asm->OutStreamer.SwitchSection(LineInfo);
2898 /// EmitDebugInlineInfo - Emit inline info using following format.
2900 /// 1. length of section
2901 /// 2. Dwarf version number
2902 /// 3. address size.
2904 /// Entries (one "entry" for each function that was inlined):
2906 /// 1. offset into __debug_str section for MIPS linkage name, if exists;
2907 /// otherwise offset into __debug_str for regular function name.
2908 /// 2. offset into __debug_str section for regular function name.
2909 /// 3. an unsigned LEB128 number indicating the number of distinct inlining
2910 /// instances for the function.
2912 /// The rest of the entry consists of a {die_offset, low_pc} pair for each
2913 /// inlined instance; the die_offset points to the inlined_subroutine die in the
2914 /// __debug_info section, and the low_pc is the starting address for the
2915 /// inlining instance.
2916 void DwarfDebug::EmitDebugInlineInfo() {
2917 if (!MAI->doesDwarfUsesInlineInfoSection())
2923 Asm->OutStreamer.SwitchSection(
2924 Asm->getObjFileLowering().getDwarfDebugInlineSection());
2926 EmitDifference("debug_inlined_end", 1,
2927 "debug_inlined_begin", 1, true);
2928 Asm->EOL("Length of Debug Inlined Information Entry");
2930 EmitLabel("debug_inlined_begin", 1);
2932 Asm->EmitInt16(dwarf::DWARF_VERSION); Asm->EOL("Dwarf Version");
2933 Asm->EmitInt8(TD->getPointerSize()); Asm->EOL("Address Size (in bytes)");
2935 for (DenseMap<MDNode *, SmallVector<unsigned, 4> >::iterator
2936 I = InlineInfo.begin(), E = InlineInfo.end(); I != E; ++I) {
2937 MDNode *Node = I->first;
2938 SmallVector<unsigned, 4> &Labels = I->second;
2939 DISubprogram SP(Node);
2940 const char *LName = SP.getLinkageName();
2941 const char *Name = SP.getName();
2944 Asm->EmitString(Name);
2946 // Skip special LLVM prefix that is used to inform the asm printer to not
2947 // emit usual symbol prefix before the symbol name. This happens for
2948 // Objective-C symbol names and symbol whose name is replaced using GCC's
2949 // __asm__ attribute.
2952 Asm->EmitString(LName);
2954 Asm->EOL("MIPS linkage name");
2956 Asm->EmitString(Name); Asm->EOL("Function name");
2958 Asm->EmitULEB128Bytes(Labels.size()); Asm->EOL("Inline count");
2960 for (SmallVector<unsigned, 4>::iterator LI = Labels.begin(),
2961 LE = Labels.end(); LI != LE; ++LI) {
2962 DIE *SP = ModuleCU->getDieMapSlotFor(Node);
2963 Asm->EmitInt32(SP->getOffset()); Asm->EOL("DIE offset");
2965 if (TD->getPointerSize() == sizeof(int32_t))
2966 O << MAI->getData32bitsDirective();
2968 O << MAI->getData64bitsDirective();
2970 PrintLabelName("label", *LI); Asm->EOL("low_pc");
2974 EmitLabel("debug_inlined_end", 1);