lustre/doc/lfs-fid2path.1

   1 .TH lfs-fid2path 1 "2018-11-24" Lustre "user utilities"
   2 .SH NAME
   3 lfs fid2path \- print the pathname(s) for a file identifier
   4 .SH SYNOPSIS
   5 .BR "lfs fid2path " [ --current | -c "] [" --link | -l
   6 .RI < linkno ">] <" fsname | rootpath "> <" fid "> ...
   7 .SH DESCRIPTION
   8 .B lfs fid2path
   9 maps a numeric Lustre File IDentifier (FID) to one or more pathnames that
  10 have hard links to that file.  This allows resolving filenames for FIDs used
  11 in console error messages, and resolving all of the pathnames for a file
  12 that has multiple hard links.  Pathnames are resolved relative to the
  13 .I rootpath
  14 specified, or relative to the filesystem mountpoint if
  15 .I fsname
  16 is provided.
  17 .SH OPTIONS
  18 .TP
  19 .BR --current | -c
  20 Print the current link number with each pathname or parent directory.
  21 .TP
  22 .BR --link | -l
  23 If a file has multiple hard links, then print only the specified link number,
  24 starting at link 0.  If multiple FIDs are given, but only one
  25 pathname is needed for each file, use
  26 .BR "--link 0" .
  27 .SH EXAMPLES
  28 .TP
  29 .B $ lfs fid2path /mnt/testfs [0x200000403:0x11f:0x0]
  30 /mnt/testfs/etc/hosts
  31 .SH SEE ALSO
  32 .BR lfs (1),
  33 .BR lfs-getstripe (1),
  34 .BR lfs-path2fid (1),
  35 .BR llapi_fid2path (3),
  36 .BR lustre (7)