语法

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

struct passwd *fgetpwent(FILE *stream);

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

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

名称

fgetpwent-获取密码文件条目

遵循规范

SVr4。

错误说明

ENOMEM

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

Linux程序员手册 第3部分
更新日期： 2018-02-02

返回值

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

出版信息

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

文件

/etc/passwd

密码数据库文件

另外参见

endpwent(3)，fgetpwent_r(3)，fopen(3)，getpw(3)，getpwent(3)，getpwnam(3)，getpwuid(3)，putpwent(3)，setpwent(3)，passwd(5)

属性

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

说明

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

passwd结构的定义如下：

struct passwd {
    char   *pw_name;       /* username */
    char   *pw_passwd;     /* user password */
    uid_t   pw_uid;        /* user ID */
    gid_t   pw_gid;        /* group ID */
    char   *pw_gecos;      /* real name */
    char   *pw_dir;        /* home directory */
    char   *pw_shell;      /* shell program */
};