NAME
fgetgrent - get group file entry
SYNOPSIS
#include <stdio.h>
#include <sys/types.h>
#include <grp.h>
I struct group *fgetgrent(FILE * stream );
DESCRIPTION
The
R 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
The
R fgetgrent ()
function returns the group information structure,
or NULL if there are no more entries or an error occurs.
ERRORS
ENOMEM
Insufficient memory to allocate group information structure.
CONFORMING TO
SVr4
SEE ALSO