• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /* This file defines standard DWARF types, structures, and macros.
2    Copyright (C) 2000-2011, 2014, 2016, 2017, 2018 Red Hat, Inc.
3    This file is part of elfutils.
4 
5    This file is free software; you can redistribute it and/or modify
6    it under the terms of either
7 
8      * the GNU Lesser General Public License as published by the Free
9        Software Foundation; either version 3 of the License, or (at
10        your option) any later version
11 
12    or
13 
14      * the GNU General Public License as published by the Free
15        Software Foundation; either version 2 of the License, or (at
16        your option) any later version
17 
18    or both in parallel, as here.
19 
20    elfutils is distributed in the hope that it will be useful, but
21    WITHOUT ANY WARRANTY; without even the implied warranty of
22    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
23    General Public License for more details.
24 
25    You should have received copies of the GNU General Public License and
26    the GNU Lesser General Public License along with this program.  If
27    not, see <http://www.gnu.org/licenses/>.  */
28 
29 #ifndef _DWARF_H
30 #define	_DWARF_H 1
31 
32 /* DWARF Unit Header Types.  */
33 enum
34   {
35     DW_UT_compile = 0x01,
36     DW_UT_type = 0x02,
37     DW_UT_partial = 0x03,
38     DW_UT_skeleton = 0x04,
39     DW_UT_split_compile = 0x05,
40     DW_UT_split_type = 0x06,
41 
42     DW_UT_lo_user = 0x80,
43     DW_UT_hi_user = 0xff
44   };
45 
46 /* DWARF tags.  */
47 enum
48   {
49     DW_TAG_array_type = 0x01,
50     DW_TAG_class_type = 0x02,
51     DW_TAG_entry_point = 0x03,
52     DW_TAG_enumeration_type = 0x04,
53     DW_TAG_formal_parameter = 0x05,
54     /* 0x06 reserved.  */
55     /* 0x07 reserved.  */
56     DW_TAG_imported_declaration = 0x08,
57     /* 0x09 reserved.  */
58     DW_TAG_label = 0x0a,
59     DW_TAG_lexical_block = 0x0b,
60     /* 0x0c reserved.  */
61     DW_TAG_member = 0x0d,
62     /* 0x0e reserved.  */
63     DW_TAG_pointer_type = 0x0f,
64     DW_TAG_reference_type = 0x10,
65     DW_TAG_compile_unit = 0x11,
66     DW_TAG_string_type = 0x12,
67     DW_TAG_structure_type = 0x13,
68     /* 0x14 reserved.  */
69     DW_TAG_subroutine_type = 0x15,
70     DW_TAG_typedef = 0x16,
71     DW_TAG_union_type = 0x17,
72     DW_TAG_unspecified_parameters = 0x18,
73     DW_TAG_variant = 0x19,
74     DW_TAG_common_block = 0x1a,
75     DW_TAG_common_inclusion = 0x1b,
76     DW_TAG_inheritance = 0x1c,
77     DW_TAG_inlined_subroutine = 0x1d,
78     DW_TAG_module = 0x1e,
79     DW_TAG_ptr_to_member_type = 0x1f,
80     DW_TAG_set_type = 0x20,
81     DW_TAG_subrange_type = 0x21,
82     DW_TAG_with_stmt = 0x22,
83     DW_TAG_access_declaration = 0x23,
84     DW_TAG_base_type = 0x24,
85     DW_TAG_catch_block = 0x25,
86     DW_TAG_const_type = 0x26,
87     DW_TAG_constant = 0x27,
88     DW_TAG_enumerator = 0x28,
89     DW_TAG_file_type = 0x29,
90     DW_TAG_friend = 0x2a,
91     DW_TAG_namelist = 0x2b,
92     DW_TAG_namelist_item = 0x2c,
93     DW_TAG_packed_type = 0x2d,
94     DW_TAG_subprogram = 0x2e,
95     DW_TAG_template_type_parameter = 0x2f,
96     DW_TAG_template_value_parameter = 0x30,
97     DW_TAG_thrown_type = 0x31,
98     DW_TAG_try_block = 0x32,
99     DW_TAG_variant_part = 0x33,
100     DW_TAG_variable = 0x34,
101     DW_TAG_volatile_type = 0x35,
102     DW_TAG_dwarf_procedure = 0x36,
103     DW_TAG_restrict_type = 0x37,
104     DW_TAG_interface_type = 0x38,
105     DW_TAG_namespace = 0x39,
106     DW_TAG_imported_module = 0x3a,
107     DW_TAG_unspecified_type = 0x3b,
108     DW_TAG_partial_unit = 0x3c,
109     DW_TAG_imported_unit = 0x3d,
110     /* 0x3e reserved.  Was DW_TAG_mutable_type.  */
111     DW_TAG_condition = 0x3f,
112     DW_TAG_shared_type = 0x40,
113     DW_TAG_type_unit = 0x41,
114     DW_TAG_rvalue_reference_type = 0x42,
115     DW_TAG_template_alias = 0x43,
116     DW_TAG_coarray_type = 0x44,
117     DW_TAG_generic_subrange = 0x45,
118     DW_TAG_dynamic_type = 0x46,
119     DW_TAG_atomic_type = 0x47,
120     DW_TAG_call_site = 0x48,
121     DW_TAG_call_site_parameter = 0x49,
122     DW_TAG_skeleton_unit = 0x4a,
123     DW_TAG_immutable_type = 0x4b,
124 
125     DW_TAG_lo_user = 0x4080,
126 
127     DW_TAG_MIPS_loop = 0x4081,
128     DW_TAG_format_label = 0x4101,
129     DW_TAG_function_template = 0x4102,
130     DW_TAG_class_template = 0x4103,
131 
132     DW_TAG_GNU_BINCL = 0x4104,
133     DW_TAG_GNU_EINCL = 0x4105,
134 
135     DW_TAG_GNU_template_template_param = 0x4106,
136     DW_TAG_GNU_template_parameter_pack = 0x4107,
137     DW_TAG_GNU_formal_parameter_pack = 0x4108,
138     DW_TAG_GNU_call_site = 0x4109,
139     DW_TAG_GNU_call_site_parameter = 0x410a,
140 
141     DW_TAG_hi_user = 0xffff
142   };
143 
144 
145 /* Children determination encodings.  */
146 enum
147   {
148     DW_CHILDREN_no = 0,
149     DW_CHILDREN_yes = 1
150   };
151 
152 
153 /* DWARF attributes encodings.  */
154 enum
155   {
156     DW_AT_sibling = 0x01,
157     DW_AT_location = 0x02,
158     DW_AT_name = 0x03,
159     /* 0x04 reserved.  */
160     /* 0x05 reserved.  */
161     /* 0x06 reserved.  */
162     /* 0x07 reserved.  */
163     /* 0x08 reserved.  */
164     DW_AT_ordering = 0x09,
165     /* 0x0a reserved.  */
166     DW_AT_byte_size = 0x0b,
167     DW_AT_bit_offset = 0x0c,  /* Deprecated in DWARF4.  */
168     DW_AT_bit_size = 0x0d,
169     /* 0x0e reserved.  */
170     /* 0x0f reserved.  */
171     DW_AT_stmt_list = 0x10,
172     DW_AT_low_pc = 0x11,
173     DW_AT_high_pc = 0x12,
174     DW_AT_language = 0x13,
175     /* 0x14 reserved.  */
176     DW_AT_discr = 0x15,
177     DW_AT_discr_value = 0x16,
178     DW_AT_visibility = 0x17,
179     DW_AT_import = 0x18,
180     DW_AT_string_length = 0x19,
181     DW_AT_common_reference = 0x1a,
182     DW_AT_comp_dir = 0x1b,
183     DW_AT_const_value = 0x1c,
184     DW_AT_containing_type = 0x1d,
185     DW_AT_default_value = 0x1e,
186     /* 0x1f reserved.  */
187     DW_AT_inline = 0x20,
188     DW_AT_is_optional = 0x21,
189     DW_AT_lower_bound = 0x22,
190     /* 0x23 reserved.  */
191     /* 0x24 reserved.  */
192     DW_AT_producer = 0x25,
193     /* 0x26 reserved.  */
194     DW_AT_prototyped = 0x27,
195     /* 0x28 reserved.  */
196     /* 0x29 reserved.  */
197     DW_AT_return_addr = 0x2a,
198     /* 0x2b reserved.  */
199     DW_AT_start_scope = 0x2c,
200     /* 0x2d reserved.  */
201     DW_AT_bit_stride = 0x2e,
202     DW_AT_upper_bound = 0x2f,
203     /* 0x30 reserved.  */
204     DW_AT_abstract_origin = 0x31,
205     DW_AT_accessibility = 0x32,
206     DW_AT_address_class = 0x33,
207     DW_AT_artificial = 0x34,
208     DW_AT_base_types = 0x35,
209     DW_AT_calling_convention = 0x36,
210     DW_AT_count = 0x37,
211     DW_AT_data_member_location = 0x38,
212     DW_AT_decl_column = 0x39,
213     DW_AT_decl_file = 0x3a,
214     DW_AT_decl_line = 0x3b,
215     DW_AT_declaration = 0x3c,
216     DW_AT_discr_list = 0x3d,
217     DW_AT_encoding = 0x3e,
218     DW_AT_external = 0x3f,
219     DW_AT_frame_base = 0x40,
220     DW_AT_friend = 0x41,
221     DW_AT_identifier_case = 0x42,
222     DW_AT_macro_info = 0x43, /* Deprecated in DWARF5.  */
223     DW_AT_namelist_item = 0x44,
224     DW_AT_priority = 0x45,
225     DW_AT_segment = 0x46,
226     DW_AT_specification = 0x47,
227     DW_AT_static_link = 0x48,
228     DW_AT_type = 0x49,
229     DW_AT_use_location = 0x4a,
230     DW_AT_variable_parameter = 0x4b,
231     DW_AT_virtuality = 0x4c,
232     DW_AT_vtable_elem_location = 0x4d,
233     DW_AT_allocated = 0x4e,
234     DW_AT_associated = 0x4f,
235     DW_AT_data_location = 0x50,
236     DW_AT_byte_stride = 0x51,
237     DW_AT_entry_pc = 0x52,
238     DW_AT_use_UTF8 = 0x53,
239     DW_AT_extension = 0x54,
240     DW_AT_ranges = 0x55,
241     DW_AT_trampoline = 0x56,
242     DW_AT_call_column = 0x57,
243     DW_AT_call_file = 0x58,
244     DW_AT_call_line = 0x59,
245     DW_AT_description = 0x5a,
246     DW_AT_binary_scale = 0x5b,
247     DW_AT_decimal_scale = 0x5c,
248     DW_AT_small = 0x5d,
249     DW_AT_decimal_sign = 0x5e,
250     DW_AT_digit_count = 0x5f,
251     DW_AT_picture_string = 0x60,
252     DW_AT_mutable = 0x61,
253     DW_AT_threads_scaled = 0x62,
254     DW_AT_explicit = 0x63,
255     DW_AT_object_pointer = 0x64,
256     DW_AT_endianity = 0x65,
257     DW_AT_elemental = 0x66,
258     DW_AT_pure = 0x67,
259     DW_AT_recursive = 0x68,
260     DW_AT_signature = 0x69,
261     DW_AT_main_subprogram = 0x6a,
262     DW_AT_data_bit_offset = 0x6b,
263     DW_AT_const_expr = 0x6c,
264     DW_AT_enum_class = 0x6d,
265     DW_AT_linkage_name = 0x6e,
266     DW_AT_string_length_bit_size = 0x6f,
267     DW_AT_string_length_byte_size = 0x70,
268     DW_AT_rank = 0x71,
269     DW_AT_str_offsets_base = 0x72,
270     DW_AT_addr_base = 0x73,
271     DW_AT_rnglists_base = 0x74,
272     /* 0x75 reserved.  */
273     DW_AT_dwo_name = 0x76,
274     DW_AT_reference = 0x77,
275     DW_AT_rvalue_reference = 0x78,
276     DW_AT_macros = 0x79,
277     DW_AT_call_all_calls = 0x7a,
278     DW_AT_call_all_source_calls = 0x7b,
279     DW_AT_call_all_tail_calls = 0x7c,
280     DW_AT_call_return_pc = 0x7d,
281     DW_AT_call_value = 0x7e,
282     DW_AT_call_origin = 0x7f,
283     DW_AT_call_parameter = 0x80,
284     DW_AT_call_pc = 0x81,
285     DW_AT_call_tail_call = 0x82,
286     DW_AT_call_target = 0x83,
287     DW_AT_call_target_clobbered = 0x84,
288     DW_AT_call_data_location = 0x85,
289     DW_AT_call_data_value = 0x86,
290     DW_AT_noreturn = 0x87,
291     DW_AT_alignment = 0x88,
292     DW_AT_export_symbols = 0x89,
293     DW_AT_deleted = 0x8a,
294     DW_AT_defaulted = 0x8b,
295     DW_AT_loclists_base = 0x8c,
296 
297     DW_AT_lo_user = 0x2000,
298 
299     DW_AT_MIPS_fde = 0x2001,
300     DW_AT_MIPS_loop_begin = 0x2002,
301     DW_AT_MIPS_tail_loop_begin = 0x2003,
302     DW_AT_MIPS_epilog_begin = 0x2004,
303     DW_AT_MIPS_loop_unroll_factor = 0x2005,
304     DW_AT_MIPS_software_pipeline_depth = 0x2006,
305     DW_AT_MIPS_linkage_name = 0x2007,
306     DW_AT_MIPS_stride = 0x2008,
307     DW_AT_MIPS_abstract_name = 0x2009,
308     DW_AT_MIPS_clone_origin = 0x200a,
309     DW_AT_MIPS_has_inlines = 0x200b,
310     DW_AT_MIPS_stride_byte = 0x200c,
311     DW_AT_MIPS_stride_elem = 0x200d,
312     DW_AT_MIPS_ptr_dopetype = 0x200e,
313     DW_AT_MIPS_allocatable_dopetype = 0x200f,
314     DW_AT_MIPS_assumed_shape_dopetype = 0x2010,
315     DW_AT_MIPS_assumed_size = 0x2011,
316 
317     /* GNU extensions.  */
318     DW_AT_sf_names = 0x2101,
319     DW_AT_src_info = 0x2102,
320     DW_AT_mac_info = 0x2103,
321     DW_AT_src_coords = 0x2104,
322     DW_AT_body_begin = 0x2105,
323     DW_AT_body_end = 0x2106,
324     DW_AT_GNU_vector = 0x2107,
325     DW_AT_GNU_guarded_by = 0x2108,
326     DW_AT_GNU_pt_guarded_by = 0x2109,
327     DW_AT_GNU_guarded = 0x210a,
328     DW_AT_GNU_pt_guarded = 0x210b,
329     DW_AT_GNU_locks_excluded = 0x210c,
330     DW_AT_GNU_exclusive_locks_required = 0x210d,
331     DW_AT_GNU_shared_locks_required = 0x210e,
332     DW_AT_GNU_odr_signature = 0x210f,
333     DW_AT_GNU_template_name = 0x2110,
334     DW_AT_GNU_call_site_value = 0x2111,
335     DW_AT_GNU_call_site_data_value = 0x2112,
336     DW_AT_GNU_call_site_target = 0x2113,
337     DW_AT_GNU_call_site_target_clobbered = 0x2114,
338     DW_AT_GNU_tail_call = 0x2115,
339     DW_AT_GNU_all_tail_call_sites = 0x2116,
340     DW_AT_GNU_all_call_sites = 0x2117,
341     DW_AT_GNU_all_source_call_sites = 0x2118,
342     DW_AT_GNU_locviews = 0x2137,
343     DW_AT_GNU_entry_view = 0x2138,
344     DW_AT_GNU_macros = 0x2119,
345     DW_AT_GNU_deleted = 0x211a,
346     /* GNU Debug Fission extensions.  */
347     DW_AT_GNU_dwo_name = 0x2130,
348     DW_AT_GNU_dwo_id = 0x2131,
349     DW_AT_GNU_ranges_base = 0x2132,
350     DW_AT_GNU_addr_base = 0x2133,
351     DW_AT_GNU_pubnames = 0x2134,
352     DW_AT_GNU_pubtypes = 0x2135,
353 
354     /* https://gcc.gnu.org/wiki/DW_AT_GNU_numerator_denominator  */
355     DW_AT_GNU_numerator = 0x2303,
356     DW_AT_GNU_denominator = 0x2304,
357     /* https://gcc.gnu.org/wiki/DW_AT_GNU_bias  */
358     DW_AT_GNU_bias = 0x2305,
359 
360     DW_AT_hi_user = 0x3fff
361   };
362 
363 /* Old unofficially attribute names.  Should not be used.
364    Will not appear in known-dwarf.h  */
365 
366 /* DWARF1 array subscripts and element data types.  */
367 #define DW_AT_subscr_data	0x0a
368 /* DWARF1 enumeration literals.  */
369 #define DW_AT_element_list	0x0f
370 /* DWARF1 reference for variable to member structure, class or union.  */
371 #define DW_AT_member		0x14
372 
373 /* DWARF form encodings.  */
374 enum
375   {
376     DW_FORM_addr = 0x01,
377     DW_FORM_block2 = 0x03,
378     DW_FORM_block4 = 0x04,
379     DW_FORM_data2 = 0x05,
380     DW_FORM_data4 = 0x06,
381     DW_FORM_data8 = 0x07,
382     DW_FORM_string = 0x08,
383     DW_FORM_block = 0x09,
384     DW_FORM_block1 = 0x0a,
385     DW_FORM_data1 = 0x0b,
386     DW_FORM_flag = 0x0c,
387     DW_FORM_sdata = 0x0d,
388     DW_FORM_strp = 0x0e,
389     DW_FORM_udata = 0x0f,
390     DW_FORM_ref_addr = 0x10,
391     DW_FORM_ref1 = 0x11,
392     DW_FORM_ref2 = 0x12,
393     DW_FORM_ref4 = 0x13,
394     DW_FORM_ref8 = 0x14,
395     DW_FORM_ref_udata = 0x15,
396     DW_FORM_indirect = 0x16,
397     DW_FORM_sec_offset = 0x17,
398     DW_FORM_exprloc = 0x18,
399     DW_FORM_flag_present = 0x19,
400     DW_FORM_strx = 0x1a,
401     DW_FORM_addrx = 0x1b,
402     DW_FORM_ref_sup4 = 0x1c,
403     DW_FORM_strp_sup = 0x1d,
404     DW_FORM_data16 = 0x1e,
405     DW_FORM_line_strp = 0x1f,
406     DW_FORM_ref_sig8 = 0x20,
407     DW_FORM_implicit_const = 0x21,
408     DW_FORM_loclistx = 0x22,
409     DW_FORM_rnglistx = 0x23,
410     DW_FORM_ref_sup8 = 0x24,
411     DW_FORM_strx1 = 0x25,
412     DW_FORM_strx2 = 0x26,
413     DW_FORM_strx3 = 0x27,
414     DW_FORM_strx4 = 0x28,
415     DW_FORM_addrx1 = 0x29,
416     DW_FORM_addrx2 = 0x2a,
417     DW_FORM_addrx3 = 0x2b,
418     DW_FORM_addrx4 = 0x2c,
419 
420     /* GNU Debug Fission extensions.  */
421     DW_FORM_GNU_addr_index = 0x1f01,
422     DW_FORM_GNU_str_index = 0x1f02,
423 
424     DW_FORM_GNU_ref_alt = 0x1f20, /* offset in alternate .debuginfo.  */
425     DW_FORM_GNU_strp_alt = 0x1f21 /* offset in alternate .debug_str. */
426   };
427 
428 
429 /* DWARF location operation encodings.  */
430 enum
431   {
432     DW_OP_addr = 0x03,		/* Constant address.  */
433     DW_OP_deref = 0x06,
434     DW_OP_const1u = 0x08,	/* Unsigned 1-byte constant.  */
435     DW_OP_const1s = 0x09,	/* Signed 1-byte constant.  */
436     DW_OP_const2u = 0x0a,	/* Unsigned 2-byte constant.  */
437     DW_OP_const2s = 0x0b,	/* Signed 2-byte constant.  */
438     DW_OP_const4u = 0x0c,	/* Unsigned 4-byte constant.  */
439     DW_OP_const4s = 0x0d,	/* Signed 4-byte constant.  */
440     DW_OP_const8u = 0x0e,	/* Unsigned 8-byte constant.  */
441     DW_OP_const8s = 0x0f,	/* Signed 8-byte constant.  */
442     DW_OP_constu = 0x10,	/* Unsigned LEB128 constant.  */
443     DW_OP_consts = 0x11,	/* Signed LEB128 constant.  */
444     DW_OP_dup = 0x12,
445     DW_OP_drop = 0x13,
446     DW_OP_over = 0x14,
447     DW_OP_pick = 0x15,		/* 1-byte stack index.  */
448     DW_OP_swap = 0x16,
449     DW_OP_rot = 0x17,
450     DW_OP_xderef = 0x18,
451     DW_OP_abs = 0x19,
452     DW_OP_and = 0x1a,
453     DW_OP_div = 0x1b,
454     DW_OP_minus = 0x1c,
455     DW_OP_mod = 0x1d,
456     DW_OP_mul = 0x1e,
457     DW_OP_neg = 0x1f,
458     DW_OP_not = 0x20,
459     DW_OP_or = 0x21,
460     DW_OP_plus = 0x22,
461     DW_OP_plus_uconst = 0x23,	/* Unsigned LEB128 addend.  */
462     DW_OP_shl = 0x24,
463     DW_OP_shr = 0x25,
464     DW_OP_shra = 0x26,
465     DW_OP_xor = 0x27,
466     DW_OP_bra = 0x28,		/* Signed 2-byte constant.  */
467     DW_OP_eq = 0x29,
468     DW_OP_ge = 0x2a,
469     DW_OP_gt = 0x2b,
470     DW_OP_le = 0x2c,
471     DW_OP_lt = 0x2d,
472     DW_OP_ne = 0x2e,
473     DW_OP_skip = 0x2f,		/* Signed 2-byte constant.  */
474     DW_OP_lit0 = 0x30,		/* Literal 0.  */
475     DW_OP_lit1 = 0x31,		/* Literal 1.  */
476     DW_OP_lit2 = 0x32,		/* Literal 2.  */
477     DW_OP_lit3 = 0x33,		/* Literal 3.  */
478     DW_OP_lit4 = 0x34,		/* Literal 4.  */
479     DW_OP_lit5 = 0x35,		/* Literal 5.  */
480     DW_OP_lit6 = 0x36,		/* Literal 6.  */
481     DW_OP_lit7 = 0x37,		/* Literal 7.  */
482     DW_OP_lit8 = 0x38,		/* Literal 8.  */
483     DW_OP_lit9 = 0x39,		/* Literal 9.  */
484     DW_OP_lit10 = 0x3a,		/* Literal 10.  */
485     DW_OP_lit11 = 0x3b,		/* Literal 11.  */
486     DW_OP_lit12 = 0x3c,		/* Literal 12.  */
487     DW_OP_lit13 = 0x3d,		/* Literal 13.  */
488     DW_OP_lit14 = 0x3e,		/* Literal 14.  */
489     DW_OP_lit15 = 0x3f,		/* Literal 15.  */
490     DW_OP_lit16 = 0x40,		/* Literal 16.  */
491     DW_OP_lit17 = 0x41,		/* Literal 17.  */
492     DW_OP_lit18 = 0x42,		/* Literal 18.  */
493     DW_OP_lit19 = 0x43,		/* Literal 19.  */
494     DW_OP_lit20 = 0x44,		/* Literal 20.  */
495     DW_OP_lit21 = 0x45,		/* Literal 21.  */
496     DW_OP_lit22 = 0x46,		/* Literal 22.  */
497     DW_OP_lit23 = 0x47,		/* Literal 23.  */
498     DW_OP_lit24 = 0x48,		/* Literal 24.  */
499     DW_OP_lit25 = 0x49,		/* Literal 25.  */
500     DW_OP_lit26 = 0x4a,		/* Literal 26.  */
501     DW_OP_lit27 = 0x4b,		/* Literal 27.  */
502     DW_OP_lit28 = 0x4c,		/* Literal 28.  */
503     DW_OP_lit29 = 0x4d,		/* Literal 29.  */
504     DW_OP_lit30 = 0x4e,		/* Literal 30.  */
505     DW_OP_lit31 = 0x4f,		/* Literal 31.  */
506     DW_OP_reg0 = 0x50,		/* Register 0.  */
507     DW_OP_reg1 = 0x51,		/* Register 1.  */
508     DW_OP_reg2 = 0x52,		/* Register 2.  */
509     DW_OP_reg3 = 0x53,		/* Register 3.  */
510     DW_OP_reg4 = 0x54,		/* Register 4.  */
511     DW_OP_reg5 = 0x55,		/* Register 5.  */
512     DW_OP_reg6 = 0x56,		/* Register 6.  */
513     DW_OP_reg7 = 0x57,		/* Register 7.  */
514     DW_OP_reg8 = 0x58,		/* Register 8.  */
515     DW_OP_reg9 = 0x59,		/* Register 9.  */
516     DW_OP_reg10 = 0x5a,		/* Register 10.  */
517     DW_OP_reg11 = 0x5b,		/* Register 11.  */
518     DW_OP_reg12 = 0x5c,		/* Register 12.  */
519     DW_OP_reg13 = 0x5d,		/* Register 13.  */
520     DW_OP_reg14 = 0x5e,		/* Register 14.  */
521     DW_OP_reg15 = 0x5f,		/* Register 15.  */
522     DW_OP_reg16 = 0x60,		/* Register 16.  */
523     DW_OP_reg17 = 0x61,		/* Register 17.  */
524     DW_OP_reg18 = 0x62,		/* Register 18.  */
525     DW_OP_reg19 = 0x63,		/* Register 19.  */
526     DW_OP_reg20 = 0x64,		/* Register 20.  */
527     DW_OP_reg21 = 0x65,		/* Register 21.  */
528     DW_OP_reg22 = 0x66,		/* Register 22.  */
529     DW_OP_reg23 = 0x67,		/* Register 24.  */
530     DW_OP_reg24 = 0x68,		/* Register 24.  */
531     DW_OP_reg25 = 0x69,		/* Register 25.  */
532     DW_OP_reg26 = 0x6a,		/* Register 26.  */
533     DW_OP_reg27 = 0x6b,		/* Register 27.  */
534     DW_OP_reg28 = 0x6c,		/* Register 28.  */
535     DW_OP_reg29 = 0x6d,		/* Register 29.  */
536     DW_OP_reg30 = 0x6e,		/* Register 30.  */
537     DW_OP_reg31 = 0x6f,		/* Register 31.  */
538     DW_OP_breg0 = 0x70,		/* Base register 0.  */
539     DW_OP_breg1 = 0x71,		/* Base register 1.  */
540     DW_OP_breg2 = 0x72,		/* Base register 2.  */
541     DW_OP_breg3 = 0x73,		/* Base register 3.  */
542     DW_OP_breg4 = 0x74,		/* Base register 4.  */
543     DW_OP_breg5 = 0x75,		/* Base register 5.  */
544     DW_OP_breg6 = 0x76,		/* Base register 6.  */
545     DW_OP_breg7 = 0x77,		/* Base register 7.  */
546     DW_OP_breg8 = 0x78,		/* Base register 8.  */
547     DW_OP_breg9 = 0x79,		/* Base register 9.  */
548     DW_OP_breg10 = 0x7a,	/* Base register 10.  */
549     DW_OP_breg11 = 0x7b,	/* Base register 11.  */
550     DW_OP_breg12 = 0x7c,	/* Base register 12.  */
551     DW_OP_breg13 = 0x7d,	/* Base register 13.  */
552     DW_OP_breg14 = 0x7e,	/* Base register 14.  */
553     DW_OP_breg15 = 0x7f,	/* Base register 15.  */
554     DW_OP_breg16 = 0x80,	/* Base register 16.  */
555     DW_OP_breg17 = 0x81,	/* Base register 17.  */
556     DW_OP_breg18 = 0x82,	/* Base register 18.  */
557     DW_OP_breg19 = 0x83,	/* Base register 19.  */
558     DW_OP_breg20 = 0x84,	/* Base register 20.  */
559     DW_OP_breg21 = 0x85,	/* Base register 21.  */
560     DW_OP_breg22 = 0x86,	/* Base register 22.  */
561     DW_OP_breg23 = 0x87,	/* Base register 23.  */
562     DW_OP_breg24 = 0x88,	/* Base register 24.  */
563     DW_OP_breg25 = 0x89,	/* Base register 25.  */
564     DW_OP_breg26 = 0x8a,	/* Base register 26.  */
565     DW_OP_breg27 = 0x8b,	/* Base register 27.  */
566     DW_OP_breg28 = 0x8c,	/* Base register 28.  */
567     DW_OP_breg29 = 0x8d,	/* Base register 29.  */
568     DW_OP_breg30 = 0x8e,	/* Base register 30.  */
569     DW_OP_breg31 = 0x8f,	/* Base register 31.  */
570     DW_OP_regx = 0x90,		/* Unsigned LEB128 register.  */
571     DW_OP_fbreg = 0x91,		/* Signed LEB128 offset.  */
572     DW_OP_bregx = 0x92,		/* ULEB128 register followed by SLEB128 off. */
573     DW_OP_piece = 0x93,		/* ULEB128 size of piece addressed. */
574     DW_OP_deref_size = 0x94,	/* 1-byte size of data retrieved.  */
575     DW_OP_xderef_size = 0x95,	/* 1-byte size of data retrieved.  */
576     DW_OP_nop = 0x96,
577     DW_OP_push_object_address = 0x97,
578     DW_OP_call2 = 0x98,
579     DW_OP_call4 = 0x99,
580     DW_OP_call_ref = 0x9a,
581     DW_OP_form_tls_address = 0x9b,/* TLS offset to address in current thread */
582     DW_OP_call_frame_cfa = 0x9c,/* CFA as determined by CFI.  */
583     DW_OP_bit_piece = 0x9d,	/* ULEB128 size and ULEB128 offset in bits.  */
584     DW_OP_implicit_value = 0x9e, /* DW_FORM_block follows opcode.  */
585     DW_OP_stack_value = 0x9f,	 /* No operands, special like DW_OP_piece.  */
586 
587     DW_OP_implicit_pointer = 0xa0,
588     DW_OP_addrx = 0xa1,
589     DW_OP_constx = 0xa2,
590     DW_OP_entry_value = 0xa3,
591     DW_OP_const_type = 0xa4,
592     DW_OP_regval_type = 0xa5,
593     DW_OP_deref_type = 0xa6,
594     DW_OP_xderef_type = 0xa7,
595     DW_OP_convert = 0xa8,
596     DW_OP_reinterpret = 0xa9,
597 
598     /* GNU extensions.  */
599     DW_OP_GNU_push_tls_address = 0xe0,
600     DW_OP_GNU_uninit = 0xf0,
601     DW_OP_GNU_encoded_addr = 0xf1,
602     DW_OP_GNU_implicit_pointer = 0xf2,
603     DW_OP_GNU_entry_value = 0xf3,
604     DW_OP_GNU_const_type = 0xf4,
605     DW_OP_GNU_regval_type = 0xf5,
606     DW_OP_GNU_deref_type = 0xf6,
607     DW_OP_GNU_convert = 0xf7,
608     DW_OP_GNU_reinterpret = 0xf9,
609     DW_OP_GNU_parameter_ref = 0xfa,
610 
611     /* GNU Debug Fission extensions.  */
612     DW_OP_GNU_addr_index = 0xfb,
613     DW_OP_GNU_const_index = 0xfc,
614 
615     DW_OP_GNU_variable_value = 0xfd,
616 
617     DW_OP_lo_user = 0xe0,	/* Implementation-defined range start.  */
618     DW_OP_hi_user = 0xff	/* Implementation-defined range end.  */
619   };
620 
621 
622 /* DWARF base type encodings.  */
623 enum
624   {
625     DW_ATE_void = 0x0,
626     DW_ATE_address = 0x1,
627     DW_ATE_boolean = 0x2,
628     DW_ATE_complex_float = 0x3,
629     DW_ATE_float = 0x4,
630     DW_ATE_signed = 0x5,
631     DW_ATE_signed_char = 0x6,
632     DW_ATE_unsigned = 0x7,
633     DW_ATE_unsigned_char = 0x8,
634     DW_ATE_imaginary_float = 0x9,
635     DW_ATE_packed_decimal = 0xa,
636     DW_ATE_numeric_string = 0xb,
637     DW_ATE_edited = 0xc,
638     DW_ATE_signed_fixed = 0xd,
639     DW_ATE_unsigned_fixed = 0xe,
640     DW_ATE_decimal_float = 0xf,
641     DW_ATE_UTF = 0x10,
642     DW_ATE_UCS = 0x11,
643     DW_ATE_ASCII = 0x12,
644 
645     DW_ATE_lo_user = 0x80,
646     DW_ATE_hi_user = 0xff
647   };
648 
649 
650 /* DWARF decimal sign encodings.  */
651 enum
652   {
653     DW_DS_unsigned = 1,
654     DW_DS_leading_overpunch = 2,
655     DW_DS_trailing_overpunch = 3,
656     DW_DS_leading_separate = 4,
657     DW_DS_trailing_separate = 5,
658   };
659 
660 
661 /* DWARF endianity encodings.  */
662 enum
663   {
664     DW_END_default = 0,
665     DW_END_big = 1,
666     DW_END_little = 2,
667 
668     DW_END_lo_user = 0x40,
669     DW_END_hi_user = 0xff
670   };
671 
672 
673 /* DWARF accessibility encodings.  */
674 enum
675   {
676     DW_ACCESS_public = 1,
677     DW_ACCESS_protected = 2,
678     DW_ACCESS_private = 3
679   };
680 
681 
682 /* DWARF visibility encodings.  */
683 enum
684   {
685     DW_VIS_local = 1,
686     DW_VIS_exported = 2,
687     DW_VIS_qualified = 3
688   };
689 
690 
691 /* DWARF virtuality encodings.  */
692 enum
693   {
694     DW_VIRTUALITY_none = 0,
695     DW_VIRTUALITY_virtual = 1,
696     DW_VIRTUALITY_pure_virtual = 2
697   };
698 
699 
700 /* DWARF language encodings.  */
701 enum
702   {
703     DW_LANG_C89 = 0x0001,	     /* ISO C:1989 */
704     DW_LANG_C = 0x0002,		     /* C */
705     DW_LANG_Ada83 = 0x0003,	     /* ISO Ada:1983 */
706     DW_LANG_C_plus_plus	= 0x0004,    /* ISO C++:1998 */
707     DW_LANG_Cobol74 = 0x0005,	     /* ISO Cobol:1974 */
708     DW_LANG_Cobol85 = 0x0006,	     /* ISO Cobol:1985 */
709     DW_LANG_Fortran77 = 0x0007,	     /* ISO FORTRAN 77 */
710     DW_LANG_Fortran90 = 0x0008,	     /* ISO Fortran 90 */
711     DW_LANG_Pascal83 = 0x0009,	     /* ISO Pascal:1983 */
712     DW_LANG_Modula2 = 0x000a,	     /* ISO Modula-2:1996 */
713     DW_LANG_Java = 0x000b,	     /* Java */
714     DW_LANG_C99 = 0x000c,	     /* ISO C:1999 */
715     DW_LANG_Ada95 = 0x000d,	     /* ISO Ada:1995 */
716     DW_LANG_Fortran95 = 0x000e,	     /* ISO Fortran 95 */
717     DW_LANG_PLI = 0x000f,	     /* ISO PL/1:1976 */
718     DW_LANG_ObjC = 0x0010,	     /* Objective-C */
719     DW_LANG_ObjC_plus_plus = 0x0011, /* Objective-C++ */
720     DW_LANG_UPC = 0x0012,	     /* Unified Parallel C */
721     DW_LANG_D = 0x0013,		     /* D */
722     DW_LANG_Python = 0x0014,	     /* Python */
723     DW_LANG_OpenCL = 0x0015,	     /* OpenCL */
724     DW_LANG_Go = 0x0016,	     /* Go */
725     DW_LANG_Modula3 = 0x0017,	     /* Modula-3 */
726     DW_LANG_Haskell = 0x0018,	     /* Haskell */
727     DW_LANG_C_plus_plus_03 = 0x0019, /* ISO C++:2003 */
728     DW_LANG_C_plus_plus_11 = 0x001a, /* ISO C++:2011 */
729     DW_LANG_OCaml = 0x001b,	     /* OCaml */
730     DW_LANG_Rust = 0x001c,	     /* Rust */
731     DW_LANG_C11 = 0x001d,	     /* ISO C:2011 */
732     DW_LANG_Swift = 0x001e,	     /* Swift */
733     DW_LANG_Julia = 0x001f,	     /* Julia */
734     DW_LANG_Dylan = 0x0020,	     /* Dylan */
735     DW_LANG_C_plus_plus_14 = 0x0021, /* ISO C++:2014 */
736     DW_LANG_Fortran03 = 0x0022,	     /* ISO/IEC 1539-1:2004 */
737     DW_LANG_Fortran08 = 0x0023,	     /* ISO/IEC 1539-1:2010 */
738     DW_LANG_RenderScript = 0x0024,   /* RenderScript Kernal Language */
739     DW_LANG_BLISS = 0x0025,	     /* BLISS */
740 
741     DW_LANG_lo_user = 0x8000,
742     DW_LANG_Mips_Assembler = 0x8001, /* Assembler */
743     DW_LANG_hi_user = 0xffff
744   };
745 
746 /* Old (typo) '1' != 'I'.  */
747 #define DW_LANG_PL1 DW_LANG_PLI
748 
749 /* DWARF identifier case encodings.  */
750 enum
751   {
752     DW_ID_case_sensitive = 0,
753     DW_ID_up_case = 1,
754     DW_ID_down_case = 2,
755     DW_ID_case_insensitive = 3
756   };
757 
758 
759 /* DWARF calling conventions encodings.
760    Used as values of DW_AT_calling_convention for subroutines
761    (normal, program or nocall) or structures, unions and class types
762    (normal, reference or value).  */
763 enum
764   {
765     DW_CC_normal = 0x1,
766     DW_CC_program = 0x2,
767     DW_CC_nocall = 0x3,
768     DW_CC_pass_by_reference = 0x4,
769     DW_CC_pass_by_value = 0x5,
770     DW_CC_lo_user = 0x40,
771     DW_CC_hi_user = 0xff
772   };
773 
774 
775 /* DWARF inline encodings.  */
776 enum
777   {
778     DW_INL_not_inlined = 0,
779     DW_INL_inlined = 1,
780     DW_INL_declared_not_inlined = 2,
781     DW_INL_declared_inlined = 3
782   };
783 
784 
785 /* DWARF ordering encodings.  */
786 enum
787   {
788     DW_ORD_row_major = 0,
789     DW_ORD_col_major = 1
790   };
791 
792 
793 /* DWARF discriminant descriptor encodings.  */
794 enum
795   {
796     DW_DSC_label = 0,
797     DW_DSC_range = 1
798   };
799 
800 /* DWARF defaulted member function encodings.  */
801 enum
802   {
803     DW_DEFAULTED_no = 0,
804     DW_DEFAULTED_in_class = 1,
805     DW_DEFAULTED_out_of_class = 2
806   };
807 
808 /* DWARF line content descriptions.  */
809 enum
810   {
811     DW_LNCT_path = 0x1,
812     DW_LNCT_directory_index = 0x2,
813     DW_LNCT_timestamp = 0x3,
814     DW_LNCT_size = 0x4,
815     DW_LNCT_MD5 = 0x5,
816     DW_LNCT_lo_user = 0x2000,
817     DW_LNCT_hi_user = 0x3fff
818   };
819 
820 /* DWARF standard opcode encodings.  */
821 enum
822   {
823     DW_LNS_copy = 1,
824     DW_LNS_advance_pc = 2,
825     DW_LNS_advance_line = 3,
826     DW_LNS_set_file = 4,
827     DW_LNS_set_column = 5,
828     DW_LNS_negate_stmt = 6,
829     DW_LNS_set_basic_block = 7,
830     DW_LNS_const_add_pc = 8,
831     DW_LNS_fixed_advance_pc = 9,
832     DW_LNS_set_prologue_end = 10,
833     DW_LNS_set_epilogue_begin = 11,
834     DW_LNS_set_isa = 12
835   };
836 
837 
838 /* DWARF extended opcode encodings.  */
839 enum
840   {
841     DW_LNE_end_sequence = 1,
842     DW_LNE_set_address = 2,
843     DW_LNE_define_file = 3,
844     DW_LNE_set_discriminator = 4,
845 
846     DW_LNE_lo_user = 128,
847 
848     DW_LNE_NVIDIA_inlined_call = 144,
849     DW_LNE_NVIDIA_set_function_name = 145,
850 
851     DW_LNE_hi_user = 255
852   };
853 
854 
855 /* DWARF macinfo type encodings.  */
856 enum
857   {
858     DW_MACINFO_define = 1,
859     DW_MACINFO_undef = 2,
860     DW_MACINFO_start_file = 3,
861     DW_MACINFO_end_file = 4,
862     DW_MACINFO_vendor_ext = 255
863   };
864 
865 
866 /* DWARF debug_macro type encodings.  */
867 enum
868   {
869     DW_MACRO_define = 0x01,
870     DW_MACRO_undef = 0x02,
871     DW_MACRO_start_file = 0x03,
872     DW_MACRO_end_file = 0x04,
873     DW_MACRO_define_strp = 0x05,
874     DW_MACRO_undef_strp = 0x06,
875     DW_MACRO_import = 0x07,
876     DW_MACRO_define_sup = 0x08,
877     DW_MACRO_undef_sup = 0x09,
878     DW_MACRO_import_sup = 0x0a,
879     DW_MACRO_define_strx = 0x0b,
880     DW_MACRO_undef_strx = 0x0c,
881     DW_MACRO_lo_user = 0xe0,
882     DW_MACRO_hi_user = 0xff
883   };
884 
885 /* Old GNU extension names for DWARF5 debug_macro type encodings.
886    There are no equivalents for the supplementary object file (sup)
887    and indirect string references (strx).  */
888 #define DW_MACRO_GNU_define		 DW_MACRO_define
889 #define DW_MACRO_GNU_undef		 DW_MACRO_undef
890 #define DW_MACRO_GNU_start_file		 DW_MACRO_start_file
891 #define DW_MACRO_GNU_end_file		 DW_MACRO_end_file
892 #define DW_MACRO_GNU_define_indirect	 DW_MACRO_define_strp
893 #define DW_MACRO_GNU_undef_indirect	 DW_MACRO_undef_strp
894 #define DW_MACRO_GNU_transparent_include DW_MACRO_import
895 #define DW_MACRO_GNU_lo_user		 DW_MACRO_lo_user
896 #define DW_MACRO_GNU_hi_user		 DW_MACRO_hi_user
897 
898 
899 /* Range list entry encoding.  */
900 enum
901   {
902     DW_RLE_end_of_list = 0x0,
903     DW_RLE_base_addressx = 0x1,
904     DW_RLE_startx_endx = 0x2,
905     DW_RLE_startx_length = 0x3,
906     DW_RLE_offset_pair = 0x4,
907     DW_RLE_base_address = 0x5,
908     DW_RLE_start_end = 0x6,
909     DW_RLE_start_length = 0x7
910   };
911 
912 
913 /* Location list entry encoding.  */
914 enum
915   {
916     DW_LLE_end_of_list = 0x0,
917     DW_LLE_base_addressx = 0x1,
918     DW_LLE_startx_endx = 0x2,
919     DW_LLE_startx_length = 0x3,
920     DW_LLE_offset_pair = 0x4,
921     DW_LLE_default_location = 0x5,
922     DW_LLE_base_address = 0x6,
923     DW_LLE_start_end = 0x7,
924     DW_LLE_start_length = 0x8
925   };
926 
927 
928 /* GNU DebugFission list entry encodings (.debug_loc.dwo).  */
929 enum
930   {
931     DW_LLE_GNU_end_of_list_entry = 0x0,
932     DW_LLE_GNU_base_address_selection_entry = 0x1,
933     DW_LLE_GNU_start_end_entry = 0x2,
934     DW_LLE_GNU_start_length_entry = 0x3,
935 
936     // http://www.fsfla.org/~lxoliva/papers/sfn/dwarf6-sfn-lvu.txt
937     // https://dwarfstd.org/ShowIssue.php?issue=170427.1
938     DW_LLE_GNU_view_pair = 0x9
939   };
940 
941 /* DWARF5 package file section identifiers.  */
942 enum
943   {
944     DW_SECT_INFO = 1,
945     /* Reserved = 2, */
946     DW_SECT_ABBREV = 3,
947     DW_SECT_LINE = 4,
948     DW_SECT_LOCLISTS = 5,
949     DW_SECT_STR_OFFSETS = 6,
950     DW_SECT_MACRO = 7,
951     DW_SECT_RNGLISTS = 8,
952   };
953 
954 
955 /* DWARF call frame instruction encodings.  */
956 enum
957   {
958     DW_CFA_advance_loc = 0x40,
959     DW_CFA_offset = 0x80,
960     DW_CFA_restore = 0xc0,
961     DW_CFA_extended = 0,
962 
963     DW_CFA_nop = 0x00,
964     DW_CFA_set_loc = 0x01,
965     DW_CFA_advance_loc1 = 0x02,
966     DW_CFA_advance_loc2 = 0x03,
967     DW_CFA_advance_loc4 = 0x04,
968     DW_CFA_offset_extended = 0x05,
969     DW_CFA_restore_extended = 0x06,
970     DW_CFA_undefined = 0x07,
971     DW_CFA_same_value = 0x08,
972     DW_CFA_register = 0x09,
973     DW_CFA_remember_state = 0x0a,
974     DW_CFA_restore_state = 0x0b,
975     DW_CFA_def_cfa = 0x0c,
976     DW_CFA_def_cfa_register = 0x0d,
977     DW_CFA_def_cfa_offset = 0x0e,
978     DW_CFA_def_cfa_expression = 0x0f,
979     DW_CFA_expression = 0x10,
980     DW_CFA_offset_extended_sf = 0x11,
981     DW_CFA_def_cfa_sf = 0x12,
982     DW_CFA_def_cfa_offset_sf = 0x13,
983     DW_CFA_val_offset = 0x14,
984     DW_CFA_val_offset_sf = 0x15,
985     DW_CFA_val_expression = 0x16,
986 
987     DW_CFA_low_user = 0x1c,
988     DW_CFA_MIPS_advance_loc8 = 0x1d,
989     DW_CFA_GNU_window_save = 0x2d,
990     DW_CFA_AARCH64_negate_ra_state = 0x2d,
991     DW_CFA_GNU_args_size = 0x2e,
992     DW_CFA_GNU_negative_offset_extended = 0x2f,
993     DW_CFA_high_user = 0x3f
994   };
995 
996 /* ID indicating CIE as opposed to FDE in .debug_frame.  */
997 enum
998   {
999     DW_CIE_ID_32 = 0xffffffffU,		 /* In 32-bit format CIE header.  */
1000     DW_CIE_ID_64 = 0xffffffffffffffffULL /* In 64-bit format CIE header.  */
1001   };
1002 
1003 
1004 /* Information for GNU unwind information.  */
1005 enum
1006   {
1007     DW_EH_PE_absptr = 0x00,
1008     DW_EH_PE_omit = 0xff,
1009 
1010     /* FDE data encoding.  */
1011     DW_EH_PE_uleb128 = 0x01,
1012     DW_EH_PE_udata2 = 0x02,
1013     DW_EH_PE_udata4 = 0x03,
1014     DW_EH_PE_udata8 = 0x04,
1015     DW_EH_PE_sleb128 = 0x09,
1016     DW_EH_PE_sdata2 = 0x0a,
1017     DW_EH_PE_sdata4 = 0x0b,
1018     DW_EH_PE_sdata8 = 0x0c,
1019     DW_EH_PE_signed = 0x08,
1020 
1021     /* FDE flags.  */
1022     DW_EH_PE_pcrel = 0x10,
1023     DW_EH_PE_textrel = 0x20,
1024     DW_EH_PE_datarel = 0x30,
1025     DW_EH_PE_funcrel = 0x40,
1026     DW_EH_PE_aligned = 0x50,
1027 
1028     DW_EH_PE_indirect = 0x80
1029   };
1030 
1031 
1032 /* DWARF XXX.  */
1033 #define DW_ADDR_none	0
1034 
1035 /* Section 7.2.2 of the DWARF3 specification defines a range of escape
1036    codes that can appear in the length field of certain DWARF structures.
1037 
1038    These defines enumerate the minimum and maximum values of this range.
1039    Currently only the maximum value is used (to indicate that 64-bit
1040    values are going to be used in the dwarf data that accompanies the
1041    structure).  The other values are reserved.
1042 
1043    Note: There is a typo in DWARF3 spec (published Dec 20, 2005).  In
1044    sections 7.4, 7.5.1, 7.19, 7.20 the minimum escape code is referred to
1045    as 0xffffff00 whereas in fact it should be 0xfffffff0.  */
1046 #define DWARF3_LENGTH_MIN_ESCAPE_CODE 0xfffffff0u
1047 #define DWARF3_LENGTH_MAX_ESCAPE_CODE 0xffffffffu
1048 #define DWARF3_LENGTH_64_BIT          DWARF3_LENGTH_MAX_ESCAPE_CODE
1049 
1050 #endif	/* dwarf.h */
1051