2 * Copyright (c) 2006-2012 Apple Inc. All rights reserved.
4 * @APPLE_LICENSE_HEADER_START@
6 * This file contains Original Code and/or Modifications of Original Code
7 * as defined in and that are subject to the Apple Public Source License
8 * Version 2.0 (the 'License'). You may not use this file except in
9 * compliance with the License. Please obtain a copy of the License at
10 * http://www.opensource.apple.com/apsl/ and read it before using this
13 * The Original Code and all software distributed under the License are
14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
18 * Please see the License for the specific language governing rights and
19 * limitations under the License.
21 * @APPLE_LICENSE_HEADER_END@
25 * [SPN] Support for _POSIX_SPAWN
28 #define CONFIG_MEMORYSTATUS 1 // <rdar://problem/13604997>
29 #include <sys/types.h> /* for user_size_t */
31 #include <spawn_private.h>
32 #include <sys/spawn_internal.h>
33 #include <sys/process_policy.h>
36 #include <limits.h> /* for OPEN_MAX, PATH_MAX */
39 #include <mach/port.h>
40 #include <mach/exception_types.h>
41 #include <mach/coalition.h> /* for COALITION_TYPE_MAX */
42 #include <sys/kern_memorystatus.h>
45 * posix_spawnattr_init
47 * Description: Initialize a spawn attributes object attr with default values
49 * Parameters: attr The spawn attributes object to be
53 * ENOMEM Insufficient memory exists to
54 * initialize the spawn attributes object.
56 * Note: As an implementation detail, the externally visibily type
57 * posix_spawnattr_t is defined to be a void *, and initialization
58 * involves allocation of a memory object. Subsequent changes to
59 * the spawn attributes may result in reallocation under the
62 * Reinitialization of an already initialized spawn attributes
63 * object will result in memory being leaked. Because spawn
64 * attributes are not required to be used in conjunction with a
65 * static initializer, there is no way to distinguish a spawn
66 * attribute with stack garbage from one that's been initialized.
67 * This is arguably an API design error.
70 posix_spawnattr_init(posix_spawnattr_t
*attr
)
72 _posix_spawnattr_t
*psattrp
= (_posix_spawnattr_t
*)attr
;
75 if ((*psattrp
= (_posix_spawnattr_t
)malloc(sizeof(struct _posix_spawnattr
))) == NULL
) {
80 * The default value of this attribute shall be as if no
83 (*psattrp
)->psa_flags
= 0;
86 * The default value of this attribute shall be an empty
89 (*psattrp
)->psa_sigdefault
= 0;
91 /* The default value of this attribute is unspecified */
92 (*psattrp
)->psa_sigmask
= 0;
94 /* The default value of this attribute shall be zero */
95 (*psattrp
)->psa_pgroup
= 0; /* doesn't matter */
97 /* Default is no binary preferences, i.e. use normal grading */
98 memset((*psattrp
)->psa_binprefs
, 0,
99 sizeof((*psattrp
)->psa_binprefs
));
101 /* Default is no port actions to take */
102 (*psattrp
)->psa_ports
= NULL
;
105 * The default value of this attribute shall be an no
106 * process control on resource starvation
108 (*psattrp
)->psa_pcontrol
= 0;
111 * Initializing the alignment paddings.
114 (*psattrp
)->short_padding
= 0;
115 (*psattrp
)->flags_padding
= 0;
117 /* Default is no new apptype requested */
118 (*psattrp
)->psa_apptype
= POSIX_SPAWN_PROCESS_TYPE_DEFAULT
;
121 (*psattrp
)->psa_jetsam_flags
= 0;
122 (*psattrp
)->psa_priority
= -1;
123 (*psattrp
)->psa_memlimit_active
= -1;
124 (*psattrp
)->psa_memlimit_inactive
= -1;
126 /* Default is no CPU usage monitor active. */
127 (*psattrp
)->psa_cpumonitor_percent
= 0;
128 (*psattrp
)->psa_cpumonitor_interval
= 0;
130 /* Default is no MAC policy extensions. */
131 (*psattrp
)->psa_mac_extensions
= NULL
;
133 /* Default is to inherit parent's coalition(s) */
134 (*psattrp
)->psa_coalition_info
= NULL
;
136 (*psattrp
)->psa_persona_info
= NULL
;
139 * old coalition field
140 * For backwards compatibility reasons, we set this to 1
141 * which is the first valid coalition id. This will allow
142 * newer user space code to properly spawn processes on
144 * (they will just all end up in the same coalition).
146 (*psattrp
)->psa_reserved
= 1;
148 /* Default is no new clamp */
149 (*psattrp
)->psa_qos_clamp
= POSIX_SPAWN_PROC_CLAMP_NONE
;
151 /* Default is no change to role */
152 (*psattrp
)->psa_darwin_role
= POSIX_SPAWN_DARWIN_ROLE_NONE
;
160 * posix_spawnattr_destroy
162 * Description: Destroy a spawn attributes object that was previously
163 * initialized via posix_spawnattr_init() by freeing any
164 * memory associated with it and setting it to an invalid value.
166 * Parameters: attr The spawn attributes object to be
171 * Notes: The destroyed spawn attribute results in the void * pointer
172 * being set to NULL; subsequent use without reinitialization
173 * will result in explicit program failure (rather than merely
174 * "undefined behaviour").
176 * NOTIMP: Allowed failures (checking NOT required):
177 * EINVAL The value specified by attr is invalid.
179 static int posix_spawn_destroyportactions_np(posix_spawnattr_t
*);
180 static int posix_spawn_destroycoalition_info_np(posix_spawnattr_t
*);
181 static int posix_spawn_destroypersona_info_np(posix_spawnattr_t
*);
184 posix_spawnattr_destroy(posix_spawnattr_t
*attr
)
186 _posix_spawnattr_t psattr
;
188 if (attr
== NULL
|| *attr
== NULL
)
191 psattr
= *(_posix_spawnattr_t
*)attr
;
192 posix_spawn_destroyportactions_np(attr
);
193 posix_spawn_destroycoalition_info_np(attr
);
194 posix_spawn_destroypersona_info_np(attr
);
204 * posix_spawnattr_setflags
206 * Description: Set the spawn flags attribute for the spawn attribute object
207 * referred to by 'attr'.
209 * Parameters: attr The spawn attributes object whose flags
211 * flags The flags value to set
215 * NOTIMP: Allowed failures (checking NOT required):
216 * EINVAL The value specified by attr is invalid.
217 * EINVAL The value of the attribute being set is not valid.
220 posix_spawnattr_setflags(posix_spawnattr_t
*attr
, short flags
)
222 _posix_spawnattr_t psattr
;
224 if (attr
== NULL
|| *attr
== NULL
)
227 psattr
= *(_posix_spawnattr_t
*)attr
;
228 psattr
->psa_flags
= flags
;
235 * posix_spawnattr_getflags
237 * Description: Retrieve the spawn attributes flag for the spawn attributes
238 * object referenced by 'attr' and place them in the memory
239 * location referenced by 'flagsp'
241 * Parameters: attr The spawn attributes object whose flags
242 * are to be retrieved
243 * flagsp A pointer to a short value to receive
249 * *flagps (modified) The flags value from the spawn
252 * NOTIMP: Allowed failures (checking NOT required):
253 * EINVAL The value specified by attr is invalid.
254 * EINVAL The value of the attribute being set is not valid.
257 posix_spawnattr_getflags(const posix_spawnattr_t
* __restrict attr
,
258 short * __restrict flagsp
)
260 _posix_spawnattr_t psattr
;
262 if (attr
== NULL
|| *attr
== NULL
)
265 psattr
= *(_posix_spawnattr_t
*)attr
;
266 *flagsp
= psattr
->psa_flags
;
273 * posix_spawnattr_getsigdefault
275 * Description: Retrieve the set of signals to be set to default according to
276 * the spawn attribute value referenced by 'attr' and place the
277 * result into the memory containing the sigset_t referenced by
280 * Parameters: attr The spawn attributes object whose
281 * signal set for default signals is to
283 * sigdefault A pointer to the sigset_t to receive
289 * *sigdefault (modified) The signal set of signals to default
290 * from the spawn attributes object
293 posix_spawnattr_getsigdefault(const posix_spawnattr_t
* __restrict attr
,
294 sigset_t
* __restrict sigdefault
)
296 _posix_spawnattr_t psattr
;
298 if (attr
== NULL
|| *attr
== NULL
)
301 psattr
= *(_posix_spawnattr_t
*)attr
;
302 *sigdefault
= psattr
->psa_sigdefault
;
309 * posix_spawnattr_getpgroup
311 * Description: Obtain the value of the spawn process group attribute from the
312 * spawn attributes object referenced by 'attr' and place the
313 * results in the memory location referenced by 'pgroup'
315 * Parameters: attr The spawn attributes object whose
316 * process group information is to be
318 * pgroup A pointer to the pid_t to receive the
324 * *pgroup (modified) The process group information from the
325 * spawn attributes object
328 posix_spawnattr_getpgroup(const posix_spawnattr_t
* __restrict attr
,
329 pid_t
* __restrict pgroup
)
331 _posix_spawnattr_t psattr
;
333 if (attr
== NULL
|| *attr
== NULL
)
336 psattr
= *(_posix_spawnattr_t
*)attr
;
337 *pgroup
= psattr
->psa_pgroup
;
344 * posix_spawnattr_getsigmask
346 * Description: Obtain the value of the spawn signal mask attribute from the
347 * spawn attributes object referenced by 'attr' and place the
348 * result into the memory containing the sigset_t referenced by
351 * Parameters: attr The spawn attributes object whose
352 * signal set for masked signals is to
354 * sigmask A pointer to the sigset_t to receive
360 * *sigmask (modified) The signal set of signals to mask
361 * from the spawn attributes object
364 posix_spawnattr_getsigmask(const posix_spawnattr_t
* __restrict attr
,
365 sigset_t
* __restrict sigmask
)
367 _posix_spawnattr_t psattr
;
369 if (attr
== NULL
|| *attr
== NULL
)
372 psattr
= *(_posix_spawnattr_t
*)attr
;
373 *sigmask
= psattr
->psa_sigmask
;
379 * posix_spawnattr_getbinpref_np
381 * Description: Obtain the value of the spawn binary preferences attribute from
382 * the spawn attributes object referenced by 'attr' and place the
383 * result into the memory referenced by 'pref'.
385 * Parameters: attr The spawn attributes object whose
386 * binary preferences are to be retrieved
387 * count The size of the cpu_type_t array
388 * pref An array of cpu types
389 * ocount The actual number copied
391 * Returns: 0 No binary preferences found
392 * > 0 The number of cpu types (less than
393 * count) copied over from 'attr'.
396 * *pref (modified) The binary preferences array
397 * from the spawn attributes object
400 posix_spawnattr_getbinpref_np(const posix_spawnattr_t
* __restrict attr
,
401 size_t count
, cpu_type_t
*pref
, size_t * __restrict ocount
)
403 _posix_spawnattr_t psattr
;
406 if (attr
== NULL
|| *attr
== NULL
)
409 psattr
= *(_posix_spawnattr_t
*)attr
;
410 for (i
= 0; i
< count
&& i
< 4; i
++) {
411 pref
[i
] = psattr
->psa_binprefs
[i
];
421 * posix_spawnattr_getpcontrol_np
423 * Description: Retrieve the process control property set default according to
424 * the spawn attribute value referenced by 'attr' and place the
425 * result into the memory containing the control referenced by
428 * Parameters: attr The spawn attributes object whose
429 * signal set for default signals is to
431 * pcontrol A pointer to an int to receive
432 * the process control info
437 * *pcontrol (modified) The signal set of signals to default
438 * from the spawn attributes object
441 posix_spawnattr_getpcontrol_np(const posix_spawnattr_t
* __restrict attr
,
442 int * __restrict pcontrol
)
444 _posix_spawnattr_t psattr
;
446 if (attr
== NULL
|| *attr
== NULL
)
449 psattr
= *(_posix_spawnattr_t
*)attr
;
450 *pcontrol
= psattr
->psa_pcontrol
;
456 * posix_spawnattr_getprocesstype_np
458 * Description: Retrieve the process specific behaviors and app launch types
459 * spawn attribute value referenced by 'attr' and place the
460 * result into the memory containing the control referenced by
463 * Parameters: attr The spawn attributes object whose
464 * signal set for default signals is to
466 * proctype A pointer to an int to receive
467 * the process type info
472 * *proctype (modified) The process type set to value
473 * from the spawn attributes object
476 posix_spawnattr_getprocesstype_np(const posix_spawnattr_t
* __restrict attr
,
477 int * __restrict proctype
)
479 _posix_spawnattr_t psattr
;
481 if (attr
== NULL
|| *attr
== NULL
)
484 psattr
= *(_posix_spawnattr_t
*)attr
;
485 *proctype
= psattr
->psa_apptype
;
490 * posix_spawnattr_setsigdefault
492 * Description: Set the set of signals to be set to default for the spawn
493 * attribute value referenced by 'attr' from the memory
494 * containing the sigset_t referenced by 'sigdefault'
496 * Parameters: attr The spawn attributes object whose
497 * signal set for default signals is to
499 * sigdefault A pointer to the sigset_t from which to
500 * obtain the signal set
505 posix_spawnattr_setsigdefault(posix_spawnattr_t
* __restrict attr
,
506 const sigset_t
* __restrict sigdefault
)
508 _posix_spawnattr_t psattr
;
510 if (attr
== NULL
|| *attr
== NULL
)
513 psattr
= *(_posix_spawnattr_t
*)attr
;
514 psattr
->psa_sigdefault
= *sigdefault
;
521 * posix_spawnattr_setpgroup
523 * Description: Set the value of the spawn process group attribute for the
524 * spawn attributes object referenced by 'attr' from the value
527 * Parameters: attr The spawn attributes object for which
528 * the process group information is to be
530 * pgroup The process group to set
535 posix_spawnattr_setpgroup(posix_spawnattr_t
* attr
, pid_t pgroup
)
537 _posix_spawnattr_t psattr
;
539 if (attr
== NULL
|| *attr
== NULL
)
542 psattr
= *(_posix_spawnattr_t
*)attr
;
543 psattr
->psa_pgroup
= pgroup
;
550 * posix_spawnattr_setsigmask
552 * Description: Set the set of signals to be masked for the spawn attribute
553 * value referenced by 'attr' from the memory containing the
554 * sigset_t referenced by 'sigmask'
556 * Parameters: attr The spawn attributes object whose
557 * signal set for masked signals is to
559 * sigmask A pointer to the sigset_t from which to
560 * obtain the signal set
565 posix_spawnattr_setsigmask(posix_spawnattr_t
* __restrict attr
,
566 const sigset_t
* __restrict sigmask
)
568 _posix_spawnattr_t psattr
;
570 if (attr
== NULL
|| *attr
== NULL
)
573 psattr
= *(_posix_spawnattr_t
*)attr
;
574 psattr
->psa_sigmask
= *sigmask
;
581 * posix_spawnattr_setbinpref_np
583 * Description: Set the universal binary preferences for the spawn attribute
584 * value referenced by 'attr' from the memory containing the
585 * cpu_type_t array referenced by 'pref', size of 'count'
587 * Parameters: attr The spawn attributes object whose
588 * binary preferences are to be set
589 * count Size of the array pointed to by 'pref'
590 * pref cpu_type_t array of binary preferences
591 * ocount The actual number copied
593 * Returns: 0 No preferences copied
594 * > 0 Number of preferences copied
596 * Note: The posix_spawnattr_t currently only holds four cpu_type_t's.
597 * If the caller provides more preferences than this limit, they
598 * will be ignored, as reflected in the return value.
601 posix_spawnattr_setbinpref_np(posix_spawnattr_t
* __restrict attr
,
602 size_t count
, cpu_type_t
*pref
, size_t * __restrict ocount
)
604 _posix_spawnattr_t psattr
;
607 if (attr
== NULL
|| *attr
== NULL
)
610 psattr
= *(_posix_spawnattr_t
*)attr
;
611 for (i
= 0; i
< count
&& i
< 4; i
++) {
612 psattr
->psa_binprefs
[i
] = pref
[i
];
615 /* return number of binprefs copied over */
623 * posix_spawnattr_setpcontrol_np
625 * Description: Set the process control property according to
626 * attribute value referenced by 'attr' from the memory
627 * containing the int value 'pcontrol'
629 * Parameters: attr The spawn attributes object whose
630 * signal set for default signals is to
632 * pcontrol An int value of the process control info
637 posix_spawnattr_setpcontrol_np(posix_spawnattr_t
* __restrict attr
,
640 _posix_spawnattr_t psattr
;
642 if (attr
== NULL
|| *attr
== NULL
)
645 psattr
= *(_posix_spawnattr_t
*)attr
;
646 psattr
->psa_pcontrol
= pcontrol
;
653 * posix_spawnattr_setprocesstype_np
655 * Description: Set the process specific behaviors and app launch type
656 * attribute value referenced by 'attr' from the memory
657 * containing the int value 'proctype'
659 * Parameters: attr The spawn attributes object whose
660 * signal set for default signals is to
662 * proctype An int value of the process type info
667 posix_spawnattr_setprocesstype_np(posix_spawnattr_t
* __restrict attr
,
670 _posix_spawnattr_t psattr
;
672 if (attr
== NULL
|| *attr
== NULL
)
675 psattr
= *(_posix_spawnattr_t
*)attr
;
676 psattr
->psa_apptype
= proctype
;
682 * posix_spawn_createportactions_np
683 * Description: create a new posix_spawn_port_actions struct and link
684 * it into the posix_spawnattr.
687 posix_spawn_createportactions_np(posix_spawnattr_t
*attr
)
689 _posix_spawnattr_t psattr
;
690 _posix_spawn_port_actions_t acts
;
692 if (attr
== NULL
|| *attr
== NULL
)
695 psattr
= *(_posix_spawnattr_t
*)attr
;
696 acts
= (_posix_spawn_port_actions_t
)malloc(PS_PORT_ACTIONS_SIZE(2));
700 acts
->pspa_alloc
= 2;
701 acts
->pspa_count
= 0;
703 psattr
->psa_ports
= acts
;
708 * posix_spawn_growportactions_np
709 * Description: Enlarge the size of portactions if necessary
712 posix_spawn_growportactions_np(posix_spawnattr_t
*attr
)
714 _posix_spawnattr_t psattr
;
715 _posix_spawn_port_actions_t acts
;
718 if (attr
== NULL
|| *attr
== NULL
)
721 psattr
= *(_posix_spawnattr_t
*)attr
;
722 acts
= psattr
->psa_ports
;
726 /* Double number of port actions allocated for */
727 newnum
= 2 * acts
->pspa_alloc
;
728 acts
= realloc(acts
, PS_PORT_ACTIONS_SIZE(newnum
));
732 acts
->pspa_alloc
= newnum
;
733 psattr
->psa_ports
= acts
;
738 * posix_spawn_destroyportactions_np
739 * Description: clean up portactions struct in posix_spawnattr_t attr
742 posix_spawn_destroyportactions_np(posix_spawnattr_t
*attr
)
744 _posix_spawnattr_t psattr
;
745 _posix_spawn_port_actions_t acts
;
747 if (attr
== NULL
|| *attr
== NULL
)
750 psattr
= *(_posix_spawnattr_t
*)attr
;
751 acts
= psattr
->psa_ports
;
760 * posix_spawn_destroycoalition_info_np
761 * Description: clean up coalition_info struct in posix_spawnattr_t attr
764 posix_spawn_destroycoalition_info_np(posix_spawnattr_t
*attr
)
766 _posix_spawnattr_t psattr
;
767 struct _posix_spawn_coalition_info
*coal_info
;
769 if (attr
== NULL
|| *attr
== NULL
)
772 psattr
= *(_posix_spawnattr_t
*)attr
;
773 coal_info
= psattr
->psa_coalition_info
;
774 if (coal_info
== NULL
)
777 psattr
->psa_coalition_info
= NULL
;
783 * posix_spawn_destroypersona_info_np
784 * Description: clean up persona_info struct in posix_spawnattr_t attr
787 posix_spawn_destroypersona_info_np(posix_spawnattr_t
*attr
)
789 _posix_spawnattr_t psattr
;
790 struct _posix_spawn_persona_info
*persona
;
792 if (attr
== NULL
|| *attr
== NULL
)
795 psattr
= *(_posix_spawnattr_t
*)attr
;
796 persona
= psattr
->psa_persona_info
;
800 psattr
->psa_persona_info
= NULL
;
806 * posix_spawn_appendportaction_np
807 * Description: append a port action, grow the array if necessary
810 posix_spawn_appendportaction_np(posix_spawnattr_t
*attr
, _ps_port_action_t
*act
)
812 _posix_spawnattr_t psattr
;
813 _posix_spawn_port_actions_t acts
;
815 if (attr
== NULL
|| *attr
== NULL
|| act
== NULL
) {
819 psattr
= *(_posix_spawnattr_t
*)attr
;
820 acts
= psattr
->psa_ports
;
822 // Have any port actions been created yet?
824 int err
= posix_spawn_createportactions_np(attr
);
828 acts
= psattr
->psa_ports
;
831 // Is there enough room?
832 if (acts
->pspa_alloc
== acts
->pspa_count
) {
833 int err
= posix_spawn_growportactions_np(attr
);
837 acts
= psattr
->psa_ports
;
840 // Add this action to next spot in array
841 acts
->pspa_actions
[acts
->pspa_count
] = *act
;
848 * posix_spawnattr_setspecialport_np
850 * Description: Set a new value for a mach special port in the spawned task.
852 * Parameters: attr The spawn attributes object for the
854 * new_port The new value for the special port
855 * which The particular port to be set
856 * (see task_set_special_port for details)
859 * ENOMEM Couldn't allocate memory
862 posix_spawnattr_setspecialport_np(
863 posix_spawnattr_t
*attr
,
864 mach_port_t new_port
,
867 _ps_port_action_t action
= {
868 .port_type
= PSPA_SPECIAL
,
869 .new_port
= new_port
,
872 return posix_spawn_appendportaction_np(attr
, &action
);
876 * posix_spawnattr_setexceptionports_np
878 * Description: Set a new port for a set of exception ports in the spawned task.
880 * Parameters: attr The spawn attributes object for the
882 * mask A bitfield indicating which exceptions
883 * to associate the port with
884 * new_port The new value for the exception port
885 * behavior The default behavior for the port
886 * flavor The default flavor for the port
887 * (see task_set_exception_ports)
892 posix_spawnattr_setexceptionports_np(
893 posix_spawnattr_t
*attr
,
894 exception_mask_t mask
,
895 mach_port_t new_port
,
896 exception_behavior_t behavior
,
897 thread_state_flavor_t flavor
)
899 _ps_port_action_t action
= {
900 .port_type
= PSPA_EXCEPTION
,
902 .new_port
= new_port
,
903 .behavior
= behavior
,
906 return posix_spawn_appendportaction_np(attr
, &action
);
910 * posix_spawnattr_setauditsessionport_np
912 * Description: Set the audit session port rights attribute in the spawned task.
913 * This is used to securely set the audit session information for
916 * Parameters: attr The spawn attributes object for the
918 * au_sessionport The audit session send port right
923 posix_spawnattr_setauditsessionport_np(
924 posix_spawnattr_t
*attr
,
925 mach_port_t au_sessionport
)
927 _ps_port_action_t action
= {
928 .port_type
= PSPA_AU_SESSION
,
929 .new_port
= au_sessionport
,
931 return posix_spawn_appendportaction_np(attr
, &action
);
936 * posix_spawn_file_actions_init
938 * Description: Initialize a spawn file actions object attr with default values
940 * Parameters: file_actions The spawn file actions object to be
944 * ENOMEM Insufficient memory exists to
945 * initialize the spawn file actions
948 * Note: As an implementation detail, the externally visibily type
949 * posix_spawn_file_actions_t is defined to be a void *, and
950 * initialization involves allocation of a memory object.
951 * Subsequent changes to the spawn file actions may result in
952 * reallocation under the covers.
954 * Reinitialization of an already initialized spawn file actions
955 * object will result in memory being leaked. Because spawn
956 * file actions are not required to be used in conjunction with a
957 * static initializer, there is no way to distinguish a spawn
958 * file actions with stack garbage from one that's been
959 * initialized. This is arguably an API design error.
962 posix_spawn_file_actions_init(posix_spawn_file_actions_t
*file_actions
)
964 _posix_spawn_file_actions_t
*psactsp
= (_posix_spawn_file_actions_t
*)file_actions
;
967 if ((*psactsp
= (_posix_spawn_file_actions_t
)malloc(PSF_ACTIONS_SIZE(PSF_ACTIONS_INIT_COUNT
))) == NULL
) {
970 (*psactsp
)->psfa_act_alloc
= PSF_ACTIONS_INIT_COUNT
;
971 (*psactsp
)->psfa_act_count
= 0;
979 * posix_spawn_file_actions_destroy
981 * Description: Destroy a spawn file actions object that was previously
982 * initialized via posix_spawn_file_actions_init() by freeing any
983 * memory associated with it and setting it to an invalid value.
985 * Parameters: attr The spawn file actions object to be
990 * Notes: The destroyed spawn file actions results in the void * pointer
991 * being set to NULL; subsequent use without reinitialization
992 * will result in explicit program failure (rather than merely
993 * "undefined behaviour").
995 * NOTIMP: Allowed failures (checking NOT required):
996 * EINVAL The value specified by file_actions is invalid.
999 posix_spawn_file_actions_destroy(posix_spawn_file_actions_t
*file_actions
)
1001 _posix_spawn_file_actions_t psacts
;
1003 if (file_actions
== NULL
|| *file_actions
== NULL
)
1006 psacts
= *(_posix_spawn_file_actions_t
*)file_actions
;
1008 *file_actions
= NULL
;
1015 * _posix_spawn_file_actions_grow
1017 * Description: Grow the available list of file actions associated with the
1018 * pointer to the structure provided; replace the contents of the
1019 * pointer as a side effect.
1021 * Parameters: psactsp Pointer to _posix_spawn_file_actions_t
1024 * Returns: 0 Success
1025 * ENOMEM Insufficient memory for operation
1027 * Notes: This code is common to all posix_spawn_file_actions_*()
1028 * functions, since we use a naieve data structure implementation
1029 * at present. Future optimization will likely change this.
1032 _posix_spawn_file_actions_grow(_posix_spawn_file_actions_t
*psactsp
)
1034 int new_alloc
= (*psactsp
)->psfa_act_alloc
* 2;
1035 _posix_spawn_file_actions_t new_psacts
;
1038 * XXX may want to impose an administrative limit here; POSIX does
1039 * XXX not provide for an administrative error return in this case,
1040 * XXX so it's probably acceptable to just fail catastrophically
1041 * XXX instead of implementing one.
1043 if ((new_psacts
= (_posix_spawn_file_actions_t
)realloc((*psactsp
), PSF_ACTIONS_SIZE(new_alloc
))) == NULL
) {
1046 new_psacts
->psfa_act_alloc
= new_alloc
;
1047 *psactsp
= new_psacts
;
1054 * posix_spawn_file_actions_addopen
1056 * Description: Add an open action to the object referenced by 'file_actions'
1057 * that will cause the file named by 'path' to be attempted to be
1058 * opened with flags 'oflag' and mode 'mode', and, if successful,
1059 * return as descriptor 'filedes' to the spawned process.
1061 * Parameters: file_actions File action object to augment
1062 * filedes fd that open is to use
1063 * path path to file to open
1064 * oflag open file flags
1065 * mode open file mode
1067 * Returns: 0 Success
1068 * EBADF The value specified by fildes is
1069 * negative or greater than or equal to
1071 * ENOMEM Insufficient memory exists to add to
1072 * the spawn file actions object.
1074 * NOTIMP: Allowed failures (checking NOT required):
1075 * EINVAL The value specified by file_actions is invalid.
1078 posix_spawn_file_actions_addopen(
1079 posix_spawn_file_actions_t
* __restrict file_actions
,
1080 int filedes
, const char * __restrict path
, int oflag
,
1083 _posix_spawn_file_actions_t
*psactsp
;
1084 _psfa_action_t
*psfileact
;
1086 if (file_actions
== NULL
|| *file_actions
== NULL
)
1089 psactsp
= (_posix_spawn_file_actions_t
*)file_actions
;
1090 /* Range check; required by POSIX */
1091 if (filedes
< 0 || filedes
>= OPEN_MAX
)
1094 /* If we do not have enough slots, grow the structure */
1095 if ((*psactsp
)->psfa_act_count
== (*psactsp
)->psfa_act_alloc
) {
1096 /* need to grow file actions structure */
1097 if (_posix_spawn_file_actions_grow(psactsp
))
1102 * Allocate next available slot and fill it out
1104 psfileact
= &(*psactsp
)->psfa_act_acts
[(*psactsp
)->psfa_act_count
++];
1106 psfileact
->psfaa_type
= PSFA_OPEN
;
1107 psfileact
->psfaa_filedes
= filedes
;
1108 psfileact
->psfaa_openargs
.psfao_oflag
= oflag
;
1109 psfileact
->psfaa_openargs
.psfao_mode
= mode
;
1110 strlcpy(psfileact
->psfaa_openargs
.psfao_path
, path
, PATH_MAX
);
1117 * posix_spawn_file_actions_addclose
1119 * Description: Add a close action to the object referenced by 'file_actions'
1120 * that will cause the file referenced by 'filedes' to be
1121 * attempted to be closed in the spawned process.
1123 * Parameters: file_actions File action object to augment
1124 * filedes fd to close
1126 * Returns: 0 Success
1127 * EBADF The value specified by fildes is
1128 * negative or greater than or equal to
1130 * ENOMEM Insufficient memory exists to add to
1131 * the spawn file actions object.
1133 * NOTIMP: Allowed failures (checking NOT required):
1134 * EINVAL The value specified by file_actions is invalid.
1137 posix_spawn_file_actions_addclose(posix_spawn_file_actions_t
*file_actions
,
1140 _posix_spawn_file_actions_t
*psactsp
;
1141 _psfa_action_t
*psfileact
;
1143 if (file_actions
== NULL
|| *file_actions
== NULL
)
1146 psactsp
= (_posix_spawn_file_actions_t
*)file_actions
;
1147 /* Range check; required by POSIX */
1148 if (filedes
< 0 || filedes
>= OPEN_MAX
)
1151 /* If we do not have enough slots, grow the structure */
1152 if ((*psactsp
)->psfa_act_count
== (*psactsp
)->psfa_act_alloc
) {
1153 /* need to grow file actions structure */
1154 if (_posix_spawn_file_actions_grow(psactsp
))
1159 * Allocate next available slot and fill it out
1161 psfileact
= &(*psactsp
)->psfa_act_acts
[(*psactsp
)->psfa_act_count
++];
1163 psfileact
->psfaa_type
= PSFA_CLOSE
;
1164 psfileact
->psfaa_filedes
= filedes
;
1171 * posix_spawn_file_actions_adddup2
1173 * Description: Add a dup2 action to the object referenced by 'file_actions'
1174 * that will cause the file referenced by 'filedes' to be
1175 * attempted to be dup2'ed to the descriptor 'newfiledes' in the
1178 * Parameters: file_actions File action object to augment
1179 * filedes fd to dup2
1180 * newfiledes fd to dup2 it to
1182 * Returns: 0 Success
1183 * EBADF The value specified by either fildes
1184 * or by newfiledes is negative or greater
1185 * than or equal to {OPEN_MAX}.
1186 * ENOMEM Insufficient memory exists to add to
1187 * the spawn file actions object.
1189 * NOTIMP: Allowed failures (checking NOT required):
1190 * EINVAL The value specified by file_actions is invalid.
1193 posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t
*file_actions
,
1194 int filedes
, int newfiledes
)
1196 _posix_spawn_file_actions_t
*psactsp
;
1197 _psfa_action_t
*psfileact
;
1199 if (file_actions
== NULL
|| *file_actions
== NULL
)
1202 psactsp
= (_posix_spawn_file_actions_t
*)file_actions
;
1203 /* Range check; required by POSIX */
1204 if (filedes
< 0 || filedes
>= OPEN_MAX
||
1205 newfiledes
< 0 || newfiledes
>= OPEN_MAX
)
1208 /* If we do not have enough slots, grow the structure */
1209 if ((*psactsp
)->psfa_act_count
== (*psactsp
)->psfa_act_alloc
) {
1210 /* need to grow file actions structure */
1211 if (_posix_spawn_file_actions_grow(psactsp
))
1216 * Allocate next available slot and fill it out
1218 psfileact
= &(*psactsp
)->psfa_act_acts
[(*psactsp
)->psfa_act_count
++];
1220 psfileact
->psfaa_type
= PSFA_DUP2
;
1221 psfileact
->psfaa_filedes
= filedes
;
1222 psfileact
->psfaa_openargs
.psfao_oflag
= newfiledes
;
1228 * posix_spawn_file_actions_addinherit_np
1230 * Description: Add the "inherit" action to the object referenced by
1231 * 'file_actions' that will cause the file referenced by
1232 * 'filedes' to continue to be available in the spawned
1233 * process via the same descriptor.
1235 * Inheritance is the normal default behaviour for
1236 * file descriptors across exec and spawn; but if the
1237 * POSIX_SPAWN_CLOEXEC_DEFAULT flag is set, the usual
1238 * default is reversed for the purposes of the spawn
1239 * invocation. Any pre-existing descriptors that
1240 * need to be made available to the spawned process can
1241 * be marked explicitly as 'inherit' via this interface.
1242 * Otherwise they will be automatically closed.
1244 * Note that any descriptors created via the other file
1245 * actions interfaces are automatically marked as 'inherit'.
1247 * Parameters: file_actions File action object to augment
1248 * filedes fd to inherit.
1250 * Returns: 0 Success
1251 * EBADF The value specified by fildes is
1252 * negative or greater than or equal to
1254 * ENOMEM Insufficient memory exists to add to
1255 * the spawn file actions object.
1257 * NOTIMP: Allowed failures (checking NOT required):
1258 * EINVAL The value specified by file_actions is invalid.
1261 posix_spawn_file_actions_addinherit_np(posix_spawn_file_actions_t
*file_actions
,
1264 _posix_spawn_file_actions_t
*psactsp
;
1265 _psfa_action_t
*psfileact
;
1267 if (file_actions
== NULL
|| *file_actions
== NULL
)
1270 psactsp
= (_posix_spawn_file_actions_t
*)file_actions
;
1271 /* Range check; required by POSIX */
1272 if (filedes
< 0 || filedes
>= OPEN_MAX
)
1275 #if defined(POSIX_SPAWN_CLOEXEC_DEFAULT) // TODO: delete this check
1276 /* If we do not have enough slots, grow the structure */
1277 if ((*psactsp
)->psfa_act_count
== (*psactsp
)->psfa_act_alloc
) {
1278 /* need to grow file actions structure */
1279 if (_posix_spawn_file_actions_grow(psactsp
))
1284 * Allocate next available slot and fill it out
1286 psfileact
= &(*psactsp
)->psfa_act_acts
[(*psactsp
)->psfa_act_count
++];
1288 psfileact
->psfaa_type
= PSFA_INHERIT
;
1289 psfileact
->psfaa_filedes
= filedes
;
1295 posix_spawnattr_setcpumonitor_default(posix_spawnattr_t
* __restrict attr
)
1297 return (posix_spawnattr_setcpumonitor(attr
, PROC_POLICY_CPUMON_DEFAULTS
, 0));
1301 posix_spawnattr_setcpumonitor(posix_spawnattr_t
* __restrict attr
,
1302 uint64_t percent
, uint64_t interval
)
1304 _posix_spawnattr_t psattr
;
1306 if (attr
== NULL
|| *attr
== NULL
)
1309 psattr
= *(_posix_spawnattr_t
*)attr
;
1311 psattr
->psa_cpumonitor_percent
= percent
;
1312 psattr
->psa_cpumonitor_interval
= interval
;
1318 posix_spawnattr_getcpumonitor(posix_spawnattr_t
* __restrict attr
,
1319 uint64_t *percent
, uint64_t *interval
)
1321 _posix_spawnattr_t psattr
;
1323 if (attr
== NULL
|| *attr
== NULL
)
1326 psattr
= *(_posix_spawnattr_t
*)attr
;
1328 *percent
= psattr
->psa_cpumonitor_percent
;
1329 *interval
= psattr
->psa_cpumonitor_interval
;
1336 * posix_spawnattr_setjetsam_ext
1338 * Description: Set jetsam attributes for the spawn attribute object
1339 * referred to by 'attr'.
1341 * Parameters: flags The flags value to set
1342 * priority Relative jetsam priority
1343 * memlimit_active Value in megabytes; memory footprint
1344 * above this level while process is
1345 * active may result in termination.
1346 * memlimit_inactive Value in megabytes; memory footprint
1347 * above this level while process is
1348 * inactive may result in termination.
1350 * Returns: 0 Success
1353 posix_spawnattr_setjetsam_ext(posix_spawnattr_t
* __restrict attr
,
1354 short flags
, int priority
, int memlimit_active
, int memlimit_inactive
)
1356 _posix_spawnattr_t psattr
;
1358 if (attr
== NULL
|| *attr
== NULL
)
1361 psattr
= *(_posix_spawnattr_t
*)attr
;
1363 psattr
->psa_jetsam_flags
= flags
;
1364 psattr
->psa_jetsam_flags
|= POSIX_SPAWN_JETSAM_SET
;
1365 psattr
->psa_priority
= priority
;
1366 psattr
->psa_memlimit_active
= memlimit_active
;
1367 psattr
->psa_memlimit_inactive
= memlimit_inactive
;
1374 * posix_spawnattr_set_importancewatch_port_np
1376 * Description: Mark ports referred to by these rights
1377 * to boost the new task instead of their current task
1378 * for the spawn attribute object referred to by 'attr'.
1379 * Ports must be valid at posix_spawn time. They will NOT be
1380 * consumed by the kernel, so they must be deallocated after the spawn returns.
1381 * (If you are SETEXEC-ing, they are cleaned up by the exec operation).
1383 * The maximum number of watch ports allowed is defined by POSIX_SPAWN_IMPORTANCE_PORT_COUNT.
1385 * Parameters: count Number of ports in portarray
1386 * portarray Array of rights
1388 * Returns: 0 Success
1389 * EINVAL Bad port count
1390 * ENOMEM Insufficient memory exists to add to
1391 * the spawn port actions object.
1394 posix_spawnattr_set_importancewatch_port_np(posix_spawnattr_t
* __restrict attr
,
1395 int count
, mach_port_t portarray
[])
1399 if (count
< 0 || count
> POSIX_SPAWN_IMPORTANCE_PORT_COUNT
) {
1403 for (i
= 0; i
< count
; i
++) {
1404 _ps_port_action_t action
= {
1405 .port_type
= PSPA_IMP_WATCHPORTS
,
1406 .new_port
= portarray
[i
],
1408 int err
= posix_spawn_appendportaction_np(attr
, &action
);
1419 _ps_mac_policy_extension_t
*
1420 posix_spawnattr_macpolicyinfo_lookup(_posix_spawn_mac_policy_extensions_t psmx
, const char *policyname
)
1427 for (i
= 0; i
< psmx
->psmx_count
; i
++) {
1428 _ps_mac_policy_extension_t
*extension
= &psmx
->psmx_extensions
[i
];
1429 if (strcmp(extension
->policyname
, policyname
) == 0)
1436 posix_spawnattr_getmacpolicyinfo_np(const posix_spawnattr_t
* __restrict attr
,
1437 const char *policyname
, void **datap
, size_t *datalenp
)
1439 _posix_spawnattr_t psattr
;
1440 _ps_mac_policy_extension_t
*extension
;
1442 if (attr
== NULL
|| *attr
== NULL
|| policyname
== NULL
|| datap
== NULL
)
1445 psattr
= *(_posix_spawnattr_t
*)attr
;
1446 extension
= posix_spawnattr_macpolicyinfo_lookup(psattr
->psa_mac_extensions
, policyname
);
1447 if (extension
== NULL
)
1449 *datap
= (void *)(uintptr_t)extension
->data
;
1450 if (datalenp
!= NULL
) {
1451 *datalenp
= (size_t)extension
->datalen
;
1457 posix_spawnattr_setmacpolicyinfo_np(posix_spawnattr_t
* __restrict attr
,
1458 const char *policyname
, void *data
, size_t datalen
)
1460 _posix_spawnattr_t psattr
;
1461 _posix_spawn_mac_policy_extensions_t psmx
;
1462 _ps_mac_policy_extension_t
*extension
;
1464 if (attr
== NULL
|| *attr
== NULL
|| policyname
== NULL
)
1467 psattr
= *(_posix_spawnattr_t
*)attr
;
1468 psmx
= psattr
->psa_mac_extensions
;
1469 extension
= posix_spawnattr_macpolicyinfo_lookup(psattr
->psa_mac_extensions
, policyname
);
1470 if (extension
!= NULL
) {
1471 extension
->data
= (uintptr_t)data
;
1472 extension
->datalen
= datalen
;
1475 else if (psmx
== NULL
) {
1476 psmx
= psattr
->psa_mac_extensions
= malloc(PS_MAC_EXTENSIONS_SIZE(PS_MAC_EXTENSIONS_INIT_COUNT
));
1479 psmx
->psmx_alloc
= PS_MAC_EXTENSIONS_INIT_COUNT
;
1480 psmx
->psmx_count
= 0;
1482 else if (psmx
->psmx_count
== psmx
->psmx_alloc
) {
1483 psmx
= psattr
->psa_mac_extensions
= reallocf(psmx
, PS_MAC_EXTENSIONS_SIZE(psmx
->psmx_alloc
* 2));
1486 psmx
->psmx_alloc
*= 2;
1488 extension
= &psmx
->psmx_extensions
[psmx
->psmx_count
];
1489 strlcpy(extension
->policyname
, policyname
, sizeof(extension
->policyname
));
1490 extension
->data
= (uintptr_t)data
;
1491 extension
->datalen
= datalen
;
1492 psmx
->psmx_count
+= 1;
1496 int posix_spawnattr_setcoalition_np(const posix_spawnattr_t
* __restrict attr
,
1497 uint64_t coalitionid
, int type
, int role
)
1499 _posix_spawnattr_t psattr
;
1500 struct _posix_spawn_coalition_info
*coal_info
;
1502 if (attr
== NULL
|| *attr
== NULL
) {
1505 if (type
< 0 || type
> COALITION_TYPE_MAX
)
1508 psattr
= *(_posix_spawnattr_t
*)attr
;
1510 coal_info
= psattr
->psa_coalition_info
;
1512 coal_info
= (struct _posix_spawn_coalition_info
*)malloc(sizeof(*coal_info
));
1515 memset(coal_info
, 0, sizeof(*coal_info
));
1516 psattr
->psa_coalition_info
= coal_info
;
1519 coal_info
->psci_info
[type
].psci_id
= coalitionid
;
1520 coal_info
->psci_info
[type
].psci_role
= role
;
1526 int posix_spawnattr_set_qos_clamp_np(const posix_spawnattr_t
* __restrict attr
, uint64_t qos_clamp
)
1528 _posix_spawnattr_t psattr
;
1530 if (attr
== NULL
|| *attr
== NULL
) {
1534 if (qos_clamp
>= POSIX_SPAWN_PROC_CLAMP_LAST
)
1537 psattr
= *(_posix_spawnattr_t
*)attr
;
1538 psattr
->psa_qos_clamp
= qos_clamp
;
1544 posix_spawnattr_get_qos_clamp_np(const posix_spawnattr_t
* __restrict attr
, uint64_t * __restrict qos_clampp
)
1546 _posix_spawnattr_t psattr
;
1548 if (attr
== NULL
|| *attr
== NULL
) {
1552 psattr
= *(_posix_spawnattr_t
*)attr
;
1553 *qos_clampp
= psattr
->psa_qos_clamp
;
1558 int posix_spawnattr_set_darwin_role_np(const posix_spawnattr_t
* __restrict attr
, uint64_t darwin_role
)
1560 _posix_spawnattr_t psattr
;
1562 if (attr
== NULL
|| *attr
== NULL
) {
1566 psattr
= *(_posix_spawnattr_t
*)attr
;
1567 psattr
->psa_darwin_role
= darwin_role
;
1573 posix_spawnattr_get_darwin_role_np(const posix_spawnattr_t
* __restrict attr
, uint64_t * __restrict darwin_rolep
)
1575 _posix_spawnattr_t psattr
;
1577 if (attr
== NULL
|| *attr
== NULL
) {
1581 psattr
= *(_posix_spawnattr_t
*)attr
;
1582 *darwin_rolep
= psattr
->psa_darwin_role
;
1589 posix_spawnattr_set_persona_np(const posix_spawnattr_t
* __restrict attr
, uid_t persona_id
, uint32_t flags
)
1591 _posix_spawnattr_t psattr
;
1592 struct _posix_spawn_persona_info
*persona
;
1594 if (attr
== NULL
|| *attr
== NULL
)
1597 if (flags
& ~POSIX_SPAWN_PERSONA_ALL_FLAGS
)
1600 psattr
= *(_posix_spawnattr_t
*)attr
;
1602 persona
= psattr
->psa_persona_info
;
1604 persona
= (struct _posix_spawn_persona_info
*)malloc(sizeof(*persona
));
1607 persona
->pspi_uid
= 0;
1608 persona
->pspi_gid
= 0;
1609 persona
->pspi_ngroups
= 0;
1610 persona
->pspi_groups
[0] = 0;
1612 psattr
->psa_persona_info
= persona
;
1615 persona
->pspi_id
= persona_id
;
1616 persona
->pspi_flags
= flags
;
1622 posix_spawnattr_set_persona_uid_np(const posix_spawnattr_t
* __restrict attr
, uid_t uid
)
1624 _posix_spawnattr_t psattr
;
1625 struct _posix_spawn_persona_info
*persona
;
1627 if (attr
== NULL
|| *attr
== NULL
)
1630 psattr
= *(_posix_spawnattr_t
*)attr
;
1631 persona
= psattr
->psa_persona_info
;
1635 if (!(persona
->pspi_flags
& (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE
| POSIX_SPAWN_PERSONA_FLAGS_VERIFY
)))
1638 persona
->pspi_uid
= uid
;
1640 persona
->pspi_flags
|= POSIX_SPAWN_PERSONA_UID
;
1646 posix_spawnattr_set_persona_gid_np(const posix_spawnattr_t
* __restrict attr
, gid_t gid
)
1648 _posix_spawnattr_t psattr
;
1649 struct _posix_spawn_persona_info
*persona
;
1651 if (attr
== NULL
|| *attr
== NULL
)
1654 psattr
= *(_posix_spawnattr_t
*)attr
;
1655 persona
= psattr
->psa_persona_info
;
1659 if (!(persona
->pspi_flags
& (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE
| POSIX_SPAWN_PERSONA_FLAGS_VERIFY
)))
1662 persona
->pspi_gid
= gid
;
1664 persona
->pspi_flags
|= POSIX_SPAWN_PERSONA_GID
;
1670 posix_spawnattr_set_persona_groups_np(const posix_spawnattr_t
* __restrict attr
, int ngroups
, gid_t
*gidarray
, uid_t gmuid
)
1672 _posix_spawnattr_t psattr
;
1673 struct _posix_spawn_persona_info
*persona
;
1675 if (attr
== NULL
|| *attr
== NULL
)
1678 if (gidarray
== NULL
)
1681 if (ngroups
> NGROUPS
)
1684 psattr
= *(_posix_spawnattr_t
*)attr
;
1685 persona
= psattr
->psa_persona_info
;
1689 if (!(persona
->pspi_flags
& (POSIX_SPAWN_PERSONA_FLAGS_OVERRIDE
| POSIX_SPAWN_PERSONA_FLAGS_VERIFY
)))
1692 persona
->pspi_ngroups
= ngroups
;
1693 for (int i
= 0; i
< ngroups
; i
++)
1694 persona
->pspi_groups
[i
] = gidarray
[i
];
1696 persona
->pspi_gmuid
= gmuid
;
1698 persona
->pspi_flags
|= POSIX_SPAWN_PERSONA_GROUPS
;
1708 * Description: Create a new process from the process image corresponding to
1709 * the supplied 'path' argument.
1711 * Parameters: pid Pointer to pid_t to receive the
1712 * PID of the spawned process, if
1713 * successful and 'pid' != NULL
1714 * path Path of image file to spawn
1715 * file_actions spawn file actions object which
1716 * describes file actions to be
1717 * performed during the spawn
1718 * attrp spawn attributes object which
1719 * describes attributes to be
1720 * applied during the spawn
1721 * argv argument vector array; NULL
1723 * envp environment vector array; NULL
1726 * Returns: 0 Success
1727 * !0 An errno value indicating the
1728 * cause of the failure to spawn
1730 * Notes: Unlike other system calls, the return value of this system
1731 * call is expected to either be a 0 or an errno, rather than a
1732 * 0 or a -1, with the 'errno' variable being set.
1734 extern int __posix_spawn(pid_t
* __restrict
, const char * __restrict
,
1735 struct _posix_spawn_args_desc
*,
1736 char *const argv
[ __restrict
], char *const envp
[ __restrict
]);
1739 posix_spawn(pid_t
* __restrict pid
, const char * __restrict path
,
1740 const posix_spawn_file_actions_t
*file_actions
,
1741 const posix_spawnattr_t
* __restrict attrp
,
1742 char *const argv
[ __restrict
], char *const envp
[ __restrict
])
1744 int saveerrno
= errno
;
1747 * Only do extra work if we have file actions or attributes to push
1748 * down. We use a descriptor to push this information down, since we
1749 * want to have size information, which will let us (1) preallocate a
1750 * single chunk of memory for the copyin(), and (2) allow us to do a
1751 * single copyin() per attributes or file actions as a monlithic block.
1753 * Note: A future implementation may attempt to do the same
1754 * thing for the argv/envp data, which could potentially
1755 * result in a performance improvement due to increased
1756 * kernel efficiency, even though it would mean copying
1757 * the data in user space.
1759 if ((file_actions
!= NULL
&& (*file_actions
!= NULL
) && (*(_posix_spawn_file_actions_t
*)file_actions
)->psfa_act_count
> 0) || attrp
!= NULL
) {
1760 struct _posix_spawn_args_desc ad
;
1762 memset(&ad
, 0, sizeof(ad
));
1763 if (attrp
!= NULL
&& *attrp
!= NULL
) {
1764 _posix_spawnattr_t psattr
= *(_posix_spawnattr_t
*)attrp
;
1765 ad
.attr_size
= sizeof(struct _posix_spawnattr
);
1768 if (psattr
->psa_ports
!= NULL
) {
1769 ad
.port_actions
= psattr
->psa_ports
;
1770 ad
.port_actions_size
= PS_PORT_ACTIONS_SIZE(
1771 ad
.port_actions
->pspa_count
);
1773 if (psattr
->psa_mac_extensions
!= NULL
) {
1774 ad
.mac_extensions
= psattr
->psa_mac_extensions
;
1775 ad
.mac_extensions_size
= PS_MAC_EXTENSIONS_SIZE(
1776 ad
.mac_extensions
->psmx_count
);
1778 if (psattr
->psa_coalition_info
!= NULL
) {
1779 ad
.coal_info_size
= sizeof(struct _posix_spawn_coalition_info
);
1780 ad
.coal_info
= psattr
->psa_coalition_info
;
1782 if (psattr
->psa_persona_info
!= NULL
) {
1783 ad
.persona_info_size
= sizeof(struct _posix_spawn_persona_info
);
1784 ad
.persona_info
= psattr
->psa_persona_info
;
1787 if (file_actions
!= NULL
&& *file_actions
!= NULL
) {
1788 _posix_spawn_file_actions_t psactsp
=
1789 *(_posix_spawn_file_actions_t
*)file_actions
;
1791 if (psactsp
->psfa_act_count
> 0) {
1792 ad
.file_actions_size
= PSF_ACTIONS_SIZE(psactsp
->psfa_act_count
);
1793 ad
.file_actions
= psactsp
;
1797 ret
= __posix_spawn(pid
, path
, &ad
, argv
, envp
);
1799 ret
= __posix_spawn(pid
, path
, NULL
, argv
, envp
);