GNU/Linux |
RedHat 6.2(Zoot) |
|
![]() |
getgrnam(3) |
![]() |
getgrnam, getgrgid − get group file entry
#include
<grp.h>
#include <sys/types.h>
struct group *getgrnam(const char *name);
struct group *getgrgid(gid_t gid);
The getgrnam() function returns a pointer to a structure containing the group information from /etc/group for the entry that matches the group name name.
The getgrgid() function returns a pointer to a structure containing the group information from /etc/group for the entry that matches the group gid gid.
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 getgrnam() and getgrgid() functions return the group information structure, or NULL if the matching entry is not found or an error occurs.
ENOMEM |
Insufficient memory to allocate group information structure. |
/etc/group
Group database file
SVID 3, POSIX, BSD 4.3
fgetgrent(3), getgrent(3), setgrent(3), endgrent(3)
![]() |
getgrnam(3) | ![]() |