debian man page for fgetgrent

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

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.44 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)