2.11BSD#431 - /usr/man/cat3/getgrent.0

GETGRENT(3)	    UNIX Programmer's Manual	      GETGRENT(3)


NAME
     getgrent, getgrgid, getgrnam, setgrent, endgrent - get group
     file entry

SYNOPSIS
     #include <grp.h>

     struct group *getgrent()

     struct group *getgrgid(gid)
     int gid;

     struct group *getgrnam(name)
     char *name;

     setgrent()

     endgrent()

DESCRIPTION
     Getgrent, getgrgid and getgrnam each return pointers to an
     object with the following structure containing the broken-
     out fields of a line in the group file.

	  /*   grp.h	 4.1  83/05/03	*/

	  struct    group { /* see getgrent(3) */
	       char *gr_name;
	       char *gr_passwd;
	       int  gr_gid;
	       char **gr_mem;
	  };

	  struct group *getgrent(), *getgrgid(), *getgrnam();

     The members of this structure are:

     gr_name	The name of the group.
     gr_passwd	The encrypted password of the group.
     gr_gid	The numerical group-ID.
     gr_mem	Null-terminated vector of pointers to the indivi-
		dual member names.

     Getgrent simply reads the next line while getgrgid and get-
     grnam search until a matching gid or name is found (or until
     EOF is encountered).  Each routine picks up where the others
     leave off so successive calls may be used to search the
     entire file.

     A call to setgrent has the effect of rewinding the group
     file to allow repeated searches.  Endgrent may be called to
     close the group file when processing is complete.


Printed 11/26/99	  May 15, 1985				1


GETGRENT(3)	    UNIX Programmer's Manual	      GETGRENT(3)


FILES
     /etc/group

SEE ALSO
     getlogin(3), getpwent(3), group(5)

DIAGNOSTICS
     A null pointer (0) is returned on EOF or error.

BUGS
     All information is contained in a static area so it must be
     copied if it is to be saved.


Printed 11/26/99	  May 15, 1985				2