POSIX_SPAWN_FILE_ACTIONS_DESTROY(3C) Standard C Library Functions
posix_spawn_file_actions_destroy, posix_spawn_file_actions_init -
destroy and initialize spawn file actions object
Standard C Library (libc, -lc)
#include <spawn.h>
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);
The posix_spawn_file_actions_destroy() function destroys the object
referenced by file_actions. The object becomes, in effect,
uninitialized. An implementation can 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 initializes the object
referenced by file_actions to contain no file actions for
posix_spawn(3C) or posix_spawnp(3C) to perform.
A spawn file actions object is as defined in
posix_spawn_file_actions_addclose(3C).
The effect of initializing an already initialized spawn file actions
object is undefined.
Upon successful completion, these functions return 0. Otherwise, an
error number is returned to indicate the error.
The posix_spawn_file_actions_init() function will 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.
Standard
MT-LEVEL
MT-Safe
posix_spawn(3C), posix_spawn_file_actions_addclose(3C), attributes(7),
standards(7)
The posix_spawn_file_actions_destroy() and
posix_spawn_file_actions_init() functions conform to IEEE Std
1003.1-2001 ("POSIX.1").
illumos July 4, 2026 illumos
NAME
posix_spawn_file_actions_destroy, posix_spawn_file_actions_init -
destroy and initialize spawn file actions object
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <spawn.h>
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 destroys the object
referenced by file_actions. The object becomes, in effect,
uninitialized. An implementation can 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 initializes the object
referenced by file_actions to contain no file actions for
posix_spawn(3C) or posix_spawnp(3C) to perform.
A spawn file actions object is as defined in
posix_spawn_file_actions_addclose(3C).
The effect of initializing an already initialized spawn file actions
object is undefined.
RETURN VALUES
Upon successful completion, these functions return 0. Otherwise, an
error number is returned to indicate the error.
ERRORS
The posix_spawn_file_actions_init() function will 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.
INTERFACE STABILITY
Standard
MT-LEVEL
MT-Safe
SEE ALSO
posix_spawn(3C), posix_spawn_file_actions_addclose(3C), attributes(7),
standards(7)
STANDARDS
The posix_spawn_file_actions_destroy() and
posix_spawn_file_actions_init() functions conform to IEEE Std
1003.1-2001 ("POSIX.1").
illumos July 4, 2026 illumos