.\" Translated Thu Jul 29 02:26:07 JST 2004
.\" by Yuichi SATO <ysato444@yahoo.co.jp>
.\"
-.TH GETGRENT_R 3 2010\-10\-21 GNU "Linux Programmer's Manual"
+.TH GETGRENT_R 3 2015\-01\-22 GNU "Linux Programmer's Manual"
.SH 名前
-getgrent_r, fgetgrent_r \- グループファイルエントリをリエントラント (reentrant) に取り出す
+getgrent_r, fgetgrent_r \- ã\82°ã\83«ã\83¼ã\83\97ã\83\95ã\82¡ã\82¤ã\83«ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92ã\83ªã\82¨ã\83³ã\83\88ã\83©ã\83³ã\83\88 (reentrant) ã\81«å\8f\96ã\82\8aå\87ºã\81\99
.SH 書式
.nf
\fB#include <grp.h>\fP
.br
\fB size_t \fP\fIbuflen\fP\fB, struct group **\fP\fIgbufp\fP\fB);\fP
.sp
-\fBint fgetgrent_r(FILE *\fP\fIfp\fP\fB, struct group *\fP\fIgbuf\fP\fB, char *\fP\fIbuf\fP\fB,\fP
+\fBint fgetgrent_r(FILE *\fP\fIstream\fP\fB, struct group *\fP\fIgbuf\fP\fB, char *\fP\fIbuf\fP\fB,\fP
.br
\fB size_t \fP\fIbuflen\fP\fB, struct group **\fP\fIgbufp\fP\fB);\fP
.fi
\fBfgetgrent_r\fP(): _SVID_SOURCE
.SH 説明
関数 \fBgetgrent_r\fP() と \fBfgetgrent_r\fP() は \fBgetgrent\fP(3) と \fBfgetgrent\fP(3)
-のリエントラント版である。 前者は、 \fBsetgrent\fP(3) によって初期化されたストリームから、次のグループファイルのエントリを読み込む。
-後者は、ストリーム \fIfp\fP から次のグループファイルのエントリを読み込む。
+ã\81®ã\83ªã\82¨ã\83³ã\83\88ã\83©ã\83³ã\83\88ç\89\88ã\81§ã\81\82ã\82\8bã\80\82 å\89\8dè\80\85ã\81¯ã\80\81 \fBsetgrent\fP(3) ã\81«ã\82\88ã\81£ã\81¦å\88\9dæ\9c\9få\8c\96ã\81\95ã\82\8cã\81\9fã\82¹ã\83\88ã\83ªã\83¼ã\83 ã\81\8bã\82\89ã\80\81次ã\81®ã\82°ã\83«ã\83¼ã\83\97ã\83\95ã\82¡ã\82¤ã\83«ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\82\92èªã\81¿è¾¼ã\82\80ã\80\82
+後者は、 \fIstream\fP から次のグループファイルのエントリーを読み込む。
.PP
\fIgroup\fP 構造体は \fI<grp.h>\fP で以下のように定義されている:
.sp
.in +4n
.nf
struct group {
- char *gr_name; /* グループ名 */
- char *gr_passwd; /* グループパスワード */
- gid_t gr_gid; /* グループ ID */
- char **gr_mem; /* グループメンバ */
+ char *gr_name; /* グループ名 */
+ char *gr_passwd; /* グループのパスワード */
+ gid_t gr_gid; /* グループ ID */
+ char **gr_mem; /* グループのメンバ名へのポインター
+ の配列 (配列はヌルで終端する) */
};
.fi
.in
.PP
この構造体のフィールドの詳細は \fBgroup\fP(5) を参照のこと。
.PP
-ã\83ªã\82¨ã\83³ã\83\88ã\83©ã\83³ã\83\88ã\81§ã\81ªã\81\84é\96¢æ\95°ã\81¯é\9d\99ç\9a\84ã\81ªæ ¼ç´\8dé \98å\9f\9fã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\82\92è¿\94ã\81\99ã\80\82 ã\81\93ã\81®é\9d\99ç\9a\84ã\81ªæ ¼ç´\8dé \98å\9f\9fã\81«ã\81¯ã\80\81æ\9b´ã\81«ã\82°ã\83«ã\83¼ã\83\97å\90\8dã\83»ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83» ã\83¡ã\83³ã\83\90ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿が含まれる。
-ここで説明されているリエントラントな関数は、 呼び出し側から提供されるバッファにグループ名など全てを返す。 最初の引き数として \fIstruct
-group\fP を保持できるバッファ \fIgbuf\fP がある。 次にその他の文字列を保持できるサイズ \fIbuflen\fP のバッファ \fIbuf\fP
-がある。 これらの関数の結果 (ストリームから読み込まれた \fIstruct group\fP) は、 提供されたバッファ \fI*gbuf\fP
-に格納され、この \fIstruct group\fP へのポインタは \fI*gbufp\fP に返される。
+ã\83ªã\82¨ã\83³ã\83\88ã\83©ã\83³ã\83\88ã\81§ã\81ªã\81\84é\96¢æ\95°ã\81¯é\9d\99ç\9a\84ã\81ªæ ¼ç´\8dé \98å\9f\9fã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\82\92è¿\94ã\81\99ã\80\82 ã\81\93ã\81®é\9d\99ç\9a\84ã\81ªæ ¼ç´\8dé \98å\9f\9fã\81«ã\81¯ã\80\81æ\9b´ã\81«ã\82°ã\83«ã\83¼ã\83\97å\90\8dã\83»ã\83\91ã\82¹ã\83¯ã\83¼ã\83\89ã\83» ã\83¡ã\83³ã\83\90ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼が含まれる。
+ã\81\93ã\81\93ã\81§èª¬æ\98\8eã\81\95ã\82\8cã\81¦ã\81\84ã\82\8bã\83ªã\82¨ã\83³ã\83\88ã\83©ã\83³ã\83\88ã\81ªé\96¢æ\95°ã\81¯ã\80\81 å\91¼ã\81³å\87ºã\81\97å\81´ã\81\8bã\82\89æ\8f\90ä¾\9bã\81\95ã\82\8cã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81«ã\82°ã\83«ã\83¼ã\83\97å\90\8dã\81ªã\81©å\85¨ã\81¦ã\82\92è¿\94ã\81\99ã\80\82 æ\9c\80å\88\9dã\81®å¼\95ã\81\8dæ\95°ã\81¨ã\81\97ã\81¦ \fIstruct
+group\fP を保持できるバッファー \fIgbuf\fP がある。 次にその他の文字列を保持できるサイズ \fIbuflen\fP のバッファー \fIbuf\fP
+がある。 これらの関数の結果 (ストリームから読み込まれた \fIstruct group\fP) は、 提供されたバッファー \fI*gbuf\fP
+ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\80\81ã\81\93ã\81® \fIstruct group\fP ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81¯ \fI*gbufp\fP ã\81«è¿\94ã\81\95ã\82\8cã\82\8bã\80\82
.SH 返り値
-成功した場合、これらの関数は 0 を返し、 *\fIgbufp\fP は \fIstruct group\fP へのポインタとなる。
+æ\88\90å\8a\9fã\81\97ã\81\9få ´å\90\88ã\80\81ã\81\93ã\82\8cã\82\89ã\81®é\96¢æ\95°ã\81¯ 0 ã\82\92è¿\94ã\81\97ã\80\81 *\fIgbufp\fP ã\81¯ \fIstruct group\fP ã\81¸ã\81®ã\83\9dã\82¤ã\83³ã\82¿ã\83¼ã\81¨ã\81ªã\82\8bã\80\82
エラーの場合、これらの関数はエラー値を返し、 *\fIgbufp\fP は NULL になる。
.SH エラー
.TP
\fBENOENT\fP
-次のエントリがない。
+次ã\81®ã\82¨ã\83³ã\83\88ã\83ªã\83¼ã\81\8cã\81ªã\81\84ã\80\82
.TP
\fBERANGE\fP
-十分なバッファ空間が与えられていない。 もっと大きなバッファで再度実行すること。
+十分なバッファー空間が与えられていない。 もっと大きなバッファーで再度実行すること。
.SH 準拠
これらの関数は GNU 拡張であり、POSIX 版の関数 \fBgetpwnam_r\fP(3) の形式に似せてある。
他のシステムでは以下のプロトタイプが使われている。
\fBfgetgrent\fP(3), \fBgetgrent\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3),
\fBputgrent\fP(3), \fBgroup\fP(5)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.63 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。