1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef _LINUX_KASAN_H
3 #define _LINUX_KASAN_H
4 
5 #include <linux/types.h>
6 
7 struct kmem_cache;
8 struct page;
9 struct vm_struct;
10 struct task_struct;
11 
12 #ifdef CONFIG_KASAN
13 
14 #include <asm/kasan.h>
15 #include <asm/pgtable.h>
16 
17 extern unsigned char kasan_zero_page[PAGE_SIZE];
18 extern pte_t kasan_zero_pte[PTRS_PER_PTE];
19 extern pmd_t kasan_zero_pmd[PTRS_PER_PMD];
20 extern pud_t kasan_zero_pud[PTRS_PER_PUD];
21 extern p4d_t kasan_zero_p4d[MAX_PTRS_PER_P4D];
22 
23 int kasan_populate_zero_shadow(const void *shadow_start,
24 				const void *shadow_end);
25 
kasan_mem_to_shadow(const void * addr)26 static inline void *kasan_mem_to_shadow(const void *addr)
27 {
28 	return (void *)((unsigned long)addr >> KASAN_SHADOW_SCALE_SHIFT)
29 		+ KASAN_SHADOW_OFFSET;
30 }
31 
32 /* Enable reporting bugs after kasan_disable_current() */
33 extern void kasan_enable_current(void);
34 
35 /* Disable reporting bugs for current task */
36 extern void kasan_disable_current(void);
37 
38 void kasan_unpoison_shadow(const void *address, size_t size);
39 
40 void kasan_unpoison_task_stack(struct task_struct *task);
41 void kasan_unpoison_stack_above_sp_to(const void *watermark);
42 
43 void kasan_alloc_pages(struct page *page, unsigned int order);
44 void kasan_free_pages(struct page *page, unsigned int order);
45 
46 void kasan_cache_create(struct kmem_cache *cache, unsigned int *size,
47 			slab_flags_t *flags);
48 void kasan_cache_shrink(struct kmem_cache *cache);
49 void kasan_cache_shutdown(struct kmem_cache *cache);
50 
51 void kasan_poison_slab(struct page *page);
52 void kasan_unpoison_object_data(struct kmem_cache *cache, void *object);
53 void kasan_poison_object_data(struct kmem_cache *cache, void *object);
54 void kasan_init_slab_obj(struct kmem_cache *cache, const void *object);
55 
56 void kasan_kmalloc_large(const void *ptr, size_t size, gfp_t flags);
57 void kasan_kfree_large(void *ptr, unsigned long ip);
58 void kasan_poison_kfree(void *ptr, unsigned long ip);
59 void kasan_kmalloc(struct kmem_cache *s, const void *object, size_t size,
60 		  gfp_t flags);
61 void kasan_krealloc(const void *object, size_t new_size, gfp_t flags);
62 
63 void kasan_slab_alloc(struct kmem_cache *s, void *object, gfp_t flags);
64 bool kasan_slab_free(struct kmem_cache *s, void *object, unsigned long ip);
65 
66 struct kasan_cache {
67 	int alloc_meta_offset;
68 	int free_meta_offset;
69 };
70 
71 int kasan_module_alloc(void *addr, size_t size);
72 void kasan_free_shadow(const struct vm_struct *vm);
73 
74 int kasan_add_zero_shadow(void *start, unsigned long size);
75 void kasan_remove_zero_shadow(void *start, unsigned long size);
76 
77 size_t ksize(const void *);
kasan_unpoison_slab(const void * ptr)78 static inline void kasan_unpoison_slab(const void *ptr) { ksize(ptr); }
79 size_t kasan_metadata_size(struct kmem_cache *cache);
80 
81 bool kasan_save_enable_multi_shot(void);
82 void kasan_restore_multi_shot(bool enabled);
83 
84 #else /* CONFIG_KASAN */
85 
kasan_unpoison_shadow(const void * address,size_t size)86 static inline void kasan_unpoison_shadow(const void *address, size_t size) {}
87 
kasan_unpoison_task_stack(struct task_struct * task)88 static inline void kasan_unpoison_task_stack(struct task_struct *task) {}
kasan_unpoison_stack_above_sp_to(const void * watermark)89 static inline void kasan_unpoison_stack_above_sp_to(const void *watermark) {}
90 
kasan_enable_current(void)91 static inline void kasan_enable_current(void) {}
kasan_disable_current(void)92 static inline void kasan_disable_current(void) {}
93 
kasan_alloc_pages(struct page * page,unsigned int order)94 static inline void kasan_alloc_pages(struct page *page, unsigned int order) {}
kasan_free_pages(struct page * page,unsigned int order)95 static inline void kasan_free_pages(struct page *page, unsigned int order) {}
96 
kasan_cache_create(struct kmem_cache * cache,unsigned int * size,slab_flags_t * flags)97 static inline void kasan_cache_create(struct kmem_cache *cache,
98 				      unsigned int *size,
99 				      slab_flags_t *flags) {}
kasan_cache_shrink(struct kmem_cache * cache)100 static inline void kasan_cache_shrink(struct kmem_cache *cache) {}
kasan_cache_shutdown(struct kmem_cache * cache)101 static inline void kasan_cache_shutdown(struct kmem_cache *cache) {}
102 
kasan_poison_slab(struct page * page)103 static inline void kasan_poison_slab(struct page *page) {}
kasan_unpoison_object_data(struct kmem_cache * cache,void * object)104 static inline void kasan_unpoison_object_data(struct kmem_cache *cache,
105 					void *object) {}
kasan_poison_object_data(struct kmem_cache * cache,void * object)106 static inline void kasan_poison_object_data(struct kmem_cache *cache,
107 					void *object) {}
kasan_init_slab_obj(struct kmem_cache * cache,const void * object)108 static inline void kasan_init_slab_obj(struct kmem_cache *cache,
109 				const void *object) {}
110 
kasan_kmalloc_large(void * ptr,size_t size,gfp_t flags)111 static inline void kasan_kmalloc_large(void *ptr, size_t size, gfp_t flags) {}
kasan_kfree_large(void * ptr,unsigned long ip)112 static inline void kasan_kfree_large(void *ptr, unsigned long ip) {}
kasan_poison_kfree(void * ptr,unsigned long ip)113 static inline void kasan_poison_kfree(void *ptr, unsigned long ip) {}
kasan_kmalloc(struct kmem_cache * s,const void * object,size_t size,gfp_t flags)114 static inline void kasan_kmalloc(struct kmem_cache *s, const void *object,
115 				size_t size, gfp_t flags) {}
kasan_krealloc(const void * object,size_t new_size,gfp_t flags)116 static inline void kasan_krealloc(const void *object, size_t new_size,
117 				 gfp_t flags) {}
118 
kasan_slab_alloc(struct kmem_cache * s,void * object,gfp_t flags)119 static inline void kasan_slab_alloc(struct kmem_cache *s, void *object,
120 				   gfp_t flags) {}
kasan_slab_free(struct kmem_cache * s,void * object,unsigned long ip)121 static inline bool kasan_slab_free(struct kmem_cache *s, void *object,
122 				   unsigned long ip)
123 {
124 	return false;
125 }
126 
kasan_module_alloc(void * addr,size_t size)127 static inline int kasan_module_alloc(void *addr, size_t size) { return 0; }
kasan_free_shadow(const struct vm_struct * vm)128 static inline void kasan_free_shadow(const struct vm_struct *vm) {}
129 
kasan_add_zero_shadow(void * start,unsigned long size)130 static inline int kasan_add_zero_shadow(void *start, unsigned long size)
131 {
132 	return 0;
133 }
kasan_remove_zero_shadow(void * start,unsigned long size)134 static inline void kasan_remove_zero_shadow(void *start,
135 					unsigned long size)
136 {}
137 
kasan_unpoison_slab(const void * ptr)138 static inline void kasan_unpoison_slab(const void *ptr) { }
kasan_metadata_size(struct kmem_cache * cache)139 static inline size_t kasan_metadata_size(struct kmem_cache *cache) { return 0; }
140 
141 #endif /* CONFIG_KASAN */
142 
143 #endif /* LINUX_KASAN_H */
144