pgfind(9)

pgfind9

Locate a process group by number

Usage

#include <sys/param.h>

#include <sys/proc.h>

struct pgrp *

pgfind(pid_t pgid);

Overview

The pgfind() function takes a pgid as its argument and returns a pointer to the pgrp structure whose pg_id is specified in the argument.

pgfind() locks the pgrp structure that is returned.

Return values

The pgfind() function returns NULL on failure or a pointer to a pgrp structure on successful completion.

Releases

56 releases since FreeBSD 5.0-RELEASE; the text changed 34 times.

  1. 5.0–5.1
  2. 5.2–5.5
  3. 6.0–6.3
  4. 6.4
  5. 7.0
  6. 7.1
  7. 7.2
  8. 7.3
  9. 7.4
  10. 8.0
  11. 8.1
  12. 8.2
  13. 8.3
  14. 8.4
  15. 9.0
  16. 9.1
  17. 9.2
  18. 9.3
  19. 10.0
  20. 10.1
  21. 10.2
  22. 10.3
  23. 10.4
  24. 11.0
  25. 11.1
  26. 11.2
  27. 11.3
  28. 11.4
  29. 12.0
  30. 12.1
  31. 12.2
  32. 12.3
  33. 12.4
  34. 13.0–13.2
  35. 13.3–16.0

Authors

This manual page was written by Evan Sarmiento ⟨[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.