名称

acl_init — ACL 作業用記憶域を初期化する

ライブラリ

Standard C Library (libc, -lc)

書式

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

acl_t
acl_init( int count);

解説

acl_init() 関数は、少なくとも count ACL エントリの ACL のための作業用記憶域を割り付けて初期化します。作業用記憶域へのポインタが返されます。 ACL を含むために割り付けられた作業用記憶域は、 acl_free(3) への呼び出しによって解放されます。その領域が最初に割り付けられる場合、それは ACL エントリを含んでいない ACL を含むでしょう。

メモリはこの関数によって割り付けできます。引数として (void*)acl_t で acl_free(3) を呼ぶことによって、新しい ACL がもはや要求されない場合、呼び出し側はどんな解放可能なメモリも解放するべきです。

実装に関する注

FreeBSD の POSIX.1e インタフェースおよび特徴のサポートはまだこの時期に開発中です。

戻り値

成功して終了すれば、この関数は作業用記憶域へのポインタを返します。そうでなければ、 (acl_t)NULL の値が返されます。また、 errno は、エラーを示す値が設定されます。

エラー

下記条件のうちのどれかが生じる場合、 acl_init() 関数は、 (acl_t)NULL の値を返し、対応する値を errno に設定します。

[ EINVAL]

count の値が 0 未満です。

[ ENOMEM]

返される acl_t は、ハードウェアあるいはシステム限度のメモリ管理制約によって許可されるより多くのメモリを要求します。

関連項目

acl(3), acl_free(3), posix1e(3)

規格

POSIX.1e は、IEEE の POSIX.1e の草案の 17 に記述されています。草案の議論は、クロスプラットフォームの POSIX.1e 実装メーリングリストで継続しています。このリストに加入するための、より詳しい情報については、 FreeBSD POSIX.1e 実装ページを参照してください。

歴史

POSIX.1e サポートは、 FreeBSD 4.0 で導入され、開発は継続しています。

作者

Robert N M Watson