posix_spawn_file_actions_init(3) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
POSIX_SPAWN_FILE_ACT... NetBSD Library Functions ManualPOSIX_SPAWN_FILE_ACT...


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:

     [EINVAL]           The value specified by file_actions is invalid.

     [ENOMEM]           Insufficient memory exists to initialize the spawn
                        file actions object.


SEE ALSO

     posix_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.0.


AUTHORS

     Ed Schouten <ed@FreeBSD.org>

NetBSD 8.0                     February 2, 2014                     NetBSD 8.0