.\" Translated Tue Jul 8 04:17:12 JST 2003
.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\"
-.\"WORD: extended attributes ³Èĥ°À
-.\"WORD: namespace ̾Á°¶õ´Ö
+.\"WORD: extended attributes 拡張属性
+.\"WORD: namespace 名前空間
.\"
.TH LISTXATTR 2 2001-12-01 "Linux" "Linux Programmer's Manual"
.\"O .SH NAME
.\"O listxattr, llistxattr, flistxattr \- list extended attribute names
-.SH ̾Á°
-listxattr, llistxattr, flistxattr \- ³Èĥ°À¤Î̾Á°¥ê¥¹¥È¤òÆÀ¤ë
+.SH 名前
+listxattr, llistxattr, flistxattr \- 拡張属性の名前リストを得る
.\"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 name:value
.\"O pairs associated with inodes (files, directories, symbolic links, etc.).
.\"O They are extensions to the normal attributes which are associated
.\"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 listxattr ()
.\"O retrieves the
.\"O .I list
.\"O is returned.
.BR listxattr ()
-¤Ï¡¢¥Õ¥¡¥¤¥ë¥·¥¹¥Æ¥àÆâ¤Î»ØÄꤵ¤ì¤¿
+は、ファイルシステム内の指定された
.I path
-¤ËÂбþ¤¹¤ë³Èĥ°À¤Î̾Á°¥ê¥¹¥È¤ò¼èÆÀ¤¹¤ë¡£
-¥ê¥¹¥È¤Ï̾Á°¤Î½¸¹ç¤Ç¡¢ NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤¬Ï¢Â³¤·¤Æʤó¤Ç¤¤¤ë¡£
-¸Æ¤Ó½Ð¤·¤¿¥×¥í¥»¥¹¤¬¥¢¥¯¥»¥¹¤¹¤ë¸¢¸Â¤Î¤Ê¤¤³Èĥ°À¤Î̾Á°¤Ï¡¢
-¥ê¥¹¥È¤Ë´Þ¤Þ¤ì¤Ê¤¤¡£³Èĥ°À¤Î̾Á°¤Î
+に対応する拡張属性の名前リストを取得する。
+リストは名前の集合で、 NULL 終端された文字列が連続して並んでいる。
+呼び出したプロセスがアクセスする権限のない拡張属性の名前は、
+リストに含まれない。拡張属性の名前の
.I list
-¤ÎŤµ¤¬ÊÖ¤µ¤ì¤ë¡£
+の長さが返される。
.PP
.\"O .BR llistxattr ()
.\"O is identical to
.\"O extended attributes associated with the link itself is retrieved,
.\"O not the file that it refers to.
.BR llistxattr ()
-¤Ï
+は
.BR listxattr ()
-¤ÈƱ¤¸¤À¤¬¡¢¥·¥ó¥Ü¥ê¥Ã¥¯¥ê¥ó¥¯¤Î¾ì¹ç¤Ë¡¢¥ê¥ó¥¯¤¬»²¾È¤·¤Æ¤¤¤ë¥Õ¥¡¥¤¥ë
-¤Ç¤Ï¤Ê¤¯¡¢¥ê¥ó¥¯¤½¤Î¤â¤Î¤Î³Èĥ°À¤Î̾Á°¥ê¥¹¥È¤ò¼èÆÀ¤¹¤ëÅÀ¤À¤±¤¬°Û¤Ê¤ë¡£
+と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル
+ではなく、リンクそのものの拡張属性の名前リストを取得する点だけが異なる。
.PP
.\"O .BR flistxattr ()
.\"O is identical to
.\"O is interrogated in place of
.\"O .IR path .
.BR flistxattr ()
-¤Ï
+は
.BR listxattr ()
-¤ÈƱ¤¸¤À¤¬¡¢
+と同じだが、
.I path
-¤ÎÂå¤ï¤ê¤Ë
+の代わりに
.I fd
-¤Ç»²¾È¤µ¤ì¤¿¥ª¡¼¥×¥óºÑ¤ß¥Õ¥¡¥¤¥ë¤Î¾ðÊó¤À¤±¤ò¼èÆÀ¤¹¤ëÅÀ¤¬°Û¤Ê¤ë
+で参照されたオープン済みファイルの情報だけを取得する点が異なる
.RI ( filedes
-¤Ï
+は
.BR open (2)
-¤Ë¤è¤Ã¤ÆÊÖ¤µ¤ì¤ë)¡£
+によって返される)。
.PP
.\"O A single extended attribute
.\"O .I name
.\"O is a simple null-terminated string.
.\"O The name includes a namespace prefix; there may be several, disjoint
.\"O namespaces associated with an individual inode.
-¸Ä¡¹¤Î³Èĥ°À¤Î
+個々の拡張属性の
.I name
-¤ÏÉáÄ̤ΠNULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤Ç¤¢¤ë¡£
-̾Á°¤Ë¤Ï¡¢Ì¾Á°¶õ´Ö¤òɽ¤¹ÀÜƬ¼ (prefix) ¤¬´Þ¤Þ¤ì¤ë;
-¸Ä¡¹¤Î inode ¤ËÂФ·¤Æ¡¢¸ß¤¤¤ËÆÈΩ¤Ê̾Á°¶õ´Ö¤¬Ê£¿ô¤¢¤Ã¤Æ¤â¤è¤¤¡£
+は普通の NULL 終端された文字列である。
+名前には、名前空間を表す接頭辞 (prefix) が含まれる;
+個々の inode に対して、互いに独立な名前空間が複数あってもよい。
.PP
.\"O An empty buffer of
.\"O .I size
.\"O list of extended attribute names, which can be used to estimate the
.\"O size of a buffer which is sufficiently large to hold the list of names.
.I size
-¤Ë 0 ¤ò»ØÄꤷ¤Æ¶õ¤Î¥Ð¥Ã¥Õ¥¡¤ò¤³¤ì¤é¤Î¥·¥¹¥Æ¥à¥³¡¼¥ë¤ËÅϤ¹¤³¤È¤¬¤Ç¤¡¢
-¤³¤Î¾ì¹ç¤Ë¤Ï³Èĥ°À¤Î̾Á°¥ê¥¹¥È¤Î¸½ºß¤Î¥µ¥¤¥º¤¬ÊÖ¤µ¤ì¤ë¡£
-¤³¤ÎÊýË¡¤Ï̾Á°¥ê¥¹¥È¤òÊÝ»ý¤¹¤ë¤Î¤Ë½½Ê¬¤ÊÂ礤µ¤Î¥Ð¥Ã¥Õ¥¡¡¦¥µ¥¤¥º¤ò
-¸«ÀѤâ¤ë¤Î¤Ë»È¤¦¤³¤È¤¬¤Ç¤¤ë¡¢
+に 0 を指定して空のバッファをこれらのシステムコールに渡すことができ、
+この場合には拡張属性の名前リストの現在のサイズが返される。
+この方法は名前リストを保持するのに十分な大きさのバッファ・サイズを
+見積もるのに使うことができる、
.\"O .SS Example
-.SS Îã
+.SS 例
.\"O The
.\"O .I list
.\"O of names is returned as an unordered array of null-terminated character
.\"O strings (attribute names are separated by null bytes (\(aq\\0\(aq)), like this:
-ÊÖ¤µ¤ì¤ë̾Á°¤Î
+返される名前の
.I list
-¤Ï¡¢ NULL ½ªÃ¼¤µ¤ì¤¿Ê¸»úÎó¤ÎÇÛÎó (°À̾¤Ï NULL ¥Ð¥¤¥È (\(aq\\0\(aq)
-¤Ç¶èÀÚ¤é¤ì¤Æ¤¤¤ë) ¤Ç¡¢³ÆÍ×ÁǤÏÀ°Î󤵤ì¤Æ¤¤¤ëÌõ¤Ç¤Ï¤Ê¤¤¡£
-°Ê²¼¤ËÎã¤ò¼¨¤¹:
+は、 NULL 終端された文字列の配列 (属性名は NULL バイト (\(aq\\0\(aq)
+で区切られている) で、各要素は整列されている訳ではない。
+以下に例を示す:
.fam C
.RS
.nf
.\"O extended attributes, might return a
.\"O .I list
.\"O like this:
-³Èĥ°À¤ò»È¤Ã¤Æ POSIX ACL ¤ò¼ÂÁõ¤·¤Æ¤¤¤ë ext2¡¢ext3¡¢XFS ¤Î¤è¤¦¤Ê¥Õ¥¡¥¤¥ë
-¥·¥¹¥Æ¥à¤Ç¤Ï¡¢ÊÖ¤µ¤ì¤ë
+拡張属性を使って POSIX ACL を実装している ext2、ext3、XFS のようなファイル
+システムでは、返される
.I list
-¤Ï°Ê²¼¤Î¤è¤¦¤Ë¤Ê¤ë¤³¤È¤À¤í¤¦:
+は以下のようになることだろう:
.fam C
.RS
.nf
.RE
.fam T
.\"O .SH RETURN VALUE
-.SH ÊÖ¤êÃÍ
+.SH 返り値
.\"O On success, a positive number is returned indicating the size of the
.\"O extended attribute name list.
.\"O On failure, \-1 is returned and
.\"O .I errno
.\"O is set appropriately.
-À®¸ù¤·¤¿¾ì¹ç¡¢³Èĥ°À¤Î̾Á°¥ê¥¹¥È¤ÎŤµ¤òɽ¤¹Àµ¤Î¿ô¤¬ÊÖ¤µ¤ì¤ë¡£
-¼ºÇÔ¤·¤¿¾ì¹ç¡¢ \-1 ¤¬ÊÖ¤µ¤ì¡¢
+成功した場合、拡張属性の名前リストの長さを表す正の数が返される。
+失敗した場合、 \-1 が返され、
.I errno
-¤ËŬÀÚ¤ÊÃͤ¬¥»¥Ã¥È¤µ¤ì¤ë¡£
+に適切な値がセットされる。
.PP
.\"O If the
.\"O .I size
.\"O is set to
.\"O .BR ERANGE .
.I list
-¥Ð¥Ã¥Õ¥¡¤ÎÂ礤µ
+バッファの大きさ
.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 .BR 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 >
-.\" ¤È the SGI XFS development team,
-.\" .RI < linux-xfs@oss.sgi.com >¡£
-.\" ¥Ð¥°¥ì¥Ý¡¼¥È¤ä¥³¥á¥ó¥È¤Ï¾åµ¤Î¥¢¥É¥ì¥¹¤Þ¤ÇÁ÷¤Ã¤Æ²¼¤µ¤¤¡£
+.\" と the SGI XFS development team,
+.\" .RI < linux-xfs@oss.sgi.com >。
+.\" バグレポートやコメントは上記のアドレスまで送って下さい。
.\"O .SH SEE ALSO
-.SH ´ØÏ¢¹àÌÜ
+.SH 関連項目
.BR getfattr (1),
.BR setfattr (1),
.BR getxattr (2),