Get the POSIX flags and the 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_ALIGN_DEFAULT
- POSIX_SPAWN_ALIGN_FAULT
- POSIX_SPAWN_ALIGN_NOFAULT
- POSIX_SPAWN_ASLR_INVERT — we recommend that you use
posix_spawnattr_setaslr()
instead of this flag
- POSIX_SPAWN_CHECK_SCRIPT
- POSIX_SPAWN_CRITICAL (QNX Neutrino 7.0.4 or later)
- POSIX_SPAWN_DEBUG
- POSIX_SPAWN_EXEC
- POSIX_SPAWN_EXPLICIT_CPU
- POSIX_SPAWN_HOLD
- POSIX_SPAWN_NEWAPP
- POSIX_SPAWN_NOZOMBIE
- POSIX_SPAWN_SEARCH_PATH
- POSIX_SPAWN_SETASID (QNX Neutrino 7.0.4 or later)
- POSIX_SPAWN_SETCRED
- POSIX_SPAWN_SETCWD (QNX Neutrino 7.1 or later)
- POSIX_SPAWN_SETND
- POSIX_SPAWN_SETSID
- POSIX_SPAWN_SETSIGIGN
- POSIX_SPAWN_SETSTACKMAX
- POSIX_SPAWN_SETTYPEID (QNX Neutrino 7.0 or later)
- POSIX_SPAWN_TCSETPGROUP
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 attrp pointer does not refer to a valid attribute structure.
Classification:
QNX Neutrino
| Safety: |
|
| Cancellation point |
No |
| Interrupt handler |
Yes |
| Signal handler |
Yes |
| Thread |
Yes |