GETPGRP(3POSIX)

📦 version 2017a, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu resolute, ubuntu stonking

💖 GETPGRP(3POSIX) — bestie, it's the POSIX Programmer's Manual 💖

okay so before we even get into it — this page is part of the POSIX Programmer's Manual, k? And like, a heads up, the Linux version of this same interface might act different (so go check the Linux man page for the actual Linux tea), or honestly it might not even be implemented on Linux at all. 🙈

✨ PROLOG ✨

This manual page is part of the POSIX Programmer's Manual. The Linux implementation of this interface may differ — consult the corresponding Linux manual page for details of Linux behavior — or the interface may not be implemented on Linux. so like. vibe check your platform first, bestie 🫶

🌸 NAME 🌸

getpgrp — get the process group ID of the calling process

it's giving "who's my group, bestie?" and the answer is you're literally about to find out 💅

🎀 SYNOPSIS 🎀

#include <unistd.h>

pid_t getpgrp(void);

no arguments, no drama, she takes void and she means it ✨

🦋 DESCRIPTION 🦋

The getpgrp() function shall return the process group ID of the calling process. that's it. that's the whole function. iconic, unbothered, zero notes 👑

🌈 RETURN VALUE 🌈

The getpgrp() function shall always be successful and no return value is reserved to indicate an error. like she literally cannot fail, main character energy fr fr 💖

⭐ ERRORS ⭐

No errors are defined.

The following sections are informative.

💀 EXAMPLES 💀

None. (not a single one. she's that simple, no cap 🎀)

🧚 APPLICATION USAGE 🧚

None.

👑 RATIONALE 👑

so the lore is: 4.3 BSD provides a getpgrp() function that returns the process group ID for a specified process. And like yeah, that version supports job control and everything, but plot twist — all known job control shells always specify the calling process with this function anyway. so the simpler System V getpgrp() suffices, and the added complexity of the 4.3 BSD getpgrp() is provided by the XSI extension getpgid(). periodt. simplicity ate 💅✨

🔥 FUTURE DIRECTIONS 🔥

None. she's not going anywhere, she's perfect as she is 💜

🌸 SEE ALSO 🌸

  • exec
  • fork()
  • getpgid()
  • getpid()
  • getppid()
  • kill()
  • setpgid()
  • setsid()

The Base Definitions volume of POSIX.1‐2017, <sys_types.h>, <unistd.h> 🦋

Portions of this text are reprinted and reproduced in electronic form from IEEE Std 1003.1-2017, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 7, 2018 Edition, Copyright (C) 2018 by the Institute of Electrical and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between this version and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html .

Any typographical or formatting errors that appear in this page are most likely to have been introduced during the conversion of the source files to man page format. To report such errors, see https://www.kernel.org/doc/man-pages/reporting_bugs.html .

no cap, that whole copyright block is the legal version of "please don't come for me, the original standard is the real referee" 😭🫶

and that's the whole page bestie!! brought to you by IEEE/The Open Group, 2017 — this was GETPGRP(3POSIX) and she ate, mwah 💅💖✨

📦 where this page comes from