名称

getfacl — ACL 情報を取得する

書式

getfacl

[ -dhinqv][ file ...]

解説

getfacl ユーティリティは、指定された (複数の) ファイルに関連付けられている任意の (discretionary) アクセス制御情報を標準出力に書き込みます。{ _POSIX_ACL_EXTENDED}が file に対して効果がないことを getconf(1) ユーティリティが示すなら、標準の任意の (discretionary) アクセスパーミッションは、必要な ACL エントリだけを含んでいる ACL として解釈されます。

次のオプションが利用可能です:

-d

アクセス ACL の代わりにディレクトリのデフォルト ACL に適用される操作。デフォルトの ACL が file ファイルを関連付けることができないなら、エラーが生成されます。このオプションは、NFSv4 ACL に対して有効ではありません。

-h

操作のターゲットがシンボリックリンクであるなら、リンクをたどらずにシンボリックリンクそれ自体から ACL を返します。

-i

NFSv4 ACL については、ユーザまたはグループ名を含むそれぞれのエントリの終りに数字の ID を追加します。 POSIX.1e ACL では無視されます。

-n

ユーザまたはグループ名に変換するのではなくユーザとグループ ID を表示します。 POSIX.1e ACL では無視されます。

-q

ファイル名と所有権に関するコメント情報を書き込みません。印刷できない文字を含むファイル名を処理するとき役に立ちます。

-v

NFSv4 ACL については、冗長なフォームでアクセスマスクとフラグを表示します。 POSIX.1e ACL では無視されます。

次のオペランドが利用可能です:

file

ACL が取り出されるファイルのパス名。 file が指定されないか、または file が - として指定されるなら、 getfacl は、標準入力から、それぞれ 1 つの改行文字によって終了している、パス名のリストを読み込みます。

ACL 構文の説明については、 setfacl(1) マニュアルページを参照してください。

終了ステータス

The getfacl utility exits 0 on success, and >0 if an error occurs.

使用例

getfacl /

ディレクトリ / のための ACL を検索して取り出します。

getfacl -d /

存在するなら、ディレクトリ / のためのデフォルト ACL を検索して取り出します。

関連項目

setfacl(1), acl(3), getextattr(8), setextattr(8), acl(9), extattr(9)

規格

getfacl ユーティリティは、 IEEE Std 1003.2c に準拠するはずです。

歴史

拡張属性とアクセス制御リストのサポートは、 TrustedBSD Project の一環として開発され、 FreeBSD 5.0 で導入されました。

作者

Robert N M Watson