2 * Copyright (c) 2007-2019 Apple Inc. All Rights Reserved.
4 * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. The rights granted to you under the License
10 * may not be used to create, or enable the creation or redistribution of,
11 * unlawful or unlicensed copies of an Apple operating system, or to
12 * circumvent, violate, or enable the circumvention or violation of, any
13 * terms of an Apple operating system software license agreement.
15 * Please obtain a copy of the License at
16 * http://www.opensource.apple.com/apsl/ and read it before using this file.
18 * The Original Code and all software distributed under the License are
19 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23 * Please see the License for the specific language governing rights and
24 * limitations under the License.
26 * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
29 * Copyright (c) 1988 University of Utah.
30 * Copyright (c) 1991, 1993
31 * The Regents of the University of California. All rights reserved.
33 * This code is derived from software contributed to Berkeley by
34 * the Systems Programming Group of the University of Utah Computer
37 * Redistribution and use in source and binary forms, with or without
38 * modification, are permitted provided that the following conditions
40 * 1. Redistributions of source code must retain the above copyright
41 * notice, this list of conditions and the following disclaimer.
42 * 2. Redistributions in binary form must reproduce the above copyright
43 * notice, this list of conditions and the following disclaimer in the
44 * documentation and/or other materials provided with the distribution.
45 * 3. All advertising materials mentioning features or use of this software
46 * must display the following acknowledgement:
47 * This product includes software developed by the University of
48 * California, Berkeley and its contributors.
49 * 4. Neither the name of the University nor the names of its contributors
50 * may be used to endorse or promote products derived from this software
51 * without specific prior written permission.
53 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
54 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
55 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
56 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
57 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
58 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
59 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
60 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
61 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
62 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
65 * from: Utah $Hdr: vm_mmap.c 1.6 91/10/21$
67 * @(#)vm_mmap.c 8.10 (Berkeley) 2/19/95
70 * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
71 * support for mandatory and extensible security protections. This notice
72 * is included in support of clause 2.2 (b) of the Apple Public License,
77 * Mapped file (mmap) interface to VM
80 #include <sys/param.h>
81 #include <sys/systm.h>
82 #include <sys/filedesc.h>
83 #include <sys/proc_internal.h>
84 #include <sys/kauth.h>
85 #include <sys/resourcevar.h>
86 #include <sys/vnode_internal.h>
89 #include <sys/file_internal.h>
90 #include <sys/vadvise.h>
91 #include <sys/trace.h>
96 #include <sys/ubc_internal.h>
97 #include <sys/sysproto.h>
99 #include <sys/syscall.h>
100 #include <sys/kdebug.h>
101 #include <sys/bsdtask_info.h>
103 #include <security/audit/audit.h>
104 #include <bsm/audit_kevents.h>
106 #include <mach/mach_types.h>
107 #include <mach/mach_traps.h>
108 #include <mach/vm_sync.h>
109 #include <mach/vm_behavior.h>
110 #include <mach/vm_inherit.h>
111 #include <mach/vm_statistics.h>
112 #include <mach/mach_vm.h>
113 #include <mach/vm_map.h>
114 #include <mach/host_priv.h>
115 #include <mach/sdt.h>
117 #include <machine/machine_routines.h>
119 #include <kern/cpu_number.h>
120 #include <kern/host.h>
121 #include <kern/task.h>
122 #include <kern/page_decrypt.h>
124 #include <IOKit/IOReturn.h>
126 #include <vm/vm_map.h>
127 #include <vm/vm_kern.h>
128 #include <vm/vm_pager.h>
129 #include <vm/vm_protos.h>
132 #include <security/mac_framework.h>
134 #include <os/overflow.h>
136 #ifndef CONFIG_EMBEDDED
137 #include <IOKit/IOBSD.h> /* for IOTaskHasEntitlement */
138 #include <sys/csr.h> /* for csr_check */
139 #define MAP_32BIT_ENTITLEMENT "com.apple.security.mmap-map-32bit"
143 * XXX Internally, we use VM_PROT_* somewhat interchangeably, but the correct
144 * XXX usage is PROT_* from an interface perspective. Thus the values of
145 * XXX VM_PROT_* and PROT_* need to correspond.
148 mmap(proc_t p
, struct mmap_args
*uap
, user_addr_t
*retval
)
151 * Map in special device (must be SHARED) or file
159 kern_return_t result
;
160 vm_map_offset_t user_addr
;
162 vm_map_size_t user_size
;
163 vm_object_offset_t pageoff
;
164 vm_object_offset_t file_pos
;
166 vm_tag_t tag
= VM_KERN_MEMORY_NONE
;
167 vm_map_kernel_flags_t vmk_flags
= VM_MAP_KERNEL_FLAGS_NONE
;
171 memory_object_t pager
= MEMORY_OBJECT_NULL
;
172 memory_object_control_t control
;
180 * Note that for UNIX03 conformance, there is additional parameter checking for
181 * mmap() system call in libsyscall prior to entering the kernel. The sanity
182 * checks and argument validation done in this function are not the only places
183 * one can get returned errnos.
186 user_map
= current_map();
187 user_addr
= (vm_map_offset_t
)uap
->addr
;
188 user_size
= (vm_map_size_t
) uap
->len
;
190 AUDIT_ARG(addr
, user_addr
);
191 AUDIT_ARG(len
, user_size
);
192 AUDIT_ARG(fd
, uap
->fd
);
194 if (vm_map_range_overflows(user_addr
, user_size
)) {
197 prot
= (uap
->prot
& VM_PROT_ALL
);
200 * Since the hardware currently does not support writing without
201 * read-before-write, or execution-without-read, if the request is
202 * for write or execute access, we must imply read access as well;
203 * otherwise programs expecting this to work will fail to operate.
205 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
206 prot
|= VM_PROT_READ
;
208 #endif /* radar 3777787 */
214 * The vm code does not have prototypes & compiler doesn't do
215 * the right thing when you cast 64bit value and pass it in function
216 * call. So here it is.
218 file_pos
= (vm_object_offset_t
)uap
->pos
;
221 /* make sure mapping fits into numeric range etc */
222 if (os_add3_overflow(file_pos
, user_size
, PAGE_SIZE_64
- 1, &sum
)) {
227 * Align the file position to a page boundary,
228 * and save its page offset component.
230 pageoff
= (file_pos
& vm_map_page_mask(user_map
));
231 file_pos
-= (vm_object_offset_t
)pageoff
;
234 /* Adjust size for rounding (on both ends). */
235 user_size
+= pageoff
; /* low end... */
236 user_size
= vm_map_round_page(user_size
,
237 vm_map_page_mask(user_map
)); /* hi end */
239 if (flags
& MAP_JIT
) {
240 if ((flags
& MAP_FIXED
) ||
241 (flags
& MAP_SHARED
) ||
242 !(flags
& MAP_ANON
) ||
243 (flags
& MAP_RESILIENT_CODESIGN
) ||
244 (flags
& MAP_RESILIENT_MEDIA
)) {
249 if ((flags
& MAP_RESILIENT_CODESIGN
) ||
250 (flags
& MAP_RESILIENT_MEDIA
)) {
251 if ((flags
& MAP_ANON
) ||
256 if (flags
& MAP_RESILIENT_CODESIGN
) {
257 if (prot
& (VM_PROT_WRITE
| VM_PROT_EXECUTE
)) {
261 if (flags
& MAP_SHARED
) {
263 * MAP_RESILIENT_MEDIA is not valid with MAP_SHARED because
264 * there is no place to inject zero-filled pages without
265 * actually adding them to the file.
266 * Since we didn't reject that combination before, there might
267 * already be callers using it and getting a valid MAP_SHARED
268 * mapping but without the resilience.
269 * For backwards compatibility's sake, let's keep ignoring
270 * MAP_RESILIENT_MEDIA in that case.
272 flags
&= ~MAP_RESILIENT_MEDIA
;
274 if (flags
& MAP_RESILIENT_MEDIA
) {
275 if ((flags
& MAP_ANON
) ||
276 (flags
& MAP_SHARED
)) {
282 * Check for illegal addresses. Watch out for address wrap... Note
283 * that VM_*_ADDRESS are not constants due to casts (argh).
285 if (flags
& MAP_FIXED
) {
287 * The specified address must have the same remainder
288 * as the file offset taken modulo PAGE_SIZE, so it
289 * should be aligned after adjustment by pageoff.
291 user_addr
-= pageoff
;
292 if (user_addr
& vm_map_page_mask(user_map
)) {
297 /* DO not have apis to get this info, need to wait till then*/
299 * XXX for non-fixed mappings where no hint is provided or
300 * the hint would fall in the potential heap space,
301 * place it after the end of the largest possible heap.
303 * There should really be a pmap call to determine a reasonable
306 else if (addr
< vm_map_round_page(p
->p_vmspace
->vm_daddr
+ MAXDSIZ
,
307 vm_map_page_mask(user_map
))) {
308 addr
= vm_map_round_page(p
->p_vmspace
->vm_daddr
+ MAXDSIZ
,
309 vm_map_page_mask(user_map
));
316 if (flags
& MAP_ANON
) {
317 maxprot
= VM_PROT_ALL
;
322 error
= mac_proc_check_map_anon(p
, user_addr
, user_size
, prot
, flags
, &maxprot
);
329 * Mapping blank space is trivial. Use positive fds as the alias
330 * value for memory tracking.
334 * Use "fd" to pass (some) Mach VM allocation flags,
335 * (see the VM_FLAGS_* definitions).
337 alloc_flags
= fd
& (VM_FLAGS_ALIAS_MASK
|
338 VM_FLAGS_SUPERPAGE_MASK
|
341 if (alloc_flags
!= fd
) {
342 /* reject if there are any extra flags */
345 VM_GET_FLAGS_ALIAS(alloc_flags
, tag
);
346 alloc_flags
&= ~VM_FLAGS_ALIAS_MASK
;
353 struct vnode_attr va
;
354 vfs_context_t ctx
= vfs_context_current();
356 if (flags
& MAP_JIT
) {
361 * Mapping file, get fp for validation. Obtain vnode and make
362 * sure it is of appropriate type.
364 err
= fp_lookup(p
, fd
, &fp
, 0);
369 switch (FILEGLOB_DTYPE(fp
->f_fglob
)) {
371 uap
->addr
= (user_addr_t
)user_addr
;
372 uap
->len
= (user_size_t
)user_size
;
376 error
= pshm_mmap(p
, uap
, retval
, fp
, (off_t
)pageoff
);
384 vp
= (struct vnode
*)fp
->f_fglob
->fg_data
;
385 error
= vnode_getwithref(vp
);
390 if (vp
->v_type
!= VREG
&& vp
->v_type
!= VCHR
) {
396 AUDIT_ARG(vnpath
, vp
, ARG_VNODE1
);
399 * POSIX: mmap needs to update access time for mapped files
401 if ((vnode_vfsvisflags(vp
) & MNT_NOATIME
) == 0) {
403 nanotime(&va
.va_access_time
);
404 VATTR_SET_ACTIVE(&va
, va_access_time
);
405 vnode_setattr(vp
, &va
, ctx
);
409 * XXX hack to handle use of /dev/zero to map anon memory (ala
412 if (vp
->v_type
== VCHR
|| vp
->v_type
== VSTR
) {
418 * Ensure that file and memory protections are
419 * compatible. Note that we only worry about
420 * writability if mapping is shared; in this case,
421 * current and max prot are dictated by the open file.
422 * XXX use the vnode instead? Problem is: what
423 * credentials do we use for determination? What if
424 * proc does a setuid?
426 maxprot
= VM_PROT_EXECUTE
; /* ??? */
427 if (fp
->f_fglob
->fg_flag
& FREAD
) {
428 maxprot
|= VM_PROT_READ
;
429 } else if (prot
& PROT_READ
) {
435 * If we are sharing potential changes (either via
436 * MAP_SHARED or via the implicit sharing of character
437 * device mappings), and we are trying to get write
438 * permission although we opened it without asking
442 if ((flags
& MAP_SHARED
) != 0) {
443 if ((fp
->f_fglob
->fg_flag
& FWRITE
) != 0 &&
445 * Do not allow writable mappings of
446 * swap files (see vm_swapfile_pager.c).
450 * check for write access
452 * Note that we already made this check when granting FWRITE
453 * against the file, so it seems redundant here.
455 error
= vnode_authorize(vp
, NULL
, KAUTH_VNODE_CHECKIMMUTABLE
, ctx
);
457 /* if not granted for any reason, but we wanted it, bad */
458 if ((prot
& PROT_WRITE
) && (error
!= 0)) {
463 /* if writable, remember */
465 maxprot
|= VM_PROT_WRITE
;
467 } else if ((prot
& PROT_WRITE
) != 0) {
473 maxprot
|= VM_PROT_WRITE
;
478 error
= mac_file_check_mmap(vfs_context_ucred(ctx
),
479 fp
->f_fglob
, prot
, flags
, file_pos
, &maxprot
);
486 * Consult the file system to determine if this
487 * particular file object can be mapped.
489 error
= VNOP_MMAP_CHECK(vp
, prot
, ctx
);
497 * No copy-on-read for mmap() mappings themselves.
499 vmk_flags
.vmkf_no_copy_on_read
= 1;
502 if (user_size
== 0) {
511 * We bend a little - round the start and end addresses
512 * to the nearest page boundary.
514 user_size
= vm_map_round_page(user_size
,
515 vm_map_page_mask(user_map
));
517 if (file_pos
& vm_map_page_mask(user_map
)) {
525 if ((flags
& MAP_FIXED
) == 0) {
526 alloc_flags
|= VM_FLAGS_ANYWHERE
;
527 user_addr
= vm_map_round_page(user_addr
,
528 vm_map_page_mask(user_map
));
530 if (user_addr
!= vm_map_trunc_page(user_addr
,
531 vm_map_page_mask(user_map
))) {
539 * mmap(MAP_FIXED) will replace any existing mappings in the
540 * specified range, if the new mapping is successful.
541 * If we just deallocate the specified address range here,
542 * another thread might jump in and allocate memory in that
543 * range before we get a chance to establish the new mapping,
544 * and we won't have a chance to restore the old mappings.
545 * So we use VM_FLAGS_OVERWRITE to let Mach VM know that it
546 * has to deallocate the existing mappings and establish the
547 * new ones atomically.
549 alloc_flags
|= VM_FLAGS_FIXED
| VM_FLAGS_OVERWRITE
;
552 if (flags
& MAP_NOCACHE
) {
553 alloc_flags
|= VM_FLAGS_NO_CACHE
;
556 if (flags
& MAP_JIT
) {
557 vmk_flags
.vmkf_map_jit
= TRUE
;
560 if (flags
& MAP_RESILIENT_CODESIGN
) {
561 alloc_flags
|= VM_FLAGS_RESILIENT_CODESIGN
;
563 if (flags
& MAP_RESILIENT_MEDIA
) {
564 alloc_flags
|= VM_FLAGS_RESILIENT_MEDIA
;
567 #ifndef CONFIG_EMBEDDED
568 if (flags
& MAP_32BIT
) {
569 if (csr_check(CSR_ALLOW_UNTRUSTED_KEXTS
) == 0 ||
570 IOTaskHasEntitlement(current_task(), MAP_32BIT_ENTITLEMENT
)) {
571 vmk_flags
.vmkf_32bit_map_va
= TRUE
;
580 * Lookup/allocate object.
582 if (handle
== NULL
) {
586 #if defined(VM_PROT_READ_IS_EXEC)
587 if (prot
& VM_PROT_READ
) {
588 prot
|= VM_PROT_EXECUTE
;
590 if (maxprot
& VM_PROT_READ
) {
591 maxprot
|= VM_PROT_EXECUTE
;
597 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
598 prot
|= VM_PROT_READ
;
600 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
601 maxprot
|= VM_PROT_READ
;
603 #endif /* radar 3777787 */
605 result
= vm_map_enter_mem_object(user_map
,
606 &user_addr
, user_size
,
607 0, alloc_flags
, vmk_flags
,
609 IPC_PORT_NULL
, 0, FALSE
,
611 (flags
& MAP_SHARED
) ?
615 /* If a non-binding address was specified for this anonymous
616 * mapping, retry the mapping with a zero base
617 * in the event the mapping operation failed due to
618 * lack of space between the address and the map's maximum.
620 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
621 user_addr
= vm_map_page_size(user_map
);
625 if (vnode_isswap(vp
)) {
627 * Map swap files with a special pager
628 * that returns obfuscated contents.
631 pager
= swapfile_pager_setup(vp
);
632 if (pager
!= MEMORY_OBJECT_NULL
) {
633 control
= swapfile_pager_control(pager
);
636 control
= ubc_getobject(vp
, UBC_FLAGS_NONE
);
639 if (control
== NULL
) {
647 * FIXME: if we're writing the file we need a way to
648 * ensure that someone doesn't replace our R/W creds
649 * with ones that only work for read.
652 ubc_setthreadcred(vp
, p
, current_thread());
654 if ((flags
& (MAP_ANON
| MAP_SHARED
)) == 0) {
660 #if defined(VM_PROT_READ_IS_EXEC)
661 if (prot
& VM_PROT_READ
) {
662 prot
|= VM_PROT_EXECUTE
;
664 if (maxprot
& VM_PROT_READ
) {
665 maxprot
|= VM_PROT_EXECUTE
;
671 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
672 prot
|= VM_PROT_READ
;
674 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
675 maxprot
|= VM_PROT_READ
;
677 #endif /* radar 3777787 */
680 if (flags
& MAP_RESILIENT_CODESIGN
) {
681 if (prot
& (VM_PROT_WRITE
| VM_PROT_EXECUTE
)) {
687 /* strictly limit access to "prot" */
691 vm_object_offset_t end_pos
= 0;
692 if (os_add_overflow(user_size
, file_pos
, &end_pos
)) {
698 result
= vm_map_enter_mem_object_control(user_map
,
699 &user_addr
, user_size
,
700 0, alloc_flags
, vmk_flags
,
703 docow
, prot
, maxprot
,
704 (flags
& MAP_SHARED
) ?
708 /* If a non-binding address was specified for this file backed
709 * mapping, retry the mapping with a zero base
710 * in the event the mapping operation failed due to
711 * lack of space between the address and the map's maximum.
713 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
714 user_addr
= vm_map_page_size(user_map
);
725 *retval
= user_addr
+ pageoff
;
728 case KERN_INVALID_ADDRESS
:
732 case KERN_PROTECTION_FAILURE
:
740 if (pager
!= MEMORY_OBJECT_NULL
) {
742 * Release the reference on the pager.
743 * If the mapping was successful, it now holds
744 * an extra reference.
746 memory_object_deallocate(pager
);
749 fp_drop(p
, fd
, fp
, 0);
752 KERNEL_DEBUG_CONSTANT((BSDDBG_CODE(DBG_BSD_SC_EXTENDED_INFO
, SYS_mmap
) | DBG_FUNC_NONE
), fd
, (uint32_t)(*retval
), (uint32_t)user_size
, error
, 0);
753 #ifndef CONFIG_EMBEDDED
754 KERNEL_DEBUG_CONSTANT((BSDDBG_CODE(DBG_BSD_SC_EXTENDED_INFO2
, SYS_mmap
) | DBG_FUNC_NONE
), (uint32_t)(*retval
>> 32), (uint32_t)(user_size
>> 32),
755 (uint32_t)(file_pos
>> 32), (uint32_t)file_pos
, 0);
761 msync(__unused proc_t p
, struct msync_args
*uap
, int32_t *retval
)
763 __pthread_testcancel(1);
764 return msync_nocancel(p
, (struct msync_nocancel_args
*)uap
, retval
);
768 msync_nocancel(__unused proc_t p
, struct msync_nocancel_args
*uap
, __unused
int32_t *retval
)
770 mach_vm_offset_t addr
;
775 vm_sync_t sync_flags
= 0;
777 user_map
= current_map();
778 addr
= (mach_vm_offset_t
) uap
->addr
;
779 size
= (mach_vm_size_t
) uap
->len
;
780 #ifndef CONFIG_EMBEDDED
781 KERNEL_DEBUG_CONSTANT((BSDDBG_CODE(DBG_BSD_SC_EXTENDED_INFO
, SYS_msync
) | DBG_FUNC_NONE
), (uint32_t)(addr
>> 32), (uint32_t)(size
>> 32), 0, 0, 0);
783 if (mach_vm_range_overflows(addr
, size
)) {
786 if (addr
& vm_map_page_mask(user_map
)) {
787 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
792 * We cannot support this properly without maintaining
793 * list all mmaps done. Cannot use vm_map_entry as they could be
794 * split or coalesced by indepenedant actions. So instead of
795 * inaccurate results, lets just return error as invalid size
798 return EINVAL
; /* XXX breaks posix apps */
802 /* disallow contradictory flags */
803 if ((flags
& (MS_SYNC
| MS_ASYNC
)) == (MS_SYNC
| MS_ASYNC
)) {
807 if (flags
& MS_KILLPAGES
) {
808 sync_flags
|= VM_SYNC_KILLPAGES
;
810 if (flags
& MS_DEACTIVATE
) {
811 sync_flags
|= VM_SYNC_DEACTIVATE
;
813 if (flags
& MS_INVALIDATE
) {
814 sync_flags
|= VM_SYNC_INVALIDATE
;
817 if (!(flags
& (MS_KILLPAGES
| MS_DEACTIVATE
))) {
818 if (flags
& MS_ASYNC
) {
819 sync_flags
|= VM_SYNC_ASYNCHRONOUS
;
821 sync_flags
|= VM_SYNC_SYNCHRONOUS
;
825 sync_flags
|= VM_SYNC_CONTIGUOUS
; /* complain if holes */
827 rv
= mach_vm_msync(user_map
, addr
, size
, sync_flags
);
832 case KERN_INVALID_ADDRESS
: /* hole in region being sync'ed */
844 munmap(__unused proc_t p
, struct munmap_args
*uap
, __unused
int32_t *retval
)
846 mach_vm_offset_t user_addr
;
847 mach_vm_size_t user_size
;
848 kern_return_t result
;
851 user_map
= current_map();
852 user_addr
= (mach_vm_offset_t
) uap
->addr
;
853 user_size
= (mach_vm_size_t
) uap
->len
;
855 AUDIT_ARG(addr
, user_addr
);
856 AUDIT_ARG(len
, user_size
);
858 if (user_addr
& vm_map_page_mask(user_map
)) {
859 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
863 if (mach_vm_range_overflows(user_addr
, user_size
)) {
867 if (user_size
== 0) {
868 /* UNIX SPEC: size is 0, return EINVAL */
872 result
= mach_vm_deallocate(user_map
, user_addr
, user_size
);
873 if (result
!= KERN_SUCCESS
) {
880 mprotect(__unused proc_t p
, struct mprotect_args
*uap
, __unused
int32_t *retval
)
883 mach_vm_offset_t user_addr
;
884 mach_vm_size_t user_size
;
885 kern_return_t result
;
891 AUDIT_ARG(addr
, uap
->addr
);
892 AUDIT_ARG(len
, uap
->len
);
893 AUDIT_ARG(value32
, uap
->prot
);
895 user_map
= current_map();
896 user_addr
= (mach_vm_offset_t
) uap
->addr
;
897 user_size
= (mach_vm_size_t
) uap
->len
;
898 prot
= (vm_prot_t
)(uap
->prot
& (VM_PROT_ALL
| VM_PROT_TRUSTED
| VM_PROT_STRIP_READ
));
900 if (mach_vm_range_overflows(user_addr
, user_size
)) {
903 if (user_addr
& vm_map_page_mask(user_map
)) {
904 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
910 #if defined(VM_PROT_READ_IS_EXEC)
911 if (prot
& VM_PROT_READ
) {
912 prot
|= VM_PROT_EXECUTE
;
918 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
)) {
919 prot
|= VM_PROT_READ
;
923 #if defined(__arm64__)
924 if (prot
& VM_PROT_STRIP_READ
) {
925 prot
&= ~(VM_PROT_READ
| VM_PROT_STRIP_READ
);
931 * The MAC check for mprotect is of limited use for 2 reasons:
932 * Without mmap revocation, the caller could have asked for the max
933 * protections initially instead of a reduced set, so a mprotect
934 * check would offer no new security.
935 * It is not possible to extract the vnode from the pager object(s)
936 * of the target memory range.
937 * However, the MAC check may be used to prevent a process from,
938 * e.g., making the stack executable.
940 error
= mac_proc_check_mprotect(p
, user_addr
,
947 if (prot
& VM_PROT_TRUSTED
) {
948 #if CONFIG_DYNAMIC_CODE_SIGNING
949 /* CODE SIGNING ENFORCEMENT - JIT support */
950 /* The special protection value VM_PROT_TRUSTED requests that we treat
951 * this page as if it had a valid code signature.
952 * If this is enabled, there MUST be a MAC policy implementing the
953 * mac_proc_check_mprotect() hook above. Otherwise, Codesigning will be
954 * compromised because the check would always succeed and thusly any
955 * process could sign dynamically. */
956 result
= vm_map_sign(
958 vm_map_trunc_page(user_addr
,
959 vm_map_page_mask(user_map
)),
960 vm_map_round_page(user_addr
+ user_size
,
961 vm_map_page_mask(user_map
)));
965 case KERN_INVALID_ADDRESS
:
966 /* UNIX SPEC: for an invalid address range, return ENOMEM */
975 prot
&= ~VM_PROT_TRUSTED
;
977 result
= mach_vm_protect(user_map
, user_addr
, user_size
,
982 case KERN_PROTECTION_FAILURE
:
984 case KERN_INVALID_ADDRESS
:
985 /* UNIX SPEC: for an invalid address range, return ENOMEM */
993 minherit(__unused proc_t p
, struct minherit_args
*uap
, __unused
int32_t *retval
)
995 mach_vm_offset_t addr
;
997 vm_inherit_t inherit
;
999 kern_return_t result
;
1001 AUDIT_ARG(addr
, uap
->addr
);
1002 AUDIT_ARG(len
, uap
->len
);
1003 AUDIT_ARG(value32
, uap
->inherit
);
1005 addr
= (mach_vm_offset_t
)uap
->addr
;
1006 size
= (mach_vm_size_t
)uap
->len
;
1007 inherit
= uap
->inherit
;
1008 if (mach_vm_range_overflows(addr
, size
)) {
1011 user_map
= current_map();
1012 result
= mach_vm_inherit(user_map
, addr
, size
,
1017 case KERN_PROTECTION_FAILURE
:
1024 madvise(__unused proc_t p
, struct madvise_args
*uap
, __unused
int32_t *retval
)
1027 mach_vm_offset_t start
;
1028 mach_vm_size_t size
;
1029 vm_behavior_t new_behavior
;
1030 kern_return_t result
;
1033 * Since this routine is only advisory, we default to conservative
1036 switch (uap
->behav
) {
1038 new_behavior
= VM_BEHAVIOR_RANDOM
;
1040 case MADV_SEQUENTIAL
:
1041 new_behavior
= VM_BEHAVIOR_SEQUENTIAL
;
1044 new_behavior
= VM_BEHAVIOR_DEFAULT
;
1047 new_behavior
= VM_BEHAVIOR_WILLNEED
;
1050 new_behavior
= VM_BEHAVIOR_DONTNEED
;
1053 new_behavior
= VM_BEHAVIOR_FREE
;
1055 case MADV_ZERO_WIRED_PAGES
:
1056 new_behavior
= VM_BEHAVIOR_ZERO_WIRED_PAGES
;
1058 case MADV_FREE_REUSABLE
:
1059 new_behavior
= VM_BEHAVIOR_REUSABLE
;
1061 case MADV_FREE_REUSE
:
1062 new_behavior
= VM_BEHAVIOR_REUSE
;
1064 case MADV_CAN_REUSE
:
1065 new_behavior
= VM_BEHAVIOR_CAN_REUSE
;
1069 new_behavior
= VM_BEHAVIOR_PAGEOUT
;
1071 #else /* MACH_ASSERT */
1073 #endif /* MACH_ASSERT */
1078 start
= (mach_vm_offset_t
) uap
->addr
;
1079 size
= (mach_vm_size_t
) uap
->len
;
1080 if (mach_vm_range_overflows(start
, size
)) {
1086 (uap
->behav
== MADV_FREE
||
1087 uap
->behav
== MADV_FREE_REUSABLE
)) {
1088 printf("** FOURK_COMPAT: %d[%s] "
1089 "failing madvise(0x%llx,0x%llx,%s)\n",
1090 p
->p_pid
, p
->p_comm
, start
, size
,
1091 ((uap
->behav
== MADV_FREE_REUSABLE
)
1092 ? "MADV_FREE_REUSABLE"
1094 DTRACE_VM3(fourk_compat_madvise
,
1100 #endif /* __arm64__ */
1102 user_map
= current_map();
1104 result
= mach_vm_behavior_set(user_map
, start
, size
, new_behavior
);
1108 case KERN_INVALID_ADDRESS
:
1118 mincore(__unused proc_t p
, struct mincore_args
*uap
, __unused
int32_t *retval
)
1120 mach_vm_offset_t addr
= 0, first_addr
= 0, end
= 0, cur_end
= 0;
1121 vm_map_t map
= VM_MAP_NULL
;
1122 user_addr_t vec
= 0;
1124 int lastvecindex
= 0;
1125 int mincoreinfo
= 0;
1127 unsigned int pqueryinfo_vec_size
= 0;
1128 vm_page_info_basic_t info
= NULL
;
1129 mach_msg_type_number_t count
= 0;
1130 char *kernel_vec
= NULL
;
1131 uint64_t req_vec_size_pages
= 0, cur_vec_size_pages
= 0, vecindex
= 0;
1132 kern_return_t kr
= KERN_SUCCESS
;
1134 map
= current_map();
1137 * Make sure that the addresses presented are valid for user
1140 first_addr
= addr
= vm_map_trunc_page(uap
->addr
,
1141 vm_map_page_mask(map
));
1142 end
= vm_map_round_page(uap
->addr
+ uap
->len
,
1143 vm_map_page_mask(map
));
1154 * We are going to loop through the whole 'req_vec_size' pages
1155 * range in chunks of 'cur_vec_size'.
1158 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1159 cur_vec_size_pages
= MIN(req_vec_size_pages
, (MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1161 kernel_vec
= (void*) _MALLOC(cur_vec_size_pages
* sizeof(char), M_TEMP
, M_WAITOK
| M_ZERO
);
1163 if (kernel_vec
== NULL
) {
1168 * Address of byte vector
1172 pqueryinfo_vec_size
= cur_vec_size_pages
* sizeof(struct vm_page_info_basic
);
1173 info
= (void*) _MALLOC(pqueryinfo_vec_size
, M_TEMP
, M_WAITOK
);
1176 FREE(kernel_vec
, M_TEMP
);
1180 while (addr
< end
) {
1181 cur_end
= addr
+ (cur_vec_size_pages
* PAGE_SIZE_64
);
1183 count
= VM_PAGE_INFO_BASIC_COUNT
;
1184 kr
= vm_map_page_range_info_internal(map
,
1188 (vm_page_info_t
) info
,
1191 assert(kr
== KERN_SUCCESS
);
1194 * Do this on a map entry basis so that if the pages are not
1195 * in the current processes address space, we can easily look
1196 * up the pages elsewhere.
1199 for (; addr
< cur_end
; addr
+= PAGE_SIZE
) {
1200 pqueryinfo
= info
[lastvecindex
+ 1].disposition
;
1204 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PRESENT
) {
1205 mincoreinfo
|= MINCORE_INCORE
;
1207 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_REF
) {
1208 mincoreinfo
|= MINCORE_REFERENCED
;
1210 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_DIRTY
) {
1211 mincoreinfo
|= MINCORE_MODIFIED
;
1213 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PAGED_OUT
) {
1214 mincoreinfo
|= MINCORE_PAGED_OUT
;
1216 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_COPIED
) {
1217 mincoreinfo
|= MINCORE_COPIED
;
1219 if ((pqueryinfo
& VM_PAGE_QUERY_PAGE_EXTERNAL
) == 0) {
1220 mincoreinfo
|= MINCORE_ANONYMOUS
;
1223 * calculate index into user supplied byte vector
1225 vecindex
= (addr
- first_addr
) >> PAGE_SHIFT
;
1226 kernel_vec
[vecindex
] = (char)mincoreinfo
;
1227 lastvecindex
= vecindex
;
1231 assert(vecindex
== (cur_vec_size_pages
- 1));
1233 error
= copyout(kernel_vec
, vec
, cur_vec_size_pages
* sizeof(char) /* a char per page */);
1240 * For the next chunk, we'll need:
1241 * - bump the location in the user buffer for our next disposition.
1243 * - starting address
1245 vec
+= cur_vec_size_pages
* sizeof(char);
1246 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1247 cur_vec_size_pages
= MIN(req_vec_size_pages
, (MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1252 FREE(kernel_vec
, M_TEMP
);
1263 mlock(__unused proc_t p
, struct mlock_args
*uap
, __unused
int32_t *retvalval
)
1266 vm_map_offset_t addr
;
1267 vm_map_size_t size
, pageoff
;
1268 kern_return_t result
;
1270 AUDIT_ARG(addr
, uap
->addr
);
1271 AUDIT_ARG(len
, uap
->len
);
1273 addr
= (vm_map_offset_t
) uap
->addr
;
1274 size
= (vm_map_size_t
)uap
->len
;
1276 if (vm_map_range_overflows(addr
, size
)) {
1284 user_map
= current_map();
1285 pageoff
= (addr
& vm_map_page_mask(user_map
));
1287 size
= vm_map_round_page(size
+ pageoff
, vm_map_page_mask(user_map
));
1289 /* have to call vm_map_wire directly to pass "I don't know" protections */
1290 result
= vm_map_wire_kernel(user_map
, addr
, addr
+ size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
, TRUE
);
1292 if (result
== KERN_RESOURCE_SHORTAGE
) {
1294 } else if (result
== KERN_PROTECTION_FAILURE
) {
1296 } else if (result
!= KERN_SUCCESS
) {
1300 return 0; /* KERN_SUCCESS */
1304 munlock(__unused proc_t p
, struct munlock_args
*uap
, __unused
int32_t *retval
)
1306 mach_vm_offset_t addr
;
1307 mach_vm_size_t size
;
1309 kern_return_t result
;
1311 AUDIT_ARG(addr
, uap
->addr
);
1312 AUDIT_ARG(len
, uap
->len
);
1314 addr
= (mach_vm_offset_t
) uap
->addr
;
1315 size
= (mach_vm_size_t
)uap
->len
;
1316 user_map
= current_map();
1317 if (mach_vm_range_overflows(addr
, size
)) {
1320 /* JMM - need to remove all wirings by spec - this just removes one */
1321 result
= mach_vm_wire_kernel(host_priv_self(), user_map
, addr
, size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
);
1322 return result
== KERN_SUCCESS
? 0 : ENOMEM
;
1327 mlockall(__unused proc_t p
, __unused
struct mlockall_args
*uap
, __unused
int32_t *retval
)
1333 munlockall(__unused proc_t p
, __unused
struct munlockall_args
*uap
, __unused
int32_t *retval
)
1338 #if CONFIG_CODE_DECRYPTION
1340 mremap_encrypted(__unused
struct proc
*p
, struct mremap_encrypted_args
*uap
, __unused
int32_t *retval
)
1342 mach_vm_offset_t user_addr
;
1343 mach_vm_size_t user_size
;
1344 kern_return_t result
;
1348 cpu_subtype_t cpusubtype
;
1349 pager_crypt_info_t crypt_info
;
1350 const char * cryptname
= 0;
1353 struct proc_regioninfo_internal pinfo
;
1355 uintptr_t vnodeaddr
;
1358 AUDIT_ARG(addr
, uap
->addr
);
1359 AUDIT_ARG(len
, uap
->len
);
1361 user_map
= current_map();
1362 user_addr
= (mach_vm_offset_t
) uap
->addr
;
1363 user_size
= (mach_vm_size_t
) uap
->len
;
1365 cryptid
= uap
->cryptid
;
1366 cputype
= uap
->cputype
;
1367 cpusubtype
= uap
->cpusubtype
;
1369 if (mach_vm_range_overflows(user_addr
, user_size
)) {
1372 if (user_addr
& vm_map_page_mask(user_map
)) {
1373 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
1379 /* not encrypted, just an empty load command */
1382 cryptname
= "com.apple.unfree";
1385 /* some random cryptid that you could manually put into
1386 * your binary if you want NULL */
1387 cryptname
= "com.apple.null";
1393 if (NULL
== text_crypter_create
) {
1397 ret
= fill_procregioninfo_onlymappedvnodes( proc_task(p
), user_addr
, &pinfo
, &vnodeaddr
, &vid
);
1398 if (ret
== 0 || !vnodeaddr
) {
1399 /* No really, this returns 0 if the memory address is not backed by a file */
1403 vp
= (vnode_t
)vnodeaddr
;
1404 if ((vnode_getwithvid(vp
, vid
)) == 0) {
1405 MALLOC_ZONE(vpath
, char *, MAXPATHLEN
, M_NAMEI
, M_WAITOK
);
1406 if (vpath
== NULL
) {
1412 ret
= vn_getpath(vp
, vpath
, &len
);
1414 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1425 kprintf("%s vpath %s cryptid 0x%08x cputype 0x%08x cpusubtype 0x%08x range 0x%016llx size 0x%016llx\n",
1426 __FUNCTION__
, vpath
, cryptid
, cputype
, cpusubtype
, (uint64_t)user_addr
, (uint64_t)user_size
);
1429 /* set up decrypter first */
1430 crypt_file_data_t crypt_data
= {
1433 .cpusubtype
= cpusubtype
1435 result
= text_crypter_create(&crypt_info
, cryptname
, (void*)&crypt_data
);
1436 #if VM_MAP_DEBUG_APPLE_PROTECT
1437 if (vm_map_debug_apple_protect
) {
1438 printf("APPLE_PROTECT: %d[%s] map %p [0x%llx:0x%llx] %s(%s) -> 0x%x\n",
1439 p
->p_pid
, p
->p_comm
,
1441 (uint64_t) user_addr
,
1442 (uint64_t) (user_addr
+ user_size
),
1443 __FUNCTION__
, vpath
, result
);
1445 #endif /* VM_MAP_DEBUG_APPLE_PROTECT */
1446 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1449 printf("%s: unable to create decrypter %s, kr=%d\n",
1450 __FUNCTION__
, cryptname
, result
);
1451 if (result
== kIOReturnNotPrivileged
) {
1452 /* text encryption returned decryption failure */
1459 /* now remap using the decrypter */
1460 vm_object_offset_t crypto_backing_offset
;
1461 crypto_backing_offset
= -1; /* i.e. use map entry's offset */
1462 result
= vm_map_apple_protected(user_map
,
1464 user_addr
+ user_size
,
1465 crypto_backing_offset
,
1468 printf("%s: mapping failed with %d\n", __FUNCTION__
, result
);
1476 #endif /* CONFIG_CODE_DECRYPTION */