getfaclのヘルプ・マニュアル／リナックスコマンド

getfaclのヘルプ・マニュアル

help
man

getfacl --help

getfacl 2.2.49 -- get file access control lists Usage: getfacl [-aceEsRLPtpndvh] file ... -a, --access display the file access control list only -d, --default display the default access control list only -c, --omit-header do not display the comment header -e, --all-effective print all effective rights -E, --no-effective print no effective rights -s, --skip-base skip files that only have the base entries -R, --recursive recurse into subdirectories -L, --logical logical walk, follow symbolic links -P, --physical physical walk, do not follow symbolic links -t, --tabular use tabular output format -n, --numeric print numeric user/group identifiers -p, --absolute-names don't strip leading '/' in pathnames -v, --version print version and exit -h, --help this help text

man getfacl

GETFACL(1) Access Control Lists GETFACL(1) 名前 getfacl - ファイルのアクセス制御リスト (access control list) を取得する書式 getfacl [-dRLPvh] file ... getfacl [-dRLPvh] - 説明各ファイルについて、getfacl はファイル名・所有者・グループ・アクセス制御リスト (ACL) を表示する。ディレクトリがデフォルト ACL を持つ場合、 getfacl はデフォルト ACL も表示する。ディレクトリ以外はデフォルト ACL を持つことができない。 ACL をサポートしていないファイルシステム上で getfacl を使うと、 getfacl は伝統的なファイルモード許可ビットで定義されるアクセス許可を表示する。 getfacl の出力形式は以下のようなものである: 1: # file: somedir/ 2: # owner: lisa 3: # group: staff 4: user::rwx 5: user:joe:rwx #effective:r-x 6: group::rwx #effective:r-x 7: group:cool:r-x 8: mask:r-x 9: other:r-x 10: default:user::rwx 11: default:user:joe:rwx #effective:r-x 12: default:group::r-x 13: default:mask:r-x 14: default:other:--- 4, 6, 9 行目はファイルモード許可ビットのユーザ・グループ・その他のフィールドに対応する。これら 3 つは基本 (base) ACL エントリと呼ばれる。 5, 7 行目は指名ユーザ (named user) と指名グループ (named group) である。 8 行目は実効権 (effective right) マスクである。このエントリは全てのグループと指名ユーザに許可されている実効権を制限する。 (ファイル所有者とその他の許可は、実効権マスクに影響を受けない。その他全てのエントリは影響を受ける。) 10-14 行目はディレクトリに関連づけられているデフォルトの ACL を表示する。ディレクトリはデフォルト ACL を持つことができる。通常のファイルはデフォルト ACL を持つことはない。 getfacl のデフォルト動作では、ACL とデフォルト ACL の両方を表示し、エントリの権利が実効権と異なるときは、実効権をコメントにして表示する。出力が端末である場合、実効権のコメントは 40 桁目に配置される。端末でない場合は、1 つのタブで ACL エントリと実効権のコメントを区切る。複数のファイルの ACL を表示する場合は、空行で区切る。 getfacl の出力は setfacl の入力に使うこともできる。許可ファイルの検索アクセス権を持つプロセス (つまり、ファイルを保持するディレクトリの読み込みアクセス権を持つプロセス) は、ファイルの ACL の読み込みアクセスも許可される。これはファイルモードへアクセスする許可と類似している。オプション --access ファイルアクセス制御リストを表示する。 -d, --default デフォルトアクセス制御リストを表示する。 --omit-header コメントヘッダ (各ファイルの出力の最初の 3 行) を表示しない。 --all-effective 実効権が ACL エントリで定義される権利と同じであっても、全ての実効権のコメントを表示する。 --no-effective 実効権のコメントを表示しない。 --skip-base 基本 ACL エントリ (所有者・グループ・その他) しか持たないファイルをスキップする。 -R, --recursive 全てのファイルとディレクトリの ACL を再帰的に一覧表示する。 -L, --logical 論理的に辿り、シンボリックリンクを辿る。デフォルトの動作では、シンボリックリンク引き数を辿り、サブディレクトリで見つかったシンボリックリンクはスキップする。 -P, --physical 物理的に辿り、全てのシンボリックリンクをスキップする。シンボリックリンク引き数もスキップする。 --tabular 別の表出力形式を使う。 ACL とデフォルト ACL が一緒に表示される。 ACL マスクエントリにより無効になっている許可は、大文字で表示される。 ACL_USER_OBJ と ACL_GROUP_OBJ エントリのエントリタグ名も大文字で表示され、これらのエントリを見つけるのに役立つ。 --absolute-names 先頭のスラッシュ文字 (‘/’) を取り除かない。デフォルトの動作では、先頭のスラッシュ文字が取り除かれる。 --version getfacl のバージョンを表示して、終了する。 --help コマンドラインオプションを説明するヘルプを表示する。 -- コマンドラインオプションの終わり。残りの引き数は、たとえダッシュ文字で始まっていたとしても、ファイル名として解釈される。 - ファイル名引き数が 1 つのダッシュ文字である場合、 getfacl は標準入力からファイルのリストを読み込む。 POSIX 1003.1e DRAFT STANDARD 17 への準拠環境変数 POSIXLY_CORRECT が定義されている場合、 getfacl のデフォルトの動作は、以下のように変わる。特に指定されていなければ、ACL のみが表示される。 -d オプションが指定された場合、デフォルト ACL のみが表示される。コマンドライン引き数が指定されない場合、 getfacl は ‘‘getfacl -’’ として起動されたときと同様に動作する。著者 Andreas Gruenbacher, . バグ報告と意見は上記のアドレスに送ってほしい。関連項目 setfacl(1), acl(5) May 2000 ACL File Utilities GETFACL(1)

GETFACL(1) Access Control Lists GETFACL(1) NAME getfacl - get file access control lists SYNOPSIS getfacl [-aceEsRLPtpndvh] file ... getfacl [-aceEsRLPtpndvh] - DESCRIPTION For each file, getfacl displays the file name, owner, the group, and the Access Control List (ACL). If a directory has a default ACL, get- facl also displays the default ACL. Non-directories cannot have default ACLs. If getfacl is used on a file system that does not support ACLs, getfacl displays the access permissions defined by the traditional file mode permission bits. The output format of getfacl is as follows: 1: # file: somedir/ 2: # owner: lisa 3: # group: staff 4: # flags: -s- 5: user::rwx 6: user:joe:rwx #effective:r-x 7: group::rwx #effective:r-x 8: group:cool:r-x 9: mask::r-x 10: other::r-x 11: default:user::rwx 12: default:user:joe:rwx #effective:r-x 13: default:group::r-x 14: default:mask::r-x 15: default:other::--- Lines 1--3 indicate the file name, owner, and owning group. Line 4 indicates the setuid (s), setgid (s), and sticky (t) bits: either the letter representing the bit, or else a dash (-). This line is included if any of those bits is set and left out otherwise, so it will not be shown for most files. (See CONFORMANCE TO POSIX 1003.1e DRAFT STANDARD 17 below.) Lines 5, 7 and 10 correspond to the user, group and other fields of the file mode permission bits. These three are called the base ACL entries. Lines 6 and 8 are named user and named group entries. Line 9 is the effective rights mask. This entry limits the effective rights granted to all groups and to named users. (The file owner and others permis- sions are not affected by the effective rights mask; all other entries are.) Lines 11--15 display the default ACL associated with this direc- tory. Directories may have a default ACL. Regular files never have a default ACL. The default behavior for getfacl is to display both the ACL and the default ACL, and to include an effective rights comment for lines where the rights of the entry differ from the effective rights. If output is to a terminal, the effective rights comment is aligned to column 40. Otherwise, a single tab character separates the ACL entry and the effective rights comment. The ACL listings of multiple files are separated by blank lines. The output of getfacl can also be used as input to setfacl. PERMISSIONS Process with search access to a file (i.e., processes with read access to the containing directory of a file) are also granted read access to the file’s ACLs. This is analogous to the permissions required for accessing the file mode. OPTIONS -a, --access Display the file access control list. -d, --default Display the default access control list. -c, --omit-header Do not display the comment header (the first three lines of each file’s output). -e, --all-effective Print all effective rights comments, even if identical to the rights defined by the ACL entry. -E, --no-effective Do not print effective rights comments. -s, --skip-base Skip files that only have the base ACL entries (owner, group, oth- ers). -R, --recursive List the ACLs of all files and directories recursively. -L, --logical Logical walk, follow symbolic links to directories. The default behavior is to follow symbolic link arguments, and skip symbolic links encountered in subdirectories. Only effective in combination with -R. -P, --physical Physical walk, do not follow symbolic links to directories. This also skips symbolic link arguments. Only effective in combination with -R. -t, --tabular Use an alternative tabular output format. The ACL and the default ACL are displayed side by side. Permissions that are ineffective due to the ACL mask entry are displayed capitalized. The entry tag names for the ACL_USER_OBJ and ACL_GROUP_OBJ entries are also dis- played in capital letters, which helps in spotting those entries. -p, --absolute-names Do not strip leading slash characters (‘/’). The default behavior is to strip leading slash characters. -n, --numeric List numeric user and group IDs -v, --version Print the version of getfacl and exit. -h, --help Print help explaining the command line options. -- End of command line options. All remaining parameters are inter- preted as file names, even if they start with a dash character. - If the file name parameter is a single dash character, getfacl reads a list of files from standard input. CONFORMANCE TO POSIX 1003.1e DRAFT STANDARD 17 If the environment variable POSIXLY_CORRECT is defined, the default behavior of getfacl changes in the following ways: Unless otherwise specified, only the ACL is printed. The default ACL is only printed if the -d option is given. If no command line parameter is given, getfacl behaves as if it was invoked as ‘‘getfacl -’’. No flags comments indi- cating the setuid, setgit, and sticky bits are generated. AUTHOR Andreas Gruenbacher, . Please send your bug reports and comments to the above address. SEE ALSO setfacl(1), acl(5) May 2000 ACL File Utilities GETFACL(1)

リナックスコマンド