1 // dwarf.h -- DWARF2 constants -*- C++ -*-
2
3 // Copyright (C) 2006-2023 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
35 namespace 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
131 enum 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
157 enum 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
170 enum 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
190 enum 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
212 enum DW_CHILDREN
213 {
214 DW_CHILDREN_no = 0,
215 DW_CHILDREN_yes = 1
216 };
217
218 // Source language names and codes.
219 enum 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
267 enum 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
283 enum 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)