OSDN Git Service

Update draft for LDP 3.67
[linuxjm/LDP_man-pages.git] / draft / man3 / fgetpwent.3
index 8d070d3..8f56bfc 100644 (file)
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -19,6 +20,7 @@
 .\"
 .\" Formatted or processed versions of this manual, if unaccompanied by
 .\" the source, must acknowledge the copyright and authors of this work.
+.\" %%%LICENSE_END
 .\"
 .\" References consulted:
 .\"     Linux libc source code
 .\" Modified Sat Jul 24 19:37:37 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Mon May 27 22:40:48 1996 by Martin Schulze (joey@linux.de)
 .\"
+.\"*******************************************************************
+.\"
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.\"
 .\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
 .\"    all rights reserved.
 .\" Translated 1997-12-18, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
 .\" Updated 2008-08-01, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
 .\"
-.TH FGETPWENT 3  2008-07-10 "GNU" "Linux Programmer's Manual"
-.\"O .SH NAME
-.SH Ì¾Á°
-.\"O fgetpwent \- get password file entry
-fgetpwent \- ¥Ñ¥¹¥ï¡¼¥É¥Õ¥¡¥¤¥ë¥¨¥ó¥È¥ê¤Î¼è¤ê½Ð¤·
-.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.TH FGETPWENT 3 2013\-04\-19 GNU "Linux Programmer's Manual"
+.SH 名前
+fgetpwent \- パスワードファイルエントリの取り出し
+.SH 書式
 .nf
-.B #include <stdio.h>
-.B #include <sys/types.h>
-.B #include <pwd.h>
+\fB#include <stdio.h>\fP
+\fB#include <sys/types.h>\fP
+\fB#include <pwd.h>\fP
 .sp
-.BI "struct passwd *fgetpwent(FILE *" stream );
+\fBstruct passwd *fgetpwent(FILE *\fP\fIstream\fP\fB);\fP
 .fi
 .sp
 .in -4n
-.\"O Feature Test Macro Requirements for glibc (see
-.\"O .BR feature_test_macros (7)):
-glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
-.RB ( feature_test_macros (7)
-»²¾È):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
-.BR fgetpwent ():
-_SVID_SOURCE
-.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
-.\"O The
-.\"O .BR fgetpwent ()
-.\"O function returns a pointer to a structure containing
-.\"O the broken out fields of a line in the file \fIstream\fP.
-.\"O The first time it is called it returns the first entry;
-.\"O thereafter, it returns successive entries.
-.\"O The file referred to by
-.\"O .I stream
-.\"O must have the same format as
-.\"O .I /etc/passwd
-.\"O (see
-.\"O .BR passwd (5)).
-.BR fgetpwent ()
-´Ø¿ô¤Ï¡¢\fIstream\fP ¤«¤éÆÀ¤é¤ì¤¿¹Ô¤òʬ²ò¤·¤¿¥Õ¥£¡¼¥ë¥É
-¤ò´Þ¤à¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-ºÇ½é¤Ë¸Æ¤Ó½Ð¤µ¤ì¤¿»þ¤Ë¤ÏºÇ½é¤Î¥¨¥ó¥È¥ê¤òÊÖ¤·¡¢¤½¤ì°Ê¹ß¤Ï
-¼¡¤Î¥¨¥ó¥È¥ê¤òÊÖ¤¹¡£
-.I stream
-¤Ç»²¾È¤µ¤ì¤ë¥Õ¥¡¥¤¥ë¤Ï
-.I /etc/passwd
-¤ÈƱ¤¸·Á¼°¤Ç¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤
-.RB ( passwd (5)
-»²¾È)¡£
+\fBfgetpwent\fP(): _SVID_SOURCE
+.SH 説明
+\fBfgetpwent\fP()  関数は、\fIstream\fP から得られた行を分解したフィールド を含む構造体へのポインタを返す。
+最初に呼び出された時には最初のエントリを返し、それ以降は 次のエントリを返す。 \fIstream\fP で参照されるファイルは \fI/etc/passwd\fP
+と同じ形式でなければならない (\fBpasswd\fP(5)  参照)。
 .PP
-.\"O The \fIpasswd\fP structure is defined in \fI<pwd.h>\fP as follows:
-\fIpasswd\fP ¹½Â¤ÂΤϡ¢\fI<pwd.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+\fIpasswd\fP 構造体は、\fI<pwd.h>\fP で以下のように定義されている:
 .sp
-.nf
 .in +4n
+.nf
 struct passwd {
-.\"O     char   *pw_name;       /* username */
-.\"O     char   *pw_passwd;     /* user password */
-.\"O     uid_t   pw_uid;        /* user ID */
-.\"O     gid_t   pw_gid;        /* group ID */
-.\"O     char   *pw_gecos;      /* real name */
-.\"O     char   *pw_dir;        /* home directory */
-.\"O     char   *pw_shell;      /* shell program */
-    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;        /* ユーザ ID */
+    gid_t   pw_gid;        /* グループ ID */
+    char   *pw_gecos;      /* 実名 */
+    char   *pw_dir;        /* ホームディレクトリ */
+    char   *pw_shell;      /* シェルプログラム */
 };
 .fi
 .in
-.\"O .SH "RETURN VALUE"
-.SH ÊÖ¤êÃÍ
-.\"O The
-.\"O .BR fgetpwent ()
-.\"O function returns a pointer to a
-.\"O .I passwd
-.\"O structure, or NULL if
-.\"O there are no more entries or an error occurs.
-.BR fgetpwent ()
-´Ø¿ô¤Ï¡¢
-.I passwd
-¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¤³¤ì°Ê¾å¥¨¥ó¥È¥ê¤¬Ìµ¤¤¤«¡¢¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
-.\"O .SH ERRORS
-.SH ¥¨¥é¡¼
-.TP
-.B ENOMEM
-.\"O Insufficient memory to allocate
-.\"O .I passwd
-.\"O structure.
-.I passwd
-¹½Â¤ÂΤò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
-.\"O .SH FILES
-.SH ¥Õ¥¡¥¤¥ë
-.TP
-.I /etc/passwd
-.\"O password database file
-¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 返り値
+\fBfgetpwent\fP()  関数は、 \fIpasswd\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL
+を返す。 エラーの場合、 \fIerrno\fP に原因を示す値が設定される。
+.SH エラー
+.TP 
+\fBENOMEM\fP
+\fIpasswd\fP 構造体に割り当てるメモリが十分なかった。
+.SH ファイル
+.TP 
+\fI/etc/passwd\fP
+パスワードデータベースファイル
+.SH 準拠
 SVr4.
-.\"O .SH "SEE ALSO"
-.SH ´ØÏ¢¹àÌÜ
-.BR endpwent (3),
-.BR fgetpwent_r (3),
-.BR fopen (3),
-.BR getpw (3),
-.BR getpwent (3),
-.BR getpwnam (3),
-.BR getpwuid (3),
-.BR putpwent (3),
-.BR setpwent (3),
-.BR passwd (5)
+.SH 関連項目
+\fBendpwent\fP(3), \fBfgetpwent_r\fP(3), \fBfopen\fP(3), \fBgetpw\fP(3), \fBgetpwent\fP(3),
+\fBgetpwnam\fP(3), \fBgetpwuid\fP(3), \fBputpwent\fP(3), \fBsetpwent\fP(3), \fBpasswd\fP(5)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.67 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。