EN JA
ACL_GET_ENTRY(3)
ACL_GET_ENTRY(3) FreeBSD Library Functions Manual ACL_GET_ENTRY(3)

名称

acl_get_entryACL から 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_idacl_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_ENTRYentry_id での呼び出しが成功するまで、0 の値を返します。そうでなければ、-1 の値を返し、グローバル変数 errno にエラーを示す値が設定されます。

エラー

acl_get_entry() は、次の場合に失敗します:
[ EINVAL]
引数 acl は、有効な ACL を指していません。引数 entry_id は、 ACL_FIRST_ENTRY でもなく ACL_NEXT_ENTRY でもありません。

規格

POSIX.1e は、IEEE の POSIX.1e の草案の 17 に記述されています。

歴史

POSIX.1e のサポートは、 FreeBSD 4.0 で導入されました。 acl_get_entry() 関数は、 FreeBSD 5.0 で追加されました。

作者

acl_get_entry() 関数は、 Chris D. Faulhaber <jedgar@fxp.org>によって書かれました。
April 13, 2001 FreeBSD