posix_spawnattr_setpgroup(3) [osx man page]
POSIX_SPAWNATTR_SETPGROUP(3) BSD Library Functions Manual POSIX_SPAWNATTR_SETPGROUP(3) NAME
posix_spawnattr_setpgroup posix_spawnattr_getpgroup -- set or get the spawn-pgroup attribute on a posix_spawnattr_t SYNOPSIS
#include <spawn.h> int posix_spawnattr_setpgroup(posix_spawnattr_t *attr, pid_t pgroup); int posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict attr, pid_t *restrict pgroup); DESCRIPTION
The posix_spawnattr_setpgroup() function sets the pgroup on the attributes object referenced by attr. The posix_spawnattr_getpgroup() function retrieves the pgroup on the attributes object referenced by attr. The argument pgroup is the process group to be joined or created when the new process is created if the POSIX_SPAWN_SETPGROUP flag is set in the posix_spawnattr_t via a call to posix_spawnattr_setflags(3); its default value is 0, which means a new process group will be created. RETURN VALUES
On success, these functions return 0; on failure they return an error number from <errno.h>. Additionally, if successful, posix_spawnattr_getpgroup() will modify the contents of the pgroup parameter with the current attribute value. ERRORS
These functions may fail if: [EINVAL] The value specified by attr is invalid. [EINVAL] The value of attr is invalid. SEE ALSO
posix_spawn(2), posix_spawnp(2), posix_spawnattr_init(3), posix_spawnattr_destroy(3), posix_spawnattr_setflags(3) STANDARDS
Version 3 of the Single UNIX Specification (``SUSv3'') [SPN] HISTORY
The posix_spawnattr_setpgroup() and posix_spawnattr_getpgroup() function calls appeared in Version 3 of the Single UNIX Specification (``SUSv3'') [SPN]. Mac OS X August 22, 2007 Mac OS X
Check Out this Related Man Page
posix_spawnattr_getpgroup(3C) Standard C Library Functions posix_spawnattr_getpgroup(3C) NAME
posix_spawnattr_getpgroup, posix_spawnattr_setpgroup - get and set spawn-pgroup attribute of spawn attributes object 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 obtains the value of the spawn-pgroup attribute from the attributes object referenced by attr. The posix_spawnattr_setpgroup() function sets the spawn-pgroup attribute in an initialized attributes object referenced by attr. The spawn-pgroup attribute represents the process group to be joined by the new process image in a spawn operation (if POSIX_SPAWN_SETP- GROUP is set in the spawn-flags attribute). The default value of this attribute is zero. RETURN VALUES
Upon successful completion, posix_spawnattr_getpgroup() returns 0 and stores the value of the spawn-pgroup attribute of attr into the object referenced by the pgroup parameter. Otherwise, an error number is returned to indicate the error. Upon successful completion, posix_spawnattr_setpgroup() returns 0. Otherwise, an 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. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Interface Stability |Standard | +-----------------------------+-----------------------------+ |MT-Level |MT-Safe | +-----------------------------+-----------------------------+ SEE ALSO
posix_spawn(3C), posix_spawnattr_getpgroup(3C), posix_spawnattr_getpgroup(3C), posix_spawnattr_getschedparam(3C), posix_spawnattr_getsched- policy(3C), posix_spawnattr_getsigdefault(3C), posix_spawnattr_getsigmask(3C), attributes(5), standards(5) SunOS 5.10 30 Jan 2004 posix_spawnattr_getpgroup(3C)