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 *fp);

DESCRIPTION
       The putgrent() function is the counterpart for fgetgrent(3).  The function writes the con‐
       tent of the provided struct group into the file pointed to by fp.  The list of group  mem‐
       bers 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.

CONFORMING TO
       This function is a GNU extension.

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

COLOPHON
       This  page  is  part of release 3.74 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 http://www.kernel.org/doc/man-pages/.



GNU                                         2003-09-09                                PUTGRENT(3)