NAME
posix_spawn_file_actions_destroy
posix_spawn_file_actions_init —
destroy and initialize spawn file actions object (ADVANCED
REALTIME)
SYNOPSIS
int posix_spawn_file_actions_destroy(posix_spawn_file_actions_t *
file_actions);
int posix_spawn_file_actions_init(posix_spawn_file_actions_t *
file_actions);
DESCRIPTION
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(3) or posix_spawnp(3) to perform.
A spawn file actions object is as defined in posix_spawn_file_actions_addclose(3).
The effect of initializing an already initialized spawn file actions object is undefined.
RETURN VALUE
Upon successful completion, these functions shall return zero; otherwise, an error number shall be returned to indicate the error.
ERRORS
The posix_spawn_file_actions_init () function shall fail if:
- [ENOMEM]
- Insufficient memory exists to initialize the spawn file actions object.
The posix_spawn_file_actions_destroy ()
function may fail if:
- [EINVAL]
- The value specified by file_actions is invalid.
EXAMPLES
None.
APPLICATION USAGE
These functions are part of the Spawn option and need not be provided on all implementations.
RATIONALE
Refer to the RATIONALE in posix_spawn_file_actions_addclose(3).
FUTURE DIRECTIONS
None.
SEE ALSO
posix_spawn(3), posix_spawnp(3), the Base Definitions volume of IEEE Std 1003.1-2001 (“POSIX.1”), <spawn.h>
CHANGE HISTORY
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.
End of informative text. footer end