名称

acl_get_brand_np — ACL エントリから ACL の等級付けを検索する

ライブラリ

Standard C Library (libc, -lc)

書式

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

int
acl_get_brand_np( acl_t acl, int *brand_p);

解説

acl_get_brand_np() 関数は、ACL acl のための ACL 等級付けを返す移植性のない呼び出しです。成功して終了するなら、引数 brand_p によって参照された位置に、ACL acl の ACL 等級付けが設定されます。

等級付けは、間違って POSIX.1e と NFSv4 エントリを混合することを防ぐことを意図する内部のメカニズムです。また、それは、ACL を印刷する方法を決定するために libc によって使用されます。 1 つの特定の等級付けのために指定される関数への最初の呼び出し - POSIX.1e または NFSv4 - ACL を "brand"。それ以後、別の等級付けに特有の呼び出し関数は、エラーの結果となります。

戻り値

The acl_get_brand_np() function returns the value 0 if successful; otherwise the value -1 is returned and the global variable errno is set to indicate the error.

エラー

acl_get_brand_np() 関数は、次の場合に失敗します:

[ EINVAL]

引数 acl が有効な ACL を指していません。

関連項目

acl(3), posix1e(3)

規格

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

歴史

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

作者

acl_get_brand_np() 関数は、 Edward Tomasz Napierala <trasz@FreeBSD.org>によって書かれました。