NAME

fs_getfid - Display the fid for a path in /afs

SYNOPSIS

fs getfid [-pathpath [-nofollow] [-help]

DESCRIPTION

The fs getfid command displays the FID for a path in /afs. The FID is the internal identifier used by the Cache Manager and File Servers encoding the volume identifier and the file within a volume.

OPTIONS

-path path

The path of the file (or directory).

-nofollow

When specified, the targets of symlinks and mountpoints are not resolved.

-help

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

OUTPUT

The output contains the name of the file or directory, the FID, and the volume containing the FID. The Windows version also outputs the object type instead of using "File" to describe all objects.

EXAMPLES

On UNIX:

   % fs getfid .
   File . (536870918.1.1) contained in volume 536870918

   % fs getfid /afs/your-cell-name.com/foo
   File /afs/your-cell-name.com/foo (536870918.20404.20997) contained in volume 536870918

On Windows:

   % fs.exe getfid \\afs\your-cell-name.com\user\b\o\bob \
       \\afs\your-cell-name.com\usr\bob\linktests\broken
   Directory \\afs\your-cell-name.com\user\b\o\bob (537235559.1.1) contained in cell your-cell-name.com
   fs: File '\\afs\your-cell-name.com\usr\bob\linktests\broken' doesn't exist

   % fs.exe getfid \\afs\your-cell-name.com\user\b\o\bob \
       \\afs\your-cell-name.com\usr\bob\linktests\broken -nofollow
   Mountpoint \\afs\your-cell-name.com\user\b\o\bob (536873032.1162.16997) contained in cell your-cell-name.com
   Symlink \\afs\your-cell-name.com\usr\bob\linktests\broken (536874416.27618.488969) contained in cell your-cell-name.com

PRIVILEGE REQUIRED

The issuer must be have read access in the directory containing the path to be resolved.

COPYRIGHT

This document was written by Steven Jenkins, and is released under the IBM Public License Version 1.0. Jeffrey Altman made several suggestions and additions.

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.