.\" Updated 2008-08-01, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
.TH FGETPWENT 3 2008-07-10 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-fgetpwent \- ¥Ñ¥¹¥ï¡¼¥É¥Õ¥¡¥¤¥ë¥¨¥ó¥È¥ê¤Î¼è¤ê½Ð¤·
-.SH ½ñ¼°
+.SH 名前
+fgetpwent \- パスワードファイルエントリの取り出し
+.SH 書式
.nf
.B #include <stdio.h>
.B #include <sys/types.h>
.fi
.sp
.in -4n
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
+glibc 向けの機能検査マクロの要件
.RB ( feature_test_macros (7)
-»²¾È):
+参照):
.in
.sp
.BR fgetpwent ():
_SVID_SOURCE
-.SH ÀâÌÀ
+.SH 説明
.BR fgetpwent ()
-´Ø¿ô¤Ï¡¢\fIstream\fP ¤«¤éÆÀ¤é¤ì¤¿¹Ô¤òʬ²ò¤·¤¿¥Õ¥£¡¼¥ë¥É
-¤ò´Þ¤à¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-ºÇ½é¤Ë¸Æ¤Ó½Ð¤µ¤ì¤¿»þ¤Ë¤ÏºÇ½é¤Î¥¨¥ó¥È¥ê¤òÊÖ¤·¡¢¤½¤ì°Ê¹ß¤Ï
-¼¡¤Î¥¨¥ó¥È¥ê¤òÊÖ¤¹¡£
+関数は、\fIstream\fP から得られた行を分解したフィールド
+を含む構造体へのポインタを返す。
+最初に呼び出された時には最初のエントリを返し、それ以降は
+次のエントリを返す。
.I stream
-¤Ç»²¾È¤µ¤ì¤ë¥Õ¥¡¥¤¥ë¤Ï
+で参照されるファイルは
.I /etc/passwd
-¤ÈƱ¤¸·Á¼°¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤
+と同じ形式でなければならない
.RB ( passwd (5)
-»²¾È)¡£
+参照)。
.PP
-\fIpasswd\fP ¹½Â¤ÂΤϡ¢\fI<pwd.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+\fIpasswd\fP 構造体は、\fI<pwd.h>\fP で以下のように定義されている:
.sp
.nf
.in +4n
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; /* ¥·¥§¥ë¥×¥í¥°¥é¥à */
+ char *pw_name; /* ユーザ名 */
+ char *pw_passwd; /* ユーザのパスワード */
+ uid_t pw_uid; /* ã\83¦ã\83¼ã\82¶ ID */
+ gid_t pw_gid; /* グループ ID */
+ char *pw_gecos; /* 本名 */
+ char *pw_dir; /* ホームディレクトリ */
+ char *pw_shell; /* シェルプログラム */
};
.fi
.in
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.BR fgetpwent ()
-´Ø¿ô¤Ï¡¢
+関数は、
.I passwd
-¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¤³¤ì°Ê¾å¥¨¥ó¥È¥ê¤¬Ìµ¤¤¤«¡¢¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
-.SH ¥¨¥é¡¼
+構造体へのポインタを返す。
+これ以上エントリが無いか、エラーが発生した場合は NULL を返す。
+.SH ã\82¨ã\83©ã\83¼
.TP
.B ENOMEM
.I passwd
-¹½Â¤ÂΤò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
-.SH ¥Õ¥¡¥¤¥ë
+構造体を割り当てるためのメモリが不十分。
+.SH ファイル
.TP
.I /etc/passwd
-¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.SH ½àµò
+パスワードデータベースファイル
+.SH 準拠
SVr4.
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR endpwent (3),
.BR fgetpwent_r (3),
.BR fopen (3),