manual/LDP_man-pages/release/man2/setxattr.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:43:40 JST 2003
  30 .\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
  31 .\"
  32 .\"WORD:        extended attributes     ³ÈÄ¥Â°À
  33 .\"WORD:        namespace               Ì¾Á°¶õ´Ö
  34 .\"
  35 .TH SETXATTR 2 2001-12-31 "Linux" "Linux Programmer's Manual"
  36 .SH Ì¾Á°
  37 setxattr, lsetxattr, fsetxattr \- ³ÈÄ¥Â°À¤ÎÃÍ¤òÀßÄê¤¹¤ë
  38 .SH ½ñ¼°
  39 .fam C
  40 .nf
  41 .B #include <sys/types.h>
  42 .B #include <attr/xattr.h>
  43 .sp
  44 .BI "int setxattr(const char\ *" path ", const char\ *" name ,
  45 .BI "              const void\ *" value ", size_t " size ", int " flags );
  46 .BI "int lsetxattr(const char\ *" path ", const char\ *" name ,
  47 .BI "              const void\ *" value ", size_t " size ", int " flags );
  48 .BI "int fsetxattr(int " fd ", const char\ *" name ,
  49 .BI "              const void\ *" value ", size_t " size ", int " flags );
  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 setxattr ()
  66 ¤Ï¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥àÆâ¤Î»ØÄê¤µ¤ì¤¿
  67 .I path
  68 ¤ËÂÐ±þ¤¹¤ë¡¢Ì¾Á°
  69 .I name
  70 ¤Î³ÈÄ¥Â°À¤ÎÃÍ
  71 .I value
  72 ¤òÀßÄê¤¹¤ë¡£
  73 .I value
  74 ¤Î
  75 .I size
  76 ¤ÏÉ¬¤º»ØÄê¤·¤Ê¤±¤ì¤Ð¤Ê¤é¤Ê¤¤¡£
  77 .PP
  78 .BR lsetxattr ()
  79 ¤Ï
  80 .BR setxattr ()
  81 ¤ÈÆ±¤¸¤À¤¬¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë
  82 ¤Ç¤Ï¤Ê¤¯¡¢¥ê¥ó¥¯¤½¤Î¤â¤Î¤Î³ÈÄ¥Â°À¤òÀßÄê¤¹¤ëÅÀ¤À¤±¤¬°Û¤Ê¤ë¡£
  83 .PP
  84 .BR fsetxattr ()
  85 ¤Ï
  86 .BR setxattr ()
  87 ¤ÈÆ±¤¸¤À¤¬¡¢
  88 .I path
  89 ¤ÎÂå¤ï¤ê¤Ë
  90 .I fd
  91 ¤Ç»²¾È¤µ¤ì¤¿¥ª¡¼¥×¥óºÑ¤ß¥Õ¥¡¥¤¥ë¤Î¾ðÊó¤À¤±¤òÀßÄê¤¹¤ëÅÀ¤¬°Û¤Ê¤ë
  92 .RI ( filedes
  93 ¤Ï
  94 .BR open (2)
  95 ¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë)¡£
  96 .PP
  97 ³ÈÄ¥Â°À¤ÎÌ¾Á°
  98 ¤ÏÉáÄÌ¤Î NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ë¡£
  99 .I name
 100 ¤Ë¤Ï¡¢Ì¾Á°¶õ´Ö¤òÉ½¤¹ÀÜÆ¬¼ (prefix) ¤¬´Þ¤Þ¤ì¤ë¡£
 101 ¸Ä¡¹¤Î inode ¤ËÂÐ¤·¤Æ¡¢¸ß¤¤¤ËÆÈÎ©¤ÊÌ¾Á°¶õ´Ö¤¬Ê£¿ô¤¢¤Ã¤Æ¤â¤è¤¤¡£
 102 ³ÈÄ¥Â°À¤ÎÃÍ
 103 .I value
 104 ¤Ï¡¢¤¢¤ë°ìÄê¤ÎÄ¹¤µ¤ÎÇ¤°Õ¤Î¥Æ¥¥¹¥È¡¦¥Ç¡¼¥¿¤Þ¤¿¤Ï
 105 ¥Ð¥¤¥Ê¥ê¡¦¥Ç¡¼¥¿¤Î½¸¹ç¤Ç¤¢¤ë¡£
 106 .PP
 107 Áàºî¤Î°ÕÌ£¤òÌÀ³Î¤Ë¤¹¤ë¤¿¤á¤Ë
 108 .I flags
 109 °ú¤¿ô¤ò»ÈÍÑ¤¹¤ë¤³¤È¤¬¤Ç¤¤ë¡£
 110 .B XATTR_CREATE
 111 ¤ÏÂ°À¤ÎºîÀ®¤À¤±¤ò¹Ô¤¦¤³¤È¤ò»ØÄê¤¹¤ë¡£
 112 »ØÄê¤µ¤ì¤¿Ì¾Á°¤ÎÂ°À¤¬¤¹¤Ç¤ËÂ¸ºß¤¹¤ë¾ì¹ç¤Ï¼ºÇÔ¤¹¤ë¡£
 113 .B XATTR_REPLACE
 114 ¤ÏÂ°À¤ÎÃÖ´¹¤À¤±¤ò¹Ô¤¦¤³¤È¤ò»ØÄê¤¹¤ë¡£
 115 »ØÄê¤µ¤ì¤¿Ì¾Á°¤ÎÂ°À¤¬¤Þ¤ÀÂ¸ºß¤·¤Ê¤¤¾ì¹ç¤Ï¼ºÇÔ¤¹¤ë¡£
 116 ¥Ç¥Õ¥©¥ë¥È¤Ç¤Ï (¥Õ¥é¥°¤ò»ØÄê¤·¤Ê¤¤¾ì¹ç)¡¢³ÈÄ¥Â°À¤ÏÉ¬Í×¤Ê¾ì¹ç¤ÏºîÀ®¤µ¤ì¡¢
 117 Â°À¤¬¤¹¤Ç¤ËÂ¸ºß¤¹¤ë¾ì¹ç¤ÏÂ°ÀÃÍ¤ÎÃÖ´¹¤ò¹Ô¤¦¡£
 118 .SH ÊÖ¤êÃÍ
 119 À®¸ù¤·¤¿¾ì¹ç¡¢ 0 ¤¬ÊÖ¤µ¤ì¤ë¡£
 120 ¼ºÇÔ¤·¤¿¾ì¹ç¡¢ \-1 ¤¬ÊÖ¤µ¤ì¡¢
 121 .I errno
 122 ¤ËÅ¬ÀÚ¤ÊÃÍ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 123 .PP
 124 .B XATTR_CREATE
 125 ¤¬»ØÄê¤µ¤ì¡¢¤«¤ÄÂ°À¤¬¤¹¤Ç¤ËÂ¸ºß¤¹¤ë¾ì¹ç¡¢
 126 .I errno
 127 ¤Ë
 128 .B EEXIST
 129 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 130 .B XATTR_REPLACE
 131 ¤¬»ØÄê¤µ¤ì¡¢Â°À¤¬¤Þ¤ÀÂ¸ºß¤·¤Ê¤¤¾ì¹ç¡¢
 132 .I errno
 133 ¤Ë
 134 .B ENOATTR
 135 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 136 .PP
 137 ³ÈÄ¥Â°À¤òµ²±¤¹¤ë¤Î¤Ë½½Ê¬¤Ê¥¹¥Ú¡¼¥¹¤¬»Ä¤Ã¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
 138 .I errno
 139 ¤Ë
 140 .B ENOSPC
 141 ¤Þ¤¿¤Ï
 142 .B EDQUOT
 143 (quota ¤Ë¤è¤ëÀ©¸Â¤¬¸¶°ø¤Î¾ì¹ç) ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 144 .PP
 145 ³ÈÄ¥Â°À¤¬¤½¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
 146 ¤â¤·¤¯¤ÏÌµ¸ú¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
 147 .I errno
 148 ¤Ë
 149 .B ENOTSUP
 150 ¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
 151 .PP
 152 .BR stat (2)
 153 ¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ï
 154 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤âÅ¬ÍÑ¤µ¤ì¤ë¡£
 155 .SH ¥Ð¡¼¥¸¥ç¥ó
 156 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.4 °Ê¹ß¤Î Linux ¤ÇÍøÍÑ¤Ç¤¤ë¡£
 157 glibc ¤Ç¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.3 °Ê¹ß¤Ç¹Ô¤ï¤ì¤Æ¤¤¤ë¡£
 158 .SH ½àµò
 159 ¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux ÆÈ¼«¤Ç¤¢¤ë¡£
 160 .\" .SH Ãø¼Ô
 161 .\" Andreas Gruenbacher,
 162 .\" .RI < a.gruenbacher@computer.org >
 163 .\" ¤È SGI XFS ³«È¯¥Á¡¼¥à,
 164 .\" .RI < linux-xfs@oss.sgi.com >¡£
 165 .\" ¥Ð¥°¥ì¥Ý¡¼¥È¤ä¥³¥á¥ó¥È¤Ï¾åµ¤Î¥¢¥É¥ì¥¹¤Þ¤ÇÁ÷¤Ã¤Æ²¼¤µ¤¤¡£
 166 .SH ´ØÏ¢¹àÌÜ
 167 .BR getfattr (1),
 168 .BR setfattr (1),
 169 .BR getxattr (2),
 170 .BR listxattr (2),
 171 .BR open (2),
 172 .BR removexattr (2),
 173 .BR stat (2),
 174 .BR attr (5),
 175 .BR symlink (7)