xfree86 man page for fs_getfid

FS_GETFID(1)						       AFS Command Reference						      FS_GETFID(1)

NAME
       fs_getfid - Display the fid for a given path in AFS

SYNOPSIS
       fs getfid [-path] path [-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 \afsexample.eduuseroob 
	      \afsexample.orgusroblinktestsroken
	  Directory \afsexample.eduuseroob (537235559.1.1) contained in cell example.edu
	  fs: File '\afsexample.orgusroblinktestsroken' doesn't exist

	  % fs.exe getfid \afsexample.eduuseroob 
	      \afsexample.orgusroblinktestsroken -literal
	  Mountpoint \afsexample.eduuseroob (536873032.1162.16997) contained in cell example.edu
	  Symlink \afsexample.orgusroblinktestsroken (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.

OpenAFS 							    2012-03-26							      FS_GETFID(1)