posix_spawnattr_getpgroup(3)

posix_spawnattr_getpgroup3

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

Usage

#include <spawn.h>

int

posix_spawnattr_getpgroup(const posix_spawnattr_t *restrict attr, pid_t *restrict pgroup);

int

posix_spawnattr_setpgroup(posix_spawnattr_t *attr, pid_t pgroup);

Library

Standard C Library (libc, -lc)

Overview

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

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

The spawn-pgroup attribute represents the process group to be joined by the new process image in a spawn operation (if POSIX_SPAWN_SETPGROUP is set in the spawn-flags attribute). The default value of this attribute is zero.

Return values

The posix_spawnattr_getpgroup() and posix_spawnattr_setpgroup() functions return zero.

Releases

39 releases since FreeBSD 8.0-RELEASE; the text changed 25 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–16.0

Standards

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

History

The posix_spawnattr_getpgroup() and posix_spawnattr_setpgroup() 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.