posix_spawnattr_getflags(3) - OpenBSD manual pages

NAME

posix_spawnattr_getflags, posix_spawnattr_setflags — get or set flags of a posix_spawn attributes object

#include <spawn.h>

int
posix_spawnattr_getflags(const posix_spawnattr_t *restrict attr, short *restrict flags);

int
posix_spawnattr_setflags(posix_spawnattr_t *attr, short flags);

The posix_spawnattr_getflags() and posix_spawnattr_setflags() functions are used to get or set the flags part of a posix_spawn(3) attribute object referenced by attr.

Flag values are OR-ed from the following flags:

POSIX_SPAWN_RESETIDS: Reset the effective user and group ID of the child process to the parent's real user and group ID; see setegid(2).
If the new process is created from a set-user-ID or set-group-ID file, usual execve(2) semantics take precedence.
POSIX_SPAWN_SETPGROUP: Set the process group of the child process according to the pgroup attribute of the object; see posix_spawnattr_getpgroup(3) and setpgid(2).
POSIX_SPAWN_SETSIGDEF: Reset signals set by posix_spawnattr_setsigdefault(3) to their default value in the child process.
POSIX_SPAWN_SETSIGMASK: Set the signal mask of the child process according to the value set by posix_spawnattr_setsigmask(3), using sigprocmask(2).
POSIX_SPAWN_SETSCHEDPARAM: Set the scheduling parameter of the child process according to the value set by posix_spawnattr_setschedparam(3) (mandated by IEEE Std 1003.1-2001 (“POSIX.1”), this implementation currently does nothing).
POSIX_SPAWN_SETSCHEDULER: Set the scheduler policy of the child process according to the value set by posix_spawnattr_setschedpolicy(3) (mandated by IEEE Std 1003.1-2001 (“POSIX.1”), this implementation currently does nothing).

posix_spawnattr_init(3) initializes this value to no flags set.

Both functions return 0.

Both functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).