FGETGRENTSection: Linux Programmer's Manual (3)
Index | Return to Main Contents
NAMEfgetgrent - get group file entry
#include <stdio.h> #include <sys/types.h> #include <grp.h> struct group *fgetgrent(FILE *stream);
Feature Test Macro Requirements for glibc (see feature_test_macros(7)):
DESCRIPTIONThe fgetgrent() function returns a pointer to a structure containing the group information from the file referred to by stream. The first time it is called it returns the first entry; thereafter, it returns successive entries. The file referred to by stream must have the same format as /etc/group (see group(5)).
The group structure is defined in <grp.h> as follows:
RETURN VALUEThe fgetgrent() function returns a pointer to a group structure, or NULL if there are no more entries or an error occurs. In the event of an error, errno is set to indicate the cause.
- Insufficient memory to allocate group structure.
ATTRIBUTESFor an explanation of the terms used in this section, see attributes(7).
|fgetgrent()||Thread safety||MT-Unsafe race:fgetgrent|
SEE ALSOendgrent(3), fgetgrent_r(3), fopen(3), getgrent(3), getgrgid(3), getgrnam(3), putgrent(3), setgrent(3), group(5)
COLOPHONThis page is part of release 4.15 of the Linux man-pages project. A description of the project, information about reporting bugs, and the latest version of this page, can be found at https://www.kernel.org/doc/man-pages/.
Return to Main Contents