NAME

fs_getcalleraccess - Show the current user's access to a file or directory

SYNOPSIS

fs getcalleraccess [-path <path>+] [-help]

DESCRIPTION

The fs getcalleraccess command (alias fs gca) displays the access that the current user has to the specified path using the same representation as fs listacl.

OPTIONS

-path <dir/file path>+

Names each AFS file or directory to run the command on. Partial pathnames are interpreted relative to the current working directory, which is also the default value if this argument is omitted.

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT

For each path, fs getcalleraccess outputs a line like:

    Callers access to <directory> is <rights>

where <directory> is the path on which it is operating and <rights> is an ACL string in the same format as is returned by fs listacl. See fs_listacl(1) for more information about ACL strings.

EXAMPLES

The following command shows the current user's access to the path /afs/your-cell-name.com, which is read and lookup access.

   % fs getcalleraccess /afs/your-cell-name.com
   Callers access to /afs/your-cell-name.com is rl
   %

PRIVILEGE REQUIRED

No special privileges are required for this command.

SEE ALSO

fs_listacl(1), fs_setacl(1)

COPYRIGHT

Copyright 2007 Jason Edgecombe <jason@rampaginggeek.com>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Jason Edgecombe for OpenAFS.

ACKNOWLEDGEMENTS

"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)

"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)

The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).

"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).

"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.