1// dwarf.h -- DWARF2 constants  -*- C++ -*-
2
3// Copyright (C) 2006-2022 Free Software Foundation, Inc.
4// Written by Ian Lance Taylor <iant@google.com>.
5
6// This file is part of elfcpp.
7
8// This program is free software; you can redistribute it and/or
9// modify it under the terms of the GNU Library General Public License
10// as published by the Free Software Foundation; either version 2, or
11// (at your option) any later version.
12
13// In addition to the permissions in the GNU Library General Public
14// License, the Free Software Foundation gives you unlimited
15// permission to link the compiled version of this file into
16// combinations with other programs, and to distribute those
17// combinations without any restriction coming from the use of this
18// file.  (The Library Public License restrictions do apply in other
19// respects; for example, they cover modification of the file, and
20/// distribution when not linked into a combined executable.)
21
22// This program is distributed in the hope that it will be useful, but
23// WITHOUT ANY WARRANTY; without even the implied warranty of
24// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
25// Library General Public License for more details.
26
27// You should have received a copy of the GNU Library General Public
28// License along with this program; if not, write to the Free Software
29// Foundation, Inc., 51 Franklin Street - Fifth Floor, Boston, MA
30// 02110-1301, USA.
31
32#ifndef ELFCPP_DWARF_H
33#define ELFCPP_DWARF_H
34
35namespace elfcpp
36{
37
38// DWARF2 codes.
39
40// Include DW_TAG, DW_FORM, DW_AT, DW_OP, DW_ATE, and DW_CFA
41// codes from dwarf2.def.
42
43#define DW_FIRST_TAG(name, value) enum DW_TAG { \
44  name = value
45#define DW_TAG(name, value) , name = value
46#define DW_TAG_DUP(name, value) , name = value
47#define DW_END_TAG };
48
49#define DW_FIRST_FORM(name, value) enum DW_FORM { \
50  name = value
51#define DW_FORM(name, value) , name = value
52#define DW_END_FORM };
53
54#define DW_FIRST_AT(name, value) enum DW_AT { \
55  name = value
56#define DW_AT(name, value) , name = value
57#define DW_AT_DUP(name, value) , name = value
58#define DW_END_AT };
59
60#define DW_FIRST_OP(name, value) enum DW_OP { \
61  name = value
62#define DW_OP(name, value) , name = value
63#define DW_OP_DUP(name, value) , name = value
64#define DW_END_OP };
65
66#define DW_FIRST_ATE(name, value) enum DW_ENCODING { \
67  name = value
68#define DW_ATE(name, value) , name = value
69#define DW_ATE_DUP(name, value) , name = value
70#define DW_END_ATE };
71
72#define DW_FIRST_CFA(name, value) enum DW_CFA { \
73  name = value
74#define DW_CFA(name, value) , name = value
75#define DW_CFA_DUP(name, value) , name = value
76#define DW_END_CFA };
77
78#define DW_FIRST_IDX(name, value) enum dwarf_name_index_attribute { \
79  name = value
80#define DW_IDX(name, value) , name = value
81#define DW_IDX_DUP(name, value) , name = value
82#define DW_END_IDX };
83
84#define DW_FIRST_UT(name, value) enum dwarf_unit_type { \
85  name = value
86#define DW_UT(name, value) , name = value
87#define DW_END_UT };
88
89#include "dwarf2.def"
90
91#undef DW_FIRST_TAG
92#undef DW_TAG
93#undef DW_TAG_DUP
94#undef DW_END_TAG
95
96#undef DW_FIRST_FORM
97#undef DW_FORM
98#undef DW_END_FORM
99
100#undef DW_FIRST_AT
101#undef DW_AT
102#undef DW_AT_DUP
103#undef DW_END_AT
104
105#undef DW_FIRST_OP
106#undef DW_OP
107#undef DW_OP_DUP
108#undef DW_END_OP
109
110#undef DW_FIRST_ATE
111#undef DW_ATE
112#undef DW_ATE_DUP
113#undef DW_END_ATE
114
115#undef DW_FIRST_CFA
116#undef DW_CFA_DUP
117#undef DW_CFA
118#undef DW_END_CFA
119
120#undef DW_FIRST_IDX
121#undef DW_IDX
122#undef DW_IDX_DUP
123#undef DW_END_IDX
124
125#undef DW_FIRST_UT
126#undef DW_UT
127#undef DW_END_UT
128
129// Frame unwind information.
130
131enum DW_EH_PE
132{
133  DW_EH_PE_absptr = 0x00,
134  DW_EH_PE_omit = 0xff,
135
136  DW_EH_PE_uleb128 = 0x01,
137  DW_EH_PE_udata2 = 0x02,
138  DW_EH_PE_udata4 = 0x03,
139  DW_EH_PE_udata8 = 0x04,
140  DW_EH_PE_signed = 0x08,
141  DW_EH_PE_sleb128 = 0x09,
142  DW_EH_PE_sdata2 = 0x0a,
143  DW_EH_PE_sdata4 = 0x0b,
144  DW_EH_PE_sdata8 = 0x0c,
145
146  DW_EH_PE_pcrel = 0x10,
147  DW_EH_PE_textrel = 0x20,
148  DW_EH_PE_datarel = 0x30,
149  DW_EH_PE_funcrel = 0x40,
150  DW_EH_PE_aligned = 0x50,
151
152  DW_EH_PE_indirect = 0x80
153};
154
155// Line number table content type codes.
156
157enum DW_LNCT
158{
159  DW_LNCT_path            = 0x1,
160  DW_LNCT_directory_index = 0x2,
161  DW_LNCT_timestamp       = 0x3,
162  DW_LNCT_size            = 0x4,
163  DW_LNCT_MD5             = 0x5,
164  DW_LNCT_lo_user         = 0x2000,
165  DW_LNCT_hi_user         = 0x3fff
166};
167
168// Line number opcodes.
169
170enum DW_LINE_OPS
171{
172  DW_LNS_extended_op        = 0x00,
173  DW_LNS_copy               = 0x01,
174  DW_LNS_advance_pc         = 0x02,
175  DW_LNS_advance_line       = 0x03,
176  DW_LNS_set_file           = 0x04,
177  DW_LNS_set_column         = 0x05,
178  DW_LNS_negate_stmt        = 0x06,
179  DW_LNS_set_basic_block    = 0x07,
180  DW_LNS_const_add_pc       = 0x08,
181  DW_LNS_fixed_advance_pc   = 0x09,
182  // DWARF 3.
183  DW_LNS_set_prologue_end   = 0x0a,
184  DW_LNS_set_epilogue_begin = 0x0b,
185  DW_LNS_set_isa            = 0x0c
186};
187
188// Line number extended opcodes.
189
190enum DW_LINE_EXTENDED_OPS
191{
192  DW_LNE_end_sequence                = 0x01,
193  DW_LNE_set_address                 = 0x02,
194  DW_LNE_define_file                 = 0x03,
195  // DWARF4.
196  DW_LNE_set_discriminator           = 0x04,
197  // HP extensions.
198  DW_LNE_HP_negate_is_UV_update      = 0x11,
199  DW_LNE_HP_push_context             = 0x12,
200  DW_LNE_HP_pop_context              = 0x13,
201  DW_LNE_HP_set_file_line_column     = 0x14,
202  DW_LNE_HP_set_routine_name         = 0x15,
203  DW_LNE_HP_set_sequence             = 0x16,
204  DW_LNE_HP_negate_post_semantics    = 0x17,
205  DW_LNE_HP_negate_function_exit     = 0x18,
206  DW_LNE_HP_negate_front_end_logical = 0x19,
207  DW_LNE_HP_define_proc              = 0x20,
208  DW_LNE_lo_user                     = 0x80,
209  DW_LNE_hi_user                     = 0xff
210};
211
212enum DW_CHILDREN
213{
214  DW_CHILDREN_no  = 0,
215  DW_CHILDREN_yes = 1
216};
217
218// Source language names and codes.
219enum DW_LANG
220{
221  DW_LANG_C89 = 0x0001,
222  DW_LANG_C = 0x0002,
223  DW_LANG_Ada83 = 0x0003,
224  DW_LANG_C_plus_plus = 0x0004,
225  DW_LANG_Cobol74 = 0x0005,
226  DW_LANG_Cobol85 = 0x0006,
227  DW_LANG_Fortran77 = 0x0007,
228  DW_LANG_Fortran90 = 0x0008,
229  DW_LANG_Pascal83 = 0x0009,
230  DW_LANG_Modula2 = 0x000a,
231  // DWARF 3.
232  DW_LANG_Java = 0x000b,
233  DW_LANG_C99 = 0x000c,
234  DW_LANG_Ada95 = 0x000d,
235  DW_LANG_Fortran95 = 0x000e,
236  DW_LANG_PLI = 0x000f,
237  DW_LANG_ObjC = 0x0010,
238  DW_LANG_ObjC_plus_plus = 0x0011,
239  DW_LANG_UPC = 0x0012,
240  DW_LANG_D = 0x0013,
241  // DWARF 4.
242  DW_LANG_Python = 0x0014,
243  // DWARF 5.
244  DW_LANG_Go = 0x0016,
245  DW_LANG_C_plus_plus_11 = 0x001a,
246  DW_LANG_C11 = 0x001d,
247  DW_LANG_C_plus_plus_14 = 0x0021,
248  DW_LANG_Fortran03 = 0x0022,
249  DW_LANG_Fortran08 = 0x0023,
250
251  DW_LANG_lo_user = 0x8000,	// Implementation-defined range start.
252  DW_LANG_hi_user = 0xffff,	// Implementation-defined range start.
253  // MIPS.
254  DW_LANG_Mips_Assembler = 0x8001,
255  // UPC.
256  DW_LANG_Upc = 0x8765,
257  // HP extensions.
258  DW_LANG_HP_Bliss     = 0x8003,
259  DW_LANG_HP_Basic91   = 0x8004,
260  DW_LANG_HP_Pascal91  = 0x8005,
261  DW_LANG_HP_IMacro    = 0x8006,
262  DW_LANG_HP_Assembler = 0x8007
263};
264
265// Range list entry kinds in .debug_rnglists* section.
266
267enum DW_RLE
268{
269  DW_RLE_end_of_list   = 0x00,
270  DW_RLE_base_addressx = 0x01,
271  DW_RLE_startx_endx   = 0x02,
272  DW_RLE_startx_length = 0x03,
273  DW_RLE_offset_pair   = 0x04,
274  DW_RLE_base_address  = 0x05,
275  DW_RLE_start_end     = 0x06,
276  DW_RLE_start_length  = 0x07
277};
278
279// DWARF section identifiers used in the package format.
280// Extensions for Fission.  See http://gcc.gnu.org/wiki/DebugFissionDWP.
281// Added (with changes) in DWARF 5.
282
283enum DW_SECT
284{
285  DW_SECT_INFO        = 1,
286  DW_SECT_ABBREV      = 3,
287  DW_SECT_LINE        = 4,
288  DW_SECT_LOCLISTS    = 5,
289  DW_SECT_STR_OFFSETS = 6,
290  DW_SECT_MACINFO     = 7,
291  DW_SECT_RNGLISTS    = 8,
292  DW_SECT_MAX = DW_SECT_RNGLISTS,
293  // These were used only for the experimental Fission support in DWARF 4.
294  DW_SECT_TYPES       = 2,
295  DW_SECT_LOC         = 5,
296  DW_SECT_MACRO       = 8
297};
298
299} // End namespace elfcpp.
300
301#endif // !defined(ELFCPP_DWARF_H)
302