X-Git-Url: http://git.osdn.net/view?a=blobdiff_plain;f=release%2Fman3%2Fgetgrent.3;h=3cd05b69c719054ec6b5f150064397e13b7778b0;hb=25a9ae037fb2517d0cf4e625fb5bdbc5f06e004d;hp=384123b01ee61599f7a2c5c28fcc00bcab6cfe7a;hpb=4a0386e39e89bfc6e52c4cd5372b1a0d9c9bf08c;p=linuxjm%2FLDP_man-pages.git diff --git a/release/man3/getgrent.3 b/release/man3/getgrent.3 index 384123b0..3cd05b69 100644 --- a/release/man3/getgrent.3 +++ b/release/man3/getgrent.3 @@ -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,150 +20,118 @@ .\" .\" 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 .\" 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 -.\" Updated & Modified 2004-05-30, Yuichi SATO -.\" Updated & Modified 2005-09-06, Akihiro MOTOKI +.\" 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 2013\-06\-21 "" "Linux Programmer's Manual" +.SH 名前 +getgrent, setgrent, endgrent \- グループファイルエントリの取得 +.SH 書式 .nf -.B #include -.B #include +\fB#include \fP +\fB#include \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\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë: +\fIgroup\fP 構造体は \fI\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 属性 +.SS "マルチスレッディング (pthreads(7) 参照)" +\fBgetgrent()\fP 関数はスレッドセーフではない。 +.LP +関数 \fBsetgrent()\fP と \fBendgrent()\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.52 の一部 +である。プロジェクトの説明とバグ報告に関する情報は +http://www.kernel.org/doc/man\-pages/ に書かれている。