putgrent(3)

🌸 putgrent(3) — Library Functions Manual 🌸

okay bestie, so this one is putgrent, from the Library Functions Manual, and it lives in the Standard C library (libc, -lc). it's the glow-up twin of writing group entries to a file. let's get into it 💅

---

✨ NAME ✨

putgrent — write a group database entry to a file

📚 LIBRARY 📚

Standard C library (libc, -lc)

🫶 SYNOPSIS 🫶

#define _GNU_SOURCE         /* See feature_test_macros(7) */
#include <grp.h>

int putgrent(const struct group *restrict grp, FILE *restrict stream);

💖 DESCRIPTION 💖

so putgrent() is literally the counterpart for fgetgrent(3). the way that it writes the content of the struct group you hand it into the stream. that's the whole vibe. 🦋

heads up bestie: the list of group members must be NULL-terminated or NULL-initialized. no half-finished lists, okay? that's the rule and we respect it. 💀

and the struct group is defined like this, no cap:

struct group {
    char   *gr_name;      /* group name */
    char   *gr_passwd;    /* group password */
    gid_t   gr_gid;       /* group ID */
    char  **gr_mem;       /* group members */
};

⭐ RETURN VALUE ⭐

the function returns zero on success, and a nonzero value on error. that's it, that's the tea. ✨

👑 ATTRIBUTES 👑

for an explanation of the terms used in this section, see attributes(7).

• putgrent() — Thread safety: MT-Safe

periodt. it's MT-Safe, she's safe, she's fine, she's iconic. 🎀

🌈 STANDARDS 🌈

GNU. (iykyk, it's a GNU thing 💜)

🦋 SEE ALSO 🦋

• fgetgrent(3)
• getgrent(3)
• group(5)

---

and that's the whole page, bestie!! this one's from Linux man-pages 6.20, dated 2026-02-08 🍓💖 mwah, go forth and write those group entries responsibly, ily, bye!! 🧚✨