NAME¶

fs_getfid - Display the fid for a given path in AFS

SYNOPSIS¶

fs getfid [-path] path [-literal] [-help]

DESCRIPTION¶

The fs getfid command displays the FID for a given path in AFS. The FID is the internal identifier used by AFS encoding the volume name and the file within a volume.

CAUTIONS¶

This command is not available on Windows prior to version 1.5.60.

OPTIONS¶

-path path

The path of the file (or directory).

-literal

For a symlink or mount point, evaluates the specified object rather than the object it refers to.

-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/example.com/foo 
   File /afs/example.com/foo (536870918.20404.20997) contained in volume 536870918

On Windows:

   % fs.exe getfid \\afs\example.edu\user\b\o\bob \
       \\afs\example.org\usr\bob\linktests\broken
   Directory \\afs\example.edu\user\b\o\bob (537235559.1.1) contained in cell example.edu
   fs: File '\\afs\example.org\usr\bob\linktests\broken' doesn't exist
   % fs.exe getfid \\afs\example.edu\user\b\o\bob \
       \\afs\example.org\usr\bob\linktests\broken -literal
   Mountpoint \\afs\example.edu\user\b\o\bob (536873032.1162.16997) contained in cell example.edu
   Symlink \\afs\example.org\usr\bob\linktests\broken (536874416.27618.488969) contained in cell example.org

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.