2 * Copyright (c) 2000-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@
28 /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
30 * Mach Operating System
31 * Copyright (c) 1987 Carnegie-Mellon University
32 * All rights reserved. The CMU software License Agreement specifies
33 * the terms and conditions for use and redistribution.
39 * Copyright (c) 1982, 1986, 1991, 1993
40 * The Regents of the University of California. All rights reserved.
41 * (c) UNIX System Laboratories, Inc.
42 * All or some portions of this file are derived from material licensed
43 * to the University of California by American Telephone and Telegraph
44 * Co. or Unix System Laboratories, Inc. and are reproduced herein with
45 * the permission of UNIX System Laboratories, Inc.
47 * Redistribution and use in source and binary forms, with or without
48 * modification, are permitted provided that the following conditions
50 * 1. Redistributions of source code must retain the above copyright
51 * notice, this list of conditions and the following disclaimer.
52 * 2. Redistributions in binary form must reproduce the above copyright
53 * notice, this list of conditions and the following disclaimer in the
54 * documentation and/or other materials provided with the distribution.
55 * 3. All advertising materials mentioning features or use of this software
56 * must display the following acknowledgement:
57 * This product includes software developed by the University of
58 * California, Berkeley and its contributors.
59 * 4. Neither the name of the University nor the names of its contributors
60 * may be used to endorse or promote products derived from this software
61 * without specific prior written permission.
63 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
64 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
65 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
66 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
67 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
68 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
69 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
70 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
71 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
72 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
75 * from: @(#)kern_exec.c 8.1 (Berkeley) 6/10/93
78 * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce
79 * support for mandatory and extensible security protections. This notice
80 * is included in support of clause 2.2 (b) of the Apple Public License,
83 #include <machine/reg.h>
85 #include <sys/param.h>
86 #include <sys/systm.h>
87 #include <sys/filedesc.h>
88 #include <sys/kernel.h>
89 #include <sys/proc_internal.h>
90 #include <sys/kauth.h>
92 #include <sys/socketvar.h>
93 #include <sys/malloc.h>
94 #include <sys/namei.h>
95 #include <sys/mount_internal.h>
96 #include <sys/vnode_internal.h>
97 #include <sys/file_internal.h>
99 #include <sys/uio_internal.h>
100 #include <sys/acct.h>
101 #include <sys/exec.h>
102 #include <sys/kdebug.h>
103 #include <sys/signal.h>
104 #include <sys/aio_kern.h>
105 #include <sys/sysproto.h>
107 #include <sys/shm_internal.h> /* shmexec() */
109 #include <sys/ubc_internal.h> /* ubc_map() */
110 #include <sys/spawn.h>
111 #include <sys/spawn_internal.h>
112 #include <sys/codesign.h>
114 #include <bsm/audit_kernel.h>
116 #include <ipc/ipc_types.h>
118 #include <mach/mach_types.h>
119 #include <mach/task.h>
120 #include <mach/thread_act.h>
121 #include <mach/vm_map.h>
122 #include <mach/mach_vm.h>
123 #include <mach/vm_param.h>
126 #include <security/mac.h>
127 #include <security/mac_mach_internal.h>
130 #include <vm/vm_map.h>
131 #include <vm/vm_kern.h>
132 #include <vm/vm_protos.h>
133 #include <vm/vm_kern.h>
136 /* Do not include dtrace.h, it redefines kmem_[alloc/free] */
137 extern void (*dtrace_fasttrap_exec_ptr
)(proc_t
);
138 extern void (*dtrace_helpers_cleanup
)(proc_t
);
139 extern void dtrace_lazy_dofs_destroy(proc_t
);
141 #include <sys/dtrace_ptss.h>
144 /* support for child creation in exec after vfork */
145 thread_t
fork_create_child(task_t parent_task
, proc_t child_proc
, int inherit_memory
, int is64bit
);
146 void vfork_exit(proc_t p
, int rv
);
147 int setsigvec(proc_t
, int, struct __user_sigaction
*);
150 * Mach things for which prototypes are unavailable from Mach headers
154 void ipc_thread_reset(
156 kern_return_t
ipc_object_copyin(
158 mach_port_name_t name
,
159 mach_msg_type_name_t msgt_name
,
160 ipc_object_t
*objectp
);
161 void ipc_port_release_send(ipc_port_t
);
163 extern struct savearea
*get_user_regs(thread_t
);
166 #include <kern/thread.h>
167 #include <kern/task.h>
168 #include <kern/ast.h>
169 #include <kern/mach_loader.h>
170 #include <mach-o/fat.h>
171 #include <mach-o/loader.h>
172 #include <machine/vmparam.h>
173 #include <sys/imgact.h>
179 * SIZE_MAXPTR The maximum size of a user space pointer, in bytes
180 * SIZE_IMG_STRSPACE The available string space, minus two pointers; we
181 * define it interms of the maximum, since we don't
182 * know the pointer size going in, until after we've
183 * parsed the executable image.
185 #define SIZE_MAXPTR 8 /* 64 bits */
186 #define SIZE_IMG_STRSPACE (NCARGS - 2 * SIZE_MAXPTR)
189 * EAI_ITERLIMIT The maximum number of times to iterate an image
190 * activator in exec_activate_image() before treating
191 * it as malformed/corrupt.
193 #define EAI_ITERLIMIT 10
195 extern vm_map_t bsd_pageable_map
;
196 extern struct fileops vnops
;
198 #define ROUND_PTR(type, addr) \
199 (type *)( ( (unsigned)(addr) + 16 - 1) \
202 struct image_params
; /* Forward */
203 static int exec_activate_image(struct image_params
*imgp
);
204 static int exec_copyout_strings(struct image_params
*imgp
, user_addr_t
*stackp
);
205 static int load_return_to_errno(load_return_t lrtn
);
206 static int execargs_alloc(struct image_params
*imgp
);
207 static int execargs_free(struct image_params
*imgp
);
208 static int exec_check_permissions(struct image_params
*imgp
);
209 static int exec_extract_strings(struct image_params
*imgp
);
210 static int exec_handle_sugid(struct image_params
*imgp
);
211 static int sugid_scripts
= 0;
212 SYSCTL_INT (_kern
, OID_AUTO
, sugid_scripts
, CTLFLAG_RW
, &sugid_scripts
, 0, "");
213 static kern_return_t
create_unix_stack(vm_map_t map
, user_addr_t user_stack
,
214 int customstack
, proc_t p
);
215 static int copyoutptr(user_addr_t ua
, user_addr_t ptr
, int ptr_size
);
216 static void exec_resettextvp(proc_t
, struct image_params
*);
218 /* We don't want this one exported */
220 int open1(vfs_context_t
, struct nameidata
*, int, struct vnode_attr
*, register_t
*);
225 * Add the requested string to the string space area.
227 * Parameters; struct image_params * image parameter block
228 * user_addr_t string to add to strings area
231 * !0 Failure errno from copyinstr()
234 * (imgp->ip_strendp) updated location of next add, if any
235 * (imgp->ip_strspace) updated byte count of space remaining
238 exec_add_string(struct image_params
*imgp
, user_addr_t str
)
244 if (imgp
->ip_strspace
<= 0) {
248 if (IS_UIO_SYS_SPACE(imgp
->ip_seg
)) {
249 char *kstr
= CAST_DOWN(char *,str
); /* SAFE */
250 error
= copystr(kstr
, imgp
->ip_strendp
, imgp
->ip_strspace
, &len
);
252 error
= copyinstr(str
, imgp
->ip_strendp
, imgp
->ip_strspace
,
255 imgp
->ip_strendp
+= len
;
256 imgp
->ip_strspace
-= len
;
257 } while (error
== ENAMETOOLONG
);
265 * To support new app package launching for Mac OS X, the dyld needs the
266 * first argument to execve() stored on the user stack.
268 * Save the executable path name at the top of the strings area and set
269 * the argument vector pointer to the location following that to indicate
270 * the start of the argument and environment tuples, setting the remaining
271 * string space count to the size of the string area minus the path length
272 * and a reserve for two pointers.
274 * Parameters; struct image_params * image parameter block
275 * char * path used to invoke program
276 * int segment from which path comes
278 * Returns: int 0 Success
280 * copy[in]str:EFAULT Bad address
281 * copy[in]str:ENAMETOOLONG Filename too long
284 * (imgp->ip_strings) saved path
285 * (imgp->ip_strspace) space remaining in ip_strings
286 * (imgp->ip_argv) beginning of argument list
287 * (imgp->ip_strendp) start of remaining copy area
289 * Note: We have to do this before the initial namei() since in the
290 * path contains symbolic links, namei() will overwrite the
291 * original path buffer contents. If the last symbolic link
292 * resolved was a relative pathname, we would lose the original
293 * "path", which could be an absolute pathname. This might be
294 * unacceptable for dyld.
297 exec_save_path(struct image_params
*imgp
, user_addr_t path
, int seg
)
301 char *kpath
= CAST_DOWN(char *,path
); /* SAFE */
303 imgp
->ip_strendp
= imgp
->ip_strings
;
304 imgp
->ip_strspace
= SIZE_IMG_STRSPACE
;
306 len
= MIN(MAXPATHLEN
, imgp
->ip_strspace
);
309 case UIO_USERSPACE32
:
310 case UIO_USERSPACE64
: /* Same for copyin()... */
311 error
= copyinstr(path
, imgp
->ip_strings
, len
, &len
);
314 error
= copystr(kpath
, imgp
->ip_strings
, len
, &len
);
322 imgp
->ip_strendp
+= len
;
323 imgp
->ip_strspace
-= len
;
324 imgp
->ip_argv
= imgp
->ip_strendp
;
332 * exec_powerpc32_imgact
334 * Implicitly invoke the PowerPC handler for a byte-swapped image magic
335 * number. This may happen either as a result of an attempt to invoke a
336 * PowerPC image directly, or indirectly as the interpreter used in an
337 * interpreter script.
339 * Parameters; struct image_params * image parameter block
341 * Returns: -1 not an PowerPC image (keep looking)
342 * -3 Success: exec_archhandler_ppc: relookup
343 * >0 Failure: exec_archhandler_ppc: error number
345 * Note: This image activator does not handle the case of a direct
346 * invocation of the exec_archhandler_ppc, since in that case, the
347 * exec_archhandler_ppc itself is not a PowerPC binary; instead,
348 * binary image activators must recognize the exec_archhandler_ppc;
349 * This is managed in exec_check_permissions().
351 * Note: This image activator is limited to 32 bit powerpc images;
352 * if support for 64 bit powerpc images is desired, it would
353 * be more in line with this design to write a separate 64 bit
357 exec_powerpc32_imgact(struct image_params
*imgp
)
359 struct mach_header
*mach_header
= (struct mach_header
*)imgp
->ip_vdata
;
364 * Make sure it's a PowerPC binary. If we've already redirected
365 * from an interpreted file once, don't do it again.
367 if (mach_header
->magic
!= MH_CIGAM
) {
369 * If it's a cross-architecture 64 bit binary, then claim
370 * it, but refuse to run it.
372 if (mach_header
->magic
== MH_CIGAM_64
)
377 /* If there is no exec_archhandler_ppc, we can't run it */
378 if (exec_archhandler_ppc
.path
[0] == 0)
381 /* Remember the type of the original file for later grading */
382 if (!imgp
->ip_origcputype
) {
383 imgp
->ip_origcputype
=
384 OSSwapBigToHostInt32(mach_header
->cputype
);
385 imgp
->ip_origcpusubtype
=
386 OSSwapBigToHostInt32(mach_header
->cpusubtype
);
390 * The PowerPC flag will be set by the exec_check_permissions()
391 * call anyway; however, we set this flag here so that the relookup
392 * in execve() does not follow symbolic links, as a side effect.
394 imgp
->ip_flags
|= IMGPF_POWERPC
;
396 /* impute an interpreter */
397 error
= copystr(exec_archhandler_ppc
.path
, imgp
->ip_interp_name
,
403 * provide a replacement string for p->p_comm; we have to use an
404 * an alternate buffer for this, rather than replacing it directly,
405 * since the exec may fail and return to the parent. In that case,
406 * we would have erroneously changed the parent p->p_comm instead.
408 strlcpy(imgp
->ip_p_comm
, imgp
->ip_ndp
->ni_cnd
.cn_nameptr
, MAXCOMLEN
);
412 #endif /* IMGPF_POWERPC */
418 * Image activator for interpreter scripts. If the image begins with the
419 * characters "#!", then it is an interpreter script. Verify that we are
420 * not already executing in PowerPC mode, and that the length of the script
421 * line indicating the interpreter is not in excess of the maximum allowed
422 * size. If this is the case, then break out the arguments, if any, which
423 * are separated by white space, and copy them into the argument save area
424 * as if they were provided on the command line before all other arguments.
425 * The line ends when we encounter a comment character ('#') or newline.
427 * Parameters; struct image_params * image parameter block
429 * Returns: -1 not an interpreter (keep looking)
430 * -3 Success: interpreter: relookup
431 * >0 Failure: interpreter: error number
433 * A return value other than -1 indicates subsequent image activators should
434 * not be given the opportunity to attempt to activate the image.
437 exec_shell_imgact(struct image_params
*imgp
)
439 char *vdata
= imgp
->ip_vdata
;
451 * Make sure it's a shell script. If we've already redirected
452 * from an interpreted file once, don't do it again.
454 * Note: We disallow PowerPC, since the expectation is that we
455 * may run a PowerPC interpreter, but not an interpret a PowerPC
456 * image. This is consistent with historical behaviour.
458 if (vdata
[0] != '#' ||
460 (imgp
->ip_flags
& IMGPF_INTERPRET
) != 0) {
465 if ((imgp
->ip_flags
& IMGPF_POWERPC
) != 0)
467 #endif /* IMGPF_POWERPC */
469 imgp
->ip_flags
|= IMGPF_INTERPRET
;
471 /* Check to see if SUGID scripts are permitted. If they aren't then
472 * clear the SUGID bits.
473 * imgp->ip_vattr is known to be valid.
475 if (sugid_scripts
== 0) {
476 imgp
->ip_origvattr
->va_mode
&= ~(VSUID
| VSGID
);
479 /* Find the nominal end of the interpreter line */
480 for( ihp
= &vdata
[2]; *ihp
!= '\n' && *ihp
!= '#'; ihp
++) {
481 if (ihp
>= &vdata
[IMG_SHSIZE
])
487 /* Skip over leading spaces - until the interpreter name */
488 while ( ihp
< line_endp
&& ((*ihp
== ' ') || (*ihp
== '\t')))
492 * Find the last non-whitespace character before the end of line or
493 * the beginning of a comment; this is our new end of line.
495 for (;line_endp
> ihp
&& ((*line_endp
== ' ') || (*line_endp
== '\t')); line_endp
--)
499 if (line_endp
== ihp
)
502 /* copy the interpreter name */
503 interp
= imgp
->ip_interp_name
;
504 while ((ihp
< line_endp
) && (*ihp
!= ' ') && (*ihp
!= '\t'))
508 exec_save_path(imgp
, CAST_USER_ADDR_T(imgp
->ip_interp_name
),
512 while (ihp
< line_endp
) {
513 /* Skip leading whitespace before each argument */
514 while ((*ihp
== ' ') || (*ihp
== '\t'))
517 if (ihp
>= line_endp
)
520 /* We have an argument; copy it */
521 while ((ihp
< line_endp
) && (*ihp
!= ' ') && (*ihp
!= '\t')) {
522 *imgp
->ip_strendp
++ = *ihp
++;
525 *imgp
->ip_strendp
++ = 0;
531 * If we have a SUID oder SGID script, create a file descriptor
532 * from the vnode and pass /dev/fd/%d instead of the actual
533 * path name so that the script does not get opened twice
535 if (imgp
->ip_origvattr
->va_mode
& (VSUID
| VSGID
)) {
536 p
= vfs_context_proc(imgp
->ip_vfs_context
);
537 error
= falloc(p
, &fp
, &fd
, imgp
->ip_vfs_context
);
541 fp
->f_fglob
->fg_flag
= FREAD
;
542 fp
->f_fglob
->fg_type
= DTYPE_VNODE
;
543 fp
->f_fglob
->fg_ops
= &vnops
;
544 fp
->f_fglob
->fg_data
= (caddr_t
)imgp
->ip_vp
;
547 procfdtbl_releasefd(p
, fd
, NULL
);
548 fp_drop(p
, fd
, fp
, 1);
550 vnode_ref(imgp
->ip_vp
);
552 snprintf(temp
, sizeof(temp
), "/dev/fd/%d", fd
);
553 error
= copyoutstr(temp
, imgp
->ip_user_fname
, sizeof(temp
), &len
);
566 * Image activator for fat 1.0 binaries. If the binary is fat, then we
567 * need to select an image from it internally, and make that the image
568 * we are going to attempt to execute. At present, this consists of
569 * reloading the first page for the image with a first page from the
570 * offset location indicated by the fat header.
572 * Parameters; struct image_params * image parameter block
574 * Returns: -1 not a fat binary (keep looking)
575 * -2 Success: encapsulated binary: reread
576 * >0 Failure: error number
578 * Important: This image activator is byte order neutral.
580 * Note: A return value other than -1 indicates subsequent image
581 * activators should not be given the opportunity to attempt
582 * to activate the image.
584 * If we find an encapsulated binary, we make no assertions
585 * about its validity; instead, we leave that up to a rescan
586 * for an activator to claim it, and, if it is claimed by one,
587 * that activator is responsible for determining validity.
590 exec_fat_imgact(struct image_params
*imgp
)
592 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
593 kauth_cred_t cred
= kauth_cred_proc_ref(p
);
594 struct fat_header
*fat_header
= (struct fat_header
*)imgp
->ip_vdata
;
595 struct _posix_spawnattr
*psa
= NULL
;
596 struct fat_arch fat_arch
;
600 /* Make sure it's a fat binary */
601 if ((fat_header
->magic
!= FAT_MAGIC
) &&
602 (fat_header
->magic
!= FAT_CIGAM
)) {
607 /* If posix_spawn binprefs exist, respect those prefs. */
608 psa
= (struct _posix_spawnattr
*) imgp
->ip_px_sa
;
609 if (psa
!= NULL
&& psa
->psa_binprefs
[0] != 0) {
610 struct fat_arch
*arches
= (struct fat_arch
*) (fat_header
+ 1);
611 int nfat_arch
= 0, pr
= 0, f
= 0;
613 nfat_arch
= OSSwapBigToHostInt32(fat_header
->nfat_arch
);
614 /* Check each preference listed against all arches in header */
615 for (pr
= 0; pr
< NBINPREFS
; pr
++) {
616 cpu_type_t pref
= psa
->psa_binprefs
[pr
];
618 /* No suitable arch in the pref list */
623 if (pref
== CPU_TYPE_ANY
) {
624 /* Fall through to regular grading */
628 for (f
= 0; f
< nfat_arch
; f
++) {
629 cpu_type_t archtype
= OSSwapBigToHostInt32(
631 cpu_type_t archsubtype
= OSSwapBigToHostInt32(
632 arches
[f
].cpusubtype
) & ~CPU_SUBTYPE_MASK
;
633 if (pref
== archtype
&&
634 grade_binary(archtype
, archsubtype
)) {
635 /* We have a winner! */
636 fat_arch
.cputype
= archtype
;
637 fat_arch
.cpusubtype
= archsubtype
;
638 fat_arch
.offset
= OSSwapBigToHostInt32(
640 fat_arch
.size
= OSSwapBigToHostInt32(
642 fat_arch
.align
= OSSwapBigToHostInt32(
650 /* Look up our preferred architecture in the fat file. */
651 lret
= fatfile_getarch_affinity(imgp
->ip_vp
,
652 (vm_offset_t
)fat_header
,
654 (p
->p_flag
& P_AFFINITY
));
655 if (lret
!= LOAD_SUCCESS
) {
656 error
= load_return_to_errno(lret
);
661 /* Read the Mach-O header out of fat_arch */
662 error
= vn_rdwr(UIO_READ
, imgp
->ip_vp
, imgp
->ip_vdata
,
663 PAGE_SIZE
, fat_arch
.offset
,
664 UIO_SYSSPACE32
, (IO_UNIT
|IO_NODELOCKED
),
670 /* Did we read a complete header? */
676 /* Success. Indicate we have identified an encapsulated binary */
678 imgp
->ip_arch_offset
= (user_size_t
)fat_arch
.offset
;
679 imgp
->ip_arch_size
= (user_size_t
)fat_arch
.size
;
682 kauth_cred_unref(&cred
);
689 * Image activator for mach-o 1.0 binaries.
691 * Parameters; struct image_params * image parameter block
693 * Returns: -1 not a fat binary (keep looking)
694 * -2 Success: encapsulated binary: reread
695 * >0 Failure: error number
696 * EBADARCH Mach-o binary, but with an unrecognized
698 * ENOMEM No memory for child process after -
699 * can only happen after vfork()
701 * Important: This image activator is NOT byte order neutral.
703 * Note: A return value other than -1 indicates subsequent image
704 * activators should not be given the opportunity to attempt
705 * to activate the image.
707 * TODO: More gracefully handle failures after vfork
710 exec_mach_imgact(struct image_params
*imgp
)
712 struct mach_header
*mach_header
= (struct mach_header
*)imgp
->ip_vdata
;
713 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
717 task_t new_task
= NULL
; /* protected by vfexec */
719 struct uthread
*uthread
;
720 vm_map_t old_map
= VM_MAP_NULL
;
723 load_result_t load_result
;
724 struct _posix_spawnattr
*psa
= NULL
;
727 * make sure it's a Mach-O 1.0 or Mach-O 2.0 binary; the difference
728 * is a reserved field on the end, so for the most part, we can
729 * treat them as if they were identical.
731 if ((mach_header
->magic
!= MH_MAGIC
) &&
732 (mach_header
->magic
!= MH_MAGIC_64
)) {
737 switch (mach_header
->filetype
) {
744 if (!imgp
->ip_origcputype
) {
745 imgp
->ip_origcputype
= mach_header
->cputype
;
746 imgp
->ip_origcpusubtype
= mach_header
->cpusubtype
;
749 task
= current_task();
750 thread
= current_thread();
751 uthread
= get_bsdthread_info(thread
);
753 if (uthread
->uu_flag
& UT_VFORK
)
754 vfexec
= 1; /* Mark in exec */
756 if ((mach_header
->cputype
& CPU_ARCH_ABI64
) == CPU_ARCH_ABI64
)
757 imgp
->ip_flags
|= IMGPF_IS_64BIT
;
759 /* If posix_spawn binprefs exist, respect those prefs. */
760 psa
= (struct _posix_spawnattr
*) imgp
->ip_px_sa
;
761 if (psa
!= NULL
&& psa
->psa_binprefs
[0] != 0) {
763 for (pr
= 0; pr
< NBINPREFS
; pr
++) {
764 cpu_type_t pref
= psa
->psa_binprefs
[pr
];
766 /* No suitable arch in the pref list */
771 if (pref
== CPU_TYPE_ANY
) {
772 /* Jump to regular grading */
776 if (pref
== imgp
->ip_origcputype
) {
777 /* We have a match! */
785 if (!grade_binary(imgp
->ip_origcputype
& ~CPU_SUBTYPE_LIB64
,
786 imgp
->ip_origcpusubtype
& ~CPU_SUBTYPE_MASK
)) {
791 /* Copy in arguments/environment from the old process */
792 error
= exec_extract_strings(imgp
);
797 * Hack for binary compatability; put three NULs on the end of the
798 * string area, and round it up to the next word boundary. This
799 * ensures padding with NULs to the boundary.
801 imgp
->ip_strendp
[0] = 0;
802 imgp
->ip_strendp
[1] = 0;
803 imgp
->ip_strendp
[2] = 0;
804 imgp
->ip_strendp
+= (((imgp
->ip_strendp
- imgp
->ip_strings
) + NBPW
-1) & ~(NBPW
-1));
810 * Should be factored out; this is here because we might be getting
811 * invoked this way as the result of a shell script, and the check
812 * in exec_check_permissions() is not interior to the jump back up
813 * to the "encapsulated_binary:" label in exec_activate_image().
815 if (imgp
->ip_vattr
->va_fsid
== exec_archhandler_ppc
.fsid
&&
816 imgp
->ip_vattr
->va_fileid
== (uint64_t)((u_long
)exec_archhandler_ppc
.fileid
)) {
817 imgp
->ip_flags
|= IMGPF_POWERPC
;
819 #endif /* IMGPF_POWERPC */
822 imgp
->ip_vfork_thread
= fork_create_child(task
, p
, FALSE
, (imgp
->ip_flags
& IMGPF_IS_64BIT
));
823 if (imgp
->ip_vfork_thread
== NULL
) {
827 /* reset local idea of thread, uthread, task */
828 thread
= imgp
->ip_vfork_thread
;
829 uthread
= get_bsdthread_info(thread
);
830 task
= new_task
= get_threadtask(thread
);
831 map
= get_task_map(task
);
837 * We set these flags here; this is OK, since if we fail after
838 * this point, we have already destroyed the parent process anyway.
840 if (imgp
->ip_flags
& IMGPF_IS_64BIT
) {
841 task_set_64bit(task
, TRUE
);
842 OSBitOrAtomic(P_LP64
, (UInt32
*)&p
->p_flag
);
844 task_set_64bit(task
, FALSE
);
845 OSBitAndAtomic(~((uint32_t)P_LP64
), (UInt32
*)&p
->p_flag
);
849 * Load the Mach-O file.
853 * NOTE: An error after this point indicates we have potentially
854 * destroyed or overwrote some process state while attempting an
855 * execve() following a vfork(), which is an unrecoverable condition.
859 * We reset the task to 64-bit (or not) here. It may have picked up
860 * a new map, and we need that to reflect its true 64-bit nature.
864 ((imgp
->ip_flags
& IMGPF_IS_64BIT
) == IMGPF_IS_64BIT
));
867 * Actually load the image file we previously decided to load.
869 lret
= load_machfile(imgp
, mach_header
, thread
, map
, &load_result
);
871 if (lret
!= LOAD_SUCCESS
) {
872 error
= load_return_to_errno(lret
);
876 vm_map_set_user_wire_limit(get_task_map(task
), p
->p_rlimit
[RLIMIT_MEMLOCK
].rlim_cur
);
879 * Set code-signing flags if this binary is signed, or if parent has
880 * requested them on exec.
882 if (load_result
.csflags
& CS_VALID
) {
883 imgp
->ip_csflags
|= load_result
.csflags
&
885 CS_HARD
|CS_KILL
|CS_EXEC_SET_HARD
|CS_EXEC_SET_KILL
);
887 imgp
->ip_csflags
&= ~CS_VALID
;
890 if (p
->p_csflags
& CS_EXEC_SET_HARD
)
891 imgp
->ip_csflags
|= CS_HARD
;
892 if (p
->p_csflags
& CS_EXEC_SET_KILL
)
893 imgp
->ip_csflags
|= CS_KILL
;
896 /* load_machfile() maps the vnode */
897 (void)ubc_map(imgp
->ip_vp
, PROT_READ
| PROT_EXEC
);
900 * Set up the system reserved areas in the new address space.
902 vm_map_exec(get_task_map(task
),
904 (void *) p
->p_fd
->fd_rdir
,
906 imgp
->ip_flags
& IMGPF_POWERPC
?
912 * Close file descriptors
913 * which specify close-on-exec.
918 * deal with set[ug]id.
920 error
= exec_handle_sugid(imgp
);
922 proc_knote(p
, NOTE_EXEC
);
924 if (!vfexec
&& (p
->p_lflag
& P_LTRACED
))
931 if (load_result
.unixproc
&&
932 create_unix_stack(get_task_map(task
),
933 load_result
.user_stack
,
934 load_result
.customstack
,
935 p
) != KERN_SUCCESS
) {
936 error
= load_return_to_errno(LOAD_NOSPACE
);
941 old_map
= vm_map_switch(get_task_map(task
));
944 if (load_result
.unixproc
) {
948 * Copy the strings area out into the new process address
952 error
= exec_copyout_strings(imgp
, &ap
);
955 vm_map_switch(old_map
);
959 thread_setuserstack(thread
, ap
);
962 if (load_result
.dynlinker
) {
965 /* Adjust the stack */
966 if (imgp
->ip_flags
& IMGPF_IS_64BIT
) {
967 ap
= thread_adjuserstack(thread
, -8);
968 error
= copyoutptr(load_result
.mach_header
, ap
, 8);
970 ap
= thread_adjuserstack(thread
, -4);
971 error
= suword(ap
, load_result
.mach_header
);
975 vm_map_switch(old_map
);
981 vm_map_switch(old_map
);
983 /* Set the entry point */
984 thread_setentrypoint(thread
, load_result
.entry_point
);
990 * Reset signal state.
995 * need to cancel async IO requests that can be cancelled and wait for those
996 * already active. MAY BLOCK!
1001 /* FIXME: Till vmspace inherit is fixed: */
1002 if (!vfexec
&& p
->vm_shm
)
1006 /* Clean up the semaphores */
1011 * Remember file name for accounting.
1013 p
->p_acflag
&= ~AFORK
;
1014 /* If the translated name isn't NULL, then we want to use
1015 * that translated name as the name we show as the "real" name.
1016 * Otherwise, use the name passed into exec.
1018 if (0 != imgp
->ip_p_comm
[0]) {
1019 bcopy((caddr_t
)imgp
->ip_p_comm
, (caddr_t
)p
->p_comm
,
1022 if (imgp
->ip_ndp
->ni_cnd
.cn_namelen
> MAXCOMLEN
)
1023 imgp
->ip_ndp
->ni_cnd
.cn_namelen
= MAXCOMLEN
;
1024 bcopy((caddr_t
)imgp
->ip_ndp
->ni_cnd
.cn_nameptr
, (caddr_t
)p
->p_comm
,
1025 (unsigned)imgp
->ip_ndp
->ni_cnd
.cn_namelen
);
1026 p
->p_comm
[imgp
->ip_ndp
->ni_cnd
.cn_namelen
] = '\0';
1031 * Invalidate any predicate evaluation already cached for this thread by DTrace.
1032 * That's because we've just stored to p_comm and DTrace refers to that when it
1033 * evaluates the "execname" special variable. uid and gid may have changed as well.
1035 dtrace_set_thread_predcache(current_thread(), 0);
1038 * Free any outstanding lazy dof entries. It is imperative we
1039 * always call dtrace_lazy_dofs_destroy, rather than null check
1040 * and call if !NULL. If we NULL test, during lazy dof faulting
1041 * we can race with the faulting code and proceed from here to
1042 * beyond the helpers cleanup. The lazy dof faulting will then
1043 * install new helpers which no longer belong to this process!
1045 dtrace_lazy_dofs_destroy(p
);
1049 * Clean up any DTrace helpers for the process.
1051 if (p
->p_dtrace_helpers
!= NULL
&& dtrace_helpers_cleanup
) {
1052 (*dtrace_helpers_cleanup
)(p
);
1056 * Cleanup the DTrace provider associated with this process.
1059 if (p
->p_dtrace_probes
&& dtrace_fasttrap_exec_ptr
) {
1060 (*dtrace_fasttrap_exec_ptr
)(p
);
1065 if (kdebug_enable
) {
1066 long dbg_arg1
, dbg_arg2
, dbg_arg3
, dbg_arg4
;
1069 * Collect the pathname for tracing
1071 kdbg_trace_string(p
, &dbg_arg1
, &dbg_arg2
, &dbg_arg3
, &dbg_arg4
);
1074 KERNEL_DEBUG_CONSTANT1((TRACEDBG_CODE(DBG_TRACE_DATA
, 2)) | DBG_FUNC_NONE
,
1075 p
->p_pid
,0,0,0, (unsigned int)thread
);
1076 KERNEL_DEBUG_CONSTANT1((TRACEDBG_CODE(DBG_TRACE_STRING
, 2)) | DBG_FUNC_NONE
,
1077 dbg_arg1
, dbg_arg2
, dbg_arg3
, dbg_arg4
, (unsigned int)thread
);
1079 KERNEL_DEBUG_CONSTANT((TRACEDBG_CODE(DBG_TRACE_DATA
, 2)) | DBG_FUNC_NONE
,
1081 KERNEL_DEBUG_CONSTANT((TRACEDBG_CODE(DBG_TRACE_STRING
, 2)) | DBG_FUNC_NONE
,
1082 dbg_arg1
, dbg_arg2
, dbg_arg3
, dbg_arg4
, 0);
1086 #ifdef IMGPF_POWERPC
1088 * Mark the process as powerpc or not. If powerpc, set the affinity
1089 * flag, which will be used for grading binaries in future exec's
1092 if (((imgp
->ip_flags
& IMGPF_POWERPC
) != 0))
1093 OSBitOrAtomic(P_TRANSLATED
, (UInt32
*)&p
->p_flag
);
1095 #endif /* IMGPF_POWERPC */
1096 OSBitAndAtomic(~((uint32_t)P_TRANSLATED
), (UInt32
*)&p
->p_flag
);
1097 OSBitAndAtomic(~((uint32_t)P_AFFINITY
), (UInt32
*)&p
->p_flag
);
1100 * If posix_spawned with the START_SUSPENDED flag, stop the
1101 * process before it runs.
1103 if (imgp
->ip_px_sa
!= NULL
) {
1104 psa
= (struct _posix_spawnattr
*) imgp
->ip_px_sa
;
1105 if (psa
->psa_flags
& POSIX_SPAWN_START_SUSPENDED
) {
1109 (void) task_suspend(p
->task
);
1114 * mark as execed, wakeup the process that vforked (if any) and tell
1115 * it that it now has it's own resources back
1117 OSBitOrAtomic(P_EXEC
, (UInt32
*)&p
->p_flag
);
1118 if (p
->p_pptr
&& (p
->p_lflag
& P_LPPWAIT
)) {
1120 p
->p_lflag
&= ~P_LPPWAIT
;
1122 wakeup((caddr_t
)p
->p_pptr
);
1125 if (vfexec
&& (p
->p_lflag
& P_LTRACED
)) {
1126 psignal_vfork(p
, new_task
, thread
, SIGTRAP
);
1131 task_deallocate(new_task
);
1132 thread_deallocate(thread
);
1145 * Our image activator table; this is the table of the image types we are
1146 * capable of loading. We list them in order of preference to ensure the
1147 * fastest image load speed.
1149 * XXX hardcoded, for now; should use linker sets
1152 int (*ex_imgact
)(struct image_params
*);
1153 const char *ex_name
;
1155 { exec_mach_imgact
, "Mach-o Binary" },
1156 { exec_fat_imgact
, "Fat Binary" },
1157 #ifdef IMGPF_POWERPC
1158 { exec_powerpc32_imgact
, "PowerPC binary" },
1159 #endif /* IMGPF_POWERPC */
1160 { exec_shell_imgact
, "Interpreter Script" },
1166 * exec_activate_image
1168 * Description: Iterate through the available image activators, and activate
1169 * the image associated with the imgp structure. We start with
1172 * Parameters: struct image_params * Image parameter block
1174 * Returns: 0 Success
1175 * EBADEXEC The executable is corrupt/unknown
1176 * execargs_alloc:EINVAL Invalid argument
1177 * execargs_alloc:EACCES Permission denied
1178 * execargs_alloc:EINTR Interrupted function
1179 * execargs_alloc:ENOMEM Not enough space
1180 * exec_save_path:EFAULT Bad address
1181 * exec_save_path:ENAMETOOLONG Filename too long
1182 * exec_check_permissions:EACCES Permission denied
1183 * exec_check_permissions:ENOEXEC Executable file format error
1184 * exec_check_permissions:ETXTBSY Text file busy [misuse of error code]
1185 * exec_check_permissions:???
1187 * vn_rdwr:??? [anything vn_rdwr can return]
1188 * <ex_imgact>:??? [anything an imgact can return]
1191 exec_activate_image(struct image_params
*imgp
)
1193 struct nameidata nd
;
1196 int once
= 1; /* save SGUID-ness for interpreted files */
1198 int iterlimit
= EAI_ITERLIMIT
;
1200 error
= execargs_alloc(imgp
);
1205 * XXXAUDIT: Note: the double copyin introduces an audit
1206 * race. To correct this race, we must use a single
1207 * copyin(), e.g. by passing a flag to namei to indicate an
1208 * external path buffer is being used.
1210 error
= exec_save_path(imgp
, imgp
->ip_user_fname
, imgp
->ip_seg
);
1215 DTRACE_PROC1(exec
, uintptr_t, imgp
->ip_strings
);
1217 NDINIT(&nd
, LOOKUP
, FOLLOW
| LOCKLEAF
| AUDITVNPATH1
,
1218 imgp
->ip_seg
, imgp
->ip_user_fname
, imgp
->ip_vfs_context
);
1224 imgp
->ip_ndp
= &nd
; /* successful namei(); call nameidone() later */
1225 imgp
->ip_vp
= nd
.ni_vp
; /* if set, need to vnode_put() at some point */
1227 error
= exec_check_permissions(imgp
);
1231 /* Copy; avoid invocation of an interpreter overwriting the original */
1234 *imgp
->ip_origvattr
= *imgp
->ip_vattr
;
1237 error
= vn_rdwr(UIO_READ
, imgp
->ip_vp
, imgp
->ip_vdata
, PAGE_SIZE
, 0,
1238 UIO_SYSSPACE32
, IO_NODELOCKED
,
1239 vfs_context_ucred(imgp
->ip_vfs_context
),
1240 &resid
, vfs_context_proc(imgp
->ip_vfs_context
));
1244 encapsulated_binary
:
1245 /* Limit the number of iterations we will attempt on each binary */
1246 if (--iterlimit
== 0) {
1251 for(i
= 0; error
== -1 && execsw
[i
].ex_imgact
!= NULL
; i
++) {
1253 error
= (*execsw
[i
].ex_imgact
)(imgp
);
1256 /* case -1: not claimed: continue */
1257 case -2: /* Encapsulated binary */
1258 goto encapsulated_binary
;
1260 case -3: /* Interpreter */
1263 * Copy the script label for later use. Note that
1264 * the label can be different when the script is
1265 * actually read by the interpreter.
1267 if (imgp
->ip_scriptlabelp
)
1268 mac_vnode_label_free(imgp
->ip_scriptlabelp
);
1269 imgp
->ip_scriptlabelp
= mac_vnode_label_alloc();
1270 if (imgp
->ip_scriptlabelp
== NULL
) {
1274 mac_vnode_label_copy(imgp
->ip_vp
->v_label
,
1275 imgp
->ip_scriptlabelp
);
1277 vnode_put(imgp
->ip_vp
);
1278 imgp
->ip_vp
= NULL
; /* already put */
1279 nd
.ni_cnd
.cn_nameiop
= LOOKUP
;
1280 nd
.ni_cnd
.cn_flags
= (nd
.ni_cnd
.cn_flags
& HASBUF
) |
1281 (FOLLOW
| LOCKLEAF
);
1283 #ifdef IMGPF_POWERPC
1285 * PowerPC does not follow symlinks because the
1286 * code which sets exec_archhandler_ppc.fsid and
1287 * exec_archhandler_ppc.fileid doesn't follow them.
1289 if (imgp
->ip_flags
& IMGPF_POWERPC
)
1290 nd
.ni_cnd
.cn_flags
&= ~FOLLOW
;
1291 #endif /* IMGPF_POWERPC */
1293 nd
.ni_segflg
= UIO_SYSSPACE32
;
1294 nd
.ni_dirp
= CAST_USER_ADDR_T(imgp
->ip_interp_name
);
1303 * Call out to allow 3rd party notification of exec.
1304 * Ignore result of kauth_authorize_fileop call.
1306 if (error
== 0 && kauth_authorize_fileop_has_listeners()) {
1307 kauth_authorize_fileop(vfs_context_ucred(imgp
->ip_vfs_context
),
1309 (uintptr_t)nd
.ni_vp
, 0);
1313 if (imgp
->ip_strings
)
1314 execargs_free(imgp
);
1316 nameidone(imgp
->ip_ndp
);
1322 * exec_handle_port_actions
1324 * Description: Go through the _posix_port_actions_t contents,
1325 * calling task_set_special_port and task_set_exception_ports
1326 * for the current task.
1328 * Parameters: struct image_params * Image parameter block
1330 * Returns: 0 Success
1331 * KERN_FAILURE Failure
1334 exec_handle_port_actions(struct image_params
*imgp
)
1336 _posix_spawn_port_actions_t pacts
= imgp
->ip_px_spa
;
1337 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
1338 _ps_port_action_t
*act
= NULL
;
1339 task_t task
= p
->task
;
1340 ipc_port_t port
= NULL
;
1341 kern_return_t ret
= KERN_SUCCESS
;
1344 for (i
= 0; i
< pacts
->pspa_count
; i
++) {
1345 act
= &pacts
->pspa_actions
[i
];
1347 ret
= ipc_object_copyin(get_task_ipcspace(current_task()),
1348 (mach_port_name_t
) act
->new_port
,
1349 MACH_MSG_TYPE_COPY_SEND
,
1350 (ipc_object_t
*) &port
);
1355 switch (act
->port_type
) {
1357 ret
= task_set_special_port(task
,
1361 case PSPA_EXCEPTION
:
1362 ret
= task_set_exception_ports(task
,
1371 /* action failed, so release port resources */
1373 ipc_port_release_send(port
);
1382 * exec_handle_file_actions
1384 * Description: Go through the _posix_file_actions_t contents applying the
1385 * open, close, and dup2 operations to the open file table for
1386 * the current process.
1388 * Parameters: struct image_params * Image parameter block
1390 * Returns: 0 Success
1393 * Note: Actions are applied in the order specified, with the credential
1394 * of the parent process. This is done to permit the parent
1395 * process to utilize POSIX_SPAWN_RESETIDS to drop privilege in
1396 * the child following operations the child may in fact not be
1397 * normally permitted to perform.
1400 exec_handle_file_actions(struct image_params
*imgp
)
1404 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
1405 _posix_spawn_file_actions_t px_sfap
= imgp
->ip_px_sfa
;
1406 register_t ival
[2]; /* dummy retval for system calls) */
1408 for (action
= 0; action
< px_sfap
->psfa_act_count
; action
++) {
1409 _psfa_action_t
*psfa
= &px_sfap
->psfa_act_acts
[ action
];
1411 switch(psfa
->psfaa_type
) {
1414 * Open is different, in that it requires the use of
1415 * a path argument, which is normally copied in from
1416 * user space; because of this, we have to support an
1417 * open from kernel space that passes an address space
1418 * context oof UIO_SYSSPACE, and casts the address
1419 * argument to a user_addr_t.
1421 struct vnode_attr va
;
1422 struct nameidata nd
;
1423 int mode
= psfa
->psfaa_openargs
.psfao_mode
;
1424 struct dup2_args dup2a
;
1425 struct close_nocancel_args ca
;
1429 /* Mask off all but regular access permissions */
1430 mode
= ((mode
&~ p
->p_fd
->fd_cmask
) & ALLPERMS
) & ~S_ISTXT
;
1431 VATTR_SET(&va
, va_mode
, mode
& ACCESSPERMS
);
1433 NDINIT(&nd
, LOOKUP
, FOLLOW
| AUDITVNPATH1
, UIO_SYSSPACE
,
1434 CAST_USER_ADDR_T(psfa
->psfaa_openargs
.psfao_path
),
1435 imgp
->ip_vfs_context
);
1437 error
= open1(imgp
->ip_vfs_context
,
1439 psfa
->psfaa_openargs
.psfao_oflag
,
1444 * If there's an error, or we get the right fd by
1445 * accident, then drop out here. This is easier that
1446 * rearchitecting all the open code to preallocate fd
1447 * slots, and internally taking one as an argument.
1449 if (error
|| ival
[0] == psfa
->psfaa_filedes
)
1454 * If we didn't fall out from an error, we ended up
1455 * with the wrong fd; so now we've got to try to dup2
1456 * it to the right one.
1458 dup2a
.from
= origfd
;
1459 dup2a
.to
= psfa
->psfaa_filedes
;
1462 * The dup2() system call implementation sets
1463 * ival to newfd in the success case, but we
1464 * can ignore that, since if we didn't get the
1465 * fd we wanted, the error will stop us.
1467 error
= dup2(p
, &dup2a
, ival
);
1472 * Finally, close the original fd.
1476 error
= close_nocancel(p
, &ca
, ival
);
1481 struct dup2_args dup2a
;
1483 dup2a
.from
= psfa
->psfaa_filedes
;
1484 dup2a
.to
= psfa
->psfaa_openargs
.psfao_oflag
;
1487 * The dup2() system call implementation sets
1488 * ival to newfd in the success case, but we
1489 * can ignore that, since if we didn't get the
1490 * fd we wanted, the error will stop us.
1492 error
= dup2(p
, &dup2a
, ival
);
1497 struct close_nocancel_args ca
;
1499 ca
.fd
= psfa
->psfaa_filedes
;
1501 error
= close_nocancel(p
, &ca
, ival
);
1509 /* All file actions failures are considered fatal, per POSIX */
1521 * Parameters: uap->pid Pointer to pid return area
1522 * uap->fname File name to exec
1523 * uap->argp Argument list
1524 * uap->envp Environment list
1526 * Returns: 0 Success
1527 * EINVAL Invalid argument
1528 * ENOTSUP Not supported
1529 * ENOEXEC Executable file format error
1530 * exec_activate_image:EINVAL Invalid argument
1531 * exec_activate_image:EACCES Permission denied
1532 * exec_activate_image:EINTR Interrupted function
1533 * exec_activate_image:ENOMEM Not enough space
1534 * exec_activate_image:EFAULT Bad address
1535 * exec_activate_image:ENAMETOOLONG Filename too long
1536 * exec_activate_image:ENOEXEC Executable file format error
1537 * exec_activate_image:ETXTBSY Text file busy [misuse of error code]
1538 * exec_activate_image:EBADEXEC The executable is corrupt/unknown
1539 * exec_activate_image:???
1540 * mac_execve_enter:???
1542 * TODO: More gracefully handle failures after vfork
1543 * Expect to need __mac_posix_spawn() at some point...
1544 * Handle posix_spawnattr_t
1545 * Handle posix_spawn_file_actions_t
1548 posix_spawn(proc_t ap
, struct posix_spawn_args
*uap
, register_t
*retval
)
1550 proc_t p
= ap
; /* quiet bogus GCC vfork() warning */
1551 register_t ival
[2]; /* dummy retval for vfork() */
1552 struct image_params image_params
, *imgp
;
1553 struct vnode_attr va
;
1554 struct vnode_attr origva
;
1555 struct uthread
*uthread
= 0; /* compiler complains if not set to 0*/
1559 char alt_p_comm
[sizeof(p
->p_comm
)] = {0}; /* for PowerPC */
1560 int is_64
= IS_64BIT_PROCESS(p
);
1562 struct vfs_context context
;
1563 struct user__posix_spawn_args_desc px_args
;
1564 struct _posix_spawnattr px_sa
;
1565 _posix_spawn_file_actions_t px_sfap
= NULL
;
1566 _posix_spawn_port_actions_t px_spap
= NULL
;
1567 struct __user_sigaction vec
;
1569 imgp
= &image_params
;
1571 /* Initialize the common data in the image_params structure */
1572 bzero(imgp
, sizeof(*imgp
));
1573 imgp
->ip_user_fname
= uap
->path
;
1574 imgp
->ip_user_argv
= uap
->argv
;
1575 imgp
->ip_user_envv
= uap
->envp
;
1576 imgp
->ip_vattr
= &va
;
1577 imgp
->ip_origvattr
= &origva
;
1578 imgp
->ip_vfs_context
= &context
;
1579 imgp
->ip_flags
= (is_64
? IMGPF_WAS_64BIT
: IMGPF_NONE
);
1580 imgp
->ip_p_comm
= alt_p_comm
; /* for PowerPC */
1581 imgp
->ip_seg
= (is_64
? UIO_USERSPACE64
: UIO_USERSPACE32
);
1583 if (uap
->adesc
!= USER_ADDR_NULL
) {
1585 error
= copyin(uap
->adesc
, &px_args
, sizeof(px_args
));
1587 struct _posix_spawn_args_desc px_args32
;
1589 error
= copyin(uap
->adesc
, &px_args32
, sizeof(px_args32
));
1592 * Convert arguments descriptor from external 32 bit
1593 * representation to internal 64 bit representation
1595 px_args
.attr_size
= px_args32
.attr_size
;
1596 px_args
.attrp
= CAST_USER_ADDR_T(px_args32
.attrp
);
1597 px_args
.file_actions_size
= px_args32
.file_actions_size
;
1598 px_args
.file_actions
= CAST_USER_ADDR_T(px_args32
.file_actions
);
1599 px_args
.port_actions_size
= px_args32
.port_actions_size
;
1600 px_args
.port_actions
= CAST_USER_ADDR_T(px_args32
.port_actions
);
1605 if (px_args
.attr_size
!= 0) {
1607 * This could lose some of the port_actions pointer,
1608 * but we already have it from px_args.
1610 if ((error
= copyin(px_args
.attrp
, &px_sa
, sizeof(px_sa
))) != 0)
1613 imgp
->ip_px_sa
= &px_sa
;
1615 if (px_args
.file_actions_size
!= 0) {
1616 /* Limit file_actions to allowed number of open files */
1617 int maxfa
= (p
->p_limit
? p
->p_rlimit
[RLIMIT_NOFILE
].rlim_cur
: NOFILE
);
1618 if (px_args
.file_actions_size
< PSF_ACTIONS_SIZE(1) ||
1619 px_args
.file_actions_size
> PSF_ACTIONS_SIZE(maxfa
)) {
1623 MALLOC(px_sfap
, _posix_spawn_file_actions_t
, px_args
.file_actions_size
, M_TEMP
, M_WAITOK
);
1624 if (px_sfap
== NULL
) {
1628 imgp
->ip_px_sfa
= px_sfap
;
1630 if ((error
= copyin(px_args
.file_actions
, px_sfap
,
1631 px_args
.file_actions_size
)) != 0)
1634 if (px_args
.port_actions_size
!= 0) {
1635 /* Limit port_actions to one page of data */
1636 if (px_args
.port_actions_size
< PS_PORT_ACTIONS_SIZE(1) ||
1637 px_args
.port_actions_size
> PAGE_SIZE
) {
1642 MALLOC(px_spap
, _posix_spawn_port_actions_t
,
1643 px_args
.port_actions_size
, M_TEMP
, M_WAITOK
);
1644 if (px_spap
== NULL
) {
1648 imgp
->ip_px_spa
= px_spap
;
1650 if ((error
= copyin(px_args
.port_actions
, px_spap
,
1651 px_args
.port_actions_size
)) != 0)
1656 if (imgp
->ip_px_sa
== NULL
|| !(px_sa
.psa_flags
& POSIX_SPAWN_SETEXEC
)){
1657 if ((error
= vfork(p
, NULL
, ival
)) != 0)
1662 /* "reenter the kernel" on a new vfork()'ed process */
1663 uthread
= get_bsdthread_info(current_thread());
1665 p
= uthread
->uu_proc
;
1667 context
.vc_thread
= current_thread();
1668 context
.vc_ucred
= p
->p_ucred
; /* XXX must NOT be kauth_cred_get() */
1671 * Post fdcopy(), pre exec_handle_sugid() - this is where we want
1672 * to handle the file_actions. Since vfork() also ends up setting
1673 * us into the parent process group, and saved off the signal flags,
1674 * this is also where we want to handle the spawn flags.
1676 /* Has spawn file actions? */
1677 if (imgp
->ip_px_sfa
!= NULL
&&
1678 (error
= exec_handle_file_actions(imgp
)) != 0) {
1682 /* Has spawn port actions? */
1683 if (imgp
->ip_px_spa
!= NULL
) {
1684 /* Only allowed when not under vfork */
1685 if (!(px_sa
.psa_flags
& POSIX_SPAWN_SETEXEC
)) {
1689 if((error
= exec_handle_port_actions(imgp
)) != 0)
1693 /* Has spawn attr? */
1694 if (imgp
->ip_px_sa
!= NULL
) {
1695 /* Set the process group ID of the child process */
1696 if (px_sa
.psa_flags
& POSIX_SPAWN_SETPGROUP
) {
1697 struct setpgid_args spga
;
1698 spga
.pid
= p
->p_pid
;
1699 spga
.pgid
= px_sa
.psa_pgroup
;
1701 * Effectively, call setpgid() system call; works
1702 * because there are no pointer arguments.
1704 if((error
= setpgid(p
, &spga
, ival
)) != 0)
1708 * Reset UID/GID to parent's RUID/RGID; This works only
1709 * because the operation occurs *after* the vfork() and
1710 * before the call to exec_handle_sugid() by the image
1711 * activator called from exec_activate_image().
1713 * The use of p_ucred is safe, since we are acting on the
1714 * new process, and it has no threads other than the one
1715 * we are creating for it.
1717 if (px_sa
.psa_flags
& POSIX_SPAWN_RESETIDS
) {
1718 kauth_cred_t my_cred
= p
->p_ucred
;
1719 kauth_cred_t my_new_cred
= kauth_cred_setuidgid(my_cred
, my_cred
->cr_ruid
, my_cred
->cr_rgid
);
1720 if (my_new_cred
!= my_cred
)
1721 p
->p_ucred
= my_new_cred
;
1724 * Mask a list of signals, instead of them being unmasked, if
1725 * they were unmasked in the parent; note that some signals
1728 if (px_sa
.psa_flags
& POSIX_SPAWN_SETSIGMASK
)
1729 uthread
->uu_sigmask
= (px_sa
.psa_sigmask
& ~sigcantmask
);
1731 * Default a list of signals instead of ignoring them, if
1732 * they were ignored in the parent.
1734 if (px_sa
.psa_flags
& POSIX_SPAWN_SETSIGDEF
) {
1735 vec
.sa_handler
= SIG_DFL
;
1739 for (sig
= 0; sig
< NSIG
; sig
++)
1740 if (px_sa
.psa_sigdefault
&& 1 << sig
) {
1741 error
= setsigvec(p
, sig
, &vec
);
1747 * XXXAUDIT: Currently, we only audit the pathname of the binary.
1748 * There may also be poor interaction with dyld.
1751 task
= current_task();
1753 /* If we're not in vfork, don't permit a mutithreaded task to exec */
1754 if (!(uthread
->uu_flag
& UT_VFORK
)) {
1755 if (task
!= kernel_task
) {
1756 numthreads
= get_task_numacts(task
);
1757 if (numthreads
<= 0 ) {
1761 if (numthreads
> 1) {
1768 #if MAC_SPAWN /* XXX */
1769 if (uap
->mac_p
!= USER_ADDR_NULL
) {
1770 error
= mac_execve_enter(uap
->mac_p
, imgp
);
1776 if ((error
= exec_activate_image(imgp
)) != 0)
1779 /* Image not claimed by any activator? */
1783 exec_resettextvp(p
, imgp
);
1786 vnode_put(imgp
->ip_vp
);
1787 if (imgp
->ip_strings
)
1788 execargs_free(imgp
);
1789 if (imgp
->ip_px_sfa
!= NULL
)
1790 FREE(imgp
->ip_px_sfa
, M_TEMP
);
1791 if (imgp
->ip_px_spa
!= NULL
)
1792 FREE(imgp
->ip_px_spa
, M_TEMP
);
1795 if (imgp
->ip_execlabelp
)
1796 mac_cred_label_free(imgp
->ip_execlabelp
);
1797 if (imgp
->ip_scriptlabelp
)
1798 mac_vnode_label_free(imgp
->ip_scriptlabelp
);
1802 DTRACE_PROC1(exec__failure
, int, error
);
1803 vfork_exit(p
, W_EXITCODE(-1, 0));
1805 DTRACE_PROC(exec__success
);
1808 * Returning to the parent process...
1810 * If the parent wants the pid, copy it out
1812 if (uap
->pid
!= USER_ADDR_NULL
)
1813 (void)suword(uap
->pid
, p
->p_pid
);
1816 * Override inherited code signing flags with the
1817 * ones for the process that is being successfully
1821 p
->p_csflags
= imgp
->ip_csflags
;
1823 vfork_return(p
, NULL
, error
);
1824 (void)thread_resume(imgp
->ip_vfork_thread
);
1829 * Override inherited code signing flags with the
1830 * ones for the process that is being successfully
1834 p
->p_csflags
= imgp
->ip_csflags
;
1836 DTRACE_PROC(exec__success
);
1838 DTRACE_PROC1(exec__failure
, int, error
);
1848 * Parameters: uap->fname File name to exec
1849 * uap->argp Argument list
1850 * uap->envp Environment list
1852 * Returns: 0 Success
1853 * __mac_execve:EINVAL Invalid argument
1854 * __mac_execve:ENOTSUP Invalid argument
1855 * __mac_execve:EACCES Permission denied
1856 * __mac_execve:EINTR Interrupted function
1857 * __mac_execve:ENOMEM Not enough space
1858 * __mac_execve:EFAULT Bad address
1859 * __mac_execve:ENAMETOOLONG Filename too long
1860 * __mac_execve:ENOEXEC Executable file format error
1861 * __mac_execve:ETXTBSY Text file busy [misuse of error code]
1864 * TODO: Dynamic linker header address on stack is copied via suword()
1868 execve(proc_t p
, struct execve_args
*uap
, register_t
*retval
)
1870 struct __mac_execve_args muap
;
1873 muap
.fname
= uap
->fname
;
1874 muap
.argp
= uap
->argp
;
1875 muap
.envp
= uap
->envp
;
1876 muap
.mac_p
= USER_ADDR_NULL
;
1877 err
= __mac_execve(p
, &muap
, retval
);
1885 * Parameters: uap->fname File name to exec
1886 * uap->argp Argument list
1887 * uap->envp Environment list
1888 * uap->mac_p MAC label supplied by caller
1890 * Returns: 0 Success
1891 * EINVAL Invalid argument
1892 * ENOTSUP Not supported
1893 * ENOEXEC Executable file format error
1894 * exec_activate_image:EINVAL Invalid argument
1895 * exec_activate_image:EACCES Permission denied
1896 * exec_activate_image:EINTR Interrupted function
1897 * exec_activate_image:ENOMEM Not enough space
1898 * exec_activate_image:EFAULT Bad address
1899 * exec_activate_image:ENAMETOOLONG Filename too long
1900 * exec_activate_image:ENOEXEC Executable file format error
1901 * exec_activate_image:ETXTBSY Text file busy [misuse of error code]
1902 * exec_activate_image:EBADEXEC The executable is corrupt/unknown
1903 * exec_activate_image:???
1904 * mac_execve_enter:???
1906 * TODO: Dynamic linker header address on stack is copied via suword()
1909 __mac_execve(proc_t p
, struct __mac_execve_args
*uap
, register_t
*retval
)
1911 struct image_params image_params
, *imgp
;
1912 struct vnode_attr va
;
1913 struct vnode_attr origva
;
1914 struct uthread
*uthread
;
1918 char alt_p_comm
[sizeof(p
->p_comm
)] = {0}; /* for PowerPC */
1919 int is_64
= IS_64BIT_PROCESS(p
);
1920 struct vfs_context context
;
1922 context
.vc_thread
= current_thread();
1923 context
.vc_ucred
= kauth_cred_proc_ref(p
); /* XXX must NOT be kauth_cred_get() */
1925 imgp
= &image_params
;
1927 /* Initialize the common data in the image_params structure */
1928 bzero(imgp
, sizeof(*imgp
));
1929 imgp
->ip_user_fname
= uap
->fname
;
1930 imgp
->ip_user_argv
= uap
->argp
;
1931 imgp
->ip_user_envv
= uap
->envp
;
1932 imgp
->ip_vattr
= &va
;
1933 imgp
->ip_origvattr
= &origva
;
1934 imgp
->ip_vfs_context
= &context
;
1935 imgp
->ip_flags
= (is_64
? IMGPF_WAS_64BIT
: IMGPF_NONE
);
1936 imgp
->ip_p_comm
= alt_p_comm
; /* for PowerPC */
1937 imgp
->ip_seg
= (is_64
? UIO_USERSPACE64
: UIO_USERSPACE32
);
1940 * XXXAUDIT: Currently, we only audit the pathname of the binary.
1941 * There may also be poor interaction with dyld.
1944 task
= current_task();
1945 uthread
= get_bsdthread_info(current_thread());
1947 /* If we're not in vfork, don't permit a mutithreaded task to exec */
1948 if (!(uthread
->uu_flag
& UT_VFORK
)) {
1949 if (task
!= kernel_task
) {
1951 numthreads
= get_task_numacts(task
);
1952 if (numthreads
<= 0 ) {
1954 kauth_cred_unref(&context
.vc_ucred
);
1957 if (numthreads
> 1) {
1959 kauth_cred_unref(&context
.vc_ucred
);
1967 if (uap
->mac_p
!= USER_ADDR_NULL
) {
1968 error
= mac_execve_enter(uap
->mac_p
, imgp
);
1970 kauth_cred_unref(&context
.vc_ucred
);
1976 proc_transstart(p
, 0);
1977 error
= exec_activate_image(imgp
);
1978 proc_transend(p
, 0);
1980 kauth_cred_unref(&context
.vc_ucred
);
1982 /* Image not claimed by any activator? */
1987 exec_resettextvp(p
, imgp
);
1989 if (imgp
->ip_vp
!= NULLVP
)
1990 vnode_put(imgp
->ip_vp
);
1991 if (imgp
->ip_strings
)
1992 execargs_free(imgp
);
1994 if (imgp
->ip_execlabelp
)
1995 mac_cred_label_free(imgp
->ip_execlabelp
);
1996 if (imgp
->ip_scriptlabelp
)
1997 mac_vnode_label_free(imgp
->ip_scriptlabelp
);
2001 * Override inherited code signing flags with the
2002 * ones for the process that is being successfully
2006 p
->p_csflags
= imgp
->ip_csflags
;
2008 DTRACE_PROC(exec__success
);
2010 if (uthread
->uu_flag
& UT_VFORK
) {
2011 vfork_return(p
, retval
, p
->p_pid
);
2012 (void)thread_resume(imgp
->ip_vfork_thread
);
2015 DTRACE_PROC1(exec__failure
, int, error
);
2025 * Description: Copy a pointer in from user space to a user_addr_t in kernel
2026 * space, based on 32/64 bitness of the user space
2028 * Parameters: froma User space address
2029 * toptr Address of kernel space user_addr_t
2030 * ptr_size 4/8, based on 'froma' address space
2032 * Returns: 0 Success
2033 * EFAULT Bad 'froma'
2036 * *ptr_size Modified
2039 copyinptr(user_addr_t froma
, user_addr_t
*toptr
, int ptr_size
)
2043 if (ptr_size
== 4) {
2044 /* 64 bit value containing 32 bit address */
2047 error
= copyin(froma
, &i
, 4);
2048 *toptr
= CAST_USER_ADDR_T(i
); /* SAFE */
2050 error
= copyin(froma
, toptr
, 8);
2059 * Description: Copy a pointer out from a user_addr_t in kernel space to
2060 * user space, based on 32/64 bitness of the user space
2062 * Parameters: ua User space address to copy to
2063 * ptr Address of kernel space user_addr_t
2064 * ptr_size 4/8, based on 'ua' address space
2066 * Returns: 0 Success
2070 * *ptr_size Modified
2073 copyoutptr(user_addr_t ua
, user_addr_t ptr
, int ptr_size
)
2077 if (ptr_size
== 4) {
2078 /* 64 bit value containing 32 bit address */
2079 unsigned int i
= CAST_DOWN(unsigned int,ua
); /* SAFE */
2081 error
= copyout(&i
, ptr
, 4);
2083 error
= copyout(&ua
, ptr
, 8);
2090 * exec_copyout_strings
2092 * Copy out the strings segment to user space. The strings segment is put
2093 * on a preinitialized stack frame.
2095 * Parameters: struct image_params * the image parameter block
2096 * int * a pointer to the stack offset variable
2098 * Returns: 0 Success
2102 * (*stackp) The stack offset, modified
2104 * Note: The strings segment layout is backward, from the beginning
2105 * of the top of the stack to consume the minimal amount of
2106 * space possible; the returned stack pointer points to the
2107 * end of the area consumed (stacks grow upward).
2109 * argc is an int; arg[i] are pointers; env[i] are pointers;
2110 * exec_path is a pointer; the 0's are (void *)NULL's
2112 * The stack frame layout is:
2135 * | exec_path | In MacOS X PR2 Beaker2E the path passed to exec() is
2136 * +-------------+ passed on the stack just after the trailing 0 of the
2137 * | 0 | the envp[] array as a pointer to a string.
2144 * | | <- p->user_stack
2147 * Although technically a part of the STRING AREA, we treat the PATH AREA as
2148 * a separate entity. This allows us to align the beginning of the PATH AREA
2149 * to a pointer boundary so that the exec_path, env[i], and argv[i] pointers
2150 * which preceed it on the stack are properly aligned.
2152 * TODO: argc copied with suword(), which takes a 64 bit address
2155 exec_copyout_strings(struct image_params
*imgp
, user_addr_t
*stackp
)
2157 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
2158 int ptr_size
= (imgp
->ip_flags
& IMGPF_IS_64BIT
) ? 8 : 4;
2159 char *argv
= imgp
->ip_argv
; /* modifiable copy of argv */
2160 user_addr_t string_area
; /* *argv[], *env[] */
2161 user_addr_t path_area
; /* package launch path */
2162 user_addr_t ptr_area
; /* argv[], env[], exec_path */
2164 int stringc
= imgp
->ip_argc
+ imgp
->ip_envc
;
2171 unsigned patharea_len
= imgp
->ip_argv
- imgp
->ip_strings
;
2175 * Set up pointers to the beginning of the string area, the beginning
2176 * of the path area, and the beginning of the pointer area (actually,
2177 * the location of argc, an int, which may be smaller than a pointer,
2178 * but we use ptr_size worth of space for it, for alignment).
2180 string_area
= stack
- (((imgp
->ip_strendp
- imgp
->ip_strings
) + ptr_size
-1) & ~(ptr_size
-1)) - ptr_size
;
2181 path_area
= string_area
- ((patharea_len
+ ptr_size
-1) & ~(ptr_size
-1));
2182 ptr_area
= path_area
- ((imgp
->ip_argc
+ imgp
->ip_envc
+ 4 + envc_add
) * ptr_size
) - ptr_size
/*argc*/;
2184 /* Return the initial stack address: the location of argc */
2188 * Record the size of the arguments area so that sysctl_procargs()
2189 * can return the argument area without having to parse the arguments.
2192 p
->p_argc
= imgp
->ip_argc
;
2193 p
->p_argslen
= (int)(stack
- path_area
);
2198 * Support for new app package launching for Mac OS X allocates
2199 * the "path" at the begining of the imgp->ip_strings buffer.
2200 * copy it just before the string area.
2203 error
= copyoutstr(imgp
->ip_strings
, path_area
,
2210 /* Save a NULL pointer below it */
2211 (void)copyoutptr(0LL, path_area
- ptr_size
, ptr_size
);
2213 /* Save the pointer to "path" just below it */
2214 (void)copyoutptr(path_area
, path_area
- 2*ptr_size
, ptr_size
);
2217 * ptr_size for 2 NULL one each ofter arg[argc -1] and env[n]
2219 * skip over saved path, ptr_size for pointer to path,
2220 * and ptr_size for the NULL after pointer to path.
2223 /* argc (int32, stored in a ptr_size area) */
2224 (void)suword(ptr_area
, imgp
->ip_argc
);
2225 ptr_area
+= sizeof(int);
2226 /* pad to ptr_size, if 64 bit image, to ensure user stack alignment */
2227 if (imgp
->ip_flags
& IMGPF_IS_64BIT
) {
2228 (void)suword(ptr_area
, 0); /* int, not long: ignored */
2229 ptr_area
+= sizeof(int);
2233 p
->p_dtrace_argv
= ptr_area
; /* user_addr_t &argv[0] for dtrace convenience */
2234 #endif /* CONFIG_DTRACE */
2237 * We use (string_area - path_area) here rather than the more
2238 * intuitive (imgp->ip_argv - imgp->ip_strings) because we are
2239 * interested in the length of the PATH_AREA in user space,
2240 * rather than the actual length of the execution path, since
2241 * it includes alignment padding of the PATH_AREA + STRING_AREA
2242 * to a ptr_size boundary.
2244 strspace
= SIZE_IMG_STRSPACE
- (string_area
- path_area
);
2246 if (stringc
== imgp
->ip_envc
) {
2247 /* argv[n] = NULL */
2248 (void)copyoutptr(0LL, ptr_area
, ptr_size
);
2249 ptr_area
+= ptr_size
;
2251 p
->p_dtrace_envp
= ptr_area
; /* user_addr_t &env[0] for dtrace convenience */
2252 #endif /* CONFIG_DTRACE */
2257 /* pointer: argv[n]/env[n] */
2258 (void)copyoutptr(string_area
, ptr_area
, ptr_size
);
2260 /* string : argv[n][]/env[n][] */
2262 if (strspace
<= 0) {
2266 error
= copyoutstr(argv
, string_area
,
2272 } while (error
== ENAMETOOLONG
);
2273 if (error
== EFAULT
|| error
== E2BIG
)
2274 break; /* bad stack - user's problem */
2275 ptr_area
+= ptr_size
;
2278 (void)copyoutptr(0LL, ptr_area
, ptr_size
);
2286 * exec_extract_strings
2288 * Copy arguments and environment from user space into work area; we may
2289 * have already copied some early arguments into the work area, and if
2290 * so, any arguments opied in are appended to those already there.
2292 * Parameters: struct image_params * the image parameter block
2294 * Returns: 0 Success
2298 * (imgp->ip_argc) Count of arguments, updated
2299 * (imgp->ip_envc) Count of environment strings, updated
2302 * Note: The argument and environment vectors are user space pointers
2303 * to arrays of user space pointers.
2306 exec_extract_strings(struct image_params
*imgp
)
2309 int ptr_size
= (imgp
->ip_flags
& IMGPF_WAS_64BIT
) ? 8 : 4;
2310 user_addr_t argv
= imgp
->ip_user_argv
;
2311 user_addr_t envv
= imgp
->ip_user_envv
;
2314 * If the argument vector is NULL, this is the system startup
2315 * bootstrap from load_init_program(), and there's nothing to do
2317 if (imgp
->ip_user_argv
== 0LL)
2320 /* Now, get rest of arguments */
2323 * If we are running an interpreter, replace the av[0] that was
2324 * passed to execve() with the fully qualified path name that was
2325 * passed to execve() for interpreters which do not use the PATH
2326 * to locate their script arguments.
2328 if((imgp
->ip_flags
& IMGPF_INTERPRET
) != 0 && argv
!= 0LL) {
2331 error
= copyinptr(argv
, &arg
, ptr_size
);
2334 if (arg
!= 0LL && arg
!= (user_addr_t
)-1) {
2336 error
= exec_add_string(imgp
, imgp
->ip_user_fname
);
2343 while (argv
!= 0LL) {
2346 error
= copyinptr(argv
, &arg
, ptr_size
);
2353 } else if (arg
== (user_addr_t
)-1) {
2354 /* Um... why would it be -1? */
2361 error
= exec_add_string(imgp
, arg
);
2367 /* Now, get the environment */
2368 while (envv
!= 0LL) {
2371 error
= copyinptr(envv
, &env
, ptr_size
);
2378 } else if (env
== (user_addr_t
)-1) {
2385 error
= exec_add_string(imgp
, env
);
2395 #define unix_stack_size(p) (p->p_rlimit[RLIMIT_STACK].rlim_cur)
2398 * exec_check_permissions
2400 * Decription: Verify that the file that is being attempted to be executed
2401 * is in fact allowed to be executed based on it POSIX file
2402 * permissions and other access control criteria
2404 * Parameters: struct image_params * the image parameter block
2406 * Returns: 0 Success
2407 * EACCES Permission denied
2408 * ENOEXEC Executable file format error
2409 * ETXTBSY Text file busy [misuse of error code]
2411 * vnode_authorize:???
2414 exec_check_permissions(struct image_params
*imgp
)
2416 struct vnode
*vp
= imgp
->ip_vp
;
2417 struct vnode_attr
*vap
= imgp
->ip_vattr
;
2418 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
2420 kauth_action_t action
;
2422 /* Only allow execution of regular files */
2423 if (!vnode_isreg(vp
))
2426 /* Get the file attributes that we will be using here and elsewhere */
2428 VATTR_WANTED(vap
, va_uid
);
2429 VATTR_WANTED(vap
, va_gid
);
2430 VATTR_WANTED(vap
, va_mode
);
2431 VATTR_WANTED(vap
, va_fsid
);
2432 VATTR_WANTED(vap
, va_fileid
);
2433 VATTR_WANTED(vap
, va_data_size
);
2434 if ((error
= vnode_getattr(vp
, vap
, imgp
->ip_vfs_context
)) != 0)
2438 * Ensure that at least one execute bit is on - otherwise root
2439 * will always succeed, and we don't want to happen unless the
2440 * file really is executable.
2442 if ((vap
->va_mode
& (S_IXUSR
| S_IXGRP
| S_IXOTH
)) == 0)
2445 /* Disallow zero length files */
2446 if (vap
->va_data_size
== 0)
2449 imgp
->ip_arch_offset
= (user_size_t
)0;
2450 imgp
->ip_arch_size
= vap
->va_data_size
;
2452 /* Disable setuid-ness for traced programs or if MNT_NOSUID */
2453 if ((vp
->v_mount
->mnt_flag
& MNT_NOSUID
) || (p
->p_lflag
& P_LTRACED
)) {
2454 vap
->va_mode
&= ~(VSUID
| VSGID
);
2456 imgp
->ip_no_trans
= 1;
2461 error
= mac_vnode_check_exec(imgp
->ip_vfs_context
, vp
, imgp
);
2466 /* Check for execute permission */
2467 action
= KAUTH_VNODE_EXECUTE
;
2468 /* Traced images must also be readable */
2469 if (p
->p_lflag
& P_LTRACED
)
2470 action
|= KAUTH_VNODE_READ_DATA
;
2471 if ((error
= vnode_authorize(vp
, NULL
, action
, imgp
->ip_vfs_context
)) != 0)
2475 /* Don't let it run if anyone had it open for writing */
2477 if (vp
->v_writecount
) {
2478 panic("going to return ETXTBSY %x", vp
);
2486 #ifdef IMGPF_POWERPC
2488 * If the file we are about to attempt to load is the exec_handler_ppc,
2489 * which is determined by matching the vattr fields against previously
2490 * cached values, then we set the PowerPC environment flag.
2492 if (vap
->va_fsid
== exec_archhandler_ppc
.fsid
&&
2493 vap
->va_fileid
== (uint64_t)((u_long
)exec_archhandler_ppc
.fileid
)) {
2494 imgp
->ip_flags
|= IMGPF_POWERPC
;
2496 #endif /* IMGPF_POWERPC */
2498 /* XXX May want to indicate to underlying FS that vnode is open */
2507 * Initially clear the P_SUGID in the process flags; if an SUGID process is
2508 * exec'ing a non-SUGID image, then this is the point of no return.
2510 * If the image being activated is SUGID, then replace the credential with a
2511 * copy, disable tracing (unless the tracing process is root), reset the
2512 * mach task port to revoke it, set the P_SUGID bit,
2514 * If the saved user and group ID will be changing, then make sure it happens
2515 * to a new credential, rather than a shared one.
2517 * Set the security token (this is probably obsolete, given that the token
2518 * should not technically be separate from the credential itself).
2520 * Parameters: struct image_params * the image parameter block
2522 * Returns: void No failure indication
2525 * <process credential> Potentially modified/replaced
2526 * <task port> Potentially revoked
2527 * <process flags> P_SUGID bit potentially modified
2528 * <security token> Potentially modified
2531 exec_handle_sugid(struct image_params
*imgp
)
2533 kauth_cred_t cred
= vfs_context_ucred(imgp
->ip_vfs_context
);
2534 proc_t p
= vfs_context_proc(imgp
->ip_vfs_context
);
2538 struct vnode
*dev_null
= NULLVP
;
2540 kauth_cred_t my_cred
;
2545 mac_transition
= mac_cred_check_label_update_execve(imgp
->ip_vfs_context
, imgp
->ip_vp
,
2546 imgp
->ip_scriptlabelp
, imgp
->ip_execlabelp
, p
);
2549 OSBitAndAtomic(~((uint32_t)P_SUGID
), (UInt32
*)&p
->p_flag
);
2552 * Order of the following is important; group checks must go last,
2553 * as we use the success of the 'is_member' check combined with the
2554 * failure of the explicit match to indicate that we will be setting
2555 * the egid of the process even though the new process did not
2556 * require VSUID/VSGID bits in order for it to set the new group as
2559 * Note: Technically, by this we are implying a call to
2560 * setegid() in the new process, rather than implying
2561 * it used its VSGID bit to set the effective group,
2562 * even though there is no code in that process to make
2565 if (((imgp
->ip_origvattr
->va_mode
& VSUID
) != 0 &&
2566 kauth_cred_getuid(cred
) != imgp
->ip_origvattr
->va_uid
) ||
2568 mac_transition
|| /* A policy wants to transition */
2570 ((imgp
->ip_origvattr
->va_mode
& VSGID
) != 0 &&
2571 ((kauth_cred_ismember_gid(cred
, imgp
->ip_origvattr
->va_gid
, &is_member
) || !is_member
) ||
2572 (cred
->cr_gid
!= imgp
->ip_origvattr
->va_gid
)))) {
2575 * Replace the credential with a copy of itself if euid or
2578 * Note: setuid binaries will automatically opt out of
2579 * group resolver participation as a side effect
2580 * of this operation. This is an intentional
2581 * part of the security model, which requires a
2582 * participating credential be established by
2583 * escalating privilege, setting up all other
2584 * aspects of the credential including whether
2585 * or not to participate in external group
2586 * membership resolution, then dropping their
2587 * effective privilege to that of the desired
2588 * final credential state.
2590 if (imgp
->ip_origvattr
->va_mode
& VSUID
) {
2591 p
->p_ucred
= kauth_cred_setresuid(p
->p_ucred
, KAUTH_UID_NONE
, imgp
->ip_origvattr
->va_uid
, imgp
->ip_origvattr
->va_uid
, KAUTH_UID_NONE
);
2593 if (imgp
->ip_origvattr
->va_mode
& VSGID
) {
2594 p
->p_ucred
= kauth_cred_setresgid(p
->p_ucred
, KAUTH_GID_NONE
, imgp
->ip_origvattr
->va_gid
, imgp
->ip_origvattr
->va_gid
);
2599 * XXXMAC: In FreeBSD, we set P_SUGID on a MAC transition
2600 * to protect against debuggers being attached by an
2601 * insufficiently privileged process onto the result of
2602 * a transition to a more privileged credential. This is
2603 * too conservative on FreeBSD, but we need to do
2604 * something similar here, or risk vulnerability.
2606 * Before we make the call into the MAC policies, get a new
2607 * duplicate credential, so they can modify it without
2608 * modifying any others sharing it.
2610 if (mac_transition
&& !imgp
->ip_no_trans
) {
2611 kauth_proc_label_update_execve(p
,
2612 imgp
->ip_vfs_context
,
2614 imgp
->ip_scriptlabelp
, imgp
->ip_execlabelp
);
2616 my_cred
= kauth_cred_proc_ref(p
);
2617 mac_task_label_update_cred(my_cred
, p
->task
);
2618 kauth_cred_unref(&my_cred
);
2622 * Have mach reset the task and thread ports.
2623 * We don't want anyone who had the ports before
2624 * a setuid exec to be able to access/control the
2625 * task/thread after.
2627 if (current_task() == p
->task
) {
2628 ipc_task_reset(p
->task
);
2629 ipc_thread_reset(current_thread());
2633 * If 'is_member' is non-zero, then we passed the VSUID and
2634 * MACF checks, and successfully determined that the previous
2635 * cred was a member of the VSGID group, but that it was not
2636 * the default at the time of the execve. So we don't set the
2637 * P_SUGID on the basis of simply running this code.
2640 OSBitOrAtomic(P_SUGID
, (UInt32
*)&p
->p_flag
);
2642 /* Cache the vnode for /dev/null the first time around */
2643 if (dev_null
== NULLVP
) {
2644 struct nameidata nd1
;
2646 NDINIT(&nd1
, LOOKUP
, FOLLOW
, UIO_SYSSPACE32
,
2647 CAST_USER_ADDR_T("/dev/null"),
2648 imgp
->ip_vfs_context
);
2650 if ((error
= vn_open(&nd1
, FREAD
, 0)) == 0) {
2651 dev_null
= nd1
.ni_vp
;
2653 * vn_open returns with both a use_count
2654 * and an io_count on the found vnode
2655 * drop the io_count, but keep the use_count
2657 vnode_put(nd1
.ni_vp
);
2661 /* Radar 2261856; setuid security hole fix */
2662 /* Patch from OpenBSD: A. Ramesh */
2664 * XXX For setuid processes, attempt to ensure that
2665 * stdin, stdout, and stderr are already allocated.
2666 * We do not want userland to accidentally allocate
2667 * descriptors in this range which has implied meaning
2670 if (dev_null
!= NULLVP
) {
2671 for (i
= 0; i
< 3; i
++) {
2672 struct fileproc
*fp
;
2675 if (p
->p_fd
->fd_ofiles
[i
] != NULL
)
2678 if ((error
= falloc(p
, &fp
, &indx
, imgp
->ip_vfs_context
)) != 0)
2681 if ((error
= vnode_ref_ext(dev_null
, FREAD
)) != 0) {
2682 fp_free(p
, indx
, fp
);
2686 fp
->f_fglob
->fg_flag
= FREAD
;
2687 fp
->f_fglob
->fg_type
= DTYPE_VNODE
;
2688 fp
->f_fglob
->fg_ops
= &vnops
;
2689 fp
->f_fglob
->fg_data
= (caddr_t
)dev_null
;
2692 procfdtbl_releasefd(p
, indx
, NULL
);
2693 fp_drop(p
, indx
, fp
, 1);
2697 * for now we need to drop the reference immediately
2698 * since we don't have any mechanism in place to
2699 * release it before starting to unmount "/dev"
2700 * during a reboot/shutdown
2702 vnode_rele(dev_null
);
2708 * Implement the semantic where the effective user and group become
2709 * the saved user and group in exec'ed programs.
2711 p
->p_ucred
= kauth_cred_setsvuidgid(p
->p_ucred
, kauth_cred_getuid(p
->p_ucred
), p
->p_ucred
->cr_gid
);
2713 /* XXX Obsolete; security token should not be separate from cred */
2714 set_security_token(p
);
2723 * Description: Set the user stack address for the process to the provided
2724 * address. If a custom stack was not set as a result of the
2725 * load process (i.e. as specified by the image file for the
2726 * executable), then allocate the stack in the provided map and
2727 * set up appropriate guard pages for enforcing administrative
2728 * limits on stack growth, if they end up being needed.
2730 * Parameters: p Process to set stack on
2731 * user_stack Address to set stack for process to
2732 * customstack FALSE if no custom stack in binary
2733 * map Address map in which to allocate the
2734 * new stack, if 'customstack' is FALSE
2736 * Returns: KERN_SUCCESS Stack successfully created
2737 * !KERN_SUCCESS Mach failure code
2739 static kern_return_t
2740 create_unix_stack(vm_map_t map
, user_addr_t user_stack
, int customstack
,
2743 mach_vm_size_t size
, prot_size
;
2744 mach_vm_offset_t addr
, prot_addr
;
2748 p
->user_stack
= user_stack
;
2753 * Allocate enough space for the maximum stack size we
2754 * will ever authorize and an extra page to act as
2755 * a guard page for stack overflows.
2757 size
= mach_vm_round_page(MAXSSIZ
);
2759 addr
= mach_vm_trunc_page(user_stack
);
2760 #else /* STACK_GROWTH_UP */
2761 addr
= mach_vm_trunc_page(user_stack
- size
);
2762 #endif /* STACK_GROWTH_UP */
2763 kr
= mach_vm_allocate(map
, &addr
, size
,
2764 VM_MAKE_TAG(VM_MEMORY_STACK
) |
2766 if (kr
!= KERN_SUCCESS
) {
2770 * And prevent access to what's above the current stack
2771 * size limit for this process.
2775 prot_addr
+= unix_stack_size(p
);
2776 #endif /* STACK_GROWTH_UP */
2777 prot_addr
= mach_vm_round_page(prot_addr
);
2778 prot_size
= mach_vm_trunc_page(size
- unix_stack_size(p
));
2779 kr
= mach_vm_protect(map
,
2784 if (kr
!= KERN_SUCCESS
) {
2785 (void) mach_vm_deallocate(map
, addr
, size
);
2789 return KERN_SUCCESS
;
2792 #include <sys/reboot.h>
2794 static char init_program_name
[128] = "/sbin/launchd";
2796 struct execve_args init_exec_args
;
2801 * Description: Load the "init" program; in most cases, this will be "launchd"
2803 * Parameters: p Process to call execve() to create
2804 * the "init" program
2808 * Notes: The process that is passed in is the first manufactured
2809 * process on the system, and gets here via bsd_ast() firing
2810 * for the first time. This is done to ensure that bsd_init()
2811 * has run to completion.
2814 load_init_program(proc_t p
)
2816 vm_offset_t init_addr
;
2820 register_t retval
[2];
2823 * Copy out program name.
2826 init_addr
= VM_MIN_ADDRESS
;
2827 (void) vm_allocate(current_map(), &init_addr
, PAGE_SIZE
,
2832 (void) copyout((caddr_t
) init_program_name
, CAST_USER_ADDR_T(init_addr
),
2833 (unsigned) sizeof(init_program_name
)+1);
2835 argv
[argc
++] = (char *) init_addr
;
2836 init_addr
+= sizeof(init_program_name
);
2837 init_addr
= (vm_offset_t
)ROUND_PTR(char, init_addr
);
2840 * Put out first (and only) argument, similarly.
2841 * Assumes everything fits in a page as allocated
2844 if (boothowto
& RB_SINGLE
) {
2845 const char *init_args
= "-s";
2847 copyout(init_args
, CAST_USER_ADDR_T(init_addr
),
2850 argv
[argc
++] = (char *)init_addr
;
2851 init_addr
+= strlen(init_args
);
2852 init_addr
= (vm_offset_t
)ROUND_PTR(char, init_addr
);
2857 * Null-end the argument list
2862 * Copy out the argument list.
2865 (void) copyout((caddr_t
) argv
, CAST_USER_ADDR_T(init_addr
),
2866 (unsigned) sizeof(argv
));
2869 * Set up argument block for fake call to execve.
2872 init_exec_args
.fname
= CAST_USER_ADDR_T(argv
[0]);
2873 init_exec_args
.argp
= CAST_USER_ADDR_T((char **)init_addr
);
2874 init_exec_args
.envp
= CAST_USER_ADDR_T(0);
2877 * So that mach_init task is set with uid,gid 0 token
2879 set_security_token(p
);
2881 error
= execve(p
,&init_exec_args
,retval
);
2883 panic("Process 1 exec of %s failed, errno %d\n",
2884 init_program_name
, error
);
2888 * load_return_to_errno
2890 * Description: Convert a load_return_t (Mach error) to an errno (BSD error)
2892 * Parameters: lrtn Mach error number
2894 * Returns: (int) BSD error number
2896 * EBADARCH Bad architecture
2897 * EBADMACHO Bad Mach object file
2898 * ESHLIBVERS Bad shared library version
2899 * ENOMEM Out of memory/resource shortage
2900 * EACCES Access denied
2901 * ENOENT Entry not found (usually "file does
2903 * EIO An I/O error occurred
2904 * EBADEXEC The executable is corrupt/unknown
2907 load_return_to_errno(load_return_t lrtn
)
2933 #include <mach/mach_types.h>
2934 #include <mach/vm_prot.h>
2935 #include <mach/semaphore.h>
2936 #include <mach/sync_policy.h>
2937 #include <kern/clock.h>
2938 #include <mach/kern_return.h>
2940 extern semaphore_t execve_semaphore
;
2945 * Description: Allocate the block of memory used by the execve arguments.
2946 * At the same time, we allocate a page so that we can read in
2947 * the first page of the image.
2949 * Parameters: struct image_params * the image parameter block
2951 * Returns: 0 Success
2952 * EINVAL Invalid argument
2953 * EACCES Permission denied
2954 * EINTR Interrupted function
2955 * ENOMEM Not enough space
2957 * Notes: This is a temporary allocation into the kernel address space
2958 * to enable us to copy arguments in from user space. This is
2959 * necessitated by not mapping the process calling execve() into
2960 * the kernel address space during the execve() system call.
2962 * We assemble the argument and environment, etc., into this
2963 * region before copying it as a single block into the child
2964 * process address space (at the top or bottom of the stack,
2965 * depending on which way the stack grows; see the function
2966 * exec_copyout_strings() for details).
2968 * This ends up with a second (possibly unnecessary) copy compared
2969 * with assembing the data directly into the child address space,
2970 * instead, but since we cannot be guaranteed that the parent has
2971 * not modified its environment, we can't really know that it's
2972 * really a block there as well.
2975 execargs_alloc(struct image_params
*imgp
)
2979 kret
= semaphore_wait(execve_semaphore
);
2980 if (kret
!= KERN_SUCCESS
)
2984 case KERN_INVALID_ADDRESS
:
2985 case KERN_PROTECTION_FAILURE
:
2988 case KERN_OPERATION_TIMED_OUT
:
2992 kret
= kmem_alloc_pageable(bsd_pageable_map
, (vm_offset_t
*)&imgp
->ip_strings
, NCARGS
+ PAGE_SIZE
);
2993 imgp
->ip_vdata
= imgp
->ip_strings
+ NCARGS
;
2994 if (kret
!= KERN_SUCCESS
) {
2995 semaphore_signal(execve_semaphore
);
3004 * Description: Free the block of memory used by the execve arguments and the
3005 * first page of the executable by a previous call to the function
3008 * Parameters: struct image_params * the image parameter block
3010 * Returns: 0 Success
3011 * EINVAL Invalid argument
3012 * EINTR Oeration interrupted
3015 execargs_free(struct image_params
*imgp
)
3019 kmem_free(bsd_pageable_map
, (vm_offset_t
)imgp
->ip_strings
, NCARGS
+ PAGE_SIZE
);
3020 imgp
->ip_strings
= NULL
;
3022 kret
= semaphore_signal(execve_semaphore
);
3024 case KERN_INVALID_ADDRESS
:
3025 case KERN_PROTECTION_FAILURE
:
3028 case KERN_OPERATION_TIMED_OUT
:
3038 exec_resettextvp(proc_t p
, struct image_params
*imgp
)
3042 vnode_t tvp
= p
->p_textvp
;
3046 offset
= imgp
->ip_arch_offset
;
3049 panic("exec_resettextvp: expected valid vp");
3051 ret
= vnode_ref(vp
);
3055 p
->p_textoff
= offset
;
3057 p
->p_textvp
= NULLVP
; /* this is paranoia */
3062 if ( tvp
!= NULLVP
) {
3063 if (vnode_getwithref(tvp
) == 0) {