VOP_GETACL(9) FreeBSD 一般コマンドマニュアル

VOP_GETACL

前のページ 上に戻る 次のページ

VOP_GETACL


     #include <sys/vnode.h>
     #include <sys/acl.h>

     int
     VOP_GETACL(struct vnode *vp, acl_type_t type, struct acl *aclp,
             struct ucred *cred, struct proc *p);


解説

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

     引数は以下の通りです。

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

     type  取り出す ACL の型。

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

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

     p     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)

ABELNET VPSサービス