GNU/Linux |
RedHat 5.2(Apollo) |
|
![]() |
getgrent(3) |
![]() |
getgrent, setgrent, endgrent − get group file entry
#include
<grp.h>
#include <sys/types.h>
struct group *getgrent(void);
void setgrent(void);
void endgrent(void);
The getgrent() function returns a pointer to a structure containing the group information from /etc/group. The first time it is called it returns the first entry; thereafter, it returns successive entries.
The setgrent() function rewinds the file pointer to the beginning of the /etc/group file.
The endgrent() function closes the /etc/group file.
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 */
};
The getgrent() function returns the group information structure, or NULL if there are no more entries or an error occurs.
ENOMEM |
Insufficient memory to allocate group information structure. |
/etc/group
group database file
SVID 3, BSD 4.3
fgetgrent(3), getgrnam(3), getgrgid(3)
![]() |
getgrent(3) | ![]() |