Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 1 | //===--- CGDebugInfo.h - DebugInfo for LLVM CodeGen -------------*- C++ -*-===// |
| 2 | // |
| 3 | // The LLVM Compiler Infrastructure |
| 4 | // |
| 5 | // This file is distributed under the University of Illinois Open Source |
| 6 | // License. See LICENSE.TXT for details. |
| 7 | // |
| 8 | //===----------------------------------------------------------------------===// |
| 9 | // |
Alp Toker | 9907f08 | 2014-07-09 14:06:35 +0000 | [diff] [blame] | 10 | // This is the source-level debug info generator for llvm translation. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 11 | // |
| 12 | //===----------------------------------------------------------------------===// |
| 13 | |
Benjamin Kramer | 2f5db8b | 2014-08-13 16:25:19 +0000 | [diff] [blame] | 14 | #ifndef LLVM_CLANG_LIB_CODEGEN_CGDEBUGINFO_H |
| 15 | #define LLVM_CLANG_LIB_CODEGEN_CGDEBUGINFO_H |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 16 | |
| 17 | #include "CGBuilder.h" |
| 18 | #include "clang/AST/Expr.h" |
| 19 | #include "clang/AST/Type.h" |
| 20 | #include "clang/Basic/SourceLocation.h" |
Eric Christopher | 75e1768 | 2013-05-16 00:45:23 +0000 | [diff] [blame] | 21 | #include "clang/Frontend/CodeGenOptions.h" |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 22 | #include "llvm/ADT/DenseMap.h" |
Duncan P. N. Exon Smith | e430654 | 2015-07-31 17:56:14 +0000 | [diff] [blame] | 23 | #include "llvm/ADT/Optional.h" |
Chandler Carruth | 7c58254 | 2014-03-06 00:22:29 +0000 | [diff] [blame] | 24 | #include "llvm/IR/DIBuilder.h" |
Chandler Carruth | 0654bac | 2014-03-06 00:46:56 +0000 | [diff] [blame] | 25 | #include "llvm/IR/DebugInfo.h" |
Chandler Carruth | 61743af | 2014-03-04 11:18:19 +0000 | [diff] [blame] | 26 | #include "llvm/IR/ValueHandle.h" |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 27 | #include "llvm/Support/Allocator.h" |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 28 | |
| 29 | namespace llvm { |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 30 | class MDNode; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 31 | } |
| 32 | |
| 33 | namespace clang { |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 34 | class CXXMethodDecl; |
| 35 | class VarDecl; |
| 36 | class ObjCInterfaceDecl; |
| 37 | class ObjCIvarDecl; |
| 38 | class ClassTemplateSpecializationDecl; |
| 39 | class GlobalDecl; |
| 40 | class UsingDecl; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 41 | |
| 42 | namespace CodeGen { |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 43 | class CodeGenModule; |
| 44 | class CodeGenFunction; |
| 45 | class CGBlockInfo; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 46 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 47 | /// This class gathers all debug information during compilation and is |
| 48 | /// responsible for emitting to llvm globals or pass directly to the |
| 49 | /// backend. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 50 | class CGDebugInfo { |
Adrian Prantl | 39428e7 | 2015-02-03 18:40:42 +0000 | [diff] [blame] | 51 | friend class ApplyDebugLocation; |
Adrian Prantl | d1b151e | 2014-01-17 00:15:10 +0000 | [diff] [blame] | 52 | friend class SaveAndRestoreLocation; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 53 | CodeGenModule &CGM; |
Eric Christopher | cbf5701 | 2013-05-20 19:59:06 +0000 | [diff] [blame] | 54 | const CodeGenOptions::DebugInfoKind DebugKind; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 55 | llvm::DIBuilder DBuilder; |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 56 | llvm::DICompileUnit *TheCU = nullptr; |
David Blaikie | 66e4197 | 2015-01-14 07:38:27 +0000 | [diff] [blame] | 57 | SourceLocation CurLoc; |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 58 | llvm::DIType *VTablePtrType = nullptr; |
| 59 | llvm::DIType *ClassTy = nullptr; |
| 60 | llvm::DICompositeType *ObjTy = nullptr; |
| 61 | llvm::DIType *SelTy = nullptr; |
| 62 | llvm::DIType *OCLImage1dDITy = nullptr; |
| 63 | llvm::DIType *OCLImage1dArrayDITy = nullptr; |
| 64 | llvm::DIType *OCLImage1dBufferDITy = nullptr; |
| 65 | llvm::DIType *OCLImage2dDITy = nullptr; |
| 66 | llvm::DIType *OCLImage2dArrayDITy = nullptr; |
| 67 | llvm::DIType *OCLImage3dDITy = nullptr; |
| 68 | llvm::DIType *OCLEventDITy = nullptr; |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 69 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 70 | /// Cache of previously constructed Types. |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 71 | llvm::DenseMap<const void *, llvm::TrackingMDRef> TypeCache; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 72 | |
David Blaikie | ef8a951 | 2014-05-05 23:23:53 +0000 | [diff] [blame] | 73 | struct ObjCInterfaceCacheEntry { |
| 74 | const ObjCInterfaceType *Type; |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 75 | llvm::DIType *Decl; |
| 76 | llvm::DIFile *Unit; |
| 77 | ObjCInterfaceCacheEntry(const ObjCInterfaceType *Type, llvm::DIType *Decl, |
| 78 | llvm::DIFile *Unit) |
David Blaikie | ef8a951 | 2014-05-05 23:23:53 +0000 | [diff] [blame] | 79 | : Type(Type), Decl(Decl), Unit(Unit) {} |
| 80 | }; |
| 81 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 82 | /// Cache of previously constructed interfaces which may change. |
David Blaikie | ef8a951 | 2014-05-05 23:23:53 +0000 | [diff] [blame] | 83 | llvm::SmallVector<ObjCInterfaceCacheEntry, 32> ObjCInterfaceCache; |
Adrian Prantl | a03a85a | 2013-03-06 22:03:30 +0000 | [diff] [blame] | 84 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 85 | /// Cache of references to AST files such as PCHs or modules. |
Adrian Prantl | c4bb47e | 2015-06-30 17:39:51 +0000 | [diff] [blame] | 86 | llvm::DenseMap<uint64_t, llvm::DIModule *> ModuleRefCache; |
| 87 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 88 | /// List of interfaces we want to keep even if orphaned. |
Adrian Prantl | 73409ce | 2013-03-11 18:33:46 +0000 | [diff] [blame] | 89 | std::vector<void *> RetainedTypes; |
| 90 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 91 | /// Cache of forward declared types to RAUW at the end of |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 92 | /// compilation. |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 93 | std::vector<std::pair<const TagType *, llvm::TrackingMDRef>> ReplaceMap; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 94 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 95 | /// Cache of replaceable forward declarartions (functions and |
Frederic Riss | d253ed6 | 2014-11-18 03:40:51 +0000 | [diff] [blame] | 96 | /// variables) to RAUW at the end of compilation. |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 97 | std::vector<std::pair<const DeclaratorDecl *, llvm::TrackingMDRef>> |
| 98 | FwdDeclReplaceMap; |
Frederic Riss | d253ed6 | 2014-11-18 03:40:51 +0000 | [diff] [blame] | 99 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 100 | /// Keep track of our current nested lexical block. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 101 | std::vector<llvm::TypedTrackingMDRef<llvm::DIScope>> LexicalBlockStack; |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 102 | llvm::DenseMap<const Decl *, llvm::TrackingMDRef> RegionMap; |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 103 | /// Keep track of LexicalBlockStack counter at the beginning of a |
| 104 | /// function. This is used to pop unbalanced regions at the end of a |
| 105 | /// function. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 106 | std::vector<unsigned> FnBeginRegionCount; |
| 107 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 108 | /// This is a storage for names that are constructed on demand. For |
| 109 | /// example, C++ destructors, C++ operators etc.. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 110 | llvm::BumpPtrAllocator DebugInfoNames; |
| 111 | StringRef CWDName; |
| 112 | |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 113 | llvm::DenseMap<const char *, llvm::TrackingMDRef> DIFileCache; |
| 114 | llvm::DenseMap<const FunctionDecl *, llvm::TrackingMDRef> SPCache; |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 115 | /// Cache declarations relevant to DW_TAG_imported_declarations (C++ |
David Blaikie | bd48376 | 2013-05-20 04:58:53 +0000 | [diff] [blame] | 116 | /// using declarations) that aren't covered by other more specific caches. |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 117 | llvm::DenseMap<const Decl *, llvm::TrackingMDRef> DeclCache; |
| 118 | llvm::DenseMap<const NamespaceDecl *, llvm::TrackingMDRef> NameSpaceCache; |
| 119 | llvm::DenseMap<const NamespaceAliasDecl *, llvm::TrackingMDRef> |
| 120 | NamespaceAliasCache; |
Duncan P. N. Exon Smith | ac346ba | 2015-07-24 18:05:58 +0000 | [diff] [blame] | 121 | llvm::DenseMap<const Decl *, llvm::TypedTrackingMDRef<llvm::DIDerivedType>> |
| 122 | StaticDataMemberCache; |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 123 | |
| 124 | /// Helper functions for getOrCreateType. |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 125 | /// @{ |
| 126 | /// Currently the checksum of an interface includes the number of |
| 127 | /// ivars and property accessors. |
Adrian Prantl | a03a85a | 2013-03-06 22:03:30 +0000 | [diff] [blame] | 128 | unsigned Checksum(const ObjCInterfaceDecl *InterfaceDecl); |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 129 | llvm::DIType *CreateType(const BuiltinType *Ty); |
| 130 | llvm::DIType *CreateType(const ComplexType *Ty); |
| 131 | llvm::DIType *CreateQualifiedType(QualType Ty, llvm::DIFile *Fg); |
| 132 | llvm::DIType *CreateType(const TypedefType *Ty, llvm::DIFile *Fg); |
| 133 | llvm::DIType *CreateType(const TemplateSpecializationType *Ty, |
| 134 | llvm::DIFile *Fg); |
| 135 | llvm::DIType *CreateType(const ObjCObjectPointerType *Ty, llvm::DIFile *F); |
| 136 | llvm::DIType *CreateType(const PointerType *Ty, llvm::DIFile *F); |
| 137 | llvm::DIType *CreateType(const BlockPointerType *Ty, llvm::DIFile *F); |
| 138 | llvm::DIType *CreateType(const FunctionType *Ty, llvm::DIFile *F); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 139 | /// Get structure or union type. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 140 | llvm::DIType *CreateType(const RecordType *Tyg); |
| 141 | llvm::DIType *CreateTypeDefinition(const RecordType *Ty); |
| 142 | llvm::DICompositeType *CreateLimitedType(const RecordType *Ty); |
Duncan P. N. Exon Smith | 4078ad4 | 2015-04-16 16:36:45 +0000 | [diff] [blame] | 143 | void CollectContainingType(const CXXRecordDecl *RD, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 144 | llvm::DICompositeType *CT); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 145 | /// Get Objective-C interface type. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 146 | llvm::DIType *CreateType(const ObjCInterfaceType *Ty, llvm::DIFile *F); |
| 147 | llvm::DIType *CreateTypeDefinition(const ObjCInterfaceType *Ty, |
| 148 | llvm::DIFile *F); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 149 | /// Get Objective-C object type. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 150 | llvm::DIType *CreateType(const ObjCObjectType *Ty, llvm::DIFile *F); |
| 151 | llvm::DIType *CreateType(const VectorType *Ty, llvm::DIFile *F); |
| 152 | llvm::DIType *CreateType(const ArrayType *Ty, llvm::DIFile *F); |
| 153 | llvm::DIType *CreateType(const LValueReferenceType *Ty, llvm::DIFile *F); |
| 154 | llvm::DIType *CreateType(const RValueReferenceType *Ty, llvm::DIFile *Unit); |
| 155 | llvm::DIType *CreateType(const MemberPointerType *Ty, llvm::DIFile *F); |
| 156 | llvm::DIType *CreateType(const AtomicType *Ty, llvm::DIFile *F); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 157 | /// Get enumeration type. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 158 | llvm::DIType *CreateEnumType(const EnumType *Ty); |
| 159 | llvm::DIType *CreateTypeDefinition(const EnumType *Ty); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 160 | /// Look up the completed type for a self pointer in the TypeCache and |
| 161 | /// create a copy of it with the ObjectPointer and Artificial flags |
| 162 | /// set. If the type is not cached, a new one is created. This should |
| 163 | /// never happen though, since creating a type for the implicit self |
| 164 | /// argument implies that we already parsed the interface definition |
| 165 | /// and the ivar declarations in the implementation. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 166 | llvm::DIType *CreateSelfType(const QualType &QualTy, llvm::DIType *Ty); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 167 | /// @} |
| 168 | |
| 169 | /// Get the type from the cache or return null type if it doesn't |
| 170 | /// exist. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 171 | llvm::DIType *getTypeOrNull(const QualType); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 172 | /// Return the debug type for a C++ method. |
| 173 | /// \arg CXXMethodDecl is of FunctionType. This function type is |
| 174 | /// not updated to include implicit \c this pointer. Use this routine |
| 175 | /// to get a method type which includes \c this pointer. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 176 | llvm::DISubroutineType *getOrCreateMethodType(const CXXMethodDecl *Method, |
| 177 | llvm::DIFile *F); |
| 178 | llvm::DISubroutineType * |
Duncan P. N. Exon Smith | 4078ad4 | 2015-04-16 16:36:45 +0000 | [diff] [blame] | 179 | getOrCreateInstanceMethodType(QualType ThisPtr, const FunctionProtoType *Func, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 180 | llvm::DIFile *Unit); |
| 181 | llvm::DISubroutineType * |
| 182 | getOrCreateFunctionType(const Decl *D, QualType FnType, llvm::DIFile *F); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 183 | /// \return debug info descriptor for vtable. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 184 | llvm::DIType *getOrCreateVTablePtrType(llvm::DIFile *F); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 185 | /// \return namespace descriptor for the given namespace decl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 186 | llvm::DINamespace *getOrCreateNameSpace(const NamespaceDecl *N); |
| 187 | llvm::DIType *getOrCreateTypeDeclaration(QualType PointeeTy, llvm::DIFile *F); |
| 188 | llvm::DIType *CreatePointerLikeType(llvm::dwarf::Tag Tag, const Type *Ty, |
| 189 | QualType PointeeTy, llvm::DIFile *F); |
Guy Benyei | d8a08ea | 2012-12-18 14:38:23 +0000 | [diff] [blame] | 190 | |
Adrian Prantl | 73409ce | 2013-03-11 18:33:46 +0000 | [diff] [blame] | 191 | llvm::Value *getCachedInterfaceTypeOrNull(const QualType Ty); |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 192 | llvm::DIType *getOrCreateStructPtrType(StringRef Name, llvm::DIType *&Cache); |
Guy Benyei | d8a08ea | 2012-12-18 14:38:23 +0000 | [diff] [blame] | 193 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 194 | /// A helper function to create a subprogram for a single member |
| 195 | /// function GlobalDecl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 196 | llvm::DISubprogram *CreateCXXMemberFunction(const CXXMethodDecl *Method, |
| 197 | llvm::DIFile *F, |
| 198 | llvm::DIType *RecordTy); |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 199 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 200 | /// A helper function to collect debug info for C++ member |
| 201 | /// functions. This is used while creating debug info entry for a |
| 202 | /// Record. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 203 | void CollectCXXMemberFunctions(const CXXRecordDecl *Decl, llvm::DIFile *F, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 204 | SmallVectorImpl<llvm::Metadata *> &E, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 205 | llvm::DIType *T); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 206 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 207 | /// A helper function to collect debug info for C++ base |
| 208 | /// classes. This is used while creating debug info entry for a |
| 209 | /// Record. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 210 | void CollectCXXBases(const CXXRecordDecl *Decl, llvm::DIFile *F, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 211 | SmallVectorImpl<llvm::Metadata *> &EltTys, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 212 | llvm::DIType *RecordTy); |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 213 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 214 | /// A helper function to collect template parameters. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 215 | llvm::DINodeArray CollectTemplateParams(const TemplateParameterList *TPList, |
| 216 | ArrayRef<TemplateArgument> TAList, |
| 217 | llvm::DIFile *Unit); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 218 | /// A helper function to collect debug info for function template |
| 219 | /// parameters. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 220 | llvm::DINodeArray CollectFunctionTemplateParams(const FunctionDecl *FD, |
| 221 | llvm::DIFile *Unit); |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 222 | |
| 223 | /// A helper function to collect debug info for template |
| 224 | /// parameters. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 225 | llvm::DINodeArray |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 226 | CollectCXXTemplateParams(const ClassTemplateSpecializationDecl *TS, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 227 | llvm::DIFile *F); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 228 | |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 229 | llvm::DIType *createFieldType(StringRef name, QualType type, |
Duncan P. N. Exon Smith | 0b6c369 | 2015-04-20 18:51:48 +0000 | [diff] [blame] | 230 | uint64_t sizeInBitsOverride, SourceLocation loc, |
| 231 | AccessSpecifier AS, uint64_t offsetInBits, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 232 | llvm::DIFile *tunit, llvm::DIScope *scope, |
Duncan P. N. Exon Smith | 0b6c369 | 2015-04-20 18:51:48 +0000 | [diff] [blame] | 233 | const RecordDecl *RD = nullptr); |
Eric Christopher | 91a3190 | 2013-01-16 01:22:32 +0000 | [diff] [blame] | 234 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 235 | /// Helpers for collecting fields of a record. |
| 236 | /// @{ |
Eric Christopher | 91a3190 | 2013-01-16 01:22:32 +0000 | [diff] [blame] | 237 | void CollectRecordLambdaFields(const CXXRecordDecl *CXXDecl, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 238 | SmallVectorImpl<llvm::Metadata *> &E, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 239 | llvm::DIType *RecordTy); |
| 240 | llvm::DIDerivedType *CreateRecordStaticField(const VarDecl *Var, |
| 241 | llvm::DIType *RecordTy, |
Duncan P. N. Exon Smith | c09c548 | 2015-04-20 21:17:26 +0000 | [diff] [blame] | 242 | const RecordDecl *RD); |
Eric Christopher | 91a3190 | 2013-01-16 01:22:32 +0000 | [diff] [blame] | 243 | void CollectRecordNormalField(const FieldDecl *Field, uint64_t OffsetInBits, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 244 | llvm::DIFile *F, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 245 | SmallVectorImpl<llvm::Metadata *> &E, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 246 | llvm::DIType *RecordTy, const RecordDecl *RD); |
| 247 | void CollectRecordFields(const RecordDecl *Decl, llvm::DIFile *F, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 248 | SmallVectorImpl<llvm::Metadata *> &E, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 249 | llvm::DICompositeType *RecordTy); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 250 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 251 | /// If the C++ class has vtable info then insert appropriate debug |
| 252 | /// info entry in EltTys vector. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 253 | void CollectVTableInfo(const CXXRecordDecl *Decl, llvm::DIFile *F, |
Duncan P. N. Exon Smith | fb49491 | 2014-12-09 18:39:32 +0000 | [diff] [blame] | 254 | SmallVectorImpl<llvm::Metadata *> &EltTys); |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 255 | /// @} |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 256 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 257 | /// Create a new lexical block node and push it on the stack. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 258 | void CreateLexicalBlock(SourceLocation Loc); |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 259 | |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 260 | public: |
| 261 | CGDebugInfo(CodeGenModule &CGM); |
| 262 | ~CGDebugInfo(); |
| 263 | |
| 264 | void finalize(); |
| 265 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 266 | /// Update the current source location. If \arg loc is invalid it is |
| 267 | /// ignored. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 268 | void setLocation(SourceLocation Loc); |
| 269 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 270 | /// Emit metadata to indicate a change in line/column information in |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 271 | /// the source file. If the location is invalid, the previous |
| 272 | /// location will be reused. |
David Blaikie | 835afb2 | 2015-01-21 23:08:17 +0000 | [diff] [blame] | 273 | void EmitLocation(CGBuilderTy &Builder, SourceLocation Loc); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 274 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 275 | /// Emit a call to llvm.dbg.function.start to indicate |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 276 | /// start of a new function. |
Adrian Prantl | 42d71b9 | 2014-04-10 23:21:53 +0000 | [diff] [blame] | 277 | /// \param Loc The location of the function header. |
| 278 | /// \param ScopeLoc The location of the function body. |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 279 | void EmitFunctionStart(GlobalDecl GD, SourceLocation Loc, |
| 280 | SourceLocation ScopeLoc, QualType FnType, |
| 281 | llvm::Function *Fn, CGBuilderTy &Builder); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 282 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 283 | /// Constructs the debug code for exiting a function. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 284 | void EmitFunctionEnd(CGBuilderTy &Builder); |
| 285 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 286 | /// Emit metadata to indicate the beginning of a new lexical block |
| 287 | /// and push the block onto the stack. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 288 | void EmitLexicalBlockStart(CGBuilderTy &Builder, SourceLocation Loc); |
| 289 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 290 | /// Emit metadata to indicate the end of a new lexical block and pop |
| 291 | /// the current block. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 292 | void EmitLexicalBlockEnd(CGBuilderTy &Builder, SourceLocation Loc); |
| 293 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 294 | /// Emit call to \c llvm.dbg.declare for an automatic variable |
| 295 | /// declaration. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 296 | void EmitDeclareOfAutoVariable(const VarDecl *Decl, llvm::Value *AI, |
| 297 | CGBuilderTy &Builder); |
| 298 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 299 | /// Emit call to \c llvm.dbg.declare for an imported variable |
| 300 | /// declaration in a block. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 301 | void EmitDeclareOfBlockDeclRefVariable(const VarDecl *variable, |
| 302 | llvm::Value *storage, |
| 303 | CGBuilderTy &Builder, |
Adrian Prantl | 88eec39 | 2014-11-21 00:35:25 +0000 | [diff] [blame] | 304 | const CGBlockInfo &blockInfo, |
| 305 | llvm::Instruction *InsertPoint = 0); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 306 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 307 | /// Emit call to \c llvm.dbg.declare for an argument variable |
| 308 | /// declaration. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 309 | void EmitDeclareOfArgVariable(const VarDecl *Decl, llvm::Value *AI, |
| 310 | unsigned ArgNo, CGBuilderTy &Builder); |
| 311 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 312 | /// Emit call to \c llvm.dbg.declare for the block-literal argument |
| 313 | /// to a block invocation function. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 314 | void EmitDeclareOfBlockLiteralArgVariable(const CGBlockInfo &block, |
David Blaikie | 77bbb5f | 2014-08-08 17:10:14 +0000 | [diff] [blame] | 315 | llvm::Value *Arg, unsigned ArgNo, |
Adrian Prantl | 51936dd | 2013-03-14 17:53:33 +0000 | [diff] [blame] | 316 | llvm::Value *LocalAddr, |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 317 | CGBuilderTy &Builder); |
| 318 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 319 | /// Emit information about a global variable. |
Yunzhong Gao | 0ebf1bb | 2013-08-30 08:53:09 +0000 | [diff] [blame] | 320 | void EmitGlobalVariable(llvm::GlobalVariable *GV, const VarDecl *Decl); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 321 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 322 | /// Emit global variable's debug info. |
Yunzhong Gao | 0ebf1bb | 2013-08-30 08:53:09 +0000 | [diff] [blame] | 323 | void EmitGlobalVariable(const ValueDecl *VD, llvm::Constant *Init); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 324 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 325 | /// Emit C++ using directive. |
David Blaikie | 9f88fe8 | 2013-04-22 06:13:21 +0000 | [diff] [blame] | 326 | void EmitUsingDirective(const UsingDirectiveDecl &UD); |
| 327 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 328 | /// Emit the type explicitly casted to. |
David Blaikie | 66088d5 | 2014-09-24 17:01:27 +0000 | [diff] [blame] | 329 | void EmitExplicitCastType(QualType Ty); |
| 330 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 331 | /// Emit C++ using declaration. |
David Blaikie | bd48376 | 2013-05-20 04:58:53 +0000 | [diff] [blame] | 332 | void EmitUsingDecl(const UsingDecl &UD); |
| 333 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 334 | /// Emit an @import declaration. |
Adrian Prantl | c4bb47e | 2015-06-30 17:39:51 +0000 | [diff] [blame] | 335 | void EmitImportDecl(const ImportDecl &ID); |
| 336 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 337 | /// Emit C++ namespace alias. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 338 | llvm::DIImportedEntity *EmitNamespaceAlias(const NamespaceAliasDecl &NA); |
David Blaikie | f121b93 | 2013-05-20 22:50:41 +0000 | [diff] [blame] | 339 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 340 | /// Emit record type's standalone debug info. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 341 | llvm::DIType *getOrCreateRecordType(QualType Ty, SourceLocation L); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 342 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 343 | /// Emit an Objective-C interface type standalone debug info. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 344 | llvm::DIType *getOrCreateInterfaceType(QualType Ty, SourceLocation Loc); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 345 | |
David Blaikie | 483a9da | 2014-05-06 18:35:21 +0000 | [diff] [blame] | 346 | void completeType(const EnumDecl *ED); |
David Blaikie | b2e86eb | 2013-08-15 20:49:17 +0000 | [diff] [blame] | 347 | void completeType(const RecordDecl *RD); |
| 348 | void completeRequiredType(const RecordDecl *RD); |
David Blaikie | 6943dea | 2013-08-20 01:28:15 +0000 | [diff] [blame] | 349 | void completeClassData(const RecordDecl *RD); |
David Blaikie | b8f2fbb | 2013-06-21 00:40:50 +0000 | [diff] [blame] | 350 | |
David Blaikie | 0e716b4 | 2014-03-03 23:48:23 +0000 | [diff] [blame] | 351 | void completeTemplateDefinition(const ClassTemplateSpecializationDecl &SD); |
| 352 | |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 353 | private: |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 354 | /// Emit call to llvm.dbg.declare for a variable declaration. |
Duncan P. N. Exon Smith | e430654 | 2015-07-31 17:56:14 +0000 | [diff] [blame] | 355 | void EmitDeclare(const VarDecl *decl, llvm::Value *AI, |
| 356 | llvm::Optional<unsigned> ArgNo, CGBuilderTy &Builder); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 357 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 358 | /// Build up structure info for the byref. See \a BuildByRefType. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 359 | llvm::DIType *EmitTypeForVarWithBlocksAttr(const VarDecl *VD, |
Duncan P. N. Exon Smith | 0b6c369 | 2015-04-20 18:51:48 +0000 | [diff] [blame] | 360 | uint64_t *OffSet); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 361 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 362 | /// Get context info for the decl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 363 | llvm::DIScope *getContextDescriptor(const Decl *Decl); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 364 | |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 365 | llvm::DIScope *getCurrentContextDescriptor(const Decl *Decl); |
David Blaikie | bd48376 | 2013-05-20 04:58:53 +0000 | [diff] [blame] | 366 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 367 | /// Create a forward decl for a RecordType in a given context. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 368 | llvm::DICompositeType *getOrCreateRecordFwdDecl(const RecordType *, |
| 369 | llvm::DIScope *); |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 370 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 371 | /// Return current directory name. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 372 | StringRef getCurrentDirname(); |
| 373 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 374 | /// Create new compile unit. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 375 | void CreateCompileUnit(); |
| 376 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 377 | /// Get the file debug info descriptor for the input location. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 378 | llvm::DIFile *getOrCreateFile(SourceLocation Loc); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 379 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 380 | /// Get the file info for main compile unit. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 381 | llvm::DIFile *getOrCreateMainFile(); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 382 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 383 | /// Get the type from the cache or create a new type if necessary. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 384 | llvm::DIType *getOrCreateType(QualType Ty, llvm::DIFile *Fg); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 385 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 386 | /// Get a reference to a clang module. |
Adrian Prantl | c4bb47e | 2015-06-30 17:39:51 +0000 | [diff] [blame] | 387 | llvm::DIModule * |
| 388 | getOrCreateModuleRef(ExternalASTSource::ASTSourceDescriptor Mod); |
| 389 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 390 | /// Get the type from the cache or create a new partial type if |
| 391 | /// necessary. |
Duncan P. N. Exon Smith | bd210e6 | 2015-07-24 20:34:41 +0000 | [diff] [blame] | 392 | llvm::DICompositeType *getOrCreateLimitedType(const RecordType *Ty, |
| 393 | llvm::DIFile *F); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 394 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 395 | /// Create type metadata for a source language type. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 396 | llvm::DIType *CreateTypeNode(QualType Ty, llvm::DIFile *Fg); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 397 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 398 | /// Return the underlying ObjCInterfaceDecl if \arg Ty is an |
| 399 | /// ObjCInterface or a pointer to one. |
| 400 | ObjCInterfaceDecl *getObjCInterfaceDecl(QualType Ty); |
Adrian Prantl | a03a85a | 2013-03-06 22:03:30 +0000 | [diff] [blame] | 401 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 402 | /// Create new member and increase Offset by FType's size. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 403 | llvm::DIType *CreateMemberType(llvm::DIFile *Unit, QualType FType, |
Duncan P. N. Exon Smith | 0b6c369 | 2015-04-20 18:51:48 +0000 | [diff] [blame] | 404 | StringRef Name, uint64_t *Offset); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 405 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 406 | /// Retrieve the DIDescriptor, if any, for the canonical form of this |
David Blaikie | bd48376 | 2013-05-20 04:58:53 +0000 | [diff] [blame] | 407 | /// declaration. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 408 | llvm::DINode *getDeclarationOrDefinition(const Decl *D); |
David Blaikie | bd48376 | 2013-05-20 04:58:53 +0000 | [diff] [blame] | 409 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 410 | /// \return debug info descriptor to describe method |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 411 | /// declaration for the given method definition. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 412 | llvm::DISubprogram *getFunctionDeclaration(const Decl *D); |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 413 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 414 | /// \return debug info descriptor to describe in-class static data |
| 415 | /// member declaration for the given out-of-class definition. If D |
| 416 | /// is an out-of-class definition of a static data member of a |
| 417 | /// class, find its corresponding in-class declaration. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 418 | llvm::DIDerivedType * |
David Blaikie | 6943dea | 2013-08-20 01:28:15 +0000 | [diff] [blame] | 419 | getOrCreateStaticDataMemberDeclarationOrNull(const VarDecl *D); |
Eric Christopher | 91a3190 | 2013-01-16 01:22:32 +0000 | [diff] [blame] | 420 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 421 | /// Create a subprogram describing the forward declaration |
| 422 | /// represented in the given FunctionDecl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 423 | llvm::DISubprogram *getFunctionForwardDeclaration(const FunctionDecl *FD); |
Frederic Riss | d253ed6 | 2014-11-18 03:40:51 +0000 | [diff] [blame] | 424 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 425 | /// Create a global variable describing the forward decalration |
Duncan P. N. Exon Smith | dadc2b6 | 2015-04-21 18:43:54 +0000 | [diff] [blame] | 426 | /// represented in the given VarDecl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 427 | llvm::DIGlobalVariable * |
Duncan P. N. Exon Smith | dadc2b6 | 2015-04-21 18:43:54 +0000 | [diff] [blame] | 428 | getGlobalVariableForwardDeclaration(const VarDecl *VD); |
Frederic Riss | d253ed6 | 2014-11-18 03:40:51 +0000 | [diff] [blame] | 429 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 430 | /// \brief Return a global variable that represents one of the |
| 431 | /// collection of global variables created for an anonmyous union. |
| 432 | /// |
| 433 | /// Recursively collect all of the member fields of a global |
| 434 | /// anonymous decl and create static variables for them. The first |
| 435 | /// time this is called it needs to be on a union and then from |
| 436 | /// there we can have additional unnamed fields. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 437 | llvm::DIGlobalVariable * |
| 438 | CollectAnonRecordDecls(const RecordDecl *RD, llvm::DIFile *Unit, |
Duncan P. N. Exon Smith | 4078ad4 | 2015-04-16 16:36:45 +0000 | [diff] [blame] | 439 | unsigned LineNo, StringRef LinkageName, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 440 | llvm::GlobalVariable *Var, llvm::DIScope *DContext); |
Eric Christopher | cab9fae | 2014-04-10 05:20:00 +0000 | [diff] [blame] | 441 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 442 | /// Get function name for the given FunctionDecl. If the name is |
| 443 | /// constructed on demand (e.g., C++ destructor) then the name is |
| 444 | /// stored on the side. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 445 | StringRef getFunctionName(const FunctionDecl *FD); |
| 446 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 447 | /// Returns the unmangled name of an Objective-C method. |
Eric Christopher | d78d4c9 | 2013-05-16 00:52:23 +0000 | [diff] [blame] | 448 | /// This is the display name for the debugging info. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 449 | StringRef getObjCMethodName(const ObjCMethodDecl *FD); |
| 450 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 451 | /// Return selector name. This is used for debugging |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 452 | /// info. |
| 453 | StringRef getSelectorName(Selector S); |
| 454 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 455 | /// Get class name including template argument list. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 456 | StringRef getClassName(const RecordDecl *RD); |
| 457 | |
Adrian Prantl | 3e8bad4 | 2015-07-08 21:18:34 +0000 | [diff] [blame] | 458 | /// Get the vtable name for the given class. |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 459 | StringRef getVTableName(const CXXRecordDecl *Decl); |
| 460 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 461 | /// Get line number for the location. If location is invalid |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 462 | /// then use current location. |
| 463 | unsigned getLineNumber(SourceLocation Loc); |
| 464 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 465 | /// Get column number for the location. If location is |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 466 | /// invalid then use current location. |
Adrian Prantl | c782242 | 2013-03-12 20:43:25 +0000 | [diff] [blame] | 467 | /// \param Force Assume DebugColumnInfo option is true. |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 468 | unsigned getColumnNumber(SourceLocation Loc, bool Force = false); |
Benjamin Kramer | 1b18a5e | 2013-09-09 16:39:06 +0000 | [diff] [blame] | 469 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 470 | /// Collect various properties of a FunctionDecl. |
Frederic Riss | 9db79f1 | 2014-11-18 03:40:46 +0000 | [diff] [blame] | 471 | /// \param GD A GlobalDecl whose getDecl() must return a FunctionDecl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 472 | void collectFunctionDeclProps(GlobalDecl GD, llvm::DIFile *Unit, |
Frederic Riss | 9db79f1 | 2014-11-18 03:40:46 +0000 | [diff] [blame] | 473 | StringRef &Name, StringRef &LinkageName, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 474 | llvm::DIScope *&FDContext, |
| 475 | llvm::DINodeArray &TParamsArray, |
Duncan P. N. Exon Smith | 8e47da4 | 2015-04-21 20:07:29 +0000 | [diff] [blame] | 476 | unsigned &Flags); |
Frederic Riss | 9db79f1 | 2014-11-18 03:40:46 +0000 | [diff] [blame] | 477 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 478 | /// Collect various properties of a VarDecl. |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 479 | void collectVarDeclProps(const VarDecl *VD, llvm::DIFile *&Unit, |
Duncan P. N. Exon Smith | 4078ad4 | 2015-04-16 16:36:45 +0000 | [diff] [blame] | 480 | unsigned &LineNo, QualType &T, StringRef &Name, |
Duncan P. N. Exon Smith | 9dd4e4e | 2015-04-29 16:40:08 +0000 | [diff] [blame] | 481 | StringRef &LinkageName, llvm::DIScope *&VDContext); |
Frederic Riss | 9db79f1 | 2014-11-18 03:40:46 +0000 | [diff] [blame] | 482 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 483 | /// Allocate a copy of \p A using the DebugInfoNames allocator |
Benjamin Kramer | 1b18a5e | 2013-09-09 16:39:06 +0000 | [diff] [blame] | 484 | /// and return a reference to it. If multiple arguments are given the strings |
| 485 | /// are concatenated. |
| 486 | StringRef internString(StringRef A, StringRef B = StringRef()) { |
| 487 | char *Data = DebugInfoNames.Allocate<char>(A.size() + B.size()); |
Chandler Carruth | a91ba12 | 2015-08-04 03:53:00 +0000 | [diff] [blame^] | 488 | if (!A.empty()) |
| 489 | std::memcpy(Data, A.data(), A.size()); |
| 490 | if (!B.empty()) |
| 491 | std::memcpy(Data + A.size(), B.data(), B.size()); |
Benjamin Kramer | 1b18a5e | 2013-09-09 16:39:06 +0000 | [diff] [blame] | 492 | return StringRef(Data, A.size() + B.size()); |
| 493 | } |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 494 | }; |
Adrian Prantl | 2e0637f | 2013-07-18 00:28:02 +0000 | [diff] [blame] | 495 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 496 | /// A scoped helper to set the current debug location to the specified |
Adrian Prantl | 6693d08 | 2015-02-03 18:40:38 +0000 | [diff] [blame] | 497 | /// location or preferred location of the specified Expr. |
David Blaikie | 66e4197 | 2015-01-14 07:38:27 +0000 | [diff] [blame] | 498 | class ApplyDebugLocation { |
David Blaikie | 9b47966 | 2015-01-25 01:19:10 +0000 | [diff] [blame] | 499 | private: |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 500 | void init(SourceLocation TemporaryLocation, bool DefaultToEmpty = false); |
| 501 | ApplyDebugLocation(CodeGenFunction &CGF, bool DefaultToEmpty, |
| 502 | SourceLocation TemporaryLocation); |
David Blaikie | 9b47966 | 2015-01-25 01:19:10 +0000 | [diff] [blame] | 503 | |
David Blaikie | 66e4197 | 2015-01-14 07:38:27 +0000 | [diff] [blame] | 504 | llvm::DebugLoc OriginalLocation; |
| 505 | CodeGenFunction &CGF; |
Adrian Prantl | 39428e7 | 2015-02-03 18:40:42 +0000 | [diff] [blame] | 506 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 507 | public: |
| 508 | /// Set the location to the (valid) TemporaryLocation. |
Adrian Prantl | 39428e7 | 2015-02-03 18:40:42 +0000 | [diff] [blame] | 509 | ApplyDebugLocation(CodeGenFunction &CGF, SourceLocation TemporaryLocation); |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 510 | ApplyDebugLocation(CodeGenFunction &CGF, const Expr *E); |
| 511 | ApplyDebugLocation(CodeGenFunction &CGF, llvm::DebugLoc Loc); |
| 512 | |
| 513 | ~ApplyDebugLocation(); |
| 514 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 515 | /// \brief Apply TemporaryLocation if it is valid. Otherwise switch |
| 516 | /// to an artificial debug location that has a valid scope, but no |
| 517 | /// line information. |
Adrian Prantl | 39428e7 | 2015-02-03 18:40:42 +0000 | [diff] [blame] | 518 | /// |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 519 | /// Artificial locations are useful when emitting compiler-generated |
| 520 | /// helper functions that have no source location associated with |
| 521 | /// them. The DWARF specification allows the compiler to use the |
| 522 | /// special line number 0 to indicate code that can not be |
| 523 | /// attributed to any source location. Note that passing an empty |
| 524 | /// SourceLocation to CGDebugInfo::setLocation() will result in the |
| 525 | /// last valid location being reused. |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 526 | static ApplyDebugLocation CreateArtificial(CodeGenFunction &CGF) { |
| 527 | return ApplyDebugLocation(CGF, false, SourceLocation()); |
| 528 | } |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 529 | /// \brief Apply TemporaryLocation if it is valid. Otherwise switch |
| 530 | /// to an artificial debug location that has a valid scope, but no |
| 531 | /// line information. |
| 532 | static ApplyDebugLocation |
| 533 | CreateDefaultArtificial(CodeGenFunction &CGF, |
| 534 | SourceLocation TemporaryLocation) { |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 535 | return ApplyDebugLocation(CGF, false, TemporaryLocation); |
| 536 | } |
| 537 | |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 538 | /// Set the IRBuilder to not attach debug locations. Note that |
| 539 | /// passing an empty SourceLocation to \a CGDebugInfo::setLocation() |
| 540 | /// will result in the last valid location being reused. Note that |
| 541 | /// all instructions that do not have a location at the beginning of |
| 542 | /// a function are counted towards to funciton prologue. |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 543 | static ApplyDebugLocation CreateEmpty(CodeGenFunction &CGF) { |
| 544 | return ApplyDebugLocation(CGF, true, SourceLocation()); |
| 545 | } |
| 546 | |
| 547 | /// \brief Apply TemporaryLocation if it is valid. Otherwise set the IRBuilder |
| 548 | /// to not attach debug locations. |
Adrian Prantl | 8f0bd5a | 2015-07-08 20:53:55 +0000 | [diff] [blame] | 549 | static ApplyDebugLocation |
| 550 | CreateDefaultEmpty(CodeGenFunction &CGF, SourceLocation TemporaryLocation) { |
Adrian Prantl | 95b24e9 | 2015-02-03 20:00:54 +0000 | [diff] [blame] | 551 | return ApplyDebugLocation(CGF, true, TemporaryLocation); |
| 552 | } |
Adrian Prantl | 2e0637f | 2013-07-18 00:28:02 +0000 | [diff] [blame] | 553 | }; |
| 554 | |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 555 | } // namespace CodeGen |
| 556 | } // namespace clang |
| 557 | |
Guy Benyei | 11169dd | 2012-12-18 14:30:41 +0000 | [diff] [blame] | 558 | #endif |