Name

posix_spawnattr_getpgroup,posix_spawnattr_setpgroup - get or set spawn-pgroup attribute of a spawn attributes object.

Library

libc.lib

Synopsis

#include <spawn.h>

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

The posix_spawnattr_getpgroup will get the value of the spawn-pgroup attribute from the attributes object referenced by the argument attr.

The posix_spawnattr_setpgroup will set the spawn-pgroup attribute in an initialized attributes object referenced by the argument attr.

The spawn-pgroup attribute represents the process group to be joined by the new process image in a spawn operation. The default value of this attribute shall be zero.

Return Values

On success, posix_spawnattr_getpgroup will return 0 and stores the spawn-group attribute of attr in the object referenced by the argument pgroup. On error, error number is returned to indicate the error.

On success posix_spawnattr_setpgroup will return 0. On error, error number is returned to indicate the error.

Errors

These functions may fail if:

[EINVAL]
The value specified by attr is invalid.

The posix_spawnattr_setpgroup() function may fail if:

[EINVAL]
The value of the attribute being set is not valid.

Feedback