1// Copyright 2009 The Go Authors. All rights reserved. 2// Use of this source code is governed by a BSD-style 3// license that can be found in the LICENSE file. 4 5// Constants 6 7package dwarf 8 9//go:generate stringer -type Attr -trimprefix=Attr 10 11// An Attr identifies the attribute type in a DWARF Entry's Field. 12type Attr uint32 13 14const ( 15 AttrSibling Attr = 0x01 16 AttrLocation Attr = 0x02 17 AttrName Attr = 0x03 18 AttrOrdering Attr = 0x09 19 AttrByteSize Attr = 0x0B 20 AttrBitOffset Attr = 0x0C 21 AttrBitSize Attr = 0x0D 22 AttrStmtList Attr = 0x10 23 AttrLowpc Attr = 0x11 24 AttrHighpc Attr = 0x12 25 AttrLanguage Attr = 0x13 26 AttrDiscr Attr = 0x15 27 AttrDiscrValue Attr = 0x16 28 AttrVisibility Attr = 0x17 29 AttrImport Attr = 0x18 30 AttrStringLength Attr = 0x19 31 AttrCommonRef Attr = 0x1A 32 AttrCompDir Attr = 0x1B 33 AttrConstValue Attr = 0x1C 34 AttrContainingType Attr = 0x1D 35 AttrDefaultValue Attr = 0x1E 36 AttrInline Attr = 0x20 37 AttrIsOptional Attr = 0x21 38 AttrLowerBound Attr = 0x22 39 AttrProducer Attr = 0x25 40 AttrPrototyped Attr = 0x27 41 AttrReturnAddr Attr = 0x2A 42 AttrStartScope Attr = 0x2C 43 AttrStrideSize Attr = 0x2E 44 AttrUpperBound Attr = 0x2F 45 AttrAbstractOrigin Attr = 0x31 46 AttrAccessibility Attr = 0x32 47 AttrAddrClass Attr = 0x33 48 AttrArtificial Attr = 0x34 49 AttrBaseTypes Attr = 0x35 50 AttrCalling Attr = 0x36 51 AttrCount Attr = 0x37 52 AttrDataMemberLoc Attr = 0x38 53 AttrDeclColumn Attr = 0x39 54 AttrDeclFile Attr = 0x3A 55 AttrDeclLine Attr = 0x3B 56 AttrDeclaration Attr = 0x3C 57 AttrDiscrList Attr = 0x3D 58 AttrEncoding Attr = 0x3E 59 AttrExternal Attr = 0x3F 60 AttrFrameBase Attr = 0x40 61 AttrFriend Attr = 0x41 62 AttrIdentifierCase Attr = 0x42 63 AttrMacroInfo Attr = 0x43 64 AttrNamelistItem Attr = 0x44 65 AttrPriority Attr = 0x45 66 AttrSegment Attr = 0x46 67 AttrSpecification Attr = 0x47 68 AttrStaticLink Attr = 0x48 69 AttrType Attr = 0x49 70 AttrUseLocation Attr = 0x4A 71 AttrVarParam Attr = 0x4B 72 AttrVirtuality Attr = 0x4C 73 AttrVtableElemLoc Attr = 0x4D 74 AttrAllocated Attr = 0x4E 75 AttrAssociated Attr = 0x4F 76 AttrDataLocation Attr = 0x50 77 AttrStride Attr = 0x51 78 AttrEntrypc Attr = 0x52 79 AttrUseUTF8 Attr = 0x53 80 AttrExtension Attr = 0x54 81 AttrRanges Attr = 0x55 82 AttrTrampoline Attr = 0x56 83 AttrCallColumn Attr = 0x57 84 AttrCallFile Attr = 0x58 85 AttrCallLine Attr = 0x59 86 AttrDescription Attr = 0x5A 87) 88 89func (a Attr) GoString() string { 90 if str, ok := _Attr_map[a]; ok { 91 return "dwarf.Attr" + str 92 } 93 return "dwarf." + a.String() 94} 95 96// A format is a DWARF data encoding format. 97type format uint32 98 99const ( 100 // value formats 101 formAddr format = 0x01 102 formDwarfBlock2 format = 0x03 103 formDwarfBlock4 format = 0x04 104 formData2 format = 0x05 105 formData4 format = 0x06 106 formData8 format = 0x07 107 formString format = 0x08 108 formDwarfBlock format = 0x09 109 formDwarfBlock1 format = 0x0A 110 formData1 format = 0x0B 111 formFlag format = 0x0C 112 formSdata format = 0x0D 113 formStrp format = 0x0E 114 formUdata format = 0x0F 115 formRefAddr format = 0x10 116 formRef1 format = 0x11 117 formRef2 format = 0x12 118 formRef4 format = 0x13 119 formRef8 format = 0x14 120 formRefUdata format = 0x15 121 formIndirect format = 0x16 122 // The following are new in DWARF 4. 123 formSecOffset format = 0x17 124 formExprloc format = 0x18 125 formFlagPresent format = 0x19 126 formRefSig8 format = 0x20 127 // Extensions for multi-file compression (.dwz) 128 // http://www.dwarfstd.org/ShowIssue.php?issue=120604.1 129 formGnuRefAlt format = 0x1f20 130 formGnuStrpAlt format = 0x1f21 131) 132 133//go:generate stringer -type Tag -trimprefix=Tag 134 135// A Tag is the classification (the type) of an Entry. 136type Tag uint32 137 138const ( 139 TagArrayType Tag = 0x01 140 TagClassType Tag = 0x02 141 TagEntryPoint Tag = 0x03 142 TagEnumerationType Tag = 0x04 143 TagFormalParameter Tag = 0x05 144 TagImportedDeclaration Tag = 0x08 145 TagLabel Tag = 0x0A 146 TagLexDwarfBlock Tag = 0x0B 147 TagMember Tag = 0x0D 148 TagPointerType Tag = 0x0F 149 TagReferenceType Tag = 0x10 150 TagCompileUnit Tag = 0x11 151 TagStringType Tag = 0x12 152 TagStructType Tag = 0x13 153 TagSubroutineType Tag = 0x15 154 TagTypedef Tag = 0x16 155 TagUnionType Tag = 0x17 156 TagUnspecifiedParameters Tag = 0x18 157 TagVariant Tag = 0x19 158 TagCommonDwarfBlock Tag = 0x1A 159 TagCommonInclusion Tag = 0x1B 160 TagInheritance Tag = 0x1C 161 TagInlinedSubroutine Tag = 0x1D 162 TagModule Tag = 0x1E 163 TagPtrToMemberType Tag = 0x1F 164 TagSetType Tag = 0x20 165 TagSubrangeType Tag = 0x21 166 TagWithStmt Tag = 0x22 167 TagAccessDeclaration Tag = 0x23 168 TagBaseType Tag = 0x24 169 TagCatchDwarfBlock Tag = 0x25 170 TagConstType Tag = 0x26 171 TagConstant Tag = 0x27 172 TagEnumerator Tag = 0x28 173 TagFileType Tag = 0x29 174 TagFriend Tag = 0x2A 175 TagNamelist Tag = 0x2B 176 TagNamelistItem Tag = 0x2C 177 TagPackedType Tag = 0x2D 178 TagSubprogram Tag = 0x2E 179 TagTemplateTypeParameter Tag = 0x2F 180 TagTemplateValueParameter Tag = 0x30 181 TagThrownType Tag = 0x31 182 TagTryDwarfBlock Tag = 0x32 183 TagVariantPart Tag = 0x33 184 TagVariable Tag = 0x34 185 TagVolatileType Tag = 0x35 186 // The following are new in DWARF 3. 187 TagDwarfProcedure Tag = 0x36 188 TagRestrictType Tag = 0x37 189 TagInterfaceType Tag = 0x38 190 TagNamespace Tag = 0x39 191 TagImportedModule Tag = 0x3A 192 TagUnspecifiedType Tag = 0x3B 193 TagPartialUnit Tag = 0x3C 194 TagImportedUnit Tag = 0x3D 195 TagMutableType Tag = 0x3E // Later removed from DWARF. 196 TagCondition Tag = 0x3F 197 TagSharedType Tag = 0x40 198 // The following are new in DWARF 4. 199 TagTypeUnit Tag = 0x41 200 TagRvalueReferenceType Tag = 0x42 201 TagTemplateAlias Tag = 0x43 202) 203 204func (t Tag) GoString() string { 205 if t <= TagTemplateAlias { 206 return "dwarf.Tag" + t.String() 207 } 208 return "dwarf." + t.String() 209} 210 211// Location expression operators. 212// The debug info encodes value locations like 8(R3) 213// as a sequence of these op codes. 214// This package does not implement full expressions; 215// the opPlusUconst operator is expected by the type parser. 216const ( 217 opAddr = 0x03 /* 1 op, const addr */ 218 opDeref = 0x06 219 opConst1u = 0x08 /* 1 op, 1 byte const */ 220 opConst1s = 0x09 /* " signed */ 221 opConst2u = 0x0A /* 1 op, 2 byte const */ 222 opConst2s = 0x0B /* " signed */ 223 opConst4u = 0x0C /* 1 op, 4 byte const */ 224 opConst4s = 0x0D /* " signed */ 225 opConst8u = 0x0E /* 1 op, 8 byte const */ 226 opConst8s = 0x0F /* " signed */ 227 opConstu = 0x10 /* 1 op, LEB128 const */ 228 opConsts = 0x11 /* " signed */ 229 opDup = 0x12 230 opDrop = 0x13 231 opOver = 0x14 232 opPick = 0x15 /* 1 op, 1 byte stack index */ 233 opSwap = 0x16 234 opRot = 0x17 235 opXderef = 0x18 236 opAbs = 0x19 237 opAnd = 0x1A 238 opDiv = 0x1B 239 opMinus = 0x1C 240 opMod = 0x1D 241 opMul = 0x1E 242 opNeg = 0x1F 243 opNot = 0x20 244 opOr = 0x21 245 opPlus = 0x22 246 opPlusUconst = 0x23 /* 1 op, ULEB128 addend */ 247 opShl = 0x24 248 opShr = 0x25 249 opShra = 0x26 250 opXor = 0x27 251 opSkip = 0x2F /* 1 op, signed 2-byte constant */ 252 opBra = 0x28 /* 1 op, signed 2-byte constant */ 253 opEq = 0x29 254 opGe = 0x2A 255 opGt = 0x2B 256 opLe = 0x2C 257 opLt = 0x2D 258 opNe = 0x2E 259 opLit0 = 0x30 260 /* OpLitN = OpLit0 + N for N = 0..31 */ 261 opReg0 = 0x50 262 /* OpRegN = OpReg0 + N for N = 0..31 */ 263 opBreg0 = 0x70 /* 1 op, signed LEB128 constant */ 264 /* OpBregN = OpBreg0 + N for N = 0..31 */ 265 opRegx = 0x90 /* 1 op, ULEB128 register */ 266 opFbreg = 0x91 /* 1 op, SLEB128 offset */ 267 opBregx = 0x92 /* 2 op, ULEB128 reg; SLEB128 off */ 268 opPiece = 0x93 /* 1 op, ULEB128 size of piece */ 269 opDerefSize = 0x94 /* 1-byte size of data retrieved */ 270 opXderefSize = 0x95 /* 1-byte size of data retrieved */ 271 opNop = 0x96 272 /* next four new in Dwarf v3 */ 273 opPushObjAddr = 0x97 274 opCall2 = 0x98 /* 2-byte offset of DIE */ 275 opCall4 = 0x99 /* 4-byte offset of DIE */ 276 opCallRef = 0x9A /* 4- or 8- byte offset of DIE */ 277 /* 0xE0-0xFF reserved for user-specific */ 278) 279 280// Basic type encodings -- the value for AttrEncoding in a TagBaseType Entry. 281const ( 282 encAddress = 0x01 283 encBoolean = 0x02 284 encComplexFloat = 0x03 285 encFloat = 0x04 286 encSigned = 0x05 287 encSignedChar = 0x06 288 encUnsigned = 0x07 289 encUnsignedChar = 0x08 290 encImaginaryFloat = 0x09 291) 292 293// Statement program standard opcode encodings. 294const ( 295 lnsCopy = 1 296 lnsAdvancePC = 2 297 lnsAdvanceLine = 3 298 lnsSetFile = 4 299 lnsSetColumn = 5 300 lnsNegateStmt = 6 301 lnsSetBasicBlock = 7 302 lnsConstAddPC = 8 303 lnsFixedAdvancePC = 9 304 305 // DWARF 3 306 lnsSetPrologueEnd = 10 307 lnsSetEpilogueBegin = 11 308 lnsSetISA = 12 309) 310 311// Statement program extended opcode encodings. 312const ( 313 lneEndSequence = 1 314 lneSetAddress = 2 315 lneDefineFile = 3 316 317 // DWARF 4 318 lneSetDiscriminator = 4 319) 320