FGETGRENT - Linux手册页

时间:2019-08-20 18:00:18  来源:igfitidea点击:

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)。

InterfaceAttributeValue
fgetgrent()Thread safetyMT-Unsafe race:fgetgrent

遵循规范

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/