xref: /xnu-8020.101.4/libsyscall/wrappers/spawn/posix_spawn.c (revision e7776783b89a353188416a9a346c6cdb4928faad)
1*e7776783SApple OSS Distributions /*
2*e7776783SApple OSS Distributions  * Copyright (c) 2006-2012 Apple Inc. All rights reserved.
3*e7776783SApple OSS Distributions  *
4*e7776783SApple OSS Distributions  * @APPLE_LICENSE_HEADER_START@
5*e7776783SApple OSS Distributions  *
6*e7776783SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*e7776783SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*e7776783SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*e7776783SApple OSS Distributions  * compliance with the License. Please obtain a copy of the License at
10*e7776783SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this
11*e7776783SApple OSS Distributions  * file.
12*e7776783SApple OSS Distributions  *
13*e7776783SApple OSS Distributions  * The Original Code and all software distributed under the License are
14*e7776783SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15*e7776783SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16*e7776783SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17*e7776783SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18*e7776783SApple OSS Distributions  * Please see the License for the specific language governing rights and
19*e7776783SApple OSS Distributions  * limitations under the License.
20*e7776783SApple OSS Distributions  *
21*e7776783SApple OSS Distributions  * @APPLE_LICENSE_HEADER_END@
22*e7776783SApple OSS Distributions  */
23*e7776783SApple OSS Distributions 
24*e7776783SApple OSS Distributions /*
25*e7776783SApple OSS Distributions  * [SPN] Support for _POSIX_SPAWN
26*e7776783SApple OSS Distributions  */
27*e7776783SApple OSS Distributions 
28*e7776783SApple OSS Distributions #define CONFIG_MEMORYSTATUS 1 // <rdar://problem/13604997>
29*e7776783SApple OSS Distributions #include <sys/types.h> /* for user_size_t */
30*e7776783SApple OSS Distributions #include <spawn.h>
31*e7776783SApple OSS Distributions #include <spawn_private.h>
32*e7776783SApple OSS Distributions #include <sys/spawn_internal.h>
33*e7776783SApple OSS Distributions #include <sys/process_policy.h>
34*e7776783SApple OSS Distributions #include <stdlib.h>
35*e7776783SApple OSS Distributions #include <errno.h>
36*e7776783SApple OSS Distributions #include <limits.h>     /* for OPEN_MAX, PATH_MAX */
37*e7776783SApple OSS Distributions #include <string.h>
38*e7776783SApple OSS Distributions #include <strings.h>
39*e7776783SApple OSS Distributions #include <mach/port.h>
40*e7776783SApple OSS Distributions #include <mach/mach_param.h> /* for TASK_PORT_REGISTER_MAX */
41*e7776783SApple OSS Distributions #include <mach/exception_types.h>
42*e7776783SApple OSS Distributions #include <mach/coalition.h> /* for COALITION_TYPE_MAX */
43*e7776783SApple OSS Distributions #include <sys/kern_memorystatus.h>
44*e7776783SApple OSS Distributions 
45*e7776783SApple OSS Distributions /*
46*e7776783SApple OSS Distributions  * Actual syscall wrappers.
47*e7776783SApple OSS Distributions  */
48*e7776783SApple OSS Distributions extern int __posix_spawn(pid_t * __restrict, const char * __restrict,
49*e7776783SApple OSS Distributions     struct _posix_spawn_args_desc *, char *const argv[__restrict],
50*e7776783SApple OSS Distributions     char *const envp[__restrict]);
51*e7776783SApple OSS Distributions extern int __execve(const char *fname, char * const *argp, char * const *envp);
52*e7776783SApple OSS Distributions 
53*e7776783SApple OSS Distributions /*
54*e7776783SApple OSS Distributions  * Function pointers that are NULL in Libsyscall_static, and get populated with
55*e7776783SApple OSS Distributions  * the real implementations in Libsyscall_dynamic from _libkernel_init.c when
56*e7776783SApple OSS Distributions  * os_feature_enabled(Libsystem, posix_spawn_filtering) is on.
57*e7776783SApple OSS Distributions  *
58*e7776783SApple OSS Distributions  * Since launchd cannot read feature flags during process startup (data volume
59*e7776783SApple OSS Distributions  * is not mounted yet), it reads them later and sets these function pointers via
60*e7776783SApple OSS Distributions  * Libsystem and __libkernel_init_after_boot_tasks.
61*e7776783SApple OSS Distributions  *
62*e7776783SApple OSS Distributions  * Usually NULL. Always NULL on customer installs.
63*e7776783SApple OSS Distributions  */
64*e7776783SApple OSS Distributions __attribute__((visibility("hidden")))
65*e7776783SApple OSS Distributions bool (*posix_spawn_with_filter)(pid_t *pid, const char *fname,
66*e7776783SApple OSS Distributions     char * const *argp, char * const *envp, struct _posix_spawn_args_desc *adp,
67*e7776783SApple OSS Distributions     int *ret);
68*e7776783SApple OSS Distributions 
69*e7776783SApple OSS Distributions __attribute__((visibility("hidden")))
70*e7776783SApple OSS Distributions int (*execve_with_filter)(const char *fname, char * const *argp,
71*e7776783SApple OSS Distributions     char * const *envp);
72*e7776783SApple OSS Distributions 
73*e7776783SApple OSS Distributions __attribute__((visibility("hidden")))
74*e7776783SApple OSS Distributions void
__posix_spawnattr_init(struct _posix_spawnattr * psattrp)75*e7776783SApple OSS Distributions __posix_spawnattr_init(struct _posix_spawnattr *psattrp)
76*e7776783SApple OSS Distributions {
77*e7776783SApple OSS Distributions 	/*
78*e7776783SApple OSS Distributions 	 * The default value of this attribute shall be as if no
79*e7776783SApple OSS Distributions 	 * flags were set
80*e7776783SApple OSS Distributions 	 */
81*e7776783SApple OSS Distributions 	psattrp->psa_flags = 0;
82*e7776783SApple OSS Distributions 
83*e7776783SApple OSS Distributions 	/*
84*e7776783SApple OSS Distributions 	 * The default value of this attribute shall be an empty
85*e7776783SApple OSS Distributions 	 * signal set
86*e7776783SApple OSS Distributions 	 */
87*e7776783SApple OSS Distributions 	psattrp->psa_sigdefault = 0;
88*e7776783SApple OSS Distributions 
89*e7776783SApple OSS Distributions 	/* The default value of this attribute is unspecified */
90*e7776783SApple OSS Distributions 	psattrp->psa_sigmask = 0;
91*e7776783SApple OSS Distributions 
92*e7776783SApple OSS Distributions 	/* The default value of this attribute shall be zero */
93*e7776783SApple OSS Distributions 	psattrp->psa_pgroup = 0;     /* doesn't matter */
94*e7776783SApple OSS Distributions 
95*e7776783SApple OSS Distributions 	/* Default is no binary preferences, i.e. use normal grading */
96*e7776783SApple OSS Distributions 	memset(psattrp->psa_binprefs, 0,
97*e7776783SApple OSS Distributions 	    sizeof(psattrp->psa_binprefs));
98*e7776783SApple OSS Distributions 	memset(psattrp->psa_subcpuprefs, 0xff /* CPU_SUBTYPE_ANY */,
99*e7776783SApple OSS Distributions 	    sizeof(psattrp->psa_subcpuprefs));
100*e7776783SApple OSS Distributions 
101*e7776783SApple OSS Distributions 	/* Default is no port actions to take */
102*e7776783SApple OSS Distributions 	psattrp->psa_ports = NULL;
103*e7776783SApple OSS Distributions 
104*e7776783SApple OSS Distributions 	/*
105*e7776783SApple OSS Distributions 	 * The default value of this attribute shall be an no
106*e7776783SApple OSS Distributions 	 * process control on resource starvation
107*e7776783SApple OSS Distributions 	 */
108*e7776783SApple OSS Distributions 	psattrp->psa_pcontrol = 0;
109*e7776783SApple OSS Distributions 
110*e7776783SApple OSS Distributions 	/*
111*e7776783SApple OSS Distributions 	 * Initializing the alignment paddings.
112*e7776783SApple OSS Distributions 	 */
113*e7776783SApple OSS Distributions 
114*e7776783SApple OSS Distributions 	psattrp->short_padding = 0;
115*e7776783SApple OSS Distributions 	psattrp->flags_padding = 0;
116*e7776783SApple OSS Distributions 
117*e7776783SApple OSS Distributions 	/* Default is no new apptype requested */
118*e7776783SApple OSS Distributions 	psattrp->psa_apptype = POSIX_SPAWN_PROCESS_TYPE_DEFAULT;
119*e7776783SApple OSS Distributions 
120*e7776783SApple OSS Distributions 	/* Jetsam related */
121*e7776783SApple OSS Distributions 	psattrp->psa_jetsam_flags = 0;
122*e7776783SApple OSS Distributions 	psattrp->psa_priority = -1;
123*e7776783SApple OSS Distributions 	psattrp->psa_memlimit_active = -1;
124*e7776783SApple OSS Distributions 	psattrp->psa_memlimit_inactive = -1;
125*e7776783SApple OSS Distributions 
126*e7776783SApple OSS Distributions 	/* Default is no thread limit */
127*e7776783SApple OSS Distributions 	psattrp->psa_thread_limit = 0;
128*e7776783SApple OSS Distributions 
129*e7776783SApple OSS Distributions 	/* Default is no CPU usage monitor active. */
130*e7776783SApple OSS Distributions 	psattrp->psa_cpumonitor_percent = 0;
131*e7776783SApple OSS Distributions 	psattrp->psa_cpumonitor_interval = 0;
132*e7776783SApple OSS Distributions 
133*e7776783SApple OSS Distributions 	/* Default is no MAC policy extensions. */
134*e7776783SApple OSS Distributions 	psattrp->psa_mac_extensions = NULL;
135*e7776783SApple OSS Distributions 
136*e7776783SApple OSS Distributions 	/* Default is to inherit parent's coalition(s) */
137*e7776783SApple OSS Distributions 	psattrp->psa_coalition_info = NULL;
138*e7776783SApple OSS Distributions 
139*e7776783SApple OSS Distributions 	psattrp->psa_persona_info = NULL;
140*e7776783SApple OSS Distributions 
141*e7776783SApple OSS Distributions 	psattrp->psa_posix_cred_info = NULL;
142*e7776783SApple OSS Distributions 
143*e7776783SApple OSS Distributions 	/*
144*e7776783SApple OSS Distributions 	 * old coalition field
145*e7776783SApple OSS Distributions 	 * For backwards compatibility reasons, we set this to 1
146*e7776783SApple OSS Distributions 	 * which is the first valid coalition id. This will allow
147*e7776783SApple OSS Distributions 	 * newer user space code to properly spawn processes on
148*e7776783SApple OSS Distributions 	 * older kernels
149*e7776783SApple OSS Distributions 	 * (they will just all end up in the same coalition).
150*e7776783SApple OSS Distributions 	 */
151*e7776783SApple OSS Distributions 	psattrp->psa_reserved = 1;
152*e7776783SApple OSS Distributions 
153*e7776783SApple OSS Distributions 	/* Default is no new clamp */
154*e7776783SApple OSS Distributions 	psattrp->psa_qos_clamp = POSIX_SPAWN_PROC_CLAMP_NONE;
155*e7776783SApple OSS Distributions 
156*e7776783SApple OSS Distributions 	/* Default is no change to role */
157*e7776783SApple OSS Distributions 	psattrp->psa_darwin_role = POSIX_SPAWN_DARWIN_ROLE_NONE;
158*e7776783SApple OSS Distributions 
159*e7776783SApple OSS Distributions 	psattrp->psa_max_addr = 0;
160*e7776783SApple OSS Distributions 
161*e7776783SApple OSS Distributions 	psattrp->psa_no_smt = false;
162*e7776783SApple OSS Distributions 	psattrp->psa_tecs = false;
163*e7776783SApple OSS Distributions 
164*e7776783SApple OSS Distributions 	/* Default is no subsystem root path */
165*e7776783SApple OSS Distributions 	psattrp->psa_subsystem_root_path = NULL;
166*e7776783SApple OSS Distributions 
167*e7776783SApple OSS Distributions 	/* Default is no platform given */
168*e7776783SApple OSS Distributions 	psattrp->psa_platform = 0;
169*e7776783SApple OSS Distributions 
170*e7776783SApple OSS Distributions 	/* Default is no option */
171*e7776783SApple OSS Distributions 	psattrp->psa_options = PSA_OPTION_NONE;
172*e7776783SApple OSS Distributions 
173*e7776783SApple OSS Distributions 	/* Default is no port limit */
174*e7776783SApple OSS Distributions 	psattrp->psa_port_soft_limit = 0;
175*e7776783SApple OSS Distributions 	psattrp->psa_port_hard_limit = 0;
176*e7776783SApple OSS Distributions 
177*e7776783SApple OSS Distributions 	/* Default is no file descriptor limit */
178*e7776783SApple OSS Distributions 	psattrp->psa_filedesc_soft_limit = 0;
179*e7776783SApple OSS Distributions 	psattrp->psa_filedesc_hard_limit = 0;
180*e7776783SApple OSS Distributions }
181*e7776783SApple OSS Distributions 
182*e7776783SApple OSS Distributions /*
183*e7776783SApple OSS Distributions  * posix_spawnattr_init
184*e7776783SApple OSS Distributions  *
185*e7776783SApple OSS Distributions  * Description:	Initialize a spawn attributes object attr with default values
186*e7776783SApple OSS Distributions  *
187*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object to be
188*e7776783SApple OSS Distributions  *					initialized
189*e7776783SApple OSS Distributions  *
190*e7776783SApple OSS Distributions  * Returns:	0			Success
191*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to
192*e7776783SApple OSS Distributions  *					initialize the spawn attributes object.
193*e7776783SApple OSS Distributions  *
194*e7776783SApple OSS Distributions  * Note:	As an implementation detail, the externally visibily type
195*e7776783SApple OSS Distributions  *		posix_spawnattr_t is defined to be a void *, and initialization
196*e7776783SApple OSS Distributions  *		involves allocation of a memory object.  Subsequent changes to
197*e7776783SApple OSS Distributions  *		the spawn attributes may result in reallocation under the
198*e7776783SApple OSS Distributions  *		covers.
199*e7776783SApple OSS Distributions  *
200*e7776783SApple OSS Distributions  *		Reinitialization of an already initialized spawn attributes
201*e7776783SApple OSS Distributions  *		object will result in memory being leaked.  Because spawn
202*e7776783SApple OSS Distributions  *		attributes are not required to be used in conjunction with a
203*e7776783SApple OSS Distributions  *		static initializer, there is no way to distinguish a spawn
204*e7776783SApple OSS Distributions  *		attribute with stack garbage from one that's been initialized.
205*e7776783SApple OSS Distributions  *		This is arguably an API design error.
206*e7776783SApple OSS Distributions  */
207*e7776783SApple OSS Distributions int
posix_spawnattr_init(posix_spawnattr_t * attr)208*e7776783SApple OSS Distributions posix_spawnattr_init(posix_spawnattr_t *attr)
209*e7776783SApple OSS Distributions {
210*e7776783SApple OSS Distributions 	_posix_spawnattr_t *psattrp = (_posix_spawnattr_t *)attr;
211*e7776783SApple OSS Distributions 	int     err = 0;
212*e7776783SApple OSS Distributions 
213*e7776783SApple OSS Distributions 	if ((*psattrp = (_posix_spawnattr_t)malloc(sizeof(struct _posix_spawnattr))) == NULL) {
214*e7776783SApple OSS Distributions 		err = ENOMEM;
215*e7776783SApple OSS Distributions 	} else {
216*e7776783SApple OSS Distributions 		__posix_spawnattr_init(*psattrp);
217*e7776783SApple OSS Distributions 	}
218*e7776783SApple OSS Distributions 
219*e7776783SApple OSS Distributions 	return err;
220*e7776783SApple OSS Distributions }
221*e7776783SApple OSS Distributions 
222*e7776783SApple OSS Distributions 
223*e7776783SApple OSS Distributions /*
224*e7776783SApple OSS Distributions  * posix_spawnattr_destroy
225*e7776783SApple OSS Distributions  *
226*e7776783SApple OSS Distributions  * Description:	Destroy a spawn attributes object that was previously
227*e7776783SApple OSS Distributions  *		initialized via posix_spawnattr_init() by freeing any
228*e7776783SApple OSS Distributions  *		memory associated with it and setting it to an invalid value.
229*e7776783SApple OSS Distributions  *
230*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object to be
231*e7776783SApple OSS Distributions  *					destroyed.
232*e7776783SApple OSS Distributions  *
233*e7776783SApple OSS Distributions  * Returns:	0			Success
234*e7776783SApple OSS Distributions  *
235*e7776783SApple OSS Distributions  * Notes:	The destroyed spawn attribute results in the void * pointer
236*e7776783SApple OSS Distributions  *		being set to NULL; subsequent use without reinitialization
237*e7776783SApple OSS Distributions  *		will result in explicit program failure (rather than merely
238*e7776783SApple OSS Distributions  *		"undefined behaviour").
239*e7776783SApple OSS Distributions  *
240*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
241*e7776783SApple OSS Distributions  *		EINVAL	The value specified by attr is invalid.
242*e7776783SApple OSS Distributions  */
243*e7776783SApple OSS Distributions static int posix_spawn_destroyportactions_np(posix_spawnattr_t *);
244*e7776783SApple OSS Distributions static int posix_spawn_destroycoalition_info_np(posix_spawnattr_t *);
245*e7776783SApple OSS Distributions static int posix_spawn_destroypersona_info_np(posix_spawnattr_t *);
246*e7776783SApple OSS Distributions static int posix_spawn_destroyposix_cred_info_np(posix_spawnattr_t *);
247*e7776783SApple OSS Distributions static int posix_spawn_destroymacpolicy_info_np(posix_spawnattr_t *);
248*e7776783SApple OSS Distributions static int posix_spawn_destroysubsystem_root_path_np(posix_spawnattr_t *);
249*e7776783SApple OSS Distributions 
250*e7776783SApple OSS Distributions int
posix_spawnattr_destroy(posix_spawnattr_t * attr)251*e7776783SApple OSS Distributions posix_spawnattr_destroy(posix_spawnattr_t *attr)
252*e7776783SApple OSS Distributions {
253*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
254*e7776783SApple OSS Distributions 
255*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
256*e7776783SApple OSS Distributions 		return EINVAL;
257*e7776783SApple OSS Distributions 	}
258*e7776783SApple OSS Distributions 
259*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
260*e7776783SApple OSS Distributions 	posix_spawn_destroyportactions_np(attr);
261*e7776783SApple OSS Distributions 	posix_spawn_destroycoalition_info_np(attr);
262*e7776783SApple OSS Distributions 	posix_spawn_destroypersona_info_np(attr);
263*e7776783SApple OSS Distributions 	posix_spawn_destroyposix_cred_info_np(attr);
264*e7776783SApple OSS Distributions 	posix_spawn_destroymacpolicy_info_np(attr);
265*e7776783SApple OSS Distributions 	posix_spawn_destroysubsystem_root_path_np(attr);
266*e7776783SApple OSS Distributions 
267*e7776783SApple OSS Distributions 	free(psattr);
268*e7776783SApple OSS Distributions 	*attr = NULL;
269*e7776783SApple OSS Distributions 
270*e7776783SApple OSS Distributions 	return 0;
271*e7776783SApple OSS Distributions }
272*e7776783SApple OSS Distributions 
273*e7776783SApple OSS Distributions 
274*e7776783SApple OSS Distributions /*
275*e7776783SApple OSS Distributions  * posix_spawnattr_setflags
276*e7776783SApple OSS Distributions  *
277*e7776783SApple OSS Distributions  * Description:	Set the spawn flags attribute for the spawn attribute object
278*e7776783SApple OSS Distributions  *		referred to by 'attr'.
279*e7776783SApple OSS Distributions  *
280*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose flags
281*e7776783SApple OSS Distributions  *					are to be set
282*e7776783SApple OSS Distributions  *		flags			The flags value to set
283*e7776783SApple OSS Distributions  *
284*e7776783SApple OSS Distributions  * Returns:	0			Success
285*e7776783SApple OSS Distributions  *
286*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
287*e7776783SApple OSS Distributions  *		EINVAL	The value specified by attr is invalid.
288*e7776783SApple OSS Distributions  *		EINVAL	The value of the attribute being set is not valid.
289*e7776783SApple OSS Distributions  */
290*e7776783SApple OSS Distributions int
posix_spawnattr_setflags(posix_spawnattr_t * attr,short flags)291*e7776783SApple OSS Distributions posix_spawnattr_setflags(posix_spawnattr_t *attr, short flags)
292*e7776783SApple OSS Distributions {
293*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
294*e7776783SApple OSS Distributions 
295*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
296*e7776783SApple OSS Distributions 		return EINVAL;
297*e7776783SApple OSS Distributions 	}
298*e7776783SApple OSS Distributions 
299*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
300*e7776783SApple OSS Distributions 	psattr->psa_flags = flags;
301*e7776783SApple OSS Distributions 
302*e7776783SApple OSS Distributions 	return 0;
303*e7776783SApple OSS Distributions }
304*e7776783SApple OSS Distributions 
305*e7776783SApple OSS Distributions 
306*e7776783SApple OSS Distributions /*
307*e7776783SApple OSS Distributions  * posix_spawnattr_getflags
308*e7776783SApple OSS Distributions  *
309*e7776783SApple OSS Distributions  * Description:	Retrieve the spawn attributes flag for the spawn attributes
310*e7776783SApple OSS Distributions  *		object referenced by 'attr' and place them in the memory
311*e7776783SApple OSS Distributions  *		location referenced by 'flagsp'
312*e7776783SApple OSS Distributions  *
313*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose flags
314*e7776783SApple OSS Distributions  *					are to be retrieved
315*e7776783SApple OSS Distributions  *		flagsp			A pointer to a short value to receive
316*e7776783SApple OSS Distributions  *					the flags
317*e7776783SApple OSS Distributions  *
318*e7776783SApple OSS Distributions  * Returns:	0			Success
319*e7776783SApple OSS Distributions  *
320*e7776783SApple OSS Distributions  * Implicit Returns:
321*e7776783SApple OSS Distributions  *		*flagps (modified)	The flags value from the spawn
322*e7776783SApple OSS Distributions  *					attributes object
323*e7776783SApple OSS Distributions  *
324*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
325*e7776783SApple OSS Distributions  *		EINVAL	The value specified by attr is invalid.
326*e7776783SApple OSS Distributions  *		EINVAL	The value of the attribute being set is not valid.
327*e7776783SApple OSS Distributions  */
328*e7776783SApple OSS Distributions int
posix_spawnattr_getflags(const posix_spawnattr_t * __restrict attr,short * __restrict flagsp)329*e7776783SApple OSS Distributions posix_spawnattr_getflags(const posix_spawnattr_t * __restrict attr,
330*e7776783SApple OSS Distributions     short * __restrict flagsp)
331*e7776783SApple OSS Distributions {
332*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
333*e7776783SApple OSS Distributions 
334*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
335*e7776783SApple OSS Distributions 		return EINVAL;
336*e7776783SApple OSS Distributions 	}
337*e7776783SApple OSS Distributions 
338*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
339*e7776783SApple OSS Distributions 	*flagsp = psattr->psa_flags;
340*e7776783SApple OSS Distributions 
341*e7776783SApple OSS Distributions 	return 0;
342*e7776783SApple OSS Distributions }
343*e7776783SApple OSS Distributions 
344*e7776783SApple OSS Distributions 
345*e7776783SApple OSS Distributions /*
346*e7776783SApple OSS Distributions  * posix_spawnattr_getsigdefault
347*e7776783SApple OSS Distributions  *
348*e7776783SApple OSS Distributions  * Description:	Retrieve the set of signals to be set to default according to
349*e7776783SApple OSS Distributions  *		the spawn attribute value referenced by 'attr' and place the
350*e7776783SApple OSS Distributions  *		result into the memory containing the sigset_t referenced by
351*e7776783SApple OSS Distributions  *		'sigdefault'
352*e7776783SApple OSS Distributions  *
353*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
354*e7776783SApple OSS Distributions  *					signal set for default signals is to
355*e7776783SApple OSS Distributions  *					be retrieved
356*e7776783SApple OSS Distributions  *		sigdefault		A pointer to the sigset_t to receive
357*e7776783SApple OSS Distributions  *					the signal set
358*e7776783SApple OSS Distributions  *
359*e7776783SApple OSS Distributions  * Returns:	0			Success
360*e7776783SApple OSS Distributions  *
361*e7776783SApple OSS Distributions  * Implicit Returns:
362*e7776783SApple OSS Distributions  *		*sigdefault (modified)	The signal set of signals to default
363*e7776783SApple OSS Distributions  *					from the spawn attributes object
364*e7776783SApple OSS Distributions  */
365*e7776783SApple OSS Distributions int
posix_spawnattr_getsigdefault(const posix_spawnattr_t * __restrict attr,sigset_t * __restrict sigdefault)366*e7776783SApple OSS Distributions posix_spawnattr_getsigdefault(const posix_spawnattr_t * __restrict attr,
367*e7776783SApple OSS Distributions     sigset_t * __restrict sigdefault)
368*e7776783SApple OSS Distributions {
369*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
370*e7776783SApple OSS Distributions 
371*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
372*e7776783SApple OSS Distributions 		return EINVAL;
373*e7776783SApple OSS Distributions 	}
374*e7776783SApple OSS Distributions 
375*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
376*e7776783SApple OSS Distributions 	*sigdefault = psattr->psa_sigdefault;
377*e7776783SApple OSS Distributions 
378*e7776783SApple OSS Distributions 	return 0;
379*e7776783SApple OSS Distributions }
380*e7776783SApple OSS Distributions 
381*e7776783SApple OSS Distributions 
382*e7776783SApple OSS Distributions /*
383*e7776783SApple OSS Distributions  * posix_spawnattr_getpgroup
384*e7776783SApple OSS Distributions  *
385*e7776783SApple OSS Distributions  * Description:	Obtain the value of the spawn process group attribute from the
386*e7776783SApple OSS Distributions  *		spawn attributes object referenced by 'attr' and place the
387*e7776783SApple OSS Distributions  *		results in the memory location referenced by 'pgroup'
388*e7776783SApple OSS Distributions  *
389*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
390*e7776783SApple OSS Distributions  *					process group information is to be
391*e7776783SApple OSS Distributions  *					retrieved
392*e7776783SApple OSS Distributions  *		pgroup			A pointer to the pid_t to receive the
393*e7776783SApple OSS Distributions  *					process group
394*e7776783SApple OSS Distributions  *
395*e7776783SApple OSS Distributions  * Returns:	0			Success
396*e7776783SApple OSS Distributions  *
397*e7776783SApple OSS Distributions  * Implicit Returns:
398*e7776783SApple OSS Distributions  *		*pgroup (modified)	The process group information from the
399*e7776783SApple OSS Distributions  *					spawn attributes object
400*e7776783SApple OSS Distributions  */
401*e7776783SApple OSS Distributions int
posix_spawnattr_getpgroup(const posix_spawnattr_t * __restrict attr,pid_t * __restrict pgroup)402*e7776783SApple OSS Distributions posix_spawnattr_getpgroup(const posix_spawnattr_t * __restrict attr,
403*e7776783SApple OSS Distributions     pid_t * __restrict pgroup)
404*e7776783SApple OSS Distributions {
405*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
406*e7776783SApple OSS Distributions 
407*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
408*e7776783SApple OSS Distributions 		return EINVAL;
409*e7776783SApple OSS Distributions 	}
410*e7776783SApple OSS Distributions 
411*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
412*e7776783SApple OSS Distributions 	*pgroup = psattr->psa_pgroup;
413*e7776783SApple OSS Distributions 
414*e7776783SApple OSS Distributions 	return 0;
415*e7776783SApple OSS Distributions }
416*e7776783SApple OSS Distributions 
417*e7776783SApple OSS Distributions 
418*e7776783SApple OSS Distributions /*
419*e7776783SApple OSS Distributions  * posix_spawnattr_getsigmask
420*e7776783SApple OSS Distributions  *
421*e7776783SApple OSS Distributions  * Description:	Obtain the value of the spawn signal mask attribute from the
422*e7776783SApple OSS Distributions  *		spawn attributes object referenced by 'attr' and place the
423*e7776783SApple OSS Distributions  *		result into the memory containing the sigset_t referenced by
424*e7776783SApple OSS Distributions  *		'sigmask'
425*e7776783SApple OSS Distributions  *
426*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
427*e7776783SApple OSS Distributions  *					signal set for masked signals is to
428*e7776783SApple OSS Distributions  *					be retrieved
429*e7776783SApple OSS Distributions  *		sigmask		A pointer to the sigset_t to receive
430*e7776783SApple OSS Distributions  *					the signal set
431*e7776783SApple OSS Distributions  *
432*e7776783SApple OSS Distributions  * Returns:	0			Success
433*e7776783SApple OSS Distributions  *
434*e7776783SApple OSS Distributions  * Implicit Returns:
435*e7776783SApple OSS Distributions  *		*sigmask (modified)	The signal set of signals to mask
436*e7776783SApple OSS Distributions  *					from the spawn attributes object
437*e7776783SApple OSS Distributions  */
438*e7776783SApple OSS Distributions int
posix_spawnattr_getsigmask(const posix_spawnattr_t * __restrict attr,sigset_t * __restrict sigmask)439*e7776783SApple OSS Distributions posix_spawnattr_getsigmask(const posix_spawnattr_t * __restrict attr,
440*e7776783SApple OSS Distributions     sigset_t * __restrict sigmask)
441*e7776783SApple OSS Distributions {
442*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
443*e7776783SApple OSS Distributions 
444*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
445*e7776783SApple OSS Distributions 		return EINVAL;
446*e7776783SApple OSS Distributions 	}
447*e7776783SApple OSS Distributions 
448*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
449*e7776783SApple OSS Distributions 	*sigmask = psattr->psa_sigmask;
450*e7776783SApple OSS Distributions 
451*e7776783SApple OSS Distributions 	return 0;
452*e7776783SApple OSS Distributions }
453*e7776783SApple OSS Distributions 
454*e7776783SApple OSS Distributions /*
455*e7776783SApple OSS Distributions  * posix_spawnattr_getbinpref_np
456*e7776783SApple OSS Distributions  *
457*e7776783SApple OSS Distributions  * Description:	Obtain the value of the spawn binary preferences attribute from
458*e7776783SApple OSS Distributions  *              the spawn attributes object referenced by 'attr' and place the
459*e7776783SApple OSS Distributions  *		result into the memory referenced by 'pref'.
460*e7776783SApple OSS Distributions  *
461*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
462*e7776783SApple OSS Distributions  *					binary preferences are to be retrieved
463*e7776783SApple OSS Distributions  *		count			The size of the cpu_type_t array
464*e7776783SApple OSS Distributions  *		pref			An array of cpu types
465*e7776783SApple OSS Distributions  *		ocount			The actual number copied
466*e7776783SApple OSS Distributions  *
467*e7776783SApple OSS Distributions  * Returns:	0			No binary preferences found
468*e7776783SApple OSS Distributions  *              > 0			The number of cpu types (less than
469*e7776783SApple OSS Distributions  *                                      count) copied over from 'attr'.
470*e7776783SApple OSS Distributions  *
471*e7776783SApple OSS Distributions  * Implicit Returns:
472*e7776783SApple OSS Distributions  *		*pref (modified)	The binary preferences array
473*e7776783SApple OSS Distributions  *					from the spawn attributes object
474*e7776783SApple OSS Distributions  */
475*e7776783SApple OSS Distributions int
posix_spawnattr_getbinpref_np(const posix_spawnattr_t * __restrict attr,size_t count,cpu_type_t * pref,size_t * __restrict ocount)476*e7776783SApple OSS Distributions posix_spawnattr_getbinpref_np(const posix_spawnattr_t * __restrict attr,
477*e7776783SApple OSS Distributions     size_t count, cpu_type_t *pref, size_t * __restrict ocount)
478*e7776783SApple OSS Distributions {
479*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
480*e7776783SApple OSS Distributions 	int i = 0;
481*e7776783SApple OSS Distributions 
482*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || pref == NULL) {
483*e7776783SApple OSS Distributions 		return EINVAL;
484*e7776783SApple OSS Distributions 	}
485*e7776783SApple OSS Distributions 
486*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
487*e7776783SApple OSS Distributions 	for (i = 0; i < count && i < NBINPREFS; i++) {
488*e7776783SApple OSS Distributions 		pref[i] = psattr->psa_binprefs[i];
489*e7776783SApple OSS Distributions 	}
490*e7776783SApple OSS Distributions 
491*e7776783SApple OSS Distributions 	if (ocount) {
492*e7776783SApple OSS Distributions 		*ocount = i;
493*e7776783SApple OSS Distributions 	}
494*e7776783SApple OSS Distributions 	return 0;
495*e7776783SApple OSS Distributions }
496*e7776783SApple OSS Distributions 
497*e7776783SApple OSS Distributions /*
498*e7776783SApple OSS Distributions  * posix_spawnattr_getarchpref_np
499*e7776783SApple OSS Distributions  *
500*e7776783SApple OSS Distributions  * Description:	Obtain the value of the spawn binary preferences attribute from
501*e7776783SApple OSS Distributions  *              the spawn attributes object referenced by 'attr' and place the
502*e7776783SApple OSS Distributions  *		result into the memory referenced by 'pref' and 'subpref'.
503*e7776783SApple OSS Distributions  *
504*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
505*e7776783SApple OSS Distributions  *					binary preferences are to be retrieved
506*e7776783SApple OSS Distributions  *		count			The size of the cpu_type_t array
507*e7776783SApple OSS Distributions  *		pref			An array of cpu types
508*e7776783SApple OSS Distributions  *		subpref			An array of subcpu types
509*e7776783SApple OSS Distributions  *		ocount			The actual number copied
510*e7776783SApple OSS Distributions  *
511*e7776783SApple OSS Distributions  * Returns:	0			No cpu/subcpu preferences found
512*e7776783SApple OSS Distributions  *              > 0			The number of types (less than
513*e7776783SApple OSS Distributions  *                                      count) copied over from 'attr'.
514*e7776783SApple OSS Distributions  *
515*e7776783SApple OSS Distributions  * Implicit Returns:
516*e7776783SApple OSS Distributions  *		*pref (modified)	The cpu preferences array
517*e7776783SApple OSS Distributions  *					from the spawn attributes object
518*e7776783SApple OSS Distributions  *		*subpref (modified)	The subcpu preferences array
519*e7776783SApple OSS Distributions  *					from the spawn attributes object
520*e7776783SApple OSS Distributions  */
521*e7776783SApple OSS Distributions int
posix_spawnattr_getarchpref_np(const posix_spawnattr_t * __restrict attr,size_t count,cpu_type_t * pref,cpu_subtype_t * subpref,size_t * __restrict ocount)522*e7776783SApple OSS Distributions posix_spawnattr_getarchpref_np(const posix_spawnattr_t * __restrict attr,
523*e7776783SApple OSS Distributions     size_t count, cpu_type_t *pref, cpu_subtype_t *subpref, size_t * __restrict ocount)
524*e7776783SApple OSS Distributions {
525*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
526*e7776783SApple OSS Distributions 	int i = 0;
527*e7776783SApple OSS Distributions 
528*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || pref == NULL || subpref == NULL) {
529*e7776783SApple OSS Distributions 		return EINVAL;
530*e7776783SApple OSS Distributions 	}
531*e7776783SApple OSS Distributions 
532*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
533*e7776783SApple OSS Distributions 	for (i = 0; i < count && i < NBINPREFS; i++) {
534*e7776783SApple OSS Distributions 		pref[i] = psattr->psa_binprefs[i];
535*e7776783SApple OSS Distributions 		subpref[i] = psattr->psa_subcpuprefs[i];
536*e7776783SApple OSS Distributions 	}
537*e7776783SApple OSS Distributions 
538*e7776783SApple OSS Distributions 	if (ocount) {
539*e7776783SApple OSS Distributions 		*ocount = i;
540*e7776783SApple OSS Distributions 	}
541*e7776783SApple OSS Distributions 	return 0;
542*e7776783SApple OSS Distributions }
543*e7776783SApple OSS Distributions 
544*e7776783SApple OSS Distributions 
545*e7776783SApple OSS Distributions /*
546*e7776783SApple OSS Distributions  * posix_spawnattr_getpcontrol_np
547*e7776783SApple OSS Distributions  *
548*e7776783SApple OSS Distributions  * Description:	Retrieve the  process control property set default according to
549*e7776783SApple OSS Distributions  *		the spawn attribute value referenced by 'attr' and place the
550*e7776783SApple OSS Distributions  *		result into the memory containing the control  referenced by
551*e7776783SApple OSS Distributions  *		'pcontrol'
552*e7776783SApple OSS Distributions  *
553*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
554*e7776783SApple OSS Distributions  *					signal set for default signals is to
555*e7776783SApple OSS Distributions  *					be retrieved
556*e7776783SApple OSS Distributions  *		pcontrol		A pointer to an int  to receive
557*e7776783SApple OSS Distributions  *					the process control info
558*e7776783SApple OSS Distributions  *
559*e7776783SApple OSS Distributions  * Returns:	0			Success
560*e7776783SApple OSS Distributions  *
561*e7776783SApple OSS Distributions  * Implicit Returns:
562*e7776783SApple OSS Distributions  *		*pcontrol (modified)	The signal set of signals to default
563*e7776783SApple OSS Distributions  *					from the spawn attributes object
564*e7776783SApple OSS Distributions  */
565*e7776783SApple OSS Distributions int
posix_spawnattr_getpcontrol_np(const posix_spawnattr_t * __restrict attr,int * __restrict pcontrol)566*e7776783SApple OSS Distributions posix_spawnattr_getpcontrol_np(const posix_spawnattr_t * __restrict attr,
567*e7776783SApple OSS Distributions     int * __restrict pcontrol)
568*e7776783SApple OSS Distributions {
569*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
570*e7776783SApple OSS Distributions 
571*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
572*e7776783SApple OSS Distributions 		return EINVAL;
573*e7776783SApple OSS Distributions 	}
574*e7776783SApple OSS Distributions 
575*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
576*e7776783SApple OSS Distributions 	*pcontrol = psattr->psa_pcontrol;
577*e7776783SApple OSS Distributions 
578*e7776783SApple OSS Distributions 	return 0;
579*e7776783SApple OSS Distributions }
580*e7776783SApple OSS Distributions 
581*e7776783SApple OSS Distributions /*
582*e7776783SApple OSS Distributions  * posix_spawnattr_getprocesstype_np
583*e7776783SApple OSS Distributions  *
584*e7776783SApple OSS Distributions  * Description:	Retrieve the  process specific behaviors and app launch types
585*e7776783SApple OSS Distributions  *		spawn attribute value referenced by 'attr' and place the
586*e7776783SApple OSS Distributions  *		result into the memory containing the control  referenced by
587*e7776783SApple OSS Distributions  *		'proctype'
588*e7776783SApple OSS Distributions  *
589*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
590*e7776783SApple OSS Distributions  *					signal set for default signals is to
591*e7776783SApple OSS Distributions  *					be retrieved
592*e7776783SApple OSS Distributions  *		proctype		A pointer to an int  to receive
593*e7776783SApple OSS Distributions  *					the process type info
594*e7776783SApple OSS Distributions  *
595*e7776783SApple OSS Distributions  * Returns:	0			Success
596*e7776783SApple OSS Distributions  *
597*e7776783SApple OSS Distributions  * Implicit Returns:
598*e7776783SApple OSS Distributions  *		*proctype (modified)	The process type set to value
599*e7776783SApple OSS Distributions  *					from the spawn attributes object
600*e7776783SApple OSS Distributions  */
601*e7776783SApple OSS Distributions int
posix_spawnattr_getprocesstype_np(const posix_spawnattr_t * __restrict attr,int * __restrict proctype)602*e7776783SApple OSS Distributions posix_spawnattr_getprocesstype_np(const posix_spawnattr_t * __restrict attr,
603*e7776783SApple OSS Distributions     int * __restrict proctype)
604*e7776783SApple OSS Distributions {
605*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
606*e7776783SApple OSS Distributions 
607*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
608*e7776783SApple OSS Distributions 		return EINVAL;
609*e7776783SApple OSS Distributions 	}
610*e7776783SApple OSS Distributions 
611*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
612*e7776783SApple OSS Distributions 	*proctype = psattr->psa_apptype;
613*e7776783SApple OSS Distributions 
614*e7776783SApple OSS Distributions 	return 0;
615*e7776783SApple OSS Distributions }
616*e7776783SApple OSS Distributions /*
617*e7776783SApple OSS Distributions  * posix_spawnattr_setsigdefault
618*e7776783SApple OSS Distributions  *
619*e7776783SApple OSS Distributions  * Description:	Set the set of signals to be set to default for the spawn
620*e7776783SApple OSS Distributions  *		attribute value referenced by 'attr' from the memory
621*e7776783SApple OSS Distributions  *		containing the sigset_t referenced by 'sigdefault'
622*e7776783SApple OSS Distributions  *
623*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
624*e7776783SApple OSS Distributions  *					signal set for default signals is to
625*e7776783SApple OSS Distributions  *					be set
626*e7776783SApple OSS Distributions  *		sigdefault		A pointer to the sigset_t from which to
627*e7776783SApple OSS Distributions  *					obtain the signal set
628*e7776783SApple OSS Distributions  *
629*e7776783SApple OSS Distributions  * Returns:	0			Success
630*e7776783SApple OSS Distributions  */
631*e7776783SApple OSS Distributions int
posix_spawnattr_setsigdefault(posix_spawnattr_t * __restrict attr,const sigset_t * __restrict sigdefault)632*e7776783SApple OSS Distributions posix_spawnattr_setsigdefault(posix_spawnattr_t * __restrict attr,
633*e7776783SApple OSS Distributions     const sigset_t * __restrict sigdefault)
634*e7776783SApple OSS Distributions {
635*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
636*e7776783SApple OSS Distributions 
637*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
638*e7776783SApple OSS Distributions 		return EINVAL;
639*e7776783SApple OSS Distributions 	}
640*e7776783SApple OSS Distributions 
641*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
642*e7776783SApple OSS Distributions 	psattr->psa_sigdefault = *sigdefault;
643*e7776783SApple OSS Distributions 
644*e7776783SApple OSS Distributions 	return 0;
645*e7776783SApple OSS Distributions }
646*e7776783SApple OSS Distributions 
647*e7776783SApple OSS Distributions 
648*e7776783SApple OSS Distributions /*
649*e7776783SApple OSS Distributions  * posix_spawnattr_setpgroup
650*e7776783SApple OSS Distributions  *
651*e7776783SApple OSS Distributions  * Description:	Set the value of the spawn process group attribute for the
652*e7776783SApple OSS Distributions  *		spawn attributes object referenced by 'attr' from the value
653*e7776783SApple OSS Distributions  *		of 'pgroup'
654*e7776783SApple OSS Distributions  *
655*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object for which
656*e7776783SApple OSS Distributions  *					the process group information is to be
657*e7776783SApple OSS Distributions  *					set
658*e7776783SApple OSS Distributions  *		pgroup			The process group to set
659*e7776783SApple OSS Distributions  *
660*e7776783SApple OSS Distributions  * Returns:	0			Success
661*e7776783SApple OSS Distributions  */
662*e7776783SApple OSS Distributions int
posix_spawnattr_setpgroup(posix_spawnattr_t * attr,pid_t pgroup)663*e7776783SApple OSS Distributions posix_spawnattr_setpgroup(posix_spawnattr_t * attr, pid_t pgroup)
664*e7776783SApple OSS Distributions {
665*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
666*e7776783SApple OSS Distributions 
667*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
668*e7776783SApple OSS Distributions 		return EINVAL;
669*e7776783SApple OSS Distributions 	}
670*e7776783SApple OSS Distributions 
671*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
672*e7776783SApple OSS Distributions 	psattr->psa_pgroup = pgroup;
673*e7776783SApple OSS Distributions 
674*e7776783SApple OSS Distributions 	return 0;
675*e7776783SApple OSS Distributions }
676*e7776783SApple OSS Distributions 
677*e7776783SApple OSS Distributions 
678*e7776783SApple OSS Distributions /*
679*e7776783SApple OSS Distributions  * posix_spawnattr_setsigmask
680*e7776783SApple OSS Distributions  *
681*e7776783SApple OSS Distributions  * Description:	Set the set of signals to be masked for the spawn attribute
682*e7776783SApple OSS Distributions  *		value referenced by 'attr' from the memory containing the
683*e7776783SApple OSS Distributions  *		sigset_t referenced by 'sigmask'
684*e7776783SApple OSS Distributions  *
685*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
686*e7776783SApple OSS Distributions  *					signal set for masked signals is to
687*e7776783SApple OSS Distributions  *					be set
688*e7776783SApple OSS Distributions  *		sigmask		A pointer to the sigset_t from which to
689*e7776783SApple OSS Distributions  *					obtain the signal set
690*e7776783SApple OSS Distributions  *
691*e7776783SApple OSS Distributions  * Returns:	0			Success
692*e7776783SApple OSS Distributions  */
693*e7776783SApple OSS Distributions int
posix_spawnattr_setsigmask(posix_spawnattr_t * __restrict attr,const sigset_t * __restrict sigmask)694*e7776783SApple OSS Distributions posix_spawnattr_setsigmask(posix_spawnattr_t * __restrict attr,
695*e7776783SApple OSS Distributions     const sigset_t * __restrict sigmask)
696*e7776783SApple OSS Distributions {
697*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
698*e7776783SApple OSS Distributions 
699*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
700*e7776783SApple OSS Distributions 		return EINVAL;
701*e7776783SApple OSS Distributions 	}
702*e7776783SApple OSS Distributions 
703*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
704*e7776783SApple OSS Distributions 	psattr->psa_sigmask = *sigmask;
705*e7776783SApple OSS Distributions 
706*e7776783SApple OSS Distributions 	return 0;
707*e7776783SApple OSS Distributions }
708*e7776783SApple OSS Distributions 
709*e7776783SApple OSS Distributions 
710*e7776783SApple OSS Distributions /*
711*e7776783SApple OSS Distributions  * posix_spawnattr_setbinpref_np
712*e7776783SApple OSS Distributions  *
713*e7776783SApple OSS Distributions  * Description:	Set the universal binary preferences for the spawn attribute
714*e7776783SApple OSS Distributions  *		value referenced by 'attr' from the memory containing the
715*e7776783SApple OSS Distributions  *		cpu_type_t array referenced by 'pref', size of 'count'
716*e7776783SApple OSS Distributions  *
717*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
718*e7776783SApple OSS Distributions  *                                      binary preferences are to be set
719*e7776783SApple OSS Distributions  *              count			Size of the array pointed to by 'pref'
720*e7776783SApple OSS Distributions  *              pref			cpu_type_t array of binary preferences
721*e7776783SApple OSS Distributions  *		ocount			The actual number copied
722*e7776783SApple OSS Distributions  *
723*e7776783SApple OSS Distributions  * Returns:	0			No preferences copied
724*e7776783SApple OSS Distributions  *              > 0			Number of preferences copied
725*e7776783SApple OSS Distributions  *
726*e7776783SApple OSS Distributions  * Note:	The posix_spawnattr_t currently only holds four cpu_type_t's.
727*e7776783SApple OSS Distributions  *              If the caller provides more preferences than this limit, they
728*e7776783SApple OSS Distributions  *              will be ignored, as reflected in the return value.
729*e7776783SApple OSS Distributions  */
730*e7776783SApple OSS Distributions int
posix_spawnattr_setbinpref_np(posix_spawnattr_t * __restrict attr,size_t count,cpu_type_t * pref,size_t * __restrict ocount)731*e7776783SApple OSS Distributions posix_spawnattr_setbinpref_np(posix_spawnattr_t * __restrict attr,
732*e7776783SApple OSS Distributions     size_t count, cpu_type_t *pref, size_t * __restrict ocount)
733*e7776783SApple OSS Distributions {
734*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
735*e7776783SApple OSS Distributions 	int i = 0;
736*e7776783SApple OSS Distributions 
737*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || pref == NULL) {
738*e7776783SApple OSS Distributions 		return EINVAL;
739*e7776783SApple OSS Distributions 	}
740*e7776783SApple OSS Distributions 
741*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
742*e7776783SApple OSS Distributions 	for (i = 0; i < count && i < NBINPREFS; i++) {
743*e7776783SApple OSS Distributions 		psattr->psa_binprefs[i] = pref[i];
744*e7776783SApple OSS Distributions 		psattr->psa_subcpuprefs[i] = CPU_SUBTYPE_ANY;
745*e7776783SApple OSS Distributions 	}
746*e7776783SApple OSS Distributions 
747*e7776783SApple OSS Distributions 	/* return number of binprefs copied over */
748*e7776783SApple OSS Distributions 	if (ocount) {
749*e7776783SApple OSS Distributions 		*ocount = i;
750*e7776783SApple OSS Distributions 	}
751*e7776783SApple OSS Distributions 
752*e7776783SApple OSS Distributions 	for (; i < NBINPREFS; i++) {
753*e7776783SApple OSS Distributions 		psattr->psa_binprefs[i] = 0;
754*e7776783SApple OSS Distributions 		psattr->psa_subcpuprefs[i] = CPU_SUBTYPE_ANY;
755*e7776783SApple OSS Distributions 	}
756*e7776783SApple OSS Distributions 
757*e7776783SApple OSS Distributions 	return 0;
758*e7776783SApple OSS Distributions }
759*e7776783SApple OSS Distributions 
760*e7776783SApple OSS Distributions /*
761*e7776783SApple OSS Distributions  * posix_spawnattr_setarchpref_np
762*e7776783SApple OSS Distributions  *
763*e7776783SApple OSS Distributions  * Description:	Set the universal binary preferences for the spawn attribute
764*e7776783SApple OSS Distributions  *		value referenced by 'attr' from the memory containing the
765*e7776783SApple OSS Distributions  *		cpu_type_t array referenced by 'pref', the cpu_subtype_t array
766*e7776783SApple OSS Distributions  *		referenced by 'subpref' and size of 'count'
767*e7776783SApple OSS Distributions  *
768*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
769*e7776783SApple OSS Distributions  *                                      binary preferences are to be set
770*e7776783SApple OSS Distributions  *              count			Size of the array pointed to by 'pref'
771*e7776783SApple OSS Distributions  *              pref			cpu_type_t array of cpu binary preferences
772*e7776783SApple OSS Distributions  *              subpref			cpu_subtype_t array of subcpu binary preferences
773*e7776783SApple OSS Distributions  *		ocount			The actual number copied
774*e7776783SApple OSS Distributions  *
775*e7776783SApple OSS Distributions  * Returns:	0			No preferences copied
776*e7776783SApple OSS Distributions  *              > 0			Number of preferences copied
777*e7776783SApple OSS Distributions  *
778*e7776783SApple OSS Distributions  * Note:	The posix_spawnattr_t currently only holds four
779*e7776783SApple OSS Distributions  *              cpu_type_t/cpu_subtype_t pairs.
780*e7776783SApple OSS Distributions  *              If the caller provides more preferences than this limit, they
781*e7776783SApple OSS Distributions  *              will be ignored, as reflected in the return value.
782*e7776783SApple OSS Distributions  */
783*e7776783SApple OSS Distributions int
posix_spawnattr_setarchpref_np(posix_spawnattr_t * __restrict attr,size_t count,cpu_type_t * pref,cpu_subtype_t * subpref,size_t * __restrict ocount)784*e7776783SApple OSS Distributions posix_spawnattr_setarchpref_np(posix_spawnattr_t * __restrict attr,
785*e7776783SApple OSS Distributions     size_t count, cpu_type_t *pref, cpu_subtype_t *subpref,
786*e7776783SApple OSS Distributions     size_t * __restrict ocount)
787*e7776783SApple OSS Distributions {
788*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
789*e7776783SApple OSS Distributions 	int i = 0;
790*e7776783SApple OSS Distributions 
791*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || pref == NULL || subpref == NULL) {
792*e7776783SApple OSS Distributions 		return EINVAL;
793*e7776783SApple OSS Distributions 	}
794*e7776783SApple OSS Distributions 
795*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
796*e7776783SApple OSS Distributions 	for (i = 0; i < count && i < NBINPREFS; i++) {
797*e7776783SApple OSS Distributions 		psattr->psa_binprefs[i] = pref[i];
798*e7776783SApple OSS Distributions 		psattr->psa_subcpuprefs[i] = subpref[i];
799*e7776783SApple OSS Distributions 	}
800*e7776783SApple OSS Distributions 
801*e7776783SApple OSS Distributions 	/* return number of binprefs copied over */
802*e7776783SApple OSS Distributions 	if (ocount) {
803*e7776783SApple OSS Distributions 		*ocount = i;
804*e7776783SApple OSS Distributions 	}
805*e7776783SApple OSS Distributions 
806*e7776783SApple OSS Distributions 	for (; i < NBINPREFS; i++) {
807*e7776783SApple OSS Distributions 		psattr->psa_binprefs[i] = 0;
808*e7776783SApple OSS Distributions 		psattr->psa_subcpuprefs[i] = CPU_SUBTYPE_ANY;
809*e7776783SApple OSS Distributions 	}
810*e7776783SApple OSS Distributions 
811*e7776783SApple OSS Distributions 	return 0;
812*e7776783SApple OSS Distributions }
813*e7776783SApple OSS Distributions 
814*e7776783SApple OSS Distributions /*
815*e7776783SApple OSS Distributions  * posix_spawnattr_setpcontrol_np
816*e7776783SApple OSS Distributions  *
817*e7776783SApple OSS Distributions  * Description:	Set the process control property according to
818*e7776783SApple OSS Distributions  *		attribute value referenced by 'attr' from the memory
819*e7776783SApple OSS Distributions  *		containing the int value 'pcontrol'
820*e7776783SApple OSS Distributions  *
821*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
822*e7776783SApple OSS Distributions  *					signal set for default signals is to
823*e7776783SApple OSS Distributions  *					be set
824*e7776783SApple OSS Distributions  *		pcontrol		An int value of the process control info
825*e7776783SApple OSS Distributions  *
826*e7776783SApple OSS Distributions  * Returns:	0			Success
827*e7776783SApple OSS Distributions  */
828*e7776783SApple OSS Distributions int
posix_spawnattr_setpcontrol_np(posix_spawnattr_t * __restrict attr,const int pcontrol)829*e7776783SApple OSS Distributions posix_spawnattr_setpcontrol_np(posix_spawnattr_t * __restrict attr,
830*e7776783SApple OSS Distributions     const int pcontrol)
831*e7776783SApple OSS Distributions {
832*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
833*e7776783SApple OSS Distributions 
834*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
835*e7776783SApple OSS Distributions 		return EINVAL;
836*e7776783SApple OSS Distributions 	}
837*e7776783SApple OSS Distributions 
838*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
839*e7776783SApple OSS Distributions 	psattr->psa_pcontrol = pcontrol;
840*e7776783SApple OSS Distributions 
841*e7776783SApple OSS Distributions 	return 0;
842*e7776783SApple OSS Distributions }
843*e7776783SApple OSS Distributions 
844*e7776783SApple OSS Distributions 
845*e7776783SApple OSS Distributions /*
846*e7776783SApple OSS Distributions  * posix_spawnattr_setprocesstype_np
847*e7776783SApple OSS Distributions  *
848*e7776783SApple OSS Distributions  * Description:	Set the process specific behaviors and app launch type
849*e7776783SApple OSS Distributions  *		attribute value referenced by 'attr' from the memory
850*e7776783SApple OSS Distributions  *		containing the int value 'proctype'
851*e7776783SApple OSS Distributions  *
852*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object whose
853*e7776783SApple OSS Distributions  *					signal set for default signals is to
854*e7776783SApple OSS Distributions  *					be set
855*e7776783SApple OSS Distributions  *		proctype		An int value of the process type info
856*e7776783SApple OSS Distributions  *
857*e7776783SApple OSS Distributions  * Returns:	0			Success
858*e7776783SApple OSS Distributions  */
859*e7776783SApple OSS Distributions int
posix_spawnattr_setprocesstype_np(posix_spawnattr_t * __restrict attr,const int proctype)860*e7776783SApple OSS Distributions posix_spawnattr_setprocesstype_np(posix_spawnattr_t * __restrict attr,
861*e7776783SApple OSS Distributions     const int proctype)
862*e7776783SApple OSS Distributions {
863*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
864*e7776783SApple OSS Distributions 
865*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
866*e7776783SApple OSS Distributions 		return EINVAL;
867*e7776783SApple OSS Distributions 	}
868*e7776783SApple OSS Distributions 
869*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
870*e7776783SApple OSS Distributions 	psattr->psa_apptype = proctype;
871*e7776783SApple OSS Distributions 
872*e7776783SApple OSS Distributions 	return 0;
873*e7776783SApple OSS Distributions }
874*e7776783SApple OSS Distributions 
875*e7776783SApple OSS Distributions /*
876*e7776783SApple OSS Distributions  * posix_spawn_createportactions_np
877*e7776783SApple OSS Distributions  * Description: create a new posix_spawn_port_actions struct and link
878*e7776783SApple OSS Distributions  *      it into the posix_spawnattr.
879*e7776783SApple OSS Distributions  */
880*e7776783SApple OSS Distributions static int
posix_spawn_createportactions_np(posix_spawnattr_t * attr)881*e7776783SApple OSS Distributions posix_spawn_createportactions_np(posix_spawnattr_t *attr)
882*e7776783SApple OSS Distributions {
883*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
884*e7776783SApple OSS Distributions 	_posix_spawn_port_actions_t acts;
885*e7776783SApple OSS Distributions 
886*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
887*e7776783SApple OSS Distributions 		return EINVAL;
888*e7776783SApple OSS Distributions 	}
889*e7776783SApple OSS Distributions 
890*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
891*e7776783SApple OSS Distributions 	acts = (_posix_spawn_port_actions_t)malloc(PS_PORT_ACTIONS_SIZE(2));
892*e7776783SApple OSS Distributions 	if (acts == NULL) {
893*e7776783SApple OSS Distributions 		return ENOMEM;
894*e7776783SApple OSS Distributions 	}
895*e7776783SApple OSS Distributions 
896*e7776783SApple OSS Distributions 	acts->pspa_alloc = 2;
897*e7776783SApple OSS Distributions 	acts->pspa_count = 0;
898*e7776783SApple OSS Distributions 
899*e7776783SApple OSS Distributions 	psattr->psa_ports = acts;
900*e7776783SApple OSS Distributions 	return 0;
901*e7776783SApple OSS Distributions }
902*e7776783SApple OSS Distributions 
903*e7776783SApple OSS Distributions /*
904*e7776783SApple OSS Distributions  * posix_spawn_growportactions_np
905*e7776783SApple OSS Distributions  * Description: Enlarge the size of portactions if necessary
906*e7776783SApple OSS Distributions  */
907*e7776783SApple OSS Distributions static int
posix_spawn_growportactions_np(posix_spawnattr_t * attr)908*e7776783SApple OSS Distributions posix_spawn_growportactions_np(posix_spawnattr_t *attr)
909*e7776783SApple OSS Distributions {
910*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
911*e7776783SApple OSS Distributions 	_posix_spawn_port_actions_t acts;
912*e7776783SApple OSS Distributions 
913*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
914*e7776783SApple OSS Distributions 		return EINVAL;
915*e7776783SApple OSS Distributions 	}
916*e7776783SApple OSS Distributions 
917*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
918*e7776783SApple OSS Distributions 	acts = psattr->psa_ports;
919*e7776783SApple OSS Distributions 	if (acts == NULL) {
920*e7776783SApple OSS Distributions 		return EINVAL;
921*e7776783SApple OSS Distributions 	}
922*e7776783SApple OSS Distributions 
923*e7776783SApple OSS Distributions 	/* Double number of port actions allocated for */
924*e7776783SApple OSS Distributions 	int newnum = 0;
925*e7776783SApple OSS Distributions 	if (os_mul_overflow(acts->pspa_alloc, 2, &newnum)) {
926*e7776783SApple OSS Distributions 		return ENOMEM;
927*e7776783SApple OSS Distributions 	}
928*e7776783SApple OSS Distributions 	size_t newsize = PS_PORT_ACTIONS_SIZE(newnum);
929*e7776783SApple OSS Distributions 	if (newsize == 0) {
930*e7776783SApple OSS Distributions 		return ENOMEM;
931*e7776783SApple OSS Distributions 	}
932*e7776783SApple OSS Distributions 
933*e7776783SApple OSS Distributions 	acts = realloc(acts, newsize);
934*e7776783SApple OSS Distributions 	if (acts == NULL) {
935*e7776783SApple OSS Distributions 		return ENOMEM;
936*e7776783SApple OSS Distributions 	}
937*e7776783SApple OSS Distributions 
938*e7776783SApple OSS Distributions 	acts->pspa_alloc = newnum;
939*e7776783SApple OSS Distributions 	psattr->psa_ports = acts;
940*e7776783SApple OSS Distributions 	return 0;
941*e7776783SApple OSS Distributions }
942*e7776783SApple OSS Distributions 
943*e7776783SApple OSS Distributions /*
944*e7776783SApple OSS Distributions  * posix_spawn_destroyportactions_np
945*e7776783SApple OSS Distributions  * Description: clean up portactions struct in posix_spawnattr_t attr
946*e7776783SApple OSS Distributions  */
947*e7776783SApple OSS Distributions static int
posix_spawn_destroyportactions_np(posix_spawnattr_t * attr)948*e7776783SApple OSS Distributions posix_spawn_destroyportactions_np(posix_spawnattr_t *attr)
949*e7776783SApple OSS Distributions {
950*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
951*e7776783SApple OSS Distributions 	_posix_spawn_port_actions_t acts;
952*e7776783SApple OSS Distributions 
953*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
954*e7776783SApple OSS Distributions 		return EINVAL;
955*e7776783SApple OSS Distributions 	}
956*e7776783SApple OSS Distributions 
957*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
958*e7776783SApple OSS Distributions 	acts = psattr->psa_ports;
959*e7776783SApple OSS Distributions 	if (acts == NULL) {
960*e7776783SApple OSS Distributions 		return EINVAL;
961*e7776783SApple OSS Distributions 	}
962*e7776783SApple OSS Distributions 
963*e7776783SApple OSS Distributions 	free(acts);
964*e7776783SApple OSS Distributions 	return 0;
965*e7776783SApple OSS Distributions }
966*e7776783SApple OSS Distributions 
967*e7776783SApple OSS Distributions /*
968*e7776783SApple OSS Distributions  * posix_spawn_destroycoalition_info_np
969*e7776783SApple OSS Distributions  * Description: clean up coalition_info struct in posix_spawnattr_t attr
970*e7776783SApple OSS Distributions  */
971*e7776783SApple OSS Distributions static int
posix_spawn_destroycoalition_info_np(posix_spawnattr_t * attr)972*e7776783SApple OSS Distributions posix_spawn_destroycoalition_info_np(posix_spawnattr_t *attr)
973*e7776783SApple OSS Distributions {
974*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
975*e7776783SApple OSS Distributions 	struct _posix_spawn_coalition_info *coal_info;
976*e7776783SApple OSS Distributions 
977*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
978*e7776783SApple OSS Distributions 		return EINVAL;
979*e7776783SApple OSS Distributions 	}
980*e7776783SApple OSS Distributions 
981*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
982*e7776783SApple OSS Distributions 	coal_info = psattr->psa_coalition_info;
983*e7776783SApple OSS Distributions 	if (coal_info == NULL) {
984*e7776783SApple OSS Distributions 		return EINVAL;
985*e7776783SApple OSS Distributions 	}
986*e7776783SApple OSS Distributions 
987*e7776783SApple OSS Distributions 	psattr->psa_coalition_info = NULL;
988*e7776783SApple OSS Distributions 	free(coal_info);
989*e7776783SApple OSS Distributions 	return 0;
990*e7776783SApple OSS Distributions }
991*e7776783SApple OSS Distributions 
992*e7776783SApple OSS Distributions /*
993*e7776783SApple OSS Distributions  * posix_spawn_destroypersona_info_np
994*e7776783SApple OSS Distributions  * Description: clean up persona_info struct in posix_spawnattr_t attr
995*e7776783SApple OSS Distributions  */
996*e7776783SApple OSS Distributions static int
posix_spawn_destroypersona_info_np(posix_spawnattr_t * attr)997*e7776783SApple OSS Distributions posix_spawn_destroypersona_info_np(posix_spawnattr_t *attr)
998*e7776783SApple OSS Distributions {
999*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1000*e7776783SApple OSS Distributions 	struct _posix_spawn_persona_info *persona;
1001*e7776783SApple OSS Distributions 
1002*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1003*e7776783SApple OSS Distributions 		return EINVAL;
1004*e7776783SApple OSS Distributions 	}
1005*e7776783SApple OSS Distributions 
1006*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1007*e7776783SApple OSS Distributions 	persona = psattr->psa_persona_info;
1008*e7776783SApple OSS Distributions 	if (persona == NULL) {
1009*e7776783SApple OSS Distributions 		return EINVAL;
1010*e7776783SApple OSS Distributions 	}
1011*e7776783SApple OSS Distributions 
1012*e7776783SApple OSS Distributions 	psattr->psa_persona_info = NULL;
1013*e7776783SApple OSS Distributions 	free(persona);
1014*e7776783SApple OSS Distributions 	return 0;
1015*e7776783SApple OSS Distributions }
1016*e7776783SApple OSS Distributions 
1017*e7776783SApple OSS Distributions /*
1018*e7776783SApple OSS Distributions  * posix_spawn_destroyposix_cred_info_np
1019*e7776783SApple OSS Distributions  * Description: clean up posix_cred_info struct in posix_spawnattr_t attr
1020*e7776783SApple OSS Distributions  */
1021*e7776783SApple OSS Distributions static int
posix_spawn_destroyposix_cred_info_np(posix_spawnattr_t * attr)1022*e7776783SApple OSS Distributions posix_spawn_destroyposix_cred_info_np(posix_spawnattr_t *attr)
1023*e7776783SApple OSS Distributions {
1024*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1025*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci;
1026*e7776783SApple OSS Distributions 
1027*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1028*e7776783SApple OSS Distributions 		return EINVAL;
1029*e7776783SApple OSS Distributions 	}
1030*e7776783SApple OSS Distributions 
1031*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1032*e7776783SApple OSS Distributions 	pspci = psattr->psa_posix_cred_info;
1033*e7776783SApple OSS Distributions 	if (pspci == NULL) {
1034*e7776783SApple OSS Distributions 		return EINVAL;
1035*e7776783SApple OSS Distributions 	}
1036*e7776783SApple OSS Distributions 
1037*e7776783SApple OSS Distributions 	psattr->psa_posix_cred_info = NULL;
1038*e7776783SApple OSS Distributions 	free(pspci);
1039*e7776783SApple OSS Distributions 	return 0;
1040*e7776783SApple OSS Distributions }
1041*e7776783SApple OSS Distributions 
1042*e7776783SApple OSS Distributions /*
1043*e7776783SApple OSS Distributions  * posix_spawn_set_subsystem_root_path
1044*e7776783SApple OSS Distributions  * Description: Set path as the subsystem root path for attr; clears if NULL
1045*e7776783SApple OSS Distributions  */
1046*e7776783SApple OSS Distributions int
posix_spawnattr_set_subsystem_root_path_np(posix_spawnattr_t * attr,char * path)1047*e7776783SApple OSS Distributions posix_spawnattr_set_subsystem_root_path_np(posix_spawnattr_t *attr, char *path)
1048*e7776783SApple OSS Distributions {
1049*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1050*e7776783SApple OSS Distributions 	char * buf = NULL;
1051*e7776783SApple OSS Distributions 	char * old_buf;
1052*e7776783SApple OSS Distributions 	size_t bytes;
1053*e7776783SApple OSS Distributions 
1054*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1055*e7776783SApple OSS Distributions 		return EINVAL;
1056*e7776783SApple OSS Distributions 	}
1057*e7776783SApple OSS Distributions 
1058*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1059*e7776783SApple OSS Distributions 
1060*e7776783SApple OSS Distributions 	if (path) {
1061*e7776783SApple OSS Distributions 		buf = malloc(MAXPATHLEN);
1062*e7776783SApple OSS Distributions 
1063*e7776783SApple OSS Distributions 		if (buf == NULL) {
1064*e7776783SApple OSS Distributions 			return ENOMEM;
1065*e7776783SApple OSS Distributions 		}
1066*e7776783SApple OSS Distributions 
1067*e7776783SApple OSS Distributions 		bytes = strlcpy(buf, path, MAXPATHLEN);
1068*e7776783SApple OSS Distributions 
1069*e7776783SApple OSS Distributions 		if (bytes >= MAXPATHLEN) {
1070*e7776783SApple OSS Distributions 			free(buf);
1071*e7776783SApple OSS Distributions 			return ENAMETOOLONG;
1072*e7776783SApple OSS Distributions 		}
1073*e7776783SApple OSS Distributions 	}
1074*e7776783SApple OSS Distributions 
1075*e7776783SApple OSS Distributions 	old_buf = psattr->psa_subsystem_root_path;
1076*e7776783SApple OSS Distributions 	psattr->psa_subsystem_root_path = buf;
1077*e7776783SApple OSS Distributions 
1078*e7776783SApple OSS Distributions 	free(old_buf);
1079*e7776783SApple OSS Distributions 
1080*e7776783SApple OSS Distributions 	return 0;
1081*e7776783SApple OSS Distributions }
1082*e7776783SApple OSS Distributions 
1083*e7776783SApple OSS Distributions /*
1084*e7776783SApple OSS Distributions  * posix_spawn_destroy_subsystem_root_path_np
1085*e7776783SApple OSS Distributions  * Description: clean up subsystem_root_path string in posix_spawnattr_t attr
1086*e7776783SApple OSS Distributions  */
1087*e7776783SApple OSS Distributions static int
posix_spawn_destroysubsystem_root_path_np(posix_spawnattr_t * attr)1088*e7776783SApple OSS Distributions posix_spawn_destroysubsystem_root_path_np(posix_spawnattr_t *attr)
1089*e7776783SApple OSS Distributions {
1090*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1091*e7776783SApple OSS Distributions 	char * subsystem_root_path;
1092*e7776783SApple OSS Distributions 
1093*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1094*e7776783SApple OSS Distributions 		return EINVAL;
1095*e7776783SApple OSS Distributions 	}
1096*e7776783SApple OSS Distributions 
1097*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1098*e7776783SApple OSS Distributions 	subsystem_root_path = psattr->psa_subsystem_root_path;
1099*e7776783SApple OSS Distributions 
1100*e7776783SApple OSS Distributions 	if (subsystem_root_path == NULL) {
1101*e7776783SApple OSS Distributions 		return EINVAL;
1102*e7776783SApple OSS Distributions 	}
1103*e7776783SApple OSS Distributions 
1104*e7776783SApple OSS Distributions 	psattr->psa_subsystem_root_path = NULL;
1105*e7776783SApple OSS Distributions 	free(subsystem_root_path);
1106*e7776783SApple OSS Distributions 	return 0;
1107*e7776783SApple OSS Distributions }
1108*e7776783SApple OSS Distributions 
1109*e7776783SApple OSS Distributions /*
1110*e7776783SApple OSS Distributions  * posix_spawnattr_set_platform_np
1111*e7776783SApple OSS Distributions  * Description: sets the platform in posix_spawnattr_t attr
1112*e7776783SApple OSS Distributions  *
1113*e7776783SApple OSS Distributions  * To be implemented.
1114*e7776783SApple OSS Distributions  */
1115*e7776783SApple OSS Distributions int
posix_spawnattr_set_platform_np(posix_spawnattr_t * attr,int platform,uint32_t flags)1116*e7776783SApple OSS Distributions posix_spawnattr_set_platform_np(posix_spawnattr_t *attr, int platform, uint32_t flags)
1117*e7776783SApple OSS Distributions {
1118*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1119*e7776783SApple OSS Distributions 
1120*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1121*e7776783SApple OSS Distributions 		return EINVAL;
1122*e7776783SApple OSS Distributions 	}
1123*e7776783SApple OSS Distributions 
1124*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1125*e7776783SApple OSS Distributions 	psattr->psa_platform = platform;
1126*e7776783SApple OSS Distributions 
1127*e7776783SApple OSS Distributions 	(void)flags;
1128*e7776783SApple OSS Distributions 	return 0;
1129*e7776783SApple OSS Distributions }
1130*e7776783SApple OSS Distributions 
1131*e7776783SApple OSS Distributions /*
1132*e7776783SApple OSS Distributions  * posix_spawnattr_disable_ptr_auth_a_keys_np
1133*e7776783SApple OSS Distributions  * Description: Set flag to disable A keys for Ptr Auth
1134*e7776783SApple OSS Distributions  */
1135*e7776783SApple OSS Distributions int
posix_spawnattr_disable_ptr_auth_a_keys_np(posix_spawnattr_t * attr,uint32_t flags)1136*e7776783SApple OSS Distributions posix_spawnattr_disable_ptr_auth_a_keys_np(posix_spawnattr_t *attr, uint32_t flags)
1137*e7776783SApple OSS Distributions {
1138*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1139*e7776783SApple OSS Distributions 
1140*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1141*e7776783SApple OSS Distributions 		return EINVAL;
1142*e7776783SApple OSS Distributions 	}
1143*e7776783SApple OSS Distributions 
1144*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1145*e7776783SApple OSS Distributions 
1146*e7776783SApple OSS Distributions 	psattr->psa_options |= PSA_OPTION_PLUGIN_HOST_DISABLE_A_KEYS;
1147*e7776783SApple OSS Distributions 	(void)flags;
1148*e7776783SApple OSS Distributions 	return 0;
1149*e7776783SApple OSS Distributions }
1150*e7776783SApple OSS Distributions 
1151*e7776783SApple OSS Distributions /*
1152*e7776783SApple OSS Distributions  * posix_spawnattr_set_alt_rosetta_np
1153*e7776783SApple OSS Distributions  * Description: Set flag to use alternative Rosetta runtime
1154*e7776783SApple OSS Distributions  */
1155*e7776783SApple OSS Distributions int
posix_spawnattr_set_alt_rosetta_np(posix_spawnattr_t * attr,uint32_t flags)1156*e7776783SApple OSS Distributions posix_spawnattr_set_alt_rosetta_np(posix_spawnattr_t *attr, uint32_t flags)
1157*e7776783SApple OSS Distributions {
1158*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1159*e7776783SApple OSS Distributions 
1160*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1161*e7776783SApple OSS Distributions 		return EINVAL;
1162*e7776783SApple OSS Distributions 	}
1163*e7776783SApple OSS Distributions 
1164*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1165*e7776783SApple OSS Distributions 
1166*e7776783SApple OSS Distributions 	psattr->psa_options |= PSA_OPTION_ALT_ROSETTA;
1167*e7776783SApple OSS Distributions 	(void)flags;
1168*e7776783SApple OSS Distributions 	return 0;
1169*e7776783SApple OSS Distributions }
1170*e7776783SApple OSS Distributions 
1171*e7776783SApple OSS Distributions /*
1172*e7776783SApple OSS Distributions  * posix_spawn_appendportaction_np
1173*e7776783SApple OSS Distributions  * Description: append a port action, grow the array if necessary
1174*e7776783SApple OSS Distributions  */
1175*e7776783SApple OSS Distributions static int
posix_spawn_appendportaction_np(posix_spawnattr_t * attr,_ps_port_action_t * act)1176*e7776783SApple OSS Distributions posix_spawn_appendportaction_np(posix_spawnattr_t *attr, _ps_port_action_t *act)
1177*e7776783SApple OSS Distributions {
1178*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1179*e7776783SApple OSS Distributions 	_posix_spawn_port_actions_t acts;
1180*e7776783SApple OSS Distributions 
1181*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || act == NULL) {
1182*e7776783SApple OSS Distributions 		return EINVAL;
1183*e7776783SApple OSS Distributions 	}
1184*e7776783SApple OSS Distributions 
1185*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1186*e7776783SApple OSS Distributions 	acts = psattr->psa_ports;
1187*e7776783SApple OSS Distributions 
1188*e7776783SApple OSS Distributions 	// Have any port actions been created yet?
1189*e7776783SApple OSS Distributions 	if (acts == NULL) {
1190*e7776783SApple OSS Distributions 		int err = posix_spawn_createportactions_np(attr);
1191*e7776783SApple OSS Distributions 		if (err) {
1192*e7776783SApple OSS Distributions 			return err;
1193*e7776783SApple OSS Distributions 		}
1194*e7776783SApple OSS Distributions 		acts = psattr->psa_ports;
1195*e7776783SApple OSS Distributions 	}
1196*e7776783SApple OSS Distributions 
1197*e7776783SApple OSS Distributions 	// Is there enough room?
1198*e7776783SApple OSS Distributions 	if (acts->pspa_alloc == acts->pspa_count) {
1199*e7776783SApple OSS Distributions 		int err = posix_spawn_growportactions_np(attr);
1200*e7776783SApple OSS Distributions 		if (err) {
1201*e7776783SApple OSS Distributions 			return err;
1202*e7776783SApple OSS Distributions 		}
1203*e7776783SApple OSS Distributions 		acts = psattr->psa_ports;
1204*e7776783SApple OSS Distributions 	}
1205*e7776783SApple OSS Distributions 
1206*e7776783SApple OSS Distributions 	// Add this action to next spot in array
1207*e7776783SApple OSS Distributions 	acts->pspa_actions[acts->pspa_count] = *act;
1208*e7776783SApple OSS Distributions 	acts->pspa_count++;
1209*e7776783SApple OSS Distributions 
1210*e7776783SApple OSS Distributions 	return 0;
1211*e7776783SApple OSS Distributions }
1212*e7776783SApple OSS Distributions 
1213*e7776783SApple OSS Distributions /*
1214*e7776783SApple OSS Distributions  * posix_spawnattr_setspecialport_np
1215*e7776783SApple OSS Distributions  *
1216*e7776783SApple OSS Distributions  * Description:	Set a new value for a mach special port in the spawned task.
1217*e7776783SApple OSS Distributions  *
1218*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object for the
1219*e7776783SApple OSS Distributions  *                                      new process
1220*e7776783SApple OSS Distributions  *              new_port		The new value for the special port
1221*e7776783SApple OSS Distributions  *              which			The particular port to be set
1222*e7776783SApple OSS Distributions  *                                      (see task_set_special_port for details)
1223*e7776783SApple OSS Distributions  *
1224*e7776783SApple OSS Distributions  * Returns:	0			Success
1225*e7776783SApple OSS Distributions  *              ENOMEM			Couldn't allocate memory
1226*e7776783SApple OSS Distributions  */
1227*e7776783SApple OSS Distributions int
posix_spawnattr_setspecialport_np(posix_spawnattr_t * attr,mach_port_t new_port,int which)1228*e7776783SApple OSS Distributions posix_spawnattr_setspecialport_np(
1229*e7776783SApple OSS Distributions 	posix_spawnattr_t *attr,
1230*e7776783SApple OSS Distributions 	mach_port_t      new_port,
1231*e7776783SApple OSS Distributions 	int             which)
1232*e7776783SApple OSS Distributions {
1233*e7776783SApple OSS Distributions 	_ps_port_action_t action = {
1234*e7776783SApple OSS Distributions 		.port_type = PSPA_SPECIAL,
1235*e7776783SApple OSS Distributions 		.new_port = new_port,
1236*e7776783SApple OSS Distributions 		.which = which,
1237*e7776783SApple OSS Distributions 	};
1238*e7776783SApple OSS Distributions 	return posix_spawn_appendportaction_np(attr, &action);
1239*e7776783SApple OSS Distributions }
1240*e7776783SApple OSS Distributions 
1241*e7776783SApple OSS Distributions /*
1242*e7776783SApple OSS Distributions  * posix_spawnattr_setexceptionports_np
1243*e7776783SApple OSS Distributions  *
1244*e7776783SApple OSS Distributions  * Description:	Set a new port for a set of exception ports in the spawned task.
1245*e7776783SApple OSS Distributions  *
1246*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object for the
1247*e7776783SApple OSS Distributions  *                                      new process
1248*e7776783SApple OSS Distributions  *              mask			A bitfield indicating which exceptions
1249*e7776783SApple OSS Distributions  *                                      to associate the port with
1250*e7776783SApple OSS Distributions  *              new_port		The new value for the exception port
1251*e7776783SApple OSS Distributions  *              behavior		The default behavior for the port
1252*e7776783SApple OSS Distributions  *              flavor			The default flavor for the port
1253*e7776783SApple OSS Distributions  *                                      (see task_set_exception_ports)
1254*e7776783SApple OSS Distributions  *
1255*e7776783SApple OSS Distributions  * Returns:	0			Success
1256*e7776783SApple OSS Distributions  */
1257*e7776783SApple OSS Distributions int
posix_spawnattr_setexceptionports_np(posix_spawnattr_t * attr,exception_mask_t mask,mach_port_t new_port,exception_behavior_t behavior,thread_state_flavor_t flavor)1258*e7776783SApple OSS Distributions posix_spawnattr_setexceptionports_np(
1259*e7776783SApple OSS Distributions 	posix_spawnattr_t       *attr,
1260*e7776783SApple OSS Distributions 	exception_mask_t        mask,
1261*e7776783SApple OSS Distributions 	mach_port_t              new_port,
1262*e7776783SApple OSS Distributions 	exception_behavior_t    behavior,
1263*e7776783SApple OSS Distributions 	thread_state_flavor_t   flavor)
1264*e7776783SApple OSS Distributions {
1265*e7776783SApple OSS Distributions 	_ps_port_action_t action = {
1266*e7776783SApple OSS Distributions 		.port_type = PSPA_EXCEPTION,
1267*e7776783SApple OSS Distributions 		.mask = mask,
1268*e7776783SApple OSS Distributions 		.new_port = new_port,
1269*e7776783SApple OSS Distributions 		.behavior = behavior,
1270*e7776783SApple OSS Distributions 		.flavor = flavor,
1271*e7776783SApple OSS Distributions 	};
1272*e7776783SApple OSS Distributions 	return posix_spawn_appendportaction_np(attr, &action);
1273*e7776783SApple OSS Distributions }
1274*e7776783SApple OSS Distributions 
1275*e7776783SApple OSS Distributions /*
1276*e7776783SApple OSS Distributions  * posix_spawnattr_setauditsessionport_np
1277*e7776783SApple OSS Distributions  *
1278*e7776783SApple OSS Distributions  * Description:	Set the audit session port rights attribute in the spawned task.
1279*e7776783SApple OSS Distributions  *		This is used to securely set the audit session information for
1280*e7776783SApple OSS Distributions  *		the new task.
1281*e7776783SApple OSS Distributions  *
1282*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn attributes object for the
1283*e7776783SApple OSS Distributions  *                                      new process
1284*e7776783SApple OSS Distributions  *              au_sessionport		The audit session send port right
1285*e7776783SApple OSS Distributions  *
1286*e7776783SApple OSS Distributions  * Returns:	0			Success
1287*e7776783SApple OSS Distributions  */
1288*e7776783SApple OSS Distributions int
posix_spawnattr_setauditsessionport_np(posix_spawnattr_t * attr,mach_port_t au_sessionport)1289*e7776783SApple OSS Distributions posix_spawnattr_setauditsessionport_np(
1290*e7776783SApple OSS Distributions 	posix_spawnattr_t       *attr,
1291*e7776783SApple OSS Distributions 	mach_port_t              au_sessionport)
1292*e7776783SApple OSS Distributions {
1293*e7776783SApple OSS Distributions 	_ps_port_action_t action = {
1294*e7776783SApple OSS Distributions 		.port_type = PSPA_AU_SESSION,
1295*e7776783SApple OSS Distributions 		.new_port = au_sessionport,
1296*e7776783SApple OSS Distributions 	};
1297*e7776783SApple OSS Distributions 	return posix_spawn_appendportaction_np(attr, &action);
1298*e7776783SApple OSS Distributions }
1299*e7776783SApple OSS Distributions 
1300*e7776783SApple OSS Distributions 
1301*e7776783SApple OSS Distributions /*
1302*e7776783SApple OSS Distributions  * posix_spawn_file_actions_init
1303*e7776783SApple OSS Distributions  *
1304*e7776783SApple OSS Distributions  * Description:	Initialize a spawn file actions object attr with default values
1305*e7776783SApple OSS Distributions  *
1306*e7776783SApple OSS Distributions  * Parameters:	file_actions		The spawn file actions object to be
1307*e7776783SApple OSS Distributions  *					initialized
1308*e7776783SApple OSS Distributions  *
1309*e7776783SApple OSS Distributions  * Returns:	0			Success
1310*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to
1311*e7776783SApple OSS Distributions  *					initialize the spawn file actions
1312*e7776783SApple OSS Distributions  *					object.
1313*e7776783SApple OSS Distributions  *
1314*e7776783SApple OSS Distributions  * Note:	As an implementation detail, the externally visibily type
1315*e7776783SApple OSS Distributions  *		posix_spawn_file_actions_t is defined to be a void *, and
1316*e7776783SApple OSS Distributions  *		initialization involves allocation of a memory object.
1317*e7776783SApple OSS Distributions  *		Subsequent changes to the spawn file actions may result in
1318*e7776783SApple OSS Distributions  *		reallocation under the covers.
1319*e7776783SApple OSS Distributions  *
1320*e7776783SApple OSS Distributions  *		Reinitialization of an already initialized spawn file actions
1321*e7776783SApple OSS Distributions  *		object will result in memory being leaked.  Because spawn
1322*e7776783SApple OSS Distributions  *		file actions are not required to be used in conjunction with a
1323*e7776783SApple OSS Distributions  *		static initializer, there is no way to distinguish a spawn
1324*e7776783SApple OSS Distributions  *		file actions with stack garbage from one that's been
1325*e7776783SApple OSS Distributions  *		initialized.  This is arguably an API design error.
1326*e7776783SApple OSS Distributions  */
1327*e7776783SApple OSS Distributions int
posix_spawn_file_actions_init(posix_spawn_file_actions_t * file_actions)1328*e7776783SApple OSS Distributions posix_spawn_file_actions_init(posix_spawn_file_actions_t *file_actions)
1329*e7776783SApple OSS Distributions {
1330*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp = (_posix_spawn_file_actions_t *)file_actions;
1331*e7776783SApple OSS Distributions 	int     err = 0;
1332*e7776783SApple OSS Distributions 
1333*e7776783SApple OSS Distributions 	if ((*psactsp = (_posix_spawn_file_actions_t)malloc(PSF_ACTIONS_SIZE(PSF_ACTIONS_INIT_COUNT))) == NULL) {
1334*e7776783SApple OSS Distributions 		err = ENOMEM;
1335*e7776783SApple OSS Distributions 	} else {
1336*e7776783SApple OSS Distributions 		(*psactsp)->psfa_act_alloc = PSF_ACTIONS_INIT_COUNT;
1337*e7776783SApple OSS Distributions 		(*psactsp)->psfa_act_count = 0;
1338*e7776783SApple OSS Distributions 	}
1339*e7776783SApple OSS Distributions 
1340*e7776783SApple OSS Distributions 	return err;
1341*e7776783SApple OSS Distributions }
1342*e7776783SApple OSS Distributions 
1343*e7776783SApple OSS Distributions 
1344*e7776783SApple OSS Distributions /*
1345*e7776783SApple OSS Distributions  * posix_spawn_file_actions_destroy
1346*e7776783SApple OSS Distributions  *
1347*e7776783SApple OSS Distributions  * Description:	Destroy a spawn file actions object that was previously
1348*e7776783SApple OSS Distributions  *		initialized via posix_spawn_file_actions_init() by freeing any
1349*e7776783SApple OSS Distributions  *		memory associated with it and setting it to an invalid value.
1350*e7776783SApple OSS Distributions  *
1351*e7776783SApple OSS Distributions  * Parameters:	attr			The spawn file actions object to be
1352*e7776783SApple OSS Distributions  *					destroyed.
1353*e7776783SApple OSS Distributions  *
1354*e7776783SApple OSS Distributions  * Returns:	0			Success
1355*e7776783SApple OSS Distributions  *
1356*e7776783SApple OSS Distributions  * Notes:	The destroyed spawn file actions results in the void * pointer
1357*e7776783SApple OSS Distributions  *		being set to NULL; subsequent use without reinitialization
1358*e7776783SApple OSS Distributions  *		will result in explicit program failure (rather than merely
1359*e7776783SApple OSS Distributions  *		"undefined behaviour").
1360*e7776783SApple OSS Distributions  *
1361*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1362*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1363*e7776783SApple OSS Distributions  */
1364*e7776783SApple OSS Distributions int
posix_spawn_file_actions_destroy(posix_spawn_file_actions_t * file_actions)1365*e7776783SApple OSS Distributions posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *file_actions)
1366*e7776783SApple OSS Distributions {
1367*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t psacts;
1368*e7776783SApple OSS Distributions 
1369*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1370*e7776783SApple OSS Distributions 		return EINVAL;
1371*e7776783SApple OSS Distributions 	}
1372*e7776783SApple OSS Distributions 
1373*e7776783SApple OSS Distributions 	psacts = *(_posix_spawn_file_actions_t *)file_actions;
1374*e7776783SApple OSS Distributions 	free(psacts);
1375*e7776783SApple OSS Distributions 	*file_actions = NULL;
1376*e7776783SApple OSS Distributions 
1377*e7776783SApple OSS Distributions 	return 0;
1378*e7776783SApple OSS Distributions }
1379*e7776783SApple OSS Distributions 
1380*e7776783SApple OSS Distributions 
1381*e7776783SApple OSS Distributions /*
1382*e7776783SApple OSS Distributions  * _posix_spawn_file_actions_grow
1383*e7776783SApple OSS Distributions  *
1384*e7776783SApple OSS Distributions  * Description:	Grow the available list of file actions associated with the
1385*e7776783SApple OSS Distributions  *		pointer to the structure provided; replace the contents of the
1386*e7776783SApple OSS Distributions  *		pointer as a side effect.
1387*e7776783SApple OSS Distributions  *
1388*e7776783SApple OSS Distributions  * Parameters:	psactsp			Pointer to _posix_spawn_file_actions_t
1389*e7776783SApple OSS Distributions  *					to grow
1390*e7776783SApple OSS Distributions  *
1391*e7776783SApple OSS Distributions  * Returns:	0			Success
1392*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory for operation
1393*e7776783SApple OSS Distributions  *
1394*e7776783SApple OSS Distributions  * Notes:	This code is common to all posix_spawn_file_actions_*()
1395*e7776783SApple OSS Distributions  *		functions, since we use a naieve data structure implementation
1396*e7776783SApple OSS Distributions  *		at present.  Future optimization will likely change this.
1397*e7776783SApple OSS Distributions  */
1398*e7776783SApple OSS Distributions static int
_posix_spawn_file_actions_grow(_posix_spawn_file_actions_t * psactsp)1399*e7776783SApple OSS Distributions _posix_spawn_file_actions_grow(_posix_spawn_file_actions_t *psactsp)
1400*e7776783SApple OSS Distributions {
1401*e7776783SApple OSS Distributions 	int newnum = 0;
1402*e7776783SApple OSS Distributions 	if (os_mul_overflow((*psactsp)->psfa_act_alloc, 2, &newnum)) {
1403*e7776783SApple OSS Distributions 		return ENOMEM;
1404*e7776783SApple OSS Distributions 	}
1405*e7776783SApple OSS Distributions 
1406*e7776783SApple OSS Distributions 	size_t newsize = PSF_ACTIONS_SIZE(newnum);
1407*e7776783SApple OSS Distributions 	if (newsize == 0) {
1408*e7776783SApple OSS Distributions 		return ENOMEM;
1409*e7776783SApple OSS Distributions 	}
1410*e7776783SApple OSS Distributions 
1411*e7776783SApple OSS Distributions 	/*
1412*e7776783SApple OSS Distributions 	 * XXX may want to impose an administrative limit here; POSIX does
1413*e7776783SApple OSS Distributions 	 * XXX not provide for an administrative error return in this case,
1414*e7776783SApple OSS Distributions 	 * XXX so it's probably acceptable to just fail catastrophically
1415*e7776783SApple OSS Distributions 	 * XXX instead of implementing one.
1416*e7776783SApple OSS Distributions 	 */
1417*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t new_psacts;
1418*e7776783SApple OSS Distributions 	if ((new_psacts = (_posix_spawn_file_actions_t)realloc((*psactsp), newsize)) == NULL) {
1419*e7776783SApple OSS Distributions 		return ENOMEM;
1420*e7776783SApple OSS Distributions 	}
1421*e7776783SApple OSS Distributions 	new_psacts->psfa_act_alloc = newnum;
1422*e7776783SApple OSS Distributions 	*psactsp = new_psacts;
1423*e7776783SApple OSS Distributions 
1424*e7776783SApple OSS Distributions 	return 0;
1425*e7776783SApple OSS Distributions }
1426*e7776783SApple OSS Distributions 
1427*e7776783SApple OSS Distributions 
1428*e7776783SApple OSS Distributions /*
1429*e7776783SApple OSS Distributions  * posix_spawn_file_actions_addopen
1430*e7776783SApple OSS Distributions  *
1431*e7776783SApple OSS Distributions  * Description:	Add an open action to the object referenced by 'file_actions'
1432*e7776783SApple OSS Distributions  *		that will cause the file named by 'path' to be attempted to be
1433*e7776783SApple OSS Distributions  *		opened with flags 'oflag' and mode 'mode', and, if successful,
1434*e7776783SApple OSS Distributions  *		return as descriptor 'filedes' to the spawned process.
1435*e7776783SApple OSS Distributions  *
1436*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1437*e7776783SApple OSS Distributions  *		filedes			fd that open is to use
1438*e7776783SApple OSS Distributions  *		path			path to file to open
1439*e7776783SApple OSS Distributions  *		oflag			open file flags
1440*e7776783SApple OSS Distributions  *		mode			open file mode
1441*e7776783SApple OSS Distributions  *
1442*e7776783SApple OSS Distributions  * Returns:	0			Success
1443*e7776783SApple OSS Distributions  *		EBADF			The value specified by fildes is
1444*e7776783SApple OSS Distributions  *					negative or greater than or equal to
1445*e7776783SApple OSS Distributions  *					{OPEN_MAX}.
1446*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1447*e7776783SApple OSS Distributions  *					the spawn file actions object.
1448*e7776783SApple OSS Distributions  *
1449*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1450*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1451*e7776783SApple OSS Distributions  */
1452*e7776783SApple OSS Distributions int
posix_spawn_file_actions_addopen(posix_spawn_file_actions_t * __restrict file_actions,int filedes,const char * __restrict path,int oflag,mode_t mode)1453*e7776783SApple OSS Distributions posix_spawn_file_actions_addopen(
1454*e7776783SApple OSS Distributions 	posix_spawn_file_actions_t * __restrict file_actions,
1455*e7776783SApple OSS Distributions 	int filedes, const char * __restrict path, int oflag,
1456*e7776783SApple OSS Distributions 	mode_t mode)
1457*e7776783SApple OSS Distributions {
1458*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1459*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1460*e7776783SApple OSS Distributions 
1461*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1462*e7776783SApple OSS Distributions 		return EINVAL;
1463*e7776783SApple OSS Distributions 	}
1464*e7776783SApple OSS Distributions 
1465*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1466*e7776783SApple OSS Distributions 	/* Range check; required by POSIX */
1467*e7776783SApple OSS Distributions 	if (filedes < 0 || filedes >= OPEN_MAX) {
1468*e7776783SApple OSS Distributions 		return EBADF;
1469*e7776783SApple OSS Distributions 	}
1470*e7776783SApple OSS Distributions 
1471*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1472*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1473*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1474*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1475*e7776783SApple OSS Distributions 			return ENOMEM;
1476*e7776783SApple OSS Distributions 		}
1477*e7776783SApple OSS Distributions 	}
1478*e7776783SApple OSS Distributions 
1479*e7776783SApple OSS Distributions 	/*
1480*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1481*e7776783SApple OSS Distributions 	 */
1482*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1483*e7776783SApple OSS Distributions 
1484*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_OPEN;
1485*e7776783SApple OSS Distributions 	psfileact->psfaa_filedes = filedes;
1486*e7776783SApple OSS Distributions 	psfileact->psfaa_openargs.psfao_oflag = oflag;
1487*e7776783SApple OSS Distributions 	psfileact->psfaa_openargs.psfao_mode = mode;
1488*e7776783SApple OSS Distributions 	strlcpy(psfileact->psfaa_openargs.psfao_path, path, PATH_MAX);
1489*e7776783SApple OSS Distributions 
1490*e7776783SApple OSS Distributions 	return 0;
1491*e7776783SApple OSS Distributions }
1492*e7776783SApple OSS Distributions 
1493*e7776783SApple OSS Distributions 
1494*e7776783SApple OSS Distributions /*
1495*e7776783SApple OSS Distributions  * posix_spawn_file_actions_addclose
1496*e7776783SApple OSS Distributions  *
1497*e7776783SApple OSS Distributions  * Description:	Add a close action to the object referenced by 'file_actions'
1498*e7776783SApple OSS Distributions  *		that will cause the file referenced by 'filedes' to be
1499*e7776783SApple OSS Distributions  *		attempted to be closed in the spawned process.
1500*e7776783SApple OSS Distributions  *
1501*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1502*e7776783SApple OSS Distributions  *		filedes			fd to close
1503*e7776783SApple OSS Distributions  *
1504*e7776783SApple OSS Distributions  * Returns:	0			Success
1505*e7776783SApple OSS Distributions  *		EBADF			The value specified by fildes is
1506*e7776783SApple OSS Distributions  *					negative or greater than or equal to
1507*e7776783SApple OSS Distributions  *					{OPEN_MAX}.
1508*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1509*e7776783SApple OSS Distributions  *					the spawn file actions object.
1510*e7776783SApple OSS Distributions  *
1511*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1512*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1513*e7776783SApple OSS Distributions  */
1514*e7776783SApple OSS Distributions int
posix_spawn_file_actions_addclose(posix_spawn_file_actions_t * file_actions,int filedes)1515*e7776783SApple OSS Distributions posix_spawn_file_actions_addclose(posix_spawn_file_actions_t *file_actions,
1516*e7776783SApple OSS Distributions     int filedes)
1517*e7776783SApple OSS Distributions {
1518*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1519*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1520*e7776783SApple OSS Distributions 
1521*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1522*e7776783SApple OSS Distributions 		return EINVAL;
1523*e7776783SApple OSS Distributions 	}
1524*e7776783SApple OSS Distributions 
1525*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1526*e7776783SApple OSS Distributions 	/* Range check; required by POSIX */
1527*e7776783SApple OSS Distributions 	if (filedes < 0 || filedes >= OPEN_MAX) {
1528*e7776783SApple OSS Distributions 		return EBADF;
1529*e7776783SApple OSS Distributions 	}
1530*e7776783SApple OSS Distributions 
1531*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1532*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1533*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1534*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1535*e7776783SApple OSS Distributions 			return ENOMEM;
1536*e7776783SApple OSS Distributions 		}
1537*e7776783SApple OSS Distributions 	}
1538*e7776783SApple OSS Distributions 
1539*e7776783SApple OSS Distributions 	/*
1540*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1541*e7776783SApple OSS Distributions 	 */
1542*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1543*e7776783SApple OSS Distributions 
1544*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_CLOSE;
1545*e7776783SApple OSS Distributions 	psfileact->psfaa_filedes = filedes;
1546*e7776783SApple OSS Distributions 
1547*e7776783SApple OSS Distributions 	return 0;
1548*e7776783SApple OSS Distributions }
1549*e7776783SApple OSS Distributions 
1550*e7776783SApple OSS Distributions 
1551*e7776783SApple OSS Distributions /*
1552*e7776783SApple OSS Distributions  * posix_spawn_file_actions_adddup2
1553*e7776783SApple OSS Distributions  *
1554*e7776783SApple OSS Distributions  * Description:	Add a dup2 action to the object referenced by 'file_actions'
1555*e7776783SApple OSS Distributions  *		that will cause the file referenced by 'filedes' to be
1556*e7776783SApple OSS Distributions  *		attempted to be dup2'ed to the descriptor 'newfiledes' in the
1557*e7776783SApple OSS Distributions  *		spawned process.
1558*e7776783SApple OSS Distributions  *
1559*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1560*e7776783SApple OSS Distributions  *		filedes			fd to dup2
1561*e7776783SApple OSS Distributions  *		newfiledes		fd to dup2 it to
1562*e7776783SApple OSS Distributions  *
1563*e7776783SApple OSS Distributions  * Returns:	0			Success
1564*e7776783SApple OSS Distributions  *		EBADF			The value specified by either fildes
1565*e7776783SApple OSS Distributions  *					or by newfiledes is negative or greater
1566*e7776783SApple OSS Distributions  *					than or equal to {OPEN_MAX}.
1567*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1568*e7776783SApple OSS Distributions  *					the spawn file actions object.
1569*e7776783SApple OSS Distributions  *
1570*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1571*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1572*e7776783SApple OSS Distributions  */
1573*e7776783SApple OSS Distributions int
posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t * file_actions,int filedes,int newfiledes)1574*e7776783SApple OSS Distributions posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *file_actions,
1575*e7776783SApple OSS Distributions     int filedes, int newfiledes)
1576*e7776783SApple OSS Distributions {
1577*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1578*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1579*e7776783SApple OSS Distributions 
1580*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1581*e7776783SApple OSS Distributions 		return EINVAL;
1582*e7776783SApple OSS Distributions 	}
1583*e7776783SApple OSS Distributions 
1584*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1585*e7776783SApple OSS Distributions 	/* Range check; required by POSIX */
1586*e7776783SApple OSS Distributions 	if (filedes < 0 || filedes >= OPEN_MAX ||
1587*e7776783SApple OSS Distributions 	    newfiledes < 0 || newfiledes >= OPEN_MAX) {
1588*e7776783SApple OSS Distributions 		return EBADF;
1589*e7776783SApple OSS Distributions 	}
1590*e7776783SApple OSS Distributions 
1591*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1592*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1593*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1594*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1595*e7776783SApple OSS Distributions 			return ENOMEM;
1596*e7776783SApple OSS Distributions 		}
1597*e7776783SApple OSS Distributions 	}
1598*e7776783SApple OSS Distributions 
1599*e7776783SApple OSS Distributions 	/*
1600*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1601*e7776783SApple OSS Distributions 	 */
1602*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1603*e7776783SApple OSS Distributions 
1604*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_DUP2;
1605*e7776783SApple OSS Distributions 	psfileact->psfaa_filedes = filedes;
1606*e7776783SApple OSS Distributions 	psfileact->psfaa_dup2args.psfad_newfiledes = newfiledes;
1607*e7776783SApple OSS Distributions 
1608*e7776783SApple OSS Distributions 	return 0;
1609*e7776783SApple OSS Distributions }
1610*e7776783SApple OSS Distributions 
1611*e7776783SApple OSS Distributions /*
1612*e7776783SApple OSS Distributions  * posix_spawn_file_actions_add_fileportdup2_np
1613*e7776783SApple OSS Distributions  *
1614*e7776783SApple OSS Distributions  * Description:	Add a dup2 action to the object referenced by 'file_actions'
1615*e7776783SApple OSS Distributions  *		that will cause the file referenced by 'fileport' to be
1616*e7776783SApple OSS Distributions  *		attempted to be dup2'ed to the descriptor 'newfiledes' in the
1617*e7776783SApple OSS Distributions  *		spawned process.
1618*e7776783SApple OSS Distributions  *
1619*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1620*e7776783SApple OSS Distributions  *		filedes			fileport to dup2
1621*e7776783SApple OSS Distributions  *		newfiledes		fd to dup2 it to
1622*e7776783SApple OSS Distributions  *
1623*e7776783SApple OSS Distributions  * Returns:	0			Success
1624*e7776783SApple OSS Distributions  *		EBADF			fileport isn't a valid port, or the
1625*e7776783SApple OSS Distributions  *					value specified by newfiledes is
1626*e7776783SApple OSS Distributions  *					negative or greater than or equal to
1627*e7776783SApple OSS Distributions  *					{OPEN_MAX}.
1628*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1629*e7776783SApple OSS Distributions  *					the spawn file actions object.
1630*e7776783SApple OSS Distributions  *
1631*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1632*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1633*e7776783SApple OSS Distributions  */
1634*e7776783SApple OSS Distributions int
posix_spawn_file_actions_add_fileportdup2_np(posix_spawn_file_actions_t * file_actions,mach_port_t fileport,int newfiledes)1635*e7776783SApple OSS Distributions posix_spawn_file_actions_add_fileportdup2_np(
1636*e7776783SApple OSS Distributions 	posix_spawn_file_actions_t *file_actions,
1637*e7776783SApple OSS Distributions 	mach_port_t fileport, int newfiledes)
1638*e7776783SApple OSS Distributions {
1639*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1640*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1641*e7776783SApple OSS Distributions 
1642*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1643*e7776783SApple OSS Distributions 		return EINVAL;
1644*e7776783SApple OSS Distributions 	}
1645*e7776783SApple OSS Distributions 
1646*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1647*e7776783SApple OSS Distributions 	/* Range check; required by POSIX */
1648*e7776783SApple OSS Distributions 	if (!MACH_PORT_VALID(fileport) ||
1649*e7776783SApple OSS Distributions 	    newfiledes < 0 || newfiledes >= OPEN_MAX) {
1650*e7776783SApple OSS Distributions 		return EBADF;
1651*e7776783SApple OSS Distributions 	}
1652*e7776783SApple OSS Distributions 
1653*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1654*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1655*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1656*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1657*e7776783SApple OSS Distributions 			return ENOMEM;
1658*e7776783SApple OSS Distributions 		}
1659*e7776783SApple OSS Distributions 	}
1660*e7776783SApple OSS Distributions 
1661*e7776783SApple OSS Distributions 	/*
1662*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1663*e7776783SApple OSS Distributions 	 */
1664*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1665*e7776783SApple OSS Distributions 
1666*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_FILEPORT_DUP2;
1667*e7776783SApple OSS Distributions 	psfileact->psfaa_fileport = fileport;
1668*e7776783SApple OSS Distributions 	psfileact->psfaa_dup2args.psfad_newfiledes = newfiledes;
1669*e7776783SApple OSS Distributions 
1670*e7776783SApple OSS Distributions 	return 0;
1671*e7776783SApple OSS Distributions }
1672*e7776783SApple OSS Distributions 
1673*e7776783SApple OSS Distributions /*
1674*e7776783SApple OSS Distributions  * posix_spawn_file_actions_addinherit_np
1675*e7776783SApple OSS Distributions  *
1676*e7776783SApple OSS Distributions  * Description:	Add the "inherit" action to the object referenced by
1677*e7776783SApple OSS Distributions  *		'file_actions' that will cause the file referenced by
1678*e7776783SApple OSS Distributions  *		'filedes' to continue to be available in the spawned
1679*e7776783SApple OSS Distributions  *		process via the same descriptor.
1680*e7776783SApple OSS Distributions  *
1681*e7776783SApple OSS Distributions  *		Inheritance is the normal default behaviour for
1682*e7776783SApple OSS Distributions  *		file descriptors across exec and spawn; but if the
1683*e7776783SApple OSS Distributions  *		POSIX_SPAWN_CLOEXEC_DEFAULT flag is set, the usual
1684*e7776783SApple OSS Distributions  *		default is reversed for the purposes of the spawn
1685*e7776783SApple OSS Distributions  *		invocation.  Any pre-existing descriptors that
1686*e7776783SApple OSS Distributions  *		need to be made available to the spawned process can
1687*e7776783SApple OSS Distributions  *		be marked explicitly as 'inherit' via this interface.
1688*e7776783SApple OSS Distributions  *		Otherwise they will be automatically closed.
1689*e7776783SApple OSS Distributions  *
1690*e7776783SApple OSS Distributions  *		Note that any descriptors created via the other file
1691*e7776783SApple OSS Distributions  *		actions interfaces are automatically marked as 'inherit'.
1692*e7776783SApple OSS Distributions  *
1693*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1694*e7776783SApple OSS Distributions  *		filedes			fd to inherit.
1695*e7776783SApple OSS Distributions  *
1696*e7776783SApple OSS Distributions  * Returns:	0			Success
1697*e7776783SApple OSS Distributions  *		EBADF			The value specified by fildes is
1698*e7776783SApple OSS Distributions  *					negative or greater than or equal to
1699*e7776783SApple OSS Distributions  *					{OPEN_MAX}.
1700*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1701*e7776783SApple OSS Distributions  *					the spawn file actions object.
1702*e7776783SApple OSS Distributions  *
1703*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1704*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1705*e7776783SApple OSS Distributions  */
1706*e7776783SApple OSS Distributions int
posix_spawn_file_actions_addinherit_np(posix_spawn_file_actions_t * file_actions,int filedes)1707*e7776783SApple OSS Distributions posix_spawn_file_actions_addinherit_np(posix_spawn_file_actions_t *file_actions,
1708*e7776783SApple OSS Distributions     int filedes)
1709*e7776783SApple OSS Distributions {
1710*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1711*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1712*e7776783SApple OSS Distributions 
1713*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1714*e7776783SApple OSS Distributions 		return EINVAL;
1715*e7776783SApple OSS Distributions 	}
1716*e7776783SApple OSS Distributions 
1717*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1718*e7776783SApple OSS Distributions 	/* Range check; required by POSIX */
1719*e7776783SApple OSS Distributions 	if (filedes < 0 || filedes >= OPEN_MAX) {
1720*e7776783SApple OSS Distributions 		return EBADF;
1721*e7776783SApple OSS Distributions 	}
1722*e7776783SApple OSS Distributions 
1723*e7776783SApple OSS Distributions #if defined(POSIX_SPAWN_CLOEXEC_DEFAULT)        // TODO: delete this check
1724*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1725*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1726*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1727*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1728*e7776783SApple OSS Distributions 			return ENOMEM;
1729*e7776783SApple OSS Distributions 		}
1730*e7776783SApple OSS Distributions 	}
1731*e7776783SApple OSS Distributions 
1732*e7776783SApple OSS Distributions 	/*
1733*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1734*e7776783SApple OSS Distributions 	 */
1735*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1736*e7776783SApple OSS Distributions 
1737*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_INHERIT;
1738*e7776783SApple OSS Distributions 	psfileact->psfaa_filedes = filedes;
1739*e7776783SApple OSS Distributions #endif
1740*e7776783SApple OSS Distributions 	return 0;
1741*e7776783SApple OSS Distributions }
1742*e7776783SApple OSS Distributions 
1743*e7776783SApple OSS Distributions 
1744*e7776783SApple OSS Distributions /*
1745*e7776783SApple OSS Distributions  * posix_spawn_file_actions_addchdir_np
1746*e7776783SApple OSS Distributions  *
1747*e7776783SApple OSS Distributions  * Description:	Add a chdir action to the object referenced by 'file_actions'
1748*e7776783SApple OSS Distributions  *		that will cause the current working directory to attempt to be changed
1749*e7776783SApple OSS Distributions  *      to that referenced by 'path' in the spawned process.
1750*e7776783SApple OSS Distributions  *
1751*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1752*e7776783SApple OSS Distributions  *		path			path of the desired working directory
1753*e7776783SApple OSS Distributions  *
1754*e7776783SApple OSS Distributions  * Returns:	0			Success
1755*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1756*e7776783SApple OSS Distributions  *					the spawn file actions object.
1757*e7776783SApple OSS Distributions  *		ENAMETOOLONG	The supplied path exceeded PATH_MAX.
1758*e7776783SApple OSS Distributions  *
1759*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1760*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1761*e7776783SApple OSS Distributions  */
1762*e7776783SApple OSS Distributions int
posix_spawn_file_actions_addchdir_np(posix_spawn_file_actions_t * __restrict file_actions,const char * __restrict path)1763*e7776783SApple OSS Distributions posix_spawn_file_actions_addchdir_np(
1764*e7776783SApple OSS Distributions 	posix_spawn_file_actions_t * __restrict file_actions,
1765*e7776783SApple OSS Distributions 	const char * __restrict path)
1766*e7776783SApple OSS Distributions {
1767*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1768*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1769*e7776783SApple OSS Distributions 
1770*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1771*e7776783SApple OSS Distributions 		return EINVAL;
1772*e7776783SApple OSS Distributions 	}
1773*e7776783SApple OSS Distributions 
1774*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1775*e7776783SApple OSS Distributions 
1776*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1777*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1778*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1779*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1780*e7776783SApple OSS Distributions 			return ENOMEM;
1781*e7776783SApple OSS Distributions 		}
1782*e7776783SApple OSS Distributions 	}
1783*e7776783SApple OSS Distributions 
1784*e7776783SApple OSS Distributions 	/*
1785*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1786*e7776783SApple OSS Distributions 	 */
1787*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1788*e7776783SApple OSS Distributions 
1789*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_CHDIR;
1790*e7776783SApple OSS Distributions 	if (strlcpy(psfileact->psfaa_chdirargs.psfac_path, path, PATH_MAX) >= PATH_MAX) {
1791*e7776783SApple OSS Distributions 		(*psactsp)->psfa_act_count--;
1792*e7776783SApple OSS Distributions 		return ENAMETOOLONG;
1793*e7776783SApple OSS Distributions 	}
1794*e7776783SApple OSS Distributions 
1795*e7776783SApple OSS Distributions 	return 0;
1796*e7776783SApple OSS Distributions }
1797*e7776783SApple OSS Distributions 
1798*e7776783SApple OSS Distributions 
1799*e7776783SApple OSS Distributions /*
1800*e7776783SApple OSS Distributions  * posix_spawn_file_actions_fchdir_np
1801*e7776783SApple OSS Distributions  *
1802*e7776783SApple OSS Distributions  * Description:	Add a fchdir action to the object referenced by 'file_actions'
1803*e7776783SApple OSS Distributions  *		that will cause the current working directory to attempt to be changed
1804*e7776783SApple OSS Distributions  *      to that referenced by the descriptor 'filedes' in the spawned process.
1805*e7776783SApple OSS Distributions  *
1806*e7776783SApple OSS Distributions  * Parameters:	file_actions		File action object to augment
1807*e7776783SApple OSS Distributions  *		filedes			fd to chdir to
1808*e7776783SApple OSS Distributions  *
1809*e7776783SApple OSS Distributions  * Returns:	0			Success
1810*e7776783SApple OSS Distributions  *		EBADF			The value specified by either fildes is negative or
1811*e7776783SApple OSS Distributions  *                              greater than or equal to {OPEN_MAX}.
1812*e7776783SApple OSS Distributions  *		ENOMEM			Insufficient memory exists to add to
1813*e7776783SApple OSS Distributions  *					the spawn file actions object.
1814*e7776783SApple OSS Distributions  *
1815*e7776783SApple OSS Distributions  * NOTIMP:	Allowed failures (checking NOT required):
1816*e7776783SApple OSS Distributions  *		EINVAL	The value specified by file_actions is invalid.
1817*e7776783SApple OSS Distributions  */
1818*e7776783SApple OSS Distributions int
posix_spawn_file_actions_addfchdir_np(posix_spawn_file_actions_t * file_actions,int filedes)1819*e7776783SApple OSS Distributions posix_spawn_file_actions_addfchdir_np(posix_spawn_file_actions_t *file_actions,
1820*e7776783SApple OSS Distributions     int filedes)
1821*e7776783SApple OSS Distributions {
1822*e7776783SApple OSS Distributions 	_posix_spawn_file_actions_t *psactsp;
1823*e7776783SApple OSS Distributions 	_psfa_action_t *psfileact;
1824*e7776783SApple OSS Distributions 
1825*e7776783SApple OSS Distributions 	if (file_actions == NULL || *file_actions == NULL) {
1826*e7776783SApple OSS Distributions 		return EINVAL;
1827*e7776783SApple OSS Distributions 	}
1828*e7776783SApple OSS Distributions 
1829*e7776783SApple OSS Distributions 	psactsp = (_posix_spawn_file_actions_t *)file_actions;
1830*e7776783SApple OSS Distributions 	/* Range check; in spirit of POSIX */
1831*e7776783SApple OSS Distributions 	if (filedes < 0 || filedes >= OPEN_MAX) {
1832*e7776783SApple OSS Distributions 		return EBADF;
1833*e7776783SApple OSS Distributions 	}
1834*e7776783SApple OSS Distributions 
1835*e7776783SApple OSS Distributions 	/* If we do not have enough slots, grow the structure */
1836*e7776783SApple OSS Distributions 	if ((*psactsp)->psfa_act_count == (*psactsp)->psfa_act_alloc) {
1837*e7776783SApple OSS Distributions 		/* need to grow file actions structure */
1838*e7776783SApple OSS Distributions 		if (_posix_spawn_file_actions_grow(psactsp)) {
1839*e7776783SApple OSS Distributions 			return ENOMEM;
1840*e7776783SApple OSS Distributions 		}
1841*e7776783SApple OSS Distributions 	}
1842*e7776783SApple OSS Distributions 
1843*e7776783SApple OSS Distributions 	/*
1844*e7776783SApple OSS Distributions 	 * Allocate next available slot and fill it out
1845*e7776783SApple OSS Distributions 	 */
1846*e7776783SApple OSS Distributions 	psfileact = &(*psactsp)->psfa_act_acts[(*psactsp)->psfa_act_count++];
1847*e7776783SApple OSS Distributions 
1848*e7776783SApple OSS Distributions 	psfileact->psfaa_type = PSFA_FCHDIR;
1849*e7776783SApple OSS Distributions 	psfileact->psfaa_filedes = filedes;
1850*e7776783SApple OSS Distributions 
1851*e7776783SApple OSS Distributions 	return 0;
1852*e7776783SApple OSS Distributions }
1853*e7776783SApple OSS Distributions 
1854*e7776783SApple OSS Distributions int
posix_spawnattr_setcpumonitor_default(posix_spawnattr_t * __restrict attr)1855*e7776783SApple OSS Distributions posix_spawnattr_setcpumonitor_default(posix_spawnattr_t * __restrict attr)
1856*e7776783SApple OSS Distributions {
1857*e7776783SApple OSS Distributions 	return posix_spawnattr_setcpumonitor(attr, PROC_POLICY_CPUMON_DEFAULTS, 0);
1858*e7776783SApple OSS Distributions }
1859*e7776783SApple OSS Distributions 
1860*e7776783SApple OSS Distributions int
posix_spawnattr_setcpumonitor(posix_spawnattr_t * __restrict attr,uint64_t percent,uint64_t interval)1861*e7776783SApple OSS Distributions posix_spawnattr_setcpumonitor(posix_spawnattr_t * __restrict attr,
1862*e7776783SApple OSS Distributions     uint64_t percent, uint64_t interval)
1863*e7776783SApple OSS Distributions {
1864*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1865*e7776783SApple OSS Distributions 
1866*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1867*e7776783SApple OSS Distributions 		return EINVAL;
1868*e7776783SApple OSS Distributions 	}
1869*e7776783SApple OSS Distributions 
1870*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1871*e7776783SApple OSS Distributions 
1872*e7776783SApple OSS Distributions 	psattr->psa_cpumonitor_percent = percent;
1873*e7776783SApple OSS Distributions 	psattr->psa_cpumonitor_interval = interval;
1874*e7776783SApple OSS Distributions 
1875*e7776783SApple OSS Distributions 	return 0;
1876*e7776783SApple OSS Distributions }
1877*e7776783SApple OSS Distributions 
1878*e7776783SApple OSS Distributions int
posix_spawnattr_getcpumonitor(posix_spawnattr_t * __restrict attr,uint64_t * percent,uint64_t * interval)1879*e7776783SApple OSS Distributions posix_spawnattr_getcpumonitor(posix_spawnattr_t * __restrict attr,
1880*e7776783SApple OSS Distributions     uint64_t *percent, uint64_t *interval)
1881*e7776783SApple OSS Distributions {
1882*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1883*e7776783SApple OSS Distributions 
1884*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1885*e7776783SApple OSS Distributions 		return EINVAL;
1886*e7776783SApple OSS Distributions 	}
1887*e7776783SApple OSS Distributions 
1888*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1889*e7776783SApple OSS Distributions 
1890*e7776783SApple OSS Distributions 	*percent = psattr->psa_cpumonitor_percent;
1891*e7776783SApple OSS Distributions 	*interval = psattr->psa_cpumonitor_interval;
1892*e7776783SApple OSS Distributions 
1893*e7776783SApple OSS Distributions 	return 0;
1894*e7776783SApple OSS Distributions }
1895*e7776783SApple OSS Distributions 
1896*e7776783SApple OSS Distributions #if (TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR)
1897*e7776783SApple OSS Distributions /*
1898*e7776783SApple OSS Distributions  * posix_spawnattr_setjetsam
1899*e7776783SApple OSS Distributions  *
1900*e7776783SApple OSS Distributions  * Description:	Set jetsam attributes for the spawn attribute object
1901*e7776783SApple OSS Distributions  *		referred to by 'attr'.
1902*e7776783SApple OSS Distributions  *
1903*e7776783SApple OSS Distributions  * Parameters:	flags			The flags value to set
1904*e7776783SApple OSS Distributions  *		priority		Relative jetsam priority
1905*e7776783SApple OSS Distributions  *		memlimit		Value in megabytes; a memory footprint
1906*e7776783SApple OSS Distributions  *					above this level may result in termination.
1907*e7776783SApple OSS Distributions  *					Implies both active and inactive limits.
1908*e7776783SApple OSS Distributions  *
1909*e7776783SApple OSS Distributions  * Returns:	0			Success
1910*e7776783SApple OSS Distributions  *
1911*e7776783SApple OSS Distributions  * Note: to be deprecated (not available on desktop)
1912*e7776783SApple OSS Distributions  *
1913*e7776783SApple OSS Distributions  */
1914*e7776783SApple OSS Distributions int
posix_spawnattr_setjetsam(posix_spawnattr_t * __restrict attr,short flags,int priority,int memlimit)1915*e7776783SApple OSS Distributions posix_spawnattr_setjetsam(posix_spawnattr_t * __restrict attr,
1916*e7776783SApple OSS Distributions     short flags, int priority, int memlimit)
1917*e7776783SApple OSS Distributions {
1918*e7776783SApple OSS Distributions 	short flags_ext = flags;
1919*e7776783SApple OSS Distributions 
1920*e7776783SApple OSS Distributions 	if (flags & POSIX_SPAWN_JETSAM_MEMLIMIT_FATAL) {
1921*e7776783SApple OSS Distributions 		flags_ext |= POSIX_SPAWN_JETSAM_MEMLIMIT_ACTIVE_FATAL;
1922*e7776783SApple OSS Distributions 		flags_ext |= POSIX_SPAWN_JETSAM_MEMLIMIT_INACTIVE_FATAL;
1923*e7776783SApple OSS Distributions 	} else {
1924*e7776783SApple OSS Distributions 		flags_ext &= ~POSIX_SPAWN_JETSAM_MEMLIMIT_ACTIVE_FATAL;
1925*e7776783SApple OSS Distributions 		flags_ext &= ~POSIX_SPAWN_JETSAM_MEMLIMIT_INACTIVE_FATAL;
1926*e7776783SApple OSS Distributions 	}
1927*e7776783SApple OSS Distributions 
1928*e7776783SApple OSS Distributions 	return posix_spawnattr_setjetsam_ext(attr, flags_ext, priority, memlimit, memlimit);
1929*e7776783SApple OSS Distributions }
1930*e7776783SApple OSS Distributions #endif /* (TARGET_OS_IPHONE && !TARGET_OS_SIMULATOR) */
1931*e7776783SApple OSS Distributions 
1932*e7776783SApple OSS Distributions /*
1933*e7776783SApple OSS Distributions  * posix_spawnattr_setjetsam_ext
1934*e7776783SApple OSS Distributions  *
1935*e7776783SApple OSS Distributions  * Description:	Set jetsam attributes for the spawn attribute object
1936*e7776783SApple OSS Distributions  *		referred to by 'attr'.
1937*e7776783SApple OSS Distributions  *
1938*e7776783SApple OSS Distributions  * Parameters:	flags			The flags value to set
1939*e7776783SApple OSS Distributions  *		priority		Relative jetsam priority
1940*e7776783SApple OSS Distributions  *		memlimit_active		Value in megabytes; memory footprint
1941*e7776783SApple OSS Distributions  *					above this level while process is
1942*e7776783SApple OSS Distributions  *					active may result in termination.
1943*e7776783SApple OSS Distributions  *		memlimit_inactive	Value in megabytes; memory footprint
1944*e7776783SApple OSS Distributions  *					above this level while process is
1945*e7776783SApple OSS Distributions  *					inactive may result in termination.
1946*e7776783SApple OSS Distributions  *
1947*e7776783SApple OSS Distributions  * Returns:	0			Success
1948*e7776783SApple OSS Distributions  */
1949*e7776783SApple OSS Distributions int
posix_spawnattr_setjetsam_ext(posix_spawnattr_t * __restrict attr,short flags,int priority,int memlimit_active,int memlimit_inactive)1950*e7776783SApple OSS Distributions posix_spawnattr_setjetsam_ext(posix_spawnattr_t * __restrict attr,
1951*e7776783SApple OSS Distributions     short flags, int priority, int memlimit_active, int memlimit_inactive)
1952*e7776783SApple OSS Distributions {
1953*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1954*e7776783SApple OSS Distributions 
1955*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1956*e7776783SApple OSS Distributions 		return EINVAL;
1957*e7776783SApple OSS Distributions 	}
1958*e7776783SApple OSS Distributions 
1959*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1960*e7776783SApple OSS Distributions 
1961*e7776783SApple OSS Distributions 	psattr->psa_jetsam_flags = flags;
1962*e7776783SApple OSS Distributions 	psattr->psa_jetsam_flags |= POSIX_SPAWN_JETSAM_SET;
1963*e7776783SApple OSS Distributions 	psattr->psa_priority = priority;
1964*e7776783SApple OSS Distributions 	psattr->psa_memlimit_active = memlimit_active;
1965*e7776783SApple OSS Distributions 	psattr->psa_memlimit_inactive = memlimit_inactive;
1966*e7776783SApple OSS Distributions 
1967*e7776783SApple OSS Distributions 	return 0;
1968*e7776783SApple OSS Distributions }
1969*e7776783SApple OSS Distributions 
1970*e7776783SApple OSS Distributions int
posix_spawnattr_set_threadlimit_ext(posix_spawnattr_t * __restrict attr,int thread_limit)1971*e7776783SApple OSS Distributions posix_spawnattr_set_threadlimit_ext(posix_spawnattr_t * __restrict attr,
1972*e7776783SApple OSS Distributions     int thread_limit)
1973*e7776783SApple OSS Distributions {
1974*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
1975*e7776783SApple OSS Distributions 
1976*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
1977*e7776783SApple OSS Distributions 		return EINVAL;
1978*e7776783SApple OSS Distributions 	}
1979*e7776783SApple OSS Distributions 
1980*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
1981*e7776783SApple OSS Distributions 
1982*e7776783SApple OSS Distributions 	psattr->psa_thread_limit = thread_limit;
1983*e7776783SApple OSS Distributions 
1984*e7776783SApple OSS Distributions 	return 0;
1985*e7776783SApple OSS Distributions }
1986*e7776783SApple OSS Distributions 
1987*e7776783SApple OSS Distributions 
1988*e7776783SApple OSS Distributions /*
1989*e7776783SApple OSS Distributions  * posix_spawnattr_set_importancewatch_port_np
1990*e7776783SApple OSS Distributions  *
1991*e7776783SApple OSS Distributions  * Description:	Mark ports referred to by these rights
1992*e7776783SApple OSS Distributions  *              to boost the new task instead of their current task
1993*e7776783SApple OSS Distributions  *              for the spawn attribute object referred to by 'attr'.
1994*e7776783SApple OSS Distributions  *              Ports must be valid at posix_spawn time.  They will NOT be
1995*e7776783SApple OSS Distributions  *              consumed by the kernel, so they must be deallocated after the spawn returns.
1996*e7776783SApple OSS Distributions  *              (If you are SETEXEC-ing, they are cleaned up by the exec operation).
1997*e7776783SApple OSS Distributions  *
1998*e7776783SApple OSS Distributions  *              The maximum number of watch ports allowed is defined by POSIX_SPAWN_IMPORTANCE_PORT_COUNT.
1999*e7776783SApple OSS Distributions  *
2000*e7776783SApple OSS Distributions  * Parameters:	count           Number of ports in portarray
2001*e7776783SApple OSS Distributions  *              portarray       Array of rights
2002*e7776783SApple OSS Distributions  *
2003*e7776783SApple OSS Distributions  * Returns:     0       Success
2004*e7776783SApple OSS Distributions  *              EINVAL  Bad port count
2005*e7776783SApple OSS Distributions  *              ENOMEM  Insufficient memory exists to add to
2006*e7776783SApple OSS Distributions  *                      the spawn port actions object.
2007*e7776783SApple OSS Distributions  */
2008*e7776783SApple OSS Distributions int
posix_spawnattr_set_importancewatch_port_np(posix_spawnattr_t * __restrict attr,int count,mach_port_t portarray[])2009*e7776783SApple OSS Distributions posix_spawnattr_set_importancewatch_port_np(posix_spawnattr_t * __restrict attr,
2010*e7776783SApple OSS Distributions     int count, mach_port_t portarray[])
2011*e7776783SApple OSS Distributions {
2012*e7776783SApple OSS Distributions 	int err = 0, i;
2013*e7776783SApple OSS Distributions 
2014*e7776783SApple OSS Distributions 	if (count < 0 || count > POSIX_SPAWN_IMPORTANCE_PORT_COUNT) {
2015*e7776783SApple OSS Distributions 		return EINVAL;
2016*e7776783SApple OSS Distributions 	}
2017*e7776783SApple OSS Distributions 
2018*e7776783SApple OSS Distributions 	for (i = 0; i < count; i++) {
2019*e7776783SApple OSS Distributions 		_ps_port_action_t action = {
2020*e7776783SApple OSS Distributions 			.port_type = PSPA_IMP_WATCHPORTS,
2021*e7776783SApple OSS Distributions 			.new_port = portarray[i],
2022*e7776783SApple OSS Distributions 		};
2023*e7776783SApple OSS Distributions 		err = posix_spawn_appendportaction_np(attr, &action);
2024*e7776783SApple OSS Distributions 		if (err) {
2025*e7776783SApple OSS Distributions 			break;
2026*e7776783SApple OSS Distributions 		}
2027*e7776783SApple OSS Distributions 	}
2028*e7776783SApple OSS Distributions 	return err;
2029*e7776783SApple OSS Distributions }
2030*e7776783SApple OSS Distributions 
2031*e7776783SApple OSS Distributions int
posix_spawnattr_set_registered_ports_np(posix_spawnattr_t * __restrict attr,mach_port_t portarray[],uint32_t count)2032*e7776783SApple OSS Distributions posix_spawnattr_set_registered_ports_np(posix_spawnattr_t * __restrict attr,
2033*e7776783SApple OSS Distributions     mach_port_t portarray[], uint32_t count)
2034*e7776783SApple OSS Distributions {
2035*e7776783SApple OSS Distributions 	int err = 0;
2036*e7776783SApple OSS Distributions 
2037*e7776783SApple OSS Distributions 	if (count > TASK_PORT_REGISTER_MAX) {
2038*e7776783SApple OSS Distributions 		return EINVAL;
2039*e7776783SApple OSS Distributions 	}
2040*e7776783SApple OSS Distributions 
2041*e7776783SApple OSS Distributions 	for (uint32_t i = 0; i < count; i++) {
2042*e7776783SApple OSS Distributions 		_ps_port_action_t action = {
2043*e7776783SApple OSS Distributions 			.port_type = PSPA_REGISTERED_PORTS,
2044*e7776783SApple OSS Distributions 			.new_port = portarray[i],
2045*e7776783SApple OSS Distributions 		};
2046*e7776783SApple OSS Distributions 		err = posix_spawn_appendportaction_np(attr, &action);
2047*e7776783SApple OSS Distributions 		if (err) {
2048*e7776783SApple OSS Distributions 			break;
2049*e7776783SApple OSS Distributions 		}
2050*e7776783SApple OSS Distributions 	}
2051*e7776783SApple OSS Distributions 	return err;
2052*e7776783SApple OSS Distributions }
2053*e7776783SApple OSS Distributions 
2054*e7776783SApple OSS Distributions int
posix_spawnattr_set_ptrauth_task_port_np(posix_spawnattr_t * __restrict attr,mach_port_t port)2055*e7776783SApple OSS Distributions posix_spawnattr_set_ptrauth_task_port_np(posix_spawnattr_t * __restrict attr,
2056*e7776783SApple OSS Distributions     mach_port_t port)
2057*e7776783SApple OSS Distributions {
2058*e7776783SApple OSS Distributions 	int err = 0;
2059*e7776783SApple OSS Distributions 
2060*e7776783SApple OSS Distributions 	_ps_port_action_t action = {
2061*e7776783SApple OSS Distributions 		.port_type = PSPA_PTRAUTH_TASK_PORT,
2062*e7776783SApple OSS Distributions 		.new_port = port,
2063*e7776783SApple OSS Distributions 	};
2064*e7776783SApple OSS Distributions 
2065*e7776783SApple OSS Distributions 	err = posix_spawn_appendportaction_np(attr, &action);
2066*e7776783SApple OSS Distributions 	return err;
2067*e7776783SApple OSS Distributions }
2068*e7776783SApple OSS Distributions 
2069*e7776783SApple OSS Distributions static
2070*e7776783SApple OSS Distributions _ps_mac_policy_extension_t *
posix_spawnattr_macpolicyinfo_lookup(_posix_spawn_mac_policy_extensions_t psmx,const char * policyname)2071*e7776783SApple OSS Distributions posix_spawnattr_macpolicyinfo_lookup(_posix_spawn_mac_policy_extensions_t psmx, const char *policyname)
2072*e7776783SApple OSS Distributions {
2073*e7776783SApple OSS Distributions 	int i;
2074*e7776783SApple OSS Distributions 
2075*e7776783SApple OSS Distributions 	if (psmx == NULL) {
2076*e7776783SApple OSS Distributions 		return NULL;
2077*e7776783SApple OSS Distributions 	}
2078*e7776783SApple OSS Distributions 
2079*e7776783SApple OSS Distributions 	for (i = 0; i < psmx->psmx_count; i++) {
2080*e7776783SApple OSS Distributions 		_ps_mac_policy_extension_t *extension = &psmx->psmx_extensions[i];
2081*e7776783SApple OSS Distributions 		if (strcmp(extension->policyname, policyname) == 0) {
2082*e7776783SApple OSS Distributions 			return extension;
2083*e7776783SApple OSS Distributions 		}
2084*e7776783SApple OSS Distributions 	}
2085*e7776783SApple OSS Distributions 	return NULL;
2086*e7776783SApple OSS Distributions }
2087*e7776783SApple OSS Distributions 
2088*e7776783SApple OSS Distributions int
posix_spawnattr_getmacpolicyinfo_np(const posix_spawnattr_t * __restrict attr,const char * policyname,void ** datap,size_t * datalenp)2089*e7776783SApple OSS Distributions posix_spawnattr_getmacpolicyinfo_np(const posix_spawnattr_t * __restrict attr,
2090*e7776783SApple OSS Distributions     const char *policyname, void **datap, size_t *datalenp)
2091*e7776783SApple OSS Distributions {
2092*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2093*e7776783SApple OSS Distributions 	_ps_mac_policy_extension_t *extension;
2094*e7776783SApple OSS Distributions 
2095*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || policyname == NULL || datap == NULL) {
2096*e7776783SApple OSS Distributions 		return EINVAL;
2097*e7776783SApple OSS Distributions 	}
2098*e7776783SApple OSS Distributions 
2099*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2100*e7776783SApple OSS Distributions 	extension = posix_spawnattr_macpolicyinfo_lookup(psattr->psa_mac_extensions, policyname);
2101*e7776783SApple OSS Distributions 	if (extension == NULL) {
2102*e7776783SApple OSS Distributions 		return ESRCH;
2103*e7776783SApple OSS Distributions 	}
2104*e7776783SApple OSS Distributions 	*datap = (void *)(uintptr_t)extension->data;
2105*e7776783SApple OSS Distributions 	if (datalenp != NULL) {
2106*e7776783SApple OSS Distributions 		*datalenp = (size_t)extension->datalen;
2107*e7776783SApple OSS Distributions 	}
2108*e7776783SApple OSS Distributions 	return 0;
2109*e7776783SApple OSS Distributions }
2110*e7776783SApple OSS Distributions 
2111*e7776783SApple OSS Distributions int
posix_spawnattr_setmacpolicyinfo_np(posix_spawnattr_t * __restrict attr,const char * policyname,void * data,size_t datalen)2112*e7776783SApple OSS Distributions posix_spawnattr_setmacpolicyinfo_np(posix_spawnattr_t * __restrict attr,
2113*e7776783SApple OSS Distributions     const char *policyname, void *data, size_t datalen)
2114*e7776783SApple OSS Distributions {
2115*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2116*e7776783SApple OSS Distributions 	_posix_spawn_mac_policy_extensions_t psmx;
2117*e7776783SApple OSS Distributions 	_ps_mac_policy_extension_t *extension;
2118*e7776783SApple OSS Distributions 
2119*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL || policyname == NULL) {
2120*e7776783SApple OSS Distributions 		return EINVAL;
2121*e7776783SApple OSS Distributions 	}
2122*e7776783SApple OSS Distributions 
2123*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2124*e7776783SApple OSS Distributions 	psmx = psattr->psa_mac_extensions;
2125*e7776783SApple OSS Distributions 	extension = posix_spawnattr_macpolicyinfo_lookup(psattr->psa_mac_extensions, policyname);
2126*e7776783SApple OSS Distributions 	if (extension != NULL) {
2127*e7776783SApple OSS Distributions 		extension->data = (uintptr_t)data;
2128*e7776783SApple OSS Distributions 		extension->datalen = datalen;
2129*e7776783SApple OSS Distributions 		return 0;
2130*e7776783SApple OSS Distributions 	} else if (psmx == NULL) {
2131*e7776783SApple OSS Distributions 		psmx = psattr->psa_mac_extensions = malloc(PS_MAC_EXTENSIONS_SIZE(PS_MAC_EXTENSIONS_INIT_COUNT));
2132*e7776783SApple OSS Distributions 		if (psmx == NULL) {
2133*e7776783SApple OSS Distributions 			return ENOMEM;
2134*e7776783SApple OSS Distributions 		}
2135*e7776783SApple OSS Distributions 		psmx->psmx_alloc = PS_MAC_EXTENSIONS_INIT_COUNT;
2136*e7776783SApple OSS Distributions 		psmx->psmx_count = 0;
2137*e7776783SApple OSS Distributions 	} else if (psmx->psmx_count == psmx->psmx_alloc) {
2138*e7776783SApple OSS Distributions 		int newnum = 0;
2139*e7776783SApple OSS Distributions 		if (os_mul_overflow(psmx->psmx_alloc, 2, &newnum)) {
2140*e7776783SApple OSS Distributions 			return ENOMEM;
2141*e7776783SApple OSS Distributions 		}
2142*e7776783SApple OSS Distributions 		size_t extsize = PS_MAC_EXTENSIONS_SIZE(newnum);
2143*e7776783SApple OSS Distributions 		if (extsize == 0) {
2144*e7776783SApple OSS Distributions 			return ENOMEM;
2145*e7776783SApple OSS Distributions 		}
2146*e7776783SApple OSS Distributions 		psmx = psattr->psa_mac_extensions = reallocf(psmx, extsize);
2147*e7776783SApple OSS Distributions 		if (psmx == NULL) {
2148*e7776783SApple OSS Distributions 			return ENOMEM;
2149*e7776783SApple OSS Distributions 		}
2150*e7776783SApple OSS Distributions 		psmx->psmx_alloc = newnum;
2151*e7776783SApple OSS Distributions 	}
2152*e7776783SApple OSS Distributions 	extension = &psmx->psmx_extensions[psmx->psmx_count];
2153*e7776783SApple OSS Distributions 	strlcpy(extension->policyname, policyname, sizeof(extension->policyname));
2154*e7776783SApple OSS Distributions 	extension->data = (uintptr_t)data;
2155*e7776783SApple OSS Distributions 	extension->datalen = datalen;
2156*e7776783SApple OSS Distributions 	psmx->psmx_count += 1;
2157*e7776783SApple OSS Distributions 	return 0;
2158*e7776783SApple OSS Distributions }
2159*e7776783SApple OSS Distributions 
2160*e7776783SApple OSS Distributions /*
2161*e7776783SApple OSS Distributions  * posix_spawn_destroymacpolicy_info_np
2162*e7776783SApple OSS Distributions  * Description: cleanup the macpolicy struct in posix_spawnattr_t attr
2163*e7776783SApple OSS Distributions  */
2164*e7776783SApple OSS Distributions static int
posix_spawn_destroymacpolicy_info_np(posix_spawnattr_t * attr)2165*e7776783SApple OSS Distributions posix_spawn_destroymacpolicy_info_np(posix_spawnattr_t *attr)
2166*e7776783SApple OSS Distributions {
2167*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2168*e7776783SApple OSS Distributions 	_posix_spawn_mac_policy_extensions_t psmx;
2169*e7776783SApple OSS Distributions 
2170*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2171*e7776783SApple OSS Distributions 		return EINVAL;
2172*e7776783SApple OSS Distributions 	}
2173*e7776783SApple OSS Distributions 
2174*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2175*e7776783SApple OSS Distributions 	psmx = psattr->psa_mac_extensions;
2176*e7776783SApple OSS Distributions 	if (psmx == NULL) {
2177*e7776783SApple OSS Distributions 		return EINVAL;
2178*e7776783SApple OSS Distributions 	}
2179*e7776783SApple OSS Distributions 
2180*e7776783SApple OSS Distributions 	psattr->psa_mac_extensions = NULL;
2181*e7776783SApple OSS Distributions 	free(psmx);
2182*e7776783SApple OSS Distributions 	return 0;
2183*e7776783SApple OSS Distributions }
2184*e7776783SApple OSS Distributions 
2185*e7776783SApple OSS Distributions int
posix_spawnattr_setcoalition_np(const posix_spawnattr_t * __restrict attr,uint64_t coalitionid,int type,int role)2186*e7776783SApple OSS Distributions posix_spawnattr_setcoalition_np(const posix_spawnattr_t * __restrict attr,
2187*e7776783SApple OSS Distributions     uint64_t coalitionid, int type, int role)
2188*e7776783SApple OSS Distributions {
2189*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2190*e7776783SApple OSS Distributions 	struct _posix_spawn_coalition_info *coal_info;
2191*e7776783SApple OSS Distributions 
2192*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2193*e7776783SApple OSS Distributions 		return EINVAL;
2194*e7776783SApple OSS Distributions 	}
2195*e7776783SApple OSS Distributions 	if (type < 0 || type > COALITION_TYPE_MAX) {
2196*e7776783SApple OSS Distributions 		return EINVAL;
2197*e7776783SApple OSS Distributions 	}
2198*e7776783SApple OSS Distributions 
2199*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2200*e7776783SApple OSS Distributions 
2201*e7776783SApple OSS Distributions 	coal_info = psattr->psa_coalition_info;
2202*e7776783SApple OSS Distributions 	if (!coal_info) {
2203*e7776783SApple OSS Distributions 		coal_info = (struct _posix_spawn_coalition_info *)malloc(sizeof(*coal_info));
2204*e7776783SApple OSS Distributions 		if (!coal_info) {
2205*e7776783SApple OSS Distributions 			return ENOMEM;
2206*e7776783SApple OSS Distributions 		}
2207*e7776783SApple OSS Distributions 		memset(coal_info, 0, sizeof(*coal_info));
2208*e7776783SApple OSS Distributions 		psattr->psa_coalition_info = coal_info;
2209*e7776783SApple OSS Distributions 	}
2210*e7776783SApple OSS Distributions 
2211*e7776783SApple OSS Distributions 	coal_info->psci_info[type].psci_id   = coalitionid;
2212*e7776783SApple OSS Distributions 	coal_info->psci_info[type].psci_role = role;
2213*e7776783SApple OSS Distributions 
2214*e7776783SApple OSS Distributions 	return 0;
2215*e7776783SApple OSS Distributions }
2216*e7776783SApple OSS Distributions 
2217*e7776783SApple OSS Distributions 
2218*e7776783SApple OSS Distributions int
posix_spawnattr_set_qos_clamp_np(const posix_spawnattr_t * __restrict attr,uint64_t qos_clamp)2219*e7776783SApple OSS Distributions posix_spawnattr_set_qos_clamp_np(const posix_spawnattr_t * __restrict attr, uint64_t qos_clamp)
2220*e7776783SApple OSS Distributions {
2221*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2222*e7776783SApple OSS Distributions 
2223*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2224*e7776783SApple OSS Distributions 		return EINVAL;
2225*e7776783SApple OSS Distributions 	}
2226*e7776783SApple OSS Distributions 
2227*e7776783SApple OSS Distributions 	if (qos_clamp >= POSIX_SPAWN_PROC_CLAMP_LAST) {
2228*e7776783SApple OSS Distributions 		return EINVAL;
2229*e7776783SApple OSS Distributions 	}
2230*e7776783SApple OSS Distributions 
2231*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2232*e7776783SApple OSS Distributions 	psattr->psa_qos_clamp = qos_clamp;
2233*e7776783SApple OSS Distributions 
2234*e7776783SApple OSS Distributions 	return 0;
2235*e7776783SApple OSS Distributions }
2236*e7776783SApple OSS Distributions 
2237*e7776783SApple OSS Distributions int
posix_spawnattr_get_qos_clamp_np(const posix_spawnattr_t * __restrict attr,uint64_t * __restrict qos_clampp)2238*e7776783SApple OSS Distributions posix_spawnattr_get_qos_clamp_np(const posix_spawnattr_t * __restrict attr, uint64_t * __restrict qos_clampp)
2239*e7776783SApple OSS Distributions {
2240*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2241*e7776783SApple OSS Distributions 
2242*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2243*e7776783SApple OSS Distributions 		return EINVAL;
2244*e7776783SApple OSS Distributions 	}
2245*e7776783SApple OSS Distributions 
2246*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2247*e7776783SApple OSS Distributions 	*qos_clampp = psattr->psa_qos_clamp;
2248*e7776783SApple OSS Distributions 
2249*e7776783SApple OSS Distributions 	return 0;
2250*e7776783SApple OSS Distributions }
2251*e7776783SApple OSS Distributions 
2252*e7776783SApple OSS Distributions int
posix_spawnattr_set_darwin_role_np(const posix_spawnattr_t * __restrict attr,uint64_t darwin_role)2253*e7776783SApple OSS Distributions posix_spawnattr_set_darwin_role_np(const posix_spawnattr_t * __restrict attr, uint64_t darwin_role)
2254*e7776783SApple OSS Distributions {
2255*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2256*e7776783SApple OSS Distributions 
2257*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2258*e7776783SApple OSS Distributions 		return EINVAL;
2259*e7776783SApple OSS Distributions 	}
2260*e7776783SApple OSS Distributions 
2261*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2262*e7776783SApple OSS Distributions 	psattr->psa_darwin_role = darwin_role;
2263*e7776783SApple OSS Distributions 
2264*e7776783SApple OSS Distributions 	return 0;
2265*e7776783SApple OSS Distributions }
2266*e7776783SApple OSS Distributions 
2267*e7776783SApple OSS Distributions int
posix_spawnattr_get_darwin_role_np(const posix_spawnattr_t * __restrict attr,uint64_t * __restrict darwin_rolep)2268*e7776783SApple OSS Distributions posix_spawnattr_get_darwin_role_np(const posix_spawnattr_t * __restrict attr, uint64_t * __restrict darwin_rolep)
2269*e7776783SApple OSS Distributions {
2270*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2271*e7776783SApple OSS Distributions 
2272*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2273*e7776783SApple OSS Distributions 		return EINVAL;
2274*e7776783SApple OSS Distributions 	}
2275*e7776783SApple OSS Distributions 
2276*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2277*e7776783SApple OSS Distributions 	*darwin_rolep = psattr->psa_darwin_role;
2278*e7776783SApple OSS Distributions 
2279*e7776783SApple OSS Distributions 	return 0;
2280*e7776783SApple OSS Distributions }
2281*e7776783SApple OSS Distributions 
2282*e7776783SApple OSS Distributions 
2283*e7776783SApple OSS Distributions int
posix_spawnattr_set_persona_np(const posix_spawnattr_t * __restrict attr,uid_t persona_id,uint32_t flags)2284*e7776783SApple OSS Distributions posix_spawnattr_set_persona_np(const posix_spawnattr_t * __restrict attr, uid_t persona_id, uint32_t flags)
2285*e7776783SApple OSS Distributions {
2286*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2287*e7776783SApple OSS Distributions 	struct _posix_spawn_persona_info *persona;
2288*e7776783SApple OSS Distributions 
2289*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2290*e7776783SApple OSS Distributions 		return EINVAL;
2291*e7776783SApple OSS Distributions 	}
2292*e7776783SApple OSS Distributions 
2293*e7776783SApple OSS Distributions 	if (flags & ~POSIX_SPAWN_PERSONA_ALL_FLAGS) {
2294*e7776783SApple OSS Distributions 		return EINVAL;
2295*e7776783SApple OSS Distributions 	}
2296*e7776783SApple OSS Distributions 
2297*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2298*e7776783SApple OSS Distributions 
2299*e7776783SApple OSS Distributions 	persona = psattr->psa_persona_info;
2300*e7776783SApple OSS Distributions 	if (!persona) {
2301*e7776783SApple OSS Distributions 		persona = (struct _posix_spawn_persona_info *)malloc(sizeof(*persona));
2302*e7776783SApple OSS Distributions 		if (!persona) {
2303*e7776783SApple OSS Distributions 			return ENOMEM;
2304*e7776783SApple OSS Distributions 		}
2305*e7776783SApple OSS Distributions 		persona->pspi_uid = 0;
2306*e7776783SApple OSS Distributions 		persona->pspi_gid = 0;
2307*e7776783SApple OSS Distributions 		persona->pspi_ngroups = 0;
2308*e7776783SApple OSS Distributions 		persona->pspi_groups[0] = 0;
2309*e7776783SApple OSS Distributions 		persona->pspi_gmuid = 0;
2310*e7776783SApple OSS Distributions 
2311*e7776783SApple OSS Distributions 		psattr->psa_persona_info = persona;
2312*e7776783SApple OSS Distributions 	}
2313*e7776783SApple OSS Distributions 
2314*e7776783SApple OSS Distributions 	persona->pspi_id = persona_id;
2315*e7776783SApple OSS Distributions 	persona->pspi_flags = flags;
2316*e7776783SApple OSS Distributions 
2317*e7776783SApple OSS Distributions 	return 0;
2318*e7776783SApple OSS Distributions }
2319*e7776783SApple OSS Distributions 
2320*e7776783SApple OSS Distributions int
posix_spawnattr_set_persona_uid_np(const posix_spawnattr_t * __restrict attr,uid_t uid)2321*e7776783SApple OSS Distributions posix_spawnattr_set_persona_uid_np(const posix_spawnattr_t * __restrict attr, uid_t uid)
2322*e7776783SApple OSS Distributions {
2323*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2324*e7776783SApple OSS Distributions 	struct _posix_spawn_persona_info *persona;
2325*e7776783SApple OSS Distributions 
2326*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2327*e7776783SApple OSS Distributions 		return EINVAL;
2328*e7776783SApple OSS Distributions 	}
2329*e7776783SApple OSS Distributions 
2330*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2331*e7776783SApple OSS Distributions 	persona = psattr->psa_persona_info;
2332*e7776783SApple OSS Distributions 	if (!persona) {
2333*e7776783SApple OSS Distributions 		return EINVAL;
2334*e7776783SApple OSS Distributions 	}
2335*e7776783SApple OSS Distributions 
2336*e7776783SApple OSS Distributions 	if (!(persona->pspi_flags & (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE | POSIX_SPAWN_PERSONA_FLAGS_VERIFY))) {
2337*e7776783SApple OSS Distributions 		return EINVAL;
2338*e7776783SApple OSS Distributions 	}
2339*e7776783SApple OSS Distributions 
2340*e7776783SApple OSS Distributions 	persona->pspi_uid = uid;
2341*e7776783SApple OSS Distributions 
2342*e7776783SApple OSS Distributions 	persona->pspi_flags |= POSIX_SPAWN_PERSONA_UID;
2343*e7776783SApple OSS Distributions 
2344*e7776783SApple OSS Distributions 	return 0;
2345*e7776783SApple OSS Distributions }
2346*e7776783SApple OSS Distributions 
2347*e7776783SApple OSS Distributions int
posix_spawnattr_set_persona_gid_np(const posix_spawnattr_t * __restrict attr,gid_t gid)2348*e7776783SApple OSS Distributions posix_spawnattr_set_persona_gid_np(const posix_spawnattr_t * __restrict attr, gid_t gid)
2349*e7776783SApple OSS Distributions {
2350*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2351*e7776783SApple OSS Distributions 	struct _posix_spawn_persona_info *persona;
2352*e7776783SApple OSS Distributions 
2353*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2354*e7776783SApple OSS Distributions 		return EINVAL;
2355*e7776783SApple OSS Distributions 	}
2356*e7776783SApple OSS Distributions 
2357*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2358*e7776783SApple OSS Distributions 	persona = psattr->psa_persona_info;
2359*e7776783SApple OSS Distributions 	if (!persona) {
2360*e7776783SApple OSS Distributions 		return EINVAL;
2361*e7776783SApple OSS Distributions 	}
2362*e7776783SApple OSS Distributions 
2363*e7776783SApple OSS Distributions 	if (!(persona->pspi_flags & (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE | POSIX_SPAWN_PERSONA_FLAGS_VERIFY))) {
2364*e7776783SApple OSS Distributions 		return EINVAL;
2365*e7776783SApple OSS Distributions 	}
2366*e7776783SApple OSS Distributions 
2367*e7776783SApple OSS Distributions 	persona->pspi_gid = gid;
2368*e7776783SApple OSS Distributions 
2369*e7776783SApple OSS Distributions 	persona->pspi_flags |= POSIX_SPAWN_PERSONA_GID;
2370*e7776783SApple OSS Distributions 
2371*e7776783SApple OSS Distributions 	return 0;
2372*e7776783SApple OSS Distributions }
2373*e7776783SApple OSS Distributions 
2374*e7776783SApple OSS Distributions int
posix_spawnattr_set_persona_groups_np(const posix_spawnattr_t * __restrict attr,int ngroups,gid_t * gidarray,uid_t gmuid)2375*e7776783SApple OSS Distributions posix_spawnattr_set_persona_groups_np(const posix_spawnattr_t * __restrict attr, int ngroups, gid_t *gidarray, uid_t gmuid)
2376*e7776783SApple OSS Distributions {
2377*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2378*e7776783SApple OSS Distributions 	struct _posix_spawn_persona_info *persona;
2379*e7776783SApple OSS Distributions 
2380*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2381*e7776783SApple OSS Distributions 		return EINVAL;
2382*e7776783SApple OSS Distributions 	}
2383*e7776783SApple OSS Distributions 
2384*e7776783SApple OSS Distributions 	if (gidarray == NULL) {
2385*e7776783SApple OSS Distributions 		return EINVAL;
2386*e7776783SApple OSS Distributions 	}
2387*e7776783SApple OSS Distributions 
2388*e7776783SApple OSS Distributions 	if (ngroups > NGROUPS || ngroups < 0) {
2389*e7776783SApple OSS Distributions 		return EINVAL;
2390*e7776783SApple OSS Distributions 	}
2391*e7776783SApple OSS Distributions 
2392*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2393*e7776783SApple OSS Distributions 	persona = psattr->psa_persona_info;
2394*e7776783SApple OSS Distributions 	if (!persona) {
2395*e7776783SApple OSS Distributions 		return EINVAL;
2396*e7776783SApple OSS Distributions 	}
2397*e7776783SApple OSS Distributions 
2398*e7776783SApple OSS Distributions 	if (!(persona->pspi_flags & (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE | POSIX_SPAWN_PERSONA_FLAGS_VERIFY))) {
2399*e7776783SApple OSS Distributions 		return EINVAL;
2400*e7776783SApple OSS Distributions 	}
2401*e7776783SApple OSS Distributions 
2402*e7776783SApple OSS Distributions 	persona->pspi_ngroups = ngroups;
2403*e7776783SApple OSS Distributions 	for (int i = 0; i < ngroups; i++) {
2404*e7776783SApple OSS Distributions 		persona->pspi_groups[i] = gidarray[i];
2405*e7776783SApple OSS Distributions 	}
2406*e7776783SApple OSS Distributions 
2407*e7776783SApple OSS Distributions 	persona->pspi_gmuid = gmuid;
2408*e7776783SApple OSS Distributions 
2409*e7776783SApple OSS Distributions 	persona->pspi_flags |= POSIX_SPAWN_PERSONA_GROUPS;
2410*e7776783SApple OSS Distributions 
2411*e7776783SApple OSS Distributions 	return 0;
2412*e7776783SApple OSS Distributions }
2413*e7776783SApple OSS Distributions 
2414*e7776783SApple OSS Distributions int
posix_spawnattr_set_max_addr_np(const posix_spawnattr_t * __restrict attr,uint64_t max_addr)2415*e7776783SApple OSS Distributions posix_spawnattr_set_max_addr_np(const posix_spawnattr_t * __restrict attr, uint64_t max_addr)
2416*e7776783SApple OSS Distributions {
2417*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2418*e7776783SApple OSS Distributions 
2419*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2420*e7776783SApple OSS Distributions 		return EINVAL;
2421*e7776783SApple OSS Distributions 	}
2422*e7776783SApple OSS Distributions 
2423*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2424*e7776783SApple OSS Distributions 	psattr->psa_max_addr = max_addr;
2425*e7776783SApple OSS Distributions 
2426*e7776783SApple OSS Distributions 	return 0;
2427*e7776783SApple OSS Distributions }
2428*e7776783SApple OSS Distributions 
2429*e7776783SApple OSS Distributions int
posix_spawnattr_setnosmt_np(const posix_spawnattr_t * __restrict attr)2430*e7776783SApple OSS Distributions posix_spawnattr_setnosmt_np(const posix_spawnattr_t * __restrict attr)
2431*e7776783SApple OSS Distributions {
2432*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2433*e7776783SApple OSS Distributions 
2434*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2435*e7776783SApple OSS Distributions 		return EINVAL;
2436*e7776783SApple OSS Distributions 	}
2437*e7776783SApple OSS Distributions 
2438*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2439*e7776783SApple OSS Distributions 	psattr->psa_no_smt = true;
2440*e7776783SApple OSS Distributions 
2441*e7776783SApple OSS Distributions 	return 0;
2442*e7776783SApple OSS Distributions }
2443*e7776783SApple OSS Distributions 
2444*e7776783SApple OSS Distributions int
posix_spawnattr_set_csm_np(const posix_spawnattr_t * __restrict attr,uint32_t flags)2445*e7776783SApple OSS Distributions posix_spawnattr_set_csm_np(const posix_spawnattr_t * __restrict attr, uint32_t flags)
2446*e7776783SApple OSS Distributions {
2447*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2448*e7776783SApple OSS Distributions 
2449*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2450*e7776783SApple OSS Distributions 		return EINVAL;
2451*e7776783SApple OSS Distributions 	}
2452*e7776783SApple OSS Distributions 
2453*e7776783SApple OSS Distributions 	const uint32_t mask = POSIX_SPAWN_NP_CSM_ALL | POSIX_SPAWN_NP_CSM_TECS | POSIX_SPAWN_NP_CSM_NOSMT;
2454*e7776783SApple OSS Distributions 	if ((flags & ~mask) != 0) {
2455*e7776783SApple OSS Distributions 		return EINVAL;
2456*e7776783SApple OSS Distributions 	}
2457*e7776783SApple OSS Distributions 
2458*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2459*e7776783SApple OSS Distributions 
2460*e7776783SApple OSS Distributions 	if (flags & (POSIX_SPAWN_NP_CSM_TECS | POSIX_SPAWN_NP_CSM_ALL)) {
2461*e7776783SApple OSS Distributions 		psattr->psa_tecs = true;
2462*e7776783SApple OSS Distributions 	}
2463*e7776783SApple OSS Distributions 	if (flags & (POSIX_SPAWN_NP_CSM_NOSMT | POSIX_SPAWN_NP_CSM_ALL)) {
2464*e7776783SApple OSS Distributions 		psattr->psa_no_smt = true;
2465*e7776783SApple OSS Distributions 	}
2466*e7776783SApple OSS Distributions 
2467*e7776783SApple OSS Distributions 	return 0;
2468*e7776783SApple OSS Distributions }
2469*e7776783SApple OSS Distributions 
2470*e7776783SApple OSS Distributions static struct _posix_spawn_posix_cred_info *
_posix_spawnattr_get_posix_creds_info(_posix_spawnattr_t psattr)2471*e7776783SApple OSS Distributions _posix_spawnattr_get_posix_creds_info(_posix_spawnattr_t psattr)
2472*e7776783SApple OSS Distributions {
2473*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci = psattr->psa_posix_cred_info;
2474*e7776783SApple OSS Distributions 
2475*e7776783SApple OSS Distributions 	if (pspci == NULL) {
2476*e7776783SApple OSS Distributions 		pspci = malloc(sizeof(struct _posix_spawn_posix_cred_info));
2477*e7776783SApple OSS Distributions 		if (pspci != NULL) {
2478*e7776783SApple OSS Distributions 			pspci->pspci_flags = 0;
2479*e7776783SApple OSS Distributions 			pspci->pspci_uid = 0;
2480*e7776783SApple OSS Distributions 			pspci->pspci_gid = 0;
2481*e7776783SApple OSS Distributions 			pspci->pspci_ngroups = 0;
2482*e7776783SApple OSS Distributions 			pspci->pspci_groups[0] = 0;
2483*e7776783SApple OSS Distributions 			pspci->pspci_gmuid = 0;
2484*e7776783SApple OSS Distributions 			pspci->pspci_login[0] = '\0';
2485*e7776783SApple OSS Distributions 			psattr->psa_posix_cred_info = pspci;
2486*e7776783SApple OSS Distributions 		}
2487*e7776783SApple OSS Distributions 	}
2488*e7776783SApple OSS Distributions 	return pspci;
2489*e7776783SApple OSS Distributions }
2490*e7776783SApple OSS Distributions 
2491*e7776783SApple OSS Distributions int
posix_spawnattr_set_uid_np(const posix_spawnattr_t * attr,uid_t uid)2492*e7776783SApple OSS Distributions posix_spawnattr_set_uid_np(const posix_spawnattr_t *attr, uid_t uid)
2493*e7776783SApple OSS Distributions {
2494*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci;
2495*e7776783SApple OSS Distributions 
2496*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2497*e7776783SApple OSS Distributions 		return EINVAL;
2498*e7776783SApple OSS Distributions 	}
2499*e7776783SApple OSS Distributions 
2500*e7776783SApple OSS Distributions 	pspci = _posix_spawnattr_get_posix_creds_info(*(_posix_spawnattr_t *)attr);
2501*e7776783SApple OSS Distributions 	if (pspci == NULL) {
2502*e7776783SApple OSS Distributions 		return ENOMEM;
2503*e7776783SApple OSS Distributions 	}
2504*e7776783SApple OSS Distributions 
2505*e7776783SApple OSS Distributions 	pspci->pspci_uid = uid;
2506*e7776783SApple OSS Distributions 
2507*e7776783SApple OSS Distributions 	pspci->pspci_flags |= POSIX_SPAWN_POSIX_CRED_UID;
2508*e7776783SApple OSS Distributions 
2509*e7776783SApple OSS Distributions 	return 0;
2510*e7776783SApple OSS Distributions }
2511*e7776783SApple OSS Distributions 
2512*e7776783SApple OSS Distributions int
posix_spawnattr_set_gid_np(const posix_spawnattr_t * attr,gid_t gid)2513*e7776783SApple OSS Distributions posix_spawnattr_set_gid_np(const posix_spawnattr_t *attr, gid_t gid)
2514*e7776783SApple OSS Distributions {
2515*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci;
2516*e7776783SApple OSS Distributions 
2517*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2518*e7776783SApple OSS Distributions 		return EINVAL;
2519*e7776783SApple OSS Distributions 	}
2520*e7776783SApple OSS Distributions 
2521*e7776783SApple OSS Distributions 	pspci = _posix_spawnattr_get_posix_creds_info(*(_posix_spawnattr_t *)attr);
2522*e7776783SApple OSS Distributions 	if (pspci == NULL) {
2523*e7776783SApple OSS Distributions 		return ENOMEM;
2524*e7776783SApple OSS Distributions 	}
2525*e7776783SApple OSS Distributions 
2526*e7776783SApple OSS Distributions 	pspci->pspci_gid = gid;
2527*e7776783SApple OSS Distributions 
2528*e7776783SApple OSS Distributions 	pspci->pspci_flags |= POSIX_SPAWN_POSIX_CRED_GID;
2529*e7776783SApple OSS Distributions 
2530*e7776783SApple OSS Distributions 	return 0;
2531*e7776783SApple OSS Distributions }
2532*e7776783SApple OSS Distributions 
2533*e7776783SApple OSS Distributions int
posix_spawnattr_set_groups_np(const posix_spawnattr_t * attr,int ngroups,gid_t * gidarray,uid_t gmuid)2534*e7776783SApple OSS Distributions posix_spawnattr_set_groups_np(const posix_spawnattr_t *attr,
2535*e7776783SApple OSS Distributions     int ngroups, gid_t *gidarray, uid_t gmuid)
2536*e7776783SApple OSS Distributions {
2537*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci;
2538*e7776783SApple OSS Distributions 
2539*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2540*e7776783SApple OSS Distributions 		return EINVAL;
2541*e7776783SApple OSS Distributions 	}
2542*e7776783SApple OSS Distributions 
2543*e7776783SApple OSS Distributions 	if (gidarray == NULL) {
2544*e7776783SApple OSS Distributions 		return EINVAL;
2545*e7776783SApple OSS Distributions 	}
2546*e7776783SApple OSS Distributions 
2547*e7776783SApple OSS Distributions 	if (ngroups > NGROUPS || ngroups < 0) {
2548*e7776783SApple OSS Distributions 		return EINVAL;
2549*e7776783SApple OSS Distributions 	}
2550*e7776783SApple OSS Distributions 
2551*e7776783SApple OSS Distributions 	pspci = _posix_spawnattr_get_posix_creds_info(*(_posix_spawnattr_t *)attr);
2552*e7776783SApple OSS Distributions 	if (pspci == NULL) {
2553*e7776783SApple OSS Distributions 		return ENOMEM;
2554*e7776783SApple OSS Distributions 	}
2555*e7776783SApple OSS Distributions 
2556*e7776783SApple OSS Distributions 	pspci->pspci_ngroups = ngroups;
2557*e7776783SApple OSS Distributions 	for (int i = 0; i < ngroups; i++) {
2558*e7776783SApple OSS Distributions 		pspci->pspci_groups[i] = gidarray[i];
2559*e7776783SApple OSS Distributions 	}
2560*e7776783SApple OSS Distributions 
2561*e7776783SApple OSS Distributions 	pspci->pspci_gmuid = gmuid;
2562*e7776783SApple OSS Distributions 
2563*e7776783SApple OSS Distributions 	pspci->pspci_flags |= POSIX_SPAWN_POSIX_CRED_GROUPS;
2564*e7776783SApple OSS Distributions 
2565*e7776783SApple OSS Distributions 	return 0;
2566*e7776783SApple OSS Distributions }
2567*e7776783SApple OSS Distributions 
2568*e7776783SApple OSS Distributions int
posix_spawnattr_set_login_np(const posix_spawnattr_t * attr,const char * login)2569*e7776783SApple OSS Distributions posix_spawnattr_set_login_np(const posix_spawnattr_t *attr, const char *login)
2570*e7776783SApple OSS Distributions {
2571*e7776783SApple OSS Distributions 	struct _posix_spawn_posix_cred_info *pspci;
2572*e7776783SApple OSS Distributions 
2573*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2574*e7776783SApple OSS Distributions 		return EINVAL;
2575*e7776783SApple OSS Distributions 	}
2576*e7776783SApple OSS Distributions 
2577*e7776783SApple OSS Distributions 	if (strlen(login) > MAXLOGNAME) {
2578*e7776783SApple OSS Distributions 		return ERANGE;
2579*e7776783SApple OSS Distributions 	}
2580*e7776783SApple OSS Distributions 
2581*e7776783SApple OSS Distributions 	pspci = _posix_spawnattr_get_posix_creds_info(*(_posix_spawnattr_t *)attr);
2582*e7776783SApple OSS Distributions 	if (pspci == NULL) {
2583*e7776783SApple OSS Distributions 		return ENOMEM;
2584*e7776783SApple OSS Distributions 	}
2585*e7776783SApple OSS Distributions 
2586*e7776783SApple OSS Distributions 	strlcpy(pspci->pspci_login, login, sizeof(pspci->pspci_login));
2587*e7776783SApple OSS Distributions 
2588*e7776783SApple OSS Distributions 	pspci->pspci_flags |= POSIX_SPAWN_POSIX_CRED_LOGIN;
2589*e7776783SApple OSS Distributions 
2590*e7776783SApple OSS Distributions 	return 0;
2591*e7776783SApple OSS Distributions }
2592*e7776783SApple OSS Distributions 
2593*e7776783SApple OSS Distributions int
posix_spawnattr_set_portlimits_ext(posix_spawnattr_t * __restrict attr,uint32_t port_soft_limit,uint32_t port_hard_limit)2594*e7776783SApple OSS Distributions posix_spawnattr_set_portlimits_ext(posix_spawnattr_t * __restrict attr,
2595*e7776783SApple OSS Distributions     uint32_t port_soft_limit, uint32_t port_hard_limit)
2596*e7776783SApple OSS Distributions {
2597*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2598*e7776783SApple OSS Distributions 
2599*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2600*e7776783SApple OSS Distributions 		return EINVAL;
2601*e7776783SApple OSS Distributions 	}
2602*e7776783SApple OSS Distributions 
2603*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2604*e7776783SApple OSS Distributions 
2605*e7776783SApple OSS Distributions 	psattr->psa_port_soft_limit = port_soft_limit;
2606*e7776783SApple OSS Distributions 	psattr->psa_port_hard_limit = port_hard_limit;
2607*e7776783SApple OSS Distributions 
2608*e7776783SApple OSS Distributions 	return 0;
2609*e7776783SApple OSS Distributions }
2610*e7776783SApple OSS Distributions 
2611*e7776783SApple OSS Distributions int
posix_spawnattr_set_filedesclimit_ext(posix_spawnattr_t * __restrict attr,uint32_t filedesc_soft_limit,uint32_t filedesc_hard_limit)2612*e7776783SApple OSS Distributions posix_spawnattr_set_filedesclimit_ext(posix_spawnattr_t * __restrict attr,
2613*e7776783SApple OSS Distributions     uint32_t filedesc_soft_limit, uint32_t filedesc_hard_limit)
2614*e7776783SApple OSS Distributions {
2615*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2616*e7776783SApple OSS Distributions 
2617*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2618*e7776783SApple OSS Distributions 		return EINVAL;
2619*e7776783SApple OSS Distributions 	}
2620*e7776783SApple OSS Distributions 
2621*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2622*e7776783SApple OSS Distributions 
2623*e7776783SApple OSS Distributions 	psattr->psa_filedesc_soft_limit = filedesc_soft_limit;
2624*e7776783SApple OSS Distributions 	psattr->psa_filedesc_hard_limit = filedesc_hard_limit;
2625*e7776783SApple OSS Distributions 
2626*e7776783SApple OSS Distributions 	return 0;
2627*e7776783SApple OSS Distributions }
2628*e7776783SApple OSS Distributions 
2629*e7776783SApple OSS Distributions /*
2630*e7776783SApple OSS Distributions  * posix_spawnattr_set_jetsam_ttr_np
2631*e7776783SApple OSS Distributions  *
2632*e7776783SApple OSS Distributions  * Description: Pass data regarding recent relaunch behavior when jetsammed for the process.
2633*e7776783SApple OSS Distributions  *              The recent history is effectively converted into a histogram and the highest
2634*e7776783SApple OSS Distributions  *              frequency bucket defines the "type" of the process. The type is passed along
2635*e7776783SApple OSS Distributions  *              to the jetsam code as part of psa_jetsam_flags.
2636*e7776783SApple OSS Distributions  *
2637*e7776783SApple OSS Distributions  * Parameters:	count           Number of entries in the ttrs_millis array
2638*e7776783SApple OSS Distributions  *              ttrs_millis     Array of raw data for relaunch behavior
2639*e7776783SApple OSS Distributions  *
2640*e7776783SApple OSS Distributions  * Returns:     0       Success
2641*e7776783SApple OSS Distributions  *              EINVAL  Bad attr pointer or empty data array
2642*e7776783SApple OSS Distributions  */
2643*e7776783SApple OSS Distributions int
posix_spawnattr_set_jetsam_ttr_np(const posix_spawnattr_t * __restrict attr,uint32_t count,uint32_t * ttrs_millis)2644*e7776783SApple OSS Distributions posix_spawnattr_set_jetsam_ttr_np(const posix_spawnattr_t * __restrict attr, uint32_t count, uint32_t *ttrs_millis)
2645*e7776783SApple OSS Distributions {
2646*e7776783SApple OSS Distributions 	_posix_spawnattr_t psattr;
2647*e7776783SApple OSS Distributions 
2648*e7776783SApple OSS Distributions 	/*
2649*e7776783SApple OSS Distributions 	 * Define the bucketizing policy which would be used to generate the histogram. These
2650*e7776783SApple OSS Distributions 	 * values are based on looking at data from various Avg. Joanna runs.
2651*e7776783SApple OSS Distributions 	 */
2652*e7776783SApple OSS Distributions 	static const uint32_t relaunch_buckets_msecs[POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_BUCKETS] = {
2653*e7776783SApple OSS Distributions 		5000,
2654*e7776783SApple OSS Distributions 		10000,
2655*e7776783SApple OSS Distributions 		UINT32_MAX
2656*e7776783SApple OSS Distributions 	};
2657*e7776783SApple OSS Distributions 	static const uint32_t relaunch_jetsam_flags[POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_BUCKETS] = {
2658*e7776783SApple OSS Distributions 		POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_HIGH,
2659*e7776783SApple OSS Distributions 		POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_MED,
2660*e7776783SApple OSS Distributions 		POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_LOW
2661*e7776783SApple OSS Distributions 	};
2662*e7776783SApple OSS Distributions 
2663*e7776783SApple OSS Distributions 	/* Make sure the attr pointer is valid */
2664*e7776783SApple OSS Distributions 	if (attr == NULL || *attr == NULL) {
2665*e7776783SApple OSS Distributions 		return EINVAL;
2666*e7776783SApple OSS Distributions 	}
2667*e7776783SApple OSS Distributions 
2668*e7776783SApple OSS Distributions 	/* Make sure the count of entries is non-zero */
2669*e7776783SApple OSS Distributions 	if (count == 0) {
2670*e7776783SApple OSS Distributions 		return EINVAL;
2671*e7776783SApple OSS Distributions 	}
2672*e7776783SApple OSS Distributions 
2673*e7776783SApple OSS Distributions 	psattr = *(_posix_spawnattr_t *)attr;
2674*e7776783SApple OSS Distributions 
2675*e7776783SApple OSS Distributions 	/* Generate a histogram based on the relaunch data while maintaining highest frequency bucket info */
2676*e7776783SApple OSS Distributions 	int relaunch_histogram[POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_BUCKETS] = {0};
2677*e7776783SApple OSS Distributions 	int max_frequency = -1;
2678*e7776783SApple OSS Distributions 	int highest_frequency_bucket = -1;
2679*e7776783SApple OSS Distributions 
2680*e7776783SApple OSS Distributions 	for (uint32_t i = 0; i < count; i++) {
2681*e7776783SApple OSS Distributions 		/* For each data point passed in via launchd, find the bucket it lands in */
2682*e7776783SApple OSS Distributions 		for (uint32_t bucket = 0; bucket < POSIX_SPAWN_JETSAM_RELAUNCH_BEHAVIOR_BUCKETS; bucket++) {
2683*e7776783SApple OSS Distributions 			if (ttrs_millis[i] <= relaunch_buckets_msecs[bucket]) {
2684*e7776783SApple OSS Distributions 				relaunch_histogram[bucket]++;
2685*e7776783SApple OSS Distributions 
2686*e7776783SApple OSS Distributions 				/* Check if the bucket is the highest frequency bucket now */
2687*e7776783SApple OSS Distributions 				if (relaunch_histogram[bucket] > max_frequency) {
2688*e7776783SApple OSS Distributions 					max_frequency = relaunch_histogram[bucket];
2689*e7776783SApple OSS Distributions 					highest_frequency_bucket = bucket;
2690*e7776783SApple OSS Distributions 				}
2691*e7776783SApple OSS Distributions 				break;
2692*e7776783SApple OSS Distributions 			}
2693*e7776783SApple OSS Distributions 		}
2694*e7776783SApple OSS Distributions 	}
2695*e7776783SApple OSS Distributions 	psattr->psa_jetsam_flags |= relaunch_jetsam_flags[highest_frequency_bucket];
2696*e7776783SApple OSS Distributions 	return 0;
2697*e7776783SApple OSS Distributions }
2698*e7776783SApple OSS Distributions 
2699*e7776783SApple OSS Distributions /*
2700*e7776783SApple OSS Distributions  * posix_spawn
2701*e7776783SApple OSS Distributions  *
2702*e7776783SApple OSS Distributions  * Description:	Create a new process from the process image corresponding to
2703*e7776783SApple OSS Distributions  *		the supplied 'path' argument.
2704*e7776783SApple OSS Distributions  *
2705*e7776783SApple OSS Distributions  * Parameters:	pid				Pointer to pid_t to receive the
2706*e7776783SApple OSS Distributions  *						PID of the spawned process, if
2707*e7776783SApple OSS Distributions  *						successful and 'pid' != NULL
2708*e7776783SApple OSS Distributions  *		path				Path of image file to spawn
2709*e7776783SApple OSS Distributions  *		file_actions			spawn file actions object which
2710*e7776783SApple OSS Distributions  *						describes file actions to be
2711*e7776783SApple OSS Distributions  *						performed during the spawn
2712*e7776783SApple OSS Distributions  *		attrp				spawn attributes object which
2713*e7776783SApple OSS Distributions  *						describes attributes to be
2714*e7776783SApple OSS Distributions  *						applied during the spawn
2715*e7776783SApple OSS Distributions  *		argv				argument vector array; NULL
2716*e7776783SApple OSS Distributions  *						terminated
2717*e7776783SApple OSS Distributions  *		envp				environment vector array; NULL
2718*e7776783SApple OSS Distributions  *						terminated
2719*e7776783SApple OSS Distributions  *
2720*e7776783SApple OSS Distributions  * Returns:	0				Success
2721*e7776783SApple OSS Distributions  *		!0				An errno value indicating the
2722*e7776783SApple OSS Distributions  *						cause of the failure to spawn
2723*e7776783SApple OSS Distributions  *
2724*e7776783SApple OSS Distributions  * Notes:	Unlike other system calls, the return value of this system
2725*e7776783SApple OSS Distributions  *		call is expected to either be a 0 or an errno, rather than a
2726*e7776783SApple OSS Distributions  *		0 or a -1, with the 'errno' variable being set.
2727*e7776783SApple OSS Distributions  */
2728*e7776783SApple OSS Distributions int
posix_spawn(pid_t * __restrict pid,const char * __restrict path,const posix_spawn_file_actions_t * file_actions,const posix_spawnattr_t * __restrict attrp,char * const argv[__restrict],char * const envp[__restrict])2729*e7776783SApple OSS Distributions posix_spawn(pid_t * __restrict pid, const char * __restrict path,
2730*e7776783SApple OSS Distributions     const posix_spawn_file_actions_t *file_actions,
2731*e7776783SApple OSS Distributions     const posix_spawnattr_t * __restrict attrp,
2732*e7776783SApple OSS Distributions     char *const argv[__restrict], char *const envp[__restrict])
2733*e7776783SApple OSS Distributions {
2734*e7776783SApple OSS Distributions 	int saveerrno = errno;
2735*e7776783SApple OSS Distributions 	int ret = 0;
2736*e7776783SApple OSS Distributions 	struct _posix_spawn_args_desc ad;
2737*e7776783SApple OSS Distributions 	struct _posix_spawn_args_desc *adp = NULL;
2738*e7776783SApple OSS Distributions 	/*
2739*e7776783SApple OSS Distributions 	 * Only do extra work if we have file actions or attributes to push
2740*e7776783SApple OSS Distributions 	 * down.  We use a descriptor to push this information down, since we
2741*e7776783SApple OSS Distributions 	 * want to have size information, which will let us (1) preallocate a
2742*e7776783SApple OSS Distributions 	 * single chunk of memory for the copyin(), and (2) allow us to do a
2743*e7776783SApple OSS Distributions 	 * single copyin() per attributes or file actions as a monlithic block.
2744*e7776783SApple OSS Distributions 	 *
2745*e7776783SApple OSS Distributions 	 * Note:	A future implementation may attempt to do the same
2746*e7776783SApple OSS Distributions 	 *		thing for the argv/envp data, which could potentially
2747*e7776783SApple OSS Distributions 	 *		result in a performance improvement due to increased
2748*e7776783SApple OSS Distributions 	 *		kernel efficiency, even though it would mean copying
2749*e7776783SApple OSS Distributions 	 *		the data in user space.
2750*e7776783SApple OSS Distributions 	 */
2751*e7776783SApple OSS Distributions 	if ((file_actions != NULL && (*file_actions != NULL) && (*(_posix_spawn_file_actions_t *)file_actions)->psfa_act_count > 0) || attrp != NULL) {
2752*e7776783SApple OSS Distributions 		memset(&ad, 0, sizeof(ad));
2753*e7776783SApple OSS Distributions 		adp = &ad;
2754*e7776783SApple OSS Distributions 		if (attrp != NULL && *attrp != NULL) {
2755*e7776783SApple OSS Distributions 			_posix_spawnattr_t psattr = *(_posix_spawnattr_t *)attrp;
2756*e7776783SApple OSS Distributions 			ad.attr_size = sizeof(struct _posix_spawnattr);
2757*e7776783SApple OSS Distributions 			ad.attrp = psattr;
2758*e7776783SApple OSS Distributions 
2759*e7776783SApple OSS Distributions 			if (psattr->psa_ports != NULL) {
2760*e7776783SApple OSS Distributions 				size_t psact_size = PS_PORT_ACTIONS_SIZE(psattr->psa_ports->pspa_count);
2761*e7776783SApple OSS Distributions 				if (psact_size == 0 && psattr->psa_ports->pspa_count != 0) {
2762*e7776783SApple OSS Distributions 					errno = EINVAL;
2763*e7776783SApple OSS Distributions 					ret = -1;
2764*e7776783SApple OSS Distributions 					goto out;
2765*e7776783SApple OSS Distributions 				}
2766*e7776783SApple OSS Distributions 				ad.port_actions = psattr->psa_ports;
2767*e7776783SApple OSS Distributions 				ad.port_actions_size = psact_size;
2768*e7776783SApple OSS Distributions 			}
2769*e7776783SApple OSS Distributions 			if (psattr->psa_mac_extensions != NULL) {
2770*e7776783SApple OSS Distributions 				size_t macext_size = PS_MAC_EXTENSIONS_SIZE(psattr->psa_mac_extensions->psmx_count);
2771*e7776783SApple OSS Distributions 				if (macext_size == 0 && psattr->psa_mac_extensions->psmx_count != 0) {
2772*e7776783SApple OSS Distributions 					errno = EINVAL;
2773*e7776783SApple OSS Distributions 					ret = -1;
2774*e7776783SApple OSS Distributions 					goto out;
2775*e7776783SApple OSS Distributions 				}
2776*e7776783SApple OSS Distributions 				ad.mac_extensions = psattr->psa_mac_extensions;
2777*e7776783SApple OSS Distributions 				ad.mac_extensions_size = macext_size;
2778*e7776783SApple OSS Distributions 			}
2779*e7776783SApple OSS Distributions 			if (psattr->psa_coalition_info != NULL) {
2780*e7776783SApple OSS Distributions 				ad.coal_info_size = sizeof(struct _posix_spawn_coalition_info);
2781*e7776783SApple OSS Distributions 				ad.coal_info = psattr->psa_coalition_info;
2782*e7776783SApple OSS Distributions 			}
2783*e7776783SApple OSS Distributions 			if (psattr->psa_persona_info != NULL) {
2784*e7776783SApple OSS Distributions 				ad.persona_info_size = sizeof(struct _posix_spawn_persona_info);
2785*e7776783SApple OSS Distributions 				ad.persona_info = psattr->psa_persona_info;
2786*e7776783SApple OSS Distributions 			}
2787*e7776783SApple OSS Distributions 			if (psattr->psa_posix_cred_info != NULL) {
2788*e7776783SApple OSS Distributions 				ad.posix_cred_info_size = sizeof(struct _posix_spawn_posix_cred_info);
2789*e7776783SApple OSS Distributions 				ad.posix_cred_info = psattr->psa_posix_cred_info;
2790*e7776783SApple OSS Distributions 			}
2791*e7776783SApple OSS Distributions 			if (psattr->psa_subsystem_root_path != NULL) {
2792*e7776783SApple OSS Distributions 				ad.subsystem_root_path_size = MAXPATHLEN;
2793*e7776783SApple OSS Distributions 				ad.subsystem_root_path = psattr->psa_subsystem_root_path;
2794*e7776783SApple OSS Distributions 			}
2795*e7776783SApple OSS Distributions 		}
2796*e7776783SApple OSS Distributions 		if (file_actions != NULL && *file_actions != NULL) {
2797*e7776783SApple OSS Distributions 			_posix_spawn_file_actions_t psactsp =
2798*e7776783SApple OSS Distributions 			    *(_posix_spawn_file_actions_t *)file_actions;
2799*e7776783SApple OSS Distributions 
2800*e7776783SApple OSS Distributions 			if (psactsp->psfa_act_count > 0) {
2801*e7776783SApple OSS Distributions 				size_t fa_size = PSF_ACTIONS_SIZE(psactsp->psfa_act_count);
2802*e7776783SApple OSS Distributions 				if (fa_size == 0 && psactsp->psfa_act_count != 0) {
2803*e7776783SApple OSS Distributions 					errno = EINVAL;
2804*e7776783SApple OSS Distributions 					ret = -1;
2805*e7776783SApple OSS Distributions 					goto out;
2806*e7776783SApple OSS Distributions 				}
2807*e7776783SApple OSS Distributions 				ad.file_actions_size = fa_size;
2808*e7776783SApple OSS Distributions 				ad.file_actions = psactsp;
2809*e7776783SApple OSS Distributions 			}
2810*e7776783SApple OSS Distributions 		}
2811*e7776783SApple OSS Distributions 	}
2812*e7776783SApple OSS Distributions 
2813*e7776783SApple OSS Distributions 	if (!posix_spawn_with_filter ||
2814*e7776783SApple OSS Distributions 	    !posix_spawn_with_filter(pid, path, argv, envp, adp, &ret)) {
2815*e7776783SApple OSS Distributions 		ret = __posix_spawn(pid, path, adp, argv, envp);
2816*e7776783SApple OSS Distributions 	}
2817*e7776783SApple OSS Distributions 
2818*e7776783SApple OSS Distributions out:
2819*e7776783SApple OSS Distributions 	if (ret < 0) {
2820*e7776783SApple OSS Distributions 		ret = errno;
2821*e7776783SApple OSS Distributions 	}
2822*e7776783SApple OSS Distributions 	errno = saveerrno;
2823*e7776783SApple OSS Distributions 	return ret;
2824*e7776783SApple OSS Distributions }
2825*e7776783SApple OSS Distributions 
2826*e7776783SApple OSS Distributions int
execve(const char * fname,char * const * argp,char * const * envp)2827*e7776783SApple OSS Distributions execve(const char *fname, char * const *argp, char * const *envp)
2828*e7776783SApple OSS Distributions {
2829*e7776783SApple OSS Distributions 	int ret;
2830*e7776783SApple OSS Distributions 	if (execve_with_filter) {
2831*e7776783SApple OSS Distributions 		/* Noinline slow path to avoid a large stack frame in the common case */
2832*e7776783SApple OSS Distributions 		return execve_with_filter(fname, argp, envp);
2833*e7776783SApple OSS Distributions 	}
2834*e7776783SApple OSS Distributions 
2835*e7776783SApple OSS Distributions 	ret = __execve(fname, argp, envp);
2836*e7776783SApple OSS Distributions 	return ret;
2837*e7776783SApple OSS Distributions }
2838