xref: /linux-6.15/include/linux/vmalloc.h (revision 46b402a0)
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 /* bits in flags of vmalloc's vm_struct below */
11 #define VM_IOREMAP	0x00000001	/* ioremap() and friends */
12 #define VM_ALLOC	0x00000002	/* vmalloc() */
13 #define VM_MAP		0x00000004	/* vmap()ed pages */
14 #define VM_USERMAP	0x00000008	/* suitable for remap_vmalloc_range */
15 #define VM_VPAGES	0x00000010	/* buffer for pages was vmalloc'ed */
16 /* bits [20..32] reserved for arch specific ioremap internals */
17 
18 /*
19  * Maximum alignment for ioremap() regions.
20  * Can be overriden by arch-specific value.
21  */
22 #ifndef IOREMAP_MAX_ORDER
23 #define IOREMAP_MAX_ORDER	(7 + PAGE_SHIFT)	/* 128 pages */
24 #endif
25 
26 struct vm_struct {
27 	struct vm_struct	*next;
28 	void			*addr;
29 	unsigned long		size;
30 	unsigned long		flags;
31 	struct page		**pages;
32 	unsigned int		nr_pages;
33 	phys_addr_t		phys_addr;
34 	void			*caller;
35 };
36 
37 /*
38  *	Highlevel APIs for driver use
39  */
40 extern void vm_unmap_ram(const void *mem, unsigned int count);
41 extern void *vm_map_ram(struct page **pages, unsigned int count,
42 				int node, pgprot_t prot);
43 extern void vm_unmap_aliases(void);
44 
45 #ifdef CONFIG_MMU
46 extern void __init vmalloc_init(void);
47 #else
48 static inline void vmalloc_init(void)
49 {
50 }
51 #endif
52 
53 extern void *vmalloc(unsigned long size);
54 extern void *vzalloc(unsigned long size);
55 extern void *vmalloc_user(unsigned long size);
56 extern void *vmalloc_node(unsigned long size, int node);
57 extern void *vzalloc_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 #ifdef CONFIG_SMP
121 struct vm_struct **pcpu_get_vm_areas(const unsigned long *offsets,
122 				     const size_t *sizes, int nr_vms,
123 				     size_t align, gfp_t gfp_mask);
124 
125 void pcpu_free_vm_areas(struct vm_struct **vms, int nr_vms);
126 #endif
127 
128 #endif /* _LINUX_VMALLOC_H */
129