2 * Copyright (c) 2007 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>
136 * XXX Internally, we use VM_PROT_* somewhat interchangeably, but the correct
137 * XXX usage is PROT_* from an interface perspective. Thus the values of
138 * XXX VM_PROT_* and PROT_* need to correspond.
141 mmap(proc_t p
, struct mmap_args
*uap
, user_addr_t
*retval
)
144 * Map in special device (must be SHARED) or file
152 kern_return_t result
;
153 vm_map_offset_t user_addr
;
154 vm_map_size_t user_size
;
155 vm_object_offset_t pageoff
;
156 vm_object_offset_t file_pos
;
158 vm_tag_t tag
= VM_KERN_MEMORY_NONE
;
159 vm_map_kernel_flags_t vmk_flags
= VM_MAP_KERNEL_FLAGS_NONE
;
163 memory_object_t pager
= MEMORY_OBJECT_NULL
;
164 memory_object_control_t control
;
172 * Note that for UNIX03 conformance, there is additional parameter checking for
173 * mmap() system call in libsyscall prior to entering the kernel. The sanity
174 * checks and argument validation done in this function are not the only places
175 * one can get returned errnos.
178 user_map
= current_map();
179 user_addr
= (vm_map_offset_t
)uap
->addr
;
180 user_size
= (vm_map_size_t
) uap
->len
;
182 AUDIT_ARG(addr
, user_addr
);
183 AUDIT_ARG(len
, user_size
);
184 AUDIT_ARG(fd
, uap
->fd
);
186 prot
= (uap
->prot
& VM_PROT_ALL
);
189 * Since the hardware currently does not support writing without
190 * read-before-write, or execution-without-read, if the request is
191 * for write or execute access, we must imply read access as well;
192 * otherwise programs expecting this to work will fail to operate.
194 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
195 prot
|= VM_PROT_READ
;
196 #endif /* radar 3777787 */
202 * The vm code does not have prototypes & compiler doesn't do the'
203 * the right thing when you cast 64bit value and pass it in function
204 * call. So here it is.
206 file_pos
= (vm_object_offset_t
)uap
->pos
;
209 /* make sure mapping fits into numeric range etc */
210 if (file_pos
+ user_size
> (vm_object_offset_t
)-PAGE_SIZE_64
)
214 * Align the file position to a page boundary,
215 * and save its page offset component.
217 pageoff
= (file_pos
& vm_map_page_mask(user_map
));
218 file_pos
-= (vm_object_offset_t
)pageoff
;
221 /* Adjust size for rounding (on both ends). */
222 user_size
+= pageoff
; /* low end... */
223 user_size
= vm_map_round_page(user_size
,
224 vm_map_page_mask(user_map
)); /* hi end */
226 if (flags
& MAP_JIT
) {
227 if ((flags
& MAP_FIXED
) ||
228 (flags
& MAP_SHARED
) ||
229 !(flags
& MAP_ANON
) ||
230 (flags
& MAP_RESILIENT_CODESIGN
) ||
231 (flags
& MAP_RESILIENT_MEDIA
)) {
236 if ((flags
& MAP_RESILIENT_CODESIGN
) ||
237 (flags
& MAP_RESILIENT_MEDIA
)) {
238 if ((flags
& MAP_ANON
) ||
242 if (prot
& (VM_PROT_WRITE
| VM_PROT_EXECUTE
)) {
248 * Check for illegal addresses. Watch out for address wrap... Note
249 * that VM_*_ADDRESS are not constants due to casts (argh).
251 if (flags
& MAP_FIXED
) {
253 * The specified address must have the same remainder
254 * as the file offset taken modulo PAGE_SIZE, so it
255 * should be aligned after adjustment by pageoff.
257 user_addr
-= pageoff
;
258 if (user_addr
& vm_map_page_mask(user_map
))
262 /* DO not have apis to get this info, need to wait till then*/
264 * XXX for non-fixed mappings where no hint is provided or
265 * the hint would fall in the potential heap space,
266 * place it after the end of the largest possible heap.
268 * There should really be a pmap call to determine a reasonable
271 else if (addr
< vm_map_round_page(p
->p_vmspace
->vm_daddr
+ MAXDSIZ
,
272 vm_map_page_mask(user_map
)))
273 addr
= vm_map_round_page(p
->p_vmspace
->vm_daddr
+ MAXDSIZ
,
274 vm_map_page_mask(user_map
));
280 if (flags
& MAP_ANON
) {
282 maxprot
= VM_PROT_ALL
;
287 error
= mac_proc_check_map_anon(p
, user_addr
, user_size
, prot
, flags
, &maxprot
);
294 * Mapping blank space is trivial. Use positive fds as the alias
295 * value for memory tracking.
299 * Use "fd" to pass (some) Mach VM allocation flags,
300 * (see the VM_FLAGS_* definitions).
302 alloc_flags
= fd
& (VM_FLAGS_ALIAS_MASK
|
303 VM_FLAGS_SUPERPAGE_MASK
|
306 if (alloc_flags
!= fd
) {
307 /* reject if there are any extra flags */
310 VM_GET_FLAGS_ALIAS(alloc_flags
, tag
);
311 alloc_flags
&= ~VM_FLAGS_ALIAS_MASK
;
318 struct vnode_attr va
;
319 vfs_context_t ctx
= vfs_context_current();
325 * Mapping file, get fp for validation. Obtain vnode and make
326 * sure it is of appropriate type.
328 err
= fp_lookup(p
, fd
, &fp
, 0);
332 switch (FILEGLOB_DTYPE(fp
->f_fglob
)) {
334 uap
->addr
= (user_addr_t
)user_addr
;
335 uap
->len
= (user_size_t
)user_size
;
339 error
= pshm_mmap(p
, uap
, retval
, fp
, (off_t
)pageoff
);
347 vp
= (struct vnode
*)fp
->f_fglob
->fg_data
;
348 error
= vnode_getwithref(vp
);
352 if (vp
->v_type
!= VREG
&& vp
->v_type
!= VCHR
) {
358 AUDIT_ARG(vnpath
, vp
, ARG_VNODE1
);
361 * POSIX: mmap needs to update access time for mapped files
363 if ((vnode_vfsvisflags(vp
) & MNT_NOATIME
) == 0) {
365 nanotime(&va
.va_access_time
);
366 VATTR_SET_ACTIVE(&va
, va_access_time
);
367 vnode_setattr(vp
, &va
, ctx
);
371 * XXX hack to handle use of /dev/zero to map anon memory (ala
374 if (vp
->v_type
== VCHR
|| vp
->v_type
== VSTR
) {
380 * Ensure that file and memory protections are
381 * compatible. Note that we only worry about
382 * writability if mapping is shared; in this case,
383 * current and max prot are dictated by the open file.
384 * XXX use the vnode instead? Problem is: what
385 * credentials do we use for determination? What if
386 * proc does a setuid?
388 maxprot
= VM_PROT_EXECUTE
; /* ??? */
389 if (fp
->f_fglob
->fg_flag
& FREAD
)
390 maxprot
|= VM_PROT_READ
;
391 else if (prot
& PROT_READ
) {
397 * If we are sharing potential changes (either via
398 * MAP_SHARED or via the implicit sharing of character
399 * device mappings), and we are trying to get write
400 * permission although we opened it without asking
404 if ((flags
& MAP_SHARED
) != 0) {
405 if ((fp
->f_fglob
->fg_flag
& FWRITE
) != 0 &&
407 * Do not allow writable mappings of
408 * swap files (see vm_swapfile_pager.c).
412 * check for write access
414 * Note that we already made this check when granting FWRITE
415 * against the file, so it seems redundant here.
417 error
= vnode_authorize(vp
, NULL
, KAUTH_VNODE_CHECKIMMUTABLE
, ctx
);
419 /* if not granted for any reason, but we wanted it, bad */
420 if ((prot
& PROT_WRITE
) && (error
!= 0)) {
425 /* if writable, remember */
427 maxprot
|= VM_PROT_WRITE
;
429 } else if ((prot
& PROT_WRITE
) != 0) {
435 maxprot
|= VM_PROT_WRITE
;
439 error
= mac_file_check_mmap(vfs_context_ucred(ctx
),
440 fp
->f_fglob
, prot
, flags
, file_pos
, &maxprot
);
449 if (user_size
== 0) {
457 * We bend a little - round the start and end addresses
458 * to the nearest page boundary.
460 user_size
= vm_map_round_page(user_size
,
461 vm_map_page_mask(user_map
));
463 if (file_pos
& vm_map_page_mask(user_map
)) {
470 if ((flags
& MAP_FIXED
) == 0) {
471 alloc_flags
|= VM_FLAGS_ANYWHERE
;
472 user_addr
= vm_map_round_page(user_addr
,
473 vm_map_page_mask(user_map
));
475 if (user_addr
!= vm_map_trunc_page(user_addr
,
476 vm_map_page_mask(user_map
))) {
483 * mmap(MAP_FIXED) will replace any existing mappings in the
484 * specified range, if the new mapping is successful.
485 * If we just deallocate the specified address range here,
486 * another thread might jump in and allocate memory in that
487 * range before we get a chance to establish the new mapping,
488 * and we won't have a chance to restore the old mappings.
489 * So we use VM_FLAGS_OVERWRITE to let Mach VM know that it
490 * has to deallocate the existing mappings and establish the
491 * new ones atomically.
493 alloc_flags
|= VM_FLAGS_FIXED
| VM_FLAGS_OVERWRITE
;
496 if (flags
& MAP_NOCACHE
)
497 alloc_flags
|= VM_FLAGS_NO_CACHE
;
499 if (flags
& MAP_JIT
) {
500 vmk_flags
.vmkf_map_jit
= TRUE
;
503 if (flags
& MAP_RESILIENT_CODESIGN
) {
504 alloc_flags
|= VM_FLAGS_RESILIENT_CODESIGN
;
508 * Lookup/allocate object.
510 if (handle
== NULL
) {
514 #if defined(VM_PROT_READ_IS_EXEC)
515 if (prot
& VM_PROT_READ
)
516 prot
|= VM_PROT_EXECUTE
;
517 if (maxprot
& VM_PROT_READ
)
518 maxprot
|= VM_PROT_EXECUTE
;
523 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
524 prot
|= VM_PROT_READ
;
525 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
526 maxprot
|= VM_PROT_READ
;
527 #endif /* radar 3777787 */
529 result
= vm_map_enter_mem_object(user_map
,
530 &user_addr
, user_size
,
531 0, alloc_flags
, vmk_flags
,
533 IPC_PORT_NULL
, 0, FALSE
,
535 (flags
& MAP_SHARED
) ?
539 /* If a non-binding address was specified for this anonymous
540 * mapping, retry the mapping with a zero base
541 * in the event the mapping operation failed due to
542 * lack of space between the address and the map's maximum.
544 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
545 user_addr
= vm_map_page_size(user_map
);
549 if (vnode_isswap(vp
)) {
551 * Map swap files with a special pager
552 * that returns obfuscated contents.
555 pager
= swapfile_pager_setup(vp
);
556 if (pager
!= MEMORY_OBJECT_NULL
) {
557 control
= swapfile_pager_control(pager
);
560 control
= ubc_getobject(vp
, UBC_FLAGS_NONE
);
563 if (control
== NULL
) {
571 * FIXME: if we're writing the file we need a way to
572 * ensure that someone doesn't replace our R/W creds
573 * with ones that only work for read.
576 ubc_setthreadcred(vp
, p
, current_thread());
578 if ((flags
& (MAP_ANON
|MAP_SHARED
)) == 0) {
584 #if defined(VM_PROT_READ_IS_EXEC)
585 if (prot
& VM_PROT_READ
)
586 prot
|= VM_PROT_EXECUTE
;
587 if (maxprot
& VM_PROT_READ
)
588 maxprot
|= VM_PROT_EXECUTE
;
593 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
594 prot
|= VM_PROT_READ
;
595 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
596 maxprot
|= VM_PROT_READ
;
597 #endif /* radar 3777787 */
600 if ((flags
& MAP_RESILIENT_CODESIGN
) ||
601 (flags
& MAP_RESILIENT_MEDIA
)) {
602 if (prot
& (VM_PROT_WRITE
| VM_PROT_EXECUTE
)) {
608 /* strictly limit access to "prot" */
612 vm_object_offset_t end_pos
= 0;
613 if (os_add_overflow(user_size
, file_pos
, &end_pos
)) {
619 result
= vm_map_enter_mem_object_control(user_map
,
620 &user_addr
, user_size
,
621 0, alloc_flags
, vmk_flags
,
624 docow
, prot
, maxprot
,
625 (flags
& MAP_SHARED
) ?
629 /* If a non-binding address was specified for this file backed
630 * mapping, retry the mapping with a zero base
631 * in the event the mapping operation failed due to
632 * lack of space between the address and the map's maximum.
634 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
635 user_addr
= vm_map_page_size(user_map
);
646 *retval
= user_addr
+ pageoff
;
649 case KERN_INVALID_ADDRESS
:
653 case KERN_PROTECTION_FAILURE
:
661 if (pager
!= MEMORY_OBJECT_NULL
) {
663 * Release the reference on the pager.
664 * If the mapping was successful, it now holds
665 * an extra reference.
667 memory_object_deallocate(pager
);
670 fp_drop(p
, fd
, fp
, 0);
672 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);
673 #ifndef CONFIG_EMBEDDED
674 KERNEL_DEBUG_CONSTANT((BSDDBG_CODE(DBG_BSD_SC_EXTENDED_INFO2
, SYS_mmap
) | DBG_FUNC_NONE
), (uint32_t)(*retval
>> 32), (uint32_t)(user_size
>> 32),
675 (uint32_t)(file_pos
>> 32), (uint32_t)file_pos
, 0);
681 msync(__unused proc_t p
, struct msync_args
*uap
, int32_t *retval
)
683 __pthread_testcancel(1);
684 return(msync_nocancel(p
, (struct msync_nocancel_args
*)uap
, retval
));
688 msync_nocancel(__unused proc_t p
, struct msync_nocancel_args
*uap
, __unused
int32_t *retval
)
690 mach_vm_offset_t addr
;
695 vm_sync_t sync_flags
=0;
697 user_map
= current_map();
698 addr
= (mach_vm_offset_t
) uap
->addr
;
699 size
= (mach_vm_size_t
)uap
->len
;
700 #ifndef CONFIG_EMBEDDED
701 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);
703 if (addr
& vm_map_page_mask(user_map
)) {
704 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
709 * We cannot support this properly without maintaining
710 * list all mmaps done. Cannot use vm_map_entry as they could be
711 * split or coalesced by indepenedant actions. So instead of
712 * inaccurate results, lets just return error as invalid size
715 return (EINVAL
); /* XXX breaks posix apps */
719 /* disallow contradictory flags */
720 if ((flags
& (MS_SYNC
|MS_ASYNC
)) == (MS_SYNC
|MS_ASYNC
))
723 if (flags
& MS_KILLPAGES
)
724 sync_flags
|= VM_SYNC_KILLPAGES
;
725 if (flags
& MS_DEACTIVATE
)
726 sync_flags
|= VM_SYNC_DEACTIVATE
;
727 if (flags
& MS_INVALIDATE
)
728 sync_flags
|= VM_SYNC_INVALIDATE
;
730 if ( !(flags
& (MS_KILLPAGES
| MS_DEACTIVATE
))) {
731 if (flags
& MS_ASYNC
)
732 sync_flags
|= VM_SYNC_ASYNCHRONOUS
;
734 sync_flags
|= VM_SYNC_SYNCHRONOUS
;
737 sync_flags
|= VM_SYNC_CONTIGUOUS
; /* complain if holes */
739 rv
= mach_vm_msync(user_map
, addr
, size
, sync_flags
);
744 case KERN_INVALID_ADDRESS
: /* hole in region being sync'ed */
756 munmap(__unused proc_t p
, struct munmap_args
*uap
, __unused
int32_t *retval
)
758 mach_vm_offset_t user_addr
;
759 mach_vm_size_t user_size
;
760 kern_return_t result
;
763 user_map
= current_map();
764 user_addr
= (mach_vm_offset_t
) uap
->addr
;
765 user_size
= (mach_vm_size_t
) uap
->len
;
767 AUDIT_ARG(addr
, user_addr
);
768 AUDIT_ARG(len
, user_size
);
770 if (user_addr
& vm_map_page_mask(user_map
)) {
771 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
775 if (user_addr
+ user_size
< user_addr
)
778 if (user_size
== 0) {
779 /* UNIX SPEC: size is 0, return EINVAL */
783 result
= mach_vm_deallocate(user_map
, user_addr
, user_size
);
784 if (result
!= KERN_SUCCESS
) {
791 mprotect(__unused proc_t p
, struct mprotect_args
*uap
, __unused
int32_t *retval
)
794 mach_vm_offset_t user_addr
;
795 mach_vm_size_t user_size
;
796 kern_return_t result
;
802 AUDIT_ARG(addr
, uap
->addr
);
803 AUDIT_ARG(len
, uap
->len
);
804 AUDIT_ARG(value32
, uap
->prot
);
806 user_map
= current_map();
807 user_addr
= (mach_vm_offset_t
) uap
->addr
;
808 user_size
= (mach_vm_size_t
) uap
->len
;
809 prot
= (vm_prot_t
)(uap
->prot
& (VM_PROT_ALL
| VM_PROT_TRUSTED
| VM_PROT_STRIP_READ
));
811 if (user_addr
& vm_map_page_mask(user_map
)) {
812 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
818 #if defined(VM_PROT_READ_IS_EXEC)
819 if (prot
& VM_PROT_READ
)
820 prot
|= VM_PROT_EXECUTE
;
825 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
826 prot
|= VM_PROT_READ
;
829 #if defined(__arm64__)
830 if (prot
& VM_PROT_STRIP_READ
)
831 prot
&= ~(VM_PROT_READ
| VM_PROT_STRIP_READ
);
836 * The MAC check for mprotect is of limited use for 2 reasons:
837 * Without mmap revocation, the caller could have asked for the max
838 * protections initially instead of a reduced set, so a mprotect
839 * check would offer no new security.
840 * It is not possible to extract the vnode from the pager object(s)
841 * of the target memory range.
842 * However, the MAC check may be used to prevent a process from,
843 * e.g., making the stack executable.
845 error
= mac_proc_check_mprotect(p
, user_addr
,
851 if(prot
& VM_PROT_TRUSTED
) {
852 #if CONFIG_DYNAMIC_CODE_SIGNING
853 /* CODE SIGNING ENFORCEMENT - JIT support */
854 /* The special protection value VM_PROT_TRUSTED requests that we treat
855 * this page as if it had a valid code signature.
856 * If this is enabled, there MUST be a MAC policy implementing the
857 * mac_proc_check_mprotect() hook above. Otherwise, Codesigning will be
858 * compromised because the check would always succeed and thusly any
859 * process could sign dynamically. */
860 result
= vm_map_sign(
862 vm_map_trunc_page(user_addr
,
863 vm_map_page_mask(user_map
)),
864 vm_map_round_page(user_addr
+user_size
,
865 vm_map_page_mask(user_map
)));
869 case KERN_INVALID_ADDRESS
:
870 /* UNIX SPEC: for an invalid address range, return ENOMEM */
879 prot
&= ~VM_PROT_TRUSTED
;
881 result
= mach_vm_protect(user_map
, user_addr
, user_size
,
886 case KERN_PROTECTION_FAILURE
:
888 case KERN_INVALID_ADDRESS
:
889 /* UNIX SPEC: for an invalid address range, return ENOMEM */
897 minherit(__unused proc_t p
, struct minherit_args
*uap
, __unused
int32_t *retval
)
899 mach_vm_offset_t addr
;
901 vm_inherit_t inherit
;
903 kern_return_t result
;
905 AUDIT_ARG(addr
, uap
->addr
);
906 AUDIT_ARG(len
, uap
->len
);
907 AUDIT_ARG(value32
, uap
->inherit
);
909 addr
= (mach_vm_offset_t
)uap
->addr
;
910 size
= (mach_vm_size_t
)uap
->len
;
911 inherit
= uap
->inherit
;
913 user_map
= current_map();
914 result
= mach_vm_inherit(user_map
, addr
, size
,
919 case KERN_PROTECTION_FAILURE
:
926 madvise(__unused proc_t p
, struct madvise_args
*uap
, __unused
int32_t *retval
)
929 mach_vm_offset_t start
;
931 vm_behavior_t new_behavior
;
932 kern_return_t result
;
935 * Since this routine is only advisory, we default to conservative
938 switch (uap
->behav
) {
940 new_behavior
= VM_BEHAVIOR_RANDOM
;
942 case MADV_SEQUENTIAL
:
943 new_behavior
= VM_BEHAVIOR_SEQUENTIAL
;
946 new_behavior
= VM_BEHAVIOR_DEFAULT
;
949 new_behavior
= VM_BEHAVIOR_WILLNEED
;
952 new_behavior
= VM_BEHAVIOR_DONTNEED
;
955 new_behavior
= VM_BEHAVIOR_FREE
;
957 case MADV_ZERO_WIRED_PAGES
:
958 new_behavior
= VM_BEHAVIOR_ZERO_WIRED_PAGES
;
960 case MADV_FREE_REUSABLE
:
961 new_behavior
= VM_BEHAVIOR_REUSABLE
;
963 case MADV_FREE_REUSE
:
964 new_behavior
= VM_BEHAVIOR_REUSE
;
967 new_behavior
= VM_BEHAVIOR_CAN_REUSE
;
971 new_behavior
= VM_BEHAVIOR_PAGEOUT
;
973 #else /* MACH_ASSERT */
975 #endif /* MACH_ASSERT */
980 start
= (mach_vm_offset_t
) uap
->addr
;
981 size
= (mach_vm_size_t
) uap
->len
;
986 (uap
->behav
== MADV_FREE
||
987 uap
->behav
== MADV_FREE_REUSABLE
)) {
988 printf("** FOURK_COMPAT: %d[%s] "
989 "failing madvise(0x%llx,0x%llx,%s)\n",
990 p
->p_pid
, p
->p_comm
, start
, size
,
991 ((uap
->behav
== MADV_FREE_REUSABLE
)
992 ? "MADV_FREE_REUSABLE"
994 DTRACE_VM3(fourk_compat_madvise
,
1000 #endif /* __arm64__ */
1002 user_map
= current_map();
1004 result
= mach_vm_behavior_set(user_map
, start
, size
, new_behavior
);
1008 case KERN_INVALID_ADDRESS
:
1018 mincore(__unused proc_t p
, struct mincore_args
*uap
, __unused
int32_t *retval
)
1020 mach_vm_offset_t addr
= 0, first_addr
= 0, end
= 0, cur_end
= 0;
1021 vm_map_t map
= VM_MAP_NULL
;
1022 user_addr_t vec
= 0;
1024 int lastvecindex
= 0;
1027 unsigned int pqueryinfo_vec_size
= 0;
1028 vm_page_info_basic_t info
= NULL
;
1029 mach_msg_type_number_t count
= 0;
1030 char *kernel_vec
= NULL
;
1031 unsigned int req_vec_size_pages
= 0, cur_vec_size_pages
= 0, vecindex
= 0;
1032 kern_return_t kr
= KERN_SUCCESS
;
1034 map
= current_map();
1037 * Make sure that the addresses presented are valid for user
1040 first_addr
= addr
= vm_map_trunc_page(uap
->addr
,
1041 vm_map_page_mask(map
));
1042 end
= vm_map_round_page(uap
->addr
+ uap
->len
,
1043 vm_map_page_mask(map
));
1052 * We are going to loop through the whole 'req_vec_size' pages
1053 * range in chunks of 'cur_vec_size'.
1056 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1057 cur_vec_size_pages
= MIN(req_vec_size_pages
, (MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1059 kernel_vec
= (void*) _MALLOC(cur_vec_size_pages
* sizeof(char), M_TEMP
, M_WAITOK
| M_ZERO
);
1061 if (kernel_vec
== NULL
) {
1066 * Address of byte vector
1070 pqueryinfo_vec_size
= cur_vec_size_pages
* sizeof(struct vm_page_info_basic
);
1071 info
= (void*) _MALLOC(pqueryinfo_vec_size
, M_TEMP
, M_WAITOK
);
1074 FREE(kernel_vec
, M_TEMP
);
1078 while (addr
< end
) {
1080 cur_end
= addr
+ (cur_vec_size_pages
* PAGE_SIZE_64
);
1082 count
= VM_PAGE_INFO_BASIC_COUNT
;
1083 kr
= vm_map_page_range_info_internal(map
,
1087 (vm_page_info_t
) info
,
1090 assert(kr
== KERN_SUCCESS
);
1093 * Do this on a map entry basis so that if the pages are not
1094 * in the current processes address space, we can easily look
1095 * up the pages elsewhere.
1098 for( ; addr
< cur_end
; addr
+= PAGE_SIZE
) {
1100 pqueryinfo
= info
[lastvecindex
+ 1].disposition
;
1104 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PRESENT
)
1105 mincoreinfo
|= MINCORE_INCORE
;
1106 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_REF
)
1107 mincoreinfo
|= MINCORE_REFERENCED
;
1108 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_DIRTY
)
1109 mincoreinfo
|= MINCORE_MODIFIED
;
1110 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PAGED_OUT
)
1111 mincoreinfo
|= MINCORE_PAGED_OUT
;
1112 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_COPIED
)
1113 mincoreinfo
|= MINCORE_COPIED
;
1114 if ((pqueryinfo
& VM_PAGE_QUERY_PAGE_EXTERNAL
) == 0)
1115 mincoreinfo
|= MINCORE_ANONYMOUS
;
1117 * calculate index into user supplied byte vector
1119 vecindex
= (addr
- first_addr
)>> PAGE_SHIFT
;
1120 kernel_vec
[vecindex
] = (char)mincoreinfo
;
1121 lastvecindex
= vecindex
;
1125 assert(vecindex
== (cur_vec_size_pages
- 1));
1127 error
= copyout(kernel_vec
, vec
, cur_vec_size_pages
* sizeof(char) /* a char per page */);
1134 * For the next chunk, we'll need:
1135 * - bump the location in the user buffer for our next disposition.
1137 * - starting address
1139 vec
+= cur_vec_size_pages
* sizeof(char);
1140 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1141 cur_vec_size_pages
= MIN(req_vec_size_pages
, (MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1146 FREE(kernel_vec
, M_TEMP
);
1157 mlock(__unused proc_t p
, struct mlock_args
*uap
, __unused
int32_t *retvalval
)
1160 vm_map_offset_t addr
;
1161 vm_map_size_t size
, pageoff
;
1162 kern_return_t result
;
1164 AUDIT_ARG(addr
, uap
->addr
);
1165 AUDIT_ARG(len
, uap
->len
);
1167 addr
= (vm_map_offset_t
) uap
->addr
;
1168 size
= (vm_map_size_t
)uap
->len
;
1170 /* disable wrap around */
1171 if (addr
+ size
< addr
)
1177 user_map
= current_map();
1178 pageoff
= (addr
& vm_map_page_mask(user_map
));
1180 size
= vm_map_round_page(size
+pageoff
, vm_map_page_mask(user_map
));
1182 /* have to call vm_map_wire directly to pass "I don't know" protections */
1183 result
= vm_map_wire_kernel(user_map
, addr
, addr
+size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
, TRUE
);
1185 if (result
== KERN_RESOURCE_SHORTAGE
)
1187 else if (result
== KERN_PROTECTION_FAILURE
)
1189 else if (result
!= KERN_SUCCESS
)
1192 return 0; /* KERN_SUCCESS */
1196 munlock(__unused proc_t p
, struct munlock_args
*uap
, __unused
int32_t *retval
)
1198 mach_vm_offset_t addr
;
1199 mach_vm_size_t size
;
1201 kern_return_t result
;
1203 AUDIT_ARG(addr
, uap
->addr
);
1204 AUDIT_ARG(addr
, uap
->len
);
1206 addr
= (mach_vm_offset_t
) uap
->addr
;
1207 size
= (mach_vm_size_t
)uap
->len
;
1208 user_map
= current_map();
1210 /* JMM - need to remove all wirings by spec - this just removes one */
1211 result
= mach_vm_wire_kernel(host_priv_self(), user_map
, addr
, size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
);
1212 return (result
== KERN_SUCCESS
? 0 : ENOMEM
);
1217 mlockall(__unused proc_t p
, __unused
struct mlockall_args
*uap
, __unused
int32_t *retval
)
1223 munlockall(__unused proc_t p
, __unused
struct munlockall_args
*uap
, __unused
int32_t *retval
)
1228 #if CONFIG_CODE_DECRYPTION
1230 mremap_encrypted(__unused
struct proc
*p
, struct mremap_encrypted_args
*uap
, __unused
int32_t *retval
)
1232 mach_vm_offset_t user_addr
;
1233 mach_vm_size_t user_size
;
1234 kern_return_t result
;
1238 cpu_subtype_t cpusubtype
;
1239 pager_crypt_info_t crypt_info
;
1240 const char * cryptname
= 0;
1243 struct proc_regioninfo_internal pinfo
;
1245 uintptr_t vnodeaddr
;
1248 AUDIT_ARG(addr
, uap
->addr
);
1249 AUDIT_ARG(len
, uap
->len
);
1251 user_map
= current_map();
1252 user_addr
= (mach_vm_offset_t
) uap
->addr
;
1253 user_size
= (mach_vm_size_t
) uap
->len
;
1255 cryptid
= uap
->cryptid
;
1256 cputype
= uap
->cputype
;
1257 cpusubtype
= uap
->cpusubtype
;
1259 if (user_addr
& vm_map_page_mask(user_map
)) {
1260 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
1266 /* not encrypted, just an empty load command */
1269 cryptname
="com.apple.unfree";
1272 /* some random cryptid that you could manually put into
1273 * your binary if you want NULL */
1274 cryptname
="com.apple.null";
1280 if (NULL
== text_crypter_create
) return ENOTSUP
;
1282 ret
= fill_procregioninfo_onlymappedvnodes( proc_task(p
), user_addr
, &pinfo
, &vnodeaddr
, &vid
);
1283 if (ret
== 0 || !vnodeaddr
) {
1284 /* No really, this returns 0 if the memory address is not backed by a file */
1288 vp
= (vnode_t
)vnodeaddr
;
1289 if ((vnode_getwithvid(vp
, vid
)) == 0) {
1290 MALLOC_ZONE(vpath
, char *, MAXPATHLEN
, M_NAMEI
, M_WAITOK
);
1297 ret
= vn_getpath(vp
, vpath
, &len
);
1299 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1310 kprintf("%s vpath %s cryptid 0x%08x cputype 0x%08x cpusubtype 0x%08x range 0x%016llx size 0x%016llx\n",
1311 __FUNCTION__
, vpath
, cryptid
, cputype
, cpusubtype
, (uint64_t)user_addr
, (uint64_t)user_size
);
1314 /* set up decrypter first */
1315 crypt_file_data_t crypt_data
= {
1318 .cpusubtype
= cpusubtype
};
1319 result
= text_crypter_create(&crypt_info
, cryptname
, (void*)&crypt_data
);
1320 #if VM_MAP_DEBUG_APPLE_PROTECT
1321 if (vm_map_debug_apple_protect
) {
1322 printf("APPLE_PROTECT: %d[%s] map %p [0x%llx:0x%llx] %s(%s) -> 0x%x\n",
1323 p
->p_pid
, p
->p_comm
,
1325 (uint64_t) user_addr
,
1326 (uint64_t) (user_addr
+ user_size
),
1327 __FUNCTION__
, vpath
, result
);
1329 #endif /* VM_MAP_DEBUG_APPLE_PROTECT */
1330 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1333 printf("%s: unable to create decrypter %s, kr=%d\n",
1334 __FUNCTION__
, cryptname
, result
);
1335 if (result
== kIOReturnNotPrivileged
) {
1336 /* text encryption returned decryption failure */
1343 /* now remap using the decrypter */
1344 vm_object_offset_t crypto_backing_offset
;
1345 crypto_backing_offset
= -1; /* i.e. use map entry's offset */
1346 result
= vm_map_apple_protected(user_map
,
1348 user_addr
+user_size
,
1349 crypto_backing_offset
,
1352 printf("%s: mapping failed with %d\n", __FUNCTION__
, result
);
1360 #endif /* CONFIG_CODE_DECRYPTION */