1
//===-- llvm/Support/Dwarf.h ---Dwarf Constants------------------*- C++ -*-===//
3
// The LLVM Compiler Infrastructure
5
// This file is distributed under the University of Illinois Open Source
6
// License. See LICENSE.TXT for details.
8
//===----------------------------------------------------------------------===//
10
// This file contains constants used for implementing Dwarf debug support. For
11
// Details on the Dwarf 3 specfication see DWARF Debugging Information Format
12
// V.3 reference manual http://dwarf.freestandards.org ,
14
//===----------------------------------------------------------------------===//
16
#ifndef LLVM_SUPPORT_DWARF_H
17
#define LLVM_SUPPORT_DWARF_H
21
//===----------------------------------------------------------------------===//
22
// Debug info constants.
25
LLVMDebugVersion = (7 << 16), // Current version of debug information.
26
LLVMDebugVersion6 = (6 << 16), // Constant for version 6.
27
LLVMDebugVersion5 = (5 << 16), // Constant for version 5.
28
LLVMDebugVersion4 = (4 << 16), // Constant for version 4.
29
LLVMDebugVersionMask = 0xffff0000 // Mask for version number.
34
//===----------------------------------------------------------------------===//
35
// Dwarf constants as gleaned from the DWARF Debugging Information Format V.3
36
// reference manual http://dwarf.freestandards.org .
39
// Do not mix the following two enumerations sets. DW_TAG_invalid changes the
40
// enumeration base type.
42
enum llvm_dwarf_constants {
44
DW_TAG_invalid = ~0U, // Tag for invalid results.
46
DW_TAG_anchor = 0, // Tag for descriptor anchors.
47
DW_TAG_auto_variable = 0x100, // Tag for local (auto) variables.
48
DW_TAG_arg_variable = 0x101, // Tag for argument variables.
49
DW_TAG_return_variable = 0x102, // Tag for return variables.
51
DW_TAG_vector_type = 0x103, // Tag for vector types.
53
DW_TAG_user_base = 0x1000, // Recommended base for user tags.
55
DW_CIE_VERSION = 1, // Common frame information version.
56
DW_CIE_ID = 0xffffffff // Common frame information mark.
59
enum dwarf_constants {
63
DW_TAG_array_type = 0x01,
64
DW_TAG_class_type = 0x02,
65
DW_TAG_entry_point = 0x03,
66
DW_TAG_enumeration_type = 0x04,
67
DW_TAG_formal_parameter = 0x05,
68
DW_TAG_imported_declaration = 0x08,
70
DW_TAG_lexical_block = 0x0b,
72
DW_TAG_pointer_type = 0x0f,
73
DW_TAG_reference_type = 0x10,
74
DW_TAG_compile_unit = 0x11,
75
DW_TAG_string_type = 0x12,
76
DW_TAG_structure_type = 0x13,
77
DW_TAG_subroutine_type = 0x15,
78
DW_TAG_typedef = 0x16,
79
DW_TAG_union_type = 0x17,
80
DW_TAG_unspecified_parameters = 0x18,
81
DW_TAG_variant = 0x19,
82
DW_TAG_common_block = 0x1a,
83
DW_TAG_common_inclusion = 0x1b,
84
DW_TAG_inheritance = 0x1c,
85
DW_TAG_inlined_subroutine = 0x1d,
87
DW_TAG_ptr_to_member_type = 0x1f,
88
DW_TAG_set_type = 0x20,
89
DW_TAG_subrange_type = 0x21,
90
DW_TAG_with_stmt = 0x22,
91
DW_TAG_access_declaration = 0x23,
92
DW_TAG_base_type = 0x24,
93
DW_TAG_catch_block = 0x25,
94
DW_TAG_const_type = 0x26,
95
DW_TAG_constant = 0x27,
96
DW_TAG_enumerator = 0x28,
97
DW_TAG_file_type = 0x29,
99
DW_TAG_namelist = 0x2b,
100
DW_TAG_namelist_item = 0x2c,
101
DW_TAG_packed_type = 0x2d,
102
DW_TAG_subprogram = 0x2e,
103
DW_TAG_template_type_parameter = 0x2f,
104
DW_TAG_template_value_parameter = 0x30,
105
DW_TAG_thrown_type = 0x31,
106
DW_TAG_try_block = 0x32,
107
DW_TAG_variant_part = 0x33,
108
DW_TAG_variable = 0x34,
109
DW_TAG_volatile_type = 0x35,
110
DW_TAG_dwarf_procedure = 0x36,
111
DW_TAG_restrict_type = 0x37,
112
DW_TAG_interface_type = 0x38,
113
DW_TAG_namespace = 0x39,
114
DW_TAG_imported_module = 0x3a,
115
DW_TAG_unspecified_type = 0x3b,
116
DW_TAG_partial_unit = 0x3c,
117
DW_TAG_imported_unit = 0x3d,
118
DW_TAG_condition = 0x3f,
119
DW_TAG_shared_type = 0x40,
120
DW_TAG_lo_user = 0x4080,
121
DW_TAG_hi_user = 0xffff,
124
DW_CHILDREN_no = 0x00,
125
DW_CHILDREN_yes = 0x01,
128
DW_AT_sibling = 0x01,
129
DW_AT_location = 0x02,
131
DW_AT_ordering = 0x09,
132
DW_AT_byte_size = 0x0b,
133
DW_AT_bit_offset = 0x0c,
134
DW_AT_bit_size = 0x0d,
135
DW_AT_stmt_list = 0x10,
137
DW_AT_high_pc = 0x12,
138
DW_AT_language = 0x13,
140
DW_AT_discr_value = 0x16,
141
DW_AT_visibility = 0x17,
143
DW_AT_string_length = 0x19,
144
DW_AT_common_reference = 0x1a,
145
DW_AT_comp_dir = 0x1b,
146
DW_AT_const_value = 0x1c,
147
DW_AT_containing_type = 0x1d,
148
DW_AT_default_value = 0x1e,
150
DW_AT_is_optional = 0x21,
151
DW_AT_lower_bound = 0x22,
152
DW_AT_producer = 0x25,
153
DW_AT_prototyped = 0x27,
154
DW_AT_return_addr = 0x2a,
155
DW_AT_start_scope = 0x2c,
156
DW_AT_bit_stride = 0x2e,
157
DW_AT_upper_bound = 0x2f,
158
DW_AT_abstract_origin = 0x31,
159
DW_AT_accessibility = 0x32,
160
DW_AT_address_class = 0x33,
161
DW_AT_artificial = 0x34,
162
DW_AT_base_types = 0x35,
163
DW_AT_calling_convention = 0x36,
165
DW_AT_data_member_location = 0x38,
166
DW_AT_decl_column = 0x39,
167
DW_AT_decl_file = 0x3a,
168
DW_AT_decl_line = 0x3b,
169
DW_AT_declaration = 0x3c,
170
DW_AT_discr_list = 0x3d,
171
DW_AT_encoding = 0x3e,
172
DW_AT_external = 0x3f,
173
DW_AT_frame_base = 0x40,
175
DW_AT_identifier_case = 0x42,
176
DW_AT_macro_info = 0x43,
177
DW_AT_namelist_item = 0x44,
178
DW_AT_priority = 0x45,
179
DW_AT_segment = 0x46,
180
DW_AT_specification = 0x47,
181
DW_AT_static_link = 0x48,
183
DW_AT_use_location = 0x4a,
184
DW_AT_variable_parameter = 0x4b,
185
DW_AT_virtuality = 0x4c,
186
DW_AT_vtable_elem_location = 0x4d,
187
DW_AT_allocated = 0x4e,
188
DW_AT_associated = 0x4f,
189
DW_AT_data_location = 0x50,
190
DW_AT_byte_stride = 0x51,
191
DW_AT_entry_pc = 0x52,
192
DW_AT_use_UTF8 = 0x53,
193
DW_AT_extension = 0x54,
195
DW_AT_trampoline = 0x56,
196
DW_AT_call_column = 0x57,
197
DW_AT_call_file = 0x58,
198
DW_AT_call_line = 0x59,
199
DW_AT_description = 0x5a,
200
DW_AT_binary_scale = 0x5b,
201
DW_AT_decimal_scale = 0x5c,
203
DW_AT_decimal_sign = 0x5e,
204
DW_AT_digit_count = 0x5f,
205
DW_AT_picture_string = 0x60,
206
DW_AT_mutable = 0x61,
207
DW_AT_threads_scaled = 0x62,
208
DW_AT_explicit = 0x63,
209
DW_AT_object_pointer = 0x64,
210
DW_AT_endianity = 0x65,
211
DW_AT_elemental = 0x66,
213
DW_AT_recursive = 0x68,
214
DW_AT_MIPS_linkage_name = 0x2007,
215
DW_AT_sf_names = 0x2101,
216
DW_AT_src_info = 0x2102,
217
DW_AT_mac_info = 0x2103,
218
DW_AT_src_coords = 0x2104,
219
DW_AT_body_begin = 0x2105,
220
DW_AT_body_end = 0x2106,
221
DW_AT_GNU_vector = 0x2107,
222
DW_AT_lo_user = 0x2000,
223
DW_AT_hi_user = 0x3fff,
226
DW_AT_APPLE_optimized = 0x3fe1,
227
DW_AT_APPLE_flags = 0x3fe2,
228
DW_AT_APPLE_isa = 0x3fe3,
229
DW_AT_APPLE_block = 0x3fe4,
230
DW_AT_APPLE_major_runtime_vers = 0x3fe5,
231
DW_AT_APPLE_runtime_class = 0x3fe6,
233
// Attribute form encodings
235
DW_FORM_block2 = 0x03,
236
DW_FORM_block4 = 0x04,
237
DW_FORM_data2 = 0x05,
238
DW_FORM_data4 = 0x06,
239
DW_FORM_data8 = 0x07,
240
DW_FORM_string = 0x08,
241
DW_FORM_block = 0x09,
242
DW_FORM_block1 = 0x0a,
243
DW_FORM_data1 = 0x0b,
245
DW_FORM_sdata = 0x0d,
247
DW_FORM_udata = 0x0f,
248
DW_FORM_ref_addr = 0x10,
253
DW_FORM_ref_udata = 0x15,
254
DW_FORM_indirect = 0x16,
256
// Operation encodings
259
DW_OP_const1u = 0x08,
260
DW_OP_const1s = 0x09,
261
DW_OP_const2u = 0x0a,
262
DW_OP_const2s = 0x0b,
263
DW_OP_const4u = 0x0c,
264
DW_OP_const4s = 0x0d,
265
DW_OP_const8u = 0x0e,
266
DW_OP_const8s = 0x0f,
286
DW_OP_plus_uconst = 0x23,
312
DW_OP_deref_size = 0x94,
313
DW_OP_xderef_size = 0x95,
315
DW_OP_push_object_address = 0x97,
318
DW_OP_call_ref = 0x9a,
319
DW_OP_form_tls_address = 0x9b,
320
DW_OP_call_frame_cfa = 0x9c,
321
DW_OP_lo_user = 0xe0,
322
DW_OP_hi_user = 0xff,
324
// Encoding attribute values
325
DW_ATE_address = 0x01,
326
DW_ATE_boolean = 0x02,
327
DW_ATE_complex_float = 0x03,
329
DW_ATE_signed = 0x05,
330
DW_ATE_signed_char = 0x06,
331
DW_ATE_unsigned = 0x07,
332
DW_ATE_unsigned_char = 0x08,
333
DW_ATE_imaginary_float = 0x09,
334
DW_ATE_packed_decimal = 0x0a,
335
DW_ATE_numeric_string = 0x0b,
336
DW_ATE_edited = 0x0c,
337
DW_ATE_signed_fixed = 0x0d,
338
DW_ATE_unsigned_fixed = 0x0e,
339
DW_ATE_decimal_float = 0x0f,
340
DW_ATE_lo_user = 0x80,
341
DW_ATE_hi_user = 0xff,
343
// Decimal sign attribute values
344
DW_DS_unsigned = 0x01,
345
DW_DS_leading_overpunch = 0x02,
346
DW_DS_trailing_overpunch = 0x03,
347
DW_DS_leading_separate = 0x04,
348
DW_DS_trailing_separate = 0x05,
350
// Endianity attribute values
351
DW_END_default = 0x00,
353
DW_END_little = 0x02,
354
DW_END_lo_user = 0x40,
355
DW_END_hi_user = 0xff,
357
// Accessibility codes
358
DW_ACCESS_public = 0x01,
359
DW_ACCESS_protected = 0x02,
360
DW_ACCESS_private = 0x03,
364
DW_VIS_exported = 0x02,
365
DW_VIS_qualified = 0x03,
368
DW_VIRTUALITY_none = 0x00,
369
DW_VIRTUALITY_virtual = 0x01,
370
DW_VIRTUALITY_pure_virtual = 0x02,
373
DW_LANG_C89 = 0x0001,
375
DW_LANG_Ada83 = 0x0003,
376
DW_LANG_C_plus_plus = 0x0004,
377
DW_LANG_Cobol74 = 0x0005,
378
DW_LANG_Cobol85 = 0x0006,
379
DW_LANG_Fortran77 = 0x0007,
380
DW_LANG_Fortran90 = 0x0008,
381
DW_LANG_Pascal83 = 0x0009,
382
DW_LANG_Modula2 = 0x000a,
383
DW_LANG_Java = 0x000b,
384
DW_LANG_C99 = 0x000c,
385
DW_LANG_Ada95 = 0x000d,
386
DW_LANG_Fortran95 = 0x000e,
387
DW_LANG_PLI = 0x000f,
388
DW_LANG_ObjC = 0x0010,
389
DW_LANG_ObjC_plus_plus = 0x0011,
390
DW_LANG_UPC = 0x0012,
392
DW_LANG_lo_user = 0x8000,
393
DW_LANG_hi_user = 0xffff,
395
// Identifier case codes
396
DW_ID_case_sensitive = 0x00,
397
DW_ID_up_case = 0x01,
398
DW_ID_down_case = 0x02,
399
DW_ID_case_insensitive = 0x03,
401
// Calling convention codes
403
DW_CC_program = 0x02,
405
DW_CC_lo_user = 0x40,
406
DW_CC_hi_user = 0xff,
409
DW_INL_not_inlined = 0x00,
410
DW_INL_inlined = 0x01,
411
DW_INL_declared_not_inlined = 0x02,
412
DW_INL_declared_inlined = 0x03,
415
DW_ORD_row_major = 0x00,
416
DW_ORD_col_major = 0x01,
418
// Discriminant descriptor values
422
// Line Number Standard Opcode Encodings
424
DW_LNS_advance_pc = 0x02,
425
DW_LNS_advance_line = 0x03,
426
DW_LNS_set_file = 0x04,
427
DW_LNS_set_column = 0x05,
428
DW_LNS_negate_stmt = 0x06,
429
DW_LNS_set_basic_block = 0x07,
430
DW_LNS_const_add_pc = 0x08,
431
DW_LNS_fixed_advance_pc = 0x09,
432
DW_LNS_set_prologue_end = 0x0a,
433
DW_LNS_set_epilogue_begin = 0x0b,
434
DW_LNS_set_isa = 0x0c,
436
// Line Number Extended Opcode Encodings
437
DW_LNE_end_sequence = 0x01,
438
DW_LNE_set_address = 0x02,
439
DW_LNE_define_file = 0x03,
440
DW_LNE_lo_user = 0x80,
441
DW_LNE_hi_user = 0xff,
443
// Macinfo Type Encodings
444
DW_MACINFO_define = 0x01,
445
DW_MACINFO_undef = 0x02,
446
DW_MACINFO_start_file = 0x03,
447
DW_MACINFO_end_file = 0x04,
448
DW_MACINFO_vendor_ext = 0xff,
450
// Call frame instruction encodings
451
DW_CFA_extended = 0x00,
453
DW_CFA_advance_loc = 0x40,
454
DW_CFA_offset = 0x80,
455
DW_CFA_restore = 0xc0,
456
DW_CFA_set_loc = 0x01,
457
DW_CFA_advance_loc1 = 0x02,
458
DW_CFA_advance_loc2 = 0x03,
459
DW_CFA_advance_loc4 = 0x04,
460
DW_CFA_offset_extended = 0x05,
461
DW_CFA_restore_extended = 0x06,
462
DW_CFA_undefined = 0x07,
463
DW_CFA_same_value = 0x08,
464
DW_CFA_register = 0x09,
465
DW_CFA_remember_state = 0x0a,
466
DW_CFA_restore_state = 0x0b,
467
DW_CFA_def_cfa = 0x0c,
468
DW_CFA_def_cfa_register = 0x0d,
469
DW_CFA_def_cfa_offset = 0x0e,
470
DW_CFA_def_cfa_expression = 0x0f,
471
DW_CFA_expression = 0x10,
472
DW_CFA_offset_extended_sf = 0x11,
473
DW_CFA_def_cfa_sf = 0x12,
474
DW_CFA_def_cfa_offset_sf = 0x13,
475
DW_CFA_val_offset = 0x14,
476
DW_CFA_val_offset_sf = 0x15,
477
DW_CFA_val_expression = 0x16,
478
DW_CFA_lo_user = 0x1c,
479
DW_CFA_hi_user = 0x3f,
481
DW_EH_PE_absptr = 0x00,
482
DW_EH_PE_omit = 0xff,
483
DW_EH_PE_uleb128 = 0x01,
484
DW_EH_PE_udata2 = 0x02,
485
DW_EH_PE_udata4 = 0x03,
486
DW_EH_PE_udata8 = 0x04,
487
DW_EH_PE_sleb128 = 0x09,
488
DW_EH_PE_sdata2 = 0x0A,
489
DW_EH_PE_sdata4 = 0x0B,
490
DW_EH_PE_sdata8 = 0x0C,
491
DW_EH_PE_signed = 0x08,
492
DW_EH_PE_pcrel = 0x10,
493
DW_EH_PE_textrel = 0x20,
494
DW_EH_PE_datarel = 0x30,
495
DW_EH_PE_funcrel = 0x40,
496
DW_EH_PE_aligned = 0x50,
497
DW_EH_PE_indirect = 0x80
500
/// TagString - Return the string for the specified tag.
502
const char *TagString(unsigned Tag);
504
/// ChildrenString - Return the string for the specified children flag.
506
const char *ChildrenString(unsigned Children);
508
/// AttributeString - Return the string for the specified attribute.
510
const char *AttributeString(unsigned Attribute);
512
/// FormEncodingString - Return the string for the specified form encoding.
514
const char *FormEncodingString(unsigned Encoding);
516
/// OperationEncodingString - Return the string for the specified operation
518
const char *OperationEncodingString(unsigned Encoding);
520
/// AttributeEncodingString - Return the string for the specified attribute
522
const char *AttributeEncodingString(unsigned Encoding);
524
/// DecimalSignString - Return the string for the specified decimal sign
526
const char *DecimalSignString(unsigned Sign);
528
/// EndianityString - Return the string for the specified endianity.
530
const char *EndianityString(unsigned Endian);
532
/// AccessibilityString - Return the string for the specified accessibility.
534
const char *AccessibilityString(unsigned Access);
536
/// VisibilityString - Return the string for the specified visibility.
538
const char *VisibilityString(unsigned Visibility);
540
/// VirtualityString - Return the string for the specified virtuality.
542
const char *VirtualityString(unsigned Virtuality);
544
/// LanguageString - Return the string for the specified language.
546
const char *LanguageString(unsigned Language);
548
/// CaseString - Return the string for the specified identifier case.
550
const char *CaseString(unsigned Case);
552
/// ConventionString - Return the string for the specified calling convention.
554
const char *ConventionString(unsigned Convention);
556
/// InlineCodeString - Return the string for the specified inline code.
558
const char *InlineCodeString(unsigned Code);
560
/// ArrayOrderString - Return the string for the specified array order.
562
const char *ArrayOrderString(unsigned Order);
564
/// DiscriminantString - Return the string for the specified discriminant
566
const char *DiscriminantString(unsigned Discriminant);
568
/// LNStandardString - Return the string for the specified line number standard.
570
const char *LNStandardString(unsigned Standard);
572
/// LNExtendedString - Return the string for the specified line number extended
573
/// opcode encodings.
574
const char *LNExtendedString(unsigned Encoding);
576
/// MacinfoString - Return the string for the specified macinfo type encodings.
578
const char *MacinfoString(unsigned Encoding);
580
/// CallFrameString - Return the string for the specified call frame instruction
582
const char *CallFrameString(unsigned Encoding);
583
} // End of namespace dwarf
585
} // End of namespace llvm