(split) LDP: Update the version to 3.53 in PO files

[linuxjm/LDP_man-pages.git] / release / man3 / getpw.3

diff --git a/release/man3/getpw.3 b/release/man3/getpw.3
index 1448508..aea36ea 100644 (file)
--- a/release/man3/getpw.3
+++ b/release/man3/getpw.3
@@ -1,5 +1,6 @@
 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
 .\"
 .\" 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.
 .\" 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.
 .\"
 .\" 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
 .\"
 .\" References consulted:
 .\"     Linux libc source code


@@ -27,88 +29,72 @@
 .\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de)
 .\"
 .\" Modified Sat Jul 24 19:23:25 1993 by Rik Faith (faith@cs.unc.edu)
 .\" Modified Mon May 27 21:37:47 1996 by Martin Schulze (joey@linux.de)
 .\"

-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\"    all rights reserved.
-.\" Translated 1997-12-19, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
-.\" Modified 1999-12-08, Kentaro Shirakata <argrath@yo.rim.or.jp>
-.\" Modified 2005-09-04, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Modified 2008-07-23, Kentaro Shirakata <argrath@ub32.org>
+.\"*******************************************************************

 .\"
 .\"

-.TH GETPW 3 2007-07-26 "GNU" "Linux Programmer's Manual"
-.SH ̾Á°
-getpw \- ¥Ñ¥¹¥ï¡¼¥É¹Ô¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë
-.SH ½ñ¼°
+.\" This file was generated with po4a. Translate the source file.
+.\"
+.\"*******************************************************************
+.TH GETPW 3 2010\-10\-21 GNU "Linux Programmer's Manual"
+.SH 名前
+getpw \- パスワード行エントリを取得する
+.SH 書式

 .nf
 .nf

-.B #define _GNU_SOURCE
-.B #include <sys/types.h>
-.B #include <pwd.h>
+\fB#define _GNU_SOURCE\fP             /* feature_test_macros(7) 参照 */
+\fB#include <sys/types.h>\fP
+\fB#include <pwd.h>\fP

 .sp
 .sp

-.BI "int getpw(uid_t " uid ", char *" buf );
+\fBint getpw(uid_t \fP\fIuid\fP\fB, char *\fP\fIbuf\fP\fB);\fP

 .fi
 .fi

-.SH ÀâÌÀ
-.BR getpw ()
-´Ø¿ô¤Ï¡¢¥Ð¥Ã¥Õ¥¡ \fIbuf\fP ¤Ë»ØÄê¥æ¡¼¥¶ ID  \fIuid\fP ¤Î
-¥Ñ¥¹¥ï¡¼¥É¹Ô¥¨¥ó¥È¥ê¤ò¼èÆÀ¤¹¤ë¡£
-ÊÖ¤µ¤ì¤ë¥Ð¥Ã¥Õ¥¡¤Ï¡¢°Ê²¼¤Î·Á¼°¤Î¹Ô¤ò´Þ¤à¡£
+.SH 説明
+\fBgetpw\fP()  関数は、バッファ \fIbuf\fP に指定ユーザ ID \fIuid\fP の パスワード行エントリを取得する。
+返されるバッファは、以下の形式の行を含む。

 .sp
 .sp

-.in +4n
-.B name:passwd:uid:gid:gecos:dir:shell
-.in
+.RS
+\fBname:passwd:uid:gid:gecos:dir:shell\fP
+.RE

 .PP
 .PP

-\fIpasswd\fP ¹½Â¤ÂÎ¤Ï \fI<pwd.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
+\fIpasswd\fP 構造体は、\fI<pwd.h>\fP で以下のように定義されている:

 .sp
 .in +4n
 .nf
 struct passwd {
 .sp
 .in +4n
 .nf
 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 */
+    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
 };
 .fi
 .in

-.SH ÊÖ¤êÃÍ
-.BR getpw ()
-´Ø¿ô¤Ï¡¢À®¸ù¤·¤¿¾ì¹ç 0 ¤òÊÖ¤¹; ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç \-1 ¤òÊÖ¤·¡¢¥¨¥é¡¼¤ò
-¼¨¤¹¤¿¤á¤Ë
-.I error
-¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
-.SH ¥¨¥é¡¼
-.TP
-.B EINVAL
-.I buf
-¤¬ NULL¡£
-.TP
-.B ENOENT
-.I uid
-¤ËÂбþ¤¹¤ë¥æ¡¼¥¶¤¬¤¤¤Ê¤¤¡£
-.TP
-.B ENOMEM
-.I passwd
-¹½Â¤ÂΤò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
-.SH ¥Õ¥¡¥¤¥ë
-.TP
-.I /etc/passwd
-¥Ñ¥¹¥ï¡¼¥É¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.SH ½àµò
+.PP
+この構造体のフィールドの詳細は \fBpasswd\fP(5)  を参照のこと。
+.SH 返り値
+\fBgetpw\fP()  関数は、成功した場合 0 を返す; エラーが発生した場合 \-1 を返し、エラーを 示すために \fIerror\fP がセットされる。
+.SH エラー
+.TP 
+\fBEINVAL\fP
+\fIbuf\fP が NULL。
+.TP 
+\fBENOENT\fP
+\fIuid\fP に対応するユーザがいない。
+.TP 
+\fBENOMEM\fP
+\fIpasswd\fP 構造体に割り当てるメモリが十分なかった。
+.SH ファイル
+.TP 
+\fI/etc/passwd\fP
+パスワードデータベースファイル
+.SH 準拠

 SVr2
 SVr2

-.SH ¥Ð¥°
-.BR getpw ()
-´Ø¿ô¤Ï¡¢Í¿¤¨¤é¤ì¤¿¥Ð¥Ã¥Õ¥¡
-.I buf
-¤¬¥ª¡¼¥Ð¡¼¥Õ¥í¡¼¤¹¤ë¤«¤â¤·¤ì¤Ê¤¤¤Î¤Ç´í¸±¤Ç¤¢¤ë¡£
-¤³¤Î´Ø¿ô¤Ï
-.BR getpwuid (3)
-¤Ë¤è¤Ã¤Æ¸Å¤¤¤â¤Î¤È¤Ê¤Ã¤¿¡£
-.SH ´ØÏ¢¹àÌÜ
-.BR endpwent (3),
-.BR fgetpwent (3),
-.BR getpwent (3),
-.BR getpwnam (3),
-.BR getpwuid (3),
-.BR putpwent (3),
-.BR setpwent (3),
-.BR passwd (5)
+.SH バグ
+\fBgetpw\fP()  関数は、与えられたバッファ \fIbuf\fP がオーバーフローするかもしれないので危険である。 この関数は
+\fBgetpwuid\fP(3)  によって古いものとなった。
+.SH 関連項目
+\fBendpwent\fP(3), \fBfgetpwent\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.53 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。