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)。
Interface | Attribute | Value |
fgetpwent() | Thread safety | MT-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/。