.\"
.TH GETPWENT 3 2013\-06\-21 GNU "Linux Programmer's Manual"
.SH 名前
-getpwent, setpwent, endpwent \- パスワードファイルのエントリの取得
+getpwent, setpwent, endpwent \- ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83\95ã\82¡ã\82¤ã\83«ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\81®å\8f\96å¾\97
.SH 書式
.nf
\fB#include <sys/types.h>\fP
.RE
.ad b
.SH 説明
-\fBgetpwent\fP() é\96¢æ\95°ã\81¯ã\80\81ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83»ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8bã\82\89å\8f\96å¾\97ã\81\97ã\81\9fã\82¨ã\83³ã\83\88ã\83ªã\82\92 è¦\81ç´ æ¯\8eã\81«å\88\86解ã\81\97ã\80\81å\90\84è¦\81ç´ ã\82\92æ ¼ç´\8dã\81\97ã\81\9fæ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿を返す
-(ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83»ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81®ä¾\8b: ã\83ã\83¼ã\82«ã\83«ã\81®ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83\95ã\82¡ã\82¤ã\83« \fI/etc/passwd\fP, NIS, LDAP)ã\80\82 \fBgetpwent\fP()
-ã\81¯ã\80\81æ\9c\80å\88\9dã\81«å\91¼ã\81³å\87ºã\81\95ã\82\8cã\81\9fæ\99\82ã\81¯æ\9c\80å\88\9dã\81®ã\82¨ã\83³ã\83\88ã\83ªã\82\92è¿\94ã\81\97ã\80\81ã\81\9dã\82\8c以é\99\8dã\81¯ å\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bæ¯\8eã\81«æ¬¡ã\81®ã\82¨ã\83³ã\83\88ã\83ªを返す。
+\fBgetpwent\fP() é\96¢æ\95°ã\81¯ã\80\81ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81\8bã\82\89å\8f\96å¾\97ã\81\97ã\81\9fã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92 è¦\81ç´ æ¯\8eã\81«å\88\86解ã\81\97ã\80\81å\90\84è¦\81ç´ ã\82\92æ ¼ç´\8dã\81\97ã\81\9fæ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼を返す
+(パスワードデータベースの例: ローカルのパスワードファイル \fI/etc/passwd\fP, NIS, LDAP)。 \fBgetpwent\fP()
+ã\81¯ã\80\81æ\9c\80å\88\9dã\81«å\91¼ã\81³å\87ºã\81\95ã\82\8cã\81\9fæ\99\82ã\81¯æ\9c\80å\88\9dã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92è¿\94ã\81\97ã\80\81ã\81\9dã\82\8c以é\99\8dã\81¯ å\91¼ã\81³å\87ºã\81\95ã\82\8cã\82\8bæ¯\8eã\81«æ¬¡ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼を返す。
.PP
-\fBsetpwent\fP() é\96¢æ\95°ã\82\92使ã\81\86ã\81¨ã\80\81ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83»ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\81®å\85\88é ã\81«æ\88»ã\82\8bã\80\82
+\fBsetpwent\fP() 関数を使うと、パスワードデータベースの先頭に戻る。
.PP
-\fBendpwent\fP() 関数は、全ての処理が終わった後にパスワード・ データベースをクローズする。
+\fBendpwent\fP() 関数は、全ての処理が終わった後にパスワード データベースをクローズする。
.PP
\fIpasswd\fP 構造体は、\fI<pwd.h>\fP で以下のように定義されている:
.sp
.in +4n
.nf
struct passwd {
- char *pw_name; /* ユーザ名 */
- char *pw_passwd; /* ユーザのパスワード */
- uid_t pw_uid; /* ユーザ ID */
+ char *pw_name; /* ユーザー名 */
+ char *pw_passwd; /* ã\83¦ã\83¼ã\82¶ã\83¼ã\81®ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89 */
+ uid_t pw_uid; /* ユーザー ID */
gid_t pw_gid; /* グループ ID */
- char *pw_gecos; /* ユーザ情報 */
+ char *pw_gecos; /* ユーザー情報 */
char *pw_dir; /* ホームディレクトリ */
char *pw_shell; /* シェルプログラム */
};
.PP
この構造体のフィールドの詳細は \fBpasswd\fP(5) を参照のこと。
.SH 返り値
-\fBgetpwent\fP() é\96¢æ\95°ã\81¯ \fIpasswd\fP æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\82\92è¿\94ã\81\99ã\80\82 ã\81\93ã\82\8c以ä¸\8aã\82¨ã\83³ã\83\88ã\83ªが無いか、エラーが発生した場合は NULL
+\fBgetpwent\fP() é\96¢æ\95°ã\81¯ \fIpasswd\fP æ§\8bé\80 ä½\93ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\80\82 ã\81\93ã\82\8c以ä¸\8aã\82¨ã\83³ã\83\88ã\83ªã\83¼が無いか、エラーが発生した場合は NULL
を返す。 エラーが発生すると、 \fIerrno\fP が適切に設定される。 この関数の呼び出し後に \fIerrno\fP をチェックしたい場合は、呼び出し前に
\fIerrno\fP を 0 に設定しておかないといけない。
返り値は静的な領域を指しており、その後の \fBgetpwent\fP(), \fBgetpwnam\fP(3), \fBgetpwuid\fP(3)
-の呼び出しで上書きされるかもしれない。 (返されたポインタを \fBfree\fP(3) に渡さないこと。)
+ã\81®å\91¼ã\81³å\87ºã\81\97ã\81§ä¸\8aæ\9b¸ã\81\8dã\81\95ã\82\8cã\82\8bã\81\8bã\82\82ã\81\97ã\82\8cã\81ªã\81\84ã\80\82 (è¿\94ã\81\95ã\82\8cã\81\9fã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92 \fBfree\fP(3) ã\81«æ¸¡ã\81\95ã\81ªã\81\84ã\81\93ã\81¨ã\80\82)
.SH エラー
.TP
\fBEINTR\fP
\fBENOMEM\fP
.\" not in POSIX
.\" to allocate the passwd structure, or to allocate buffers
-\fIpasswd\fP 構造体に割り当てるメモリが十分なかった。
+\fIpasswd\fP æ§\8bé\80 ä½\93ã\81«å\89²ã\82\8aå½\93ã\81¦ã\82\8bã\83¡ã\83¢ã\83ªã\83¼ã\81\8cå\8d\81å\88\86ã\81ªã\81\8bã\81£ã\81\9fã\80\82
.TP
\fBERANGE\fP
-与えられたバッファ空間が不十分である。
+与えられたバッファー空間が不十分である。
.SH ファイル
.TP
\fI/etc/passwd\fP
-ã\83ã\83¼ã\82«ã\83«ã\81®ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83»ã\83\87ã\83¼ã\82¿ã\83\99ã\83¼ã\82¹ã\83\95ã\82¡ã\82¤ã\83«
+ローカルのパスワードデータベースファイル
.SH 属性
.SS "マルチスレッディング (pthreads(7) 参照)"
\fBgetpwent\fP() 関数はスレッドセーフではない。