The fields of debug descriptors used internally by LLVM (MachineDebugInfo) +
The fields of debug descriptors used internally by LLVM (MachineModuleInfo) are restricted to only the simple data types int, uint, bool, float, double, sbyte* and { }* . References to arbitrary values are handled using a { }* and a @@ -295,13 +295,15 @@ descriptors, arrays of descriptors or global variables.
} -The first field of a descriptor is always an uint containing a tag -value identifying the content of the descriptor. The remaining fields are -specific to the descriptor. The values of tags are loosely bound to the tag -values of Dwarf information entries. However, that does not restrict the use of -the information supplied to Dwarf targets.
+ -The details of the various descriptors follow.
+The details of the various descriptors follow.
@@ -314,7 +316,7 @@ the information supplied to Dwarf targets.%llvm.dbg.anchor.type = type { - uint, ;; Tag = 0 + uint, ;; Tag = 0 + LLVMDebugVersion uint ;; Tag of descriptors grouped by the anchor }@@ -352,9 +354,8 @@ deleted.
%llvm.dbg.compile_unit.type = type { - uint, ;; Tag = 17 (DW_TAG_compile_unit) + uint, ;; Tag = 17 + LLVMDebugVersion (DW_TAG_compile_unit) { }*, ;; Compile unit anchor = cast = (%llvm.dbg.anchor.type* %llvm.dbg.compile_units to { }*) - uint, ;; LLVM debug version number = 3 uint, ;; Dwarf language identifier (ex. DW_LANG_C89) sbyte*, ;; Source file name sbyte*, ;; Source file directory (includes trailing slash) @@ -362,11 +363,11 @@ deleted. }-
These descriptors contain the version number for the debug info (currently -3), a source language ID for the file (we use the Dwarf 3.0 ID numbers, such as -DW_LANG_C89, DW_LANG_C_plus_plus, DW_LANG_Cobol74, -etc), three strings describing the filename, working directory of the compiler, -and an identifier string for the compiler that produced it.
+These descriptors contain a source language ID for the file (we use the Dwarf +3.0 ID numbers, such as DW_LANG_C89, DW_LANG_C_plus_plus, +DW_LANG_Cobol74, etc), three strings describing the filename, working +directory of the compiler, and an identifier string for the compiler that +produced it.
Compile unit descriptors provide the root context for objects declared in a specific source file. Global variables and top level functions would be defined @@ -384,10 +385,12 @@ line correspondence.
%llvm.dbg.global_variable.type = type { - uint, ;; Tag = 52 (DW_TAG_variable) + uint, ;; Tag = 52 + LLVMDebugVersion (DW_TAG_variable) { }*, ;; Global variable anchor = cast (%llvm.dbg.anchor.type* %llvm.dbg.global_variables to { }*), { }*, ;; Reference to context descriptor sbyte*, ;; Name + sbyte*, ;; Display name (fully qualified C++ name) + sbyte*, ;; MIPS linkage name (for C++) { }*, ;; Reference to compile unit where defined uint, ;; Line number where defined { }*, ;; Reference to type descriptor @@ -411,10 +414,12 @@ provide details such as name, type and where the variable is defined.%llvm.dbg.subprogram.type = type { - uint, ;; Tag = 46 (DW_TAG_subprogram) + uint, ;; Tag = 46 + LLVMDebugVersion (DW_TAG_subprogram) { }*, ;; Subprogram anchor = cast (%llvm.dbg.anchor.type* %llvm.dbg.subprograms to { }*), { }*, ;; Reference to context descriptor sbyte*, ;; Name + sbyte*, ;; Display name (fully qualified C++ name) + sbyte*, ;; MIPS linkage name (for C++) { }*, ;; Reference to compile unit where defined uint, ;; Line number where defined { }*, ;; Reference to type descriptor @@ -437,7 +442,7 @@ location where the subprogram is defined.%llvm.dbg.block = type { - uint, ;; Tag = 13 (DW_TAG_lexical_block) + uint, ;; Tag = 13 + LLVMDebugVersion (DW_TAG_lexical_block) { }* ;; Reference to context descriptor }@@ -457,7 +462,7 @@ and deeper nested blocks.%llvm.dbg.basictype.type = type { - uint, ;; Tag = 36 (DW_TAG_base_type) + uint, ;; Tag = 36 + LLVMDebugVersion (DW_TAG_base_type) { }*, ;; Reference to context (typically a compile unit) sbyte*, ;; Name (may be "" for anonymous types) { }*, ;; Reference to compile unit where defined (may be NULL) @@ -588,11 +593,17 @@ are possible tag values; DW_TAG_enumeration_type = 4 DW_TAG_structure_type = 19 DW_TAG_union_type = 23 + DW_TAG_vector_type = 259 + DW_TAG_subroutine_type = 46 + DW_TAG_inheritance = 26-The members of array types (tag = DW_TAG_array_type) are subrange descriptors, each representing the range of -subscripts at that level of indexing.
+The vector flag indicates that an array type is a native packed vector.
+ +The members of array types (tag = DW_TAG_array_type) or vector types +(tag = DW_TAG_vector_type) are subrange +descriptors, each representing the range of subscripts at that level of +indexing.
The members of enumeration types (tag = DW_TAG_enumeration_type) are enumerator descriptors, each representing the @@ -605,6 +616,21 @@ href="#format_basic_type">basic, derived or composite type descriptors, each representing a field member of the structure or union.
+For C++ classes (tag = DW_TAG_structure_type), member descriptors +provide information about base classes, static members and member functions. If +a member is a derived type descriptor and has +a tag of DW_TAG_inheritance, then the type represents a base class. If +the member of is a global variable +descriptor then it represents a static member. And, if the member is a subprogram descriptor then it represents a member +function. For static members and member functions, getName() returns +the members link or the C++ mangled name. getDisplayName() the +simplied version of the name.
+ +The first member of subroutine (tag = DW_TAG_subroutine_type) +type elements is the return type for the subroutine. The remaining +elements are the formal arguments to the subroutine.
+Composite type location can be determined from the compile unit and line number. The size, alignment and offset are expressed in bits and can be 64 bit values. The alignment is used to @@ -624,7 +650,7 @@ type.
%llvm.dbg.subrange.type = type { - uint, ;; Tag = 33 (DW_TAG_subrange_type) + uint, ;; Tag = 33 + LLVMDebugVersion (DW_TAG_subrange_type) uint, ;; Low value uint ;; High value } @@ -647,7 +673,7 @@ low == high the array will be unbounded.@@ -1187,10 +1218,11 @@ int main(int argc, char *argv[]) { ;; Define the descriptor for the subprogram. TODO - more details. ;; %llvm.dbg.subprogram = internal constant %llvm.dbg.subprogram.type { - uint 46, + uint add(uint 46, uint 262144), { }* cast (%llvm.dbg.anchor.type* %llvm.dbg.subprograms to { }*), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([5 x sbyte]* %str1, int 0, int 0), + sbyte* getelementptr ([1 x sbyte]* %str2, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), uint 1, { }* null, @@ -1201,6 +1233,7 @@ int main(int argc, char *argv[]) { ;; Define the name of the subprogram. ;; %str1 = internal constant [5 x sbyte] c"main\00", section "llvm.metadata" +%str2 = internal constant [1 x sbyte] c"\00", section "llvm.metadata" ;; ;; Define the subprogram itself. @@ -1232,7 +1265,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.enumerator.type = type { - uint, ;; Tag = 40 (DW_TAG_enumerator) + uint, ;; Tag = 40 + LLVMDebugVersion (DW_TAG_enumerator) sbyte*, ;; Name uint ;; Value } @@ -721,7 +747,7 @@ provide debug information at various points in generated code.This intrinsic is used to provide correspondence between the source file and the generated code. The first argument is the line number (base 1), second -argument si the column number (0 if unknown) and the third argument the source +argument is the column number (0 if unknown) and the third argument the source %llvm.dbg.compile_unit* cast to a { }*. Code following a call to this intrinsic will have been defined in close proximity of the line, column and file. This information holds until @@ -741,10 +767,13 @@ href="#format_common_stoppoint">lvm.dbg.stoppoint.
This intrinsic is used to link the debug information in %llvm.dbg.subprogram to the function. It also -defines the beginning of the function's declarative region (scope.) The -intrinsic should be called early in the function after the all the alloca -instructions. It should be paired off with a closing %llvm.dbg.subprogram to the function. It +defines the beginning of the function's declarative region (scope). It also +implies a call to %llvm.dbg.stoppoint which defines a +source line "stop point". The intrinsic should be called early in the function +after the all the alloca instructions. It should be paired off with a closing +%llvm.dbg.region.end. The function's single argument is the %llvm.dbg.subprogram.type.
@@ -965,7 +994,7 @@ another scope).It is worth noting that this scoping mechanism is used to control scoping of all declarations, not just variable declarations. For example, the scope of a -C++ using declaration is controlled with this couldchange how name lookup is +C++ using declaration is controlled with this and could change how name lookup is performed.
@@ -1039,7 +1068,7 @@ int main(int argc, char *argv[]) { ;; Define the compile unit for the source file "/Users/mine/sources/MySource.cpp". ;; %llvm.dbg.compile_unit1 = internal constant %llvm.dbg.compile_unit.type { - uint 17, + uint add(uint 17, uint 262144), { }* cast (%llvm.dbg.anchor.type* %llvm.dbg.compile_units to { }*), uint 1, uint 1, @@ -1051,7 +1080,7 @@ int main(int argc, char *argv[]) { ;; Define the compile unit for the header file "/Users/mine/sources/MyHeader.h". ;; %llvm.dbg.compile_unit2 = internal constant %llvm.dbg.compile_unit.type { - uint 17, + uint add(uint 17, uint 262144), { }* cast (%llvm.dbg.anchor.type* %llvm.dbg.compile_units to { }*), uint 1, uint 1, @@ -1114,10 +1143,11 @@ int MyGlobal = 100; ;; variable anchor and the global variable itself. ;; %llvm.dbg.global_variable = internal constant %llvm.dbg.global_variable.type { - uint 52, + uint add(uint 52, uint 262144), { }* cast (%llvm.dbg.anchor.type* %llvm.dbg.global_variables to { }*), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([9 x sbyte]* %str1, int 0, int 0), + sbyte* getelementptr ([1 x sbyte]* %str2, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), uint 1, { }* cast (%llvm.dbg.basictype.type* %llvm.dbg.basictype to { }*), @@ -1130,9 +1160,9 @@ int MyGlobal = 100; ;; intrinsic type the source file is NULL and line 0. ;; %llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), - sbyte* getelementptr ([4 x sbyte]* %str2, int 0, int 0), + sbyte* getelementptr ([4 x sbyte]* %str3, int 0, int 0), { }* null, int 0, uint 32, @@ -1144,7 +1174,8 @@ int MyGlobal = 100; ;; Define the names of the global variable and basic type. ;; %str1 = internal constant [9 x sbyte] c"MyGlobal\00", section "llvm.metadata" -%str2 = internal constant [4 x sbyte] c"int\00", section "llvm.metadata" +%str2 = internal constant [1 x sbyte] c"\00", section "llvm.metadata" +%str3 = internal constant [4 x sbyte] c"int\00", section "llvm.metadata"%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([5 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1255,7 +1288,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([5 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1278,7 +1311,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([14 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1301,7 +1334,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([10 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1324,7 +1357,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([19 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1347,7 +1380,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([4 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1370,7 +1403,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([13 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1393,7 +1426,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([14 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1416,7 +1449,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([23 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1439,7 +1472,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([6 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1462,7 +1495,7 @@ int %main(int %argc, sbyte** %argv) {%llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([7 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1496,7 +1529,7 @@ typedef const int *IntPtr; ;; Define the typedef "IntPtr". ;; %llvm.dbg.derivedtype1 = internal constant %llvm.dbg.derivedtype.type { - uint 22, + uint add(uint 22, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([7 x sbyte]* %str1, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1511,7 +1544,7 @@ typedef const int *IntPtr; ;; Define the pointer type. ;; %llvm.dbg.derivedtype2 = internal constant %llvm.dbg.derivedtype.type { - uint 15, + uint add(uint 15, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* null, { }* null, @@ -1525,7 +1558,7 @@ typedef const int *IntPtr; ;; Define the const type. ;; %llvm.dbg.derivedtype3 = internal constant %llvm.dbg.derivedtype.type { - uint 38, + uint add(uint 38, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* null, { }* null, @@ -1539,7 +1572,7 @@ typedef const int *IntPtr; ;; Define the int type. ;; %llvm.dbg.basictype1 = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([4 x sbyte]* %str2, int 0, int 0), { }* null, @@ -1577,7 +1610,7 @@ struct Color { ;; Define basic type for unsigned int. ;; %llvm.dbg.basictype = internal constant %llvm.dbg.basictype.type { - uint 36, + uint add(uint 36, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([13 x sbyte]* %str1, int 0, int 0), { }* null, @@ -1592,7 +1625,7 @@ struct Color { ;; Define composite type for struct Color. ;; %llvm.dbg.compositetype = internal constant %llvm.dbg.compositetype.type { - uint 19, + uint add(uint 19, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([6 x sbyte]* %str2, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1600,7 +1633,7 @@ struct Color { uint 96, uint 32, uint 0, - { }* null, + { }* null, { }* cast ([3 x { }*]* %llvm.dbg.array to { }*) }, section "llvm.metadata" %str2 = internal constant [6 x sbyte] c"Color\00", section "llvm.metadata" @@ -1608,7 +1641,7 @@ struct Color { ;; Define the Red field. ;; %llvm.dbg.derivedtype1 = internal constant %llvm.dbg.derivedtype.type { - uint 13, + uint add(uint 13, uint 262144), { }* null, sbyte* getelementptr ([4 x sbyte]* %str3, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1623,7 +1656,7 @@ struct Color { ;; Define the Green field. ;; %llvm.dbg.derivedtype2 = internal constant %llvm.dbg.derivedtype.type { - uint 13, + uint add(uint 13, uint 262144), { }* null, sbyte* getelementptr ([6 x sbyte]* %str4, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1638,7 +1671,7 @@ struct Color { ;; Define the Blue field. ;; %llvm.dbg.derivedtype3 = internal constant %llvm.dbg.derivedtype.type { - uint 13, + uint add(uint 13, uint 262144), { }* null, sbyte* getelementptr ([5 x sbyte]* %str5, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1684,7 +1717,7 @@ enum Trees { ;; Define composite type for enum Trees ;; %llvm.dbg.compositetype = internal constant %llvm.dbg.compositetype.type { - uint 4, + uint add(uint 4, uint 262144), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), sbyte* getelementptr ([6 x sbyte]* %str1, int 0, int 0), { }* cast (%llvm.dbg.compile_unit.type* %llvm.dbg.compile_unit to { }*), @@ -1700,7 +1733,7 @@ enum Trees { ;; Define Spruce enumerator. ;; %llvm.dbg.enumerator1 = internal constant %llvm.dbg.enumerator.type { - uint 40, + uint add(uint 40, uint 262144), sbyte* getelementptr ([7 x sbyte]* %str2, int 0, int 0), int 100 }, section "llvm.metadata" %str2 = internal constant [7 x sbyte] c"Spruce\00", section "llvm.metadata" @@ -1709,7 +1742,7 @@ enum Trees { ;; Define Oak enumerator. ;; %llvm.dbg.enumerator2 = internal constant %llvm.dbg.enumerator.type { - uint 40, + uint add(uint 40, uint 262144), sbyte* getelementptr ([4 x sbyte]* %str3, int 0, int 0), int 200 }, section "llvm.metadata" %str3 = internal constant [4 x sbyte] c"Oak\00", section "llvm.metadata" @@ -1718,7 +1751,7 @@ enum Trees { ;; Define Maple enumerator. ;; %llvm.dbg.enumerator3 = internal constant %llvm.dbg.enumerator.type { - uint 40, + uint add(uint 40, uint 262144), sbyte* getelementptr ([6 x sbyte]* %str4, int 0, int 0), int 300 }, section "llvm.metadata" %str4 = internal constant [6 x sbyte] c"Maple\00", section "llvm.metadata"