posix_spawnattr_getpgroup(), posix_spawnattr_setpgroup()

get and set the spawn-pgroup attribute of a spawn attributes object 

Advanced Realtime Function


SYNOPSIS

#include <spawn.h>

int posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict attr, pid_t *restrict pgroup);

int posix_spawnattr_setpgroup(posix_spawnattr_t *attr, pid_t pgroup);


DESCRIPTION

The posix_spawnattr_getpgroup() function retrieves the value of the spawn-pgroup attribute from the attr spawn attributes object. The retrieved value is stored in the object pointed to by pgroup.

The posix_spawnattr_setpgroup() function sets the spawn-pgroup attribute of the initialized spawn attributes object pointed to by attr. The pgroup argument points to the value used for setting the attribute.

The spawn-pgroup attribute of a spawn attributes object indicates the process group that a new process image is to join when created by a spawn operation (if POSIX_SPAWN_SETGROUP is set in the spawn-flags attribute). By default, this attribute has a value of 0.


PARAMETERS

attr 

Points to a spawn attributes object.

pgroup 

Points to the value retrieved by posix_spawnattr_getpgroup() or to the value to be assigned to the spawn-pgroup attribute by posix_spawnattr_setpgroup().


RETURN VALUES

On success, posix_spawnattr_getpgroup() and posix_spawnattr_setpgroup() return 0. Additionally, posix_spawnattr_getpgroup() places the value retrieved from the spawn-pgroup attribute of the attr spawn attributes object in the object pointed to by pgroup.

Otherwise, one of the following error numbers is returned:

EINVAL 

The attr or pgroup arguments point to 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_destroy(), posix_spawnattr_getflags(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigmask(), posix_spawnattr_init(), posix_spawnattr_setflags(), posix_spawnattr_setschedparam(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigmask(), posix_spawnp()

Miscellaneous:
spawn


PTC MKS Toolkit 10.3 Documentation Build 39.