NAME    [Toc]    [Back]

       fgetgrent - get group file entry

SYNOPSIS    [Toc]    [Back]

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

       struct group *fgetgrent(FILE *stream);

DESCRIPTION    [Toc]    [Back]

       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    [Toc]    [Back]

       The fgetgrent() function returns the group  information	structure,  or
       NULL if there are no more entries or an error occurs.

ERRORS    [Toc]    [Back]

       ENOMEM Insufficient memory to allocate group information structure.

CONFORMING TO    [Toc]    [Back]

       SVID 3

SEE ALSO    [Toc]    [Back]

       getgrnam(3), getgrgid(3), getgrent(3), setgrent(3), endgrent(3)



GNU				  1993-04-04			  FGETGRENT(3)