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