HCoop / hcoop / debian / openafs.git / blame
| Commit | Line | Data |
|---|---|---|
| 805e021f CE |
1 | =head1 NAME |
| 2 | ||
| 3 | fs_getcalleraccess - Show the current user's access to a file or directory | |
| 4 | ||
| 5 | =head1 SYNOPSIS | |
| 6 | ||
| 7 | =for html | |
| 8 | <div class="synopsis"> | |
| 9 | ||
| 10 | B<fs getcalleraccess> S<<< [B<-path> <I<path>>+] >>> [B<-help>] | |
| 11 | ||
| 12 | B<fs gca> S<<< [B<-p> <I<path>>] >>> [B<-h>] | |
| 13 | ||
| 14 | =for html | |
| 15 | </div> | |
| 16 | ||
| 17 | =head1 DESCRIPTION | |
| 18 | ||
| 19 | The B<fs getcalleraccess> command displays the access that the current | |
| 20 | user has to the specified path using the same representation as B<fs | |
| 21 | listacl>. | |
| 22 | ||
| 23 | =head1 OPTIONS | |
| 24 | ||
| 25 | =over 4 | |
| 26 | ||
| 27 | =item B<-help> | |
| 28 | ||
| 29 | Prints the online help for this command. All other valid options are | |
| 30 | ignored. | |
| 31 | ||
| 32 | =item B<-path> <I<path>>+ | |
| 33 | ||
| 34 | The B<-path> option specifies the path on which to operate. B<-path> may | |
| 35 | be omitted. If this option isn't given, the default is to act on the | |
| 36 | current directory. | |
| 37 | ||
| 38 | =back | |
| 39 | ||
| 40 | =head1 OUTPUT | |
| 41 | ||
| 42 | For each path, B<fs getcalleraccess> outputs a line like: | |
| 43 | ||
| 44 | Callers access to <directory> is <rights> | |
| 45 | ||
| 46 | where <directory> is the path on which it is operating and <rights> is an | |
| 47 | ACL string in the same format as is returned by B<fs listacl>. See | |
| 48 | L<fs_listacl(1)> for more information about AFS ACL strings. | |
| 49 | ||
| 50 | =head1 EXAMPLES | |
| 51 | ||
| 52 | The following command shows the current user's access to the path | |
| 53 | F</afs/openafs.org>, which is read and lookup access. | |
| 54 | ||
| 55 | % fs getcalleraccess /afs/openafs.org | |
| 56 | Callers access to /afs/openafs.org is rl | |
| 57 | % | |
| 58 | ||
| 59 | =head1 PRIVILEGE REQUIRED | |
| 60 | ||
| 61 | No special privileges are required for this command. | |
| 62 | ||
| 63 | =head1 SEE ALSO | |
| 64 | ||
| 65 | L<fs_listacl(1)>, | |
| 66 | L<fs_setacl(1)> | |
| 67 | ||
| 68 | =head1 COPYRIGHT | |
| 69 | ||
| 70 | Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com> | |
| 71 | ||
| 72 | This documentation is covered by the BSD License as written in the | |
| 73 | doc/LICENSE file. This man page was written by Jason Edgecombe for | |
| 74 | OpenAFS. |