VOP_GETACL(9)

名称
VOP_GETACL - vnode のアクセス制御リストの取り出し

書式
<sys/param.h> <sys/vnode.h> <sys/acl.h> int VOP_GETACL(struct vnode *vp, acl_type_t type, struct acl *aclp, struct ucred *cred, struct thread *td)

解説
この vnode 呼び出しは、 ファイルまたはディレクトリからアクセス制御リスト (ACL) を 取り出すために使用可能です。

引数は以下の通りです。

vp  ファイルまたはディレクトリの vnode。

type
    取り出す ACL の型。

aclp
    ACL データを受け取る ACL 構造体へのポインタ。

cred
    要求の認証で使用されるユーザ証明。

td  ACL を要求しているスレッド。

cred ポインタは、 NULL を渡すことができ、 可能であるならばアクセス制御チェックが実行されないことを指示します。 この cred の設定は、アクティブプロセスに許されていない ACL の取り出しを、 カーネルが正当化することを認めるために使用可能です。

vnode ACL インタフェースはファイルまたはディレクトリの ACL インタフェースの セマンティクスではなく文法を定義します。 カーネル内の ACL 管理についての詳細な情報は acl(9) を参照してください。

ロック
この vnode は入る時にロックされ、戻るときまでロックされ続けるべきです。

戻り値
aclp ポインタが有効な ACL を指している場合には、0 が返されます。 そうでない場合には適切なエラーコードが返されます。

エラー

[EINVAL]
    渡された ACL 型はこの vnode には無効です。

[EACCES]
    呼び出し側が適切な特権を持っていません。

[ENOMEM]
    その要求を処理するために十分なメモリが利用可能ではありません。

[EOPNOTSUPP]
    ファイルシステムは VOP_GETACL() をサポートしていません。

関連項目
acl(9), vnode(9), VOP_ACLCHECK(9), VOP_SETACL(9)

作者
このマニュアルページは Robert Watson が書きました。