posix_spawnattr_getxflags()
Get the POSIX and QNX Neutrino extended flags from a spawn attributes object
Synopsis:
#include <spawn.h> int posix_spawnattr_getxflags( const posix_spawnattr_t *_Restrict attrp, uint32_t *_Restrict flags_p);
Arguments:
- attrp
- A pointer to the spawn attributes object that you want to query.
- flags_p
- A pointer to a location where the function can store the flags.
Library:
libc
Use the -l c option to qcc to link against this library. This library is usually included automatically.
Description:
The posix_spawnattr_getxflags() function retrieves the POSIX flags and QNX Neutrino extended flags from the spawn attributes object pointed to by attrp, and stores them in the object pointed to by flags_p. You must have already initialized the spawn attributes object by calling posix_spawnattr_init() .
POSIX defines the following flags:
- POSIX_SPAWN_SETPGROUP
- POSIX_SPAWN_SETSIGMASK
- POSIX_SPAWN_SETSIGDEF
- POSIX_SPAWN_SETSCHEDULER
- POSIX_SPAWN_SETSCHEDPARAM
- POSIX_SPAWN_RESETIDS
QNX Neutrino defines the following extended flags:
- POSIX_SPAWN_SETND
- POSIX_SPAWN_SETSIGIGN
- POSIX_SPAWN_SETSPART
- POSIX_SPAWN_EXPLICIT_CPU
- POSIX_SPAWN_SETCRED
- POSIX_SPAWN_SETSTACKMAX
- POSIX_SPAWN_NOZOMBIE
- POSIX_SPAWN_HOLD
- POSIX_SPAWN_ALIGN_DEFAULT
- POSIX_SPAWN_ALIGN_FAULT
- POSIX_SPAWN_ALIGN_NOFAULT
- POSIX_SPAWN_ASLR_INVERT
These flags indicate which process attributes you want to change in the new process image when you invoke posix_spawn() or posix_spawnp(). For detailed information about the flags, see the entry for posix_spawn() .
Returns:
- EOK
- Success.
- EINVAL
- The value specified by attrp or flags_p is invalid.
Classification:
Safety: | |
---|---|
Cancellation point | No |
Interrupt handler | Yes |
Signal handler | Yes |
Thread | Yes |