xref: /linux-6.15/include/linux/vmalloc.h (revision 9d64fc08)
1 #ifndef _LINUX_VMALLOC_H
2 #define _LINUX_VMALLOC_H
3 
4 #include <linux/spinlock.h>
5 #include <linux/init.h>
6 #include <linux/list.h>
7 #include <linux/llist.h>
8 #include <asm/page.h>		/* pgprot_t */
9 #include <linux/rbtree.h>
10 
11 struct vm_area_struct;		/* vma defining user mapping in mm_types.h */
12 struct notifier_block;		/* in notifier.h */
13 
14 /* bits in flags of vmalloc's vm_struct below */
15 #define VM_IOREMAP		0x00000001	/* ioremap() and friends */
16 #define VM_ALLOC		0x00000002	/* vmalloc() */
17 #define VM_MAP			0x00000004	/* vmap()ed pages */
18 #define VM_USERMAP		0x00000008	/* suitable for remap_vmalloc_range */
19 #define VM_UNINITIALIZED	0x00000020	/* vm_struct is not fully initialized */
20 #define VM_NO_GUARD		0x00000040      /* don't add guard page */
21 #define VM_KASAN		0x00000080      /* has allocated kasan shadow memory */
22 /* bits [20..32] reserved for arch specific ioremap internals */
23 
24 /*
25  * Maximum alignment for ioremap() regions.
26  * Can be overriden by arch-specific value.
27  */
28 #ifndef IOREMAP_MAX_ORDER
29 #define IOREMAP_MAX_ORDER	(7 + PAGE_SHIFT)	/* 128 pages */
30 #endif
31 
32 struct vm_struct {
33 	struct vm_struct	*next;
34 	void			*addr;
35 	unsigned long		size;
36 	unsigned long		flags;
37 	struct page		**pages;
38 	unsigned int		nr_pages;
39 	phys_addr_t		phys_addr;
40 	const void		*caller;
41 };
42 
43 struct vmap_area {
44 	unsigned long va_start;
45 	unsigned long va_end;
46 	unsigned long flags;
47 	struct rb_node rb_node;         /* address sorted rbtree */
48 	struct list_head list;          /* address sorted list */
49 	struct llist_node purge_list;    /* "lazy purge" list */
50 	struct vm_struct *vm;
51 	struct rcu_head rcu_head;
52 };
53 
54 /*
55  *	Highlevel APIs for driver use
56  */
57 extern void vm_unmap_ram(const void *mem, unsigned int count);
58 extern void *vm_map_ram(struct page **pages, unsigned int count,
59 				int node, pgprot_t prot);
60 extern void vm_unmap_aliases(void);
61 
62 #ifdef CONFIG_MMU
63 extern void __init vmalloc_init(void);
64 #else
65 static inline void vmalloc_init(void)
66 {
67 }
68 #endif
69 
70 extern void *vmalloc(unsigned long size);
71 extern void *vzalloc(unsigned long size);
72 extern void *vmalloc_user(unsigned long size);
73 extern void *vmalloc_node(unsigned long size, int node);
74 extern void *vzalloc_node(unsigned long size, int node);
75 extern void *vmalloc_exec(unsigned long size);
76 extern void *vmalloc_32(unsigned long size);
77 extern void *vmalloc_32_user(unsigned long size);
78 extern void *__vmalloc(unsigned long size, gfp_t gfp_mask, pgprot_t prot);
79 extern void *__vmalloc_node_range(unsigned long size, unsigned long align,
80 			unsigned long start, unsigned long end, gfp_t gfp_mask,
81 			pgprot_t prot, unsigned long vm_flags, int node,
82 			const void *caller);
83 #ifndef CONFIG_MMU
84 extern void *__vmalloc_node_flags(unsigned long size, int node, gfp_t flags);
85 static inline void *__vmalloc_node_flags_caller(unsigned long size, int node,
86 						gfp_t flags, void *caller)
87 {
88 	return __vmalloc_node_flags(size, node, flags);
89 }
90 #else
91 extern void *__vmalloc_node_flags_caller(unsigned long size,
92 					 int node, gfp_t flags, void *caller);
93 #endif
94 
95 extern void vfree(const void *addr);
96 extern void vfree_atomic(const void *addr);
97 
98 extern void *vmap(struct page **pages, unsigned int count,
99 			unsigned long flags, pgprot_t prot);
100 extern void vunmap(const void *addr);
101 
102 extern int remap_vmalloc_range_partial(struct vm_area_struct *vma,
103 				       unsigned long uaddr, void *kaddr,
104 				       unsigned long size);
105 
106 extern int remap_vmalloc_range(struct vm_area_struct *vma, void *addr,
107 							unsigned long pgoff);
108 void vmalloc_sync_all(void);
109 
110 /*
111  *	Lowlevel-APIs (not for driver use!)
112  */
113 
114 static inline size_t get_vm_area_size(const struct vm_struct *area)
115 {
116 	if (!(area->flags & VM_NO_GUARD))
117 		/* return actual size without guard page */
118 		return area->size - PAGE_SIZE;
119 	else
120 		return area->size;
121 
122 }
123 
124 extern struct vm_struct *get_vm_area(unsigned long size, unsigned long flags);
125 extern struct vm_struct *get_vm_area_caller(unsigned long size,
126 					unsigned long flags, const void *caller);
127 extern struct vm_struct *__get_vm_area(unsigned long size, unsigned long flags,
128 					unsigned long start, unsigned long end);
129 extern struct vm_struct *__get_vm_area_caller(unsigned long size,
130 					unsigned long flags,
131 					unsigned long start, unsigned long end,
132 					const void *caller);
133 extern struct vm_struct *remove_vm_area(const void *addr);
134 extern struct vm_struct *find_vm_area(const void *addr);
135 
136 extern int map_vm_area(struct vm_struct *area, pgprot_t prot,
137 			struct page **pages);
138 #ifdef CONFIG_MMU
139 extern int map_kernel_range_noflush(unsigned long start, unsigned long size,
140 				    pgprot_t prot, struct page **pages);
141 extern void unmap_kernel_range_noflush(unsigned long addr, unsigned long size);
142 extern void unmap_kernel_range(unsigned long addr, unsigned long size);
143 #else
144 static inline int
145 map_kernel_range_noflush(unsigned long start, unsigned long size,
146 			pgprot_t prot, struct page **pages)
147 {
148 	return size >> PAGE_SHIFT;
149 }
150 static inline void
151 unmap_kernel_range_noflush(unsigned long addr, unsigned long size)
152 {
153 }
154 static inline void
155 unmap_kernel_range(unsigned long addr, unsigned long size)
156 {
157 }
158 #endif
159 
160 /* Allocate/destroy a 'vmalloc' VM area. */
161 extern struct vm_struct *alloc_vm_area(size_t size, pte_t **ptes);
162 extern void free_vm_area(struct vm_struct *area);
163 
164 /* for /dev/kmem */
165 extern long vread(char *buf, char *addr, unsigned long count);
166 extern long vwrite(char *buf, char *addr, unsigned long count);
167 
168 /*
169  *	Internals.  Dont't use..
170  */
171 extern struct list_head vmap_area_list;
172 extern __init void vm_area_add_early(struct vm_struct *vm);
173 extern __init void vm_area_register_early(struct vm_struct *vm, size_t align);
174 
175 #ifdef CONFIG_SMP
176 # ifdef CONFIG_MMU
177 struct vm_struct **pcpu_get_vm_areas(const unsigned long *offsets,
178 				     const size_t *sizes, int nr_vms,
179 				     size_t align);
180 
181 void pcpu_free_vm_areas(struct vm_struct **vms, int nr_vms);
182 # else
183 static inline struct vm_struct **
184 pcpu_get_vm_areas(const unsigned long *offsets,
185 		const size_t *sizes, int nr_vms,
186 		size_t align)
187 {
188 	return NULL;
189 }
190 
191 static inline void
192 pcpu_free_vm_areas(struct vm_struct **vms, int nr_vms)
193 {
194 }
195 # endif
196 #endif
197 
198 #ifdef CONFIG_MMU
199 #define VMALLOC_TOTAL (VMALLOC_END - VMALLOC_START)
200 #else
201 #define VMALLOC_TOTAL 0UL
202 #endif
203 
204 int register_vmap_purge_notifier(struct notifier_block *nb);
205 int unregister_vmap_purge_notifier(struct notifier_block *nb);
206 
207 #endif /* _LINUX_VMALLOC_H */
208