拡張属性のコンセプトは \fBattr\fP(5) に書かれている。
.PP
\fBlistxattr\fP() は、ファイルシステム内の指定された \fIpath\fP に対応する拡張属性の名前リストを取得する。取得したリストは
-\fIlist\fP ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\82\8bã\80\82 \fIlist\fP ã\81¯å\91¼ã\81³å\87ºã\81\97å\81´ã\81§ç¢ºä¿\9dã\81\99ã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\81§ã\80\81å¼\95ã\81\8dæ\95° \fIsize\fP ã\81§ã\83\90ã\83\83ã\83\95ã\82¡のサイズを (バイト単位で)
+\fIlist\fP ã\81«æ ¼ç´\8dã\81\95ã\82\8cã\82\8bã\80\82 \fIlist\fP ã\81¯å\91¼ã\81³å\87ºã\81\97å\81´ã\81§ç¢ºä¿\9dã\81\99ã\82\8bã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81§ã\80\81å¼\95ã\81\8dæ\95° \fIsize\fP ã\81§ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼のサイズを (バイト単位で)
指定する。リストは名前の集合で、ヌル終端された文字列が連続して並んでいる。呼び出したプロセスがアクセスする権限のない拡張属性の名前は、リストに含まれない。拡張属性の名前の
\fIlist\fP の長さが返される。
.PP
個々の拡張属性の \fIname\fP は普通のヌル終端された文字列である。 名前には、名前空間を表す接頭辞 (prefix) が含まれる; 個々の
inode に対して、互いに独立な名前空間が複数あってもよい。
.PP
-\fIsize\fP に 0 を指定して空のバッファをこれらのシステムコールに渡すことができ、 この場合には拡張属性の名前リストの現在のサイズが返される。
-ã\81\93ã\81®æ\96¹æ³\95ã\81¯å\90\8då\89\8dã\83ªã\82¹ã\83\88ã\82\92ä¿\9dæ\8c\81ã\81\99ã\82\8bã\81®ã\81«å\8d\81å\88\86ã\81ªå¤§ã\81\8dã\81\95ã\81®ã\83\90ã\83\83ã\83\95ã\82¡ã\83»サイズを 見積もるのに使うことができる、
+\fIsize\fP ã\81« 0 ã\82\92æ\8c\87å®\9aã\81\97ã\81¦ç©ºã\81®ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\82\92ã\81\93ã\82\8cã\82\89ã\81®ã\82·ã\82¹ã\83\86ã\83 ã\82³ã\83¼ã\83«ã\81«æ¸¡ã\81\99ã\81\93ã\81¨ã\81\8cã\81§ã\81\8dã\80\81 ã\81\93ã\81®å ´å\90\88ã\81«ã\81¯æ\8b¡å¼µå±\9eæ\80§ã\81®å\90\8då\89\8dã\83ªã\82¹ã\83\88ã\81®ç\8f¾å\9c¨ã\81®ã\82µã\82¤ã\82ºã\81\8cè¿\94ã\81\95ã\82\8cã\82\8bã\80\82
+ã\81\93ã\81®æ\96¹æ³\95ã\81¯å\90\8då\89\8dã\83ªã\82¹ã\83\88ã\82\92ä¿\9dæ\8c\81ã\81\99ã\82\8bã\81®ã\81«å\8d\81å\88\86ã\81ªå¤§ã\81\8dã\81\95ã\81®ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼サイズを 見積もるのに使うことができる、
.SS Example
返される名前の \fIlist\fP は、ヌル終端された文字列の配列 (属性名はヌルバイト (\(aq\e0\(aq) で区切られている)
で、各要素は整列されている訳ではない。 以下に例を示す:
拡張属性がそのファイルシステムでサポートされていない、 もしくは無効になっている。
.TP
\fBERANGE\fP
-\fIlist\fP バッファの大きさ \fIsize\fP が結果を保持するのに十分な大きさでなかった。
+\fIlist\fP ã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®å¤§ã\81\8dã\81\95 \fIsize\fP ã\81\8cçµ\90æ\9e\9cã\82\92ä¿\9dæ\8c\81ã\81\99ã\82\8bã\81®ã\81«å\8d\81å\88\86ã\81ªå¤§ã\81\8dã\81\95ã\81§ã\81ªã\81\8bã\81£ã\81\9fã\80\82
.PP
上記に加えて、 \fBstat\fP(2) に書かれているエラーが発生する場合もある。
.SH バージョン
\fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBopen\fP(2),
\fBremovexattr\fP(2), \fBsetxattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\fP(7)
.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
