FGETPWENT - Linux手册页

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

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

名称

fgetpwent-获取密码文件条目

语法

#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()函数返回一个指向结构的指针,该结构包含文件流中一行的中断字段。第一次调用它会返回第一个条目。此后,它将返回连续的条目。流引用的文件必须具有与/ 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 */
};

返回值

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

错误说明

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

文件

/etc/passwd
密码数据库文件

属性

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

InterfaceAttributeValue
fgetpwent()Thread safetyMT-Unsafe race:fgetpwent

遵循规范

SVr4。

另外参见

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

出版信息

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