OSDN Git Service

(split) LDP: Release pages for LDP v3.39.
[linuxjm/LDP_man-pages.git] / release / man3 / getgrent.3
index b1d9c0d..83a7dc9 100644 (file)
 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
 .\"     386BSD man pages
 .\" Modified Sat Jul 24 19:29:54 1993 by Rik Faith (faith@cs.unc.edu)
+.\"*******************************************************************
 .\"
-.\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
-.\"    all rights reserved.
-.\" Translated 1997-12-19, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
-.\" Updated & Modified 2004-05-30, Yuichi SATO <ysato444@yahoo.co.jp>
-.\" Updated & Modified 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" This file was generated with po4a. Translate the source file.
 .\"
-.TH GETGRENT 3  2010-10-21 "" "Linux Programmer's Manual"
+.\"*******************************************************************
+.TH GETGRENT 3 2010\-10\-21 "" "Linux Programmer's Manual"
 .SH 名前
 getgrent, setgrent, endgrent \- グループファイルエントリの取得
 .SH 書式
 .nf
-.B #include <sys/types.h>
-.B #include <grp.h>
+\fB#include <sys/types.h>\fP
+\fB#include <grp.h>\fP
 .sp
-.B struct group *getgrent(void);
+\fBstruct group *getgrent(void);\fP
 .sp
-.B void setgrent(void);
+\fBvoid setgrent(void);\fP
 .sp
-.B void endgrent(void);
+\fBvoid endgrent(void);\fP
 .fi
 .sp
 .in -4n
-glibc 向けの機能検査マクロの要件
-.RB ( feature_test_macros (7)
-参照):
+glibc 向けの機能検査マクロの要件 (\fBfeature_test_macros\fP(7)  参照):
 .in
 .sp
 .PD 0
 .ad l
-.BR setgrent ():
+\fBsetgrent\fP():
 .RS 4
-_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED ||
+_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED ||
 .br
 /* Since glibc 2.12: */ _POSIX_C_SOURCE\ >=\ 200809L
 .RE
 .sp
-.BR getgrent (),
-.BR endgrent ():
+\fBgetgrent\fP(), \fBendgrent\fP():
 .RS 4
-_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 ||
-_XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
+_SVID_SOURCE || _BSD_SOURCE || _XOPEN_SOURCE\ >=\ 500 || _XOPEN_SOURCE\ &&\ _XOPEN_SOURCE_EXTENDED
 .RE
 .PD
 .ad b
 .SH 説明
-.BR getgrent ()
-関数は、グループ・データベースから取得したエントリを
-要素毎に分解し、各要素を格納した構造体へのポインタを返す
-(グループ・データベースの例:
-ローカルのグループファイル
-.IR /etc/group ,
-NIS, LDAP)。
-.BR getgrent ()
-は、最初に呼び出された時は最初のエントリを返し、
-それ以降は呼び出される毎に次のエントリを返す。
+\fBgetgrent\fP()  関数は、グループ・データベースから取得したエントリを 要素毎に分解し、各要素を格納した構造体へのポインタを返す
+(グループ・データベースの例: ローカルのグループファイル \fI/etc/group\fP, NIS, LDAP)。 \fBgetgrent\fP()
+は、最初に呼び出された時は最初のエントリを返し、 それ以降は呼び出される毎に次のエントリを返す。
 .PP
-.BR setgrent ()
-関数を使うと、もう一度読み込めるように、
-グループ・データベースの先頭に戻る。
+\fBsetgrent\fP()  関数を使うと、もう一度読み込めるように、 グループ・データベースの先頭に戻る。
 .PP
-.BR endgrent ()
-関数は、全ての処理が終わった後にグループ・
-データベースをクローズする。
+\fBendgrent\fP()  関数は、全ての処理が終わった後にグループ・ データベースをクローズする。
 .PP
-\fIgroup\fP 構造体は\fI<grp.h>\fP で以下のように定義されている:
+\fIgroup\fP 構造体は \fI<grp.h>\fP で以下のように定義されている:
 .sp
 .in +4n
 .nf
@@ -104,65 +86,41 @@ struct group {
 .fi
 .in
 .PP
-この構造体のフィールドの詳細は
-.BR group (5)
-を参照のこと。
+この構造体のフィールドの詳細は \fBgroup\fP(5)  を参照のこと。
 .SH 返り値
-.BR getgrent ()
-関数は
-.I group
-構造体へのポインタを返す。
-これ以上エントリが無いか、エラーが発生した場合は NULL を返す。
+\fBgetgrent\fP()  関数は \fIgroup\fP 構造体へのポインタを返す。 これ以上エントリが無いか、エラーが発生した場合は NULL を返す。
 .LP
-エラーが発生すると、
-.I errno
-が適切に設定される。
-この関数の呼び出し後に
-.I errno
-をチェックしたい場合は、呼び出し前に
-.I errno
-を 0 に設定しておかないといけない。
+エラーが発生すると、 \fIerrno\fP が適切に設定される。 この関数の呼び出し後に \fIerrno\fP をチェックしたい場合は、呼び出し前に
+\fIerrno\fP を 0 に設定しておかないといけない。
 
-返り値は静的な領域を指しており、その後の
-.BR getgrent (),
-.BR getgrgid (3),
-.BR getgrnam (3)
-の呼び出しで上書きされるかもしれない。
-(返されたポインタを
-.BR free (3)
-に渡さないこと。)
+返り値は静的な領域を指しており、その後の \fBgetgrent\fP(), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3)
+の呼び出しで上書きされるかもしれない。 (返されたポインタを \fBfree\fP(3)  に渡さないこと。)
 .SH エラー
-.TP
-.B EINTR
-シグナルがキャッチされた。
-.TP
-.B EIO
+.TP 
+\fBEINTR\fP
+シグナルが捕捉された。
+.TP 
+\fBEIO\fP
 I/O エラー。
-.TP
-.B EMFILE
+.TP 
+\fBEMFILE\fP
 呼び出したプロセスが既にファイルをオープンし過ぎている。
-.TP
-.B ENFILE
+.TP 
+\fBENFILE\fP
 システム上にオープンされたファイルが多過ぎる。
-.TP
-.B ENOMEM
-.\" POSIX にはない。
-.I group
-構造体を割り当てるためのメモリが不十分。
-.TP
-.B ERANGE
-十分なバッファ空間がない。
+.TP 
+\fBENOMEM\fP
+.\" not in POSIX
+\fIgroup\fP 構造体を割り当てるためのメモリが不十分。
+.TP 
+\fBERANGE\fP
+与えられたバッファ空間が不十分である。
 .SH ファイル
-.TP
-.I /etc/group
+.TP 
+\fI/etc/group\fP
 ローカルのグループ・データベースファイル
 .SH 準拠
-SVr4, 4.3BSD, POSIX.1-2001.
+SVr4, 4.3BSD, POSIX.1\-2001.
 .SH 関連項目
-.BR fgetgrent (3),
-.BR getgrent_r (3),
-.BR getgrgid (3),
-.BR getgrnam (3)
-.BR getgrouplist (3),
-.BR putgrent (3),
-.BR group (5)
+\fBfgetgrent\fP(3), \fBgetgrent_r\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3)
+\fBgetgrouplist\fP(3), \fBputgrent\fP(3), \fBgroup\fP(5)