annotate libgcc/unwind-pe.h @ 158:494b0b89df80 default tip

...
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Mon, 25 May 2020 18:13:55 +0900
parents 1830386684a0
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
111
kono
parents:
diff changeset
1 /* Exception handling and frame unwind runtime interface routines.
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
2 Copyright (C) 2001-2020 Free Software Foundation, Inc.
111
kono
parents:
diff changeset
3
kono
parents:
diff changeset
4 This file is part of GCC.
kono
parents:
diff changeset
5
kono
parents:
diff changeset
6 GCC is free software; you can redistribute it and/or modify it
kono
parents:
diff changeset
7 under the terms of the GNU General Public License as published by
kono
parents:
diff changeset
8 the Free Software Foundation; either version 3, or (at your option)
kono
parents:
diff changeset
9 any later version.
kono
parents:
diff changeset
10
kono
parents:
diff changeset
11 GCC is distributed in the hope that it will be useful, but WITHOUT
kono
parents:
diff changeset
12 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
kono
parents:
diff changeset
13 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
kono
parents:
diff changeset
14 License for more details.
kono
parents:
diff changeset
15
kono
parents:
diff changeset
16 Under Section 7 of GPL version 3, you are granted additional
kono
parents:
diff changeset
17 permissions described in the GCC Runtime Library Exception, version
kono
parents:
diff changeset
18 3.1, as published by the Free Software Foundation.
kono
parents:
diff changeset
19
kono
parents:
diff changeset
20 You should have received a copy of the GNU General Public License and
kono
parents:
diff changeset
21 a copy of the GCC Runtime Library Exception along with this program;
kono
parents:
diff changeset
22 see the files COPYING3 and COPYING.RUNTIME respectively. If not, see
kono
parents:
diff changeset
23 <http://www.gnu.org/licenses/>. */
kono
parents:
diff changeset
24
kono
parents:
diff changeset
25 /* @@@ Really this should be out of line, but this also causes link
kono
parents:
diff changeset
26 compatibility problems with the base ABI. This is slightly better
kono
parents:
diff changeset
27 than duplicating code, however. */
kono
parents:
diff changeset
28
kono
parents:
diff changeset
29 #ifndef GCC_UNWIND_PE_H
kono
parents:
diff changeset
30 #define GCC_UNWIND_PE_H
kono
parents:
diff changeset
31
kono
parents:
diff changeset
32 /* If using C++, references to abort have to be qualified with std::. */
kono
parents:
diff changeset
33 #if __cplusplus
kono
parents:
diff changeset
34 #define __gxx_abort std::abort
kono
parents:
diff changeset
35 #else
kono
parents:
diff changeset
36 #define __gxx_abort abort
kono
parents:
diff changeset
37 #endif
kono
parents:
diff changeset
38
kono
parents:
diff changeset
39 /* Pointer encodings, from dwarf2.h. */
kono
parents:
diff changeset
40 #define DW_EH_PE_absptr 0x00
kono
parents:
diff changeset
41 #define DW_EH_PE_omit 0xff
kono
parents:
diff changeset
42
kono
parents:
diff changeset
43 #define DW_EH_PE_uleb128 0x01
kono
parents:
diff changeset
44 #define DW_EH_PE_udata2 0x02
kono
parents:
diff changeset
45 #define DW_EH_PE_udata4 0x03
kono
parents:
diff changeset
46 #define DW_EH_PE_udata8 0x04
kono
parents:
diff changeset
47 #define DW_EH_PE_sleb128 0x09
kono
parents:
diff changeset
48 #define DW_EH_PE_sdata2 0x0A
kono
parents:
diff changeset
49 #define DW_EH_PE_sdata4 0x0B
kono
parents:
diff changeset
50 #define DW_EH_PE_sdata8 0x0C
kono
parents:
diff changeset
51 #define DW_EH_PE_signed 0x08
kono
parents:
diff changeset
52
kono
parents:
diff changeset
53 #define DW_EH_PE_pcrel 0x10
kono
parents:
diff changeset
54 #define DW_EH_PE_textrel 0x20
kono
parents:
diff changeset
55 #define DW_EH_PE_datarel 0x30
kono
parents:
diff changeset
56 #define DW_EH_PE_funcrel 0x40
kono
parents:
diff changeset
57 #define DW_EH_PE_aligned 0x50
kono
parents:
diff changeset
58
kono
parents:
diff changeset
59 #define DW_EH_PE_indirect 0x80
kono
parents:
diff changeset
60
kono
parents:
diff changeset
61
kono
parents:
diff changeset
62 #ifndef NO_SIZE_OF_ENCODED_VALUE
kono
parents:
diff changeset
63
kono
parents:
diff changeset
64 /* Given an encoding, return the number of bytes the format occupies.
kono
parents:
diff changeset
65 This is only defined for fixed-size encodings, and so does not
kono
parents:
diff changeset
66 include leb128. */
kono
parents:
diff changeset
67
kono
parents:
diff changeset
68 static unsigned int
kono
parents:
diff changeset
69 size_of_encoded_value (unsigned char encoding) __attribute__ ((unused));
kono
parents:
diff changeset
70
kono
parents:
diff changeset
71 static unsigned int
kono
parents:
diff changeset
72 size_of_encoded_value (unsigned char encoding)
kono
parents:
diff changeset
73 {
kono
parents:
diff changeset
74 if (encoding == DW_EH_PE_omit)
kono
parents:
diff changeset
75 return 0;
kono
parents:
diff changeset
76
kono
parents:
diff changeset
77 switch (encoding & 0x07)
kono
parents:
diff changeset
78 {
kono
parents:
diff changeset
79 case DW_EH_PE_absptr:
kono
parents:
diff changeset
80 return sizeof (void *);
kono
parents:
diff changeset
81 case DW_EH_PE_udata2:
kono
parents:
diff changeset
82 return 2;
kono
parents:
diff changeset
83 case DW_EH_PE_udata4:
kono
parents:
diff changeset
84 return 4;
kono
parents:
diff changeset
85 case DW_EH_PE_udata8:
kono
parents:
diff changeset
86 return 8;
kono
parents:
diff changeset
87 }
kono
parents:
diff changeset
88 __gxx_abort ();
kono
parents:
diff changeset
89 }
kono
parents:
diff changeset
90
kono
parents:
diff changeset
91 #endif
kono
parents:
diff changeset
92
kono
parents:
diff changeset
93 #ifndef NO_BASE_OF_ENCODED_VALUE
kono
parents:
diff changeset
94
kono
parents:
diff changeset
95 /* Given an encoding and an _Unwind_Context, return the base to which
kono
parents:
diff changeset
96 the encoding is relative. This base may then be passed to
kono
parents:
diff changeset
97 read_encoded_value_with_base for use when the _Unwind_Context is
kono
parents:
diff changeset
98 not available. */
kono
parents:
diff changeset
99
kono
parents:
diff changeset
100 static _Unwind_Ptr
kono
parents:
diff changeset
101 base_of_encoded_value (unsigned char encoding, struct _Unwind_Context *context)
kono
parents:
diff changeset
102 {
kono
parents:
diff changeset
103 if (encoding == DW_EH_PE_omit)
kono
parents:
diff changeset
104 return 0;
kono
parents:
diff changeset
105
kono
parents:
diff changeset
106 switch (encoding & 0x70)
kono
parents:
diff changeset
107 {
kono
parents:
diff changeset
108 case DW_EH_PE_absptr:
kono
parents:
diff changeset
109 case DW_EH_PE_pcrel:
kono
parents:
diff changeset
110 case DW_EH_PE_aligned:
kono
parents:
diff changeset
111 return 0;
kono
parents:
diff changeset
112
kono
parents:
diff changeset
113 case DW_EH_PE_textrel:
kono
parents:
diff changeset
114 return _Unwind_GetTextRelBase (context);
kono
parents:
diff changeset
115 case DW_EH_PE_datarel:
kono
parents:
diff changeset
116 return _Unwind_GetDataRelBase (context);
kono
parents:
diff changeset
117 case DW_EH_PE_funcrel:
kono
parents:
diff changeset
118 return _Unwind_GetRegionStart (context);
kono
parents:
diff changeset
119 }
kono
parents:
diff changeset
120 __gxx_abort ();
kono
parents:
diff changeset
121 }
kono
parents:
diff changeset
122
kono
parents:
diff changeset
123 #endif
kono
parents:
diff changeset
124
kono
parents:
diff changeset
125 /* Read an unsigned leb128 value from P, store the value in VAL, return
kono
parents:
diff changeset
126 P incremented past the value. We assume that a word is large enough to
kono
parents:
diff changeset
127 hold any value so encoded; if it is smaller than a pointer on some target,
kono
parents:
diff changeset
128 pointers should not be leb128 encoded on that target. */
kono
parents:
diff changeset
129
kono
parents:
diff changeset
130 static const unsigned char *
kono
parents:
diff changeset
131 read_uleb128 (const unsigned char *p, _uleb128_t *val)
kono
parents:
diff changeset
132 {
kono
parents:
diff changeset
133 unsigned int shift = 0;
kono
parents:
diff changeset
134 unsigned char byte;
kono
parents:
diff changeset
135 _uleb128_t result;
kono
parents:
diff changeset
136
kono
parents:
diff changeset
137 result = 0;
kono
parents:
diff changeset
138 do
kono
parents:
diff changeset
139 {
kono
parents:
diff changeset
140 byte = *p++;
kono
parents:
diff changeset
141 result |= ((_uleb128_t)byte & 0x7f) << shift;
kono
parents:
diff changeset
142 shift += 7;
kono
parents:
diff changeset
143 }
kono
parents:
diff changeset
144 while (byte & 0x80);
kono
parents:
diff changeset
145
kono
parents:
diff changeset
146 *val = result;
kono
parents:
diff changeset
147 return p;
kono
parents:
diff changeset
148 }
kono
parents:
diff changeset
149
kono
parents:
diff changeset
150 /* Similar, but read a signed leb128 value. */
kono
parents:
diff changeset
151
kono
parents:
diff changeset
152 static const unsigned char *
kono
parents:
diff changeset
153 read_sleb128 (const unsigned char *p, _sleb128_t *val)
kono
parents:
diff changeset
154 {
kono
parents:
diff changeset
155 unsigned int shift = 0;
kono
parents:
diff changeset
156 unsigned char byte;
kono
parents:
diff changeset
157 _uleb128_t result;
kono
parents:
diff changeset
158
kono
parents:
diff changeset
159 result = 0;
kono
parents:
diff changeset
160 do
kono
parents:
diff changeset
161 {
kono
parents:
diff changeset
162 byte = *p++;
kono
parents:
diff changeset
163 result |= ((_uleb128_t)byte & 0x7f) << shift;
kono
parents:
diff changeset
164 shift += 7;
kono
parents:
diff changeset
165 }
kono
parents:
diff changeset
166 while (byte & 0x80);
kono
parents:
diff changeset
167
kono
parents:
diff changeset
168 /* Sign-extend a negative value. */
kono
parents:
diff changeset
169 if (shift < 8 * sizeof(result) && (byte & 0x40) != 0)
kono
parents:
diff changeset
170 result |= -(((_uleb128_t)1L) << shift);
kono
parents:
diff changeset
171
kono
parents:
diff changeset
172 *val = (_sleb128_t) result;
kono
parents:
diff changeset
173 return p;
kono
parents:
diff changeset
174 }
kono
parents:
diff changeset
175
kono
parents:
diff changeset
176 /* Load an encoded value from memory at P. The value is returned in VAL;
kono
parents:
diff changeset
177 The function returns P incremented past the value. BASE is as given
kono
parents:
diff changeset
178 by base_of_encoded_value for this encoding in the appropriate context. */
kono
parents:
diff changeset
179
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
180 #pragma GCC diagnostic push
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
181 #pragma GCC diagnostic ignored "-Waddress-of-packed-member"
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
182
111
kono
parents:
diff changeset
183 static const unsigned char *
kono
parents:
diff changeset
184 read_encoded_value_with_base (unsigned char encoding, _Unwind_Ptr base,
kono
parents:
diff changeset
185 const unsigned char *p, _Unwind_Ptr *val)
kono
parents:
diff changeset
186 {
kono
parents:
diff changeset
187 union unaligned
kono
parents:
diff changeset
188 {
kono
parents:
diff changeset
189 void *ptr;
kono
parents:
diff changeset
190 unsigned u2 __attribute__ ((mode (HI)));
kono
parents:
diff changeset
191 unsigned u4 __attribute__ ((mode (SI)));
kono
parents:
diff changeset
192 unsigned u8 __attribute__ ((mode (DI)));
kono
parents:
diff changeset
193 signed s2 __attribute__ ((mode (HI)));
kono
parents:
diff changeset
194 signed s4 __attribute__ ((mode (SI)));
kono
parents:
diff changeset
195 signed s8 __attribute__ ((mode (DI)));
kono
parents:
diff changeset
196 } __attribute__((__packed__));
kono
parents:
diff changeset
197
kono
parents:
diff changeset
198 const union unaligned *u = (const union unaligned *) p;
kono
parents:
diff changeset
199 _Unwind_Internal_Ptr result;
kono
parents:
diff changeset
200
kono
parents:
diff changeset
201 if (encoding == DW_EH_PE_aligned)
kono
parents:
diff changeset
202 {
kono
parents:
diff changeset
203 _Unwind_Internal_Ptr a = (_Unwind_Internal_Ptr) p;
kono
parents:
diff changeset
204 a = (a + sizeof (void *) - 1) & - sizeof(void *);
kono
parents:
diff changeset
205 result = *(_Unwind_Internal_Ptr *) a;
kono
parents:
diff changeset
206 p = (const unsigned char *) (_Unwind_Internal_Ptr) (a + sizeof (void *));
kono
parents:
diff changeset
207 }
kono
parents:
diff changeset
208 else
kono
parents:
diff changeset
209 {
kono
parents:
diff changeset
210 switch (encoding & 0x0f)
kono
parents:
diff changeset
211 {
kono
parents:
diff changeset
212 case DW_EH_PE_absptr:
kono
parents:
diff changeset
213 result = (_Unwind_Internal_Ptr) u->ptr;
kono
parents:
diff changeset
214 p += sizeof (void *);
kono
parents:
diff changeset
215 break;
kono
parents:
diff changeset
216
kono
parents:
diff changeset
217 case DW_EH_PE_uleb128:
kono
parents:
diff changeset
218 {
kono
parents:
diff changeset
219 _uleb128_t tmp;
kono
parents:
diff changeset
220 p = read_uleb128 (p, &tmp);
kono
parents:
diff changeset
221 result = (_Unwind_Internal_Ptr) tmp;
kono
parents:
diff changeset
222 }
kono
parents:
diff changeset
223 break;
kono
parents:
diff changeset
224
kono
parents:
diff changeset
225 case DW_EH_PE_sleb128:
kono
parents:
diff changeset
226 {
kono
parents:
diff changeset
227 _sleb128_t tmp;
kono
parents:
diff changeset
228 p = read_sleb128 (p, &tmp);
kono
parents:
diff changeset
229 result = (_Unwind_Internal_Ptr) tmp;
kono
parents:
diff changeset
230 }
kono
parents:
diff changeset
231 break;
kono
parents:
diff changeset
232
kono
parents:
diff changeset
233 case DW_EH_PE_udata2:
kono
parents:
diff changeset
234 result = u->u2;
kono
parents:
diff changeset
235 p += 2;
kono
parents:
diff changeset
236 break;
kono
parents:
diff changeset
237 case DW_EH_PE_udata4:
kono
parents:
diff changeset
238 result = u->u4;
kono
parents:
diff changeset
239 p += 4;
kono
parents:
diff changeset
240 break;
kono
parents:
diff changeset
241 case DW_EH_PE_udata8:
kono
parents:
diff changeset
242 result = u->u8;
kono
parents:
diff changeset
243 p += 8;
kono
parents:
diff changeset
244 break;
kono
parents:
diff changeset
245
kono
parents:
diff changeset
246 case DW_EH_PE_sdata2:
kono
parents:
diff changeset
247 result = u->s2;
kono
parents:
diff changeset
248 p += 2;
kono
parents:
diff changeset
249 break;
kono
parents:
diff changeset
250 case DW_EH_PE_sdata4:
kono
parents:
diff changeset
251 result = u->s4;
kono
parents:
diff changeset
252 p += 4;
kono
parents:
diff changeset
253 break;
kono
parents:
diff changeset
254 case DW_EH_PE_sdata8:
kono
parents:
diff changeset
255 result = u->s8;
kono
parents:
diff changeset
256 p += 8;
kono
parents:
diff changeset
257 break;
kono
parents:
diff changeset
258
kono
parents:
diff changeset
259 default:
kono
parents:
diff changeset
260 __gxx_abort ();
kono
parents:
diff changeset
261 }
kono
parents:
diff changeset
262
kono
parents:
diff changeset
263 if (result != 0)
kono
parents:
diff changeset
264 {
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
265 #if __FDPIC__
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
266 /* FDPIC relative addresses imply taking the GOT address
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
267 into account. */
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
268 if ((encoding & DW_EH_PE_pcrel) && (encoding & DW_EH_PE_indirect))
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
269 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
270 result += _Unwind_gnu_Find_got ((_Unwind_Ptr) u);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
271 result = *(_Unwind_Internal_Ptr *) result;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
272 }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
273 else
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
274 {
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
275 result += ((encoding & 0x70) == DW_EH_PE_pcrel
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
276 ? (_Unwind_Internal_Ptr) u : base);
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
277 if (encoding & DW_EH_PE_indirect)
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
278 result = *(_Unwind_Internal_Ptr *) result;
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
279 }
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
280 #else
111
kono
parents:
diff changeset
281 result += ((encoding & 0x70) == DW_EH_PE_pcrel
kono
parents:
diff changeset
282 ? (_Unwind_Internal_Ptr) u : base);
kono
parents:
diff changeset
283 if (encoding & DW_EH_PE_indirect)
kono
parents:
diff changeset
284 result = *(_Unwind_Internal_Ptr *) result;
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
285 #endif
111
kono
parents:
diff changeset
286 }
kono
parents:
diff changeset
287 }
kono
parents:
diff changeset
288
kono
parents:
diff changeset
289 *val = result;
kono
parents:
diff changeset
290 return p;
kono
parents:
diff changeset
291 }
kono
parents:
diff changeset
292
145
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
293 #pragma GCC diagnostic pop
1830386684a0 gcc-9.2.0
anatofuz
parents: 131
diff changeset
294
111
kono
parents:
diff changeset
295 #ifndef NO_BASE_OF_ENCODED_VALUE
kono
parents:
diff changeset
296
kono
parents:
diff changeset
297 /* Like read_encoded_value_with_base, but get the base from the context
kono
parents:
diff changeset
298 rather than providing it directly. */
kono
parents:
diff changeset
299
kono
parents:
diff changeset
300 static inline const unsigned char *
kono
parents:
diff changeset
301 read_encoded_value (struct _Unwind_Context *context, unsigned char encoding,
kono
parents:
diff changeset
302 const unsigned char *p, _Unwind_Ptr *val)
kono
parents:
diff changeset
303 {
kono
parents:
diff changeset
304 return read_encoded_value_with_base (encoding,
kono
parents:
diff changeset
305 base_of_encoded_value (encoding, context),
kono
parents:
diff changeset
306 p, val);
kono
parents:
diff changeset
307 }
kono
parents:
diff changeset
308
kono
parents:
diff changeset
309 #endif
kono
parents:
diff changeset
310
kono
parents:
diff changeset
311 #endif /* unwind-pe.h */