release/man2/getxattr.2

   1 .\"
   2 .\" Extended attributes system calls manual pages
   3 .\"
   4 .\" Copyright (C) Andreas Gruenbacher, February 2001
   5 .\" Copyright (C) Silicon Graphics Inc, September 2001
   6 .\"
   7 .\" This is free documentation; you can redistribute it and/or
   8 .\" modify it under the terms of the GNU General Public License as
   9 .\" published by the Free Software Foundation; either version 2 of
  10 .\" the License, or (at your option) any later version.
  11 .\"
  12 .\" The GNU General Public License's references to "object code"
  13 .\" and "executables" are to be interpreted as the output of any
  14 .\" document formatting or typesetting system, including
  15 .\" intermediate and printed output.
  16 .\"
  17 .\" This manual is distributed in the hope that it will be useful,
  18 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  19 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  20 .\" GNU General Public License for more details.
  21 .\"
  22 .\" You should have received a copy of the GNU General Public
  23 .\" License along with this manual; if not, write to the Free
  24 .\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
  25 .\" USA.
  26 .\"
  27 .\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
  28 .\"         all rights reserved.
  29 .\" Translated Tue Jul  8 02:47:19 JST 2003
  30 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  31 .\"
  32 .\"WORD:        extended attributes     ³ÈÄ¥Â°À
  33 .\"WORD:        namespace               Ì¾Á°¶õ´Ö
  34 .\"
  35 .TH GETXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
  36 .SH Ì¾Á°
  37 getxattr, lgetxattr, fgetxattr \- ³ÈÄ¥Â°À¤ÎÃÍ¤ò¼èÆÀ¤¹¤ë
  38 .SH ½ñ¼°
  39 .fam C
  40 .nf
  41 .B #include <sys/types.h>
  42 .B #include <attr/xattr.h>
  43 .sp
  44 .BI "ssize_t getxattr(const char\ *" path ", const char\ *" name ,
  45 .BI "                 void\ *" value ", size_t " size );
  46 .BI "ssize_t lgetxattr(const char\ *" path ", const char\ *" name ,
  47 .BI "                 void\ *" value ", size_t " size );
  48 .BI "ssize_t fgetxattr(int " fd ", const char\ *" name ,
  49 .BI "                 void\ *" value ", size_t " size );
  50 .fi
  51 .fam T
  52 .SH ÀâÌÀ
  53 ³ÈÄ¥Â°À¤Ï¡¢inode (¥Õ¥¡¥¤¥ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯Åù) ¤Ë
  54 ´ØÏ¢ÉÕ¤±¤é¤ì¤¿
  55 .IR name :\c
  56 .I value
  57 ¤ÎÂÐ¤Ç¤¢¤ë¡£
  58 ¤³¤ì¤é¤Ï¡¢¥·¥¹¥Æ¥à¾å¤Î¤¹¤Ù¤Æ¤Î inode ¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤¿ÄÌ¾ï¤ÎÂ°À
  59 .RB ( stat (2)
  60 ¤¬ÊÖ¤¹¥Ç¡¼¥¿) ¤ò³ÈÄ¥¤¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
  61 ³ÈÄ¥Â°À¤Î¥³¥ó¥»¥×¥È¤Ï
  62 .BR attr (5)
  63 ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¡£
  64 .PP
  65 .BR getxattr ()
  66 ¤Ï¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥àÆâ¤Î»ØÄê¤µ¤ì¤¿
  67 .I path
  68 ¤ËÂÐ±þ¤¹¤ë¡¢Ì¾Á°
  69 .I name
  70 ¤Î³ÈÄ¥Â°À¤Î
  71 .I value
  72 (ÃÍ) ¤ò¼èÆÀ¤¹¤ë¡£
  73 Â°À
  74 .I value
  75 ¤ÎÄ¹¤µ¤¬ÊÖ¤µ¤ì¤ë¡£
  76 .PP
  77 .BR lgetxattr ()
  78 ¤Ï
  79 .BR getxattr ()
  80 ¤ÈÆ±¤¸¤À¤¬¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë
  81 ¤Ç¤Ï¤Ê¤¯¡¢¥ê¥ó¥¯¤½¤Î¤â¤Î¤Î¾ðÊó¤ò¼èÆÀ¤¹¤ëÅÀ¤À¤±¤¬°Û¤Ê¤ë¡£
  82 .PP
  83 .BR fgetxattr ()
  84 ¤Ï
  85 .BR getxattr ()
  86 ¤ÈÆ±¤¸¤À¤¬¡¢
  87 .I path
  88 ¤ÎÂå¤ï¤ê¤Ë
  89 .I fd
  90 ¤Ç»²¾È¤µ¤ì¤¿¥ª¡¼¥×¥óºÑ¤ß¥Õ¥¡¥¤¥ë¤Î¾ðÊó¤À¤±¤ò¼èÆÀ¤¹¤ëÅÀ¤¬°Û¤Ê¤ë
  91 .RI ( fd
  92 ¤Ï
  93 .BR open (2)
  94 ¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë)¡£
  95 .PP
  96 ³ÈÄ¥Â°À¤ÎÌ¾Á°
  97 .I name
  98 ¤ÏÉáÄÌ¤Î NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ë¡£
  99 Ì¾Á°¤Ë¤Ï¡¢Ì¾Á°¶õ´Ö¤òÉ½¤¹ÀÜÆ¬¼ (prefix) ¤¬´Þ¤Þ¤ì¤ë;
 100 ¸Ä¡¹¤Î inode ¤ËÂÐ¤·¤Æ¡¢¸ß¤¤¤ËÆÈÎ©¤ÊÌ¾Á°¶õ´Ö¤¬Ê£¿ô¤¢¤Ã¤Æ¤â¤è¤¤¡£
 101 ³ÈÄ¥Â°À¤ÎÃÍ¤Ï¡¢¤¢¤ë°ìÄê¤ÎÄ¹¤µ¤ÎÇ¤°Õ¤Î¥Æ¥¥¹¥È¡¦¥Ç¡¼¥¿¤Þ¤¿¤Ï
 102 ¥Ð¥¤¥Ê¥ê¡¦¥Ç¡¼¥¿¤Î½¸¹ç¤Ç¤¢¤ë¡£
 103 .PP
 104 .I size
 105 ¤Ë 0 ¤ò»ØÄê¤·¤Æ¶õ¤Î¥Ð¥Ã¥Õ¥¡¤ò¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅÏ¤¹¤³¤È¤¬¤Ç¤¡¢
 106 ¤³¤Î¾ì¹ç¤Ë¤Ï»ØÄê¤µ¤ì¤¿Ì¾Á°¤Î³ÈÄ¥Â°À¤Î¸½ºß¤Î¥µ¥¤¥º¤¬ÊÖ¤µ¤ì¤ë¡£
 107 ¤³¤ÎÊýË¡¤Ï¡¢³ÈÄ¥Â°À¤ÎÃÍ¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂç¤¤µ¤Î¥Ð¥Ã¥Õ¥¡¡¦¥µ¥¤¥º¤ò
 108 ¸«ÀÑ¤â¤ë¤Î¤Ë»È¤¦¤³¤È¤¬¤Ç¤¤ë¡¢
 109 .PP
 110 ¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¡¦¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï¡¢½é´ü¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤Î¿äÂ¬¤ò¤·¤¿¤ê¡¢
 111 Í¿¤¨¤é¤ì¤¿¥Ð¥Ã¥Õ¥¡¤¬¾®¤µ¤¹¤®¤¿¤³¤È¤òÊÖ¤êÃÍ¤ÇÃÎ¤é¤»¤ë¤³¤È¤Ç¥Ð¥Ã¥Õ¥¡¤òÂç¤¤¯
 112 ¤·¤¿¤ê¤Ç¤¤ë¤è¤¦¤ËÀß·×¤µ¤ì¤Æ¤¤¤ë¡£
 113 .SH ÊÖ¤êÃÍ
 114 À®¸ù¤·¤¿¾ì¹ç¡¢³ÈÄ¥Â°À¤ÎÃÍ¤ÎÄ¹¤µ¤òÉ½¤¹Àµ¤Î¿ô¤¬ÊÖ¤µ¤ì¤ë¡£
 115 ¼ºÇÔ¤·¤¿¾ì¹ç¡¢ \-1 ¤¬ÊÖ¤µ¤ì¡¢
 116 .I errno
 117 ¤ËÅ¬ÀÚ¤ÊÃÍ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 118 .PP
 119 »ØÄê¤µ¤ì¤¿Ì¾Á°¤ÎÂ°À¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢¤Þ¤¿¤Ï¥×¥í¥»¥¹¤¬¤½¤ÎÂ°À¤Ë¥¢¥¯¥»¥¹
 120 ¤¹¤ë¸¢¸Â¤¬¤Ê¤¤¾ì¹ç¡¢
 121 .I errno
 122 ¤Ë
 123 .B ENOATTR
 124 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 125 .PP
 126 .I value
 127 ¥Ð¥Ã¥Õ¥¡¤ÎÂç¤¤µ
 128 .I size
 129 ¤¬·ë²Ì¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂç¤¤µ¤Ç¤Ê¤¤¾ì¹ç¡¢
 130 .I errno
 131 ¤Ë
 132 .B ERANGE
 133 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 134 .PP
 135 ³ÈÄ¥Â°À¤¬¤½¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
 136 ¤â¤·¤¯¤ÏÌµ¸ú¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
 137 .I errno
 138 ¤Ë
 139 .B ENOTSUP
 140 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 141 .PP
 142 .BR stat (2)
 143 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ï
 144 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤âÅ¬ÍÑ¤µ¤ì¤ë¡£
 145 .SH ¥Ð¡¼¥¸¥ç¥ó
 146 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.4 °Ê¹ß¤Î Linux ¤ÇÍøÍÑ¤Ç¤¤ë¡£
 147 glibc ¤Ç¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.3 °Ê¹ß¤Ç¹Ô¤ï¤ì¤Æ¤¤¤ë¡£
 148 .SH ½àµò
 149 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ÆÈ¼«¤Ç¤¢¤ë¡£
 150 .\" .SH Ãø¼Ô
 151 .\" Andreas Gruenbacher,
 152 .\" .RI < a.gruenbacher@computer.org >
 153 .\" ¤È SGI XFS ³«È¯¥Á¡¼¥à,
 154 .\" .RI < linux-xfs@oss.sgi.com >¡£
 155 .\" ¥Ð¥°¥ì¥Ý¡¼¥È¤ä¥³¥á¥ó¥È¤Ï¾åµ¤Î¥¢¥É¥ì¥¹¤Þ¤ÇÁ÷¤Ã¤Æ²¼¤µ¤¤¡£
 156 .SH ´ØÏ¢¹àÌÜ
 157 .BR getfattr (1),
 158 .BR setfattr (1),
 159 .BR listxattr (2),
 160 .BR open (2),
 161 .BR removexattr (2),
 162 .BR setxattr (2),
 163 .BR stat (2),
 164 .BR attr (5),
 165 .BR symlink (7)