(split) LDP: Update draft pages

[linuxjm/LDP_man-pages.git] / draft / man2 / listxattr.2

diff --git a/draft/man2/listxattr.2 b/draft/man2/listxattr.2
index ac7f032..bad3d7c 100644 (file)
--- a/draft/man2/listxattr.2
+++ b/draft/man2/listxattr.2
@@ -1,9 +1,7 @@
-.\"
-.\" Extended attributes system calls manual pages
-.\"

 .\" Copyright (C) Andreas Gruenbacher, February 2001
 .\" Copyright (C) Silicon Graphics Inc, September 2001
 .\"
 .\" Copyright (C) Andreas Gruenbacher, February 2001
 .\" Copyright (C) Silicon Graphics Inc, September 2001
 .\"

+.\" %%%LICENSE_START(GPLv2+_DOC_FULL)

 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of
 .\" This is free documentation; you can redistribute it and/or
 .\" modify it under the terms of the GNU General Public License as
 .\" published by the Free Software Foundation; either version 2 of


@@ -20,16 +18,23 @@
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public
 .\" GNU General Public License for more details.
 .\"
 .\" You should have received a copy of the GNU General Public

-.\" License along with this manual; if not, write to the Free
-.\" Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111,
-.\" USA.
+.\" License along with this manual; if not, see
+.\" <http://www.gnu.org/licenses/>.
+.\" %%%LICENSE_END

 .\"
 .\"*******************************************************************
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************
 .\"
 .\"*******************************************************************
 .\"
 .\" This file was generated with po4a. Translate the source file.
 .\"
 .\"*******************************************************************

-.TH LISTXATTR 2 2001\-12\-01 Linux "Linux Programmer's Manual"
+.\"
+.\" Japanese Version Copyright (c) 2003  Akihiro MOTOKI
+.\"         all rights reserved.
+.\" Translated Tue Jul  8 04:17:12 JST 2003
+.\"         by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
+.\" Updated 2013-05-01, Akihiro MOTOKI <amotoki@gmail.com>
+.\"
+.TH LISTXATTR 2 2013\-04\-09 Linux "Linux Programmer's Manual"

 .SH 名前
 listxattr, llistxattr, flistxattr \- 拡張属性の名前リストを得る
 .SH 書式
 .SH 名前
 listxattr, llistxattr, flistxattr \- 拡張属性の名前リストを得る
 .SH 書式


@@ -48,9 +53,11 @@ listxattr, llistxattr, flistxattr \- 拡張属性の名前リストを得る
 これらは、システム上のすべての inode に関連付けられた通常の属性 (\fBstat\fP(2)  が返すデータ) を拡張するものである。
 拡張属性のコンセプトは \fBattr\fP(5)  に書かれている。
 .PP
 これらは、システム上のすべての inode に関連付けられた通常の属性 (\fBstat\fP(2)  が返すデータ) を拡張するものである。
 拡張属性のコンセプトは \fBattr\fP(5)  に書かれている。
 .PP

-\fBlistxattr\fP()  は、ファイルシステム内の指定された \fIpath\fP に対応する拡張属性の名前リストを取得する。 リストは名前の集合で、
-NULL 終端された文字列が連続して並んでいる。 呼び出したプロセスがアクセスする権限のない拡張属性の名前は、 リストに含まれない。拡張属性の名前の
-\fIlist\fP の長さが返される。
+\fBlistxattr\fP()  は、ファイルシステム内の指定された \fIpath\fP に対応する拡張属性の名前リストを取得する。取得したリストは
+\fIlist\fP に格納される。 \fIlist\fP は呼び出し側で確保するバッファで、引き数 \fIsize\fP でバッファのサイズを (バイト単位で)
+指定する。リストは名前の集合で、 NULL
+終端された文字列が連続して並んでいる。呼び出したプロセスがアクセスする権限のない拡張属性の名前は、リストに含まれない。拡張属性の名前の \fIlist\fP
+の長さが返される。

 .PP
 \fBllistxattr\fP()  は \fBlistxattr\fP()  と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル
 ではなく、リンクそのものの拡張属性の名前リストを取得する点だけが異なる。
 .PP
 \fBllistxattr\fP()  は \fBlistxattr\fP()  と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル
 ではなく、リンクそのものの拡張属性の名前リストを取得する点だけが異なる。


@@ -86,14 +93,16 @@ system.posix_acl_access\e0system.posix_acl_default\e0
 .RE
 .fam T
 .SH 返り値
 .RE
 .fam T
 .SH 返り値

-成功した場合、拡張属性の名前リストの長さを表す正の数が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
-.PP
-\fIlist\fP バッファの大きさ \fIsize\fP が結果を保持するのに十分な大きさでない場合、 \fIerrno\fP に \fBERANGE\fP
-がセットされる。
-.PP
-拡張属性がそのファイルシステムでサポートされていない場合、 もしくは無効になっている場合、 \fIerrno\fP に \fBENOTSUP\fP がセットされる。
+成功した場合、拡張属性の名前リストの長さを表す非負の数が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
+.SH エラー
+.TP 
+\fBENOTSUP\fP
+拡張属性がそのファイルシステムでサポートされていない、 もしくは無効になっている。
+.TP 
+\fBERANGE\fP
+\fIlist\fP バッファの大きさ \fIsize\fP が結果を保持するのに十分な大きさでなかった。

 .PP
 .PP

-\fBstat\fP(2)  システムコールの説明に書かれているエラーは これらのシステムコールにも適用される。
+上記に加えて、 \fBstat\fP(2) に書かれているエラーが発生する場合もある。

 .SH バージョン
 これらのシステムコールはカーネル 2.4 以降の Linux で利用できる。 glibc でのサポートはバージョン 2.3 以降で行われている。
 .SH 準拠
 .SH バージョン
 これらのシステムコールはカーネル 2.4 以降の Linux で利用できる。 glibc でのサポートはバージョン 2.3 以降で行われている。
 .SH 準拠


@@ -108,6 +117,6 @@ system.posix_acl_access\e0system.posix_acl_default\e0
 \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 この文書について
 \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.40 の一部
+この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.54 の一部

 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。
 である。プロジェクトの説明とバグ報告に関する情報は
 http://www.kernel.org/doc/man\-pages/ に書かれている。