1 #ifndef _ASM_X86_UACCESS_H
2 #define _ASM_X86_UACCESS_H
4 * User space memory access functions
6 #include <linux/errno.h>
7 #include <linux/compiler.h>
8 #include <linux/thread_info.h>
9 #include <linux/string.h>
14 #define VERIFY_WRITE 1
17 * The fs value determines whether argument validity checking should be
18 * performed or not. If get_fs() == USER_DS, checking is performed, with
19 * get_fs() == KERNEL_DS, checking is bypassed.
21 * For historical reasons, these macros are grossly misnamed.
24 #define MAKE_MM_SEG(s) ((mm_segment_t) { (s) })
26 #define KERNEL_DS MAKE_MM_SEG(-1UL)
27 #define USER_DS MAKE_MM_SEG(TASK_SIZE_MAX)
29 #define get_ds() (KERNEL_DS)
30 #define get_fs() (current_thread_info()->addr_limit)
31 #define set_fs(x) (current_thread_info()->addr_limit = (x))
33 #define segment_eq(a, b) ((a).seg == (b).seg)
35 #define __addr_ok(addr) \
36 ((unsigned long __force)(addr) < \
37 (current_thread_info()->addr_limit.seg))
40 * Test whether a block of memory is a valid user space address.
41 * Returns 0 if the range is valid, nonzero otherwise.
43 * This is equivalent to the following test:
44 * (u33)addr + (u33)size > (u33)current->addr_limit.seg (u65 for x86_64)
46 * This needs 33-bit (65-bit for x86_64) arithmetic. We have a carry...
49 #define __range_not_ok(addr, size) \
51 unsigned long flag, roksum; \
52 __chk_user_ptr(addr); \
53 asm("add %3,%1 ; sbb %0,%0 ; cmp %1,%4 ; sbb $0,%0" \
54 : "=&r" (flag), "=r" (roksum) \
55 : "1" (addr), "g" ((long)(size)), \
56 "rm" (current_thread_info()->addr_limit.seg)); \
61 * access_ok: - Checks if a user space pointer is valid
62 * @type: Type of access: %VERIFY_READ or %VERIFY_WRITE. Note that
63 * %VERIFY_WRITE is a superset of %VERIFY_READ - if it is safe
64 * to write to a block, it is always safe to read from it.
65 * @addr: User space pointer to start of block to check
66 * @size: Size of block to check
68 * Context: User context only. This function may sleep.
70 * Checks if a pointer to a block of memory in user space is valid.
72 * Returns true (nonzero) if the memory block may be valid, false (zero)
73 * if it is definitely invalid.
75 * Note that, depending on architecture, this function probably just
76 * checks that the pointer is in the user space range - after calling
77 * this function, memory access functions may still return -EFAULT.
79 #define access_ok(type, addr, size) (likely(__range_not_ok(addr, size) == 0))
82 * The exception table consists of pairs of addresses: the first is the
83 * address of an instruction that is allowed to fault, and the second is
84 * the address at which the program should continue. No registers are
85 * modified, so it is entirely up to the continuation code to figure out
88 * All the routines below use bits of fixup code that are out of line
89 * with the main instruction path. This means when everything is well,
90 * we don't even have to jump over them. Further, they do not intrude
91 * on our cache or tlb entries.
94 struct exception_table_entry
{
95 unsigned long insn
, fixup
;
98 extern int fixup_exception(struct pt_regs
*regs
);
101 * These are the main single-value transfer routines. They automatically
102 * use the right size if we just have the right pointer type.
104 * This gets kind of ugly. We want to return _two_ values in "get_user()"
105 * and yet we don't want to do any pointers, because that is too much
106 * of a performance impact. Thus we have a few rather ugly macros here,
107 * and hide all the ugliness from the user.
109 * The "__xxx" versions of the user access functions are versions that
110 * do not verify the address space, that must have been done previously
111 * with a separate "access_ok()" call (this is used when we do multiple
112 * accesses to the same area of user memory).
115 extern int __get_user_1(void);
116 extern int __get_user_2(void);
117 extern int __get_user_4(void);
118 extern int __get_user_8(void);
119 extern int __get_user_bad(void);
121 #define __get_user_x(size, ret, x, ptr) \
122 asm volatile("call __get_user_" #size \
123 : "=a" (ret), "=d" (x) \
126 /* Careful: we have to cast the result to the type of the pointer
127 * for sign reasons */
130 * get_user: - Get a simple variable from user space.
131 * @x: Variable to store result.
132 * @ptr: Source address, in user space.
134 * Context: User context only. This function may sleep.
136 * This macro copies a single simple variable from user space to kernel
137 * space. It supports simple types like char and int, but not larger
138 * data types like structures or arrays.
140 * @ptr must have pointer-to-simple-variable type, and the result of
141 * dereferencing @ptr must be assignable to @x without a cast.
143 * Returns zero on success, or -EFAULT on error.
144 * On error, the variable @x is set to zero.
147 #define __get_user_8(__ret_gu, __val_gu, ptr) \
148 __get_user_x(X, __ret_gu, __val_gu, ptr)
150 #define __get_user_8(__ret_gu, __val_gu, ptr) \
151 __get_user_x(8, __ret_gu, __val_gu, ptr)
154 #define get_user(x, ptr) \
157 unsigned long __val_gu; \
158 __chk_user_ptr(ptr); \
160 switch (sizeof(*(ptr))) { \
162 __get_user_x(1, __ret_gu, __val_gu, ptr); \
165 __get_user_x(2, __ret_gu, __val_gu, ptr); \
168 __get_user_x(4, __ret_gu, __val_gu, ptr); \
171 __get_user_8(__ret_gu, __val_gu, ptr); \
174 __get_user_x(X, __ret_gu, __val_gu, ptr); \
177 (x) = (__typeof__(*(ptr)))__val_gu; \
181 #define __put_user_x(size, x, ptr, __ret_pu) \
182 asm volatile("call __put_user_" #size : "=a" (__ret_pu) \
183 : "0" ((typeof(*(ptr)))(x)), "c" (ptr) : "ebx")
188 #define __put_user_asm_u64(x, addr, err, errret) \
189 asm volatile("1: movl %%eax,0(%2)\n" \
190 "2: movl %%edx,4(%2)\n" \
192 ".section .fixup,\"ax\"\n" \
196 _ASM_EXTABLE(1b, 4b) \
197 _ASM_EXTABLE(2b, 4b) \
199 : "A" (x), "r" (addr), "i" (errret), "0" (err))
201 #define __put_user_asm_ex_u64(x, addr) \
202 asm volatile("1: movl %%eax,0(%1)\n" \
203 "2: movl %%edx,4(%1)\n" \
205 _ASM_EXTABLE(1b, 2b - 1b) \
206 _ASM_EXTABLE(2b, 3b - 2b) \
207 : : "A" (x), "r" (addr))
209 #define __put_user_x8(x, ptr, __ret_pu) \
210 asm volatile("call __put_user_8" : "=a" (__ret_pu) \
211 : "A" ((typeof(*(ptr)))(x)), "c" (ptr) : "ebx")
213 #define __put_user_asm_u64(x, ptr, retval, errret) \
214 __put_user_asm(x, ptr, retval, "q", "", "er", errret)
215 #define __put_user_asm_ex_u64(x, addr) \
216 __put_user_asm_ex(x, addr, "q", "", "er")
217 #define __put_user_x8(x, ptr, __ret_pu) __put_user_x(8, x, ptr, __ret_pu)
220 extern void __put_user_bad(void);
223 * Strange magic calling convention: pointer in %ecx,
224 * value in %eax(:%edx), return value in %eax. clobbers %rbx
226 extern void __put_user_1(void);
227 extern void __put_user_2(void);
228 extern void __put_user_4(void);
229 extern void __put_user_8(void);
231 #ifdef CONFIG_X86_WP_WORKS_OK
234 * put_user: - Write a simple value into user space.
235 * @x: Value to copy to user space.
236 * @ptr: Destination address, in user space.
238 * Context: User context only. This function may sleep.
240 * This macro copies a single simple value from kernel space to user
241 * space. It supports simple types like char and int, but not larger
242 * data types like structures or arrays.
244 * @ptr must have pointer-to-simple-variable type, and @x must be assignable
245 * to the result of dereferencing @ptr.
247 * Returns zero on success, or -EFAULT on error.
249 #define put_user(x, ptr) \
252 __typeof__(*(ptr)) __pu_val; \
253 __chk_user_ptr(ptr); \
256 switch (sizeof(*(ptr))) { \
258 __put_user_x(1, __pu_val, ptr, __ret_pu); \
261 __put_user_x(2, __pu_val, ptr, __ret_pu); \
264 __put_user_x(4, __pu_val, ptr, __ret_pu); \
267 __put_user_x8(__pu_val, ptr, __ret_pu); \
270 __put_user_x(X, __pu_val, ptr, __ret_pu); \
276 #define __put_user_size(x, ptr, size, retval, errret) \
279 __chk_user_ptr(ptr); \
282 __put_user_asm(x, ptr, retval, "b", "b", "iq", errret); \
285 __put_user_asm(x, ptr, retval, "w", "w", "ir", errret); \
288 __put_user_asm(x, ptr, retval, "l", "k", "ir", errret); \
291 __put_user_asm_u64((__typeof__(*ptr))(x), ptr, retval, \
299 #define __put_user_size_ex(x, ptr, size) \
301 __chk_user_ptr(ptr); \
304 __put_user_asm_ex(x, ptr, "b", "b", "iq"); \
307 __put_user_asm_ex(x, ptr, "w", "w", "ir"); \
310 __put_user_asm_ex(x, ptr, "l", "k", "ir"); \
313 __put_user_asm_ex_u64((__typeof__(*ptr))(x), ptr); \
322 #define __put_user_size(x, ptr, size, retval, errret) \
324 __typeof__(*(ptr))__pus_tmp = x; \
327 if (unlikely(__copy_to_user_ll(ptr, &__pus_tmp, size) != 0)) \
331 #define put_user(x, ptr) \
334 __typeof__(*(ptr))__pus_tmp = x; \
336 if (unlikely(__copy_to_user_ll(ptr, &__pus_tmp, \
337 sizeof(*(ptr))) != 0)) \
338 __ret_pu = -EFAULT; \
344 #define __get_user_asm_u64(x, ptr, retval, errret) (x) = __get_user_bad()
345 #define __get_user_asm_ex_u64(x, ptr) (x) = __get_user_bad()
347 #define __get_user_asm_u64(x, ptr, retval, errret) \
348 __get_user_asm(x, ptr, retval, "q", "", "=r", errret)
349 #define __get_user_asm_ex_u64(x, ptr) \
350 __get_user_asm_ex(x, ptr, "q", "", "=r")
353 #define __get_user_size(x, ptr, size, retval, errret) \
356 __chk_user_ptr(ptr); \
359 __get_user_asm(x, ptr, retval, "b", "b", "=q", errret); \
362 __get_user_asm(x, ptr, retval, "w", "w", "=r", errret); \
365 __get_user_asm(x, ptr, retval, "l", "k", "=r", errret); \
368 __get_user_asm_u64(x, ptr, retval, errret); \
371 (x) = __get_user_bad(); \
375 #define __get_user_asm(x, addr, err, itype, rtype, ltype, errret) \
376 asm volatile("1: mov"itype" %2,%"rtype"1\n" \
378 ".section .fixup,\"ax\"\n" \
380 " xor"itype" %"rtype"1,%"rtype"1\n" \
383 _ASM_EXTABLE(1b, 3b) \
384 : "=r" (err), ltype(x) \
385 : "m" (__m(addr)), "i" (errret), "0" (err))
387 #define __get_user_size_ex(x, ptr, size) \
389 __chk_user_ptr(ptr); \
392 __get_user_asm_ex(x, ptr, "b", "b", "=q"); \
395 __get_user_asm_ex(x, ptr, "w", "w", "=r"); \
398 __get_user_asm_ex(x, ptr, "l", "k", "=r"); \
401 __get_user_asm_ex_u64(x, ptr); \
404 (x) = __get_user_bad(); \
408 #define __get_user_asm_ex(x, addr, itype, rtype, ltype) \
409 asm volatile("1: mov"itype" %1,%"rtype"0\n" \
411 _ASM_EXTABLE(1b, 2b - 1b) \
412 : ltype(x) : "m" (__m(addr)))
414 #define __put_user_nocheck(x, ptr, size) \
417 __put_user_size((x), (ptr), (size), __pu_err, -EFAULT); \
421 #define __get_user_nocheck(x, ptr, size) \
424 unsigned long __gu_val; \
425 __get_user_size(__gu_val, (ptr), (size), __gu_err, -EFAULT); \
426 (x) = (__force __typeof__(*(ptr)))__gu_val; \
430 /* FIXME: this hack is definitely wrong -AK */
431 struct __large_struct
{ unsigned long buf
[100]; };
432 #define __m(x) (*(struct __large_struct __user *)(x))
435 * Tell gcc we read from memory instead of writing: this is because
436 * we do not write to any memory gcc knows about, so there are no
439 #define __put_user_asm(x, addr, err, itype, rtype, ltype, errret) \
440 asm volatile("1: mov"itype" %"rtype"1,%2\n" \
442 ".section .fixup,\"ax\"\n" \
446 _ASM_EXTABLE(1b, 3b) \
448 : ltype(x), "m" (__m(addr)), "i" (errret), "0" (err))
450 #define __put_user_asm_ex(x, addr, itype, rtype, ltype) \
451 asm volatile("1: mov"itype" %"rtype"0,%1\n" \
453 _ASM_EXTABLE(1b, 2b - 1b) \
454 : : ltype(x), "m" (__m(addr)))
457 * uaccess_try and catch
459 #define uaccess_try do { \
460 int prev_err = current_thread_info()->uaccess_err; \
461 current_thread_info()->uaccess_err = 0; \
464 #define uaccess_catch(err) \
465 (err) |= (current_thread_info()->uaccess_err ? -EFAULT : 0); \
466 current_thread_info()->uaccess_err = prev_err; \
470 * __get_user: - Get a simple variable from user space, with less checking.
471 * @x: Variable to store result.
472 * @ptr: Source address, in user space.
474 * Context: User context only. This function may sleep.
476 * This macro copies a single simple variable from user space to kernel
477 * space. It supports simple types like char and int, but not larger
478 * data types like structures or arrays.
480 * @ptr must have pointer-to-simple-variable type, and the result of
481 * dereferencing @ptr must be assignable to @x without a cast.
483 * Caller must check the pointer with access_ok() before calling this
486 * Returns zero on success, or -EFAULT on error.
487 * On error, the variable @x is set to zero.
490 #define __get_user(x, ptr) \
491 __get_user_nocheck((x), (ptr), sizeof(*(ptr)))
494 * __put_user: - Write a simple value into user space, with less checking.
495 * @x: Value to copy to user space.
496 * @ptr: Destination address, in user space.
498 * Context: User context only. This function may sleep.
500 * This macro copies a single simple value from kernel space to user
501 * space. It supports simple types like char and int, but not larger
502 * data types like structures or arrays.
504 * @ptr must have pointer-to-simple-variable type, and @x must be assignable
505 * to the result of dereferencing @ptr.
507 * Caller must check the pointer with access_ok() before calling this
510 * Returns zero on success, or -EFAULT on error.
513 #define __put_user(x, ptr) \
514 __put_user_nocheck((__typeof__(*(ptr)))(x), (ptr), sizeof(*(ptr)))
516 #define __get_user_unaligned __get_user
517 #define __put_user_unaligned __put_user
520 * {get|put}_user_try and catch
524 * } get_user_catch(err)
526 #define get_user_try uaccess_try
527 #define get_user_catch(err) uaccess_catch(err)
529 #define get_user_ex(x, ptr) do { \
530 unsigned long __gue_val; \
531 __get_user_size_ex((__gue_val), (ptr), (sizeof(*(ptr)))); \
532 (x) = (__force __typeof__(*(ptr)))__gue_val; \
535 #ifdef CONFIG_X86_WP_WORKS_OK
537 #define put_user_try uaccess_try
538 #define put_user_catch(err) uaccess_catch(err)
540 #define put_user_ex(x, ptr) \
541 __put_user_size_ex((__typeof__(*(ptr)))(x), (ptr), sizeof(*(ptr)))
543 #else /* !CONFIG_X86_WP_WORKS_OK */
545 #define put_user_try do { \
546 int __uaccess_err = 0;
548 #define put_user_catch(err) \
549 (err) |= __uaccess_err; \
552 #define put_user_ex(x, ptr) do { \
553 __uaccess_err |= __put_user(x, ptr); \
556 #endif /* CONFIG_X86_WP_WORKS_OK */
559 copy_from_user_nmi(void *to
, const void __user
*from
, unsigned long n
);
562 * movsl can be slow when source and dest are not both 8-byte aligned
564 #ifdef CONFIG_X86_INTEL_USERCOPY
565 extern struct movsl_mask
{
567 } ____cacheline_aligned_in_smp movsl_mask
;
570 #define ARCH_HAS_NOCACHE_UACCESS 1
573 # include "uaccess_32.h"
575 # include "uaccess_64.h"
578 #endif /* _ASM_X86_UACCESS_H */