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
|
305 if (alloc_flags
!= fd
) {
306 /* reject if there are any extra flags */
309 VM_GET_FLAGS_ALIAS(alloc_flags
, tag
);
310 alloc_flags
&= ~VM_FLAGS_ALIAS_MASK
;
317 struct vnode_attr va
;
318 vfs_context_t ctx
= vfs_context_current();
324 * Mapping file, get fp for validation. Obtain vnode and make
325 * sure it is of appropriate type.
327 err
= fp_lookup(p
, fd
, &fp
, 0);
331 switch (FILEGLOB_DTYPE(fp
->f_fglob
)) {
333 uap
->addr
= (user_addr_t
)user_addr
;
334 uap
->len
= (user_size_t
)user_size
;
338 error
= pshm_mmap(p
, uap
, retval
, fp
, (off_t
)pageoff
);
346 vp
= (struct vnode
*)fp
->f_fglob
->fg_data
;
347 error
= vnode_getwithref(vp
);
351 if (vp
->v_type
!= VREG
&& vp
->v_type
!= VCHR
) {
357 AUDIT_ARG(vnpath
, vp
, ARG_VNODE1
);
360 * POSIX: mmap needs to update access time for mapped files
362 if ((vnode_vfsvisflags(vp
) & MNT_NOATIME
) == 0) {
364 nanotime(&va
.va_access_time
);
365 VATTR_SET_ACTIVE(&va
, va_access_time
);
366 vnode_setattr(vp
, &va
, ctx
);
370 * XXX hack to handle use of /dev/zero to map anon memory (ala
373 if (vp
->v_type
== VCHR
|| vp
->v_type
== VSTR
) {
379 * Ensure that file and memory protections are
380 * compatible. Note that we only worry about
381 * writability if mapping is shared; in this case,
382 * current and max prot are dictated by the open file.
383 * XXX use the vnode instead? Problem is: what
384 * credentials do we use for determination? What if
385 * proc does a setuid?
387 maxprot
= VM_PROT_EXECUTE
; /* ??? */
388 if (fp
->f_fglob
->fg_flag
& FREAD
)
389 maxprot
|= VM_PROT_READ
;
390 else if (prot
& PROT_READ
) {
396 * If we are sharing potential changes (either via
397 * MAP_SHARED or via the implicit sharing of character
398 * device mappings), and we are trying to get write
399 * permission although we opened it without asking
403 if ((flags
& MAP_SHARED
) != 0) {
404 if ((fp
->f_fglob
->fg_flag
& FWRITE
) != 0 &&
406 * Do not allow writable mappings of
407 * swap files (see vm_swapfile_pager.c).
411 * check for write access
413 * Note that we already made this check when granting FWRITE
414 * against the file, so it seems redundant here.
416 error
= vnode_authorize(vp
, NULL
, KAUTH_VNODE_CHECKIMMUTABLE
, ctx
);
418 /* if not granted for any reason, but we wanted it, bad */
419 if ((prot
& PROT_WRITE
) && (error
!= 0)) {
424 /* if writable, remember */
426 maxprot
|= VM_PROT_WRITE
;
428 } else if ((prot
& PROT_WRITE
) != 0) {
434 maxprot
|= VM_PROT_WRITE
;
438 error
= mac_file_check_mmap(vfs_context_ucred(ctx
),
439 fp
->f_fglob
, prot
, flags
, file_pos
, &maxprot
);
448 if (user_size
== 0) {
456 * We bend a little - round the start and end addresses
457 * to the nearest page boundary.
459 user_size
= vm_map_round_page(user_size
,
460 vm_map_page_mask(user_map
));
462 if (file_pos
& vm_map_page_mask(user_map
)) {
469 if ((flags
& MAP_FIXED
) == 0) {
470 alloc_flags
|= VM_FLAGS_ANYWHERE
;
471 user_addr
= vm_map_round_page(user_addr
,
472 vm_map_page_mask(user_map
));
474 if (user_addr
!= vm_map_trunc_page(user_addr
,
475 vm_map_page_mask(user_map
))) {
482 * mmap(MAP_FIXED) will replace any existing mappings in the
483 * specified range, if the new mapping is successful.
484 * If we just deallocate the specified address range here,
485 * another thread might jump in and allocate memory in that
486 * range before we get a chance to establish the new mapping,
487 * and we won't have a chance to restore the old mappings.
488 * So we use VM_FLAGS_OVERWRITE to let Mach VM know that it
489 * has to deallocate the existing mappings and establish the
490 * new ones atomically.
492 alloc_flags
|= VM_FLAGS_FIXED
| VM_FLAGS_OVERWRITE
;
495 if (flags
& MAP_NOCACHE
)
496 alloc_flags
|= VM_FLAGS_NO_CACHE
;
498 if (flags
& MAP_JIT
) {
499 vmk_flags
.vmkf_map_jit
= TRUE
;
502 if (flags
& MAP_RESILIENT_CODESIGN
) {
503 alloc_flags
|= VM_FLAGS_RESILIENT_CODESIGN
;
507 * Lookup/allocate object.
509 if (handle
== NULL
) {
513 #if defined(VM_PROT_READ_IS_EXEC)
514 if (prot
& VM_PROT_READ
)
515 prot
|= VM_PROT_EXECUTE
;
516 if (maxprot
& VM_PROT_READ
)
517 maxprot
|= VM_PROT_EXECUTE
;
522 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
523 prot
|= VM_PROT_READ
;
524 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
525 maxprot
|= VM_PROT_READ
;
526 #endif /* radar 3777787 */
528 result
= vm_map_enter_mem_object(user_map
,
529 &user_addr
, user_size
,
530 0, alloc_flags
, vmk_flags
,
532 IPC_PORT_NULL
, 0, FALSE
,
534 (flags
& MAP_SHARED
) ?
538 /* If a non-binding address was specified for this anonymous
539 * mapping, retry the mapping with a zero base
540 * in the event the mapping operation failed due to
541 * lack of space between the address and the map's maximum.
543 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
544 user_addr
= vm_map_page_size(user_map
);
548 if (vnode_isswap(vp
)) {
550 * Map swap files with a special pager
551 * that returns obfuscated contents.
554 pager
= swapfile_pager_setup(vp
);
555 if (pager
!= MEMORY_OBJECT_NULL
) {
556 control
= swapfile_pager_control(pager
);
559 control
= ubc_getobject(vp
, UBC_FLAGS_NONE
);
562 if (control
== NULL
) {
570 * FIXME: if we're writing the file we need a way to
571 * ensure that someone doesn't replace our R/W creds
572 * with ones that only work for read.
575 ubc_setthreadcred(vp
, p
, current_thread());
577 if ((flags
& (MAP_ANON
|MAP_SHARED
)) == 0) {
583 #if defined(VM_PROT_READ_IS_EXEC)
584 if (prot
& VM_PROT_READ
)
585 prot
|= VM_PROT_EXECUTE
;
586 if (maxprot
& VM_PROT_READ
)
587 maxprot
|= VM_PROT_EXECUTE
;
592 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
593 prot
|= VM_PROT_READ
;
594 if (maxprot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
595 maxprot
|= VM_PROT_READ
;
596 #endif /* radar 3777787 */
599 if ((flags
& MAP_RESILIENT_CODESIGN
) ||
600 (flags
& MAP_RESILIENT_MEDIA
)) {
601 if (prot
& (VM_PROT_WRITE
| VM_PROT_EXECUTE
)) {
607 /* strictly limit access to "prot" */
610 result
= vm_map_enter_mem_object_control(user_map
,
611 &user_addr
, user_size
,
612 0, alloc_flags
, vmk_flags
,
615 docow
, prot
, maxprot
,
616 (flags
& MAP_SHARED
) ?
620 /* If a non-binding address was specified for this file backed
621 * mapping, retry the mapping with a zero base
622 * in the event the mapping operation failed due to
623 * lack of space between the address and the map's maximum.
625 if ((result
== KERN_NO_SPACE
) && ((flags
& MAP_FIXED
) == 0) && user_addr
&& (num_retries
++ == 0)) {
626 user_addr
= vm_map_page_size(user_map
);
637 *retval
= user_addr
+ pageoff
;
640 case KERN_INVALID_ADDRESS
:
644 case KERN_PROTECTION_FAILURE
:
652 if (pager
!= MEMORY_OBJECT_NULL
) {
654 * Release the reference on the pager.
655 * If the mapping was successful, it now holds
656 * an extra reference.
658 memory_object_deallocate(pager
);
661 fp_drop(p
, fd
, fp
, 0);
663 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);
664 #ifndef CONFIG_EMBEDDED
665 KERNEL_DEBUG_CONSTANT((BSDDBG_CODE(DBG_BSD_SC_EXTENDED_INFO2
, SYS_mmap
) | DBG_FUNC_NONE
), (uint32_t)(*retval
>> 32), (uint32_t)(user_size
>> 32),
666 (uint32_t)(file_pos
>> 32), (uint32_t)file_pos
, 0);
672 msync(__unused proc_t p
, struct msync_args
*uap
, int32_t *retval
)
674 __pthread_testcancel(1);
675 return(msync_nocancel(p
, (struct msync_nocancel_args
*)uap
, retval
));
679 msync_nocancel(__unused proc_t p
, struct msync_nocancel_args
*uap
, __unused
int32_t *retval
)
681 mach_vm_offset_t addr
;
686 vm_sync_t sync_flags
=0;
688 user_map
= current_map();
689 addr
= (mach_vm_offset_t
) uap
->addr
;
690 size
= (mach_vm_size_t
)uap
->len
;
691 #ifndef CONFIG_EMBEDDED
692 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);
694 if (addr
& vm_map_page_mask(user_map
)) {
695 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
700 * We cannot support this properly without maintaining
701 * list all mmaps done. Cannot use vm_map_entry as they could be
702 * split or coalesced by indepenedant actions. So instead of
703 * inaccurate results, lets just return error as invalid size
706 return (EINVAL
); /* XXX breaks posix apps */
710 /* disallow contradictory flags */
711 if ((flags
& (MS_SYNC
|MS_ASYNC
)) == (MS_SYNC
|MS_ASYNC
))
714 if (flags
& MS_KILLPAGES
)
715 sync_flags
|= VM_SYNC_KILLPAGES
;
716 if (flags
& MS_DEACTIVATE
)
717 sync_flags
|= VM_SYNC_DEACTIVATE
;
718 if (flags
& MS_INVALIDATE
)
719 sync_flags
|= VM_SYNC_INVALIDATE
;
721 if ( !(flags
& (MS_KILLPAGES
| MS_DEACTIVATE
))) {
722 if (flags
& MS_ASYNC
)
723 sync_flags
|= VM_SYNC_ASYNCHRONOUS
;
725 sync_flags
|= VM_SYNC_SYNCHRONOUS
;
728 sync_flags
|= VM_SYNC_CONTIGUOUS
; /* complain if holes */
730 rv
= mach_vm_msync(user_map
, addr
, size
, sync_flags
);
735 case KERN_INVALID_ADDRESS
: /* hole in region being sync'ed */
747 munmap(__unused proc_t p
, struct munmap_args
*uap
, __unused
int32_t *retval
)
749 mach_vm_offset_t user_addr
;
750 mach_vm_size_t user_size
;
751 kern_return_t result
;
754 user_map
= current_map();
755 user_addr
= (mach_vm_offset_t
) uap
->addr
;
756 user_size
= (mach_vm_size_t
) uap
->len
;
758 AUDIT_ARG(addr
, user_addr
);
759 AUDIT_ARG(len
, user_size
);
761 if (user_addr
& vm_map_page_mask(user_map
)) {
762 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
766 if (user_addr
+ user_size
< user_addr
)
769 if (user_size
== 0) {
770 /* UNIX SPEC: size is 0, return EINVAL */
774 result
= mach_vm_deallocate(user_map
, user_addr
, user_size
);
775 if (result
!= KERN_SUCCESS
) {
782 mprotect(__unused proc_t p
, struct mprotect_args
*uap
, __unused
int32_t *retval
)
785 mach_vm_offset_t user_addr
;
786 mach_vm_size_t user_size
;
787 kern_return_t result
;
793 AUDIT_ARG(addr
, uap
->addr
);
794 AUDIT_ARG(len
, uap
->len
);
795 AUDIT_ARG(value32
, uap
->prot
);
797 user_map
= current_map();
798 user_addr
= (mach_vm_offset_t
) uap
->addr
;
799 user_size
= (mach_vm_size_t
) uap
->len
;
800 prot
= (vm_prot_t
)(uap
->prot
& (VM_PROT_ALL
| VM_PROT_TRUSTED
| VM_PROT_STRIP_READ
));
802 if (user_addr
& vm_map_page_mask(user_map
)) {
803 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
809 #if defined(VM_PROT_READ_IS_EXEC)
810 if (prot
& VM_PROT_READ
)
811 prot
|= VM_PROT_EXECUTE
;
816 if (prot
& (VM_PROT_EXECUTE
| VM_PROT_WRITE
))
817 prot
|= VM_PROT_READ
;
820 #if defined(__arm64__)
821 if (prot
& VM_PROT_STRIP_READ
)
822 prot
&= ~(VM_PROT_READ
| VM_PROT_STRIP_READ
);
827 * The MAC check for mprotect is of limited use for 2 reasons:
828 * Without mmap revocation, the caller could have asked for the max
829 * protections initially instead of a reduced set, so a mprotect
830 * check would offer no new security.
831 * It is not possible to extract the vnode from the pager object(s)
832 * of the target memory range.
833 * However, the MAC check may be used to prevent a process from,
834 * e.g., making the stack executable.
836 error
= mac_proc_check_mprotect(p
, user_addr
,
842 if(prot
& VM_PROT_TRUSTED
) {
843 #if CONFIG_DYNAMIC_CODE_SIGNING
844 /* CODE SIGNING ENFORCEMENT - JIT support */
845 /* The special protection value VM_PROT_TRUSTED requests that we treat
846 * this page as if it had a valid code signature.
847 * If this is enabled, there MUST be a MAC policy implementing the
848 * mac_proc_check_mprotect() hook above. Otherwise, Codesigning will be
849 * compromised because the check would always succeed and thusly any
850 * process could sign dynamically. */
851 result
= vm_map_sign(
853 vm_map_trunc_page(user_addr
,
854 vm_map_page_mask(user_map
)),
855 vm_map_round_page(user_addr
+user_size
,
856 vm_map_page_mask(user_map
)));
860 case KERN_INVALID_ADDRESS
:
861 /* UNIX SPEC: for an invalid address range, return ENOMEM */
870 prot
&= ~VM_PROT_TRUSTED
;
872 result
= mach_vm_protect(user_map
, user_addr
, user_size
,
877 case KERN_PROTECTION_FAILURE
:
879 case KERN_INVALID_ADDRESS
:
880 /* UNIX SPEC: for an invalid address range, return ENOMEM */
888 minherit(__unused proc_t p
, struct minherit_args
*uap
, __unused
int32_t *retval
)
890 mach_vm_offset_t addr
;
892 vm_inherit_t inherit
;
894 kern_return_t result
;
896 AUDIT_ARG(addr
, uap
->addr
);
897 AUDIT_ARG(len
, uap
->len
);
898 AUDIT_ARG(value32
, uap
->inherit
);
900 addr
= (mach_vm_offset_t
)uap
->addr
;
901 size
= (mach_vm_size_t
)uap
->len
;
902 inherit
= uap
->inherit
;
904 user_map
= current_map();
905 result
= mach_vm_inherit(user_map
, addr
, size
,
910 case KERN_PROTECTION_FAILURE
:
917 madvise(__unused proc_t p
, struct madvise_args
*uap
, __unused
int32_t *retval
)
920 mach_vm_offset_t start
;
922 vm_behavior_t new_behavior
;
923 kern_return_t result
;
926 * Since this routine is only advisory, we default to conservative
929 switch (uap
->behav
) {
931 new_behavior
= VM_BEHAVIOR_RANDOM
;
933 case MADV_SEQUENTIAL
:
934 new_behavior
= VM_BEHAVIOR_SEQUENTIAL
;
937 new_behavior
= VM_BEHAVIOR_DEFAULT
;
940 new_behavior
= VM_BEHAVIOR_WILLNEED
;
943 new_behavior
= VM_BEHAVIOR_DONTNEED
;
946 new_behavior
= VM_BEHAVIOR_FREE
;
948 case MADV_ZERO_WIRED_PAGES
:
949 new_behavior
= VM_BEHAVIOR_ZERO_WIRED_PAGES
;
951 case MADV_FREE_REUSABLE
:
952 new_behavior
= VM_BEHAVIOR_REUSABLE
;
954 case MADV_FREE_REUSE
:
955 new_behavior
= VM_BEHAVIOR_REUSE
;
958 new_behavior
= VM_BEHAVIOR_CAN_REUSE
;
962 new_behavior
= VM_BEHAVIOR_PAGEOUT
;
964 #else /* MACH_ASSERT */
966 #endif /* MACH_ASSERT */
971 start
= (mach_vm_offset_t
) uap
->addr
;
972 size
= (mach_vm_size_t
) uap
->len
;
977 (uap
->behav
== MADV_FREE
||
978 uap
->behav
== MADV_FREE_REUSABLE
)) {
979 printf("** FOURK_COMPAT: %d[%s] "
980 "failing madvise(0x%llx,0x%llx,%s)\n",
981 p
->p_pid
, p
->p_comm
, start
, size
,
982 ((uap
->behav
== MADV_FREE_REUSABLE
)
983 ? "MADV_FREE_REUSABLE"
985 DTRACE_VM3(fourk_compat_madvise
,
991 #endif /* __arm64__ */
993 user_map
= current_map();
995 result
= mach_vm_behavior_set(user_map
, start
, size
, new_behavior
);
999 case KERN_INVALID_ADDRESS
:
1009 mincore(__unused proc_t p
, struct mincore_args
*uap
, __unused
int32_t *retval
)
1011 mach_vm_offset_t addr
= 0, first_addr
= 0, end
= 0, cur_end
= 0;
1012 vm_map_t map
= VM_MAP_NULL
;
1013 user_addr_t vec
= 0;
1015 int vecindex
= 0, lastvecindex
= 0;
1018 unsigned int pqueryinfo_vec_size
= 0;
1019 vm_page_info_basic_t info
= NULL
;
1020 mach_msg_type_number_t count
= 0;
1021 char *kernel_vec
= NULL
;
1022 int req_vec_size_pages
= 0, cur_vec_size_pages
= 0;
1023 kern_return_t kr
= KERN_SUCCESS
;
1025 map
= current_map();
1028 * Make sure that the addresses presented are valid for user
1031 first_addr
= addr
= vm_map_trunc_page(uap
->addr
,
1032 vm_map_page_mask(map
));
1033 end
= vm_map_round_page(uap
->addr
+ uap
->len
,
1034 vm_map_page_mask(map
));
1043 * We are going to loop through the whole 'req_vec_size' pages
1044 * range in chunks of 'cur_vec_size'.
1047 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1048 cur_vec_size_pages
= MIN(req_vec_size_pages
, (int)(MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1050 kernel_vec
= (void*) _MALLOC(cur_vec_size_pages
* sizeof(char), M_TEMP
, M_WAITOK
);
1052 if (kernel_vec
== NULL
) {
1057 * Address of byte vector
1061 pqueryinfo_vec_size
= cur_vec_size_pages
* sizeof(struct vm_page_info_basic
);
1062 info
= (void*) _MALLOC(pqueryinfo_vec_size
, M_TEMP
, M_WAITOK
);
1065 FREE(kernel_vec
, M_TEMP
);
1069 while (addr
< end
) {
1071 cur_end
= addr
+ (cur_vec_size_pages
* PAGE_SIZE_64
);
1073 count
= VM_PAGE_INFO_BASIC_COUNT
;
1074 kr
= vm_map_page_range_info_internal(map
,
1078 (vm_page_info_t
) info
,
1081 assert(kr
== KERN_SUCCESS
);
1084 * Do this on a map entry basis so that if the pages are not
1085 * in the current processes address space, we can easily look
1086 * up the pages elsewhere.
1089 for( ; addr
< cur_end
; addr
+= PAGE_SIZE
) {
1091 pqueryinfo
= info
[lastvecindex
+ 1].disposition
;
1095 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PRESENT
)
1096 mincoreinfo
|= MINCORE_INCORE
;
1097 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_REF
)
1098 mincoreinfo
|= MINCORE_REFERENCED
;
1099 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_DIRTY
)
1100 mincoreinfo
|= MINCORE_MODIFIED
;
1101 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_PAGED_OUT
)
1102 mincoreinfo
|= MINCORE_PAGED_OUT
;
1103 if (pqueryinfo
& VM_PAGE_QUERY_PAGE_COPIED
)
1104 mincoreinfo
|= MINCORE_COPIED
;
1105 if ((pqueryinfo
& VM_PAGE_QUERY_PAGE_EXTERNAL
) == 0)
1106 mincoreinfo
|= MINCORE_ANONYMOUS
;
1108 * calculate index into user supplied byte vector
1110 vecindex
= (addr
- first_addr
)>> PAGE_SHIFT
;
1111 kernel_vec
[vecindex
] = (char)mincoreinfo
;
1112 lastvecindex
= vecindex
;
1116 assert(vecindex
== (cur_vec_size_pages
- 1));
1118 error
= copyout(kernel_vec
, vec
, cur_vec_size_pages
* sizeof(char) /* a char per page */);
1125 * For the next chunk, we'll need:
1126 * - bump the location in the user buffer for our next disposition.
1128 * - starting address
1130 vec
+= cur_vec_size_pages
* sizeof(char);
1131 req_vec_size_pages
= (end
- addr
) >> PAGE_SHIFT
;
1132 cur_vec_size_pages
= MIN(req_vec_size_pages
, (int)(MAX_PAGE_RANGE_QUERY
>> PAGE_SHIFT
));
1137 FREE(kernel_vec
, M_TEMP
);
1148 mlock(__unused proc_t p
, struct mlock_args
*uap
, __unused
int32_t *retvalval
)
1151 vm_map_offset_t addr
;
1152 vm_map_size_t size
, pageoff
;
1153 kern_return_t result
;
1155 AUDIT_ARG(addr
, uap
->addr
);
1156 AUDIT_ARG(len
, uap
->len
);
1158 addr
= (vm_map_offset_t
) uap
->addr
;
1159 size
= (vm_map_size_t
)uap
->len
;
1161 /* disable wrap around */
1162 if (addr
+ size
< addr
)
1168 user_map
= current_map();
1169 pageoff
= (addr
& vm_map_page_mask(user_map
));
1171 size
= vm_map_round_page(size
+pageoff
, vm_map_page_mask(user_map
));
1173 /* have to call vm_map_wire directly to pass "I don't know" protections */
1174 result
= vm_map_wire_kernel(user_map
, addr
, addr
+size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
, TRUE
);
1176 if (result
== KERN_RESOURCE_SHORTAGE
)
1178 else if (result
== KERN_PROTECTION_FAILURE
)
1180 else if (result
!= KERN_SUCCESS
)
1183 return 0; /* KERN_SUCCESS */
1187 munlock(__unused proc_t p
, struct munlock_args
*uap
, __unused
int32_t *retval
)
1189 mach_vm_offset_t addr
;
1190 mach_vm_size_t size
;
1192 kern_return_t result
;
1194 AUDIT_ARG(addr
, uap
->addr
);
1195 AUDIT_ARG(addr
, uap
->len
);
1197 addr
= (mach_vm_offset_t
) uap
->addr
;
1198 size
= (mach_vm_size_t
)uap
->len
;
1199 user_map
= current_map();
1201 /* JMM - need to remove all wirings by spec - this just removes one */
1202 result
= mach_vm_wire_kernel(host_priv_self(), user_map
, addr
, size
, VM_PROT_NONE
, VM_KERN_MEMORY_MLOCK
);
1203 return (result
== KERN_SUCCESS
? 0 : ENOMEM
);
1208 mlockall(__unused proc_t p
, __unused
struct mlockall_args
*uap
, __unused
int32_t *retval
)
1214 munlockall(__unused proc_t p
, __unused
struct munlockall_args
*uap
, __unused
int32_t *retval
)
1219 #if CONFIG_CODE_DECRYPTION
1221 mremap_encrypted(__unused
struct proc
*p
, struct mremap_encrypted_args
*uap
, __unused
int32_t *retval
)
1223 mach_vm_offset_t user_addr
;
1224 mach_vm_size_t user_size
;
1225 kern_return_t result
;
1229 cpu_subtype_t cpusubtype
;
1230 pager_crypt_info_t crypt_info
;
1231 const char * cryptname
= 0;
1234 struct proc_regioninfo_internal pinfo
;
1236 uintptr_t vnodeaddr
;
1239 AUDIT_ARG(addr
, uap
->addr
);
1240 AUDIT_ARG(len
, uap
->len
);
1242 user_map
= current_map();
1243 user_addr
= (mach_vm_offset_t
) uap
->addr
;
1244 user_size
= (mach_vm_size_t
) uap
->len
;
1246 cryptid
= uap
->cryptid
;
1247 cputype
= uap
->cputype
;
1248 cpusubtype
= uap
->cpusubtype
;
1250 if (user_addr
& vm_map_page_mask(user_map
)) {
1251 /* UNIX SPEC: user address is not page-aligned, return EINVAL */
1257 /* not encrypted, just an empty load command */
1260 cryptname
="com.apple.unfree";
1263 /* some random cryptid that you could manually put into
1264 * your binary if you want NULL */
1265 cryptname
="com.apple.null";
1271 if (NULL
== text_crypter_create
) return ENOTSUP
;
1273 ret
= fill_procregioninfo_onlymappedvnodes( proc_task(p
), user_addr
, &pinfo
, &vnodeaddr
, &vid
);
1274 if (ret
== 0 || !vnodeaddr
) {
1275 /* No really, this returns 0 if the memory address is not backed by a file */
1279 vp
= (vnode_t
)vnodeaddr
;
1280 if ((vnode_getwithvid(vp
, vid
)) == 0) {
1281 MALLOC_ZONE(vpath
, char *, MAXPATHLEN
, M_NAMEI
, M_WAITOK
);
1288 ret
= vn_getpath(vp
, vpath
, &len
);
1290 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1301 kprintf("%s vpath %s cryptid 0x%08x cputype 0x%08x cpusubtype 0x%08x range 0x%016llx size 0x%016llx\n",
1302 __FUNCTION__
, vpath
, cryptid
, cputype
, cpusubtype
, (uint64_t)user_addr
, (uint64_t)user_size
);
1305 /* set up decrypter first */
1306 crypt_file_data_t crypt_data
= {
1309 .cpusubtype
= cpusubtype
};
1310 result
= text_crypter_create(&crypt_info
, cryptname
, (void*)&crypt_data
);
1311 #if VM_MAP_DEBUG_APPLE_PROTECT
1312 if (vm_map_debug_apple_protect
) {
1313 printf("APPLE_PROTECT: %d[%s] map %p [0x%llx:0x%llx] %s(%s) -> 0x%x\n",
1314 p
->p_pid
, p
->p_comm
,
1316 (uint64_t) user_addr
,
1317 (uint64_t) (user_addr
+ user_size
),
1318 __FUNCTION__
, vpath
, result
);
1320 #endif /* VM_MAP_DEBUG_APPLE_PROTECT */
1321 FREE_ZONE(vpath
, MAXPATHLEN
, M_NAMEI
);
1324 printf("%s: unable to create decrypter %s, kr=%d\n",
1325 __FUNCTION__
, cryptname
, result
);
1326 if (result
== kIOReturnNotPrivileged
) {
1327 /* text encryption returned decryption failure */
1334 /* now remap using the decrypter */
1335 vm_object_offset_t crypto_backing_offset
;
1336 crypto_backing_offset
= -1; /* i.e. use map entry's offset */
1337 result
= vm_map_apple_protected(user_map
,
1339 user_addr
+user_size
,
1340 crypto_backing_offset
,
1343 printf("%s: mapping failed with %d\n", __FUNCTION__
, result
);
1351 #endif /* CONFIG_CODE_DECRYPTION */