getgrent

Syntax

#include <grp.h> struct group *getgrent(void);

Description

This function returns the next available group entry. Note that for MS-DOS, this is simulated. If the environment variable GROUP is set, that is the name of the only group returned, else the only group is "dos". Thus, under DOS, getgrent will always fail on the second and subsequent calls.

The return type of this and related function is as follows:

struct group { gid_t gr_gid; /* result of getgid() */ char ** gr_mem; /* gr_mem[0] points to getenv("USER"/"LOGNAME") or "user" */ char * gr_name; /* getenv("GROUP") or "dos" */ char * gr_passwd; /* "" */ };

Return Value

The next structure, or NULL at the end of the list.

Portability

ANSI/ISO C	No
POSIX	No

Example

struct group *g; setgrent(); while ((g = getgrent()) != NULL) { printf("group %s gid %d\n", g->gr_name, g->gr_gid); } endgrent();