Mac Developer Library Developer


This manual page is part of Xcode Tools version 5.0

To obtain these tools:

If you are running a version of Xcode Tools other than 5.0, view the documentation locally:

  • In Xcode

  • In Terminal, using the man(1) command

Reading manual pages

Manual pages are intended as a quick reference for people who already understand a technology.

  • To learn how the manual is organized or to learn about command syntax, read the manual page for manpages(5).

  • For more information about this technology, look for other documentation in the Apple Developer Library.

  • For general information about writing shell scripts, read Shell Scripting Primer.


     posix_spawn_file_actions_init posix_spawn_file_actions_destroy -- initialize or destroy spawn file
     actions objects

     #include <spawn.h>

     posix_spawn_file_actions_init(posix_spawn_file_actions_t *file_actions);

     posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *file_actions);

     The posix_spawn_file_actions_init() function initializes the object referenced by file_actions, to an
     empty set of file actions for subsequent use in a call to posix_spawn(2) or posix_spawnp(2).  A
     posix_spawn_file_actions_t object is an opaque type that is used to collect set of file actions speci-fied specified
     fied by calls to posix_spawn_file_actions_addclose(3) and posix_spawn_file_actions_addopen(3) such that
     once the spawn operation is complete, the child process will have a different set of file descriptors
     than the parent, in the order that the operations were added to the posix_spawn_file_actions_t.

     Additionally, any descriptor in the parent not modified by a file action, and which has the FD_CLOEXEC
     flag set, will be closed in the child.

     The posix_spawn_file_actions_destroy() function destroys the object referenced by file_actions which
     was previously intialized by posix_spawn_file_actions_init(), returning any resources obtained at the
     time of initialization to the system for subsequent reuse.  A posix_spawn_file_actions_t may be reini-tialized reinitialized
     tialized after having been destroyed, but must not be reused after destruction, unless it has been

     On success, these functions return 0; on failure they return an error number from <errno.h>.

     These functions will fail and return an error if:

     [ENOMEM]           Insufficient resources to initialize the posix_spawn_file_actions_t object.

     [EINVAL]           The posix_spawn_file_actions_t being destroyed is invalid.

     posix_spawn(2), posix_spawnp(2), posix_spawn_file_actions_addclose(3),
     posix_spawn_file_actions_addopen(3), posix_spawn_file_actions_adddup2(3)

     Version 3 of the Single UNIX Specification (``SUSv3'') [SPN]

     The posix_spawn_file_actions_init() and posix_spawn_file_actions_destroy() function calls appeared in
     Version 3 of the Single UNIX Specification (``SUSv3'') [SPN].

Mac OS X                        August 22, 2007                       Mac OS X

Reporting Problems

The way to report a problem with this manual page depends on the type of problem:

Content errors
Report errors in the content of this documentation with the feedback links below.
Bug reports
Report bugs in the functionality of the described tool or API through Bug Reporter.
Formatting problems
Report formatting mistakes in the online version of these pages with the feedback links below.