1 #ifndef _ASM_M32R_UACCESS_H
2 #define _ASM_M32R_UACCESS_H
5 * linux/include/asm-m32r/uaccess.h
8 * Copyright (C) 2004 Hirokazu Takata <takata at linux-m32r.org>
14 #define UAPRINTK(args...) printk(args)
16 #define UAPRINTK(args...)
17 #endif /* UACCESS_DEBUG */
20 * User space memory access functions
22 #include <linux/config.h>
23 #include <linux/errno.h>
24 #include <linux/thread_info.h>
28 #define VERIFY_WRITE 1
31 * The fs value determines whether argument validity checking should be
32 * performed or not. If get_fs() == USER_DS, checking is performed, with
33 * get_fs() == KERNEL_DS, checking is bypassed.
35 * For historical reasons, these macros are grossly misnamed.
38 #define MAKE_MM_SEG(s) ((mm_segment_t) { (s) })
41 #define KERNEL_DS MAKE_MM_SEG(0xFFFFFFFF)
42 #define USER_DS MAKE_MM_SEG(PAGE_OFFSET)
44 #define KERNEL_DS MAKE_MM_SEG(0xFFFFFFFF)
45 #define USER_DS MAKE_MM_SEG(0xFFFFFFFF)
46 #endif /* CONFIG_MMU */
48 #define get_ds() (KERNEL_DS)
50 #define get_fs() (current_thread_info()->addr_limit)
51 #define set_fs(x) (current_thread_info()->addr_limit = (x))
53 static inline mm_segment_t
get_fs(void)
58 static inline void set_fs(mm_segment_t s
)
61 #endif /* CONFIG_MMU */
63 #define segment_eq(a,b) ((a).seg == (b).seg)
65 #define __addr_ok(addr) \
66 ((unsigned long)(addr) < (current_thread_info()->addr_limit.seg))
69 * Test whether a block of memory is a valid user space address.
70 * Returns 0 if the range is valid, nonzero otherwise.
72 * This is equivalent to the following test:
73 * (u33)addr + (u33)size >= (u33)current->addr_limit.seg
75 * This needs 33-bit arithmetic. We have a carry...
77 #define __range_ok(addr,size) ({ \
78 unsigned long flag, sum; \
79 __chk_user_ptr(addr); \
81 " cmpu %1, %1 ; clear cbit\n" \
82 " addx %1, %3 ; set cbit if overflow\n" \
86 : "=&r"(flag), "=r"(sum) \
87 : "1"(addr), "r"((int)(size)), \
88 "r"(current_thread_info()->addr_limit.seg), "r"(0) \
93 * access_ok: - Checks if a user space pointer is valid
94 * @type: Type of access: %VERIFY_READ or %VERIFY_WRITE. Note that
95 * %VERIFY_WRITE is a superset of %VERIFY_READ - if it is safe
96 * to write to a block, it is always safe to read from it.
97 * @addr: User space pointer to start of block to check
98 * @size: Size of block to check
100 * Context: User context only. This function may sleep.
102 * Checks if a pointer to a block of memory in user space is valid.
104 * Returns true (nonzero) if the memory block may be valid, false (zero)
105 * if it is definitely invalid.
107 * Note that, depending on architecture, this function probably just
108 * checks that the pointer is in the user space range - after calling
109 * this function, memory access functions may still return -EFAULT.
112 #define access_ok(type,addr,size) (likely(__range_ok(addr,size) == 0))
114 static inline int access_ok(int type
, const void *addr
, unsigned long size
)
116 extern unsigned long memory_start
, memory_end
;
117 unsigned long val
= (unsigned long)addr
;
119 return ((val
>= memory_start
) && ((val
+ size
) < memory_end
));
121 #endif /* CONFIG_MMU */
124 * verify_area: - Obsolete, use access_ok()
125 * @type: Type of access: %VERIFY_READ or %VERIFY_WRITE
126 * @addr: User space pointer to start of block to check
127 * @size: Size of block to check
129 * Context: User context only. This function may sleep.
131 * This function has been replaced by access_ok().
133 * Checks if a pointer to a block of memory in user space is valid.
135 * Returns zero if the memory block may be valid, -EFAULT
136 * if it is definitely invalid.
138 * See access_ok() for more details.
140 static inline int verify_area(int type
, const void __user
*addr
,
143 return access_ok(type
, addr
, size
) ? 0 : -EFAULT
;
148 * The exception table consists of pairs of addresses: the first is the
149 * address of an instruction that is allowed to fault, and the second is
150 * the address at which the program should continue. No registers are
151 * modified, so it is entirely up to the continuation code to figure out
154 * All the routines below use bits of fixup code that are out of line
155 * with the main instruction path. This means when everything is well,
156 * we don't even have to jump over them. Further, they do not intrude
157 * on our cache or tlb entries.
160 struct exception_table_entry
162 unsigned long insn
, fixup
;
165 extern int fixup_exception(struct pt_regs
*regs
);
168 * These are the main single-value transfer routines. They automatically
169 * use the right size if we just have the right pointer type.
171 * This gets kind of ugly. We want to return _two_ values in "get_user()"
172 * and yet we don't want to do any pointers, because that is too much
173 * of a performance impact. Thus we have a few rather ugly macros here,
174 * and hide all the uglyness from the user.
176 * The "__xxx" versions of the user access functions are versions that
177 * do not verify the address space, that must have been done previously
178 * with a separate "access_ok()" call (this is used when we do multiple
179 * accesses to the same area of user memory).
182 extern void __get_user_1(void);
183 extern void __get_user_2(void);
184 extern void __get_user_4(void);
187 #define __get_user_x(size,ret,x,ptr) \
188 __asm__ __volatile__( \
191 " bl __get_user_" #size "\n" \
194 : "=r"(ret), "=r"(x) \
196 : "r0", "r1", "r14" )
199 * Use "jl" instead of "bl" for MODULE
201 #define __get_user_x(size,ret,x,ptr) \
202 __asm__ __volatile__( \
205 " seth lr, #high(__get_user_" #size ")\n" \
206 " or3 lr, lr, #low(__get_user_" #size ")\n" \
210 : "=r"(ret), "=r"(x) \
212 : "r0", "r1", "r14" )
215 /* Careful: we have to cast the result to the type of the pointer for sign
218 * get_user: - Get a simple variable from user space.
219 * @x: Variable to store result.
220 * @ptr: Source address, in user space.
222 * Context: User context only. This function may sleep.
224 * This macro copies a single simple variable from user space to kernel
225 * space. It supports simple types like char and int, but not larger
226 * data types like structures or arrays.
228 * @ptr must have pointer-to-simple-variable type, and the result of
229 * dereferencing @ptr must be assignable to @x without a cast.
231 * Returns zero on success, or -EFAULT on error.
232 * On error, the variable @x is set to zero.
234 #define get_user(x,ptr) \
235 ({ int __ret_gu,__val_gu; \
236 __chk_user_ptr(ptr); \
237 switch(sizeof (*(ptr))) { \
238 case 1: __get_user_x(1,__ret_gu,__val_gu,ptr); break; \
239 case 2: __get_user_x(2,__ret_gu,__val_gu,ptr); break; \
240 case 4: __get_user_x(4,__ret_gu,__val_gu,ptr); break; \
241 default: __get_user_x(X,__ret_gu,__val_gu,ptr); break; \
243 (x) = (__typeof__(*(ptr)))__val_gu; \
247 extern void __put_user_bad(void);
250 * put_user: - Write a simple value into user space.
251 * @x: Value to copy to user space.
252 * @ptr: Destination address, in user space.
254 * Context: User context only. This function may sleep.
256 * This macro copies a single simple value from kernel space to user
257 * space. It supports simple types like char and int, but not larger
258 * data types like structures or arrays.
260 * @ptr must have pointer-to-simple-variable type, and @x must be assignable
261 * to the result of dereferencing @ptr.
263 * Returns zero on success, or -EFAULT on error.
265 #define put_user(x,ptr) \
266 __put_user_check((__typeof__(*(ptr)))(x),(ptr),sizeof(*(ptr)))
270 * __get_user: - Get a simple variable from user space, with less checking.
271 * @x: Variable to store result.
272 * @ptr: Source address, in user space.
274 * Context: User context only. This function may sleep.
276 * This macro copies a single simple variable from user space to kernel
277 * space. It supports simple types like char and int, but not larger
278 * data types like structures or arrays.
280 * @ptr must have pointer-to-simple-variable type, and the result of
281 * dereferencing @ptr must be assignable to @x without a cast.
283 * Caller must check the pointer with access_ok() before calling this
286 * Returns zero on success, or -EFAULT on error.
287 * On error, the variable @x is set to zero.
289 #define __get_user(x,ptr) \
290 __get_user_nocheck((x),(ptr),sizeof(*(ptr)))
294 * __put_user: - Write a simple value into user space, with less checking.
295 * @x: Value to copy to user space.
296 * @ptr: Destination address, in user space.
298 * Context: User context only. This function may sleep.
300 * This macro copies a single simple value from kernel space to user
301 * space. It supports simple types like char and int, but not larger
302 * data types like structures or arrays.
304 * @ptr must have pointer-to-simple-variable type, and @x must be assignable
305 * to the result of dereferencing @ptr.
307 * Caller must check the pointer with access_ok() before calling this
310 * Returns zero on success, or -EFAULT on error.
312 #define __put_user(x,ptr) \
313 __put_user_nocheck((__typeof__(*(ptr)))(x),(ptr),sizeof(*(ptr)))
315 #define __put_user_nocheck(x,ptr,size) \
318 __put_user_size((x),(ptr),(size),__pu_err); \
323 #define __put_user_check(x,ptr,size) \
325 long __pu_err = -EFAULT; \
326 __typeof__(*(ptr)) __user *__pu_addr = (ptr); \
328 if (access_ok(VERIFY_WRITE,__pu_addr,size)) \
329 __put_user_size((x),__pu_addr,(size),__pu_err); \
333 #if defined(__LITTLE_ENDIAN__)
334 #define __put_user_u64(x, addr, err) \
335 __asm__ __volatile__( \
339 "2: st %H1,@(4,%2)\n" \
342 ".section .fixup,\"ax\"\n" \
345 " seth r14,#high(3b)\n" \
346 " or3 r14,r14,#low(3b)\n" \
349 ".section __ex_table,\"a\"\n" \
355 : "r"(x), "r"(addr), "i"(-EFAULT), "0"(err) \
358 #elif defined(__BIG_ENDIAN__)
359 #define __put_user_u64(x, addr, err) \
360 __asm__ __volatile__( \
364 "2: st %L1,@(4,%2)\n" \
367 ".section .fixup,\"ax\"\n" \
370 " seth r14,#high(3b)\n" \
371 " or3 r14,r14,#low(3b)\n" \
374 ".section __ex_table,\"a\"\n" \
380 : "r"(x), "r"(addr), "i"(-EFAULT), "0"(err) \
383 #error no endian defined
386 #define __put_user_size(x,ptr,size,retval) \
389 __chk_user_ptr(ptr); \
391 case 1: __put_user_asm(x,ptr,retval,"b"); break; \
392 case 2: __put_user_asm(x,ptr,retval,"h"); break; \
393 case 4: __put_user_asm(x,ptr,retval,""); break; \
394 case 8: __put_user_u64((__typeof__(*ptr))(x),ptr,retval); break;\
395 default: __put_user_bad(); \
399 struct __large_struct
{ unsigned long buf
[100]; };
400 #define __m(x) (*(struct __large_struct *)(x))
403 * Tell gcc we read from memory instead of writing: this is because
404 * we do not write to any memory gcc knows about, so there are no
407 #define __put_user_asm(x, addr, err, itype) \
408 __asm__ __volatile__( \
410 "1: st"itype" %1,@%2\n" \
413 ".section .fixup,\"ax\"\n" \
416 " seth r14,#high(2b)\n" \
417 " or3 r14,r14,#low(2b)\n" \
420 ".section __ex_table,\"a\"\n" \
425 : "r"(x), "r"(addr), "i"(-EFAULT), "0"(err) \
428 #define __get_user_nocheck(x,ptr,size) \
430 long __gu_err, __gu_val; \
431 __get_user_size(__gu_val,(ptr),(size),__gu_err); \
432 (x) = (__typeof__(*(ptr)))__gu_val; \
436 extern long __get_user_bad(void);
438 #define __get_user_size(x,ptr,size,retval) \
441 __chk_user_ptr(ptr); \
443 case 1: __get_user_asm(x,ptr,retval,"ub"); break; \
444 case 2: __get_user_asm(x,ptr,retval,"uh"); break; \
445 case 4: __get_user_asm(x,ptr,retval,""); break; \
446 default: (x) = __get_user_bad(); \
450 #define __get_user_asm(x, addr, err, itype) \
451 __asm__ __volatile__( \
453 "1: ld"itype" %1,@%2\n" \
456 ".section .fixup,\"ax\"\n" \
459 " seth r14,#high(2b)\n" \
460 " or3 r14,r14,#low(2b)\n" \
463 ".section __ex_table,\"a\"\n" \
467 : "=r"(err), "=&r"(x) \
468 : "r"(addr), "i"(-EFAULT), "0"(err) \
472 * Here we special-case 1, 2 and 4-byte copy_*_user invocations. On a fault
473 * we return the initial request size (1, 2 or 4), as copy_*_user should do.
474 * If a store crosses a page boundary and gets a fault, the m32r will not write
475 * anything, so this is accurate.
480 * Copy To/From Userspace
483 /* Generic arbitrary sized copy. */
484 /* Return the number of bytes NOT copied. */
485 #define __copy_user(to,from,size) \
487 unsigned long __dst, __src, __c; \
488 __asm__ __volatile__ ( \
491 " beq %0, %1, 9f\n" \
493 " and3 r14, r14, #3\n" \
495 " and3 %2, %2, #3\n" \
497 " addi %0, #-4 ; word_copy \n" \
499 "0: ld r14, @%1+\n" \
502 "1: st r14, @+%0\n" \
507 "2: ldb r14, @%1 ; byte_copy \n" \
509 "3: stb r14, @%0\n" \
516 ".section .fixup,\"ax\"\n" \
525 "7: seth r14, #high(9b)\n" \
526 " or3 r14, r14, #low(9b)\n" \
529 ".section __ex_table,\"a\"\n" \
536 : "=&r"(__dst), "=&r"(__src), "=&r"(size), "=&r"(__c) \
537 : "0"(to), "1"(from), "2"(size), "3"(size / 4) \
538 : "r14", "memory"); \
541 #define __copy_user_zeroing(to,from,size) \
543 unsigned long __dst, __src, __c; \
544 __asm__ __volatile__ ( \
547 " beq %0, %1, 9f\n" \
549 " and3 r14, r14, #3\n" \
551 " and3 %2, %2, #3\n" \
553 " addi %0, #-4 ; word_copy \n" \
555 "0: ld r14, @%1+\n" \
558 "1: st r14, @+%0\n" \
563 "2: ldb r14, @%1 ; byte_copy \n" \
565 "3: stb r14, @%0\n" \
572 ".section .fixup,\"ax\"\n" \
581 "7: ldi r14, #0 ; store zero \n" \
583 "8: addi %2, #-1\n" \
584 " stb r14, @%0 ; ACE? \n" \
587 " seth r14, #high(9b)\n" \
588 " or3 r14, r14, #low(9b)\n" \
591 ".section __ex_table,\"a\"\n" \
598 : "=&r"(__dst), "=&r"(__src), "=&r"(size), "=&r"(__c) \
599 : "0"(to), "1"(from), "2"(size), "3"(size / 4) \
600 : "r14", "memory"); \
604 /* We let the __ versions of copy_from/to_user inline, because they're often
605 * used in fast paths and have only a small space overhead.
607 static inline unsigned long __generic_copy_from_user_nocheck(void *to
,
608 const void __user
*from
, unsigned long n
)
610 __copy_user_zeroing(to
,from
,n
);
614 static inline unsigned long __generic_copy_to_user_nocheck(void __user
*to
,
615 const void *from
, unsigned long n
)
617 __copy_user(to
,from
,n
);
621 unsigned long __generic_copy_to_user(void *, const void *, unsigned long);
622 unsigned long __generic_copy_from_user(void *, const void *, unsigned long);
625 * __copy_to_user: - Copy a block of data into user space, with less checking.
626 * @to: Destination address, in user space.
627 * @from: Source address, in kernel space.
628 * @n: Number of bytes to copy.
630 * Context: User context only. This function may sleep.
632 * Copy data from kernel space to user space. Caller must check
633 * the specified block with access_ok() before calling this function.
635 * Returns number of bytes that could not be copied.
636 * On success, this will be zero.
638 #define __copy_to_user(to,from,n) \
639 __generic_copy_to_user_nocheck((to),(from),(n))
641 #define __copy_to_user_inatomic __copy_to_user
642 #define __copy_from_user_inatomic __copy_from_user
645 * copy_to_user: - Copy a block of data into user space.
646 * @to: Destination address, in user space.
647 * @from: Source address, in kernel space.
648 * @n: Number of bytes to copy.
650 * Context: User context only. This function may sleep.
652 * Copy data from kernel space to user space.
654 * Returns number of bytes that could not be copied.
655 * On success, this will be zero.
657 #define copy_to_user(to,from,n) \
660 __generic_copy_to_user((to),(from),(n)); \
664 * __copy_from_user: - Copy a block of data from user space, with less checking. * @to: Destination address, in kernel space.
665 * @from: Source address, in user space.
666 * @n: Number of bytes to copy.
668 * Context: User context only. This function may sleep.
670 * Copy data from user space to kernel space. Caller must check
671 * the specified block with access_ok() before calling this function.
673 * Returns number of bytes that could not be copied.
674 * On success, this will be zero.
676 * If some data could not be copied, this function will pad the copied
677 * data to the requested size using zero bytes.
679 #define __copy_from_user(to,from,n) \
680 __generic_copy_from_user_nocheck((to),(from),(n))
683 * copy_from_user: - Copy a block of data from user space.
684 * @to: Destination address, in kernel space.
685 * @from: Source address, in user space.
686 * @n: Number of bytes to copy.
688 * Context: User context only. This function may sleep.
690 * Copy data from user space to kernel space.
692 * Returns number of bytes that could not be copied.
693 * On success, this will be zero.
695 * If some data could not be copied, this function will pad the copied
696 * data to the requested size using zero bytes.
698 #define copy_from_user(to,from,n) \
701 __generic_copy_from_user((to),(from),(n)); \
704 long __must_check
strncpy_from_user(char *dst
, const char __user
*src
,
706 long __must_check
__strncpy_from_user(char *dst
,
707 const char __user
*src
, long count
);
710 * __clear_user: - Zero a block of memory in user space, with less checking.
711 * @to: Destination address, in user space.
712 * @n: Number of bytes to zero.
714 * Zero a block of memory in user space. Caller must check
715 * the specified block with access_ok() before calling this function.
717 * Returns number of bytes that could not be cleared.
718 * On success, this will be zero.
720 unsigned long __clear_user(void __user
*mem
, unsigned long len
);
723 * clear_user: - Zero a block of memory in user space.
724 * @to: Destination address, in user space.
725 * @n: Number of bytes to zero.
727 * Zero a block of memory in user space. Caller must check
728 * the specified block with access_ok() before calling this function.
730 * Returns number of bytes that could not be cleared.
731 * On success, this will be zero.
733 unsigned long clear_user(void __user
*mem
, unsigned long len
);
736 * strlen_user: - Get the size of a string in user space.
737 * @str: The string to measure.
739 * Context: User context only. This function may sleep.
741 * Get the size of a NUL-terminated string in user space.
743 * Returns the size of the string INCLUDING the terminating NUL.
744 * On exception, returns 0.
746 * If there is a limit on the length of a valid string, you may wish to
747 * consider using strnlen_user() instead.
749 #define strlen_user(str) strnlen_user(str, ~0UL >> 1)
750 long strnlen_user(const char __user
*str
, long n
);
752 #endif /* _ASM_M32R_UACCESS_H */