libgo/go/debug/dwarf/const.go

   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
   7 package dwarf
   8
   9 import "strconv"
  10
  11 // An Attr identifies the attribute type in a DWARF Entry's Field.
  12 type Attr uint32
  13
  14 const (
  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
  89 var attrNames = [...]string{
  90         AttrSibling:        "Sibling",
  91         AttrLocation:       "Location",
  92         AttrName:           "Name",
  93         AttrOrdering:       "Ordering",
  94         AttrByteSize:       "ByteSize",
  95         AttrBitOffset:      "BitOffset",
  96         AttrBitSize:        "BitSize",
  97         AttrStmtList:       "StmtList",
  98         AttrLowpc:          "Lowpc",
  99         AttrHighpc:         "Highpc",
 100         AttrLanguage:       "Language",
 101         AttrDiscr:          "Discr",
 102         AttrDiscrValue:     "DiscrValue",
 103         AttrVisibility:     "Visibility",
 104         AttrImport:         "Import",
 105         AttrStringLength:   "StringLength",
 106         AttrCommonRef:      "CommonRef",
 107         AttrCompDir:        "CompDir",
 108         AttrConstValue:     "ConstValue",
 109         AttrContainingType: "ContainingType",
 110         AttrDefaultValue:   "DefaultValue",
 111         AttrInline:         "Inline",
 112         AttrIsOptional:     "IsOptional",
 113         AttrLowerBound:     "LowerBound",
 114         AttrProducer:       "Producer",
 115         AttrPrototyped:     "Prototyped",
 116         AttrReturnAddr:     "ReturnAddr",
 117         AttrStartScope:     "StartScope",
 118         AttrStrideSize:     "StrideSize",
 119         AttrUpperBound:     "UpperBound",
 120         AttrAbstractOrigin: "AbstractOrigin",
 121         AttrAccessibility:  "Accessibility",
 122         AttrAddrClass:      "AddrClass",
 123         AttrArtificial:     "Artificial",
 124         AttrBaseTypes:      "BaseTypes",
 125         AttrCalling:        "Calling",
 126         AttrCount:          "Count",
 127         AttrDataMemberLoc:  "DataMemberLoc",
 128         AttrDeclColumn:     "DeclColumn",
 129         AttrDeclFile:       "DeclFile",
 130         AttrDeclLine:       "DeclLine",
 131         AttrDeclaration:    "Declaration",
 132         AttrDiscrList:      "DiscrList",
 133         AttrEncoding:       "Encoding",
 134         AttrExternal:       "External",
 135         AttrFrameBase:      "FrameBase",
 136         AttrFriend:         "Friend",
 137         AttrIdentifierCase: "IdentifierCase",
 138         AttrMacroInfo:      "MacroInfo",
 139         AttrNamelistItem:   "NamelistItem",
 140         AttrPriority:       "Priority",
 141         AttrSegment:        "Segment",
 142         AttrSpecification:  "Specification",
 143         AttrStaticLink:     "StaticLink",
 144         AttrType:           "Type",
 145         AttrUseLocation:    "UseLocation",
 146         AttrVarParam:       "VarParam",
 147         AttrVirtuality:     "Virtuality",
 148         AttrVtableElemLoc:  "VtableElemLoc",
 149         AttrAllocated:      "Allocated",
 150         AttrAssociated:     "Associated",
 151         AttrDataLocation:   "DataLocation",
 152         AttrStride:         "Stride",
 153         AttrEntrypc:        "Entrypc",
 154         AttrUseUTF8:        "UseUTF8",
 155         AttrExtension:      "Extension",
 156         AttrRanges:         "Ranges",
 157         AttrTrampoline:     "Trampoline",
 158         AttrCallColumn:     "CallColumn",
 159         AttrCallFile:       "CallFile",
 160         AttrCallLine:       "CallLine",
 161         AttrDescription:    "Description",
 162 }
 163
 164 func (a Attr) String() string {
 165         if int(a) < len(attrNames) {
 166                 s := attrNames[a]
 167                 if s != "" {
 168                         return s
 169                 }
 170         }
 171         return strconv.Itoa(int(a))
 172 }
 173
 174 func (a Attr) GoString() string {
 175         if int(a) < len(attrNames) {
 176                 s := attrNames[a]
 177                 if s != "" {
 178                         return "dwarf.Attr" + s
 179                 }
 180         }
 181         return "dwarf.Attr(" + strconv.Itoa64(int64(a)) + ")"
 182 }
 183
 184 // A format is a DWARF data encoding format.
 185 type format uint32
 186
 187 const (
 188         // value formats
 189         formAddr        format = 0x01
 190         formDwarfBlock2 format = 0x03
 191         formDwarfBlock4 format = 0x04
 192         formData2       format = 0x05
 193         formData4       format = 0x06
 194         formData8       format = 0x07
 195         formString      format = 0x08
 196         formDwarfBlock  format = 0x09
 197         formDwarfBlock1 format = 0x0A
 198         formData1       format = 0x0B
 199         formFlag        format = 0x0C
 200         formSdata       format = 0x0D
 201         formStrp        format = 0x0E
 202         formUdata       format = 0x0F
 203         formRefAddr     format = 0x10
 204         formRef1        format = 0x11
 205         formRef2        format = 0x12
 206         formRef4        format = 0x13
 207         formRef8        format = 0x14
 208         formRefUdata    format = 0x15
 209         formIndirect    format = 0x16
 210 )
 211
 212 // A Tag is the classification (the type) of an Entry.
 213 type Tag uint32
 214
 215 const (
 216         TagArrayType              Tag = 0x01
 217         TagClassType              Tag = 0x02
 218         TagEntryPoint             Tag = 0x03
 219         TagEnumerationType        Tag = 0x04
 220         TagFormalParameter        Tag = 0x05
 221         TagImportedDeclaration    Tag = 0x08
 222         TagLabel                  Tag = 0x0A
 223         TagLexDwarfBlock          Tag = 0x0B
 224         TagMember                 Tag = 0x0D
 225         TagPointerType            Tag = 0x0F
 226         TagReferenceType          Tag = 0x10
 227         TagCompileUnit            Tag = 0x11
 228         TagStringType             Tag = 0x12
 229         TagStructType             Tag = 0x13
 230         TagSubroutineType         Tag = 0x15
 231         TagTypedef                Tag = 0x16
 232         TagUnionType              Tag = 0x17
 233         TagUnspecifiedParameters  Tag = 0x18
 234         TagVariant                Tag = 0x19
 235         TagCommonDwarfBlock       Tag = 0x1A
 236         TagCommonInclusion        Tag = 0x1B
 237         TagInheritance            Tag = 0x1C
 238         TagInlinedSubroutine      Tag = 0x1D
 239         TagModule                 Tag = 0x1E
 240         TagPtrToMemberType        Tag = 0x1F
 241         TagSetType                Tag = 0x20
 242         TagSubrangeType           Tag = 0x21
 243         TagWithStmt               Tag = 0x22
 244         TagAccessDeclaration      Tag = 0x23
 245         TagBaseType               Tag = 0x24
 246         TagCatchDwarfBlock        Tag = 0x25
 247         TagConstType              Tag = 0x26
 248         TagConstant               Tag = 0x27
 249         TagEnumerator             Tag = 0x28
 250         TagFileType               Tag = 0x29
 251         TagFriend                 Tag = 0x2A
 252         TagNamelist               Tag = 0x2B
 253         TagNamelistItem           Tag = 0x2C
 254         TagPackedType             Tag = 0x2D
 255         TagSubprogram             Tag = 0x2E
 256         TagTemplateTypeParameter  Tag = 0x2F
 257         TagTemplateValueParameter Tag = 0x30
 258         TagThrownType             Tag = 0x31
 259         TagTryDwarfBlock          Tag = 0x32
 260         TagVariantPart            Tag = 0x33
 261         TagVariable               Tag = 0x34
 262         TagVolatileType           Tag = 0x35
 263         TagDwarfProcedure         Tag = 0x36
 264         TagRestrictType           Tag = 0x37
 265         TagInterfaceType          Tag = 0x38
 266         TagNamespace              Tag = 0x39
 267         TagImportedModule         Tag = 0x3A
 268         TagUnspecifiedType        Tag = 0x3B
 269         TagPartialUnit            Tag = 0x3C
 270         TagImportedUnit           Tag = 0x3D
 271         TagMutableType            Tag = 0x3E
 272 )
 273
 274 var tagNames = [...]string{
 275         TagArrayType:              "ArrayType",
 276         TagClassType:              "ClassType",
 277         TagEntryPoint:             "EntryPoint",
 278         TagEnumerationType:        "EnumerationType",
 279         TagFormalParameter:        "FormalParameter",
 280         TagImportedDeclaration:    "ImportedDeclaration",
 281         TagLabel:                  "Label",
 282         TagLexDwarfBlock:          "LexDwarfBlock",
 283         TagMember:                 "Member",
 284         TagPointerType:            "PointerType",
 285         TagReferenceType:          "ReferenceType",
 286         TagCompileUnit:            "CompileUnit",
 287         TagStringType:             "StringType",
 288         TagStructType:             "StructType",
 289         TagSubroutineType:         "SubroutineType",
 290         TagTypedef:                "Typedef",
 291         TagUnionType:              "UnionType",
 292         TagUnspecifiedParameters:  "UnspecifiedParameters",
 293         TagVariant:                "Variant",
 294         TagCommonDwarfBlock:       "CommonDwarfBlock",
 295         TagCommonInclusion:        "CommonInclusion",
 296         TagInheritance:            "Inheritance",
 297         TagInlinedSubroutine:      "InlinedSubroutine",
 298         TagModule:                 "Module",
 299         TagPtrToMemberType:        "PtrToMemberType",
 300         TagSetType:                "SetType",
 301         TagSubrangeType:           "SubrangeType",
 302         TagWithStmt:               "WithStmt",
 303         TagAccessDeclaration:      "AccessDeclaration",
 304         TagBaseType:               "BaseType",
 305         TagCatchDwarfBlock:        "CatchDwarfBlock",
 306         TagConstType:              "ConstType",
 307         TagConstant:               "Constant",
 308         TagEnumerator:             "Enumerator",
 309         TagFileType:               "FileType",
 310         TagFriend:                 "Friend",
 311         TagNamelist:               "Namelist",
 312         TagNamelistItem:           "NamelistItem",
 313         TagPackedType:             "PackedType",
 314         TagSubprogram:             "Subprogram",
 315         TagTemplateTypeParameter:  "TemplateTypeParameter",
 316         TagTemplateValueParameter: "TemplateValueParameter",
 317         TagThrownType:             "ThrownType",
 318         TagTryDwarfBlock:          "TryDwarfBlock",
 319         TagVariantPart:            "VariantPart",
 320         TagVariable:               "Variable",
 321         TagVolatileType:           "VolatileType",
 322         TagDwarfProcedure:         "DwarfProcedure",
 323         TagRestrictType:           "RestrictType",
 324         TagInterfaceType:          "InterfaceType",
 325         TagNamespace:              "Namespace",
 326         TagImportedModule:         "ImportedModule",
 327         TagUnspecifiedType:        "UnspecifiedType",
 328         TagPartialUnit:            "PartialUnit",
 329         TagImportedUnit:           "ImportedUnit",
 330         TagMutableType:            "MutableType",
 331 }
 332
 333 func (t Tag) String() string {
 334         if int(t) < len(tagNames) {
 335                 s := tagNames[t]
 336                 if s != "" {
 337                         return s
 338                 }
 339         }
 340         return strconv.Itoa(int(t))
 341 }
 342
 343 func (t Tag) GoString() string {
 344         if int(t) < len(tagNames) {
 345                 s := tagNames[t]
 346                 if s != "" {
 347                         return "dwarf.Tag" + s
 348                 }
 349         }
 350         return "dwarf.Tag(" + strconv.Itoa64(int64(t)) + ")"
 351 }
 352
 353 // Location expression operators.
 354 // The debug info encodes value locations like 8(R3)
 355 // as a sequence of these op codes.
 356 // This package does not implement full expressions;
 357 // the opPlusUconst operator is expected by the type parser.
 358 const (
 359         opAddr       = 0x03 /* 1 op, const addr */
 360         opDeref      = 0x06
 361         opConst1u    = 0x08 /* 1 op, 1 byte const */
 362         opConst1s    = 0x09 /*  " signed */
 363         opConst2u    = 0x0A /* 1 op, 2 byte const  */
 364         opConst2s    = 0x0B /*  " signed */
 365         opConst4u    = 0x0C /* 1 op, 4 byte const */
 366         opConst4s    = 0x0D /*  " signed */
 367         opConst8u    = 0x0E /* 1 op, 8 byte const */
 368         opConst8s    = 0x0F /*  " signed */
 369         opConstu     = 0x10 /* 1 op, LEB128 const */
 370         opConsts     = 0x11 /*  " signed */
 371         opDup        = 0x12
 372         opDrop       = 0x13
 373         opOver       = 0x14
 374         opPick       = 0x15 /* 1 op, 1 byte stack index */
 375         opSwap       = 0x16
 376         opRot        = 0x17
 377         opXderef     = 0x18
 378         opAbs        = 0x19
 379         opAnd        = 0x1A
 380         opDiv        = 0x1B
 381         opMinus      = 0x1C
 382         opMod        = 0x1D
 383         opMul        = 0x1E
 384         opNeg        = 0x1F
 385         opNot        = 0x20
 386         opOr         = 0x21
 387         opPlus       = 0x22
 388         opPlusUconst = 0x23 /* 1 op, ULEB128 addend */
 389         opShl        = 0x24
 390         opShr        = 0x25
 391         opShra       = 0x26
 392         opXor        = 0x27
 393         opSkip       = 0x2F /* 1 op, signed 2-byte constant */
 394         opBra        = 0x28 /* 1 op, signed 2-byte constant */
 395         opEq         = 0x29
 396         opGe         = 0x2A
 397         opGt         = 0x2B
 398         opLe         = 0x2C
 399         opLt         = 0x2D
 400         opNe         = 0x2E
 401         opLit0       = 0x30
 402         /* OpLitN = OpLit0 + N for N = 0..31 */
 403         opReg0 = 0x50
 404         /* OpRegN = OpReg0 + N for N = 0..31 */
 405         opBreg0 = 0x70 /* 1 op, signed LEB128 constant */
 406         /* OpBregN = OpBreg0 + N for N = 0..31 */
 407         opRegx       = 0x90 /* 1 op, ULEB128 register */
 408         opFbreg      = 0x91 /* 1 op, SLEB128 offset */
 409         opBregx      = 0x92 /* 2 op, ULEB128 reg; SLEB128 off */
 410         opPiece      = 0x93 /* 1 op, ULEB128 size of piece */
 411         opDerefSize  = 0x94 /* 1-byte size of data retrieved */
 412         opXderefSize = 0x95 /* 1-byte size of data retrieved */
 413         opNop        = 0x96
 414         /* next four new in Dwarf v3 */
 415         opPushObjAddr = 0x97
 416         opCall2       = 0x98 /* 2-byte offset of DIE */
 417         opCall4       = 0x99 /* 4-byte offset of DIE */
 418         opCallRef     = 0x9A /* 4- or 8- byte offset of DIE */
 419         /* 0xE0-0xFF reserved for user-specific */
 420 )
 421
 422 // Basic type encodings -- the value for AttrEncoding in a TagBaseType Entry.
 423 const (
 424         encAddress        = 0x01
 425         encBoolean        = 0x02
 426         encComplexFloat   = 0x03
 427         encFloat          = 0x04
 428         encSigned         = 0x05
 429         encSignedChar     = 0x06
 430         encUnsigned       = 0x07
 431         encUnsignedChar   = 0x08
 432         encImaginaryFloat = 0x09
 433 )