xref: /openbmc/linux/include/linux/mman.h (revision a0071e3b)
1b2441318SGreg Kroah-Hartman /* SPDX-License-Identifier: GPL-2.0 */
21da177e4SLinus Torvalds #ifndef _LINUX_MMAN_H
31da177e4SLinus Torvalds #define _LINUX_MMAN_H
41da177e4SLinus Torvalds 
59cdcb566SDavid Woodhouse #include <linux/mm.h>
600a62ce9SKOSAKI Motohiro #include <linux/percpu_counter.h>
79cdcb566SDavid Woodhouse 
860063497SArun Sharma #include <linux/atomic.h>
9607ca46eSDavid Howells #include <uapi/linux/mman.h>
109cdcb566SDavid Woodhouse 
111c972597SDan Williams /*
121c972597SDan Williams  * Arrange for legacy / undefined architecture specific flags to be
13b6fb293fSJan Kara  * ignored by mmap handling code.
141c972597SDan Williams  */
151c972597SDan Williams #ifndef MAP_32BIT
161c972597SDan Williams #define MAP_32BIT 0
171c972597SDan Williams #endif
1829f890d1SRick Edgecombe #ifndef MAP_ABOVE4G
1929f890d1SRick Edgecombe #define MAP_ABOVE4G 0
2029f890d1SRick Edgecombe #endif
211c972597SDan Williams #ifndef MAP_HUGE_2MB
221c972597SDan Williams #define MAP_HUGE_2MB 0
231c972597SDan Williams #endif
241c972597SDan Williams #ifndef MAP_HUGE_1GB
251c972597SDan Williams #define MAP_HUGE_1GB 0
261c972597SDan Williams #endif
271c972597SDan Williams #ifndef MAP_UNINITIALIZED
281c972597SDan Williams #define MAP_UNINITIALIZED 0
291c972597SDan Williams #endif
30b6fb293fSJan Kara #ifndef MAP_SYNC
31b6fb293fSJan Kara #define MAP_SYNC 0
32b6fb293fSJan Kara #endif
331c972597SDan Williams 
341c972597SDan Williams /*
351c972597SDan Williams  * The historical set of flags that all mmap implementations implicitly
361c972597SDan Williams  * support when a ->mmap_validate() op is not provided in file_operations.
373b8db39fSDavid Hildenbrand  *
386128b3afSDavid Hildenbrand  * MAP_EXECUTABLE and MAP_DENYWRITE are completely ignored throughout the
396128b3afSDavid Hildenbrand  * kernel.
401c972597SDan Williams  */
411c972597SDan Williams #define LEGACY_MAP_MASK (MAP_SHARED \
421c972597SDan Williams 		| MAP_PRIVATE \
431c972597SDan Williams 		| MAP_FIXED \
441c972597SDan Williams 		| MAP_ANONYMOUS \
451c972597SDan Williams 		| MAP_DENYWRITE \
461c972597SDan Williams 		| MAP_EXECUTABLE \
471c972597SDan Williams 		| MAP_UNINITIALIZED \
481c972597SDan Williams 		| MAP_GROWSDOWN \
491c972597SDan Williams 		| MAP_LOCKED \
501c972597SDan Williams 		| MAP_NORESERVE \
511c972597SDan Williams 		| MAP_POPULATE \
521c972597SDan Williams 		| MAP_NONBLOCK \
531c972597SDan Williams 		| MAP_STACK \
541c972597SDan Williams 		| MAP_HUGETLB \
551c972597SDan Williams 		| MAP_32BIT \
5629f890d1SRick Edgecombe 		| MAP_ABOVE4G \
571c972597SDan Williams 		| MAP_HUGE_2MB \
581c972597SDan Williams 		| MAP_HUGE_1GB)
591c972597SDan Williams 
601da177e4SLinus Torvalds extern int sysctl_overcommit_memory;
611da177e4SLinus Torvalds extern int sysctl_overcommit_ratio;
6249f0ce5fSJerome Marchand extern unsigned long sysctl_overcommit_kbytes;
6300a62ce9SKOSAKI Motohiro extern struct percpu_counter vm_committed_as;
641da177e4SLinus Torvalds 
65917d9290STim Chen #ifdef CONFIG_SMP
66917d9290STim Chen extern s32 vm_committed_as_batch;
6756f3547bSFeng Tang extern void mm_compute_batch(int overcommit_policy);
68917d9290STim Chen #else
69917d9290STim Chen #define vm_committed_as_batch 0
mm_compute_batch(int overcommit_policy)7056f3547bSFeng Tang static inline void mm_compute_batch(int overcommit_policy)
7156f3547bSFeng Tang {
7256f3547bSFeng Tang }
73917d9290STim Chen #endif
74917d9290STim Chen 
75997071bcSK. Y. Srinivasan unsigned long vm_memory_committed(void);
76997071bcSK. Y. Srinivasan 
vm_acct_memory(long pages)771da177e4SLinus Torvalds static inline void vm_acct_memory(long pages)
781da177e4SLinus Torvalds {
79104b4e51SNikolay Borisov 	percpu_counter_add_batch(&vm_committed_as, pages, vm_committed_as_batch);
801da177e4SLinus Torvalds }
811da177e4SLinus Torvalds 
vm_unacct_memory(long pages)821da177e4SLinus Torvalds static inline void vm_unacct_memory(long pages)
831da177e4SLinus Torvalds {
841da177e4SLinus Torvalds 	vm_acct_memory(-pages);
851da177e4SLinus Torvalds }
861da177e4SLinus Torvalds 
871da177e4SLinus Torvalds /*
88b3fbbea4SKevin Brodsky  * Allow architectures to handle additional protection and flag bits. The
89b3fbbea4SKevin Brodsky  * overriding macros must be defined in the arch-specific asm/mman.h file.
90b845f313SDave Kleikamp  */
91b845f313SDave Kleikamp 
92b845f313SDave Kleikamp #ifndef arch_calc_vm_prot_bits
93e6bfb709SDave Hansen #define arch_calc_vm_prot_bits(prot, pkey) 0
94b845f313SDave Kleikamp #endif
95b845f313SDave Kleikamp 
96b3fbbea4SKevin Brodsky #ifndef arch_calc_vm_flag_bits
97b3fbbea4SKevin Brodsky #define arch_calc_vm_flag_bits(flags) 0
98b3fbbea4SKevin Brodsky #endif
99b3fbbea4SKevin Brodsky 
100b845f313SDave Kleikamp #ifndef arch_validate_prot
101b845f313SDave Kleikamp /*
102b845f313SDave Kleikamp  * This is called from mprotect().  PROT_GROWSDOWN and PROT_GROWSUP have
103b845f313SDave Kleikamp  * already been masked out.
104b845f313SDave Kleikamp  *
105b845f313SDave Kleikamp  * Returns true if the prot flags are valid
106b845f313SDave Kleikamp  */
arch_validate_prot(unsigned long prot,unsigned long addr)1079035cf9aSKhalid Aziz static inline bool arch_validate_prot(unsigned long prot, unsigned long addr)
108b845f313SDave Kleikamp {
109b845f313SDave Kleikamp 	return (prot & ~(PROT_READ | PROT_WRITE | PROT_EXEC | PROT_SEM)) == 0;
110b845f313SDave Kleikamp }
111b845f313SDave Kleikamp #define arch_validate_prot arch_validate_prot
112b845f313SDave Kleikamp #endif
113b845f313SDave Kleikamp 
114c462ac28SCatalin Marinas #ifndef arch_validate_flags
115c462ac28SCatalin Marinas /*
116c462ac28SCatalin Marinas  * This is called from mmap() and mprotect() with the updated vma->vm_flags.
117c462ac28SCatalin Marinas  *
118c462ac28SCatalin Marinas  * Returns true if the VM_* flags are valid.
119c462ac28SCatalin Marinas  */
arch_validate_flags(unsigned long flags)120c462ac28SCatalin Marinas static inline bool arch_validate_flags(unsigned long flags)
121c462ac28SCatalin Marinas {
122c462ac28SCatalin Marinas 	return true;
123c462ac28SCatalin Marinas }
124c462ac28SCatalin Marinas #define arch_validate_flags arch_validate_flags
125c462ac28SCatalin Marinas #endif
126c462ac28SCatalin Marinas 
127b845f313SDave Kleikamp /*
1281da177e4SLinus Torvalds  * Optimisation macro.  It is equivalent to:
1291da177e4SLinus Torvalds  *      (x & bit1) ? bit2 : 0
1301da177e4SLinus Torvalds  * but this version is faster.
1311da177e4SLinus Torvalds  * ("bit1" and "bit2" must be single bits)
1321da177e4SLinus Torvalds  */
1331da177e4SLinus Torvalds #define _calc_vm_trans(x, bit1, bit2) \
134592e2545SJan Kara   ((!(bit1) || !(bit2)) ? 0 : \
1351da177e4SLinus Torvalds   ((bit1) <= (bit2) ? ((x) & (bit1)) * ((bit2) / (bit1)) \
136592e2545SJan Kara    : ((x) & (bit1)) / ((bit1) / (bit2))))
1371da177e4SLinus Torvalds 
1381da177e4SLinus Torvalds /*
1391da177e4SLinus Torvalds  * Combine the mmap "prot" argument into "vm_flags" used internally.
1401da177e4SLinus Torvalds  */
1411da177e4SLinus Torvalds static inline unsigned long
calc_vm_prot_bits(unsigned long prot,unsigned long pkey)142e6bfb709SDave Hansen calc_vm_prot_bits(unsigned long prot, unsigned long pkey)
1431da177e4SLinus Torvalds {
1441da177e4SLinus Torvalds 	return _calc_vm_trans(prot, PROT_READ,  VM_READ ) |
1451da177e4SLinus Torvalds 	       _calc_vm_trans(prot, PROT_WRITE, VM_WRITE) |
146b845f313SDave Kleikamp 	       _calc_vm_trans(prot, PROT_EXEC,  VM_EXEC) |
147e6bfb709SDave Hansen 	       arch_calc_vm_prot_bits(prot, pkey);
1481da177e4SLinus Torvalds }
1491da177e4SLinus Torvalds 
1501da177e4SLinus Torvalds /*
1511da177e4SLinus Torvalds  * Combine the mmap "flags" argument into "vm_flags" used internally.
1521da177e4SLinus Torvalds  */
1531da177e4SLinus Torvalds static inline unsigned long
calc_vm_flag_bits(unsigned long flags)1541da177e4SLinus Torvalds calc_vm_flag_bits(unsigned long flags)
1551da177e4SLinus Torvalds {
1561da177e4SLinus Torvalds 	return _calc_vm_trans(flags, MAP_GROWSDOWN,  VM_GROWSDOWN ) |
157b6fb293fSJan Kara 	       _calc_vm_trans(flags, MAP_LOCKED,     VM_LOCKED    ) |
158b3fbbea4SKevin Brodsky 	       _calc_vm_trans(flags, MAP_SYNC,	     VM_SYNC      ) |
159b3fbbea4SKevin Brodsky 	       arch_calc_vm_flag_bits(flags);
1601da177e4SLinus Torvalds }
16100619bccSJerome Marchand 
16200619bccSJerome Marchand unsigned long vm_commit_limit(void);
163b507808eSJoey Gouly 
164a0071e3bSZev Weiss #ifndef arch_memory_deny_write_exec_supported
arch_memory_deny_write_exec_supported(void)165a0071e3bSZev Weiss static inline bool arch_memory_deny_write_exec_supported(void)
166a0071e3bSZev Weiss {
167a0071e3bSZev Weiss 	return true;
168a0071e3bSZev Weiss }
169a0071e3bSZev Weiss #define arch_memory_deny_write_exec_supported arch_memory_deny_write_exec_supported
170a0071e3bSZev Weiss #endif
171a0071e3bSZev Weiss 
172b507808eSJoey Gouly /*
173b507808eSJoey Gouly  * Denies creating a writable executable mapping or gaining executable permissions.
174b507808eSJoey Gouly  *
175b507808eSJoey Gouly  * This denies the following:
176b507808eSJoey Gouly  *
177b507808eSJoey Gouly  * 	a)	mmap(PROT_WRITE | PROT_EXEC)
178b507808eSJoey Gouly  *
179b507808eSJoey Gouly  *	b)	mmap(PROT_WRITE)
180b507808eSJoey Gouly  *		mprotect(PROT_EXEC)
181b507808eSJoey Gouly  *
182b507808eSJoey Gouly  *	c)	mmap(PROT_WRITE)
183b507808eSJoey Gouly  *		mprotect(PROT_READ)
184b507808eSJoey Gouly  *		mprotect(PROT_EXEC)
185b507808eSJoey Gouly  *
186b507808eSJoey Gouly  * But allows the following:
187b507808eSJoey Gouly  *
188b507808eSJoey Gouly  *	d)	mmap(PROT_READ | PROT_EXEC)
189b507808eSJoey Gouly  *		mmap(PROT_READ | PROT_EXEC | PROT_BTI)
190b507808eSJoey Gouly  */
map_deny_write_exec(struct vm_area_struct * vma,unsigned long vm_flags)191b507808eSJoey Gouly static inline bool map_deny_write_exec(struct vm_area_struct *vma,  unsigned long vm_flags)
192b507808eSJoey Gouly {
193b507808eSJoey Gouly 	if (!test_bit(MMF_HAS_MDWE, &current->mm->flags))
194b507808eSJoey Gouly 		return false;
195b507808eSJoey Gouly 
196b507808eSJoey Gouly 	if ((vm_flags & VM_EXEC) && (vm_flags & VM_WRITE))
197b507808eSJoey Gouly 		return true;
198b507808eSJoey Gouly 
199b507808eSJoey Gouly 	if (!(vma->vm_flags & VM_EXEC) && (vm_flags & VM_EXEC))
200b507808eSJoey Gouly 		return true;
201b507808eSJoey Gouly 
202b507808eSJoey Gouly 	return false;
203b507808eSJoey Gouly }
204b507808eSJoey Gouly 
2051da177e4SLinus Torvalds #endif /* _LINUX_MMAN_H */
206