documentation for "fs listacl -cmd"

LICENSE BSD

Reviewed-on: http://gerrit.openafs.org/586
Reviewed-by: Matt Benjamin <matt@linuxbox.com>
Reviewed-by: Hartmut Reuter <reuter@rzg.mpg.de>
Reviewed-by: Jeffrey Altman <jaltman@openafs.org>
Tested-by: Jeffrey Altman <jaltman@openafs.org>
This commit is contained in:
Jeffrey Altman 2009-10-06 09:48:57 -04:00 committed by Jeffrey Altman
parent ea78369ab6
commit e74f819555

View File

@ -7,11 +7,11 @@ fs_listacl - Displays ACLs
=for html
<div class="synopsis">
B<fs listacl> S<<< [B<-path> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-help>]
B<fs listacl> S<<< [B<-path> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-cmd>] [B<-help>]
B<fs la> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-h>]
B<fs la> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-cmd>] [B<-h>]
B<fs lista> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-h>]
B<fs lista> S<<< [B<-p> <I<dir/file path>>+] >>> [B<-id>] [B<-if>] [B<-cmd>] [B<-h>]
=for html
</div>
@ -25,7 +25,7 @@ the AFS/DFS Migration Toolkit Protocol Translator to access DFS data (and
DFS does implement per-file ACLs). To display the ACL of the current
working directory, omit the B<-path> argument.
To alter an ACL, use the fs setacl command. To copy an ACL from one
To alter an ACL, use the B<fs setacl> command. To copy an ACL from one
directory to another, use the B<fs copyacl> command. To remove obsolete
entries from an ACL, use the B<fs cleanacl> command.
@ -61,6 +61,11 @@ Displays the Initial Object ACL of each DFS directory. This argument is
supported only on DFS directories accessed via the AFS/DFS Migration
Toolkit Protocol Translator.
=item B<-cmd>
Outputs an B<fs setacl> command string that can be used to recreate
the ACL applied to the specified file, directory or symbolic link.
=item B<-help>
Prints the online help for this command. All other valid options are
@ -166,6 +171,16 @@ subdirectory.
Normal rights:
pat rlidwka
The following command generates the B<fs setacl> command required to
recreate the ACL on the home directory of the user
C<pat> (the current working directory), and on its C<private>
subdirectory.
% fs listacl -path . private -cmd
fs setacl -dir . -acl system:authuser rl pat rlidwka pat:friends rlid
fs setacl -dir . -acl smith rlidwka -negative
fs setacl -dir private -acl pat rlidwka
=head1 PRIVILEGE REQUIRED
If the B<-path> argument names an AFS directory, the issuer must have the