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

NAME
       fgetgrent - get group file entry

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

       struct group *fgetgrent(FILE *stream);

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

       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  the group information
       structure, or NULL if there are  no  more  entries  or  an
       error occurs.

ERRORS
       ENOMEM Insufficient  memory  to allocate group information
              structure.

CONFORMING TO
       SVID 3

SEE ALSO
       getgrnam(3), getgrgid(3), getgrent(3),  setgrent(3),  end-
       grent(3)

GNU                       April 4, 1993                         1