NAME

       fgetgrent - get group file entry

SYNOPSIS

       #include <stdio.h>
       #include <sys/types.h>
       #include <grp.h>

       struct group *fgetgrent(FILE *stream);

   Feature Test Macro Requirements for glibc (see feature_test_macros(7)):

       fgetgrent(): _SVID_SOURCE

DESCRIPTION

       The  fgetgrent() function returns a pointer to a structure containing the group information from the file
       referred to by stream.  The first time it is called it returns the first entry;  thereafter,  it  returns
       successive  entries.   The  file  referred  to  by  stream  must  have the same format as /etc/group (see
       group(5)).

       The group structure is defined in <grp.h> as follows:

           struct group {
               char   *gr_name;        /* group name */
               char   *gr_passwd;      /* group password */
               gid_t   gr_gid;         /* group ID */
               char  **gr_mem;         /* NULL-terminated array of pointers
                                          to names of group members */
           };

RETURN VALUE

       The fgetgrent() function returns a pointer to a group structure, or NULL if there are no more entries  or
       an error occurs.  In the event of an error, errno is set to indicate the cause.

ERRORS

       ENOMEM Insufficient memory to allocate group structure.

ATTRIBUTES

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

       ┌────────────┬───────────────┬──────────────────────────┐
       │Interface   │ Attribute     │ Value                    │
       ├────────────┼───────────────┼──────────────────────────┤
       │fgetgrent() │ Thread safety │ MT-Unsafe race:fgetgrent │
       └────────────┴───────────────┴──────────────────────────┘

CONFORMING TO

       SVr4.

SEE ALSO

       endgrent(3),  fgetgrent_r(3),  fopen(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3), setgrent(3),
       group(5)

COLOPHON

       This page is part of release 4.04 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/.