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 "
   6 [\fI\,OPTION\/\fR]... <\fI\,FSNAME\/\fR|\fI\,MOUNT_POINT\/\fR> <\fI\,FID\/\fR>...
   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 MOUNT_POINT
  14 specified, or relative to the filesystem mount point if
  15 .I FSNAME
  16 is provided.
  17 .SH OPTIONS
  18 .TP
  19 \fB\-f\fR, \fB\-\-print\-fid\fR
  20 Print the FID with the path.
  21 .TP
  22 \fB\-c\fR, \fB\-\-print\-link\fR
  23 Print the current link number with each pathname or parent directory.
  24 .TP
  25 \fB\-l\fR, \fB\-\-link\fR=\fI\,LINK\/\fR
  26 If a file has multiple hard links, then print only the specified LINK,
  27 starting at link 0.  If multiple FIDs are given, but only one
  28 pathname is needed for each file, use
  29 .BR "--link=0" .
  30 .SH EXAMPLES
  31 .TP
  32 .B $ lfs fid2path /mnt/testfs [0x200000403:0x11f:0x0]
  33 /mnt/testfs/etc/hosts
  34 .SH SEE ALSO
  35 .BR lfs (1),
  36 .BR lfs-getstripe (1),
  37 .BR lfs-path2fid (1),
  38 .BR llapi_fid2path (3),
  39 .BR lustre (7)