日本語 man コマンド類 (ja-man-1.1j_5) と日本語 man ドキュメント (ja-man-doc-5.4 (5.4-RELEASE 用) など) をインストールすると、以下のような man コマンド閲覧、キーワード検索が コンソールからできるようになります。
4.11-RELEASE-K, 5.4-RELEASE-K, 5.5-RELEASE-K, 6.0-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K, 12.1-RELEASE-K は、 プライベート版 (小金丸が編集してまとめたもの) ですが、 より多くの翻訳したファイルが含まれています。 (5.4-RELEASE-K から 6.4-RELEASE-K, 7.0-RELEASE-K から 7.4-RELEASE-K, 8.0-RELEASE-K から 8.4-RELEASE-K, 9.0-RELEASE-K から 9.3-RELEASE-K, 10.0-RELEASE-K から 10.3-RELEASE-K, 11.0-RELEASE-K から 11.4-RELEASE-K, 12.0-RELEASE-K から 12.4-RELEASE-K, 13.0-RELEASE-K から 13.3-RELEASE-K, 14.0-RELEASE-K から 14.1-RELEASE-K は、全翻訳済み)
13.3-STABLE-K, 15.0-CURRENT-K は現在、作成中で日々更新されています。
Table of Contents
ACL_GET(3) FreeBSD ライブラリ関数マニュアル ACL_GET(3)
名称
acl_get_fd, acl_get_fd_np, acl_get_file, acl_get_link_np -- ファイルのた
めに ACL を取得する
ライブラリ
標準 C ライブラリ (libc, -lc)
書式
#include <sys/types.h>
#include <sys/acl.h>
acl_t
acl_get_fd(int fd);
acl_t
acl_get_fd_np(int fd, acl_type_t type);
acl_t
acl_get_file(const char *path_p, acl_type_t type);
acl_t
acl_get_link_np(const char *path_p, acl_type_t type);
解説
acl_get_fd(), acl_get_file(), acl_get_link_np() と acl_get_fd_np() は、そ
れぞれ、ファイルから ACL の検索を許可します。acl_get_fd() はファイル記述
子からのタイプ ACL_TYPE_ACCESS の ACL の検索を許可する POSIX.1e 呼び出し
です。acl_get_fd_np() 関数は、ファイル記述子からの任意のタイプの ACL の検
索を許可する acl_get_fd() の移植性のない形式です。acl_get_file() 関数は、
名前によってファイルから指定された ACL のタイプの取り出しを可能にする
POSIX.1e 呼び出しです。acl_get_link_np() は呼び出しの目標がシンボリックリ
ンクである場合、シンボリックリンクをたどらない acl_get_file() の移植性の
ないバリエーションです。
メモリはこれらの関数によって割り付けできます。引数として (void *)acl_t で
acl_free(3) を呼ぶことによって、新しい ACL がもはや要求されない場合、呼び
出し側はどんな解放可能なメモリも解放するべきです。
作業用記憶域の ACL は fd によって参照されたオブジェクトに関連した ACL の
独立したコピーです。作業用記憶域の ACL は任意のアクセスコントロール決定に
参加しません。
type 引数のための有効な値は、次の通りです:
ACL_TYPE_ACCESS POSIX.1e アクセス ACL
ACL_TYPE_DEFAULT POSIX.1e デフォルト ACL
ACL_TYPE_NFS4 NFSv4 ACL
返された ACL は、それに応じて、等級 (brand) が付けられます。
実装に関する注
FreeBSD の POSIX.1e インタフェースおよび特徴のサポートはまだこの時期に開
発中です。
戻り値
成功して終了すれば、この関数は、検索された ACL へのポインタを返します。そ
うでなければ、(acl_t)NULL の値が返されます。また、errno は、エラーを示す
値が設定されます。
エラー
下記条件のうちのどれかが生じる場合、acl_get_fd() 関数は、(acl_t)NULL の値
を返し、対応する値を errno に設定します。
[EACCES] 検索許可はパス接頭辞のコンポーネントのために否定されま
す。あるいは、オブジェクトは存在します。また、プロセス
は適切なアクセス権を持っていません。
[EBADF] fd 引数が有効なファイル記述子ではありません。
[EINVAL] 渡された ACL タイプが、このファイルオブジェクトには無
効です。
[ENAMETOOLONG] パス名のコンポーネントが 255 文字を超過しました。ある
いは、パス名全体が 1023 文字を超過しました。
[ENOENT] 指定されたオブジェクトが存在しません。あるいは、path_p
引数は空の文字列を指しています。
[ENOMEM] リクエストを遂行するにはメモリが不足しています。
[EOPNOTSUPP] ファイルシステムは ACL 検索をサポートしません。
関連項目
acl(3), acl_free(3), acl_get(3), acl_get_brand_np(3), acl_set(3),
posix1e(3)
規格
POSIX.1e は、IEEE の POSIX.1e の草案の 17 に記述されています。草案の議論
は、クロスプラットフォームの POSIX.1e 実装メーリングリストで継続していま
す。このリストに加入するための、より詳しい情報については、FreeBSD
POSIX.1e 実装ページを参照してください。
歴史
POSIX.1e サポートは、FreeBSD 4.0 で導入され、開発は継続しています。
作者
Robert N M Watson
FreeBSD 11.4 June 25, 2009 FreeBSD 11.4