POSIX_SPAWN_FILE_ACTIONS_ADDCHDIR(3) Library Functions Manual POSIX_SPAWN_FILE_ACTIONS_ADDCHDIR(3)

posix_spawn_file_actions_addchdir, posix_spawn_file_actions_addfchdir — add chdir or fchdir action to spawn file actions object

Standard C Library (libc, -lc)

#include <spawn.h>

int
posix_spawn_file_actions_addchdir(posix_spawn_file_actions_t *restrict file_actions, const char *restrict path);

int
posix_spawn_file_actions_addfchdir(posix_spawn_file_actions_t * file_actions, int fildes);

The () function adds a chdir action to the object referenced by file_actions that causes the working directory to be set to path (as if

chdir(path)

had been called) for a new process spawned using this file actions object. A relative path is interpreted relative to the working directory determined by any prior actions. The string pointed to by path is copied by the () function.

The () function adds a fchdir action to the object referenced by file_actions that causes the working directory to be set to the directory referenced by fildes (as if

fchdir(fildes)

had been called) for a new process spawned using this file actions object.

File actions are performed in the new process created by () or () in the same order that they were added to the file actions object. Thus the execution of an “open” action that was created by a call to () that specifies a relative path will be affected by the execution of a chdir or fchdir action that was created by a previous call to posix_spawn_file_actions_addchdir() or posix_spawn_file_actions_addfchdir(). Likewise, a relative path passed to posix_spawn() will be affected by the last chdir or fchdir action in the file action list.

Upon successful completion, these function return zero; otherwise, an error number is returned to indicate the error.

The posix_spawn_file_actions_addfchdir() function fails if:

[]
The value specified by fildes is negative.

Both functions may fail with:

[]
The value specified by file_actions is invalid.
[]
Insufficient memory exists to add the spawn file actions object.

It is not an error for the path or fildes argument passed to these functions to specify a pathname or file descriptor for which the specified operation could not 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.

chdir(2), fchdir(2), posix_spawn(3), posix_spawn_file_actions_destroy(3), posix_spawn_file_actions_init(3), posix_spawnp(3)

The posix_spawn_file_actions_addchdir() and posix_spawn_file_actions_addfchdir() functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).

The POSIX implementation of posix_spawn_file_actions_addchdir() and posix_spawn_file_actions_addfchdir() is derived from SOLARIS kernel's posix_spawn_file_actions_addchdir_np().

Piyush Sachdeva

July 8, 2020 NetBSD 11.0