ADC Home > Reference Library > Reference > Mac OS X > Mac OS X Man 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 |