summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTim Shimmin <tes@sgi.com>2007-12-03 16:55:54 +0000
committerTim Shimmin <tes@sgi.com>2007-12-03 16:55:54 +0000
commit264bff299a6da24bcdbec4e8ba2131cd865718cc (patch)
tree7c0d648e0905bbf7ac8f8a733ed84e77e501e639
parente26d3f3349fa03f97f970fb6e68e4e242140a0d1 (diff)
downloadacl-264bff299a6da24bcdbec4e8ba2131cd865718cc.tar.gz
Update man pages about tree walking and symlinks.
Merge of master-melb:xfs-cmds:30185a by kenmcd. Update man pages about tree walking and symlinks.
-rw-r--r--doc/CHANGES4
-rw-r--r--man/man1/getfacl.111
-rw-r--r--man/man1/setfacl.110
3 files changed, 17 insertions, 8 deletions
diff --git a/doc/CHANGES b/doc/CHANGES
index 1503acb..5ae69f2 100644
--- a/doc/CHANGES
+++ b/doc/CHANGES
@@ -1,3 +1,7 @@
+2.2.47
+* Update setfacl/getfacl man pages for symlink related options
+ thanks to Andreas G.
+
2.2.46 (21 November 2007)
* From Andreas Gruenbacher:
* Update acl.5 man page to clarify the relationship between
diff --git a/man/man1/getfacl.1 b/man/man1/getfacl.1
index 0f9a7dc..a702e8e 100644
--- a/man/man1/getfacl.1
+++ b/man/man1/getfacl.1
@@ -100,13 +100,14 @@ Skip files that only have the base ACL entries (owner, group, others).
List the ACLs of all files and directories recursively.
.TP
.I \-L, \-\-logical
-Logical walk, follow symbolic links. The default behavior is to follow
-symbolic link arguments, and to skip symbolic links encountered in
-subdirectories.
+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.
.TP
.I \-P, \-\-physical
-Physical walk, skip all symbolic links. This also skips symbolic link
-arguments.
+Physical walk, do not follow symbolic links to directories. This also skips symbolic
+link arguments.
+Only effective in combination with \-R.
.TP
.I \-\-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 displayed in capital letters, which helps in spotting those entries.
diff --git a/man/man1/setfacl.1 b/man/man1/setfacl.1
index e04e35f..92d3b18 100644
--- a/man/man1/setfacl.1
+++ b/man/man1/setfacl.1
@@ -104,11 +104,15 @@ Test mode. Instead of changing the ACLs of any files, the resulting ACLs are lis
Apply operations to all files and directories recursively. This option cannot be mixed with `\-\-restore'.
.TP 4
.I \-L, \-\-logical
-Logical walk, follow symbolic links. The default behavior is to follow symbolic link arguments, and to skip symbolic links encountered
-in subdirectories. This option cannot be mixed with `\-\-restore'.
+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.
+This option cannot be mixed with `\-\-restore'.
.TP 4
.I \-P, \-\-physical
-Physical walk, skip all symbolic links. This also skips symbolic link arguments.
+Physical walk, do not follow symbolic links to directories.
+This also skips symbolic link arguments.
+Only effective in combination with \-R.
This option cannot be mixed with `\-\-restore'.
.TP 4
.I \-\-version