1 /* SPDX-License-Identifier: GPL-2.0 */
3 * syscall_wrapper.h - x86 specific wrappers to syscall definitions
6 #ifndef _ASM_X86_SYSCALL_WRAPPER_H
7 #define _ASM_X86_SYSCALL_WRAPPER_H
9 #include <asm/ptrace.h>
11 extern long __x64_sys_ni_syscall(const struct pt_regs *regs);
12 extern long __ia32_sys_ni_syscall(const struct pt_regs *regs);
15 * Instead of the generic __SYSCALL_DEFINEx() definition, the x86 version takes
16 * struct pt_regs *regs as the only argument of the syscall stub(s) named as:
17 * __x64_sys_*() - 64-bit native syscall
18 * __ia32_sys_*() - 32-bit native syscall or common compat syscall
19 * __ia32_compat_sys_*() - 32-bit compat syscall
20 * __x64_compat_sys_*() - 64-bit X32 compat syscall
22 * The registers are decoded according to the ABI:
23 * 64-bit: RDI, RSI, RDX, R10, R8, R9
24 * 32-bit: EBX, ECX, EDX, ESI, EDI, EBP
26 * The stub then passes the decoded arguments to the __se_sys_*() wrapper to
27 * perform sign-extension (omitted for zero-argument syscalls). Finally the
28 * arguments are passed to the __do_sys_*() function which is the actual
29 * syscall. These wrappers are marked as inline so the compiler can optimize
30 * the functions where appropriate.
32 * Example assembly (slightly re-ordered for better readability):
34 * <__x64_sys_recv>: <-- syscall with 4 parameters
37 * mov 0x70(%rdi),%rdi <-- decode regs->di
38 * mov 0x68(%rdi),%rsi <-- decode regs->si
39 * mov 0x60(%rdi),%rdx <-- decode regs->dx
40 * mov 0x38(%rdi),%rcx <-- decode regs->r10
42 * xor %r9d,%r9d <-- clear %r9
43 * xor %r8d,%r8d <-- clear %r8
45 * callq __sys_recvfrom <-- do the actual work in __sys_recvfrom()
46 * which takes 6 arguments
48 * cltq <-- extend return value to 64-bit
51 * This approach avoids leaking random user-provided register content down
55 /* Mapping of registers to parameters for syscalls on x86-64 and x32 */
56 #define SC_X86_64_REGS_TO_ARGS(x, ...) \
58 ,,regs->di,,regs->si,,regs->dx \
59 ,,regs->r10,,regs->r8,,regs->r9) \
62 /* SYSCALL_PT_ARGS is Adapted from s390x */
63 #define SYSCALL_PT_ARG6(m, t1, t2, t3, t4, t5, t6) \
64 SYSCALL_PT_ARG5(m, t1, t2, t3, t4, t5), m(t6, (regs->bp))
65 #define SYSCALL_PT_ARG5(m, t1, t2, t3, t4, t5) \
66 SYSCALL_PT_ARG4(m, t1, t2, t3, t4), m(t5, (regs->di))
67 #define SYSCALL_PT_ARG4(m, t1, t2, t3, t4) \
68 SYSCALL_PT_ARG3(m, t1, t2, t3), m(t4, (regs->si))
69 #define SYSCALL_PT_ARG3(m, t1, t2, t3) \
70 SYSCALL_PT_ARG2(m, t1, t2), m(t3, (regs->dx))
71 #define SYSCALL_PT_ARG2(m, t1, t2) \
72 SYSCALL_PT_ARG1(m, t1), m(t2, (regs->cx))
73 #define SYSCALL_PT_ARG1(m, t1) m(t1, (regs->bx))
74 #define SYSCALL_PT_ARGS(x, ...) SYSCALL_PT_ARG##x(__VA_ARGS__)
76 #define __SC_COMPAT_CAST(t, a) \
77 (__typeof(__builtin_choose_expr(__TYPE_IS_L(t), 0, 0U))) \
80 /* Mapping of registers to parameters for syscalls on i386 */
81 #define SC_IA32_REGS_TO_ARGS(x, ...) \
82 SYSCALL_PT_ARGS(x, __SC_COMPAT_CAST, \
83 __MAP(x, __SC_TYPE, __VA_ARGS__)) \
85 #define __SYS_STUB0(abi, name) \
86 long __##abi##_##name(const struct pt_regs *regs); \
87 ALLOW_ERROR_INJECTION(__##abi##_##name, ERRNO); \
88 long __##abi##_##name(const struct pt_regs *regs) \
91 #define __SYS_STUBx(abi, name, ...) \
92 long __##abi##_##name(const struct pt_regs *regs); \
93 ALLOW_ERROR_INJECTION(__##abi##_##name, ERRNO); \
94 long __##abi##_##name(const struct pt_regs *regs) \
96 return __se_##name(__VA_ARGS__); \
99 #define __COND_SYSCALL(abi, name) \
100 __weak long __##abi##_##name(const struct pt_regs *__unused); \
101 __weak long __##abi##_##name(const struct pt_regs *__unused) \
103 return sys_ni_syscall(); \
106 #define __SYS_NI(abi, name) \
107 SYSCALL_ALIAS(__##abi##_##name, sys_ni_posix_timers);
110 #define __X64_SYS_STUB0(name) \
111 __SYS_STUB0(x64, sys_##name)
113 #define __X64_SYS_STUBx(x, name, ...) \
114 __SYS_STUBx(x64, sys##name, \
115 SC_X86_64_REGS_TO_ARGS(x, __VA_ARGS__))
117 #define __X64_COND_SYSCALL(name) \
118 __COND_SYSCALL(x64, sys_##name)
120 #define __X64_SYS_NI(name) \
121 __SYS_NI(x64, sys_##name)
122 #else /* CONFIG_X86_64 */
123 #define __X64_SYS_STUB0(name)
124 #define __X64_SYS_STUBx(x, name, ...)
125 #define __X64_COND_SYSCALL(name)
126 #define __X64_SYS_NI(name)
127 #endif /* CONFIG_X86_64 */
129 #if defined(CONFIG_X86_32) || defined(CONFIG_IA32_EMULATION)
130 #define __IA32_SYS_STUB0(name) \
131 __SYS_STUB0(ia32, sys_##name)
133 #define __IA32_SYS_STUBx(x, name, ...) \
134 __SYS_STUBx(ia32, sys##name, \
135 SC_IA32_REGS_TO_ARGS(x, __VA_ARGS__))
137 #define __IA32_COND_SYSCALL(name) \
138 __COND_SYSCALL(ia32, sys_##name)
140 #define __IA32_SYS_NI(name) \
141 __SYS_NI(ia32, sys_##name)
142 #else /* CONFIG_X86_32 || CONFIG_IA32_EMULATION */
143 #define __IA32_SYS_STUB0(name)
144 #define __IA32_SYS_STUBx(x, name, ...)
145 #define __IA32_COND_SYSCALL(name)
146 #define __IA32_SYS_NI(name)
147 #endif /* CONFIG_X86_32 || CONFIG_IA32_EMULATION */
149 #ifdef CONFIG_IA32_EMULATION
151 * For IA32 emulation, we need to handle "compat" syscalls *and* create
152 * additional wrappers (aptly named __ia32_sys_xyzzy) which decode the
153 * ia32 regs in the proper order for shared or "common" syscalls. As some
154 * syscalls may not be implemented, we need to expand COND_SYSCALL in
155 * kernel/sys_ni.c and SYS_NI in kernel/time/posix-stubs.c to cover this
158 #define __IA32_COMPAT_SYS_STUB0(name) \
159 __SYS_STUB0(ia32, compat_sys_##name)
161 #define __IA32_COMPAT_SYS_STUBx(x, name, ...) \
162 __SYS_STUBx(ia32, compat_sys##name, \
163 SC_IA32_REGS_TO_ARGS(x, __VA_ARGS__))
165 #define __IA32_COMPAT_COND_SYSCALL(name) \
166 __COND_SYSCALL(ia32, compat_sys_##name)
168 #define __IA32_COMPAT_SYS_NI(name) \
169 __SYS_NI(ia32, compat_sys_##name)
171 #else /* CONFIG_IA32_EMULATION */
172 #define __IA32_COMPAT_SYS_STUB0(name)
173 #define __IA32_COMPAT_SYS_STUBx(x, name, ...)
174 #define __IA32_COMPAT_COND_SYSCALL(name)
175 #define __IA32_COMPAT_SYS_NI(name)
176 #endif /* CONFIG_IA32_EMULATION */
179 #ifdef CONFIG_X86_X32_ABI
181 * For the x32 ABI, we need to create a stub for compat_sys_*() which is aware
182 * of the x86-64-style parameter ordering of x32 syscalls. The syscalls common
183 * with x86_64 obviously do not need such care.
185 #define __X32_COMPAT_SYS_STUB0(name) \
186 __SYS_STUB0(x64, compat_sys_##name)
188 #define __X32_COMPAT_SYS_STUBx(x, name, ...) \
189 __SYS_STUBx(x64, compat_sys##name, \
190 SC_X86_64_REGS_TO_ARGS(x, __VA_ARGS__))
192 #define __X32_COMPAT_COND_SYSCALL(name) \
193 __COND_SYSCALL(x64, compat_sys_##name)
195 #define __X32_COMPAT_SYS_NI(name) \
196 __SYS_NI(x64, compat_sys_##name)
197 #else /* CONFIG_X86_X32_ABI */
198 #define __X32_COMPAT_SYS_STUB0(name)
199 #define __X32_COMPAT_SYS_STUBx(x, name, ...)
200 #define __X32_COMPAT_COND_SYSCALL(name)
201 #define __X32_COMPAT_SYS_NI(name)
202 #endif /* CONFIG_X86_X32_ABI */
207 * Compat means IA32_EMULATION and/or X86_X32. As they use a different
208 * mapping of registers to parameters, we need to generate stubs for each
211 #define COMPAT_SYSCALL_DEFINE0(name) \
213 __do_compat_sys_##name(const struct pt_regs *__unused); \
214 __IA32_COMPAT_SYS_STUB0(name) \
215 __X32_COMPAT_SYS_STUB0(name) \
217 __do_compat_sys_##name(const struct pt_regs *__unused)
219 #define COMPAT_SYSCALL_DEFINEx(x, name, ...) \
220 static long __se_compat_sys##name(__MAP(x,__SC_LONG,__VA_ARGS__)); \
221 static inline long __do_compat_sys##name(__MAP(x,__SC_DECL,__VA_ARGS__));\
222 __IA32_COMPAT_SYS_STUBx(x, name, __VA_ARGS__) \
223 __X32_COMPAT_SYS_STUBx(x, name, __VA_ARGS__) \
224 static long __se_compat_sys##name(__MAP(x,__SC_LONG,__VA_ARGS__)) \
226 return __do_compat_sys##name(__MAP(x,__SC_DELOUSE,__VA_ARGS__));\
228 static inline long __do_compat_sys##name(__MAP(x,__SC_DECL,__VA_ARGS__))
231 * As some compat syscalls may not be implemented, we need to expand
232 * COND_SYSCALL_COMPAT in kernel/sys_ni.c and COMPAT_SYS_NI in
233 * kernel/time/posix-stubs.c to cover this case as well.
235 #define COND_SYSCALL_COMPAT(name) \
236 __IA32_COMPAT_COND_SYSCALL(name) \
237 __X32_COMPAT_COND_SYSCALL(name)
239 #define COMPAT_SYS_NI(name) \
240 __IA32_COMPAT_SYS_NI(name) \
241 __X32_COMPAT_SYS_NI(name)
243 #endif /* CONFIG_COMPAT */
245 #define __SYSCALL_DEFINEx(x, name, ...) \
246 static long __se_sys##name(__MAP(x,__SC_LONG,__VA_ARGS__)); \
247 static inline long __do_sys##name(__MAP(x,__SC_DECL,__VA_ARGS__));\
248 __X64_SYS_STUBx(x, name, __VA_ARGS__) \
249 __IA32_SYS_STUBx(x, name, __VA_ARGS__) \
250 static long __se_sys##name(__MAP(x,__SC_LONG,__VA_ARGS__)) \
252 long ret = __do_sys##name(__MAP(x,__SC_CAST,__VA_ARGS__));\
253 __MAP(x,__SC_TEST,__VA_ARGS__); \
254 __PROTECT(x, ret,__MAP(x,__SC_ARGS,__VA_ARGS__)); \
257 static inline long __do_sys##name(__MAP(x,__SC_DECL,__VA_ARGS__))
260 * As the generic SYSCALL_DEFINE0() macro does not decode any parameters for
261 * obvious reasons, and passing struct pt_regs *regs to it in %rdi does not
262 * hurt, we only need to re-define it here to keep the naming congruent to
263 * SYSCALL_DEFINEx() -- which is essential for the COND_SYSCALL() and SYS_NI()
264 * macros to work correctly.
266 #define SYSCALL_DEFINE0(sname) \
267 SYSCALL_METADATA(_##sname, 0); \
268 static long __do_sys_##sname(const struct pt_regs *__unused); \
269 __X64_SYS_STUB0(sname) \
270 __IA32_SYS_STUB0(sname) \
271 static long __do_sys_##sname(const struct pt_regs *__unused)
273 #define COND_SYSCALL(name) \
274 __X64_COND_SYSCALL(name) \
275 __IA32_COND_SYSCALL(name)
277 #define SYS_NI(name) \
283 * For VSYSCALLS, we need to declare these three syscalls with the new
284 * pt_regs-based calling convention for in-kernel use.
286 long __x64_sys_getcpu(const struct pt_regs *regs);
287 long __x64_sys_gettimeofday(const struct pt_regs *regs);
288 long __x64_sys_time(const struct pt_regs *regs);
290 #endif /* _ASM_X86_SYSCALL_WRAPPER_H */