ACL_GET_ENTRY(3) | FreeBSD Library Functions Manual | ACL_GET_ENTRY(3) |
名称
acl_get_entry — ACL から ACL エントリを検索して取り出すライブラリ
Standard C Library (libc, -lc)書式
#include < sys/types.h>#include < sys/acl.h>
int
acl_get_entry( acl_t acl, int entry_id, acl_entry_t *entry_p);
解説
acl_get_entry() 関数は、引数 acl によって示された ACL 中の引数 entry_d によって指定された ACL エントリのための記述子を検索して取り出す POSIX.1e 呼び出しです。entry_id の値が ACL_FIRST_ENTRY である場合、関数は、 acl 中の最初の ACL エントリのための記述子を entry_p で返すでしょう。 acl_get_entry() への初期の呼び出しか、 acl_create_entry(), acl_delete_entry(), acl_dup(), acl_from_text(), acl_get_fd(), acl_get_file(), acl_set_fd(), acl_set_file() または acl_valid() への以前の呼び出しのどちらが成功しなかったとき、 ACL_NEXT_ENTRY に設定された entry_id で acl_get_entry() への呼び出しが行なわれる場合、結果は不定です。
戻り値
acl_get_entry() 関数は、ACL エントリの取得に成功する場合、1 の値を返します。 ACL に ACL エントリがない場合、 acl_get_entry() は、0 の値を返します。 entry_id の値が ACL_NEXT_ENTRY であり、 ACL 中の最後の ACL エントリが acl_get_entry() への以前の呼び出しによって既に返されている場合、 ACL_FIRST_ENTRY の entry_id での呼び出しが成功するまで、0 の値を返します。そうでなければ、-1 の値を返し、グローバル変数 errno にエラーを示す値が設定されます。エラー
acl_get_entry() は、次の場合に失敗します:- [ EINVAL]
- 引数 acl は、有効な ACL を指していません。引数 entry_id は、 ACL_FIRST_ENTRY でもなく ACL_NEXT_ENTRY でもありません。
関連項目
acl(3), acl_calc_mask(3), acl_create_entry(3), acl_delete_entry(3), acl_dup(3), acl_from_text(3), acl_get_fd(3), acl_get_file(3), acl_init(3), acl_set_fd(3), acl_set_file(3), acl_valid(3), posix1e(3)規格
POSIX.1e は、IEEE の POSIX.1e の草案の 17 に記述されています。歴史
POSIX.1e のサポートは、 FreeBSD 4.0 で導入されました。 acl_get_entry() 関数は、 FreeBSD 5.0 で追加されました。作者
acl_get_entry() 関数は、 <jedgar@fxp.org>によって書かれました。April 13, 2001 | FreeBSD |