posix_spawn_file_actions_destroy, posix_spawn_file_actions_init - destroy and initialize spawn file actions object (ADVANCED REALTIME)
[SPN] #include <spawn.h>
The posix_spawn_file_actions_destroy() function shall destroy the object referenced by file_actions; the object becomes, in effect, uninitialized. An implementation may cause posix_spawn_file_actions_destroy() to set the object referenced by file_actions to an invalid value. A destroyed spawn file actions object can be reinitialized using posix_spawn_file_actions_init(); the results of otherwise referencing the object after it has been destroyed are undefined.
The posix_spawn_file_actions_init() function shall initialize the object referenced by file_actions to contain no file actions for posix_spawn() or posix_spawnp() to perform.
A spawn file actions object is as defined in posix_spawn_file_actions_addclose.
The effect of initializing an already initialized spawn file actions object is undefined.
Upon successful completion, these functions shall return zero; otherwise, an error number shall be returned to indicate the error.
The posix_spawn_file_actions_init() function shall fail if:
- Insufficient memory exists to initialize the spawn file actions object.
The posix_spawn_file_actions_destroy() function may fail if:
- The value specified by file_actions is invalid.
These functions are part of the Spawn option and need not be provided on all implementations.
Refer to the RATIONALE section in posix_spawn_file_actions_addclose.
First released in Issue 6. Derived from IEEE Std 1003.1d-1999.
In the SYNOPSIS, the inclusion of <sys/types.h> is no longer required.
return to top of page