ENDGRENT(3) Library Functions Manual ENDGRENT(3)

endgrent getgrent setgrent — group database entry functions

#include <grp.h>

void endgrent(void);
struct group *getgrent(void);
void setgrent(void);

The getgrent(3) function returns a pointer to a structure containing the broken-out fields of an entry in the group database. When first called, getgrent(3) returns a pointer to a group structure containing the first entry in the group database. Thereafter, it returns a pointer to a group structure containing the next group structure in the group database, so successive calls may be used to search the entire database.

The function effectively rewinds the group database to allow repeated searches.

The function may be called to close the group database when processing is complete.

These interfaces need not be reentrant.

When first called, getgrent(3) will return a pointer to the first group structure in the group database. Upon subsequent calls it returns the next group structure in the group database. The getgrent(3) function returns a null pointer on end-of-file or an error and errno may be set to indicate the error.

The return value may point to a static area which is overwritten by a subsequent call to , or .

The getgrent(3) function may fail if:

A signal was caught during the operation.
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.

None.

These functions are provided due to their historical usage. Applications should avoid dependencies on fields in the group database, whether the database is a single file, or where in the filesystem namespace the database resides. Applications should use getgrnam(3) and getgrgid(3) whenever possible both because it avoids these dependencies and for greater portability with systems that conform to earlier versions of this specification.

None.

getgrgid(3) , getgrnam(3) , getlogin(3) , getpwent(3) , <grp.h> .

February 1997 posix.fail