]> git.saurik.com Git - apple/xnu.git/blobdiff - bsd/sys/mman.h
xnu-6153.121.1.tar.gz
[apple/xnu.git] / bsd / sys / mman.h
index d7469fbf339c13994b06cb51c1165395ef7a2041..abe0b93c05dab6ffa1dbdd05f7fd107abd0451b1 100644 (file)
@@ -1,8 +1,8 @@
 /*
- * Copyright (c) 2000-2002 Apple Computer, Inc. All rights reserved.
+ * Copyright (c) 2000-2019 Apple Computer, Inc. All rights reserved.
  *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
- * 
+ *
  * This file contains Original Code and/or Modifications of Original Code
  * as defined in and that are subject to the Apple Public Source License
  * Version 2.0 (the 'License'). You may not use this file except in
  * unlawful or unlicensed copies of an Apple operating system, or to
  * circumvent, violate, or enable the circumvention or violation of, any
  * terms of an Apple operating system software license agreement.
- * 
+ *
  * Please obtain a copy of the License at
  * http://www.opensource.apple.com/apsl/ and read it before using this file.
- * 
+ *
  * The Original Code and all software distributed under the License are
  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
@@ -22,7 +22,7 @@
  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  * Please see the License for the specific language governing rights and
  * limitations under the License.
- * 
+ *
  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
  */
 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
@@ -73,7 +73,7 @@
  * [TYM]       posix_typed_mem_open()
  */
 
-#ifndef        _SYS_MMAN_H_
+#ifndef _SYS_MMAN_H_
 #define _SYS_MMAN_H_
 
 #include <sys/appleapiopts.h>
 /*
  * Protections are chosen from these bits, or-ed together
  */
-#define        PROT_NONE       0x00    /* [MC2] no permissions */
-#define        PROT_READ       0x01    /* [MC2] pages can be read */
-#define        PROT_WRITE      0x02    /* [MC2] pages can be written */
-#define        PROT_EXEC       0x04    /* [MC2] pages can be executed */
+#define PROT_NONE       0x00    /* [MC2] no permissions */
+#define PROT_READ       0x01    /* [MC2] pages can be read */
+#define PROT_WRITE      0x02    /* [MC2] pages can be written */
+#define PROT_EXEC       0x04    /* [MC2] pages can be executed */
 
 /*
  * Flags contain sharing type and options.
  * Sharing types; choose one.
  */
-#define        MAP_SHARED      0x0001          /* [MF|SHM] share changes */
-#define        MAP_PRIVATE     0x0002          /* [MF|SHM] changes are private */
+#define MAP_SHARED      0x0001          /* [MF|SHM] share changes */
+#define MAP_PRIVATE     0x0002          /* [MF|SHM] changes are private */
 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
-#define        MAP_COPY        MAP_PRIVATE     /* Obsolete */
-#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+#define MAP_COPY        MAP_PRIVATE     /* Obsolete */
+#endif  /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
 
 /*
  * Other flags
  */
-#define        MAP_FIXED        0x0010 /* [MF|SHM] interpret addr exactly */
+#define MAP_FIXED        0x0010 /* [MF|SHM] interpret addr exactly */
 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
-#define        MAP_RENAME       0x0020 /* Sun: rename private pages to file */
-#define        MAP_NORESERVE    0x0040 /* Sun: don't reserve needed swap area */
-#define        MAP_RESERVED0080 0x0080 /* previously unimplemented MAP_INHERIT */
-#define        MAP_NOEXTEND     0x0100 /* for MAP_FILE, don't change file size */
-#define        MAP_HASSEMAPHORE 0x0200 /* region may contain semaphores */
-#define MAP_NOCACHE     0x0400 /* don't cache pages for this mapping */
-#define MAP_JIT                 0x0800 /* Allocate a region that will be used for JIT purposes */
-#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+#define MAP_RENAME       0x0020 /* Sun: rename private pages to file */
+#define MAP_NORESERVE    0x0040 /* Sun: don't reserve needed swap area */
+#define MAP_RESERVED0080 0x0080 /* previously unimplemented MAP_INHERIT */
+#define MAP_NOEXTEND     0x0100 /* for MAP_FILE, don't change file size */
+#define MAP_HASSEMAPHORE 0x0200 /* region may contain semaphores */
+#define MAP_NOCACHE      0x0400 /* don't cache pages for this mapping */
+#define MAP_JIT          0x0800 /* Allocate a region that will be used for JIT purposes */
+
+/*
+ * Mapping type
+ */
+#define MAP_FILE        0x0000  /* map from file (default) */
+#define MAP_ANON        0x1000  /* allocated from memory, swap space */
+#define MAP_ANONYMOUS   MAP_ANON
+
+/*
+ * The MAP_RESILIENT_* flags can be used when the caller wants to map some
+ * possibly unreliable memory and be able to access it safely, possibly
+ * getting the wrong contents rather than raising any exception.
+ * For safety reasons, such mappings have to be read-only (PROT_READ access
+ * only).
+ *
+ * MAP_RESILIENT_CODESIGN:
+ *      accessing this mapping will not generate code-signing violations,
+ *     even if the contents are tainted.
+ * MAP_RESILIENT_MEDIA:
+ *     accessing this mapping will not generate an exception if the contents
+ *     are not available (unreachable removable or remote media, access beyond
+ *     end-of-file, ...).  Missing contents will be replaced with zeroes.
+ */
+#define MAP_RESILIENT_CODESIGN  0x2000 /* no code-signing failures */
+#define MAP_RESILIENT_MEDIA     0x4000 /* no backing-store failures */
+
+#if !defined(CONFIG_EMBEDDED)
+#define MAP_32BIT       0x8000          /* Return virtual addresses <4G only: Requires entitlement */
+#endif  /* !defined(CONFIG_EMBEDDED) */
+
+#endif  /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
 
 /*
  * Process memory locking
  */
-#define MCL_CURRENT    0x0001  /* [ML] Lock only current memory */
-#define MCL_FUTURE     0x0002  /* [ML] Lock all future memory as well */
+#define MCL_CURRENT     0x0001  /* [ML] Lock only current memory */
+#define MCL_FUTURE      0x0002  /* [ML] Lock all future memory as well */
 
 /*
  * Error return from mmap()
  */
-#define MAP_FAILED     ((void *)-1)    /* [MF|SHM] mmap failed */
+#define MAP_FAILED      ((void *)-1)    /* [MF|SHM] mmap failed */
 
 /*
  * msync() flags
  */
-#define MS_ASYNC       0x0001  /* [MF|SIO] return immediately */
-#define MS_INVALIDATE  0x0002  /* [MF|SIO] invalidate all cached data */
-#define        MS_SYNC         0x0010  /* [MF|SIO] msync synchronously */
+#define MS_ASYNC        0x0001  /* [MF|SIO] return immediately */
+#define MS_INVALIDATE   0x0002  /* [MF|SIO] invalidate all cached data */
+#define MS_SYNC         0x0010  /* [MF|SIO] msync synchronously */
 
 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
 #define MS_KILLPAGES    0x0004  /* invalidate pages, leave mapped */
 #define MS_DEACTIVATE   0x0008  /* deactivate pages, leave mapped */
 
-/*
- * Mapping type
- */
-#define        MAP_FILE        0x0000  /* map from file (default) */
-#define        MAP_ANON        0x1000  /* allocated from memory, swap space */
-#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+#endif  /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
 
 
 /*
  * Advice to madvise
  */
-#define        POSIX_MADV_NORMAL       0       /* [MC1] no further special treatment */
-#define        POSIX_MADV_RANDOM       1       /* [MC1] expect random page refs */
-#define        POSIX_MADV_SEQUENTIAL   2       /* [MC1] expect sequential page refs */
-#define        POSIX_MADV_WILLNEED     3       /* [MC1] will need these pages */
-#define        POSIX_MADV_DONTNEED     4       /* [MC1] dont need these pages */
+#define POSIX_MADV_NORMAL       0       /* [MC1] no further special treatment */
+#define POSIX_MADV_RANDOM       1       /* [MC1] expect random page refs */
+#define POSIX_MADV_SEQUENTIAL   2       /* [MC1] expect sequential page refs */
+#define POSIX_MADV_WILLNEED     3       /* [MC1] will need these pages */
+#define POSIX_MADV_DONTNEED     4       /* [MC1] dont need these pages */
 
 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
-#define        MADV_NORMAL             POSIX_MADV_NORMAL
-#define        MADV_RANDOM             POSIX_MADV_RANDOM
-#define        MADV_SEQUENTIAL         POSIX_MADV_SEQUENTIAL
-#define        MADV_WILLNEED           POSIX_MADV_WILLNEED
-#define        MADV_DONTNEED           POSIX_MADV_DONTNEED
-#define        MADV_FREE               5       /* pages unneeded, discard contents */
-#define        MADV_ZERO_WIRED_PAGES   6       /* zero the wired pages that have not been unwired before the entry is deleted */
-#define MADV_FREE_REUSABLE     7       /* pages can be reused (by anyone) */
-#define MADV_FREE_REUSE                8       /* caller wants to reuse those pages */
-#define MADV_CAN_REUSE         9
+#define MADV_NORMAL             POSIX_MADV_NORMAL
+#define MADV_RANDOM             POSIX_MADV_RANDOM
+#define MADV_SEQUENTIAL         POSIX_MADV_SEQUENTIAL
+#define MADV_WILLNEED           POSIX_MADV_WILLNEED
+#define MADV_DONTNEED           POSIX_MADV_DONTNEED
+#define MADV_FREE               5       /* pages unneeded, discard contents */
+#define MADV_ZERO_WIRED_PAGES   6       /* zero the wired pages that have not been unwired before the entry is deleted */
+#define MADV_FREE_REUSABLE      7       /* pages can be reused (by anyone) */
+#define MADV_FREE_REUSE         8       /* caller wants to reuse those pages */
+#define MADV_CAN_REUSE          9
+#define MADV_PAGEOUT            10      /* page out now (internal only) */
 
 /*
  * Return bits from mincore
  */
-#define        MINCORE_INCORE           0x1     /* Page is incore */
-#define        MINCORE_REFERENCED       0x2     /* Page has been referenced by us */
-#define        MINCORE_MODIFIED         0x4     /* Page has been modified by us */
-#define        MINCORE_REFERENCED_OTHER 0x8     /* Page has been referenced */
-#define        MINCORE_MODIFIED_OTHER  0x10     /* Page has been modified */
-#endif /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
+#define MINCORE_INCORE           0x1     /* Page is incore */
+#define MINCORE_REFERENCED       0x2     /* Page has been referenced by us */
+#define MINCORE_MODIFIED         0x4     /* Page has been modified by us */
+#define MINCORE_REFERENCED_OTHER 0x8     /* Page has been referenced */
+#define MINCORE_MODIFIED_OTHER  0x10     /* Page has been modified */
+#define MINCORE_PAGED_OUT       0x20     /* Page has been paged out */
+#define MINCORE_COPIED          0x40     /* Page has been copied */
+#define MINCORE_ANONYMOUS       0x80     /* Page belongs to an anonymous object */
+#endif  /* (!_POSIX_C_SOURCE || _DARWIN_C_SOURCE) */
 
 
 #ifndef KERNEL
 
 __BEGIN_DECLS
 /* [ML] */
-int    mlockall(int);
-int    munlockall(void);
+int     mlockall(int);
+int     munlockall(void);
 /* [MR] */
-int    mlock(const void *, size_t);
+int     mlock(const void *, size_t);
 #ifndef _MMAP
-#define        _MMAP
+#define _MMAP
 /* [MC3]*/
-void * mmap(void *, size_t, int, int, int, off_t) __DARWIN_ALIAS(mmap);
+void *  mmap(void *, size_t, int, int, int, off_t) __DARWIN_ALIAS(mmap);
 #endif
 /* [MPR] */
-int    mprotect(void *, size_t, int) __DARWIN_ALIAS(mprotect);
+int     mprotect(void *, size_t, int) __DARWIN_ALIAS(mprotect);
 /* [MF|SIO] */
-int    msync(void *, size_t, int) __DARWIN_ALIAS_C(msync);
+int     msync(void *, size_t, int) __DARWIN_ALIAS_C(msync);
 /* [MR] */
-int    munlock(const void *, size_t);
+int     munlock(const void *, size_t);
 /* [MC3]*/
-int    munmap(void *, size_t) __DARWIN_ALIAS(munmap);
+int     munmap(void *, size_t) __DARWIN_ALIAS(munmap);
 /* [SHM] */
-int    shm_open(const char *, int, ...);
-int    shm_unlink(const char *);
+int     shm_open(const char *, int, ...);
+int     shm_unlink(const char *);
 /* [ADV] */
-int    posix_madvise(void *, size_t, int);
+int     posix_madvise(void *, size_t, int);
 
 #if !defined(_POSIX_C_SOURCE) || defined(_DARWIN_C_SOURCE)
-int    madvise(void *, size_t, int);
-int    mincore(const void *, size_t, char *);
-int    minherit(void *, size_t, int);
+int     madvise(void *, size_t, int);
+int     mincore(const void *, size_t, char *);
+int     minherit(void *, size_t, int);
 #endif
+
+#ifdef PRIVATE
+int mremap_encrypted(void *, size_t, __uint32_t, __uint32_t, __uint32_t);
+#endif
+
 __END_DECLS
 
-#else  /* KERNEL */
+#else   /* KERNEL */
 #ifdef XNU_KERNEL_PRIVATE
-void pshm_cache_init(void);    /* for bsd_init() */
+void pshm_cache_init(void);     /* for bsd_init() */
 void pshm_lock_init(void);
 
 /*
@@ -229,7 +263,7 @@ void pshm_lock_init(void);
 struct mmap_args;
 struct fileproc;
 int pshm_mmap(struct proc *p, struct mmap_args *uap, user_addr_t *retval,
-               struct fileproc *fp, off_t pageoff);
+    struct fileproc *fp, off_t pageoff);
 /* Really need to overhaul struct fileops to avoid this... */
 struct pshmnode;
 struct stat;