1/* Memory-mapping-related declarations/definitions, not architecture-specific.
2 Copyright (C) 2017-2026 Free Software Foundation, Inc.
3 This file is part of the GNU C Library.
4
5 The GNU C Library is free software; you can redistribute it and/or
6 modify it under the terms of the GNU Lesser General Public
7 License as published by the Free Software Foundation; either
8 version 2.1 of the License, or (at your option) any later version.
9
10 The GNU C Library is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 Lesser General Public License for more details.
14
15 You should have received a copy of the GNU Lesser General Public
16 License along with the GNU C Library; if not, see
17 <https://www.gnu.org/licenses/>. */
18
19#ifndef _SYS_MMAN_H
20# error "Never use <bits/mman-shared.h> directly; include <sys/mman.h> instead."
21#endif
22
23#ifdef __USE_GNU
24/* Flags for mremap. */
25# define MREMAP_MAYMOVE 1
26# define MREMAP_FIXED 2
27# define MREMAP_DONTUNMAP 4
28
29/* Flags for memfd_create. */
30# ifndef MFD_CLOEXEC
31# define MFD_CLOEXEC 1U
32# define MFD_ALLOW_SEALING 2U
33# define MFD_HUGETLB 4U
34# endif
35# ifndef MFD_NOEXEC_SEAL
36# define MFD_NOEXEC_SEAL 8U
37# define MFD_EXEC 0x10U
38# endif
39
40/* Flags for mlock2. */
41# ifndef MLOCK_ONFAULT
42# define MLOCK_ONFAULT 1U
43# endif
44
45/* Access restrictions for pkey_alloc. */
46# define PKEY_UNRESTRICTED 0x0
47# define PKEY_DISABLE_ACCESS 0x1
48# define PKEY_DISABLE_WRITE 0x2
49
50__BEGIN_DECLS
51
52// zig patch: check target glibc version
53# if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 27) || __GLIBC__ > 2
54
55/* Create a new memory file descriptor. NAME is a name for debugging.
56 FLAGS is a combination of the MFD_* constants. */
57int memfd_create (const char *__name, unsigned int __flags) __THROW;
58
59/* Lock pages from ADDR (inclusive) to ADDR + LENGTH (exclusive) into
60 memory. FLAGS is a combination of the MLOCK_* flags above. */
61int mlock2 (const void *__addr, size_t __length, unsigned int __flags) __THROW
62 __attr_access_none (1);
63
64#endif /* if (__GLIBC__ == 2 && __GLIBC_MINOR__ >= 27) || __GLIBC__ > 2 */
65
66/* Allocate a new protection key, with the PKEY_DISABLE_* bits
67 specified in ACCESS_RESTRICTIONS. The protection key mask for the
68 current thread is updated to match the access privilege for the new
69 key. */
70int pkey_alloc (unsigned int __flags, unsigned int __access_restrictions) __THROW;
71
72/* Update the access restrictions for the current thread for KEY, which must
73 have been allocated using pkey_alloc. */
74int pkey_set (int __key, unsigned int __access_restrictions) __THROW;
75
76/* Return the access restrictions for the current thread for KEY, which must
77 have been allocated using pkey_alloc. */
78int pkey_get (int __key) __THROW;
79
80/* Free an allocated protection key, which must have been allocated
81 using pkey_alloc. */
82int pkey_free (int __key) __THROW;
83
84/* Apply memory protection flags for KEY to the specified address
85 range. */
86int pkey_mprotect (void *__addr, size_t __len, int __prot, int __pkey) __THROW;
87
88/* Seal the address range to avoid further modifications, such as remapping to
89 shrink or expand the VMA, changing protection permission with mprotect,
90 unmap with munmap, or destructive semantics such as madvise with
91 MADV_DONTNEED.
92
93 The address range must be a valid VMA, without any gaps (unallocated
94 memory) between the start and end, and ADDR must be page-aligned (LEN will
95 be page-aligned implicitly). */
96int mseal (void *__addr, size_t __len, unsigned long flags) __THROW;
97
98__END_DECLS
99
100#endif /* __USE_GNU */