xref: /linux-6.15/include/linux/kasan.h (revision b13f7666)
1 #ifndef _LINUX_KASAN_H
2 #define _LINUX_KASAN_H
3 
4 #include <linux/types.h>
5 
6 struct kmem_cache;
7 struct page;
8 struct vm_struct;
9 
10 #ifdef CONFIG_KASAN
11 
12 #define KASAN_SHADOW_SCALE_SHIFT 3
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 
22 void kasan_populate_zero_shadow(const void *shadow_start,
23 				const void *shadow_end);
24 
25 static inline void *kasan_mem_to_shadow(const void *addr)
26 {
27 	return (void *)((unsigned long)addr >> KASAN_SHADOW_SCALE_SHIFT)
28 		+ KASAN_SHADOW_OFFSET;
29 }
30 
31 /* Enable reporting bugs after kasan_disable_current() */
32 extern void kasan_enable_current(void);
33 
34 /* Disable reporting bugs for current task */
35 extern void kasan_disable_current(void);
36 
37 void kasan_unpoison_shadow(const void *address, size_t size);
38 
39 void kasan_unpoison_task_stack(struct task_struct *task);
40 void kasan_unpoison_stack_above_sp_to(const void *watermark);
41 
42 void kasan_alloc_pages(struct page *page, unsigned int order);
43 void kasan_free_pages(struct page *page, unsigned int order);
44 
45 void kasan_cache_create(struct kmem_cache *cache, size_t *size,
46 			unsigned long *flags);
47 void kasan_cache_shrink(struct kmem_cache *cache);
48 void kasan_cache_shutdown(struct kmem_cache *cache);
49 
50 void kasan_poison_slab(struct page *page);
51 void kasan_unpoison_object_data(struct kmem_cache *cache, void *object);
52 void kasan_poison_object_data(struct kmem_cache *cache, void *object);
53 void kasan_init_slab_obj(struct kmem_cache *cache, const void *object);
54 
55 void kasan_kmalloc_large(const void *ptr, size_t size, gfp_t flags);
56 void kasan_kfree_large(const void *ptr);
57 void kasan_poison_kfree(void *ptr);
58 void kasan_kmalloc(struct kmem_cache *s, const void *object, size_t size,
59 		  gfp_t flags);
60 void kasan_krealloc(const void *object, size_t new_size, gfp_t flags);
61 
62 void kasan_slab_alloc(struct kmem_cache *s, void *object, gfp_t flags);
63 bool kasan_slab_free(struct kmem_cache *s, void *object);
64 
65 struct kasan_cache {
66 	int alloc_meta_offset;
67 	int free_meta_offset;
68 };
69 
70 int kasan_module_alloc(void *addr, size_t size);
71 void kasan_free_shadow(const struct vm_struct *vm);
72 
73 size_t ksize(const void *);
74 static inline void kasan_unpoison_slab(const void *ptr) { ksize(ptr); }
75 size_t kasan_metadata_size(struct kmem_cache *cache);
76 
77 #else /* CONFIG_KASAN */
78 
79 static inline void kasan_unpoison_shadow(const void *address, size_t size) {}
80 
81 static inline void kasan_unpoison_task_stack(struct task_struct *task) {}
82 static inline void kasan_unpoison_stack_above_sp_to(const void *watermark) {}
83 
84 static inline void kasan_enable_current(void) {}
85 static inline void kasan_disable_current(void) {}
86 
87 static inline void kasan_alloc_pages(struct page *page, unsigned int order) {}
88 static inline void kasan_free_pages(struct page *page, unsigned int order) {}
89 
90 static inline void kasan_cache_create(struct kmem_cache *cache,
91 				      size_t *size,
92 				      unsigned long *flags) {}
93 static inline void kasan_cache_shrink(struct kmem_cache *cache) {}
94 static inline void kasan_cache_shutdown(struct kmem_cache *cache) {}
95 
96 static inline void kasan_poison_slab(struct page *page) {}
97 static inline void kasan_unpoison_object_data(struct kmem_cache *cache,
98 					void *object) {}
99 static inline void kasan_poison_object_data(struct kmem_cache *cache,
100 					void *object) {}
101 static inline void kasan_init_slab_obj(struct kmem_cache *cache,
102 				const void *object) {}
103 
104 static inline void kasan_kmalloc_large(void *ptr, size_t size, gfp_t flags) {}
105 static inline void kasan_kfree_large(const void *ptr) {}
106 static inline void kasan_poison_kfree(void *ptr) {}
107 static inline void kasan_kmalloc(struct kmem_cache *s, const void *object,
108 				size_t size, gfp_t flags) {}
109 static inline void kasan_krealloc(const void *object, size_t new_size,
110 				 gfp_t flags) {}
111 
112 static inline void kasan_slab_alloc(struct kmem_cache *s, void *object,
113 				   gfp_t flags) {}
114 static inline bool kasan_slab_free(struct kmem_cache *s, void *object)
115 {
116 	return false;
117 }
118 
119 static inline int kasan_module_alloc(void *addr, size_t size) { return 0; }
120 static inline void kasan_free_shadow(const struct vm_struct *vm) {}
121 
122 static inline void kasan_unpoison_slab(const void *ptr) { }
123 static inline size_t kasan_metadata_size(struct kmem_cache *cache) { return 0; }
124 
125 #endif /* CONFIG_KASAN */
126 
127 #endif /* LINUX_KASAN_H */
128