1// Copyright 2010 The Go Authors. All rights reserved.
2// Use of this source code is governed by a BSD-style
3// license that can be found in the LICENSE file.
4
5package dwarf
6
7// Cut, pasted, tr-and-awk'ed from tables in
8// http://dwarfstd.org/doc/Dwarf3.pdf
9
10// Table 18
11const (
12	DW_TAG_array_type               = 0x01
13	DW_TAG_class_type               = 0x02
14	DW_TAG_entry_point              = 0x03
15	DW_TAG_enumeration_type         = 0x04
16	DW_TAG_formal_parameter         = 0x05
17	DW_TAG_imported_declaration     = 0x08
18	DW_TAG_label                    = 0x0a
19	DW_TAG_lexical_block            = 0x0b
20	DW_TAG_member                   = 0x0d
21	DW_TAG_pointer_type             = 0x0f
22	DW_TAG_reference_type           = 0x10
23	DW_TAG_compile_unit             = 0x11
24	DW_TAG_string_type              = 0x12
25	DW_TAG_structure_type           = 0x13
26	DW_TAG_subroutine_type          = 0x15
27	DW_TAG_typedef                  = 0x16
28	DW_TAG_union_type               = 0x17
29	DW_TAG_unspecified_parameters   = 0x18
30	DW_TAG_variant                  = 0x19
31	DW_TAG_common_block             = 0x1a
32	DW_TAG_common_inclusion         = 0x1b
33	DW_TAG_inheritance              = 0x1c
34	DW_TAG_inlined_subroutine       = 0x1d
35	DW_TAG_module                   = 0x1e
36	DW_TAG_ptr_to_member_type       = 0x1f
37	DW_TAG_set_type                 = 0x20
38	DW_TAG_subrange_type            = 0x21
39	DW_TAG_with_stmt                = 0x22
40	DW_TAG_access_declaration       = 0x23
41	DW_TAG_base_type                = 0x24
42	DW_TAG_catch_block              = 0x25
43	DW_TAG_const_type               = 0x26
44	DW_TAG_constant                 = 0x27
45	DW_TAG_enumerator               = 0x28
46	DW_TAG_file_type                = 0x29
47	DW_TAG_friend                   = 0x2a
48	DW_TAG_namelist                 = 0x2b
49	DW_TAG_namelist_item            = 0x2c
50	DW_TAG_packed_type              = 0x2d
51	DW_TAG_subprogram               = 0x2e
52	DW_TAG_template_type_parameter  = 0x2f
53	DW_TAG_template_value_parameter = 0x30
54	DW_TAG_thrown_type              = 0x31
55	DW_TAG_try_block                = 0x32
56	DW_TAG_variant_part             = 0x33
57	DW_TAG_variable                 = 0x34
58	DW_TAG_volatile_type            = 0x35
59	// Dwarf3
60	DW_TAG_dwarf_procedure  = 0x36
61	DW_TAG_restrict_type    = 0x37
62	DW_TAG_interface_type   = 0x38
63	DW_TAG_namespace        = 0x39
64	DW_TAG_imported_module  = 0x3a
65	DW_TAG_unspecified_type = 0x3b
66	DW_TAG_partial_unit     = 0x3c
67	DW_TAG_imported_unit    = 0x3d
68	DW_TAG_condition        = 0x3f
69	DW_TAG_shared_type      = 0x40
70	// Dwarf4
71	DW_TAG_type_unit             = 0x41
72	DW_TAG_rvalue_reference_type = 0x42
73	DW_TAG_template_alias        = 0x43
74
75	// User defined
76	DW_TAG_lo_user = 0x4080
77	DW_TAG_hi_user = 0xffff
78)
79
80// Table 19
81const (
82	DW_CHILDREN_no  = 0x00
83	DW_CHILDREN_yes = 0x01
84)
85
86// Not from the spec, but logically belongs here
87const (
88	DW_CLS_ADDRESS = 0x01 + iota
89	DW_CLS_BLOCK
90	DW_CLS_CONSTANT
91	DW_CLS_FLAG
92	DW_CLS_PTR // lineptr, loclistptr, macptr, rangelistptr
93	DW_CLS_REFERENCE
94	DW_CLS_ADDRLOC
95	DW_CLS_STRING
96
97	// Go-specific internal hackery.
98	DW_CLS_GO_TYPEREF
99)
100
101// Table 20
102const (
103	DW_AT_sibling              = 0x01 // reference
104	DW_AT_location             = 0x02 // block, loclistptr
105	DW_AT_name                 = 0x03 // string
106	DW_AT_ordering             = 0x09 // constant
107	DW_AT_byte_size            = 0x0b // block, constant, reference
108	DW_AT_bit_offset           = 0x0c // block, constant, reference
109	DW_AT_bit_size             = 0x0d // block, constant, reference
110	DW_AT_stmt_list            = 0x10 // lineptr
111	DW_AT_low_pc               = 0x11 // address
112	DW_AT_high_pc              = 0x12 // address
113	DW_AT_language             = 0x13 // constant
114	DW_AT_discr                = 0x15 // reference
115	DW_AT_discr_value          = 0x16 // constant
116	DW_AT_visibility           = 0x17 // constant
117	DW_AT_import               = 0x18 // reference
118	DW_AT_string_length        = 0x19 // block, loclistptr
119	DW_AT_common_reference     = 0x1a // reference
120	DW_AT_comp_dir             = 0x1b // string
121	DW_AT_const_value          = 0x1c // block, constant, string
122	DW_AT_containing_type      = 0x1d // reference
123	DW_AT_default_value        = 0x1e // reference
124	DW_AT_inline               = 0x20 // constant
125	DW_AT_is_optional          = 0x21 // flag
126	DW_AT_lower_bound          = 0x22 // block, constant, reference
127	DW_AT_producer             = 0x25 // string
128	DW_AT_prototyped           = 0x27 // flag
129	DW_AT_return_addr          = 0x2a // block, loclistptr
130	DW_AT_start_scope          = 0x2c // constant
131	DW_AT_bit_stride           = 0x2e // constant
132	DW_AT_upper_bound          = 0x2f // block, constant, reference
133	DW_AT_abstract_origin      = 0x31 // reference
134	DW_AT_accessibility        = 0x32 // constant
135	DW_AT_address_class        = 0x33 // constant
136	DW_AT_artificial           = 0x34 // flag
137	DW_AT_base_types           = 0x35 // reference
138	DW_AT_calling_convention   = 0x36 // constant
139	DW_AT_count                = 0x37 // block, constant, reference
140	DW_AT_data_member_location = 0x38 // block, constant, loclistptr
141	DW_AT_decl_column          = 0x39 // constant
142	DW_AT_decl_file            = 0x3a // constant
143	DW_AT_decl_line            = 0x3b // constant
144	DW_AT_declaration          = 0x3c // flag
145	DW_AT_discr_list           = 0x3d // block
146	DW_AT_encoding             = 0x3e // constant
147	DW_AT_external             = 0x3f // flag
148	DW_AT_frame_base           = 0x40 // block, loclistptr
149	DW_AT_friend               = 0x41 // reference
150	DW_AT_identifier_case      = 0x42 // constant
151	DW_AT_macro_info           = 0x43 // macptr
152	DW_AT_namelist_item        = 0x44 // block
153	DW_AT_priority             = 0x45 // reference
154	DW_AT_segment              = 0x46 // block, loclistptr
155	DW_AT_specification        = 0x47 // reference
156	DW_AT_static_link          = 0x48 // block, loclistptr
157	DW_AT_type                 = 0x49 // reference
158	DW_AT_use_location         = 0x4a // block, loclistptr
159	DW_AT_variable_parameter   = 0x4b // flag
160	DW_AT_virtuality           = 0x4c // constant
161	DW_AT_vtable_elem_location = 0x4d // block, loclistptr
162	// Dwarf3
163	DW_AT_allocated      = 0x4e // block, constant, reference
164	DW_AT_associated     = 0x4f // block, constant, reference
165	DW_AT_data_location  = 0x50 // block
166	DW_AT_byte_stride    = 0x51 // block, constant, reference
167	DW_AT_entry_pc       = 0x52 // address
168	DW_AT_use_UTF8       = 0x53 // flag
169	DW_AT_extension      = 0x54 // reference
170	DW_AT_ranges         = 0x55 // rangelistptr
171	DW_AT_trampoline     = 0x56 // address, flag, reference, string
172	DW_AT_call_column    = 0x57 // constant
173	DW_AT_call_file      = 0x58 // constant
174	DW_AT_call_line      = 0x59 // constant
175	DW_AT_description    = 0x5a // string
176	DW_AT_binary_scale   = 0x5b // constant
177	DW_AT_decimal_scale  = 0x5c // constant
178	DW_AT_small          = 0x5d // reference
179	DW_AT_decimal_sign   = 0x5e // constant
180	DW_AT_digit_count    = 0x5f // constant
181	DW_AT_picture_string = 0x60 // string
182	DW_AT_mutable        = 0x61 // flag
183	DW_AT_threads_scaled = 0x62 // flag
184	DW_AT_explicit       = 0x63 // flag
185	DW_AT_object_pointer = 0x64 // reference
186	DW_AT_endianity      = 0x65 // constant
187	DW_AT_elemental      = 0x66 // flag
188	DW_AT_pure           = 0x67 // flag
189	DW_AT_recursive      = 0x68 // flag
190
191	DW_AT_lo_user = 0x2000 // ---
192	DW_AT_hi_user = 0x3fff // ---
193)
194
195// Table 21
196const (
197	DW_FORM_addr      = 0x01 // address
198	DW_FORM_block2    = 0x03 // block
199	DW_FORM_block4    = 0x04 // block
200	DW_FORM_data2     = 0x05 // constant
201	DW_FORM_data4     = 0x06 // constant, lineptr, loclistptr, macptr, rangelistptr
202	DW_FORM_data8     = 0x07 // constant, lineptr, loclistptr, macptr, rangelistptr
203	DW_FORM_string    = 0x08 // string
204	DW_FORM_block     = 0x09 // block
205	DW_FORM_block1    = 0x0a // block
206	DW_FORM_data1     = 0x0b // constant
207	DW_FORM_flag      = 0x0c // flag
208	DW_FORM_sdata     = 0x0d // constant
209	DW_FORM_strp      = 0x0e // string
210	DW_FORM_udata     = 0x0f // constant
211	DW_FORM_ref_addr  = 0x10 // reference
212	DW_FORM_ref1      = 0x11 // reference
213	DW_FORM_ref2      = 0x12 // reference
214	DW_FORM_ref4      = 0x13 // reference
215	DW_FORM_ref8      = 0x14 // reference
216	DW_FORM_ref_udata = 0x15 // reference
217	DW_FORM_indirect  = 0x16 // (see Section 7.5.3)
218	// Dwarf4
219	DW_FORM_sec_offset   = 0x17 // lineptr, loclistptr, macptr, rangelistptr
220	DW_FORM_exprloc      = 0x18 // exprloc
221	DW_FORM_flag_present = 0x19 // flag
222	DW_FORM_ref_sig8     = 0x20 // reference
223	// Pseudo-form: expanded to data4 on IOS, udata elsewhere.
224	DW_FORM_udata_pseudo = 0x99
225)
226
227// Table 24 (#operands, notes)
228const (
229	DW_OP_addr                = 0x03 // 1 constant address (size target specific)
230	DW_OP_deref               = 0x06 // 0
231	DW_OP_const1u             = 0x08 // 1 1-byte constant
232	DW_OP_const1s             = 0x09 // 1 1-byte constant
233	DW_OP_const2u             = 0x0a // 1 2-byte constant
234	DW_OP_const2s             = 0x0b // 1 2-byte constant
235	DW_OP_const4u             = 0x0c // 1 4-byte constant
236	DW_OP_const4s             = 0x0d // 1 4-byte constant
237	DW_OP_const8u             = 0x0e // 1 8-byte constant
238	DW_OP_const8s             = 0x0f // 1 8-byte constant
239	DW_OP_constu              = 0x10 // 1 ULEB128 constant
240	DW_OP_consts              = 0x11 // 1 SLEB128 constant
241	DW_OP_dup                 = 0x12 // 0
242	DW_OP_drop                = 0x13 // 0
243	DW_OP_over                = 0x14 // 0
244	DW_OP_pick                = 0x15 // 1 1-byte stack index
245	DW_OP_swap                = 0x16 // 0
246	DW_OP_rot                 = 0x17 // 0
247	DW_OP_xderef              = 0x18 // 0
248	DW_OP_abs                 = 0x19 // 0
249	DW_OP_and                 = 0x1a // 0
250	DW_OP_div                 = 0x1b // 0
251	DW_OP_minus               = 0x1c // 0
252	DW_OP_mod                 = 0x1d // 0
253	DW_OP_mul                 = 0x1e // 0
254	DW_OP_neg                 = 0x1f // 0
255	DW_OP_not                 = 0x20 // 0
256	DW_OP_or                  = 0x21 // 0
257	DW_OP_plus                = 0x22 // 0
258	DW_OP_plus_uconst         = 0x23 // 1 ULEB128 addend
259	DW_OP_shl                 = 0x24 // 0
260	DW_OP_shr                 = 0x25 // 0
261	DW_OP_shra                = 0x26 // 0
262	DW_OP_xor                 = 0x27 // 0
263	DW_OP_skip                = 0x2f // 1 signed 2-byte constant
264	DW_OP_bra                 = 0x28 // 1 signed 2-byte constant
265	DW_OP_eq                  = 0x29 // 0
266	DW_OP_ge                  = 0x2a // 0
267	DW_OP_gt                  = 0x2b // 0
268	DW_OP_le                  = 0x2c // 0
269	DW_OP_lt                  = 0x2d // 0
270	DW_OP_ne                  = 0x2e // 0
271	DW_OP_lit0                = 0x30 // 0 ...
272	DW_OP_lit31               = 0x4f // 0 literals 0..31 = (DW_OP_lit0 + literal)
273	DW_OP_reg0                = 0x50 // 0 ..
274	DW_OP_reg31               = 0x6f // 0 reg 0..31 = (DW_OP_reg0 + regnum)
275	DW_OP_breg0               = 0x70 // 1 ...
276	DW_OP_breg31              = 0x8f // 1 SLEB128 offset base register 0..31 = (DW_OP_breg0 + regnum)
277	DW_OP_regx                = 0x90 // 1 ULEB128 register
278	DW_OP_fbreg               = 0x91 // 1 SLEB128 offset
279	DW_OP_bregx               = 0x92 // 2 ULEB128 register followed by SLEB128 offset
280	DW_OP_piece               = 0x93 // 1 ULEB128 size of piece addressed
281	DW_OP_deref_size          = 0x94 // 1 1-byte size of data retrieved
282	DW_OP_xderef_size         = 0x95 // 1 1-byte size of data retrieved
283	DW_OP_nop                 = 0x96 // 0
284	DW_OP_push_object_address = 0x97 // 0
285	DW_OP_call2               = 0x98 // 1 2-byte offset of DIE
286	DW_OP_call4               = 0x99 // 1 4-byte offset of DIE
287	DW_OP_call_ref            = 0x9a // 1 4- or 8-byte offset of DIE
288	DW_OP_form_tls_address    = 0x9b // 0
289	DW_OP_call_frame_cfa      = 0x9c // 0
290	DW_OP_bit_piece           = 0x9d // 2
291	DW_OP_lo_user             = 0xe0
292	DW_OP_hi_user             = 0xff
293)
294
295// Table 25
296const (
297	DW_ATE_address         = 0x01
298	DW_ATE_boolean         = 0x02
299	DW_ATE_complex_float   = 0x03
300	DW_ATE_float           = 0x04
301	DW_ATE_signed          = 0x05
302	DW_ATE_signed_char     = 0x06
303	DW_ATE_unsigned        = 0x07
304	DW_ATE_unsigned_char   = 0x08
305	DW_ATE_imaginary_float = 0x09
306	DW_ATE_packed_decimal  = 0x0a
307	DW_ATE_numeric_string  = 0x0b
308	DW_ATE_edited          = 0x0c
309	DW_ATE_signed_fixed    = 0x0d
310	DW_ATE_unsigned_fixed  = 0x0e
311	DW_ATE_decimal_float   = 0x0f
312	DW_ATE_lo_user         = 0x80
313	DW_ATE_hi_user         = 0xff
314)
315
316// Table 26
317const (
318	DW_DS_unsigned           = 0x01
319	DW_DS_leading_overpunch  = 0x02
320	DW_DS_trailing_overpunch = 0x03
321	DW_DS_leading_separate   = 0x04
322	DW_DS_trailing_separate  = 0x05
323)
324
325// Table 27
326const (
327	DW_END_default = 0x00
328	DW_END_big     = 0x01
329	DW_END_little  = 0x02
330	DW_END_lo_user = 0x40
331	DW_END_hi_user = 0xff
332)
333
334// Table 28
335const (
336	DW_ACCESS_public    = 0x01
337	DW_ACCESS_protected = 0x02
338	DW_ACCESS_private   = 0x03
339)
340
341// Table 29
342const (
343	DW_VIS_local     = 0x01
344	DW_VIS_exported  = 0x02
345	DW_VIS_qualified = 0x03
346)
347
348// Table 30
349const (
350	DW_VIRTUALITY_none         = 0x00
351	DW_VIRTUALITY_virtual      = 0x01
352	DW_VIRTUALITY_pure_virtual = 0x02
353)
354
355// Table 31
356const (
357	DW_LANG_C89         = 0x0001
358	DW_LANG_C           = 0x0002
359	DW_LANG_Ada83       = 0x0003
360	DW_LANG_C_plus_plus = 0x0004
361	DW_LANG_Cobol74     = 0x0005
362	DW_LANG_Cobol85     = 0x0006
363	DW_LANG_Fortran77   = 0x0007
364	DW_LANG_Fortran90   = 0x0008
365	DW_LANG_Pascal83    = 0x0009
366	DW_LANG_Modula2     = 0x000a
367	// Dwarf3
368	DW_LANG_Java           = 0x000b
369	DW_LANG_C99            = 0x000c
370	DW_LANG_Ada95          = 0x000d
371	DW_LANG_Fortran95      = 0x000e
372	DW_LANG_PLI            = 0x000f
373	DW_LANG_ObjC           = 0x0010
374	DW_LANG_ObjC_plus_plus = 0x0011
375	DW_LANG_UPC            = 0x0012
376	DW_LANG_D              = 0x0013
377	// Dwarf4
378	DW_LANG_Python = 0x0014
379	// Dwarf5
380	DW_LANG_Go = 0x0016
381
382	DW_LANG_lo_user = 0x8000
383	DW_LANG_hi_user = 0xffff
384)
385
386// Table 32
387const (
388	DW_ID_case_sensitive   = 0x00
389	DW_ID_up_case          = 0x01
390	DW_ID_down_case        = 0x02
391	DW_ID_case_insensitive = 0x03
392)
393
394// Table 33
395const (
396	DW_CC_normal  = 0x01
397	DW_CC_program = 0x02
398	DW_CC_nocall  = 0x03
399	DW_CC_lo_user = 0x40
400	DW_CC_hi_user = 0xff
401)
402
403// Table 34
404const (
405	DW_INL_not_inlined          = 0x00
406	DW_INL_inlined              = 0x01
407	DW_INL_declared_not_inlined = 0x02
408	DW_INL_declared_inlined     = 0x03
409)
410
411// Table 35
412const (
413	DW_ORD_row_major = 0x00
414	DW_ORD_col_major = 0x01
415)
416
417// Table 36
418const (
419	DW_DSC_label = 0x00
420	DW_DSC_range = 0x01
421)
422
423// Table 37
424const (
425	DW_LNS_copy             = 0x01
426	DW_LNS_advance_pc       = 0x02
427	DW_LNS_advance_line     = 0x03
428	DW_LNS_set_file         = 0x04
429	DW_LNS_set_column       = 0x05
430	DW_LNS_negate_stmt      = 0x06
431	DW_LNS_set_basic_block  = 0x07
432	DW_LNS_const_add_pc     = 0x08
433	DW_LNS_fixed_advance_pc = 0x09
434	// Dwarf3
435	DW_LNS_set_prologue_end   = 0x0a
436	DW_LNS_set_epilogue_begin = 0x0b
437	DW_LNS_set_isa            = 0x0c
438)
439
440// Table 38
441const (
442	DW_LNE_end_sequence = 0x01
443	DW_LNE_set_address  = 0x02
444	DW_LNE_define_file  = 0x03
445	DW_LNE_lo_user      = 0x80
446	DW_LNE_hi_user      = 0xff
447)
448
449// Table 39
450const (
451	DW_MACINFO_define     = 0x01
452	DW_MACINFO_undef      = 0x02
453	DW_MACINFO_start_file = 0x03
454	DW_MACINFO_end_file   = 0x04
455	DW_MACINFO_vendor_ext = 0xff
456)
457
458// Table 40.
459const (
460	// operand,...
461	DW_CFA_nop              = 0x00
462	DW_CFA_set_loc          = 0x01 // address
463	DW_CFA_advance_loc1     = 0x02 // 1-byte delta
464	DW_CFA_advance_loc2     = 0x03 // 2-byte delta
465	DW_CFA_advance_loc4     = 0x04 // 4-byte delta
466	DW_CFA_offset_extended  = 0x05 // ULEB128 register, ULEB128 offset
467	DW_CFA_restore_extended = 0x06 // ULEB128 register
468	DW_CFA_undefined        = 0x07 // ULEB128 register
469	DW_CFA_same_value       = 0x08 // ULEB128 register
470	DW_CFA_register         = 0x09 // ULEB128 register, ULEB128 register
471	DW_CFA_remember_state   = 0x0a
472	DW_CFA_restore_state    = 0x0b
473
474	DW_CFA_def_cfa            = 0x0c // ULEB128 register, ULEB128 offset
475	DW_CFA_def_cfa_register   = 0x0d // ULEB128 register
476	DW_CFA_def_cfa_offset     = 0x0e // ULEB128 offset
477	DW_CFA_def_cfa_expression = 0x0f // BLOCK
478	DW_CFA_expression         = 0x10 // ULEB128 register, BLOCK
479	DW_CFA_offset_extended_sf = 0x11 // ULEB128 register, SLEB128 offset
480	DW_CFA_def_cfa_sf         = 0x12 // ULEB128 register, SLEB128 offset
481	DW_CFA_def_cfa_offset_sf  = 0x13 // SLEB128 offset
482	DW_CFA_val_offset         = 0x14 // ULEB128, ULEB128
483	DW_CFA_val_offset_sf      = 0x15 // ULEB128, SLEB128
484	DW_CFA_val_expression     = 0x16 // ULEB128, BLOCK
485
486	DW_CFA_lo_user = 0x1c
487	DW_CFA_hi_user = 0x3f
488
489	// Opcodes that take an addend operand.
490	DW_CFA_advance_loc = 0x1 << 6 // +delta
491	DW_CFA_offset      = 0x2 << 6 // +register (ULEB128 offset)
492	DW_CFA_restore     = 0x3 << 6 // +register
493)
494