posix_spawnattr_setxflags()

Set the possible attribute flags that can be set when a process is spawned

Synopsis:

#include <posix_spawnattr.h>

int posix_spawnattr_setxflags(
       posix_spawnattr_t *attrp,
       uint32_t flags);

Arguments:

attrp

A spawn attribute object.

flags

QNX provides several extended attribute settings to extend the range of possible flags values using a unit32_t type for these extended flags. The flags are:

• POSIX_SPAWN_SETPGROUP — set process group (00000001)
• POSIX_SPAWN_SETSIGMASK — set mask to sigmask (00000002)
• POSIX_SPAWN_SETSIGDEF — set members of sigdefault to SIG_DFL (00000004)
• POSIX_SPAWN_SETSCHEDULER — set members of sigignore to SIG_IGN (00000040)
• POSIX_SPAWN_SETSCHEDPARAM — Set the scheduling policy (00000400)
• POSIX_SPAWN_RESETIDS — reset IDs (0000)
• POSIX_SPAWN_SETND — spawn to remote node (00000100)
• POSIX_SPAWN_SETSIGIGN — set members of sigignore to SIG_IGN (00000008)
• POSIX_SPAWN_SETMPART — associate process with a set of memory partitions (00000010)
• POSIX_SPAWN_SETSPART — associate process with a scheduler partition (00000020)
• POSIX_SPAWN_EXPLICIT_CPU — Set the CPU affinity/runmask (00000800)
• POSIX_SPAWN_SETSTACKMAX — set the stack max (00001000)
• POSIX_SPAWN_NOZOMBIE — process will not zombie on death (00002000)
• POSIX_SPAWN_ALIGN_DEFAULT — use system default settings for alignment (00000000)
• POSIX_SPAWN_ALIGN_FAULT — try to always fault data misalignment references (01000000)
• POSIX_SPAWN_ALIGN_NOFAULT — don't fault on misalignment, and attempt to fix it; might be slow (02000000)

Description:

The posix_spawnattr_setxflags() function sets the extended spawn-flags attribute in an initialized attributes object referenced by attrp.

POSIX specifies posix_spawnattr_setflags() and posix_spawnattr_getflags() routines for the setting of predefined flags using a flags parameter, which is defined as a short type.

---

Any flag not defined in this list will not be able to be set, and therefore not cause any actions. The posix_spawnattr_setxflags() function is a QNX Neutrino extension to posix_spawnattr_t().

---

Returns:

Upon successful completion, posix_spawnattr_setxflags() returns zero; otherwise, an error number is returned to indicate the error (errno is set).

Errors:

EINVAL

For any invalid parameter.

ENOMEM

The partition Id couldn't be added to the attributes object.

EOK

Success.

Classification:

QNX Neutrino RTS

See also:

posix_spawn(), posix_spawn_file_actions_addclose(), posix_spawn_file_actions_adddup2(), posix_spawn_file_actions_addopen(), posix_spawn_file_actions_destroy(), posix_spawn_file_actions_init(), posix_spawnattr_addpartid(), posix_spawnattr_addpartition(), posix_spawnattr_destroy(), posix_spawnattr_getcred(), posix_spawnattr_getflags(), posix_spawnattr_getnode(), posix_spawnattr_getpartid(), posix_spawnattr_getpgroup(), posix_spawnattr_getrunmask(), posix_spawnattr_getschedparam(), posix_spawnattr_getschedpolicy(), posix_spawnattr_getsigdefault(), posix_spawnattr_getsigignore(), posix_spawnattr_getsigmask(), posix_spawnattr_getstackmax(), posix_spawnattr_getxflags(), posix_spawnattr_init(), posix_spawnattr_setcred(), posix_spawnattr_setflags(), posix_spawnattr_setnode(), posix_spawnattr_setpgroup(), posix_spawnattr_setschedparam(), posix_spawnattr_setrunmask(), posix_spawnattr_setschedpolicy(), posix_spawnattr_setsigdefault(), posix_spawnattr_setsigignore(), posix_spawnattr_setstackmax(), posix_spawnattr_setstackmax(), posix_spawnp()