FGETGRENT(3)		   Linux Programmers Manual		 FGETGRENT(3)



NAME
       fgetgrent - get group file entry

SYNOPSIS
       #include 
       #include 
       #include 

       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  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), getgr
       nam(3), putgrent(3), setgrent(3), group(5)

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



GNU				  2008-07-10			  FGETGRENT(3)