名称

acl_dup — ACL 複写する

ライブラリ

Standard C Library (libc, -lc)

書式

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

acl_t
acl_dup( acl_t acl);

解説

acl_dup() 関数は、引数 acl によって指される ACL のコピーへのポインタを返します。

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

acl によって参照された ACL を参照するどんな既存の ACL ポインタも、ACL を参照し続けます。

実装に関する注

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

戻り値

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

エラー

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

[ EINVAL]

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

[ ENOMEM]

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

関連項目

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

規格

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

歴史

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

作者

Robert N M Watson