manual/LDP_man-pages/release/man2/listxattr.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 04:17:12 JST 2003
  30 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  31 .\"
  32 .\"WORD:        extended attributes     ³ÈÄ¥Â°À
  33 .\"WORD:        namespace               Ì¾Á°¶õ´Ö
  34 .\"
  35 .TH LISTXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
  36 .SH Ì¾Á°
  37 listxattr, llistxattr, flistxattr \- ³ÈÄ¥Â°À¤ÎÌ¾Á°¥ê¥¹¥È¤òÆÀ¤ë
  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 listxattr(const char\ *" path ", char\ *" list \
  45 ", size_t " size );
  46 .BI "ssize_t llistxattr(const char\ *" path ", char\ *" list \
  47 ", size_t " size );
  48 .BI "ssize_t flistxattr(int " fd ", char\ *" list ", size_t " size );
  49 .fi
  50 .fam T
  51 .SH ÀâÌÀ
  52 ³ÈÄ¥Â°À¤Ï¡¢inode (¥Õ¥¡¥¤¥ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯Åù) ¤Ë
  53 ´ØÏ¢ÉÕ¤±¤é¤ì¤¿
  54 .IR name :\c
  55 .I value
  56 ¤ÎÂÐ¤Ç¤¢¤ë¡£
  57 ¤³¤ì¤é¤Ï¡¢¥·¥¹¥Æ¥à¾å¤Î¤¹¤Ù¤Æ¤Î inode ¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤¿ÄÌ¾ï¤ÎÂ°À
  58 .RB ( stat (2)
  59 ¤¬ÊÖ¤¹¥Ç¡¼¥¿) ¤ò³ÈÄ¥¤¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
  60 ³ÈÄ¥Â°À¤Î¥³¥ó¥»¥×¥È¤Ï
  61 .BR attr (5)
  62 ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¡£
  63 .PP
  64 .BR listxattr ()
  65 ¤Ï¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥àÆâ¤Î»ØÄê¤µ¤ì¤¿
  66 .I path
  67 ¤ËÂÐ±þ¤¹¤ë³ÈÄ¥Â°À¤ÎÌ¾Á°¥ê¥¹¥È¤ò¼èÆÀ¤¹¤ë¡£
  68 ¥ê¥¹¥È¤ÏÌ¾Á°¤Î½¸¹ç¤Ç¡¢ NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤¬Ï¢Â³¤·¤ÆÊÂ¤ó¤Ç¤¤¤ë¡£
  69 ¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤¬¥¢¥¯¥»¥¹¤¹¤ë¸¢¸Â¤Î¤Ê¤¤³ÈÄ¥Â°À¤ÎÌ¾Á°¤Ï¡¢
  70 ¥ê¥¹¥È¤Ë´Þ¤Þ¤ì¤Ê¤¤¡£³ÈÄ¥Â°À¤ÎÌ¾Á°¤Î
  71 .I list
  72 ¤ÎÄ¹¤µ¤¬ÊÖ¤µ¤ì¤ë¡£
  73 .PP
  74 .BR llistxattr ()
  75 ¤Ï
  76 .BR listxattr ()
  77 ¤ÈÆ±¤¸¤À¤¬¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë
  78 ¤Ç¤Ï¤Ê¤¯¡¢¥ê¥ó¥¯¤½¤Î¤â¤Î¤Î³ÈÄ¥Â°À¤ÎÌ¾Á°¥ê¥¹¥È¤ò¼èÆÀ¤¹¤ëÅÀ¤À¤±¤¬°Û¤Ê¤ë¡£
  79 .PP
  80 .BR flistxattr ()
  81 ¤Ï
  82 .BR listxattr ()
  83 ¤ÈÆ±¤¸¤À¤¬¡¢
  84 .I path
  85 ¤ÎÂå¤ï¤ê¤Ë
  86 .I fd
  87 ¤Ç»²¾È¤µ¤ì¤¿¥ª¡¼¥×¥óºÑ¤ß¥Õ¥¡¥¤¥ë¤Î¾ðÊó¤À¤±¤ò¼èÆÀ¤¹¤ëÅÀ¤¬°Û¤Ê¤ë
  88 .RI ( filedes
  89 ¤Ï
  90 .BR open (2)
  91 ¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë)¡£
  92 .PP
  93 ¸Ä¡¹¤Î³ÈÄ¥Â°À¤Î
  94 .I name
  95 ¤ÏÉáÄÌ¤Î NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ë¡£
  96 Ì¾Á°¤Ë¤Ï¡¢Ì¾Á°¶õ´Ö¤òÉ½¤¹ÀÜÆ¬¼ (prefix) ¤¬´Þ¤Þ¤ì¤ë;
  97 ¸Ä¡¹¤Î inode ¤ËÂÐ¤·¤Æ¡¢¸ß¤¤¤ËÆÈÎ©¤ÊÌ¾Á°¶õ´Ö¤¬Ê£¿ô¤¢¤Ã¤Æ¤â¤è¤¤¡£
  98 .PP
  99 .I size
 100 ¤Ë 0 ¤ò»ØÄê¤·¤Æ¶õ¤Î¥Ð¥Ã¥Õ¥¡¤ò¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅÏ¤¹¤³¤È¤¬¤Ç¤¡¢
 101 ¤³¤Î¾ì¹ç¤Ë¤Ï³ÈÄ¥Â°À¤ÎÌ¾Á°¥ê¥¹¥È¤Î¸½ºß¤Î¥µ¥¤¥º¤¬ÊÖ¤µ¤ì¤ë¡£
 102 ¤³¤ÎÊýË¡¤ÏÌ¾Á°¥ê¥¹¥È¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂç¤¤µ¤Î¥Ð¥Ã¥Õ¥¡¡¦¥µ¥¤¥º¤ò
 103 ¸«ÀÑ¤â¤ë¤Î¤Ë»È¤¦¤³¤È¤¬¤Ç¤¤ë¡¢
 104 .SS Îã
 105 ÊÖ¤µ¤ì¤ëÌ¾Á°¤Î
 106 .I list
 107 ¤Ï¡¢ NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤ÎÇÛÎó (Â°ÀÌ¾¤Ï NULL ¥Ð¥¤¥È (\(aq\\0\(aq)
 108 ¤Ç¶èÀÚ¤é¤ì¤Æ¤¤¤ë) ¤Ç¡¢³ÆÍ×ÁÇ¤ÏÀ°Îó¤µ¤ì¤Æ¤¤¤ëÌõ¤Ç¤Ï¤Ê¤¤¡£
 109 °Ê²¼¤ËÎã¤ò¼¨¤¹:
 110 .fam C
 111 .RS
 112 .nf
 113
 114 user.name1\\0system.name1\\0user.name2\\0
 115 .fi
 116 .RE
 117 .fam T
 118 .P
 119 ³ÈÄ¥Â°À¤ò»È¤Ã¤Æ POSIX ACL ¤ò¼ÂÁõ¤·¤Æ¤¤¤ë ext2¡¢ext3¡¢XFS ¤Î¤è¤¦¤Ê¥Õ¥¡¥¤¥ë
 120 ¥·¥¹¥Æ¥à¤Ç¤Ï¡¢ÊÖ¤µ¤ì¤ë
 121 .I list
 122 ¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤ë¤³¤È¤À¤í¤¦:
 123 .fam C
 124 .RS
 125 .nf
 126
 127 system.posix_acl_access\\0system.posix_acl_default\\0
 128 .fi
 129 .RE
 130 .fam T
 131 .SH ÊÖ¤êÃÍ
 132 À®¸ù¤·¤¿¾ì¹ç¡¢³ÈÄ¥Â°À¤ÎÌ¾Á°¥ê¥¹¥È¤ÎÄ¹¤µ¤òÉ½¤¹Àµ¤Î¿ô¤¬ÊÖ¤µ¤ì¤ë¡£
 133 ¼ºÇÔ¤·¤¿¾ì¹ç¡¢ \-1 ¤¬ÊÖ¤µ¤ì¡¢
 134 .I errno
 135 ¤ËÅ¬ÀÚ¤ÊÃÍ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 136 .PP
 137 .I list
 138 ¥Ð¥Ã¥Õ¥¡¤ÎÂç¤¤µ
 139 .I size
 140 ¤¬·ë²Ì¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂç¤¤µ¤Ç¤Ê¤¤¾ì¹ç¡¢
 141 .I errno
 142 ¤Ë
 143 .B ERANGE
 144 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 145 .PP
 146 ³ÈÄ¥Â°À¤¬¤½¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
 147 ¤â¤·¤¯¤ÏÌµ¸ú¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
 148 .I errno
 149 ¤Ë
 150 .B ENOTSUP
 151 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 152 .PP
 153 .BR stat (2)
 154 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ï
 155 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤âÅ¬ÍÑ¤µ¤ì¤ë¡£
 156 .SH ¥Ð¡¼¥¸¥ç¥ó
 157 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.4 °Ê¹ß¤Î Linux ¤ÇÍøÍÑ¤Ç¤¤ë¡£
 158 glibc ¤Ç¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.3 °Ê¹ß¤Ç¹Ô¤ï¤ì¤Æ¤¤¤ë¡£
 159 .SH ½àµò
 160 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ÆÈ¼«¤Ç¤¢¤ë¡£
 161 .\" .SH Ãø¼Ô
 162 .\" Andreas Gruenbacher,
 163 .\" .RI < a.gruenbacher@computer.org >
 164 .\" ¤È the SGI XFS development team,
 165 .\" .RI < linux-xfs@oss.sgi.com >¡£
 166 .\" ¥Ð¥°¥ì¥Ý¡¼¥È¤ä¥³¥á¥ó¥È¤Ï¾åµ¤Î¥¢¥É¥ì¥¹¤Þ¤ÇÁ÷¤Ã¤Æ²¼¤µ¤¤¡£
 167 .SH ´ØÏ¢¹àÌÜ
 168 .BR getfattr (1),
 169 .BR setfattr (1),
 170 .BR getxattr (2),
 171 .BR open (2),
 172 .BR removexattr (2),
 173 .BR setxattr (2),
 174 .BR stat (2),
 175 .BR attr (5),
 176 .BR symlink (7)