xref: /linux-6.15/include/linux/vmalloc.h (revision cdb13808)
1 #ifndef _LINUX_VMALLOC_H
2 #define _LINUX_VMALLOC_H
3 
4 #include <linux/spinlock.h>
5 #include <linux/init.h>
6 #include <asm/page.h>		/* pgprot_t */
7 
8 struct vm_area_struct;		/* vma defining user mapping in mm_types.h */
9 
10 extern bool vmap_lazy_unmap;
11 
12 /* bits in flags of vmalloc's vm_struct below */
13 #define VM_IOREMAP	0x00000001	/* ioremap() and friends */
14 #define VM_ALLOC	0x00000002	/* vmalloc() */
15 #define VM_MAP		0x00000004	/* vmap()ed pages */
16 #define VM_USERMAP	0x00000008	/* suitable for remap_vmalloc_range */
17 #define VM_VPAGES	0x00000010	/* buffer for pages was vmalloc'ed */
18 /* bits [20..32] reserved for arch specific ioremap internals */
19 
20 /*
21  * Maximum alignment for ioremap() regions.
22  * Can be overriden by arch-specific value.
23  */
24 #ifndef IOREMAP_MAX_ORDER
25 #define IOREMAP_MAX_ORDER	(7 + PAGE_SHIFT)	/* 128 pages */
26 #endif
27 
28 struct vm_struct {
29 	struct vm_struct	*next;
30 	void			*addr;
31 	unsigned long		size;
32 	unsigned long		flags;
33 	struct page		**pages;
34 	unsigned int		nr_pages;
35 	phys_addr_t		phys_addr;
36 	void			*caller;
37 };
38 
39 /*
40  *	Highlevel APIs for driver use
41  */
42 extern void vm_unmap_ram(const void *mem, unsigned int count);
43 extern void *vm_map_ram(struct page **pages, unsigned int count,
44 				int node, pgprot_t prot);
45 extern void vm_unmap_aliases(void);
46 
47 #ifdef CONFIG_MMU
48 extern void __init vmalloc_init(void);
49 #else
50 static inline void vmalloc_init(void)
51 {
52 }
53 #endif
54 
55 extern void *vmalloc(unsigned long size);
56 extern void *vmalloc_user(unsigned long size);
57 extern void *vmalloc_node(unsigned long size, int node);
58 extern void *vmalloc_exec(unsigned long size);
59 extern void *vmalloc_32(unsigned long size);
60 extern void *vmalloc_32_user(unsigned long size);
61 extern void *__vmalloc(unsigned long size, gfp_t gfp_mask, pgprot_t prot);
62 extern void *__vmalloc_area(struct vm_struct *area, gfp_t gfp_mask,
63 				pgprot_t prot);
64 extern void vfree(const void *addr);
65 
66 extern void *vmap(struct page **pages, unsigned int count,
67 			unsigned long flags, pgprot_t prot);
68 extern void vunmap(const void *addr);
69 
70 extern int remap_vmalloc_range(struct vm_area_struct *vma, void *addr,
71 							unsigned long pgoff);
72 void vmalloc_sync_all(void);
73 
74 /*
75  *	Lowlevel-APIs (not for driver use!)
76  */
77 
78 static inline size_t get_vm_area_size(const struct vm_struct *area)
79 {
80 	/* return actual size without guard page */
81 	return area->size - PAGE_SIZE;
82 }
83 
84 extern struct vm_struct *get_vm_area(unsigned long size, unsigned long flags);
85 extern struct vm_struct *get_vm_area_caller(unsigned long size,
86 					unsigned long flags, void *caller);
87 extern struct vm_struct *__get_vm_area(unsigned long size, unsigned long flags,
88 					unsigned long start, unsigned long end);
89 extern struct vm_struct *__get_vm_area_caller(unsigned long size,
90 					unsigned long flags,
91 					unsigned long start, unsigned long end,
92 					void *caller);
93 extern struct vm_struct *get_vm_area_node(unsigned long size,
94 					  unsigned long flags, int node,
95 					  gfp_t gfp_mask);
96 extern struct vm_struct *remove_vm_area(const void *addr);
97 
98 extern int map_vm_area(struct vm_struct *area, pgprot_t prot,
99 			struct page ***pages);
100 extern int map_kernel_range_noflush(unsigned long start, unsigned long size,
101 				    pgprot_t prot, struct page **pages);
102 extern void unmap_kernel_range_noflush(unsigned long addr, unsigned long size);
103 extern void unmap_kernel_range(unsigned long addr, unsigned long size);
104 
105 /* Allocate/destroy a 'vmalloc' VM area. */
106 extern struct vm_struct *alloc_vm_area(size_t size);
107 extern void free_vm_area(struct vm_struct *area);
108 
109 /* for /dev/kmem */
110 extern long vread(char *buf, char *addr, unsigned long count);
111 extern long vwrite(char *buf, char *addr, unsigned long count);
112 
113 /*
114  *	Internals.  Dont't use..
115  */
116 extern rwlock_t vmlist_lock;
117 extern struct vm_struct *vmlist;
118 extern __init void vm_area_register_early(struct vm_struct *vm, size_t align);
119 
120 struct vm_struct **pcpu_get_vm_areas(const unsigned long *offsets,
121 				     const size_t *sizes, int nr_vms,
122 				     size_t align, gfp_t gfp_mask);
123 
124 void pcpu_free_vm_areas(struct vm_struct **vms, int nr_vms);
125 
126 #endif /* _LINUX_VMALLOC_H */
127