+++ /dev/null
-.\" 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
-.\" the License, or (at your option) any later version.
-.\"
-.\" The GNU General Public License's references to "object code"
-.\" and "executables" are to be interpreted as the output of any
-.\" document formatting or typesetting system, including
-.\" intermediate and printed output.
-.\"
-.\" This manual is distributed in the hope that it will be useful,
-.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
-.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
-.\" 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, see
-.\" <http://www.gnu.org/licenses/>.
-.\" %%%LICENSE_END
-.\"
-.\"*******************************************************************
-.\"
-.\" This file was generated with po4a. Translate the source file.
-.\"
-.\"*******************************************************************
-.\"
-.\" Japanese Version Copyright (c) 2003 Akihiro MOTOKI
-.\" all rights reserved.
-.\" Translated Tue Jul 8 04:43:40 JST 2003
-.\" by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
-.\" Updated 2013-03-27, Akihiro MOTOKI <amotoki@gmail.com>
-.\"
-.TH SETXATTR 2 2014\-02\-06 Linux "Linux Programmer's Manual"
-.SH 名前
-setxattr, lsetxattr, fsetxattr \- 拡張属性の値を設定する
-.SH 書式
-.fam C
-.nf
-\fB#include <sys/types.h>\fP
-\fB#include <sys/xattr.h>\fP
-.sp
-\fBint setxattr(const char\ *\fP\fIpath\fP\fB, const char\ *\fP\fIname\fP\fB,\fP
-\fB const void\ *\fP\fIvalue\fP\fB, size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP
-\fBint lsetxattr(const char\ *\fP\fIpath\fP\fB, const char\ *\fP\fIname\fP\fB,\fP
-\fB const void\ *\fP\fIvalue\fP\fB, size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP
-\fBint fsetxattr(int \fP\fIfd\fP\fB, const char\ *\fP\fIname\fP\fB,\fP
-\fB const void\ *\fP\fIvalue\fP\fB, size_t \fP\fIsize\fP\fB, int \fP\fIflags\fP\fB);\fP
-.fi
-.fam T
-.SH 説明
-拡張属性は、inode (ファイル、ディレクトリ、シンボリックリンク等) に 関連付けられた \fIname\fP:\fIvalue\fP の対である。
-これらは、システム上のすべての inode に関連付けられた通常の属性 (\fBstat\fP(2) が返すデータ) を拡張するものである。
-拡張属性のコンセプトは \fBattr\fP(5) に書かれている。
-.PP
-\fBsetxattr\fP() は、ファイルシステム内の指定された \fIpath\fP に対応する、名前 \fIname\fP の拡張属性の値 \fIvalue\fP
-を設定する。 \fIvalue\fP の \fIsize\fP は必ず指定しなければならない。
-.PP
-\fBlsetxattr\fP() は \fBsetxattr\fP() と同じだが、シンボリックリンクの場合に、リンクが参照しているファイル
-ではなく、リンクそのものの拡張属性を設定する点だけが異なる。
-.PP
-\fBfsetxattr\fP() は \fBsetxattr\fP() と同じだが、 \fIpath\fP の代わりに \fIfd\fP
-で参照されたオープン済みファイルの情報だけを設定する点が異なる (\fIfiledes\fP は \fBopen\fP(2) によって返される)。
-.PP
-拡張属性の名前 は普通のヌル終端された文字列である。 \fIname\fP には、名前空間を表す接頭辞 (prefix) が含まれる。 個々の inode
-に対して、互いに独立な名前空間が複数あってもよい。 拡張属性の値 \fIvalue\fP は、ある一定の長さの任意のテキストデータまたは
-バイナリデータの集合である。
-.PP
-操作の意味を明確にするために \fIflags\fP 引き数を使用することができる。 \fBXATTR_CREATE\fP は属性の作成だけを行うことを指定する。
-指定された名前の属性がすでに存在する場合は失敗する。 \fBXATTR_REPLACE\fP は属性の置換だけを行うことを指定する。
-指定された名前の属性がまだ存在しない場合は失敗する。 デフォルトでは (フラグを指定しない場合)、拡張属性は必要な場合は作成され、
-属性がすでに存在する場合は属性値の置換を行う。
-.SH 返り値
-成功した場合、0 が返される。 失敗した場合、 \-1 が返され、 \fIerrno\fP に適切な値がセットされる。
-.SH エラー
-.TP
-\fBEDQUOT\fP
-ディスクのクォータ上限に達した。拡張属性を格納できるだけの空き領域がないことを意味する。
-.TP
-\fBEEXIST\fP
-\fBXATTR_CREATE\fP が指定されたが、その属性はすでに存在している。
-.TP
-\fBENOATTR\fP
-\fBXATTR_REPLACE\fP が指定されたが、その属性が存在しない。(\fBENOATTR\fP は \fI<attr/xattr.h>\fP
-で \fBENODATA\fP の同義語として定義されている。)
-.TP
-\fBENOSPC\fP
-拡張属性を記憶するのに十分なスペースが残っていない。
-.TP
-\fBENOTSUP\fP
-拡張属性がそのファイルシステムでサポートされていない、もしくは無効になっている。
-\fIerrno\fP に \fBENOTSUP\fP がセットされる。
-.PP
-上記に加えて、 \fBstat\fP(2) に書かれているエラーが発生する場合もある。
-.SH バージョン
-これらのシステムコールはカーネル 2.4 以降の Linux で利用できる。 glibc でのサポートはバージョン 2.3 以降で行われている。
-.SH 準拠
-.\" .SH AUTHORS
-.\" Andreas Gruenbacher,
-.\" .RI < a.gruenbacher@computer.org >
-.\" and the SGI XFS development team,
-.\" .RI < linux-xfs@oss.sgi.com >.
-.\" Please send any bug reports or comments to these addresses.
-これらのシステムコールは Linux 独自である。
-.SH 関連項目
-\fBgetfattr\fP(1), \fBsetfattr\fP(1), \fBgetxattr\fP(2), \fBlistxattr\fP(2), \fBopen\fP(2),
-\fBremovexattr\fP(2), \fBstat\fP(2), \fBattr\fP(5), \fBsymlink\fP(7)
-.SH この文書について
-この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
-である。プロジェクトの説明とバグ報告に関する情報は
-http://www.kernel.org/doc/man\-pages/ に書かれている。
OSDN Git Service
