posix_spawnattr_destroy()

Destroy a spawn attributes object

Synopsis:

#include <spawn.h>

int posix_spawnattr_destroy(posix_spawnattr_t *attrp);

Arguments:

attrp: A pointer to the spawn attributes object that you want to destroy.

Library:

libc

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

Description:

The posix_spawnattr_destroy() function destroys a spawn attributes object. You can reinitialize a destroyed attrp attributes object by using posix_spawnattr_init(); the results of referencing the object after you've destroyed it are undefined.

A spawn attributes object is an opaque object of type posix_spawnattr_t (defined in <spawn.h>), and it specifies the inheritance of process attributes across a spawn operation.

The resulting spawn attributes object (possibly modified by setting individual attribute values), is used to modify the behavior of posix_spawn() or posix_spawnp(). Changes that you make to the spawn attributes object don't affect any processes that you've already spawned.

The posix_spawnattr_destroy() function renders the posix_spawnattr_t unusable. Before you can reuse the object, you must initialize it with posix_spawnattr_init(). POSIX specifies that results are undefined if you use a posix_spawnattr_t object after it has been destroyed, including calling posix_spawnattr_destroy() on an already destroyed object. If you attempt to reference a destroyed attributes object, all of the posix_spawnattr_get*() and posix_spawnattr_set*() operations, as well as posix_spawn(), return EINVAL.

Returns:

EOK: Success.
EINVAL: The value specified by attrp is invalid.

Classification:

POSIX 1003.1 SPN

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

Related links

close()
Close a file
dup2()
Duplicate a file descriptor, specifying the new descriptor
execl()
Execute a file
execle()
Execute a file
execlp()
Execute a file
execlpe()
Execute a file
execv()
Execute a file
execve()
Execute a file
execvp()
Execute a file
execvpe()
Execute a file
open(), open64()
Open a file
procmgr_ability()
Control a process's ability to perform certain operations

P

posix_spawn(), posix_spawnp()
Spawn a process
posix_spawn_file_actions_addclose()
Add a close a file descriptor action to a spawn file actions object
posix_spawn_file_actions_adddup2()
Add a duplicate a file descriptor action to a spawn file actions object
posix_spawn_file_actions_addopen()
Add an open a file action to a spawn file action object
posix_spawn_file_actions_destroy()
Destroy a spawn file actions object
posix_spawn_file_actions_init()
Initialize a spawn file actions object
posix_spawnattr_getcred()
Get the user and group ID attributes from a spawn attributes object
posix_spawnattr_getflags()
Get the POSIX flags from a spawn attributes object
posix_spawnattr_getpgroup()
Get the process group attribute of a spawn attributes object
posix_spawnattr_getrunmask()
Get the runmask attribute from a spawn attributes object
posix_spawnattr_getschedparam()
Get the scheduling parameters attribute of a spawn attributes object
posix_spawnattr_getschedpolicy()
Get the scheduling policy attribute of a spawn attributes object
posix_spawnattr_getsigdefault()
Get the default signals attribute of a spawn attributes object
posix_spawnattr_getsigignore()
Get the ignored signals attribute from a spawn attributes object
posix_spawnattr_getsigmask()
Get the signal mask attribute of a spawn attributes object
posix_spawnattr_getstackmax()
Get the maximum stack size attribute from a spawn attributes object
posix_spawnattr_getxflags()
Get the POSIX flags and the BlackBerry 10 OS extended flags from a spawn attributes object
posix_spawnattr_init()
Initialize a spawn attributes object
posix_spawnattr_setcred()
Set the user and group ID attributes in a spawn attributes object
posix_spawnattr_setflags()
Set the POSIX flags in a spawn attributes object
posix_spawnattr_setpgroup()
Set the process group attribute in a spawn attributes object
posix_spawnattr_setrunmask()
Set the runmask attribute in a spawn attributes object
posix_spawnattr_setschedparam()
Set the scheduling parameters attribute of a spawn attributes object
posix_spawnattr_setschedpolicy()
Set the scheduling policy attribute of a spawn attributes object
posix_spawnattr_setsigdefault()
Set the default signals attribute of a spawn attributes object
posix_spawnattr_setsigignore()
Set the ignored signals attribute of a spawn attributes object
posix_spawnattr_setsigmask()
Set the signal mask attribute of a spawn attributes object
posix_spawnattr_setstackmax()
Set the maximum stack size attribute in a spawn attributes object
posix_spawnattr_setxflags()
Set the POSIX flags and the BlackBerry 10 OS extended flags in a spawn attributes object