Caution: This version of this document is no longer maintained. For the latest documentation, see


Add an open action to the object referenced that causes the file named by the path to be opened


#include <posix_spawn_file_actions.h>

int posix_spawn_file_actions_addopen(
       posix_spawn_file_actions_t *_Restrict fact_p,
       int new_fd,
       const char *_Restrict path,
       int oflags,
       mode_t omode);


The file action to update the spawn file actions object.
The updated file descriptors count.
The name of the file to open. The string described by path is copied by the posix_spawn_file_actions_addopen() function.
Flags that specify the status and access modes of the file.
An object of type mode_t that specifies the access mode that you want to use for a newly created file. For more information, see “Access permissions” and O_CREATE in the documentation for stat().



Use the -l c option to qcc to link against this library. This library is usually included automatically.


The posix_spawn_file_actions_addopen() function will add an open action to the object referenced by fact_p that will cause the file named by path to be opened (as if open(path, oflag, mode) had been called, and the returned file descriptor, if not fd, had been changed to fd) when a new process is spawned using this file actions object. If fd was already an open file descriptor, it will be closed before the new file is opened.

For detailed information about the open and close functions, see posix_spawn_file_actions_addopen() and posix_spawn_file_actions_addclose() functions.


Upon successful completion, these functions returns zero; otherwise, an error number is returned to indicate the error (errno is set).


The value specified by new_fd is negative or greater than or equal to {OPEN_MAX}.
For any invalid parameter, or the value specified by fact_p is invalid.
The partition Id couldn't be added to the attributes object, or insufficient memory exists to add to the spawn file actions object. It shall not be considered an error for the new_fd argument passed to these functions to specify a file descriptor for which the specified operation could not be performed at the time of the call. Any such error will be detected when the associated file actions object is later used during a posix_spawn() or posix_spawnp() operation.


POSIX 1003.1 RTS

Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes

See also:

posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_destroy(), posix_spawn_file_actions_init(), posix_spawnattr_addpartid(), posix_spawnattr_addpartition(), posix_spawnattr_destroy(), posix_spawnattr_getcred(), posix_spawnattr_getflags(), posix_spawnattr_getnode(), posix_spawnattr_getpartid(), posix_spawnattr_getpgroup(), posix_spawnattr_getrunmask(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigignore(), posix_spawnattr_getsigmask(), posix_spawnattr_getstackmax(), posix_spawnattr_getxflags(), posix_spawnattr_init(), posix_spawnattr_setcred(), posix_spawnattr_setflags(), posix_spawnattr_setnode(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setrunmask(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigignore(), posix_spawnattr_setsigmask(), posix_spawnattr_setstackmax(), posix_spawnattr_setxflags(), posix_spawnp()