posix_spawnattr_destroy

posix_spawnattr_destroy()

destroy and initialize spawn attributes object 

Advanced Realtime Function


SYNOPSIS

#include <spawn.h>

int posix_spawnattr_destroy(posix_spawnattr_t *attr);

int posix_spawnattr_init(posix_spawnattr_t *attr);


DESCRIPTION

The posix_spawnattr_destroy() function destroys the spawn attributes object pointed to by attr. You can reinitialize the destroyed object with the posix_spawnattr_int() function. A destroyed attr attributes object

The posix_spawnattr_init() function initializes the spawn attributes object pointed to by attr with the default value for all of the individual attributes.

A spawn attributes object is of type posix_spawnattr_t (defined in <spawn.h>). This object specifies the inheritance of process attributes across a spawn operation.

A spawn attributes object (after possible modification by setting individual attribute values) can modify the behavior of the posix_spawn() and posix_spawnp(). function. Once a spawn attribute object has been used to spawn a new process, any function affecting that attributes object (including destruction) has no effect whatsoever on the spawned process.


PARAMETERS

attr 

Points to a spawn attributes object.


RETURN VALUES

On success, the posix_spawnattr_destroy() and posix_spawnattr_init() functions return 0.

Otherwise, these functions return one of the following error numbers:

ENOMEM 

There is not enough memory to initialize the spawn attributes object.

EINVAL 

The attr argument contains an invalid value.


CONFORMANCE

UNIX 03.


MULTITHREAD SAFETY LEVEL

MT-Safe.


PORTING ISSUES

None.


AVAILABILITY

PTC MKS Toolkit for Professional Developers
PTC MKS Toolkit for Professional Developers 64-Bit Edition
PTC MKS Toolkit for Enterprise Developers
PTC MKS Toolkit for Enterprise Developers 64-Bit Edition


SEE ALSO

Functions:
posix_spawn(), posix_spawnattr_getflags(), posix_spawnattr_getpgroup(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigmask(), posix_spawnattr_setflags(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigmask(), posix_spawnp()

Miscellaneous:
spawn


PTC MKS Toolkit 10.3 Documentation Build 39.