.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
.\" Updated 2013-03-26, Akihiro MOTOKI <amotoki@gmail.com>
.\"
-.TH GETXATTR 2 2013\-01\-19 Linux "Linux Programmer's Manual"
+.TH GETXATTR 2 2014\-04\-06 Linux "Linux Programmer's Manual"
.SH 名前
getxattr, lgetxattr, fgetxattr \- 拡張属性の値を取得する
.SH 書式
.fam C
.nf
\fB#include <sys/types.h>\fP
-\fB#include <attr/xattr.h>\fP
+\fB#include <sys/xattr.h>\fP
.sp
\fBssize_t getxattr(const char\ *\fP\fIpath\fP\fB, const char\ *\fP\fIname\fP\fB,\fP
\fB void\ *\fP\fIvalue\fP\fB, size_t \fP\fIsize\fP\fB);\fP
\fBfgetxattr\fP() は \fBgetxattr\fP() と同じだが、 \fIpath\fP の代わりに \fIfd\fP
で参照されたオープン済みファイルの情報だけを取得する点が異なる (\fIfd\fP は \fBopen\fP(2) によって返される)。
.PP
-拡張属性の名前 \fIname\fP は普通の NULL 終端された文字列である。 名前には、名前空間を表す接頭辞 (prefix) が含まれる; 個々の
-inode に対して、互いに独立な名前空間が複数あってもよい。 拡張属性の値は、ある一定の長さの任意のテキスト・データまたは
-バイナリ・データの集合である。
+拡張属性の名前 \fIname\fP は普通のヌル終端された文字列である。 名前には、名前空間を表す接頭辞 (prefix) が含まれる; 個々の inode
+に対して、互いに独立な名前空間が複数あってもよい。 拡張属性の値は、ある一定の長さの任意のテキストデータまたは バイナリデータの集合である。
.PP
-\fIsize\fP に 0 を指定して空のバッファをこれらのシステムコールに渡すことができ、 この場合には指定された名前の拡張属性の現在のサイズが返される。
-この方法は、拡張属性の値を保持するのに十分な大きさのバッファ・サイズを 見積もるのに使うことができる、
+\fIsize\fP に 0 を指定して空のバッファーをこれらのシステムコールに渡すことができ、
+この場合には指定された名前の拡張属性の現在のサイズが返される。 この方法は、拡張属性の値を保持するのに十分な大きさのバッファーサイズを
+見積もるのに使うことができる、
.PP
-ã\81\93ã\81®ã\82·ã\82¹ã\83\86ã\83 ã\82³ã\83¼ã\83«ã\83»ã\82¤ã\83³ã\82¿ã\83\95ã\82§ã\83¼ã\82¹ã\81¯ã\80\81å\88\9dæ\9c\9fã\83\90ã\83\83ã\83\95ã\82¡ã\81®ã\82µã\82¤ã\82ºã\81®æ\8e¨æ¸¬ã\82\92ã\81\97ã\81\9fã\82\8aã\80\81 ä¸\8eã\81\88ã\82\89ã\82\8cã\81\9fã\83\90ã\83\83ã\83\95ã\82¡ã\81\8cå°\8fã\81\95ã\81\99ã\81\8eã\81\9fã\81\93ã\81¨ã\82\92è¿\94ã\82\8aå\80¤ã\81§ç\9f¥ã\82\89ã\81\9bã\82\8bã\81\93ã\81¨ã\81§ã\83\90ã\83\83ã\83\95ã\82¡ã\82\92大ã\81\8dã\81\8f
-したりできるように設計されている。
+ã\81\93ã\81®ã\82·ã\82¹ã\83\86ã\83 ã\82³ã\83¼ã\83«ã\82¤ã\83³ã\82¿ã\83¼ã\83\95ã\82§ã\83¼ã\82¹ã\81¯ã\80\81å\88\9dæ\9c\9fã\83\90ã\83\83ã\83\95ã\82¡ã\83¼ã\81®ã\82µã\82¤ã\82ºã\81®æ\8e¨æ¸¬ã\82\92ã\81\97ã\81\9fã\82\8aã\80\81
+与えられたバッファーが小さすぎたことを返り値で知らせることでバッファーを大きく したりできるように設計されている。
.SH 返り値
-成功した場合、拡張属性の値の長さを表す正の数が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
+成功した場合、拡張属性の値の長さを表す非負の数が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
.SH エラー
.TP
\fBENOATTR\fP
拡張属性がそのファイルシステムでサポートされていない、 もしくは無効になっている。
.TP
\fBERANGE\fP
-\fIvalue\fP バッファの大きさ \fIsize\fP が結果を保持するのに十分な大きさでなかった。
+\fIvalue\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), \fBlistxattr\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.54 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
である。プロジェクトの説明とバグ報告に関する情報は
http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
