release/man3/getgrent_r.3

   1 .\" Copyright (c) 2003 Andries Brouwer (aeb@cwi.nl)
   2 .\"
   3 .\" This is free documentation; you can redistribute it and/or
   4 .\" modify it under the terms of the GNU General Public License as
   5 .\" published by the Free Software Foundation; either version 2 of
   6 .\" the License, or (at your option) any later version.
   7 .\"
   8 .\" The GNU General Public License's references to "object code"
   9 .\" and "executables" are to be interpreted as the output of any
  10 .\" document formatting or typesetting system, including
  11 .\" intermediate and printed output.
  12 .\"
  13 .\" This manual is distributed in the hope that it will be useful,
  14 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  15 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16 .\" GNU General Public License for more details.
  17 .\"
  18 .\" You should have received a copy of the GNU General Public
  19 .\" License along with this manual; if not, write to the Free
  20 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  21 .\" USA.
  22 .\"
  23 .\" Japanese Version Copyright (c) 2004 Yuichi SATO
  24 .\"         all rights reserved.
  25 .\" Translated Thu Jul 29 02:26:07 JST 2004
  26 .\"         by Yuichi SATO <ysato444@yahoo.co.jp>
  27 .\"
  28 .TH GETGRENT_R 3 2010-10-21 "GNU" "Linux Programmer's Manual"
  29 .SH Ì¾Á°
  30 getgrent_r, fgetgrent_r \- ¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë¥¨¥ó¥È¥ê¤ò¥ê¥¨¥ó¥È¥é¥ó¥È (reentrant) ¤Ë¼è¤ê½Ð¤¹
  31 .SH ½ñ¼°
  32 .nf
  33 .B #include <grp.h>
  34 .sp
  35 .BI "int getgrent_r(struct group *" gbuf ", char *" buf ,
  36 .br
  37 .BI "               size_t " buflen ", struct group **" gbufp );
  38 .sp
  39 .BI "int fgetgrent_r(FILE *" fp ", struct group *" gbuf ", char *" buf ,
  40 .br
  41 .BI "                size_t " buflen ", struct group **" gbufp );
  42 .fi
  43 .sp
  44 .in -4n
  45 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  46 .RB ( feature_test_macros (7)
  47 »²¾È):
  48 .in
  49 .sp
  50 .BR getgrent_r ():
  51 _GNU_SOURCE
  52 .\" FIXME . The FTM requirements seem inconsistent here.  File a glibc bug?
  53 .br
  54 .BR fgetgrent_r ():
  55 _SVID_SOURCE
  56 .SH ÀâÌÀ
  57 ´Ø¿ô
  58 .BR getgrent_r ()
  59 ¤È
  60 .BR fgetgrent_r ()
  61 ¤Ï
  62 .BR getgrent (3)
  63 ¤È
  64 .BR fgetgrent (3)
  65 ¤Î¥ê¥¨¥ó¥È¥é¥ó¥ÈÈÇ¤Ç¤¢¤ë¡£
  66 Á°¼Ô¤Ï¡¢
  67 .BR setgrent (3)
  68 ¤Ë¤è¤Ã¤Æ½é´ü²½¤µ¤ì¤¿¥¹¥È¥ê¡¼¥à¤«¤é¡¢¼¡¤Î¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë¤Î¥¨¥ó¥È¥ê¤òÆÉ¤ß¹þ¤à¡£
  69 ¸å¼Ô¤Ï¡¢¥¹¥È¥ê¡¼¥à
  70 .I fp
  71 ¤«¤é¼¡¤Î¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë¤Î¥¨¥ó¥È¥ê¤òÆÉ¤ß¹þ¤à¡£
  72 .PP
  73 \fIgroup\fP ¹½Â¤ÂÎ¤Ï
  74 .I <grp.h>
  75 ¤Ë¤ª¤¤¤Æ°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
  76 .sp
  77 .in +4n
  78 .nf
  79 struct group {
  80     char    *gr_name;     /* ¥°¥ë¡¼¥×Ì¾ */
  81     char    *gr_passwd;   /* ¥°¥ë¡¼¥×¥Ñ¥¹¥ï¡¼¥É */
  82     gid_t    gr_gid;      /* ¥°¥ë¡¼¥× ID */
  83     char   **gr_mem;      /* ¥°¥ë¡¼¥×¥á¥ó¥Ð */
  84 };
  85 .fi
  86 .in
  87 .PP
  88 ¤³¤Î¹½Â¤ÂÎ¤Î¥Õ¥£¡¼¥ë¥É¤Î¾ÜºÙ¤Ï
  89 .BR group (5)
  90 ¤ò»²¾È¤Î¤³¤È¡£
  91 .PP
  92 ¥ê¥¨¥ó¥È¥é¥ó¥È¤Ç¤Ê¤¤´Ø¿ô¤ÏÀÅÅª¤Ê³ÊÇ¼ÎÎ°è¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  93 ¤³¤ÎÀÅÅª¤Ê³ÊÇ¼ÎÎ°è¤Ë¤Ï¡¢¹¹¤Ë¥°¥ë¡¼¥×Ì¾¡¦¥Ñ¥¹¥ï¡¼¥É¡¦
  94 ¥á¥ó¥Ð¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬´Þ¤Þ¤ì¤ë¡£
  95 ¤³¤³¤ÇÀâÌÀ¤µ¤ì¤Æ¤¤¤ë¥ê¥¨¥ó¥È¥é¥ó¥È¤Ê´Ø¿ô¤Ï¡¢
  96 ¸Æ¤Ó½Ð¤·Â¦¤«¤éÄó¶¡¤µ¤ì¤ë¥Ð¥Ã¥Õ¥¡¤Ë¥°¥ë¡¼¥×Ì¾¤Ê¤ÉÁ´¤Æ¤òÊÖ¤¹¡£
  97 ºÇ½é¤Î°ú¤¿ô¤È¤·¤Æ \fIstruct group\fP ¤òÊÝ»ý¤Ç¤¤ë¥Ð¥Ã¥Õ¥¡
  98 .I gbuf
  99 ¤¬¤¢¤ë¡£
 100 ¼¡¤Ë¤½¤ÎÂ¾¤ÎÊ¸»úÎó¤òÊÝ»ý¤Ç¤¤ë¥µ¥¤¥º
 101 .I buflen
 102 ¤Î¥Ð¥Ã¥Õ¥¡
 103 .I buf
 104 ¤¬¤¢¤ë¡£
 105 ¤³¤ì¤é¤Î´Ø¿ô¤Î·ë²Ì (¥¹¥È¥ê¡¼¥à¤«¤éÆÉ¤ß¹þ¤Þ¤ì¤¿ \fIstruct group\fP) ¤Ï¡¢
 106 Äó¶¡¤µ¤ì¤¿¥Ð¥Ã¥Õ¥¡
 107 .IR *gbuf
 108 ¤Ë³ÊÇ¼¤µ¤ì¡¢¤³¤Î \fIstruct group\fP ¤Ø¤Î¥Ý¥¤¥ó¥¿¤Ï
 109 .IR *gbufp
 110 ¤ËÊÖ¤µ¤ì¤ë¡£
 111 .SH ÊÖ¤êÃÍ
 112 À®¸ù¤·¤¿¾ì¹ç¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï 0 ¤òÊÖ¤·¡¢
 113 .RI * gbufp
 114 ¤Ï \fIstruct group\fP ¤Ø¤Î¥Ý¥¤¥ó¥¿¤È¤Ê¤ë¡£
 115 ¥¨¥é¡¼¤Î¾ì¹ç¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï¥¨¥é¡¼ÃÍ¤òÊÖ¤·¡¢
 116 .RI * gbufp
 117 ¤Ï NULL ¤Ë¤Ê¤ë¡£
 118 .SH ¥¨¥é¡¼
 119 .TP
 120 .B ENOENT
 121 ¼¡¤Î¥¨¥ó¥È¥ê¤¬¤Ê¤¤¡£
 122 .TP
 123 .B ERANGE
 124 ½½Ê¬¤Ê¥Ð¥Ã¥Õ¥¡¶õ´Ö¤¬Í¿¤¨¤é¤ì¤Æ¤¤¤Ê¤¤¡£
 125 ¤â¤Ã¤ÈÂç¤¤Ê¥Ð¥Ã¥Õ¥¡¤ÇºÆÅÙ¼Â¹Ô¤¹¤ë¤³¤È¡£
 126 .SH ½àµò
 127 ¤³¤ì¤é¤Î´Ø¿ô¤Ï GNU ³ÈÄ¥¤Ç¤¢¤ê¡¢POSIX ÈÇ¤Î´Ø¿ô
 128 .BR getpwnam_r (3)
 129 ¤Î·Á¼°¤Ë»÷¤»¤Æ¤¢¤ë¡£
 130 Â¾¤Î¥·¥¹¥Æ¥à¤Ç¤Ï°Ê²¼¤Î¥×¥í¥È¥¿¥¤¥×¤¬»È¤ï¤ì¤Æ¤¤¤ë¡£
 131 .sp
 132 .nf
 133 .in +4n
 134 struct group *getgrent_r(struct group *grp, char *buf,
 135                          int buflen);
 136 .in
 137 .fi
 138 .sp
 139 ¤è¤êÎÉ¤¤¤â¤Î¤Ç¤Ï¡¢°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤Ã¤Æ¤¤¤ë¡£
 140 .sp
 141 .nf
 142 .in +4n
 143 int getgrent_r(struct group *grp, char *buf, int buflen,
 144                FILE **gr_fp);
 145 .in
 146 .fi
 147 .SH Ãí°Õ
 148 ´Ø¿ô
 149 .BR getgrent_r ()
 150 ¤ÏËÜÅö¤Î¥ê¥¨¥ó¥È¥é¥ó¥È¤Ç¤Ï¤Ê¤¤¡£
 151 ¤Ê¤¼¤Ê¤é¡¢¥¹¥È¥ê¡¼¥à¤ÎÆÉ¤ß¹þ¤ß°ÌÃÖ¤ò
 152 Â¾¤ÎÁ´¤Æ¤Î¥¹¥ì¥Ã¥É¤È¶¦Í¤·¤Æ¤¤¤ë¤¿¤á¤Ç¤¢¤ë¡£
 153 .SH Îã
 154 .nf
 155 #define _GNU_SOURCE
 156 #include <grp.h>
 157 #include <stdio.h>
 158 #include <stdlib.h>
 159 #define BUFLEN 4096
 160
 161 int
 162 main(void)
 163 {
 164     struct group grp, *grpp;
 165     char buf[BUFLEN];
 166     int i;
 167
 168     setgrent();
 169     while (1) {
 170         i = getgrent_r(&grp, buf, BUFLEN, &grpp);
 171         if (i)
 172             break;
 173         printf("%s (%d):", grpp\->gr_name, grpp\->gr_gid);
 174         for (i = 0; ; i++) {
 175             if (grpp\->gr_mem[i] == NULL)
 176                 break;
 177             printf(" %s", grpp\->gr_mem[i]);
 178         }
 179         printf("\en");
 180     }
 181     endgrent();
 182     exit(EXIT_SUCCESS);
 183 }
 184 .fi
 185 .\" ¤¿¤Ö¤ó¥¨¥é¡¼¥Á¥§¥Ã¥¯¤òÄÉ²Ã¤·¤Æ¡¢strerror_r ¤ò»È¤¦¤Ù¤¤À¤í¤¦¡£
 186 .\" #include <errno.h>
 187 .\" #include <stdlib.h>
 188 .\"         if (i) {
 189 .\"               if (i == ENOENT)
 190 .\"                     break;
 191 .\"               printf("getgrent_r: %s", strerror(i));
 192 .\"               exit(EXIT_FAILURE);
 193 .\"         }
 194 .SH ´ØÏ¢¹àÌÜ
 195 .BR fgetgrent (3),
 196 .BR getgrent (3),
 197 .BR getgrgid (3),
 198 .BR getgrnam (3),
 199 .BR putgrent (3),
 200 .BR group (5)