posix_spawnattr_getxflags()
Get the POSIX flags and the BlackBerry 10 OS 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);
Since:
BlackBerry 10.0.0
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 BlackBerry 10 OS 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
BlackBerry 10 OS defines the following extended flags:
- POSIX_SPAWN_ALIGN_DEFAULT
- POSIX_SPAWN_ALIGN_FAULT
- POSIX_SPAWN_ALIGN_NOFAULT
- POSIX_SPAWN_ASLR_INVERT
- POSIX_SPAWN_CHECK_SCRIPT
- POSIX_SPAWN_DEBUG
- POSIX_SPAWN_EXEC
- POSIX_SPAWN_EXPLICIT_CPU
- POSIX_SPAWN_HOLD
- POSIX_SPAWN_NEWAPP
- POSIX_SPAWN_NOZOMBIE
- POSIX_SPAWN_PADDR64_SAFE
- POSIX_SPAWN_SEARCH_PATH
- POSIX_SPAWN_SETCRED
- POSIX_SPAWN_SETND
- POSIX_SPAWN_SETSID
- POSIX_SPAWN_SETSIGIGN
- POSIX_SPAWN_SETSTACKMAX
- 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().
The posix_spawnattr_getxflags() function is a BlackBerry 10 OS extension. POSIX specifies the posix_spawnattr_getflags() and posix_spawnattr_setflags() routines, which get and set only the POSIX flags.
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 |
Last modified: 2014-06-24