Linux程序员手册 第3部分
更新日期： 2017-09-15

名称

fgetgrent-获取组文件条目

语法

#include <stdio.h>
#include <sys/types.h>
#include <grp.h>

struct group *fgetgrent(FILE *stream);

glibc的功能测试宏要求(请参阅feature_test_macros(7))：

fgetgrent()：
从glibc 2.19开始：
_DEFAULT_SOURCE
Glibc 2.19及更早版本：
_SVID_SOURCE

说明

fgetgrent()函数返回一个指向结构的指针，该结构包含流引用的文件中的组信息。第一次调用它会返回第一个条目。此后，它将返回连续的条目。流引用的文件必须具有与/ etc / group相同的格式(请参阅group(5))。

组结构定义如下：

struct group {
    char   *gr_name;        /* group name */
    char   *gr_passwd;      /* group password */
    gid_t   gr_gid;         /* group ID */
    char  **gr_mem;         /* NULL-terminated array of pointers
                               to names of group members */
};

返回值

fgetgrent()函数返回一个指向组结构的指针，如果没有更多条目或发生错误，则返回NULL。如果发生错误，则设置errno来指示原因。

错误说明

ENOMEM

内存不足，无法分配组结构。

属性

有关本节中使用的术语的说明，请参见attribute(7)。

遵循规范

SVr4。

另外参见

endgrent(3)，fgetgrent_r(3)，fopen(3)，getgrent(3)，getgrgid(3)，getgrnam(3)，putgrent(3)，setgrent(3)，group(5)

出版信息

这个页面是Linux手册页项目5.08版的一部分。有关项目的说明、有关报告错误的信息以及此页面的最新版本，请访问https://www.kernel.org/doc/man-pages/。