Provided by: manpages-dev_3.35-0.1ubuntu1_all bug

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;         /* 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.

ERRORS

       ENOMEM Insufficient memory to allocate group structure.

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 3.35 of the Linux man-pages project.  A
       description of the project, and information about reporting  bugs,  can
       be found at http://man7.org/linux/man-pages/.