POSIX_SPAWN_FILE_ACTI... BSD Library Functions Manual POSIX_SPAWN_FILE_ACTI...NAME
posix_spawn_file_actions_init, posix_spawn_file_actions_destroy — ini‐
tialize and destroy spawn file actions object
LIBRARY
Standard C Library (libc, -lc)
SYNOPSIS
#include <spawn.h>
int
posix_spawn_file_actions_init(posix_spawn_file_actions_t * file_actions);
int
posix_spawn_file_actions_destroy(posix_spawn_file_actions_t * file_actions);
DESCRIPTION
The posix_spawn_file_actions_init() function initialize the object refer‐
enced by file_actions() to contain no file actions for posix_spawn() or
posix_spawnp(). Initializing an already initialized spawn file actions
object may cause memory to be leaked.
The posix_spawn_file_actions_destroy() function destroy the object refer‐
enced by file_actions; the object becomes, in effect, uninitialized. A
destroyed spawn file actions object can be reinitialized using
posix_spawn_file_actions_init(). The object should not be used after it
has been destroyed.
RETURN VALUES
Upon successful completion, these functions return zero; 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.
SEE ALSOposix_spawn(3), posix_spawn_file_actions_addclose(3),
posix_spawn_file_actions_adddup2(3), posix_spawn_file_actions_addopen(3),
posix_spawnp(3)STANDARDS
The posix_spawn_file_actions_init() and
posix_spawn_file_actions_destroy() functions conform to IEEE Std
1003.1-2001 (“POSIX.1”).
HISTORY
The posix_spawn_file_actions_init() and
posix_spawn_file_actions_destroy() functions first appeared in
FreeBSD 8.0 and imported for NetBSD 6.
AUTHORS
Ed Schouten ⟨ed@FreeBSD.org⟩
BSD December 20, 2011 BSD