1 #ifndef _ASM_X86_UNWIND_HINTS_H
2 #define _ASM_X86_UNWIND_HINTS_H
9 * In asm, there are two kinds of code: normal C-type callable functions and
10 * the rest. The normal callable functions can be called by other code, and
11 * don't do anything unusual with the stack. Such normal callable functions
12 * are annotated with the ENTRY/ENDPROC macros. Most asm code falls in this
13 * category. In this case, no special debugging annotations are needed because
14 * objtool can automatically generate the ORC data for the ORC unwinder to read
17 * Anything which doesn't fall into the above category, such as syscall and
18 * interrupt handlers, tends to not be called directly by other functions, and
19 * often does unusual non-C-function-type things with the stack pointer. Such
20 * code needs to be annotated such that objtool can understand it. The
21 * following CFI hint macros are for this type of code.
23 * These macros provide hints to objtool about the state of the stack at each
24 * instruction. Objtool starts from the hints and follows the code flow,
25 * making automatic CFI adjustments when it sees pushes and pops, filling out
26 * the debuginfo as necessary. It will also warn if it sees any
29 .macro UNWIND_HINT sp_reg
=ORC_REG_SP sp_offset
=0 type
=ORC_TYPE_CALL end
=0
30 #ifdef CONFIG_STACK_VALIDATION
32 .pushsection
.discard
.unwind_hints
33 /* struct unwind_hint */
34 .long .Lunwind_hint_ip_\@
- .
44 .macro UNWIND_HINT_EMPTY
45 UNWIND_HINT sp_reg
=ORC_REG_UNDEFINED end
=1
48 .macro UNWIND_HINT_REGS base
=%rsp offset
=0 indirect
=0 extra
=1 iret
=0
51 .set sp_reg
, ORC_REG_SP_INDIRECT
53 .set sp_reg
, ORC_REG_SP
56 .set sp_reg
, ORC_REG_BP
58 .set sp_reg
, ORC_REG_DI
60 .set sp_reg
, ORC_REG_DX
62 .set sp_reg
, ORC_REG_R10
64 .error
"UNWIND_HINT_REGS: bad base register"
67 .set sp_offset
, \offset
70 .set type
, ORC_TYPE_REGS_IRET
72 .set type
, ORC_TYPE_REGS_IRET
73 .set sp_offset
, \offset
+ (16*8)
75 .set type
, ORC_TYPE_REGS
78 UNWIND_HINT sp_reg
=sp_reg sp_offset
=sp_offset type
=type
81 .macro UNWIND_HINT_IRET_REGS base
=%rsp offset
=0
82 UNWIND_HINT_REGS base
=\base offset
=\offset iret
=1
85 .macro UNWIND_HINT_FUNC sp_offset
=8
86 UNWIND_HINT sp_offset
=\sp_offset
89 .macro UNWIND_HINT_SAVE
90 UNWIND_HINT type
=UNWIND_HINT_TYPE_SAVE
93 .macro UNWIND_HINT_RESTORE
94 UNWIND_HINT type
=UNWIND_HINT_TYPE_RESTORE
97 #else /* !__ASSEMBLY__ */
99 #define UNWIND_HINT(sp_reg, sp_offset, type, end) \
101 ".pushsection .discard.unwind_hints\n\t" \
102 /* struct unwind_hint */ \
103 ".long 987b - .\n\t" \
104 ".short " __stringify(sp_offset) "\n\t" \
105 ".byte " __stringify(sp_reg) "\n\t" \
106 ".byte " __stringify(type) "\n\t" \
107 ".byte " __stringify(end) "\n\t" \
111 #define UNWIND_HINT_SAVE UNWIND_HINT(0, 0, UNWIND_HINT_TYPE_SAVE, 0)
113 #define UNWIND_HINT_RESTORE UNWIND_HINT(0, 0, UNWIND_HINT_TYPE_RESTORE, 0)
115 #endif /* __ASSEMBLY__ */
117 #endif /* _ASM_X86_UNWIND_HINTS_H */