.\" 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"
-.SH ̾Á°
-getgrent, setgrent, endgrent \- ¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë¥¨¥ó¥È¥ê¤Î¼èÆÀ
-.SH ½ñ¼°
+.\"*******************************************************************
+.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 ()
-¤Ï¡¢ºÇ½é¤Ë¸Æ¤Ó½Ð¤µ¤ì¤¿»þ¤ÏºÇ½é¤Î¥¨¥ó¥È¥ê¤òÊÖ¤·¡¢
-¤½¤ì°Ê¹ß¤Ï¸Æ¤Ó½Ð¤µ¤ì¤ëËè¤Ë¼¡¤Î¥¨¥ó¥È¥ê¤òÊÖ¤¹¡£
+.SH 説明
+\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
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
-¤³¤Î¹½Â¤ÂΤΥե£¡¼¥ë¥É¤Î¾ÜºÙ¤Ï
-.BR group (5)
-¤ò»²¾È¤Î¤³¤È¡£
-.SH ÊÖ¤êÃÍ
-.BR getgrent ()
-´Ø¿ô¤Ï
-.I group
-¹½Â¤ÂΤؤΥݥ¤¥ó¥¿¤òÊÖ¤¹¡£
-¤³¤ì°Ê¾å¥¨¥ó¥È¥ê¤¬Ìµ¤¤¤«¡¢¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
+この構造体のフィールドの詳細は \fBgroup\fP(5) を参照のこと。
+.SH 返り値
+\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)
-¤ËÅϤµ¤Ê¤¤¤³¤È¡£)
-.SH ¥¨¥é¡¼
-.TP
-.B EINTR
-¥·¥°¥Ê¥ë¤¬¥¥ã¥Ã¥Á¤µ¤ì¤¿¡£
-.TP
-.B EIO
-I/O ¥¨¥é¡¼¡£
-.TP
-.B EMFILE
-¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤¬´û¤Ë¥Õ¥¡¥¤¥ë¤ò¥ª¡¼¥×¥ó¤·²á¤®¤Æ¤¤¤ë¡£
-.TP
-.B ENFILE
-¥·¥¹¥Æ¥à¾å¤Ë¥ª¡¼¥×¥ó¤µ¤ì¤¿¥Õ¥¡¥¤¥ë¤¬Â¿²á¤®¤ë¡£
-.TP
-.B ENOMEM
-.\" POSIX ¤Ë¤Ï¤Ê¤¤¡£
-.I group
-¹½Â¤ÂΤò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
-.TP
-.B ERANGE
-½½Ê¬¤Ê¥Ð¥Ã¥Õ¥¡¶õ´Ö¤¬¤Ê¤¤¡£
-.SH ¥Õ¥¡¥¤¥ë
-.TP
-.I /etc/group
-¥í¡¼¥«¥ë¤Î¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
-.SH ½àµò
-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)
+返り値は静的な領域を指しており、その後の \fBgetgrent\fP(), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3)
+の呼び出しで上書きされるかもしれない。 (返されたポインタを \fBfree\fP(3) に渡さないこと。)
+.SH エラー
+.TP
+\fBEINTR\fP
+シグナルが捕捉された。
+.TP
+\fBEIO\fP
+I/O エラー。
+.TP
+\fBEMFILE\fP
+呼び出したプロセスが既にファイルをオープンし過ぎている。
+.TP
+\fBENFILE\fP
+システム上にオープンされたファイルが多過ぎる。
+.TP
+\fBENOMEM\fP
+.\" not in POSIX
+\fIgroup\fP 構造体を割り当てるためのメモリが不十分。
+.TP
+\fBERANGE\fP
+与えられたバッファ空間が不十分である。
+.SH ファイル
+.TP
+\fI/etc/group\fP
+ローカルのグループ・データベースファイル
+.SH 準拠
+SVr4, 4.3BSD, POSIX.1\-2001.
+.SH 関連項目
+\fBfgetgrent\fP(3), \fBgetgrent_r\fP(3), \fBgetgrgid\fP(3), \fBgetgrnam\fP(3)
+\fBgetgrouplist\fP(3), \fBputgrent\fP(3), \fBgroup\fP(5)
+.SH この文書について
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.40 の一部
+である。プロジェクトの説明とバグ報告に関する情報は
+http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
