posix_spawnattr_setflags(3)

posix_spawnattr_setflags3

Get and set the spawn-flags attribute of a spawn attributes object

Part of posix_spawnattr_getflags(3).

Usage

#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);

Library

Standard C Library (libc, -lc)

Overview

The posix_spawnattr_getflags() function obtains the value of the spawn-flags attribute from the attributes object referenced by attr.

The posix_spawnattr_setflags() function sets the spawn-flags attribute in an initialized attributes object referenced by attr.

The spawn-flags attribute is used to indicate which process attributes are to be changed in the new process image when invoking posix_spawn() or posix_spawnp(). It is the bitwise-inclusive OR of zero or more of the following flags (see posix_spawn()):

POSIX_SPAWN_RESETIDS
POSIX_SPAWN_SETPGROUP
POSIX_SPAWN_SETSIGDEF
POSIX_SPAWN_SETSIGMASK
POSIX_SPAWN_SETSCHEDPARAM
POSIX_SPAWN_SETSCHEDULER
POSIX_SPAWN_DISABLE_ASLR_NP

These flags are defined in ⟨spawn.h⟩. The default value of this attribute is as if no flags were set.

Return values

The posix_spawnattr_getflags() function returns zero. The posix_spawnattr_setflags() function returns zero on success, and EINVAL on failure due to invalid flag specified.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 28 times.

  1. 8.0
  2. 8.1
  3. 8.2
  4. 8.3
  5. 8.4
  6. 9.0
  7. 9.1
  8. 9.2
  9. 9.3
  10. 10.0
  11. 10.1
  12. 10.2
  13. 10.3
  14. 10.4
  15. 11.0
  16. 11.1
  17. 11.2
  18. 11.3
  19. 11.4
  20. 12.0
  21. 12.1
  22. 12.2
  23. 12.3
  24. 12.4
  25. 13.0–13.2
  26. 13.3
  27. 13.4–13.5
  28. 14.0
  29. 14.1–16.0

Standards

The posix_spawnattr_getflags() and posix_spawnattr_setflags() functions conform to IEEE Std 1003.1-2001 (“POSIX.1”).

History

The posix_spawnattr_getflags() and posix_spawnattr_setflags() functions first appeared in FreeBSD 8.0.

Authors

Ed Schouten ⟨[email protected]⟩

From base 16.0-CURRENT-20261027-61c70dc16a79 in FreeBSD 16.0-CURRENT (2026-10-27). Parsed by carta from the page's mdoc source.