lustre/doc/ll_decode_filter_fid.8

   1 .TH ll_decode_filter_fid 1 "Dec 15, 2010" Lustre "utilities"
   2 .SH NAME
   3 ll_decode_filter_fid \- display Lustre Object ID and MDT parent FID
   4 .SH SYNOPSIS
   5 .B ll_decode_filter_fid
   6 .I object_file
   7 .RI [ "object_file ..." ]
   8 .br
   9 .SH DESCRIPTION
  10 .B ll_decode_filter_fid
  11 decodes and prints the Lustre OST object ID and MDT FID and stripe index
  12 for the specified OST object(s), which is stored in the "trusted.fid"
  13 attribute on each OST object.  This is accessible to
  14 .B ll_decode_filter_fid
  15 when the OST filesystem is mounted locally as type ldiskfs for maintenance.
  16 .PP
  17 The "trusted.fid" extended attribute is stored on each OST object when it
  18 is first modified (data written or attributes set) and is not accessed or
  19 modified by Lustre after that time.
  20 .PP
  21 The OST object ID (objid) is useful in case of OST directory corruption,
  22 though normally the
  23 .BR ll_recover_lost_found_objs (8)
  24 utility is able to reconstruct the entire OST object directory hierarchy.
  25 The MDS FID can be useful to determine which MDS inode an OST object
  26 is (or was) used by.  The stripe index can be used in conjunction with
  27 other OST objects to reconstruct the layout of a file even if the MDT
  28 inode was lost.
  29 .SH EXAMPLE
  30 .fi
  31 root@oss1# cd /mnt/ost/lost+found
  32 .fi
  33 root@oss1# ll_decode_filter_fid #12345[4,5,8]
  34 .fi
  35 #123454: objid=690670 seq=0 parent=[0x751c5:0xfce6e605:0x0]
  36 .fi
  37 #123455: objid=614725 seq=0 parent=[0x18d11:0xebba84eb:0x1]
  38 .fi
  39 #123458: objid=533088 seq=0 parent=[0x21417:0x19734d61:0x0]
  40 .PP
  41 This shows that the 3 files in lost+found have decimal object IDs 690670,
  42 614725, and 533088, respectively.  The object sequence number (formerly
  43 object group) is 0 for all current OST objects.
  44 .PP
  45 The MDT parent inode FIDs are hexdecimal numbers of the form
  46 sequence:oid:idx.  Since the sequence number is below 0x100000000 in
  47 all these cases, the FIDs are in the IGIF (legacy Inode and Generation
  48 In FID) namespace and are mapped directly to the MDT inode = seq and
  49 generation = oid values, so the MDT inodes are
  50 0x751c5, 0x18d11, and 0x21417 respectively.  For objects with MDT parent
  51 sequence numbers above 0x200000000, this indicates that the FID needs
  52 to be mapped via the MDT Object Index (OI) file on the MDT to determine
  53 the internal inode number.
  54 .PP
  55 The idx field shows the stripe number of this OST object in the Lustre
  56 RAID-0 striped file.
  57 .SH SEE ALSO
  58 .BR lustre (7),
  59 .BR ll_recover_lost_found_objs (8)