release/man3/getgrnam.3

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\" Copyright 1993 David Metcalfe (david@prism.demon.co.uk)
   3 .\"
   4 .\" Permission is granted to make and distribute verbatim copies of this
   5 .\" manual provided the copyright notice and this permission notice are
   6 .\" preserved on all copies.
   7 .\"
   8 .\" Permission is granted to copy and distribute modified versions of this
   9 .\" manual under the conditions for verbatim copying, provided that the
  10 .\" entire resulting derived work is distributed under the terms of a
  11 .\" permission notice identical to this one.
  12 .\"
  13 .\" Since the Linux kernel and libraries are constantly changing, this
  14 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  15 .\" responsibility for errors or omissions, or for damages resulting from
  16 .\" the use of the information contained herein.  The author(s) may not
  17 .\" have taken the same level of care in the production of this manual,
  18 .\" which is licensed free of charge, as they might when working
  19 .\" professionally.
  20 .\"
  21 .\" Formatted or processed versions of this manual, if unaccompanied by
  22 .\" the source, must acknowledge the copyright and authors of this work.
  23 .\"
  24 .\" References consulted:
  25 .\"     Linux libc source code
  26 .\"     Lewine's _POSIX Programmer's Guide_ (O'Reilly & Associates, 1991)
  27 .\"     386BSD man pages
  28 .\"
  29 .\" Modified 1993-07-24 by Rik Faith (faith@cs.unc.edu)
  30 .\" Modified 2003-11-15 by aeb
  31 .\"
  32 .\" Japanese Version Copyright (c) 1997 HIROFUMI Nishizuka
  33 .\"     all rights reserved.
  34 .\" Translated 1997-12-19, HIROFUMI Nishizuka <nishi@rpts.cl.nec.co.jp>
  35 .\" Updated & Modefied 1999-02-26, Shouichi Saito
  36 .\" Updated & Modified 2004-06-05, Yuichi SATO <ysato444@yahoo.co.jp>
  37 .\" Updated & Modified 2005-09-06, Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  38 .\" Updated 2008-12-24, Akihiro MOTOKI, LDP v3.14
  39 .\"
  40 .TH GETGRNAM 3 2009-03-30 "" "Linux Programmer's Manual"
  41 .SH Ì¾Á°
  42 getgrnam, getgrnam_r, getgrgid, getgrgid_r \- ¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë¥¨¥ó¥È¥ê¤Î¼è¤ê½Ð¤·
  43 .SH ½ñ¼°
  44 .nf
  45 .B #include <sys/types.h>
  46 .B #include <grp.h>
  47 .sp
  48 .BI "struct group *getgrnam(const char *" name );
  49 .sp
  50 .BI "struct group *getgrgid(gid_t " gid );
  51 .sp
  52 .BI "int getgrnam_r(const char *" name ", struct group *" grp ,
  53 .br
  54 .BI "          char *" buf ", size_t " buflen ", struct group **" result );
  55 .sp
  56 .BI "int getgrgid_r(gid_t " gid ", struct group *" grp ,
  57 .br
  58 .BI "          char *" buf ", size_t " buflen ", struct group **" result );
  59 .fi
  60 .sp
  61 .in -4n
  62 glibc ¸þ¤±¤Îµ¡Ç½¸¡ºº¥Þ¥¯¥í¤ÎÍ×·ï
  63 .RB ( feature_test_macros (7)
  64 »²¾È):
  65 .ad l
  66 .in
  67 .sp
  68 .BR getgrnam_r (),
  69 .BR getgrgid_r ():
  70 .RS 4
  71 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
  72 _SVID_SOURCE || _POSIX_SOURCE
  73 .RE
  74 .ad b
  75 .SH ÀâÌÀ
  76 .BR getgrnam ()
  77 ´Ø¿ô¤Ï¡¢¥°¥ë¡¼¥×Ì¾
  78 .I name
  79 ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥¨¥ó¥È¥ê¤ò
  80 Í×ÁÇËè¤ËÊ¬²ò¤·¡¢³ÆÍ×ÁÇ¤ò³ÊÇ¼¤·¤¿¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹
  81 (¥Ñ¥¹¥ï¡¼¥É¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎÎã:
  82 ¥í¡¼¥«¥ë¤Î¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë
  83 .IR /etc/group ,
  84 NIS, LDAP)¡£
  85 .PP
  86 .BR getgrgid ()
  87 ´Ø¿ô¤Ï¡¢¥°¥ë¡¼¥× ID
  88 .I uid
  89 ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥¨¥ó¥È¥ê¤ò
  90 Í×ÁÇËè¤ËÊ¬²ò¤·¡¢³ÆÍ×ÁÇ¤ò³ÊÇ¼¤·¤¿¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  91 .PP
  92 .BR getgrnam_r ()
  93 ¤È
  94 .BR getgrgid_r ()
  95 ´Ø¿ô¤Ï (¾åµ¤Î´Ø¿ô¤È) Æ±¤¸¾ðÊó¤ò¼èÆÀ¤¹¤ë¤¬¡¢
  96 ¼èÆÀ¤·¤¿
  97 .I group
  98 ¹½Â¤ÂÎ¤ò
  99 .I grp
 100 ¤¬»Ø¤¹ÎÎ°è¤Ë³ÊÇ¼¤¹¤ë¡£
 101 ¤³¤Î
 102 .I group
 103 ¹½Â¤ÂÎ¤Ë¤ÏÊ¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬´Þ¤Þ¤ì¡¢
 104 ¤³¤ì¤é¤ÎÊ¸»úÎó¤Ï¥µ¥¤¥º
 105 .I buflen
 106 ¤Î¥Ð¥Ã¥Õ¥¡
 107 .I buf
 108 ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 109 À®¸ù¤·¤¿¾ì¹ç
 110 .I *gbufp
 111 ¤Ë¤Ï·ë²Ì¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬³ÊÇ¼¤µ¤ì¤ë¡£
 112 ¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤ä¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ë¤Ï
 113 .I *result
 114 ¤Ë¤Ï NULL ¤¬Æþ¤ë¡£
 115 .PP
 116 \fIgroup\fP ¹½Â¤ÂÎ¤Ï¡¢\fI<grp.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
 117 .sp
 118 .in +4n
 119 .nf
 120 struct group {
 121     char   *gr_name;       /* ¥°¥ë¡¼¥×Ì¾ */
 122     char   *gr_passwd;     /* ¥°¥ë¡¼¥×¤Î¥Ð¥¹¥ï¡¼¥É */
 123     gid_t   gr_gid;        /* ¥°¥ë¡¼¥× ID */
 124     char  **gr_mem;        /* ¥°¥ë¡¼¥×¤Î¥á¥ó¥Ð */
 125 };
 126 .fi
 127 .in
 128 .PP
 129 .I buf
 130 ¤ËºÇÂçÉ¬Í×¤Ê¥µ¥¤¥º¤Ï¡¢
 131 .BR sysconf (3)
 132 ¤Ë°ú¤¿ô
 133 .B _SC_GETGR_R_SIZE_MAX
 134 ¤ò»ØÄê¤·¤Æ¼Â¹Ô¤¹¤ë¤³¤È¤ÇÊ¬¤«¤ë¡£
 135 .SH ÊÖ¤êÃÍ
 136 .BR getgrnam ()
 137 ¤È
 138 .BR getgrgid ()
 139 ´Ø¿ô¤Ï¡¢
 140 .I group
 141 ¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
 142 ¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤ä¡¢
 143 ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
 144 ¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¡¢
 145 .I errno
 146 ¤¬Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤ë¡£
 147 ¸Æ¤Ó½Ð¤·¤Î¸å¤Ç
 148 .I errno
 149 ¤ò¥Á¥§¥Ã¥¯¤·¤¿¤¤¾ì¹ç¤Ï¡¢
 150 ¸Æ¤Ó½Ð¤·¤ÎÁ°¤Ë (¤³¤ÎÃÍ¤ò) 0 ¤ËÀßÄê¤·¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£
 151 .LP
 152 ÊÖ¤êÃÍ¤ÏÀÅÅª¤ÊÎÎ°è¤ò»Ø¤·¤Æ¤ª¤ê¡¢¤½¤Î¸å¤Î
 153 .BR getgrent (3),
 154 .BR getgrgid (),
 155 .BR getgrnam ()
 156 ¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 157 (ÊÖ¤µ¤ì¤¿¥Ý¥¤¥ó¥¿¤ò
 158 .BR free (3)
 159 ¤ËÅÏ¤µ¤Ê¤¤¤³¤È¡£)
 160 .LP
 161 À®¸ù¤¹¤ë¤È¡¢
 162 .BR getgrnam_r ()
 163 ¤È
 164 .BR getgrgid_r ()
 165 ¤Ï 0 ¤òÊÖ¤·¡¢
 166 .I *result
 167 ¤Ë
 168 .I grp
 169 ¤òÀßÄê¤¹¤ë¡£
 170 ¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¤Ï¡¢
 171 0 ¤òÊÖ¤·¡¢
 172 .I *result
 173 ¤Ë NULL ¤òÀßÄê¤¹¤ë¡£
 174 ¥¨¥é¡¼¤Î¾ì¹ç¡¢¥¨¥é¡¼ÈÖ¹æ¤òÊÖ¤·¡¢
 175 .I *result
 176 ¤Ë NULL ¤òÀßÄê¤¹¤ë¡£
 177 .SH ¥¨¥é¡¼
 178 .TP
 179 .BR 0 " ¤Þ¤¿¤Ï " ENOENT " ¤Þ¤¿¤Ï " ESRCH " ¤Þ¤¿¤Ï " EBADF " ¤Þ¤¿¤Ï " EPERM " ¤Þ¤¿¤Ï ... "
 180 »ØÄê¤µ¤ì¤¿
 181 .I name
 182 ¤Þ¤¿¤Ï
 183 .I gid
 184 ¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¡£
 185 .TP
 186 .B EINTR
 187 ¥·¥°¥Ê¥ë¤¬¥¥ã¥Ã¥Á¤µ¤ì¤¿¡£
 188 .TP
 189 .B EIO
 190 I/O ¥¨¥é¡¼¡£
 191 .TP
 192 .B EMFILE
 193 ¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Ë¤ª¤¤¤Æ¡¢
 194 ´û¤ËºÇÂç¿ô
 195 .RB ( OPEN_MAX )
 196 ¤Î¥Õ¥¡¥¤¥ë¤¬¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¡£
 197 .TP
 198 .B ENFILE
 199 ¥·¥¹¥Æ¥à¾å¤Ç´û¤ËºÇÂç¿ô¤Î¥Õ¥¡¥¤¥ë¤¬¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¡£
 200 .TP
 201 .B ENOMEM
 202 .\" POSIX ¤Ë¤Ï¤Ê¤¤
 203 .I group
 204 ¹½Â¤ÂÎ¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
 205 .\" ¥°¥ë¡¼¥×¾ðÊó¹½Â¤ÂÎ¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¡¢¤Þ¤¿¤Ï¥Ð¥Ã¥Õ¥¡¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î
 206 .TP
 207 .B ERANGE
 208 Í¿¤¨¤é¤ì¤¿¥Ð¥Ã¥Õ¥¡¶õ´Ö¤¬ÉÔ½½Ê¬¤Ç¤¢¤ë¡£
 209 .SH ¥Õ¥¡¥¤¥ë
 210 .TP
 211 .I /etc/group
 212 ¥í¡¼¥«¥ë¤Î¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
 213 .SH ½àµò
 214 SVr4, 4.3BSD, POSIX.1-2001.
 215 .SH Ãí°Õ
 216 ¾åµ¤Î¡ÖÊÖ¤êÃÍ¡×°Ê²¼¤Îµ½Ò¤Ï POSIX.1-2001 ¤Ëµò¤ë¡£
 217 ¤³¤ÎÉ¸½à¤Ï¡Ö(¥¨¥ó¥È¥ê¤¬) ¸«¤Ä¤«¤é¤Ê¤¤¤³¤È¡×¤ò¥¨¥é¡¼¤È¤·¤Æ¤¤¤Ê¤¤¤Î¤Ç¡¢
 218 ¤½¤Î¤è¤¦¤Ê¾ì¹ç¤Ë
 219 .I errno
 220 ¤¬¤É¤Î¤è¤¦¤ÊÃÍ¤Ë¤Ê¤ë¤«¤òÄê¤á¤Æ¤¤¤Ê¤¤¡£
 221 ¤½¤Î¤¿¤á¡¢¥¨¥é¡¼¤òÇ§¼±¤¹¤ë¤³¤È¤ÏÉÔ²ÄÇ½¤Ç¤¢¤ë¡£
 222 POSIX ¤Ë½àµò¤·¤Æ¡¢¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤¤¾ì¹ç¤Ï
 223 .I errno
 224 ¤òÊÑ¹¹¤·¤Ê¤¤¤è¤¦¤Ë¤¹¤Ù¤¤Ç¤¢¤ë¡¢¤È¼çÄ¥¤¹¤ë¿Í¤â¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 225 ÍÍ¡¹¤Ê UNIX ·Ï¤Î¥·¥¹¥Æ¥à¤Ç»î¤·¤Æ¤ß¤ë¤È¡¢¤½¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¤Ï
 226 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM ¤È¤¤¤Ã¤¿ÍÍ¡¹¤ÊÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
 227 Â¾¤ÎÃÍ¤¬ÊÖ¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 228 .\" ¤è¤êÀµ³Î¤Ë¤Ï:
 229 .\" AIX 5.1 ¤Ï ESRCH ¤òÊÖ¤¹¡£
 230 .\" OSF1 4.0g ¤Ï EWOULDBLOCK ¤òÊÖ¤¹¡£
 231 .\" libc, glibc (¥Ð¡¼¥¸¥ç¥ó 2.6 ¤Þ¤Ç), Irix 6.5 ¤Ï ENOENT ¤òÊÖ¤¹¡£
 232 .\" glibc (¥Ð¡¼¥¸¥ç¥ó 2.7 °Ê¹ß) ¤Ï 0 ¤òÊÖ¤¹¡£
 233 .\" FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 ¤Ï EPERM ¤òÊÖ¤¹¡£
 234 .\" SunOS 5.8 ¤Ï EBADF ¤òÊÖ¤¹¡£
 235 .\" Tru64 5.1b, HP-UX-11i, SunOS 5.7 ¤Ï 0 ¤òÊÖ¤¹¡£
 236 .SH ´ØÏ¢¹àÌÜ
 237 .BR endgrent (3),
 238 .BR fgetgrent (3),
 239 .BR getgrent (3),
 240 .BR getpwnam (3),
 241 .BR setgrent (3),
 242 .BR group (5)