posix_spawn_file_actions_adddup2()

Add the dup2() action to spawn file actions object

Synopsis:

#include <posix_spawn_file_actions.h>

int posix_spawn_file_actions_adddup2(
       posix_spawn_file_actions_t *fact_p,
       int fd,
       int new_fd);

Arguments:

fact_p: The file action to update the spawn file actions object.
fd: The file descriptors in the array.
new_fd: The file descriptor fd that was duplicated.

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

The posix_spawn_file_actions_adddup2() function adds a dup2() action to the object referenced by fact_p that causes the file descriptor fd to be duplicated as new_fd (as if a call to dup2(fd, new_fd)) when a new process is spawned using this file actions object. A spawn file actions object is as defined in posix_spawn_file_actions_addclose().

Returns:

Upon successful completion, the posix_spawn_file_actions_adddup2() function returns zero; otherwise, it returns an error number to indicate the error (errno is set.)

Errors:

EBADF: The value specified by fildes or newfildes is negative or greater than or equal to {OPEN_MAX}.
EINVAL: For any invalid parameter. The value specified by file actions is invalid. It isn't considered an error for the fd argument passed to the posix_spawn_file_actions_adddup2() function to specify a file descriptor for which the specified operation couldn't be performed at the time of the call. Any such error will be detected when the associated file actions object is later used during a posix_spawn() or posix_spawnp() operation.
ENOMEM: If the action couldn't be added to the file actions object, or insufficient memory exists to add to the spawn file actions object.
EOK: Success.

Classification:

POSIX 1003.1 RTS

Safety:
Cancellation point	No
Interrupt handler	Yes
Signal handler	Yes
Thread	Yes