#include <sys/types.h> #include <attr/xattr.h> ssize_t listxattr(const char *path, char *list, size_t size); ssize_t llistxattr(const char *path, char *list, size_t size); ssize_t flistxattr(int filedes, char *list, size_t size);
listxattr() は、ファイルシステム内の指定された path に対応する拡張属性の名前リストを取得する。 リストは名前の集合で、 NULL 終端された文字列が連続して並んでいる。 呼び出したプロセスがアクセスする権限のない拡張属性の名前は、 リストに含まれない。拡張属性の名前の list の長さが返される。
llistxattr() は listxattr() と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル ではなく、リンクそのものの拡張属性の名前リストを取得する点だけが異なる。
flistxattr() は listxattr() と同じだが、 path の代わりに filedes で指示されたオープン済みファイルの情報だけを取得する点が異なる (filedes は open(2) によって返される)。
個々の拡張属性の name は普通の NULL 終端された文字列である。 名前には、名前空間を表す接頭辞 (prefix) が含まれる; 個々の inode に対して、互いに独立な名前空間が複数あってもよい。
size に 0 を指定して空のバッファをこれらのシステムコールに渡すことができ、 この場合には拡張属性の名前リストの現在のサイズが返される。 この方法は名前リストを保持するのに十分な大きさのバッファ・サイズを 見積もるのに使うことができる、
user.name1\0system.name1\0user.name2\0
system.posix_acl_access\0system.posix_acl_default\0
list バッファの大きさ size が結果を保持するのに十分な大きさでない場合、 errno に ERANGE がセットされる。
拡張属性がそのファイルシステムでサポートされていない場合、 もしくは無効になっている場合、 errno に ENOTSUP がセットされる。
stat(2) システムコールの説明に書かれているエラーは これらのシステムコールにも適用される。