.\" Translated Tue Jul 8 02:47:19 JST 2003
.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
-.\"WORD: extended attributes ³Èĥ°À
-.\"WORD: namespace ̾Á°¶õ´Ö
+.\"WORD: extended attributes 拡張属性
+.\"WORD: namespace 名前空間
.\"
.TH GETXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
.\"O getxattr, lgetxattr, fgetxattr \- retrieve an extended attribute value
-.SH ̾Á°
-getxattr, lgetxattr, fgetxattr \- ³Èĥ°À¤ÎÃͤò¼èÆÀ¤¹¤ë
+.SH 名前
+getxattr, lgetxattr, fgetxattr \- 拡張属性の値を取得する
.\"O .SH SYNOPSIS
-.SH ½ñ¼°
+.SH 書式
.fam C
.nf
.B #include <sys/types.h>
.fi
.fam T
.\"O .SH DESCRIPTION
-.SH ÀâÌÀ
+.SH 説明
.\"O Extended attributes are
.\"O .IR name :\c
.\"O .I value
.\"O data).
.\"O A complete overview of extended attributes concepts can be found in
.\"O .BR attr (5).
-³Èĥ°À¤Ï¡¢inode (¥Õ¥¡¥¤¥ë¡¢¥Ç¥£¥ì¥¯¥È¥ê¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯Åù) ¤Ë
-´ØÏ¢ÉÕ¤±¤é¤ì¤¿
+拡張属性は、inode (ファイル、ディレクトリ、シンボリックリンク等) に
+関連付けられた
.IR name :\c
.I value
-¤ÎÂФǤ¢¤ë¡£
-¤³¤ì¤é¤Ï¡¢¥·¥¹¥Æ¥à¾å¤Î¤¹¤Ù¤Æ¤Î inode ¤Ë´ØÏ¢ÉÕ¤±¤é¤ì¤¿Ä̾ï¤Î°À
+の対である。
+これらは、システム上のすべての inode に関連付けられた通常の属性
.RB ( stat (2)
-¤¬ÊÖ¤¹¥Ç¡¼¥¿) ¤ò³ÈÄ¥¤¹¤ë¤â¤Î¤Ç¤¢¤ë¡£
-³Èĥ°À¤Î¥³¥ó¥»¥×¥È¤Ï
+が返すデータ) を拡張するものである。
+拡張属性のコンセプトは
.BR attr (5)
-¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¡£
+に書かれている。
.PP
.\"O .BR getxattr ()
.\"O retrieves the
.\"O .I value
.\"O is returned.
.BR getxattr ()
-¤Ï¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥àÆâ¤Î»ØÄꤵ¤ì¤¿
+は、ファイルシステム内の指定された
.I path
-¤ËÂбþ¤¹¤ë¡¢Ì¾Á°
+に対応する、名前
.I name
-¤Î³Èĥ°À¤Î
+の拡張属性の
.I value
-(ÃÍ) ¤ò¼èÆÀ¤¹¤ë¡£
-°+(値) を取得する。
+属性
.I value
-¤ÎŤµ¤¬ÊÖ¤µ¤ì¤ë¡£
+の長さが返される。
.PP
.\"O .BR lgetxattr ()
.\"O is identical to
.\"O except in the case of a symbolic link, where the link itself is
.\"O interrogated, not the file that it refers to.
.BR lgetxattr ()
-¤Ï
+は
.BR getxattr ()
-¤ÈƱ¤¸¤À¤¬¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë
-¤Ç¤Ï¤Ê¤¯¡¢¥ê¥ó¥¯¤½¤Î¤â¤Î¤Î¾ðÊó¤ò¼èÆÀ¤¹¤ëÅÀ¤À¤±¤¬°Û¤Ê¤ë¡£
+と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル
+ではなく、リンクそのものの情報を取得する点だけが異なる。
.PP
.\"O .BR fgetxattr ()
.\"O is identical to
.\"O is interrogated in place of
.\"O .IR path .
.BR fgetxattr ()
-¤Ï
+は
.BR getxattr ()
-¤ÈƱ¤¸¤À¤¬¡¢
+と同じだが、
.I path
-¤ÎÂå¤ï¤ê¤Ë
+の代わりに
.I fd
-¤Ç»²¾È¤µ¤ì¤¿¥ª¡¼¥×¥óºÑ¤ß¥Õ¥¡¥¤¥ë¤Î¾ðÊó¤À¤±¤ò¼èÆÀ¤¹¤ëÅÀ¤¬°Û¤Ê¤ë
+で参照されたオープン済みファイルの情報だけを取得する点が異なる
.RI ( fd
-¤Ï
+は
.BR open (2)
-¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë)¡£
+によって返される)。
.PP
.\"O An extended attribute
.\"O .I name
.\"O namespaces associated with an individual inode.
.\"O The value of an extended attribute is a chunk of arbitrary textual or
.\"O binary data of specified length.
-³Èĥ°À¤Î̾Á°
+拡張属性の名前
.I name
-¤ÏÉáÄ̤ΠNULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ë¡£
-̾Á°¤Ë¤Ï¡¢Ì¾Á°¶õ´Ö¤òɽ¤¹ÀÜƬ¼ (prefix) ¤¬´Þ¤Þ¤ì¤ë;
-¸Ä¡¹¤Î inode ¤ËÂФ·¤Æ¡¢¸ß¤¤¤ËÆÈΩ¤Ê̾Á°¶õ´Ö¤¬Ê£¿ô¤¢¤Ã¤Æ¤â¤è¤¤¡£
-³Èĥ°À¤ÎÃͤϡ¢¤¢¤ë°ìÄê¤ÎŤµ¤ÎǤ°Õ¤Î¥Æ¥¥¹¥È¡¦¥Ç¡¼¥¿¤Þ¤¿¤Ï
-¥Ð¥¤¥Ê¥ê¡¦¥Ç¡¼¥¿¤Î½¸¹ç¤Ç¤¢¤ë¡£
+は普通の NULL 終端された文字列である。
+名前には、名前空間を表す接頭辞 (prefix) が含まれる;
+個々の inode に対して、互いに独立な名前空間が複数あってもよい。
+拡張属性の値は、ある一定の長さの任意のテキスト・データまたは
+バイナリ・データの集合である。
.PP
.\"O An empty buffer of
.\"O .I size
.\"O buffer which is sufficiently large to hold the value associated with
.\"O the extended attribute.
.I size
-¤Ë 0 ¤ò»ØÄꤷ¤Æ¶õ¤Î¥Ð¥Ã¥Õ¥¡¤ò¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅϤ¹¤³¤È¤¬¤Ç¤¡¢
-¤³¤Î¾ì¹ç¤Ë¤Ï»ØÄꤵ¤ì¤¿Ì¾Á°¤Î³Èĥ°À¤Î¸½ºß¤Î¥µ¥¤¥º¤¬ÊÖ¤µ¤ì¤ë¡£
-¤³¤ÎÊýË¡¤Ï¡¢³Èĥ°À¤ÎÃͤòÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂ礤µ¤Î¥Ð¥Ã¥Õ¥¡¡¦¥µ¥¤¥º¤ò
-¸«ÀѤâ¤ë¤Î¤Ë»È¤¦¤³¤È¤¬¤Ç¤¤ë¡¢
+に 0 を指定して空のバッファをこれらのシステムコールに渡すことができ、
+この場合には指定された名前の拡張属性の現在のサイズが返される。
+この方法は、拡張属性の値を保持するのに十分な大きさのバッファ・サイズを
+見積もるのに使うことができる、
.PP
.\"O The interface is designed to allow guessing of initial buffer
.\"O sizes, and to enlarge buffers when the return value indicates
.\"O that the buffer provided was too small.
-¤³¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¡¦¥¤¥ó¥¿¥Õ¥§¡¼¥¹¤Ï¡¢½é´ü¥Ð¥Ã¥Õ¥¡¤Î¥µ¥¤¥º¤Î¿ä¬¤ò¤·¤¿¤ê¡¢
-Í¿¤¨¤é¤ì¤¿¥Ð¥Ã¥Õ¥¡¤¬¾®¤µ¤¹¤®¤¿¤³¤È¤òÊÖ¤êÃͤÇÃΤ餻¤ë¤³¤È¤Ç¥Ð¥Ã¥Õ¥¡¤òÂ礤¯
-¤·¤¿¤ê¤Ç¤¤ë¤è¤¦¤ËÀ߷פµ¤ì¤Æ¤¤¤ë¡£
+このシステムコール・インタフェースは、初期バッファのサイズの推測をしたり、
+与えられたバッファが小さすぎたことを返り値で知らせることでバッファを大きく
+したりできるように設計されている。
.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success, a positive number is returned indicating the size of the
.\"O extended attribute value.
.\"O On failure, \-1 is returned and
.\"O .I errno
.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¡¢³Èĥ°À¤ÎÃͤÎŤµ¤òɽ¤¹Àµ¤Î¿ô¤¬ÊÖ¤µ¤ì¤ë¡£
-¼ºÇÔ¤·¤¿¾ì¹ç¡¢ \-1 ¤¬ÊÖ¤µ¤ì¡¢
+成功した場合、拡張属性の値の長さを表す正の数が返される。
+失敗した場合、 \-1 が返され、
.I errno
-¤ËŬÀÚ¤ÊÃͤ¬¥»¥Ã¥È¤µ¤ì¤ë¡£
+に適切な値がセットされる。
.PP
.\"O If the named attribute does not exist, or the process has no access to
.\"O this attribute,
.\"O .I errno
.\"O is set to
.\"O .BR ENOATTR .
-»ØÄꤵ¤ì¤¿Ì¾Á°¤Î°À¤¬Â¸ºß¤·¤Ê¤¤¾ì¹ç¡¢¤Þ¤¿¤Ï¥×¥í¥»¥¹¤¬¤½¤Î°À¤Ë¥¢¥¯¥»¥¹
-¤¹¤ë¸¢¸Â¤¬¤Ê¤¤¾ì¹ç¡¢
+æ\8c\87å®\9aã\81\95ã\82\8cã\81\9få\90\8då\89\8dã\81®å±\9eæ\80§ã\81\8cå\98å\9c¨ã\81\97ã\81ªã\81\84å ´å\90\88ã\80\81ã\81¾ã\81\9fã\81¯ã\83\97ã\83ã\82»ã\82¹ã\81\8cã\81\9dã\81®å±\9eæ\80§ã\81«ã\82¢ã\82¯ã\82»ã\82¹
+する権限がない場合、
.I errno
-¤Ë
+に
.B ENOATTR
-¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
+がセットされる。
.PP
.\"O If the
.\"O .I size
.\"O is set to
.\"O .B ERANGE .
.I value
-¥Ð¥Ã¥Õ¥¡¤ÎÂ礤µ
+バッファの大きさ
.I size
-¤¬·ë²Ì¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂ礤µ¤Ç¤Ê¤¤¾ì¹ç¡¢
+が結果を保持するのに十分な大きさでない場合、
.I errno
-¤Ë
+に
.B ERANGE
-¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
+がセットされる。
.PP
.\"O If extended attributes are not supported by the file system, or are disabled,
.\"O .I errno
.\"O is set to
.\"O .B ENOTSUP .
-³Èĥ°À¤¬¤½¤Î¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥à¤Ç¥µ¥Ý¡¼¥È¤µ¤ì¤Æ¤¤¤Ê¤¤¾ì¹ç¡¢
-¤â¤·¤¯¤Ï̵¸ú¤Ë¤Ê¤Ã¤Æ¤¤¤ë¾ì¹ç¡¢
+拡張属性がそのファイルシステムでサポートされていない場合、
+もしくは無効になっている場合、
.I errno
-¤Ë
+に
.B ENOTSUP
-¤¬¥»¥Ã¥È¤µ¤ì¤ë¡£
+がセットされる。
.PP
.\"O The errors documented for the
.\"O .BR stat (2)
.\"O system call are also applicable here.
.BR stat (2)
-¥·¥¹¥Æ¥à¥³¡¼¥ë¤ÎÀâÌÀ¤Ë½ñ¤«¤ì¤Æ¤¤¤ë¥¨¥é¡¼¤Ï
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ë¤âŬÍѤµ¤ì¤ë¡£
+システムコールの説明に書かれているエラーは
+これらのシステムコールにも適用される。
.\"O .SH VERSIONS
-.SH ¥Ð¡¼¥¸¥ç¥ó
+.SH バージョン
.\"O These system calls have been available on Linux since kernel 2.4;
.\"O glibc support is provided since version 2.3.
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï¥«¡¼¥Í¥ë 2.4 °Ê¹ß¤Î Linux ¤ÇÍøÍѤǤ¤ë¡£
-glibc ¤Ç¤Î¥µ¥Ý¡¼¥È¤Ï¥Ð¡¼¥¸¥ç¥ó 2.3 °Ê¹ß¤Ç¹Ô¤ï¤ì¤Æ¤¤¤ë¡£
+これらのシステムコールはカーネル 2.4 以降の Linux で利用できる。
+glibc でのサポートはバージョン 2.3 以降で行われている。
.\"O .SH "CONFORMING TO"
-.SH ½àµò
+.SH 準拠
.\"O These system calls are Linux-specific.
-¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤Ï Linux Æȼ«¤Ç¤¢¤ë¡£
+これらのシステムコールは Linux 独自である。
.\"O .\" .SH AUTHORS
-.\" .SH Ãø¼Ô
+.\" .SH 著者
.\"O .\" Andreas Gruenbacher,
.\"O .\" .RI < a.gruenbacher@computer.org >
.\"O .\" and the SGI XFS development team,
.\"O .\" Please send any bug reports or comments to these addresses.
.\" Andreas Gruenbacher,
.\" .RI < a.gruenbacher@computer.org >
-.\" ¤È SGI XFS ³«È¯¥Á¡¼¥à,
-.\" .RI < linux-xfs@oss.sgi.com >¡£
-.\" ¥Ð¥°¥ì¥Ý¡¼¥È¤ä¥³¥á¥ó¥È¤Ï¾åµ¤Î¥¢¥É¥ì¥¹¤Þ¤ÇÁ÷¤Ã¤Æ²¼¤µ¤¤¡£
+.\" と SGI XFS 開発チーム,
+.\" .RI < linux-xfs@oss.sgi.com >。
+.\" バグレポートやコメントは上記のアドレスまで送って下さい。
.\"O .SH SEE ALSO
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR getfattr (1),
.BR setfattr (1),
.BR listxattr (2),