getgrent(3C)															      getgrent(3C)

NAME

       getgrent(), getgrgid(), getgrgid_r(), getgrnam(), getgrnam_r(), setgrent(), endgrent(), fgetgrent() - get group file entry

SYNOPSIS

   Obsolescent Interfaces
DESCRIPTION

       and are used to obtain group entries, and return a pointer to an object of structure.  An entry may come from any of the sources for speci-
       fied in the file.  See nsswitch.conf(4).

       The structure is defined in and includes the following members:

       When first called,  returns a pointer to the first structure in the group database; thereafter, it returns a pointer to the next  structure
			   in the database.  In this way, successive calls can be used to search the entire database;

       Has the effect of rewinding the group database to allow repeated searches;

       Can be called to indicate that group database processing is complete;

       Searches from the beginning of the group database until a numeric group ID
			   matching gid is found, and returns a pointer to the particular structure in which it was found;

       Searches from the beginning of the group database until a group name matching
			   name is found, and returns a pointer to the particular structure in which it was found;

       Returns a pointer to the next
			   structure in the standard I/O stream stream, which should be open for reading, and its contents should match the format
			   of

   Obsolescent Interfaces
       get group file entry.

   Reentrant Interfaces
       and both update the group pointed to by and store a pointer to that structure at the location pointed to by The structure shall contain	an
       entry from the group database with a matching or Storage referenced by the group structure pointed to by shall be allocated from the memory
       provided with the parameter, which is in size.  The maximum size needed for this buffer can be  determined  with  the  parameter.   A  NULL
       pointer is returned at the location pointed to by on error or if the requested entry is not found.

RETURN VALUE

       and  return  a NULL pointer if an end-of-file or error is encountered on reading.  Otherwise, the return value points to an internal static
       area containing a valid structure.

       and return zero upon success.  Otherwise, an error number is returned to indicate the error.

ERRORS

       and fail if any of the following are true:

	      An I/O error has occurred.

	      OPEN_MAX	  file descriptors are currently open in the calling process.

	      The maximum allowable number of files is currently
			  open in the system.

       The and functions will fail if:

	      Insufficient storage was supplied via
			  buffer and bufsize to contain the data to be referenced by the resulting group structure.

WARNINGS

       The value returned by and points to an area that is overwritten by each call to any of the functions.  It must be copied if  it	is  to	be
       saved.

       Users  of  and  should note that these interfaces now conform with POSIX.1c.  and are obsolescent interfaces.  These interfaces and the old
       prototypes of and are supported for compatibility with existing DCE applications only.

       The interfaces and use the Dynamic Name Service Switch.	(See nsswitch.conf(4).)  An application that uses these interfaces cannot be fully
       archive bound.

DEPENDENCIES

   NFS
       ypcat(1).

FILES

SEE ALSO

       ypcat(1), getgroups(2), getpwent(3C), stdio(3S), group(4), thread_safety(5).

STANDARDS CONFORMANCE

																      getgrent(3C)