projects/linux·blob master · refs

417 lines · 9.7 KiB

1/* SPDX-License-Identifier: GPL-2.0
2 *
3 * Copyright (C) 2009 Matt Fleming <[email protected]>
4 */
5#ifndef __ASM_SH_DWARF_H
6#define __ASM_SH_DWARF_H
7
8#ifdef CONFIG_DWARF_UNWINDER
9
10/*
11 * DWARF expression operations
12 */
13#define DW_OP_addr 0x03
14#define DW_OP_deref 0x06
15#define DW_OP_const1u 0x08
16#define DW_OP_const1s 0x09
17#define DW_OP_const2u 0x0a
18#define DW_OP_const2s 0x0b
19#define DW_OP_const4u 0x0c
20#define DW_OP_const4s 0x0d
21#define DW_OP_const8u 0x0e
22#define DW_OP_const8s 0x0f
23#define DW_OP_constu 0x10
24#define DW_OP_consts 0x11
25#define DW_OP_dup 0x12
26#define DW_OP_drop 0x13
27#define DW_OP_over 0x14
28#define DW_OP_pick 0x15
29#define DW_OP_swap 0x16
30#define DW_OP_rot 0x17
31#define DW_OP_xderef 0x18
32#define DW_OP_abs 0x19
33#define DW_OP_and 0x1a
34#define DW_OP_div 0x1b
35#define DW_OP_minus 0x1c
36#define DW_OP_mod 0x1d
37#define DW_OP_mul 0x1e
38#define DW_OP_neg 0x1f
39#define DW_OP_not 0x20
40#define DW_OP_or 0x21
41#define DW_OP_plus 0x22
42#define DW_OP_plus_uconst 0x23
43#define DW_OP_shl 0x24
44#define DW_OP_shr 0x25
45#define DW_OP_shra 0x26
46#define DW_OP_xor 0x27
47#define DW_OP_skip 0x2f
48#define DW_OP_bra 0x28
49#define DW_OP_eq 0x29
50#define DW_OP_ge 0x2a
51#define DW_OP_gt 0x2b
52#define DW_OP_le 0x2c
53#define DW_OP_lt 0x2d
54#define DW_OP_ne 0x2e
55#define DW_OP_lit0 0x30
56#define DW_OP_lit1 0x31
57#define DW_OP_lit2 0x32
58#define DW_OP_lit3 0x33
59#define DW_OP_lit4 0x34
60#define DW_OP_lit5 0x35
61#define DW_OP_lit6 0x36
62#define DW_OP_lit7 0x37
63#define DW_OP_lit8 0x38
64#define DW_OP_lit9 0x39
65#define DW_OP_lit10 0x3a
66#define DW_OP_lit11 0x3b
67#define DW_OP_lit12 0x3c
68#define DW_OP_lit13 0x3d
69#define DW_OP_lit14 0x3e
70#define DW_OP_lit15 0x3f
71#define DW_OP_lit16 0x40
72#define DW_OP_lit17 0x41
73#define DW_OP_lit18 0x42
74#define DW_OP_lit19 0x43
75#define DW_OP_lit20 0x44
76#define DW_OP_lit21 0x45
77#define DW_OP_lit22 0x46
78#define DW_OP_lit23 0x47
79#define DW_OP_lit24 0x48
80#define DW_OP_lit25 0x49
81#define DW_OP_lit26 0x4a
82#define DW_OP_lit27 0x4b
83#define DW_OP_lit28 0x4c
84#define DW_OP_lit29 0x4d
85#define DW_OP_lit30 0x4e
86#define DW_OP_lit31 0x4f
87#define DW_OP_reg0 0x50
88#define DW_OP_reg1 0x51
89#define DW_OP_reg2 0x52
90#define DW_OP_reg3 0x53
91#define DW_OP_reg4 0x54
92#define DW_OP_reg5 0x55
93#define DW_OP_reg6 0x56
94#define DW_OP_reg7 0x57
95#define DW_OP_reg8 0x58
96#define DW_OP_reg9 0x59
97#define DW_OP_reg10 0x5a
98#define DW_OP_reg11 0x5b
99#define DW_OP_reg12 0x5c
100#define DW_OP_reg13 0x5d
101#define DW_OP_reg14 0x5e
102#define DW_OP_reg15 0x5f
103#define DW_OP_reg16 0x60
104#define DW_OP_reg17 0x61
105#define DW_OP_reg18 0x62
106#define DW_OP_reg19 0x63
107#define DW_OP_reg20 0x64
108#define DW_OP_reg21 0x65
109#define DW_OP_reg22 0x66
110#define DW_OP_reg23 0x67
111#define DW_OP_reg24 0x68
112#define DW_OP_reg25 0x69
113#define DW_OP_reg26 0x6a
114#define DW_OP_reg27 0x6b
115#define DW_OP_reg28 0x6c
116#define DW_OP_reg29 0x6d
117#define DW_OP_reg30 0x6e
118#define DW_OP_reg31 0x6f
119#define DW_OP_breg0 0x70
120#define DW_OP_breg1 0x71
121#define DW_OP_breg2 0x72
122#define DW_OP_breg3 0x73
123#define DW_OP_breg4 0x74
124#define DW_OP_breg5 0x75
125#define DW_OP_breg6 0x76
126#define DW_OP_breg7 0x77
127#define DW_OP_breg8 0x78
128#define DW_OP_breg9 0x79
129#define DW_OP_breg10 0x7a
130#define DW_OP_breg11 0x7b
131#define DW_OP_breg12 0x7c
132#define DW_OP_breg13 0x7d
133#define DW_OP_breg14 0x7e
134#define DW_OP_breg15 0x7f
135#define DW_OP_breg16 0x80
136#define DW_OP_breg17 0x81
137#define DW_OP_breg18 0x82
138#define DW_OP_breg19 0x83
139#define DW_OP_breg20 0x84
140#define DW_OP_breg21 0x85
141#define DW_OP_breg22 0x86
142#define DW_OP_breg23 0x87
143#define DW_OP_breg24 0x88
144#define DW_OP_breg25 0x89
145#define DW_OP_breg26 0x8a
146#define DW_OP_breg27 0x8b
147#define DW_OP_breg28 0x8c
148#define DW_OP_breg29 0x8d
149#define DW_OP_breg30 0x8e
150#define DW_OP_breg31 0x8f
151#define DW_OP_regx 0x90
152#define DW_OP_fbreg 0x91
153#define DW_OP_bregx 0x92
154#define DW_OP_piece 0x93
155#define DW_OP_deref_size 0x94
156#define DW_OP_xderef_size 0x95
157#define DW_OP_nop 0x96
158#define DW_OP_push_object_address 0x97
159#define DW_OP_call2 0x98
160#define DW_OP_call4 0x99
161#define DW_OP_call_ref 0x9a
162#define DW_OP_form_tls_address 0x9b
163#define DW_OP_call_frame_cfa 0x9c
164#define DW_OP_bit_piece 0x9d
165#define DW_OP_lo_user 0xe0
166#define DW_OP_hi_user 0xff
167
168/*
169 * Addresses used in FDE entries in the .eh_frame section may be encoded
170 * using one of the following encodings.
171 */
172#define DW_EH_PE_absptr 0x00
173#define DW_EH_PE_omit 0xff
174#define DW_EH_PE_uleb128 0x01
175#define DW_EH_PE_udata2 0x02
176#define DW_EH_PE_udata4 0x03
177#define DW_EH_PE_udata8 0x04
178#define DW_EH_PE_sleb128 0x09
179#define DW_EH_PE_sdata2 0x0a
180#define DW_EH_PE_sdata4 0x0b
181#define DW_EH_PE_sdata8 0x0c
182#define DW_EH_PE_signed 0x09
183
184#define DW_EH_PE_pcrel 0x10
185
186/*
187 * The architecture-specific register number that contains the return
188 * address in the .debug_frame table.
189 */
190#define DWARF_ARCH_RA_REG 17
191
192#ifndef __ASSEMBLER__
193
194#include <linux/compiler.h>
195#include <linux/bug.h>
196#include <linux/list.h>
197#include <linux/module.h>
198
199/*
200 * Read either the frame pointer (r14) or the stack pointer (r15).
201 * NOTE: this MUST be inlined.
202 */
203static __always_inline unsigned long dwarf_read_arch_reg(unsigned int reg)
204{
205 unsigned long value = 0;
206
207 switch (reg) {
208 case 14:
209 __asm__ __volatile__("mov r14, %0\n" : "=r" (value));
210 break;
211 case 15:
212 __asm__ __volatile__("mov r15, %0\n" : "=r" (value));
213 break;
214 default:
215 BUG();
216 }
217
218 return value;
219}
220
221/**
222 * dwarf_cie - Common Information Entry
223 */
224struct dwarf_cie {
225 unsigned long length;
226 unsigned long cie_id;
227 unsigned char version;
228 const char *augmentation;
229 unsigned int code_alignment_factor;
230 int data_alignment_factor;
231
232 /* Which column in the rule table represents return addr of func. */
233 unsigned int return_address_reg;
234
235 unsigned char *initial_instructions;
236 unsigned char *instructions_end;
237
238 unsigned char encoding;
239
240 unsigned long cie_pointer;
241
242 unsigned long flags;
243#define DWARF_CIE_Z_AUGMENTATION (1 << 0)
244
245 /* linked-list entry if this CIE is from a module */
246 struct list_head link;
247
248 struct rb_node node;
249};
250
251/**
252 * dwarf_fde - Frame Description Entry
253 */
254struct dwarf_fde {
255 unsigned long length;
256 unsigned long cie_pointer;
257 struct dwarf_cie *cie;
258 unsigned long initial_location;
259 unsigned long address_range;
260 unsigned char *instructions;
261 unsigned char *end;
262
263 /* linked-list entry if this FDE is from a module */
264 struct list_head link;
265
266 struct rb_node node;
267};
268
269/**
270 * dwarf_frame - DWARF information for a frame in the call stack
271 */
272struct dwarf_frame {
273 struct dwarf_frame *prev, *next;
274
275 unsigned long pc;
276
277 struct list_head reg_list;
278
279 unsigned long cfa;
280
281 /* Valid when DW_FRAME_CFA_REG_OFFSET is set in flags */
282 unsigned int cfa_register;
283 unsigned int cfa_offset;
284
285 /* Valid when DW_FRAME_CFA_REG_EXP is set in flags */
286 unsigned char *cfa_expr;
287 unsigned int cfa_expr_len;
288
289 unsigned long flags;
290#define DWARF_FRAME_CFA_REG_OFFSET (1 << 0)
291#define DWARF_FRAME_CFA_REG_EXP (1 << 1)
292
293 unsigned long return_addr;
294};
295
296/**
297 * dwarf_reg - DWARF register
298 * @flags: Describes how to calculate the value of this register
299 */
300struct dwarf_reg {
301 struct list_head link;
302
303 unsigned int number;
304
305 unsigned long addr;
306 unsigned long flags;
307#define DWARF_REG_OFFSET (1 << 0)
308#define DWARF_VAL_OFFSET (1 << 1)
309#define DWARF_UNDEFINED (1 << 2)
310};
311
312/*
313 * Call Frame instruction opcodes.
314 */
315#define DW_CFA_advance_loc 0x40
316#define DW_CFA_offset 0x80
317#define DW_CFA_restore 0xc0
318#define DW_CFA_nop 0x00
319#define DW_CFA_set_loc 0x01
320#define DW_CFA_advance_loc1 0x02
321#define DW_CFA_advance_loc2 0x03
322#define DW_CFA_advance_loc4 0x04
323#define DW_CFA_offset_extended 0x05
324#define DW_CFA_restore_extended 0x06
325#define DW_CFA_undefined 0x07
326#define DW_CFA_same_value 0x08
327#define DW_CFA_register 0x09
328#define DW_CFA_remember_state 0x0a
329#define DW_CFA_restore_state 0x0b
330#define DW_CFA_def_cfa 0x0c
331#define DW_CFA_def_cfa_register 0x0d
332#define DW_CFA_def_cfa_offset 0x0e
333#define DW_CFA_def_cfa_expression 0x0f
334#define DW_CFA_expression 0x10
335#define DW_CFA_offset_extended_sf 0x11
336#define DW_CFA_def_cfa_sf 0x12
337#define DW_CFA_def_cfa_offset_sf 0x13
338#define DW_CFA_val_offset 0x14
339#define DW_CFA_val_offset_sf 0x15
340#define DW_CFA_val_expression 0x16
341#define DW_CFA_lo_user 0x1c
342#define DW_CFA_hi_user 0x3f
343
344/* GNU extension opcodes */
345#define DW_CFA_GNU_args_size 0x2e
346#define DW_CFA_GNU_negative_offset_extended 0x2f
347
348/*
349 * Some call frame instructions encode their operands in the opcode. We
350 * need some helper functions to extract both the opcode and operands
351 * from an instruction.
352 */
353static inline unsigned int DW_CFA_opcode(unsigned long insn)
354{
355 return (insn & 0xc0);
356}
357
358static inline unsigned int DW_CFA_operand(unsigned long insn)
359{
360 return (insn & 0x3f);
361}
362
363#define DW_EH_FRAME_CIE 0 /* .eh_frame CIE IDs are 0 */
364#define DW_CIE_ID 0xffffffff
365#define DW64_CIE_ID 0xffffffffffffffffULL
366
367/*
368 * DWARF FDE/CIE length field values.
369 */
370#define DW_EXT_LO 0xfffffff0
371#define DW_EXT_HI 0xffffffff
372#define DW_EXT_DWARF64 DW_EXT_HI
373
374extern struct dwarf_frame *dwarf_unwind_stack(unsigned long,
375 struct dwarf_frame *);
376extern void dwarf_free_frame(struct dwarf_frame *);
377
378extern int module_dwarf_finalize(const Elf_Ehdr *, const Elf_Shdr *,
379 struct module *);
380extern void module_dwarf_cleanup(struct module *);
381
382#endif /* !__ASSEMBLER__ */
383
384#define CFI_STARTPROC .cfi_startproc
385#define CFI_ENDPROC .cfi_endproc
386#define CFI_DEF_CFA .cfi_def_cfa
387#define CFI_REGISTER .cfi_register
388#define CFI_REL_OFFSET .cfi_rel_offset
389#define CFI_UNDEFINED .cfi_undefined
390
391#else
392
393/*
394 * Use the asm comment character to ignore the rest of the line.
395 */
396#define CFI_IGNORE !
397
398#define CFI_STARTPROC CFI_IGNORE
399#define CFI_ENDPROC CFI_IGNORE
400#define CFI_DEF_CFA CFI_IGNORE
401#define CFI_REGISTER CFI_IGNORE
402#define CFI_REL_OFFSET CFI_IGNORE
403#define CFI_UNDEFINED CFI_IGNORE
404
405#ifndef __ASSEMBLER__
406static inline void dwarf_unwinder_init(void)
407{
408}
409
410#define module_dwarf_finalize(hdr, sechdrs, me) (0)
411#define module_dwarf_cleanup(mod) do { } while (0)
412
413#endif
414
415#endif /* CONFIG_DWARF_UNWINDER */
416
417#endif /* __ASM_SH_DWARF_H */