LLVM API Documentation
00001 //===-- llvm/Support/Dwarf.h ---Dwarf Constants------------------*- C++ -*-===// 00002 // 00003 // The LLVM Compiler Infrastructure 00004 // 00005 // This file was developed by James M. Laskey and is distributed under the 00006 // University of Illinois Open Source License. See LICENSE.TXT for details. 00007 // 00008 //===----------------------------------------------------------------------===// 00009 // 00010 // This file contains constants used for implementing Dwarf debug support. For 00011 // Details on the Dwarf 3 specfication see DWARF Debugging Information Format 00012 // V.3 reference manual http://dwarf.freestandards.org , 00013 // 00014 //===----------------------------------------------------------------------===// 00015 00016 #ifndef LLVM_SUPPORT_DWARF_H 00017 #define LLVM_SUPPORT_DWARF_H 00018 00019 namespace llvm { 00020 00021 namespace dwarf { 00022 00023 //===----------------------------------------------------------------------===// 00024 // Dwarf constants as gleaned from the DWARF Debugging Information Format V.3 00025 // reference manual http://dwarf.freestandards.org . 00026 // 00027 00028 // Do not mix the following two enumerations sets. DW_TAG_invalid changes the 00029 // enumeration base type. 00030 00031 enum llvm_dwarf_constants { 00032 // llvm mock tags 00033 DW_TAG_invalid = ~0U, // Tag for invalid results. 00034 00035 DW_TAG_anchor = 0, // Tag for descriptor anchors. 00036 DW_TAG_auto_variable = 0x100, // Tag for local (auto) variables. 00037 DW_TAG_arg_variable = 0x101, // Tag for argument variables. 00038 DW_TAG_return_variable = 0x102, // Tag for return variables. 00039 00040 DW_TAG_user_base = 0x1000, // Recommended base for user tags. 00041 00042 DW_CIE_VERSION = 1, // Common frame information version. 00043 DW_CIE_ID = 0xffffffff // Common frame information mark. 00044 }; 00045 00046 enum dwarf_constants { 00047 DWARF_VERSION = 2, 00048 00049 // Tags 00050 DW_TAG_array_type = 0x01, 00051 DW_TAG_class_type = 0x02, 00052 DW_TAG_entry_point = 0x03, 00053 DW_TAG_enumeration_type = 0x04, 00054 DW_TAG_formal_parameter = 0x05, 00055 DW_TAG_imported_declaration = 0x08, 00056 DW_TAG_label = 0x0a, 00057 DW_TAG_lexical_block = 0x0b, 00058 DW_TAG_member = 0x0d, 00059 DW_TAG_pointer_type = 0x0f, 00060 DW_TAG_reference_type = 0x10, 00061 DW_TAG_compile_unit = 0x11, 00062 DW_TAG_string_type = 0x12, 00063 DW_TAG_structure_type = 0x13, 00064 DW_TAG_subroutine_type = 0x15, 00065 DW_TAG_typedef = 0x16, 00066 DW_TAG_union_type = 0x17, 00067 DW_TAG_unspecified_parameters = 0x18, 00068 DW_TAG_variant = 0x19, 00069 DW_TAG_common_block = 0x1a, 00070 DW_TAG_common_inclusion = 0x1b, 00071 DW_TAG_inheritance = 0x1c, 00072 DW_TAG_inlined_subroutine = 0x1d, 00073 DW_TAG_module = 0x1e, 00074 DW_TAG_ptr_to_member_type = 0x1f, 00075 DW_TAG_set_type = 0x20, 00076 DW_TAG_subrange_type = 0x21, 00077 DW_TAG_with_stmt = 0x22, 00078 DW_TAG_access_declaration = 0x23, 00079 DW_TAG_base_type = 0x24, 00080 DW_TAG_catch_block = 0x25, 00081 DW_TAG_const_type = 0x26, 00082 DW_TAG_constant = 0x27, 00083 DW_TAG_enumerator = 0x28, 00084 DW_TAG_file_type = 0x29, 00085 DW_TAG_friend = 0x2a, 00086 DW_TAG_namelist = 0x2b, 00087 DW_TAG_namelist_item = 0x2c, 00088 DW_TAG_packed_type = 0x2d, 00089 DW_TAG_subprogram = 0x2e, 00090 DW_TAG_template_type_parameter = 0x2f, 00091 DW_TAG_template_value_parameter = 0x30, 00092 DW_TAG_thrown_type = 0x31, 00093 DW_TAG_try_block = 0x32, 00094 DW_TAG_variant_part = 0x33, 00095 DW_TAG_variable = 0x34, 00096 DW_TAG_volatile_type = 0x35, 00097 DW_TAG_dwarf_procedure = 0x36, 00098 DW_TAG_restrict_type = 0x37, 00099 DW_TAG_interface_type = 0x38, 00100 DW_TAG_namespace = 0x39, 00101 DW_TAG_imported_module = 0x3a, 00102 DW_TAG_unspecified_type = 0x3b, 00103 DW_TAG_partial_unit = 0x3c, 00104 DW_TAG_imported_unit = 0x3d, 00105 DW_TAG_condition = 0x3f, 00106 DW_TAG_shared_type = 0x40, 00107 DW_TAG_lo_user = 0x4080, 00108 DW_TAG_hi_user = 0xffff, 00109 00110 // Children flag 00111 DW_CHILDREN_no = 0x00, 00112 DW_CHILDREN_yes = 0x01, 00113 00114 // Attributes 00115 DW_AT_sibling = 0x01, 00116 DW_AT_location = 0x02, 00117 DW_AT_name = 0x03, 00118 DW_AT_ordering = 0x09, 00119 DW_AT_byte_size = 0x0b, 00120 DW_AT_bit_offset = 0x0c, 00121 DW_AT_bit_size = 0x0d, 00122 DW_AT_stmt_list = 0x10, 00123 DW_AT_low_pc = 0x11, 00124 DW_AT_high_pc = 0x12, 00125 DW_AT_language = 0x13, 00126 DW_AT_discr = 0x15, 00127 DW_AT_discr_value = 0x16, 00128 DW_AT_visibility = 0x17, 00129 DW_AT_import = 0x18, 00130 DW_AT_string_length = 0x19, 00131 DW_AT_common_reference = 0x1a, 00132 DW_AT_comp_dir = 0x1b, 00133 DW_AT_const_value = 0x1c, 00134 DW_AT_containing_type = 0x1d, 00135 DW_AT_default_value = 0x1e, 00136 DW_AT_inline = 0x20, 00137 DW_AT_is_optional = 0x21, 00138 DW_AT_lower_bound = 0x22, 00139 DW_AT_producer = 0x25, 00140 DW_AT_prototyped = 0x27, 00141 DW_AT_return_addr = 0x2a, 00142 DW_AT_start_scope = 0x2c, 00143 DW_AT_bit_stride = 0x2e, 00144 DW_AT_upper_bound = 0x2f, 00145 DW_AT_abstract_origin = 0x31, 00146 DW_AT_accessibility = 0x32, 00147 DW_AT_address_class = 0x33, 00148 DW_AT_artificial = 0x34, 00149 DW_AT_base_types = 0x35, 00150 DW_AT_calling_convention = 0x36, 00151 DW_AT_count = 0x37, 00152 DW_AT_data_member_location = 0x38, 00153 DW_AT_decl_column = 0x39, 00154 DW_AT_decl_file = 0x3a, 00155 DW_AT_decl_line = 0x3b, 00156 DW_AT_declaration = 0x3c, 00157 DW_AT_discr_list = 0x3d, 00158 DW_AT_encoding = 0x3e, 00159 DW_AT_external = 0x3f, 00160 DW_AT_frame_base = 0x40, 00161 DW_AT_friend = 0x41, 00162 DW_AT_identifier_case = 0x42, 00163 DW_AT_macro_info = 0x43, 00164 DW_AT_namelist_item = 0x44, 00165 DW_AT_priority = 0x45, 00166 DW_AT_segment = 0x46, 00167 DW_AT_specification = 0x47, 00168 DW_AT_static_link = 0x48, 00169 DW_AT_type = 0x49, 00170 DW_AT_use_location = 0x4a, 00171 DW_AT_variable_parameter = 0x4b, 00172 DW_AT_virtuality = 0x4c, 00173 DW_AT_vtable_elem_location = 0x4d, 00174 DW_AT_allocated = 0x4e, 00175 DW_AT_associated = 0x4f, 00176 DW_AT_data_location = 0x50, 00177 DW_AT_byte_stride = 0x51, 00178 DW_AT_entry_pc = 0x52, 00179 DW_AT_use_UTF8 = 0x53, 00180 DW_AT_extension = 0x54, 00181 DW_AT_ranges = 0x55, 00182 DW_AT_trampoline = 0x56, 00183 DW_AT_call_column = 0x57, 00184 DW_AT_call_file = 0x58, 00185 DW_AT_call_line = 0x59, 00186 DW_AT_description = 0x5a, 00187 DW_AT_binary_scale = 0x5b, 00188 DW_AT_decimal_scale = 0x5c, 00189 DW_AT_small = 0x5d, 00190 DW_AT_decimal_sign = 0x5e, 00191 DW_AT_digit_count = 0x5f, 00192 DW_AT_picture_string = 0x60, 00193 DW_AT_mutable = 0x61, 00194 DW_AT_threads_scaled = 0x62, 00195 DW_AT_explicit = 0x63, 00196 DW_AT_object_pointer = 0x64, 00197 DW_AT_endianity = 0x65, 00198 DW_AT_elemental = 0x66, 00199 DW_AT_pure = 0x67, 00200 DW_AT_recursive = 0x68, 00201 DW_AT_lo_user = 0x2000, 00202 DW_AT_hi_user = 0x3fff, 00203 00204 // Attribute form encodings 00205 DW_FORM_addr = 0x01, 00206 DW_FORM_block2 = 0x03, 00207 DW_FORM_block4 = 0x04, 00208 DW_FORM_data2 = 0x05, 00209 DW_FORM_data4 = 0x06, 00210 DW_FORM_data8 = 0x07, 00211 DW_FORM_string = 0x08, 00212 DW_FORM_block = 0x09, 00213 DW_FORM_block1 = 0x0a, 00214 DW_FORM_data1 = 0x0b, 00215 DW_FORM_flag = 0x0c, 00216 DW_FORM_sdata = 0x0d, 00217 DW_FORM_strp = 0x0e, 00218 DW_FORM_udata = 0x0f, 00219 DW_FORM_ref_addr = 0x10, 00220 DW_FORM_ref1 = 0x11, 00221 DW_FORM_ref2 = 0x12, 00222 DW_FORM_ref4 = 0x13, 00223 DW_FORM_ref8 = 0x14, 00224 DW_FORM_ref_udata = 0x15, 00225 DW_FORM_indirect = 0x16, 00226 00227 // Operation encodings 00228 DW_OP_addr = 0x03, 00229 DW_OP_deref = 0x06, 00230 DW_OP_const1u = 0x08, 00231 DW_OP_const1s = 0x09, 00232 DW_OP_const2u = 0x0a, 00233 DW_OP_const2s = 0x0b, 00234 DW_OP_const4u = 0x0c, 00235 DW_OP_const4s = 0x0d, 00236 DW_OP_const8u = 0x0e, 00237 DW_OP_const8s = 0x0f, 00238 DW_OP_constu = 0x10, 00239 DW_OP_consts = 0x11, 00240 DW_OP_dup = 0x12, 00241 DW_OP_drop = 0x13, 00242 DW_OP_over = 0x14, 00243 DW_OP_pick = 0x15, 00244 DW_OP_swap = 0x16, 00245 DW_OP_rot = 0x17, 00246 DW_OP_xderef = 0x18, 00247 DW_OP_abs = 0x19, 00248 DW_OP_and = 0x1a, 00249 DW_OP_div = 0x1b, 00250 DW_OP_minus = 0x1c, 00251 DW_OP_mod = 0x1d, 00252 DW_OP_mul = 0x1e, 00253 DW_OP_neg = 0x1f, 00254 DW_OP_not = 0x20, 00255 DW_OP_or = 0x21, 00256 DW_OP_plus = 0x22, 00257 DW_OP_plus_uconst = 0x23, 00258 DW_OP_shl = 0x24, 00259 DW_OP_shr = 0x25, 00260 DW_OP_shra = 0x26, 00261 DW_OP_xor = 0x27, 00262 DW_OP_skip = 0x2f, 00263 DW_OP_bra = 0x28, 00264 DW_OP_eq = 0x29, 00265 DW_OP_ge = 0x2a, 00266 DW_OP_gt = 0x2b, 00267 DW_OP_le = 0x2c, 00268 DW_OP_lt = 0x2d, 00269 DW_OP_ne = 0x2e, 00270 DW_OP_lit0 = 0x30, 00271 DW_OP_lit1 = 0x31, 00272 DW_OP_lit31 = 0x4f, 00273 DW_OP_reg0 = 0x50, 00274 DW_OP_reg1 = 0x51, 00275 DW_OP_reg31 = 0x6f, 00276 DW_OP_breg0 = 0x70, 00277 DW_OP_breg1 = 0x71, 00278 DW_OP_breg31 = 0x8f, 00279 DW_OP_regx = 0x90, 00280 DW_OP_fbreg = 0x91, 00281 DW_OP_bregx = 0x92, 00282 DW_OP_piece = 0x93, 00283 DW_OP_deref_size = 0x94, 00284 DW_OP_xderef_size = 0x95, 00285 DW_OP_nop = 0x96, 00286 DW_OP_push_object_address = 0x97, 00287 DW_OP_call2 = 0x98, 00288 DW_OP_call4 = 0x99, 00289 DW_OP_call_ref = 0x9a, 00290 DW_OP_form_tls_address = 0x9b, 00291 DW_OP_call_frame_cfa = 0x9c, 00292 DW_OP_lo_user = 0xe0, 00293 DW_OP_hi_user = 0xff, 00294 00295 // Encoding attribute values 00296 DW_ATE_address = 0x01, 00297 DW_ATE_boolean = 0x02, 00298 DW_ATE_complex_float = 0x03, 00299 DW_ATE_float = 0x04, 00300 DW_ATE_signed = 0x05, 00301 DW_ATE_signed_char = 0x06, 00302 DW_ATE_unsigned = 0x07, 00303 DW_ATE_unsigned_char = 0x08, 00304 DW_ATE_imaginary_float = 0x09, 00305 DW_ATE_packed_decimal = 0x0a, 00306 DW_ATE_numeric_string = 0x0b, 00307 DW_ATE_edited = 0x0c, 00308 DW_ATE_signed_fixed = 0x0d, 00309 DW_ATE_unsigned_fixed = 0x0e, 00310 DW_ATE_decimal_float = 0x0f, 00311 DW_ATE_lo_user = 0x80, 00312 DW_ATE_hi_user = 0xff, 00313 00314 // Decimal sign attribute values 00315 DW_DS_unsigned = 0x01, 00316 DW_DS_leading_overpunch = 0x02, 00317 DW_DS_trailing_overpunch = 0x03, 00318 DW_DS_leading_separate = 0x04, 00319 DW_DS_trailing_separate = 0x05, 00320 00321 // Endianity attribute values 00322 DW_END_default = 0x00, 00323 DW_END_big = 0x01, 00324 DW_END_little = 0x02, 00325 DW_END_lo_user = 0x40, 00326 DW_END_hi_user = 0xff, 00327 00328 // Accessibility codes 00329 DW_ACCESS_public = 0x01, 00330 DW_ACCESS_protected = 0x02, 00331 DW_ACCESS_private = 0x03, 00332 00333 // Visibility codes 00334 DW_VIS_local = 0x01, 00335 DW_VIS_exported = 0x02, 00336 DW_VIS_qualified = 0x03, 00337 00338 // Virtuality codes 00339 DW_VIRTUALITY_none = 0x00, 00340 DW_VIRTUALITY_virtual = 0x01, 00341 DW_VIRTUALITY_pure_virtual = 0x02, 00342 00343 // Language names 00344 DW_LANG_C89 = 0x0001, 00345 DW_LANG_C = 0x0002, 00346 DW_LANG_Ada83 = 0x0003, 00347 DW_LANG_C_plus_plus = 0x0004, 00348 DW_LANG_Cobol74 = 0x0005, 00349 DW_LANG_Cobol85 = 0x0006, 00350 DW_LANG_Fortran77 = 0x0007, 00351 DW_LANG_Fortran90 = 0x0008, 00352 DW_LANG_Pascal83 = 0x0009, 00353 DW_LANG_Modula2 = 0x000a, 00354 DW_LANG_Java = 0x000b, 00355 DW_LANG_C99 = 0x000c, 00356 DW_LANG_Ada95 = 0x000d, 00357 DW_LANG_Fortran95 = 0x000e, 00358 DW_LANG_PLI = 0x000f, 00359 DW_LANG_ObjC = 0x0010, 00360 DW_LANG_ObjC_plus_plus = 0x0011, 00361 DW_LANG_UPC = 0x0012, 00362 DW_LANG_D = 0x0013, 00363 DW_LANG_lo_user = 0x8000, 00364 DW_LANG_hi_user = 0xffff, 00365 00366 // Identifier case codes 00367 DW_ID_case_sensitive = 0x00, 00368 DW_ID_up_case = 0x01, 00369 DW_ID_down_case = 0x02, 00370 DW_ID_case_insensitive = 0x03, 00371 00372 // Calling convention codes 00373 DW_CC_normal = 0x01, 00374 DW_CC_program = 0x02, 00375 DW_CC_nocall = 0x03, 00376 DW_CC_lo_user = 0x40, 00377 DW_CC_hi_user = 0xff, 00378 00379 // Inline codes 00380 DW_INL_not_inlined = 0x00, 00381 DW_INL_inlined = 0x01, 00382 DW_INL_declared_not_inlined = 0x02, 00383 DW_INL_declared_inlined = 0x03, 00384 00385 // Array ordering 00386 DW_ORD_row_major = 0x00, 00387 DW_ORD_col_major = 0x01, 00388 00389 // Discriminant descriptor values 00390 DW_DSC_label = 0x00, 00391 DW_DSC_range = 0x01, 00392 00393 // Line Number Standard Opcode Encodings 00394 DW_LNS_copy = 0x01, 00395 DW_LNS_advance_pc = 0x02, 00396 DW_LNS_advance_line = 0x03, 00397 DW_LNS_set_file = 0x04, 00398 DW_LNS_set_column = 0x05, 00399 DW_LNS_negate_stmt = 0x06, 00400 DW_LNS_set_basic_block = 0x07, 00401 DW_LNS_const_add_pc = 0x08, 00402 DW_LNS_fixed_advance_pc = 0x09, 00403 DW_LNS_set_prologue_end = 0x0a, 00404 DW_LNS_set_epilogue_begin = 0x0b, 00405 DW_LNS_set_isa = 0x0c, 00406 00407 // Line Number Extended Opcode Encodings 00408 DW_LNE_end_sequence = 0x01, 00409 DW_LNE_set_address = 0x02, 00410 DW_LNE_define_file = 0x03, 00411 DW_LNE_lo_user = 0x80, 00412 DW_LNE_hi_user = 0xff, 00413 00414 // Macinfo Type Encodings 00415 DW_MACINFO_define = 0x01, 00416 DW_MACINFO_undef = 0x02, 00417 DW_MACINFO_start_file = 0x03, 00418 DW_MACINFO_end_file = 0x04, 00419 DW_MACINFO_vendor_ext = 0xff, 00420 00421 // Call frame instruction encodings 00422 DW_CFA_extended = 0x00, 00423 DW_CFA_advance_loc = 0x40, 00424 DW_CFA_offset = 0x80, 00425 DW_CFA_restore = 0xc0, 00426 DW_CFA_set_loc = 0x01, 00427 DW_CFA_advance_loc1 = 0x02, 00428 DW_CFA_advance_loc2 = 0x03, 00429 DW_CFA_advance_loc4 = 0x04, 00430 DW_CFA_offset_extended = 0x05, 00431 DW_CFA_restore_extended = 0x06, 00432 DW_CFA_undefined = 0x07, 00433 DW_CFA_same_value = 0x08, 00434 DW_CFA_register = 0x09, 00435 DW_CFA_remember_state = 0x0a, 00436 DW_CFA_restore_state = 0x0b, 00437 DW_CFA_def_cfa = 0x0c, 00438 DW_CFA_def_cfa_register = 0x0d, 00439 DW_CFA_def_cfa_offset = 0x0e, 00440 DW_CFA_def_cfa_expression = 0x0f, 00441 DW_CFA_expression = 0x10, 00442 DW_CFA_offset_extended_sf = 0x11, 00443 DW_CFA_def_cfa_sf = 0x12, 00444 DW_CFA_def_cfa_offset_sf = 0x13, 00445 DW_CFA_val_offset = 0x14, 00446 DW_CFA_val_offset_sf = 0x15, 00447 DW_CFA_val_expression = 0x16, 00448 DW_CFA_lo_user = 0x1c, 00449 DW_CFA_hi_user = 0x3f 00450 }; 00451 00452 /// TagString - Return the string for the specified tag. 00453 /// 00454 const char *TagString(unsigned Tag); 00455 00456 /// ChildrenString - Return the string for the specified children flag. 00457 /// 00458 const char *ChildrenString(unsigned Children); 00459 00460 /// AttributeString - Return the string for the specified attribute. 00461 /// 00462 const char *AttributeString(unsigned Attribute); 00463 00464 /// FormEncodingString - Return the string for the specified form encoding. 00465 /// 00466 const char *FormEncodingString(unsigned Encoding); 00467 00468 /// OperationEncodingString - Return the string for the specified operation 00469 /// encoding. 00470 const char *OperationEncodingString(unsigned Encoding); 00471 00472 /// AttributeEncodingString - Return the string for the specified attribute 00473 /// encoding. 00474 const char *AttributeEncodingString(unsigned Encoding); 00475 00476 /// DecimalSignString - Return the string for the specified decimal sign 00477 /// attribute. 00478 const char *DecimalSignString(unsigned Sign); 00479 00480 /// EndianityString - Return the string for the specified endianity. 00481 /// 00482 const char *EndianityString(unsigned Endian); 00483 00484 /// AccessibilityString - Return the string for the specified accessibility. 00485 /// 00486 const char *AccessibilityString(unsigned Access); 00487 00488 /// VisibilityString - Return the string for the specified visibility. 00489 /// 00490 const char *VisibilityString(unsigned Visibility); 00491 00492 /// VirtualityString - Return the string for the specified virtuality. 00493 /// 00494 const char *VirtualityString(unsigned Virtuality); 00495 00496 /// LanguageString - Return the string for the specified language. 00497 /// 00498 const char *LanguageString(unsigned Language); 00499 00500 /// CaseString - Return the string for the specified identifier case. 00501 /// 00502 const char *CaseString(unsigned Case); 00503 00504 /// ConventionString - Return the string for the specified calling convention. 00505 /// 00506 const char *ConventionString(unsigned Convention); 00507 00508 /// InlineCodeString - Return the string for the specified inline code. 00509 /// 00510 const char *InlineCodeString(unsigned Code); 00511 00512 /// ArrayOrderString - Return the string for the specified array order. 00513 /// 00514 const char *ArrayOrderString(unsigned Order); 00515 00516 /// DiscriminantString - Return the string for the specified discriminant 00517 /// descriptor. 00518 const char *DiscriminantString(unsigned Discriminant); 00519 00520 /// LNStandardString - Return the string for the specified line number standard. 00521 /// 00522 const char *LNStandardString(unsigned Standard); 00523 00524 /// LNExtendedString - Return the string for the specified line number extended 00525 /// opcode encodings. 00526 const char *LNExtendedString(unsigned Encoding); 00527 00528 /// MacinfoString - Return the string for the specified macinfo type encodings. 00529 /// 00530 const char *MacinfoString(unsigned Encoding); 00531 00532 /// CallFrameString - Return the string for the specified call frame instruction 00533 /// encodings. 00534 const char *CallFrameString(unsigned Encoding); 00535 00536 } // End of namespace dwarf 00537 00538 } // End of namespace llvm 00539 00540 #endif