# 2.11BSD#431 - /usr/man/cat3/endgrent.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

Generated: 2016-12-26 | Generated by man2html V0.25 page hit count: 266 |