lustre/doc/lfs-path2fid.1

   1 .TH lfs-path2fid 1 "2018-11-24" Lustre "user utilities"
   2 .SH NAME
   3 lfs path2fid \- print the file identifier for a given pathname
   4 .SH SYNOPSIS
   5 .BR "lfs path2fid " [ --parents ]
   6 .RI < directory | file > ...
   7 .SH DESCRIPTION
   8 .B lfs path2fid
   9 prints the File Identifier for the specified
  10 .I file
  11 or
  12 .IR directory .
  13 The FID is unique for each file in the filesystem, and is never reused
  14 for other files if the file is deleted.
  15 .br
  16 The FID is also available for regular files via
  17 .BR "lfs getstripe -F".
  18 .SH OPTIONS
  19 .TP
  20 .B --parents
  21 Print out the parent FID and name(s) of the given entries. If an entry has
  22 multiple links, these are displayed on a single line, tab-separated.
  23 .SH EXAMPLES
  24 .TP
  25 .B $ lfs path2fid /mnt/lustre/etc/hosts
  26 [0x200000403:0x11f:0x0]
  27 .TP
  28 .B $ lfs path2fid --parents /mnt/lustre/etc/hosts
  29 [0x200000403:0x101:0x0]/hosts
  30 .SH SEE ALSO
  31 .BR lfs (1),
  32 .BR lfs-fid2path (1),
  33 .BR lfs-getstripe (1),
  34 .BR llapi_path2fid (3),
  35 .BR llapi_path2parent (3),
  36 .BR lustre (7)