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
           Windows only: 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.