iOS Manual Pages

This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

POSIX_SPAWN_FILE_ACTI... BSD Library Functions Manual POSIX_SPAWN_FILE_ACTI...

NAME
     posix_spawn_file_actions_addclose posix_spawn_file_actions_addopen -- add
     open or close actions to a posix_spawn_file_actions_t

SYNOPSIS
     #include <spawn.h>

     int
     posix_spawn_file_actions_addclose(posix_spawn_file_actions_t *file_actions,
         int filedes);

     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);

     int
     posix_spawn_file_actions_adddup2(posix_spawn_file_actions_t *file_actions,
         int filedes, int newfiledes);

DESCRIPTION
     The posix_spawn_file_actions_addclose() function adds a close operation
     to the list of operations associated with the object referenced by
     file_actions, for subsequent use in a call to posix_spawn(2) or
     posix_spawnp(2).  The descriptor referred to by filedes is closed as if
     close() had been called on it prior to the new child process starting
     execution.

     The posix_spawn_file_actions_addopen() function adds an open operation to
     the list of operations associated with the object referenced by
     file_actions, for subsequent use in a call to posix_spawn(2) or
     posix_spawnp(2).  The descriptor referred to by filedes is opened using
     the path, oflag, and mode arguments as if open() had been called on it
     prior to the new child process starting execution.  The string path is
     copied by the posix_spawn_file_actions_addopen() function during this
     process, so storage need not be persistent in the caller.

     The posix_spawn_file_actions_adddup2() function adds a dup2 operation to
     the list of operations associated with the object referenced by
     file_actions, for subsequent use in a call to posix_spawn(2) or
     posix_spawnp(2).  The descriptor referred to by newfiledes is created as
     if dup2() had been called on filedes prior to the new child process
     starting execution.

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

ERRORS
     These functions may fail if:

     [EBADF]            The value specified by filedes is negative or would
                        cause the process to exceed the maximum number of open
                        files it is allowed..

     [EINVAL]           The value of file_actions is invalid.

     [ENOMEM]           Insufficient memory was available eo add to the
                        file_actions.

SEE ALSO
     posix_spawn(2), posix_spawnp(2), posix_spawn_file_actions_init(3),
     posix_spawn_file_actions_destroy(3),

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

HISTORY
     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