posix_spawnattr_setflags()

Updated: April 19, 2023

Set the POSIX flags in a spawn attributes object

Synopsis:

#include <spawn.h>

int posix_spawnattr_setflags(
       posix_spawnattr_t *attrp,
       short flags);

Arguments:

attrp
A pointer to the spawn attributes object that you want to modify.
flags
A bitwise OR of the POSIX flags you want to store in the spawn attributes:
  • POSIX_SPAWN_SETPGROUP
  • POSIX_SPAWN_SETSIGMASK
  • POSIX_SPAWN_SETSIGDEF
  • POSIX_SPAWN_SETSCHEDULER
  • POSIX_SPAWN_SETSCHEDPARAM
  • POSIX_SPAWN_RESETIDS

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.

Description:

The posix_spawnattr_setflags() function stores the POSIX flags in the spawn attributes object pointed to by attrp, overwriting any previously saved POSIX flags. You must have already initialized the spawn attributes object by calling posix_spawnattr_init().

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().

Note: You can't use this function to set the extended flags that QNX Neutrino defines:
  • POSIX_SPAWN_ALIGN_DEFAULT
  • POSIX_SPAWN_ALIGN_FAULT
  • POSIX_SPAWN_ALIGN_NOFAULT
  • POSIX_SPAWN_ASLR_INVERT
  • 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_SETCRED
  • POSIX_SPAWN_SETND
  • POSIX_SPAWN_SETSID
  • POSIX_SPAWN_SETSIGIGN
  • POSIX_SPAWN_SETSTACKMAX
  • POSIX_SPAWN_TCSETPGROUP

To set the extended flags, use posix_spawnattr_setxflags(). The posix_spawnattr_setflags() function doesn't affect any extended flags that you previously set in the spawn attributes object.

Returns:

EOK
Success.
EINVAL
An argument was invalid.

Examples:

See posix_spawn().

Classification:

POSIX 1003.1 SPN

Safety:  
Cancellation point No
Interrupt handler Yes
Signal handler Yes
Thread Yes