posix_spawnattr_getpgroup()
Get the process group attribute of a spawn attributes object
Synopsis:
#include <spawn.h> int posix_spawnattr_getpgroup( const posix_spawnattr_t *_Restrict attrp, pid_t *_Restrict pid_p);
Arguments:
- attrp
- A pointer to the spawn attributes object that you want to query.
- pid_p
- A pointer to a location where the function can store the group ID
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The posix_spawnattr_getpgroup() function gets the value of the process group attribute from the attributes object pointed to by attrp, and stores it in the object pointed to by pid_p. You must have already initialized the spawn attributes object by calling posix_spawnattr_init() .
This attribute represents the process group to be joined by the new process image in a spawn operation if POSIX_SPAWN_SETPGROUP is set in the spawn flags; to set this flag, call the POSIX function posix_spawnattr_setflags() , or the QNX Neutrino function posix_spawnattr_setxflags() . The default value of the process group attribute is zero.
You can use posix_spawnattr_setpgroup() . to set it.
For more information about spawn attributes, see the entry for posix_spawn() .
Returns:
- EOK
- Success
- EINVAL
- The value specified by attrp or pid_p was invalid.
Classification:
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | Yes |
Signal handler | Yes |
Thread | Yes |