Manpages

名 前

fgetpwent − パ ス ワ ー ド フ ァ イ ル エ ン ト リ ー の 取 り 出 し

書 式

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

struct passwd *fgetpwent(FILE *stream);

glibc 向 け の 機 能 検 査 マ ク ロ の 要 件 (feature_test_macros(7) 参 照 ):

fgetpwent(): _SVID_SOURCE

説 明

fgetpwent() 関 数 は 、 stream か ら 得 ら れ た 行 を 分 解 し た フ ィ ー ル ド を 含 む 構 造 体 へ の ポ イ ン タ ー を 返 す 。 最 初 に 呼 び 出 さ れ た 時 に は 最 初 の エ ン ト リ ー を 返 し 、 そ れ 以 降 は 次 の エ ン ト リ ー を 返 す 。 stream で 参 照 さ れ る フ ァ イ ル は /etc/passwd と 同 じ 形 式 で な け れ ば な ら な い (passwd(5) 参 照 )。

passwd 構 造 体 は 、 <pwd.h> で 以 下 の よ う に 定 義 さ れ て い る :

struct passwd {
char *pw_name; /* ユ ー ザ ー 名 */
char *pw_passwd; /* ユ ー ザ ー の パ ス ワ ー ド */
uid_t pw_uid; /* ユ ー ザ ー ID */
gid_t pw_gid; /* グ ル ー プ ID */
char *pw_gecos; /* 実 名 */
char *pw_dir; /* ホ ー ム デ ィ レ ク ト リ */
char *pw_shell; /* シ ェ ル プ ロ グ ラ ム */ };

返 り 値

fgetpwent() 関 数 は 、 passwd 構 造 体 へ の ポ イ ン タ ー を 返 す 。 こ れ 以 上 エ ン ト リ ー が 無 い か 、 エ ラ ー が 発 生 し た 場 合 は NULL を 返 す 。 エ ラ ー の 場 合 、 errno に 原 因 を 示 す 値 が 設 定 さ れ る 。

エ ラ ー

フ ァ イ ル

/etc/passwd パ ス ワ ー ド デ ー タ ベ ー ス フ ァ イ ル

準 拠

SVr4.

関 連 項 目

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

こ の 文 書 に つ い て

こ の man ペ ー ジ は Linux man−pages プ ロ ジ ェ ク ト の リ リ ー ス 3.79 の 一 部 で あ る 。 プ ロ ジ ェ ク ト の 説 明 と バ グ 報 告 に 関 す る 情 報 は http://www.kernel.org/doc/man−pages/ に 書 か れ て い る 。