posix_spawnattr_setflags()

Set the POSIX flags in a spawn attributes object

Synopsis:

#include <spawn.h>

int posix_spawnattr_setflags(
       posix_spawnattr_t *attrp,
       short flags);

Since:

BlackBerry 10.0.0

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

You can't use this function to set the extended flags that BlackBerry 10 OS defines:

  • 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

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.

Classification:

POSIX 1003.1 SPN

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

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus