1 /* This file defines standard DWARF types, structures, and macros.
2    Copyright (C) 2000-2011, 2014 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 tags.  */
33 enum
34   {
35     DW_TAG_array_type = 0x01,
36     DW_TAG_class_type = 0x02,
37     DW_TAG_entry_point = 0x03,
38     DW_TAG_enumeration_type = 0x04,
39     DW_TAG_formal_parameter = 0x05,
40     DW_TAG_imported_declaration = 0x08,
41     DW_TAG_label = 0x0a,
42     DW_TAG_lexical_block = 0x0b,
43     DW_TAG_member = 0x0d,
44     DW_TAG_pointer_type = 0x0f,
45     DW_TAG_reference_type = 0x10,
46     DW_TAG_compile_unit = 0x11,
47     DW_TAG_string_type = 0x12,
48     DW_TAG_structure_type = 0x13,
49     DW_TAG_subroutine_type = 0x15,
50     DW_TAG_typedef = 0x16,
51     DW_TAG_union_type = 0x17,
52     DW_TAG_unspecified_parameters = 0x18,
53     DW_TAG_variant = 0x19,
54     DW_TAG_common_block = 0x1a,
55     DW_TAG_common_inclusion = 0x1b,
56     DW_TAG_inheritance = 0x1c,
57     DW_TAG_inlined_subroutine = 0x1d,
58     DW_TAG_module = 0x1e,
59     DW_TAG_ptr_to_member_type = 0x1f,
60     DW_TAG_set_type = 0x20,
61     DW_TAG_subrange_type = 0x21,
62     DW_TAG_with_stmt = 0x22,
63     DW_TAG_access_declaration = 0x23,
64     DW_TAG_base_type = 0x24,
65     DW_TAG_catch_block = 0x25,
66     DW_TAG_const_type = 0x26,
67     DW_TAG_constant = 0x27,
68     DW_TAG_enumerator = 0x28,
69     DW_TAG_file_type = 0x29,
70     DW_TAG_friend = 0x2a,
71     DW_TAG_namelist = 0x2b,
72     DW_TAG_namelist_item = 0x2c,
73     DW_TAG_packed_type = 0x2d,
74     DW_TAG_subprogram = 0x2e,
75     DW_TAG_template_type_parameter = 0x2f,
76     DW_TAG_template_value_parameter = 0x30,
77     DW_TAG_thrown_type = 0x31,
78     DW_TAG_try_block = 0x32,
79     DW_TAG_variant_part = 0x33,
80     DW_TAG_variable = 0x34,
81     DW_TAG_volatile_type = 0x35,
82     DW_TAG_dwarf_procedure = 0x36,
83     DW_TAG_restrict_type = 0x37,
84     DW_TAG_interface_type = 0x38,
85     DW_TAG_namespace = 0x39,
86     DW_TAG_imported_module = 0x3a,
87     DW_TAG_unspecified_type = 0x3b,
88     DW_TAG_partial_unit = 0x3c,
89     DW_TAG_imported_unit = 0x3d,
90     /* 0x3e reserved.  */
91     DW_TAG_condition = 0x3f,
92     DW_TAG_shared_type = 0x40,
93     DW_TAG_type_unit = 0x41,
94     DW_TAG_rvalue_reference_type = 0x42,
95     DW_TAG_template_alias = 0x43,
96 
97     DW_TAG_lo_user = 0x4080,
98 
99     DW_TAG_MIPS_loop = 0x4081,
100     DW_TAG_format_label = 0x4101,
101     DW_TAG_function_template = 0x4102,
102     DW_TAG_class_template = 0x4103,
103 
104     DW_TAG_GNU_BINCL = 0x4104,
105     DW_TAG_GNU_EINCL = 0x4105,
106 
107     DW_TAG_GNU_template_template_param = 0x4106,
108     DW_TAG_GNU_template_parameter_pack = 0x4107,
109     DW_TAG_GNU_formal_parameter_pack = 0x4108,
110     DW_TAG_GNU_call_site = 0x4109,
111     DW_TAG_GNU_call_site_parameter = 0x410a,
112 
113     DW_TAG_hi_user = 0xffff
114   };
115 
116 
117 /* Children determination encodings.  */
118 enum
119   {
120     DW_CHILDREN_no = 0,
121     DW_CHILDREN_yes = 1
122   };
123 
124 
125 /* DWARF attributes encodings.  */
126 enum
127   {
128     DW_AT_sibling = 0x01,
129     DW_AT_location = 0x02,
130     DW_AT_name = 0x03,
131     DW_AT_ordering = 0x09,
132     DW_AT_subscr_data = 0x0a,
133     DW_AT_byte_size = 0x0b,
134     DW_AT_bit_offset = 0x0c,
135     DW_AT_bit_size = 0x0d,
136     DW_AT_element_list = 0x0f,
137     DW_AT_stmt_list = 0x10,
138     DW_AT_low_pc = 0x11,
139     DW_AT_high_pc = 0x12,
140     DW_AT_language = 0x13,
141     DW_AT_member = 0x14,
142     DW_AT_discr = 0x15,
143     DW_AT_discr_value = 0x16,
144     DW_AT_visibility = 0x17,
145     DW_AT_import = 0x18,
146     DW_AT_string_length = 0x19,
147     DW_AT_common_reference = 0x1a,
148     DW_AT_comp_dir = 0x1b,
149     DW_AT_const_value = 0x1c,
150     DW_AT_containing_type = 0x1d,
151     DW_AT_default_value = 0x1e,
152     DW_AT_inline = 0x20,
153     DW_AT_is_optional = 0x21,
154     DW_AT_lower_bound = 0x22,
155     DW_AT_producer = 0x25,
156     DW_AT_prototyped = 0x27,
157     DW_AT_return_addr = 0x2a,
158     DW_AT_start_scope = 0x2c,
159     DW_AT_bit_stride = 0x2e,
160     DW_AT_upper_bound = 0x2f,
161     DW_AT_abstract_origin = 0x31,
162     DW_AT_accessibility = 0x32,
163     DW_AT_address_class = 0x33,
164     DW_AT_artificial = 0x34,
165     DW_AT_base_types = 0x35,
166     DW_AT_calling_convention = 0x36,
167     DW_AT_count = 0x37,
168     DW_AT_data_member_location = 0x38,
169     DW_AT_decl_column = 0x39,
170     DW_AT_decl_file = 0x3a,
171     DW_AT_decl_line = 0x3b,
172     DW_AT_declaration = 0x3c,
173     DW_AT_discr_list = 0x3d,
174     DW_AT_encoding = 0x3e,
175     DW_AT_external = 0x3f,
176     DW_AT_frame_base = 0x40,
177     DW_AT_friend = 0x41,
178     DW_AT_identifier_case = 0x42,
179     DW_AT_macro_info = 0x43,
180     DW_AT_namelist_item = 0x44,
181     DW_AT_priority = 0x45,
182     DW_AT_segment = 0x46,
183     DW_AT_specification = 0x47,
184     DW_AT_static_link = 0x48,
185     DW_AT_type = 0x49,
186     DW_AT_use_location = 0x4a,
187     DW_AT_variable_parameter = 0x4b,
188     DW_AT_virtuality = 0x4c,
189     DW_AT_vtable_elem_location = 0x4d,
190     DW_AT_allocated = 0x4e,
191     DW_AT_associated = 0x4f,
192     DW_AT_data_location = 0x50,
193     DW_AT_byte_stride = 0x51,
194     DW_AT_entry_pc = 0x52,
195     DW_AT_use_UTF8 = 0x53,
196     DW_AT_extension = 0x54,
197     DW_AT_ranges = 0x55,
198     DW_AT_trampoline = 0x56,
199     DW_AT_call_column = 0x57,
200     DW_AT_call_file = 0x58,
201     DW_AT_call_line = 0x59,
202     DW_AT_description = 0x5a,
203     DW_AT_binary_scale = 0x5b,
204     DW_AT_decimal_scale = 0x5c,
205     DW_AT_small = 0x5d,
206     DW_AT_decimal_sign = 0x5e,
207     DW_AT_digit_count = 0x5f,
208     DW_AT_picture_string = 0x60,
209     DW_AT_mutable = 0x61,
210     DW_AT_threads_scaled = 0x62,
211     DW_AT_explicit = 0x63,
212     DW_AT_object_pointer = 0x64,
213     DW_AT_endianity = 0x65,
214     DW_AT_elemental = 0x66,
215     DW_AT_pure = 0x67,
216     DW_AT_recursive = 0x68,
217     DW_AT_signature = 0x69,
218     DW_AT_main_subprogram = 0x6a,
219     DW_AT_data_bit_offset = 0x6b,
220     DW_AT_const_expr = 0x6c,
221     DW_AT_enum_class = 0x6d,
222     DW_AT_linkage_name = 0x6e,
223 
224     /* DWARF5 attribute values.  */
225     DW_AT_noreturn = 0x87,
226 
227     DW_AT_lo_user = 0x2000,
228 
229     DW_AT_MIPS_fde = 0x2001,
230     DW_AT_MIPS_loop_begin = 0x2002,
231     DW_AT_MIPS_tail_loop_begin = 0x2003,
232     DW_AT_MIPS_epilog_begin = 0x2004,
233     DW_AT_MIPS_loop_unroll_factor = 0x2005,
234     DW_AT_MIPS_software_pipeline_depth = 0x2006,
235     DW_AT_MIPS_linkage_name = 0x2007,
236     DW_AT_MIPS_stride = 0x2008,
237     DW_AT_MIPS_abstract_name = 0x2009,
238     DW_AT_MIPS_clone_origin = 0x200a,
239     DW_AT_MIPS_has_inlines = 0x200b,
240     DW_AT_MIPS_stride_byte = 0x200c,
241     DW_AT_MIPS_stride_elem = 0x200d,
242     DW_AT_MIPS_ptr_dopetype = 0x200e,
243     DW_AT_MIPS_allocatable_dopetype = 0x200f,
244     DW_AT_MIPS_assumed_shape_dopetype = 0x2010,
245     DW_AT_MIPS_assumed_size = 0x2011,
246 
247     /* GNU extensions.  */
248     DW_AT_sf_names = 0x2101,
249     DW_AT_src_info = 0x2102,
250     DW_AT_mac_info = 0x2103,
251     DW_AT_src_coords = 0x2104,
252     DW_AT_body_begin = 0x2105,
253     DW_AT_body_end = 0x2106,
254     DW_AT_GNU_vector = 0x2107,
255     DW_AT_GNU_guarded_by = 0x2108,
256     DW_AT_GNU_pt_guarded_by = 0x2109,
257     DW_AT_GNU_guarded = 0x210a,
258     DW_AT_GNU_pt_guarded = 0x210b,
259     DW_AT_GNU_locks_excluded = 0x210c,
260     DW_AT_GNU_exclusive_locks_required = 0x210d,
261     DW_AT_GNU_shared_locks_required = 0x210e,
262     DW_AT_GNU_odr_signature = 0x210f,
263     DW_AT_GNU_template_name = 0x2110,
264     DW_AT_GNU_call_site_value = 0x2111,
265     DW_AT_GNU_call_site_data_value = 0x2112,
266     DW_AT_GNU_call_site_target = 0x2113,
267     DW_AT_GNU_call_site_target_clobbered = 0x2114,
268     DW_AT_GNU_tail_call = 0x2115,
269     DW_AT_GNU_all_tail_call_sites = 0x2116,
270     DW_AT_GNU_all_call_sites = 0x2117,
271     DW_AT_GNU_all_source_call_sites = 0x2118,
272     DW_AT_GNU_macros = 0x2119,
273     DW_AT_GNU_deleted = 0x211a,
274 
275     DW_AT_hi_user = 0x3fff
276   };
277 
278 
279 /* DWARF form encodings.  */
280 enum
281   {
282     DW_FORM_addr = 0x01,
283     DW_FORM_block2 = 0x03,
284     DW_FORM_block4 = 0x04,
285     DW_FORM_data2 = 0x05,
286     DW_FORM_data4 = 0x06,
287     DW_FORM_data8 = 0x07,
288     DW_FORM_string = 0x08,
289     DW_FORM_block = 0x09,
290     DW_FORM_block1 = 0x0a,
291     DW_FORM_data1 = 0x0b,
292     DW_FORM_flag = 0x0c,
293     DW_FORM_sdata = 0x0d,
294     DW_FORM_strp = 0x0e,
295     DW_FORM_udata = 0x0f,
296     DW_FORM_ref_addr = 0x10,
297     DW_FORM_ref1 = 0x11,
298     DW_FORM_ref2 = 0x12,
299     DW_FORM_ref4 = 0x13,
300     DW_FORM_ref8 = 0x14,
301     DW_FORM_ref_udata = 0x15,
302     DW_FORM_indirect = 0x16,
303     DW_FORM_sec_offset = 0x17,
304     DW_FORM_exprloc = 0x18,
305     DW_FORM_flag_present = 0x19,
306     DW_FORM_ref_sig8 = 0x20,
307 
308     DW_FORM_GNU_ref_alt = 0x1f20, /* offset in alternate .debuginfo.  */
309     DW_FORM_GNU_strp_alt = 0x1f21 /* offset in alternate .debug_str. */
310   };
311 
312 
313 /* DWARF location operation encodings.  */
314 enum
315   {
316     DW_OP_addr = 0x03,		/* Constant address.  */
317     DW_OP_deref = 0x06,
318     DW_OP_const1u = 0x08,	/* Unsigned 1-byte constant.  */
319     DW_OP_const1s = 0x09,	/* Signed 1-byte constant.  */
320     DW_OP_const2u = 0x0a,	/* Unsigned 2-byte constant.  */
321     DW_OP_const2s = 0x0b,	/* Signed 2-byte constant.  */
322     DW_OP_const4u = 0x0c,	/* Unsigned 4-byte constant.  */
323     DW_OP_const4s = 0x0d,	/* Signed 4-byte constant.  */
324     DW_OP_const8u = 0x0e,	/* Unsigned 8-byte constant.  */
325     DW_OP_const8s = 0x0f,	/* Signed 8-byte constant.  */
326     DW_OP_constu = 0x10,	/* Unsigned LEB128 constant.  */
327     DW_OP_consts = 0x11,	/* Signed LEB128 constant.  */
328     DW_OP_dup = 0x12,
329     DW_OP_drop = 0x13,
330     DW_OP_over = 0x14,
331     DW_OP_pick = 0x15,		/* 1-byte stack index.  */
332     DW_OP_swap = 0x16,
333     DW_OP_rot = 0x17,
334     DW_OP_xderef = 0x18,
335     DW_OP_abs = 0x19,
336     DW_OP_and = 0x1a,
337     DW_OP_div = 0x1b,
338     DW_OP_minus = 0x1c,
339     DW_OP_mod = 0x1d,
340     DW_OP_mul = 0x1e,
341     DW_OP_neg = 0x1f,
342     DW_OP_not = 0x20,
343     DW_OP_or = 0x21,
344     DW_OP_plus = 0x22,
345     DW_OP_plus_uconst = 0x23,	/* Unsigned LEB128 addend.  */
346     DW_OP_shl = 0x24,
347     DW_OP_shr = 0x25,
348     DW_OP_shra = 0x26,
349     DW_OP_xor = 0x27,
350     DW_OP_bra = 0x28,		/* Signed 2-byte constant.  */
351     DW_OP_eq = 0x29,
352     DW_OP_ge = 0x2a,
353     DW_OP_gt = 0x2b,
354     DW_OP_le = 0x2c,
355     DW_OP_lt = 0x2d,
356     DW_OP_ne = 0x2e,
357     DW_OP_skip = 0x2f,		/* Signed 2-byte constant.  */
358     DW_OP_lit0 = 0x30,		/* Literal 0.  */
359     DW_OP_lit1 = 0x31,		/* Literal 1.  */
360     DW_OP_lit2 = 0x32,		/* Literal 2.  */
361     DW_OP_lit3 = 0x33,		/* Literal 3.  */
362     DW_OP_lit4 = 0x34,		/* Literal 4.  */
363     DW_OP_lit5 = 0x35,		/* Literal 5.  */
364     DW_OP_lit6 = 0x36,		/* Literal 6.  */
365     DW_OP_lit7 = 0x37,		/* Literal 7.  */
366     DW_OP_lit8 = 0x38,		/* Literal 8.  */
367     DW_OP_lit9 = 0x39,		/* Literal 9.  */
368     DW_OP_lit10 = 0x3a,		/* Literal 10.  */
369     DW_OP_lit11 = 0x3b,		/* Literal 11.  */
370     DW_OP_lit12 = 0x3c,		/* Literal 12.  */
371     DW_OP_lit13 = 0x3d,		/* Literal 13.  */
372     DW_OP_lit14 = 0x3e,		/* Literal 14.  */
373     DW_OP_lit15 = 0x3f,		/* Literal 15.  */
374     DW_OP_lit16 = 0x40,		/* Literal 16.  */
375     DW_OP_lit17 = 0x41,		/* Literal 17.  */
376     DW_OP_lit18 = 0x42,		/* Literal 18.  */
377     DW_OP_lit19 = 0x43,		/* Literal 19.  */
378     DW_OP_lit20 = 0x44,		/* Literal 20.  */
379     DW_OP_lit21 = 0x45,		/* Literal 21.  */
380     DW_OP_lit22 = 0x46,		/* Literal 22.  */
381     DW_OP_lit23 = 0x47,		/* Literal 23.  */
382     DW_OP_lit24 = 0x48,		/* Literal 24.  */
383     DW_OP_lit25 = 0x49,		/* Literal 25.  */
384     DW_OP_lit26 = 0x4a,		/* Literal 26.  */
385     DW_OP_lit27 = 0x4b,		/* Literal 27.  */
386     DW_OP_lit28 = 0x4c,		/* Literal 28.  */
387     DW_OP_lit29 = 0x4d,		/* Literal 29.  */
388     DW_OP_lit30 = 0x4e,		/* Literal 30.  */
389     DW_OP_lit31 = 0x4f,		/* Literal 31.  */
390     DW_OP_reg0 = 0x50,		/* Register 0.  */
391     DW_OP_reg1 = 0x51,		/* Register 1.  */
392     DW_OP_reg2 = 0x52,		/* Register 2.  */
393     DW_OP_reg3 = 0x53,		/* Register 3.  */
394     DW_OP_reg4 = 0x54,		/* Register 4.  */
395     DW_OP_reg5 = 0x55,		/* Register 5.  */
396     DW_OP_reg6 = 0x56,		/* Register 6.  */
397     DW_OP_reg7 = 0x57,		/* Register 7.  */
398     DW_OP_reg8 = 0x58,		/* Register 8.  */
399     DW_OP_reg9 = 0x59,		/* Register 9.  */
400     DW_OP_reg10 = 0x5a,		/* Register 10.  */
401     DW_OP_reg11 = 0x5b,		/* Register 11.  */
402     DW_OP_reg12 = 0x5c,		/* Register 12.  */
403     DW_OP_reg13 = 0x5d,		/* Register 13.  */
404     DW_OP_reg14 = 0x5e,		/* Register 14.  */
405     DW_OP_reg15 = 0x5f,		/* Register 15.  */
406     DW_OP_reg16 = 0x60,		/* Register 16.  */
407     DW_OP_reg17 = 0x61,		/* Register 17.  */
408     DW_OP_reg18 = 0x62,		/* Register 18.  */
409     DW_OP_reg19 = 0x63,		/* Register 19.  */
410     DW_OP_reg20 = 0x64,		/* Register 20.  */
411     DW_OP_reg21 = 0x65,		/* Register 21.  */
412     DW_OP_reg22 = 0x66,		/* Register 22.  */
413     DW_OP_reg23 = 0x67,		/* Register 24.  */
414     DW_OP_reg24 = 0x68,		/* Register 24.  */
415     DW_OP_reg25 = 0x69,		/* Register 25.  */
416     DW_OP_reg26 = 0x6a,		/* Register 26.  */
417     DW_OP_reg27 = 0x6b,		/* Register 27.  */
418     DW_OP_reg28 = 0x6c,		/* Register 28.  */
419     DW_OP_reg29 = 0x6d,		/* Register 29.  */
420     DW_OP_reg30 = 0x6e,		/* Register 30.  */
421     DW_OP_reg31 = 0x6f,		/* Register 31.  */
422     DW_OP_breg0 = 0x70,		/* Base register 0.  */
423     DW_OP_breg1 = 0x71,		/* Base register 1.  */
424     DW_OP_breg2 = 0x72,		/* Base register 2.  */
425     DW_OP_breg3 = 0x73,		/* Base register 3.  */
426     DW_OP_breg4 = 0x74,		/* Base register 4.  */
427     DW_OP_breg5 = 0x75,		/* Base register 5.  */
428     DW_OP_breg6 = 0x76,		/* Base register 6.  */
429     DW_OP_breg7 = 0x77,		/* Base register 7.  */
430     DW_OP_breg8 = 0x78,		/* Base register 8.  */
431     DW_OP_breg9 = 0x79,		/* Base register 9.  */
432     DW_OP_breg10 = 0x7a,	/* Base register 10.  */
433     DW_OP_breg11 = 0x7b,	/* Base register 11.  */
434     DW_OP_breg12 = 0x7c,	/* Base register 12.  */
435     DW_OP_breg13 = 0x7d,	/* Base register 13.  */
436     DW_OP_breg14 = 0x7e,	/* Base register 14.  */
437     DW_OP_breg15 = 0x7f,	/* Base register 15.  */
438     DW_OP_breg16 = 0x80,	/* Base register 16.  */
439     DW_OP_breg17 = 0x81,	/* Base register 17.  */
440     DW_OP_breg18 = 0x82,	/* Base register 18.  */
441     DW_OP_breg19 = 0x83,	/* Base register 19.  */
442     DW_OP_breg20 = 0x84,	/* Base register 20.  */
443     DW_OP_breg21 = 0x85,	/* Base register 21.  */
444     DW_OP_breg22 = 0x86,	/* Base register 22.  */
445     DW_OP_breg23 = 0x87,	/* Base register 23.  */
446     DW_OP_breg24 = 0x88,	/* Base register 24.  */
447     DW_OP_breg25 = 0x89,	/* Base register 25.  */
448     DW_OP_breg26 = 0x8a,	/* Base register 26.  */
449     DW_OP_breg27 = 0x8b,	/* Base register 27.  */
450     DW_OP_breg28 = 0x8c,	/* Base register 28.  */
451     DW_OP_breg29 = 0x8d,	/* Base register 29.  */
452     DW_OP_breg30 = 0x8e,	/* Base register 30.  */
453     DW_OP_breg31 = 0x8f,	/* Base register 31.  */
454     DW_OP_regx = 0x90,		/* Unsigned LEB128 register.  */
455     DW_OP_fbreg = 0x91,		/* Signed LEB128 offset.  */
456     DW_OP_bregx = 0x92,		/* ULEB128 register followed by SLEB128 off. */
457     DW_OP_piece = 0x93,		/* ULEB128 size of piece addressed. */
458     DW_OP_deref_size = 0x94,	/* 1-byte size of data retrieved.  */
459     DW_OP_xderef_size = 0x95,	/* 1-byte size of data retrieved.  */
460     DW_OP_nop = 0x96,
461     DW_OP_push_object_address = 0x97,
462     DW_OP_call2 = 0x98,
463     DW_OP_call4 = 0x99,
464     DW_OP_call_ref = 0x9a,
465     DW_OP_form_tls_address = 0x9b,/* TLS offset to address in current thread */
466     DW_OP_call_frame_cfa = 0x9c,/* CFA as determined by CFI.  */
467     DW_OP_bit_piece = 0x9d,	/* ULEB128 size and ULEB128 offset in bits.  */
468     DW_OP_implicit_value = 0x9e, /* DW_FORM_block follows opcode.  */
469     DW_OP_stack_value = 0x9f,	 /* No operands, special like DW_OP_piece.  */
470 
471     /* GNU extensions.  */
472     DW_OP_GNU_push_tls_address = 0xe0,
473     DW_OP_GNU_uninit = 0xf0,
474     DW_OP_GNU_encoded_addr = 0xf1,
475     DW_OP_GNU_implicit_pointer = 0xf2,
476     DW_OP_GNU_entry_value = 0xf3,
477     DW_OP_GNU_const_type = 0xf4,
478     DW_OP_GNU_regval_type = 0xf5,
479     DW_OP_GNU_deref_type = 0xf6,
480     DW_OP_GNU_convert = 0xf7,
481     DW_OP_GNU_reinterpret = 0xf9,
482     DW_OP_GNU_parameter_ref = 0xfa,
483 
484     DW_OP_lo_user = 0xe0,	/* Implementation-defined range start.  */
485     DW_OP_hi_user = 0xff	/* Implementation-defined range end.  */
486   };
487 
488 
489 /* DWARF base type encodings.  */
490 enum
491   {
492     DW_ATE_void = 0x0,
493     DW_ATE_address = 0x1,
494     DW_ATE_boolean = 0x2,
495     DW_ATE_complex_float = 0x3,
496     DW_ATE_float = 0x4,
497     DW_ATE_signed = 0x5,
498     DW_ATE_signed_char = 0x6,
499     DW_ATE_unsigned = 0x7,
500     DW_ATE_unsigned_char = 0x8,
501     DW_ATE_imaginary_float = 0x9,
502     DW_ATE_packed_decimal = 0xa,
503     DW_ATE_numeric_string = 0xb,
504     DW_ATE_edited = 0xc,
505     DW_ATE_signed_fixed = 0xd,
506     DW_ATE_unsigned_fixed = 0xe,
507     DW_ATE_decimal_float = 0xf,
508     DW_ATE_UTF = 0x10,
509 
510     DW_ATE_lo_user = 0x80,
511     DW_ATE_hi_user = 0xff
512   };
513 
514 
515 /* DWARF decimal sign encodings.  */
516 enum
517   {
518     DW_DS_unsigned = 1,
519     DW_DS_leading_overpunch = 2,
520     DW_DS_trailing_overpunch = 3,
521     DW_DS_leading_separate = 4,
522     DW_DS_trailing_separate = 5,
523   };
524 
525 
526 /* DWARF endianity encodings.  */
527 enum
528   {
529     DW_END_default = 0,
530     DW_END_big = 1,
531     DW_END_little = 2,
532 
533     DW_END_lo_user = 0x40,
534     DW_END_hi_user = 0xff
535   };
536 
537 
538 /* DWARF accessibility encodings.  */
539 enum
540   {
541     DW_ACCESS_public = 1,
542     DW_ACCESS_protected = 2,
543     DW_ACCESS_private = 3
544   };
545 
546 
547 /* DWARF visibility encodings.  */
548 enum
549   {
550     DW_VIS_local = 1,
551     DW_VIS_exported = 2,
552     DW_VIS_qualified = 3
553   };
554 
555 
556 /* DWARF virtuality encodings.  */
557 enum
558   {
559     DW_VIRTUALITY_none = 0,
560     DW_VIRTUALITY_virtual = 1,
561     DW_VIRTUALITY_pure_virtual = 2
562   };
563 
564 
565 /* DWARF language encodings.  */
566 enum
567   {
568     DW_LANG_C89 = 0x0001,	     /* ISO C:1989 */
569     DW_LANG_C = 0x0002,		     /* C */
570     DW_LANG_Ada83 = 0x0003,	     /* ISO Ada:1983 */
571     DW_LANG_C_plus_plus	= 0x0004,    /* ISO C++:1998 */
572     DW_LANG_Cobol74 = 0x0005,	     /* ISO Cobol:1974 */
573     DW_LANG_Cobol85 = 0x0006,	     /* ISO Cobol:1985 */
574     DW_LANG_Fortran77 = 0x0007,	     /* ISO FORTRAN 77 */
575     DW_LANG_Fortran90 = 0x0008,	     /* ISO Fortran 90 */
576     DW_LANG_Pascal83 = 0x0009,	     /* ISO Pascal:1983 */
577     DW_LANG_Modula2 = 0x000a,	     /* ISO Modula-2:1996 */
578     DW_LANG_Java = 0x000b,	     /* Java */
579     DW_LANG_C99 = 0x000c,	     /* ISO C:1999 */
580     DW_LANG_Ada95 = 0x000d,	     /* ISO Ada:1995 */
581     DW_LANG_Fortran95 = 0x000e,	     /* ISO Fortran 95 */
582     DW_LANG_PL1 = 0x000f,	     /* ISO PL/1:1976 */
583     DW_LANG_ObjC = 0x0010,	     /* Objective-C */
584     DW_LANG_ObjC_plus_plus = 0x0011, /* Objective-C++ */
585     DW_LANG_UPC = 0x0012,	     /* Unified Parallel C */
586     DW_LANG_D = 0x0013,		     /* D */
587     DW_LANG_Python = 0x0014,	     /* Python */
588     DW_LANG_Go = 0x0016,	     /* Go */
589     DW_LANG_C_plus_plus_11 = 0x001a, /* ISO C++:2011 */
590     DW_LANG_C11 = 0x001d,	     /* ISO C:2011 */
591     DW_LANG_C_plus_plus_14 = 0x0021, /* ISO C++:2014 */
592 
593 
594     DW_LANG_lo_user = 0x8000,
595     DW_LANG_Mips_Assembler = 0x8001, /* Assembler */
596     DW_LANG_hi_user = 0xffff
597   };
598 
599 
600 /* DWARF identifier case encodings.  */
601 enum
602   {
603     DW_ID_case_sensitive = 0,
604     DW_ID_up_case = 1,
605     DW_ID_down_case = 2,
606     DW_ID_case_insensitive = 3
607   };
608 
609 
610 /* DWARF calling conventions encodings.  */
611 enum
612   {
613     DW_CC_normal = 0x1,
614     DW_CC_program = 0x2,
615     DW_CC_nocall = 0x3,
616     DW_CC_lo_user = 0x40,
617     DW_CC_hi_user = 0xff
618   };
619 
620 
621 /* DWARF inline encodings.  */
622 enum
623   {
624     DW_INL_not_inlined = 0,
625     DW_INL_inlined = 1,
626     DW_INL_declared_not_inlined = 2,
627     DW_INL_declared_inlined = 3
628   };
629 
630 
631 /* DWARF ordering encodings.  */
632 enum
633   {
634     DW_ORD_row_major = 0,
635     DW_ORD_col_major = 1
636   };
637 
638 
639 /* DWARF discriminant descriptor encodings.  */
640 enum
641   {
642     DW_DSC_label = 0,
643     DW_DSC_range = 1
644   };
645 
646 
647 /* DWARF standard opcode encodings.  */
648 enum
649   {
650     DW_LNS_copy = 1,
651     DW_LNS_advance_pc = 2,
652     DW_LNS_advance_line = 3,
653     DW_LNS_set_file = 4,
654     DW_LNS_set_column = 5,
655     DW_LNS_negate_stmt = 6,
656     DW_LNS_set_basic_block = 7,
657     DW_LNS_const_add_pc = 8,
658     DW_LNS_fixed_advance_pc = 9,
659     DW_LNS_set_prologue_end = 10,
660     DW_LNS_set_epilogue_begin = 11,
661     DW_LNS_set_isa = 12
662   };
663 
664 
665 /* DWARF extended opcode encodings.  */
666 enum
667   {
668     DW_LNE_end_sequence = 1,
669     DW_LNE_set_address = 2,
670     DW_LNE_define_file = 3,
671     DW_LNE_set_discriminator = 4,
672 
673     DW_LNE_lo_user = 128,
674     DW_LNE_hi_user = 255
675   };
676 
677 
678 /* DWARF macinfo type encodings.  */
679 enum
680   {
681     DW_MACINFO_define = 1,
682     DW_MACINFO_undef = 2,
683     DW_MACINFO_start_file = 3,
684     DW_MACINFO_end_file = 4,
685     DW_MACINFO_vendor_ext = 255
686   };
687 
688 
689 /* DWARF debug_macro type encodings.  GNU/DWARF5 extension.  */
690 enum
691   {
692     DW_MACRO_GNU_define = 0x01,
693     DW_MACRO_GNU_undef = 0x02,
694     DW_MACRO_GNU_start_file = 0x03,
695     DW_MACRO_GNU_end_file = 0x04,
696     DW_MACRO_GNU_define_indirect = 0x05,
697     DW_MACRO_GNU_undef_indirect = 0x06,
698     DW_MACRO_GNU_transparent_include = 0x07,
699     DW_MACRO_GNU_lo_user = 0xe0,
700     DW_MACRO_GNU_hi_user = 0xff
701   };
702 
703 
704 /* DWARF call frame instruction encodings.  */
705 enum
706   {
707     DW_CFA_advance_loc = 0x40,
708     DW_CFA_offset = 0x80,
709     DW_CFA_restore = 0xc0,
710     DW_CFA_extended = 0,
711 
712     DW_CFA_nop = 0x00,
713     DW_CFA_set_loc = 0x01,
714     DW_CFA_advance_loc1 = 0x02,
715     DW_CFA_advance_loc2 = 0x03,
716     DW_CFA_advance_loc4 = 0x04,
717     DW_CFA_offset_extended = 0x05,
718     DW_CFA_restore_extended = 0x06,
719     DW_CFA_undefined = 0x07,
720     DW_CFA_same_value = 0x08,
721     DW_CFA_register = 0x09,
722     DW_CFA_remember_state = 0x0a,
723     DW_CFA_restore_state = 0x0b,
724     DW_CFA_def_cfa = 0x0c,
725     DW_CFA_def_cfa_register = 0x0d,
726     DW_CFA_def_cfa_offset = 0x0e,
727     DW_CFA_def_cfa_expression = 0x0f,
728     DW_CFA_expression = 0x10,
729     DW_CFA_offset_extended_sf = 0x11,
730     DW_CFA_def_cfa_sf = 0x12,
731     DW_CFA_def_cfa_offset_sf = 0x13,
732     DW_CFA_val_offset = 0x14,
733     DW_CFA_val_offset_sf = 0x15,
734     DW_CFA_val_expression = 0x16,
735 
736     DW_CFA_low_user = 0x1c,
737     DW_CFA_MIPS_advance_loc8 = 0x1d,
738     DW_CFA_GNU_window_save = 0x2d,
739     DW_CFA_GNU_args_size = 0x2e,
740     DW_CFA_GNU_negative_offset_extended = 0x2f,
741     DW_CFA_high_user = 0x3f
742   };
743 
744 /* ID indicating CIE as opposed to FDE in .debug_frame.  */
745 enum
746   {
747     DW_CIE_ID_32 = 0xffffffffU,		 /* In 32-bit format CIE header.  */
748     DW_CIE_ID_64 = 0xffffffffffffffffULL /* In 64-bit format CIE header.  */
749   };
750 
751 
752 /* Information for GNU unwind information.  */
753 enum
754   {
755     DW_EH_PE_absptr = 0x00,
756     DW_EH_PE_omit = 0xff,
757 
758     /* FDE data encoding.  */
759     DW_EH_PE_uleb128 = 0x01,
760     DW_EH_PE_udata2 = 0x02,
761     DW_EH_PE_udata4 = 0x03,
762     DW_EH_PE_udata8 = 0x04,
763     DW_EH_PE_sleb128 = 0x09,
764     DW_EH_PE_sdata2 = 0x0a,
765     DW_EH_PE_sdata4 = 0x0b,
766     DW_EH_PE_sdata8 = 0x0c,
767     DW_EH_PE_signed = 0x08,
768 
769     /* FDE flags.  */
770     DW_EH_PE_pcrel = 0x10,
771     DW_EH_PE_textrel = 0x20,
772     DW_EH_PE_datarel = 0x30,
773     DW_EH_PE_funcrel = 0x40,
774     DW_EH_PE_aligned = 0x50,
775 
776     DW_EH_PE_indirect = 0x80
777   };
778 
779 
780 /* DWARF XXX.  */
781 #define DW_ADDR_none	0
782 
783 /* Section 7.2.2 of the DWARF3 specification defines a range of escape
784    codes that can appear in the length field of certain DWARF structures.
785 
786    These defines enumerate the minium and maximum values of this range.
787    Currently only the maximum value is used (to indicate that 64-bit
788    values are going to be used in the dwarf data that accompanies the
789    structure).  The other values are reserved.
790 
791    Note: There is a typo in DWARF3 spec (published Dec 20, 2005).  In
792    sections 7.4, 7.5.1, 7.19, 7.20 the minimum escape code is referred to
793    as 0xffffff00 whereas in fact it should be 0xfffffff0.  */
794 #define DWARF3_LENGTH_MIN_ESCAPE_CODE 0xfffffff0u
795 #define DWARF3_LENGTH_MAX_ESCAPE_CODE 0xffffffffu
796 #define DWARF3_LENGTH_64_BIT          DWARF3_LENGTH_MAX_ESCAPE_CODE
797 
798 #endif	/* dwarf.h */
799