日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
VOP_GETEXTATTR(9) FreeBSD カーネル開発者マニュアル VOP_GETEXTATTR(9)
名称
VOP_GETEXTATTR -- vnode からの名前付き拡張属性を検索する
書式
#include <sys/param.h>
#include <sys/vnode.h>
#include <sys/extattr.h>
int
VOP_GETEXTATTR(struct vnode *vp, int attrnamespace, const char *name,
struct uio *uio, size_t *size, struct ucred *cred,
struct thread *td);
解説
この vnode 呼び出しは、ファイルまたはディレクトリから特有の名前付き拡張属
性を検索するために使用されます。
その引数は、次の通りです:
vp ファイルまたはディレクトリの vnode。
attrnamespace どの拡張属性の名前空間に属性名が存在するかを示す整数定数。
name 属性名を含んでいる、ヌル文字で終了する文字列へのポインタ。
uio 読み込まれるデータの位置。
size NULL でないなら、返り時に、属性データをすべて読み込むため
に必要なバイトの数を含みます。ほとんどの場合、uio は、size
が、NULL でないとき、NULL となり、その逆も同様です。
cred 要求の認証で使用するユーザ資格証明。
td 拡張属性を要求しているスレッド。
cred ポインタは、できれば、アクセス制御チェックが実行されないことを示す
NULL を指定できます。この cred の設定は、アクティブなプロセスが行うことを
許されないかもしれない拡張属性の検索をカーネルが認証することができるよう
に使用されるかもしれません。
拡張属性のセマンティクスは、呼び出しを実装するファイルシステムによって異
なります。拡張属性についての多くの情報は、extattr(9) で見つけられます。
ロック
vnode は、入口でロックされ、返り時にロックされ続けるべきです。
戻り値
成功すれば、0 が返され、uio 構造体は、読み込まれたデータを反映するために
更新されます。そうでなければ、適切なエラーコードが返されます。
エラー
[ENOATTR] 要求された属性がこの vnode に対して定義されませんでし
た。
[EACCES] 呼び出し側が適切な特権を持っていません。
[ENXIO] 要求が、指定された vnode と属性名に対して、このファイ
ルシステムで有効ではありませんでした。
[ENOMEM] 十分なメモリが要求を実行するために利用可能ではありませ
ん。
[EFAULT] uio 構造体が無効のユーザ空間のアドレスを参照していま
す。
[EINVAL] name, namespace, または uio 引数が無効です。
[EOPNOTSUPP] ファイルシステムが VOP_GETEXTATTR() をサポートしていま
せん。
関連項目
extattr(9), vnode(9), VOP_LISTEXTATTR(9), VOP_SETEXTATTR(9)
バグ
属性名として空の文字列を渡すことによって、いくつかのファイルシステムは、
要求された名前空間のためのターゲットの vnode で定義された名前のリストを返
します。これは、悪い API で、明示的な VOP によって置き換えられるでしょ
う。
FreeBSD 11.4 December 23, 1999 FreeBSD 11.4