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 _POSIX_C_SOURCE\ >=\ 1 || _XOPEN_SOURCE || _BSD_SOURCE ||
  71 _SVID_SOURCE || _POSIX_SOURCE
  72 .ad b
  73 .SH ÀâÌÀ
  74 .BR getgrnam ()
  75 ´Ø¿ô¤Ï¡¢¥°¥ë¡¼¥×Ì¾
  76 .I name
  77 ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥¨¥ó¥È¥ê¤ò
  78 Í×ÁÇËè¤ËÊ¬²ò¤·¡¢³ÆÍ×ÁÇ¤ò³ÊÇ¼¤·¤¿¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹
  79 (¥Ñ¥¹¥ï¡¼¥É¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤ÎÎã:
  80 ¥í¡¼¥«¥ë¤Î¥°¥ë¡¼¥×¥Õ¥¡¥¤¥ë
  81 .IR /etc/group ,
  82 NIS, LDAP)¡£
  83 .PP
  84 .BR getgrgid ()
  85 ´Ø¿ô¤Ï¡¢¥°¥ë¡¼¥× ID
  86 .I uid
  87 ¤Ë¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¤Î¥¨¥ó¥È¥ê¤ò
  88 Í×ÁÇËè¤ËÊ¬²ò¤·¡¢³ÆÍ×ÁÇ¤ò³ÊÇ¼¤·¤¿¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
  89 .PP
  90 .BR getgrnam_r ()
  91 ¤È
  92 .BR getgrgid_r ()
  93 ´Ø¿ô¤Ï (¾åµ¤Î´Ø¿ô¤È) Æ±¤¸¾ðÊó¤ò¼èÆÀ¤¹¤ë¤¬¡¢
  94 ¼èÆÀ¤·¤¿
  95 .I group
  96 ¹½Â¤ÂÎ¤ò
  97 .I grp
  98 ¤¬»Ø¤¹ÎÎ°è¤Ë³ÊÇ¼¤¹¤ë¡£
  99 ¤³¤Î
 100 .I group
 101 ¹½Â¤ÂÎ¤Ë¤ÏÊ¸»úÎó¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬´Þ¤Þ¤ì¡¢
 102 ¤³¤ì¤é¤ÎÊ¸»úÎó¤Ï¥µ¥¤¥º
 103 .I buflen
 104 ¤Î¥Ð¥Ã¥Õ¥¡
 105 .I buf
 106 ¤Ë³ÊÇ¼¤µ¤ì¤ë¡£
 107 À®¸ù¤·¤¿¾ì¹ç
 108 .I *gbufp
 109 ¤Ë¤Ï·ë²Ì¤Ø¤Î¥Ý¥¤¥ó¥¿¤¬³ÊÇ¼¤µ¤ì¤ë¡£
 110 ¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤ä¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ë¤Ï
 111 .I *result
 112 ¤Ë¤Ï NULL ¤¬Æþ¤ë¡£
 113 .PP
 114 \fIgroup\fP ¹½Â¤ÂÎ¤Ï¡¢\fI<grp.h>\fP ¤Ç°Ê²¼¤Î¤è¤¦¤ËÄêµÁ¤µ¤ì¤Æ¤¤¤ë:
 115 .sp
 116 .in +4n
 117 .nf
 118 struct group {
 119     char   *gr_name;       /* ¥°¥ë¡¼¥×Ì¾ */
 120     char   *gr_passwd;     /* ¥°¥ë¡¼¥×¤Î¥Ð¥¹¥ï¡¼¥É */
 121     gid_t   gr_gid;        /* ¥°¥ë¡¼¥× ID */
 122     char  **gr_mem;        /* ¥°¥ë¡¼¥×¤Î¥á¥ó¥Ð */
 123 };
 124 .fi
 125 .in
 126 .PP
 127 .I buf
 128 ¤ËºÇÂçÉ¬Í×¤Ê¥µ¥¤¥º¤Ï¡¢
 129 .BR sysconf (3)
 130 ¤Ë°ú¤¿ô
 131 .B _SC_GETGR_R_SIZE_MAX
 132 ¤ò»ØÄê¤·¤Æ¼Â¹Ô¤¹¤ë¤³¤È¤ÇÊ¬¤«¤ë¡£
 133 .SH ÊÖ¤êÃÍ
 134 .BR getgrnam ()
 135 ¤È
 136 .BR getgrgid ()
 137 ´Ø¿ô¤Ï¡¢
 138 .I group
 139 ¹½Â¤ÂÎ¤Ø¤Î¥Ý¥¤¥ó¥¿¤òÊÖ¤¹¡£
 140 ¥Þ¥Ã¥Á¤¹¤ë¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤ä¡¢
 141 ¥¨¥é¡¼¤¬È¯À¸¤·¤¿¾ì¹ç¤Ï NULL ¤òÊÖ¤¹¡£
 142 ¥¨¥é¡¼¤¬µ¯¤³¤Ã¤¿¾ì¹ç¡¢
 143 .I errno
 144 ¤¬Å¬ÀÚ¤ËÀßÄê¤µ¤ì¤ë¡£
 145 ¸Æ¤Ó½Ð¤·¤Î¸å¤Ç
 146 .I errno
 147 ¤ò¥Á¥§¥Ã¥¯¤·¤¿¤¤¾ì¹ç¤Ï¡¢
 148 ¸Æ¤Ó½Ð¤·¤ÎÁ°¤Ë (¤³¤ÎÃÍ¤ò) 0 ¤ËÀßÄê¤·¤Æ¤ª¤¯¤Ù¤¤Ç¤¢¤ë¡£
 149 .LP
 150 ÊÖ¤êÃÍ¤ÏÀÅÅª¤ÊÎÎ°è¤ò»Ø¤·¤Æ¤ª¤ê¡¢¤½¤Î¸å¤Î
 151 .BR getgrent (3),
 152 .BR getgrgid (),
 153 .BR getgrnam ()
 154 ¤Î¸Æ¤Ó½Ð¤·¤Ç¾å½ñ¤¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 155 (ÊÖ¤µ¤ì¤¿¥Ý¥¤¥ó¥¿¤ò
 156 .BR free (3)
 157 ¤ËÅÏ¤µ¤Ê¤¤¤³¤È¡£)
 158 .LP
 159 À®¸ù¤¹¤ë¤È¡¢
 160 .BR getgrnam_r ()
 161 ¤È
 162 .BR getgrgid_r ()
 163 ¤Ï 0 ¤òÊÖ¤·¡¢
 164 .I *result
 165 ¤Ë
 166 .I grp
 167 ¤òÀßÄê¤¹¤ë¡£
 168 ¥Þ¥Ã¥Á¤¹¤ë¥°¥ë¡¼¥×¡¦¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¾ì¹ç¤Ë¤Ï¡¢
 169 0 ¤òÊÖ¤·¡¢
 170 .I *result
 171 ¤Ë NULL ¤òÀßÄê¤¹¤ë¡£
 172 ¥¨¥é¡¼¤Î¾ì¹ç¡¢¥¨¥é¡¼ÈÖ¹æ¤òÊÖ¤·¡¢
 173 .I *result
 174 ¤Ë NULL ¤òÀßÄê¤¹¤ë¡£
 175 .SH ¥¨¥é¡¼
 176 .TP
 177 .BR 0 " ¤Þ¤¿¤Ï " ENOENT " ¤Þ¤¿¤Ï " ESRCH " ¤Þ¤¿¤Ï " EBADF " ¤Þ¤¿¤Ï " EPERM " ¤Þ¤¿¤Ï ... "
 178 »ØÄê¤µ¤ì¤¿
 179 .I name
 180 ¤Þ¤¿¤Ï
 181 .I gid
 182 ¤¬¸«¤Ä¤«¤é¤Ê¤«¤Ã¤¿¡£
 183 .TP
 184 .B EINTR
 185 ¥·¥°¥Ê¥ë¤¬¥¥ã¥Ã¥Á¤µ¤ì¤¿¡£
 186 .TP
 187 .B EIO
 188 I/O ¥¨¥é¡¼¡£
 189 .TP
 190 .B EMFILE
 191 ¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤Ë¤ª¤¤¤Æ¡¢
 192 ´û¤ËºÇÂç¿ô
 193 .RB ( OPEN_MAX )
 194 ¤Î¥Õ¥¡¥¤¥ë¤¬¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¡£
 195 .TP
 196 .B ENFILE
 197 ¥·¥¹¥Æ¥à¾å¤Ç´û¤ËºÇÂç¿ô¤Î¥Õ¥¡¥¤¥ë¤¬¥ª¡¼¥×¥ó¤µ¤ì¤Æ¤¤¤ë¡£
 198 .TP
 199 .B ENOMEM
 200 .\" POSIX ¤Ë¤Ï¤Ê¤¤
 201 .I group
 202 ¹½Â¤ÂÎ¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î¥á¥â¥ê¤¬ÉÔ½½Ê¬¡£
 203 .\" ¥°¥ë¡¼¥×¾ðÊó¹½Â¤ÂÎ¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¡¢¤Þ¤¿¤Ï¥Ð¥Ã¥Õ¥¡¤ò³ä¤êÅö¤Æ¤ë¤¿¤á¤Î
 204 .TP
 205 .B ERANGE
 206 Í¿¤¨¤é¤ì¤¿¥Ð¥Ã¥Õ¥¡¶õ´Ö¤¬ÉÔ½½Ê¬¤Ç¤¢¤ë¡£
 207 .SH ¥Õ¥¡¥¤¥ë
 208 .TP
 209 .I /etc/group
 210 ¥í¡¼¥«¥ë¤Î¥°¥ë¡¼¥×¡¦¥Ç¡¼¥¿¥Ù¡¼¥¹¥Õ¥¡¥¤¥ë
 211 .SH ½àµò
 212 SVr4, 4.3BSD, POSIX.1-2001.
 213 .SH Ãí°Õ
 214 ¾åµ¤Î¡ÖÊÖ¤êÃÍ¡×°Ê²¼¤Îµ½Ò¤Ï POSIX.1-2001 ¤Ëµò¤ë¡£
 215 ¤³¤ÎÉ¸½à¤Ï¡Ö(¥¨¥ó¥È¥ê¤¬) ¸«¤Ä¤«¤é¤Ê¤¤¤³¤È¡×¤ò¥¨¥é¡¼¤È¤·¤Æ¤¤¤Ê¤¤¤Î¤Ç¡¢
 216 ¤½¤Î¤è¤¦¤Ê¾ì¹ç¤Ë
 217 .I errno
 218 ¤¬¤É¤Î¤è¤¦¤ÊÃÍ¤Ë¤Ê¤ë¤«¤òÄê¤á¤Æ¤¤¤Ê¤¤¡£
 219 ¤½¤Î¤¿¤á¡¢¥¨¥é¡¼¤òÇ§¼±¤¹¤ë¤³¤È¤ÏÉÔ²ÄÇ½¤Ç¤¢¤ë¡£
 220 POSIX ¤Ë½àµò¤·¤Æ¡¢¥¨¥ó¥È¥ê¤¬¸«¤Ä¤«¤é¤Ê¤¤¾ì¹ç¤Ï
 221 .I errno
 222 ¤òÊÑ¹¹¤·¤Ê¤¤¤è¤¦¤Ë¤¹¤Ù¤¤Ç¤¢¤ë¡¢¤È¼çÄ¥¤¹¤ë¿Í¤â¤¤¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 223 ÍÍ¡¹¤Ê Unix ·Ï¤Î¥·¥¹¥Æ¥à¤Ç»î¤·¤Æ¤ß¤ë¤È¡¢¤½¤Î¤è¤¦¤Ê¾ì¹ç¤Ë¤Ï
 224 0, ENOENT, EBADF, ESRCH, EWOULDBLOCK, EPERM ¤È¤¤¤Ã¤¿ÍÍ¡¹¤ÊÃÍ¤¬ÊÖ¤µ¤ì¤ë¡£
 225 Â¾¤ÎÃÍ¤¬ÊÖ¤µ¤ì¤ë¤«¤â¤·¤ì¤Ê¤¤¡£
 226 .\" ¤è¤êÀµ³Î¤Ë¤Ï:
 227 .\" AIX 5.1 ¤Ï ESRCH ¤òÊÖ¤¹¡£
 228 .\" OSF1 4.0g ¤Ï EWOULDBLOCK ¤òÊÖ¤¹¡£
 229 .\" libc, glibc (¥Ð¡¼¥¸¥ç¥ó 2.6 ¤Þ¤Ç), Irix 6.5 ¤Ï ENOENT ¤òÊÖ¤¹¡£
 230 .\" glibc (¥Ð¡¼¥¸¥ç¥ó 2.7 °Ê¹ß) ¤Ï 0 ¤òÊÖ¤¹¡£
 231 .\" FreeBSD 4.8, OpenBSD 3.2, NetBSD 1.6 ¤Ï EPERM ¤òÊÖ¤¹¡£
 232 .\" SunOS 5.8 ¤Ï EBADF ¤òÊÖ¤¹¡£
 233 .\" Tru64 5.1b, HP-UX-11i, SunOS 5.7 ¤Ï 0 ¤òÊÖ¤¹¡£
 234 .SH ´ØÏ¢¹àÌÜ
 235 .BR endgrent (3),
 236 .BR fgetgrent (3),
 237 .BR getgrent (3),
 238 .BR getpwnam (3),
 239 .BR setgrent (3),
 240 .BR group (5)