dwww Home | Manual pages | Find package

PUTGRENT(3)                Linux Programmer's Manual               PUTGRENT(3)

NAME
       putgrent - write a group database entry to a file

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

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

DESCRIPTION
       The putgrent() function is the counterpart for fgetgrent(3).  The func-
       tion writes the content of the provided struct group into  the  stream.
       The list of group members must be NULL-terminated or NULL-initialized.

       The struct group is defined as follows:

           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.

ATTRIBUTES
       For  an  explanation  of  the  terms  used  in  this  section,  see at-
       tributes(7).

       ┌───────────┬───────────────┬─────────┐
       │InterfaceAttributeValue   │
       ├───────────┼───────────────┼─────────┤
       │putgrent() │ Thread safety │ MT-Safe │
       └───────────┴───────────────┴─────────┘

CONFORMING TO
       This function is a GNU extension.

SEE ALSO
       fgetgrent(3), getgrent(3), group(5)

COLOPHON
       This page is part of release 5.10 of the Linux  man-pages  project.   A
       description  of  the project, information about reporting bugs, and the
       latest    version    of    this    page,    can     be     found     at
       https://www.kernel.org/doc/man-pages/.

GNU                               2017-09-15                       PUTGRENT(3)

Generated by dwww version 1.14 on Mon Dec 23 01:09:43 CET 2024.