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 .SH EXAMPLE
  24 .fi
  25 root@oss1# cd /mnt/ost/lost+found
  26 .fi
  27 root@oss1# ll_decode_filter_fid #12345[4,5,8]
  28 .fi
  29 #123454: objid=690670 seq=0 parent=[0x751c5:0xfce6e605:0x0]
  30 .fi
  31 #123455: objid=614725 seq=0 parent=[0x18d11:0xebba84eb:0x1]
  32 .fi
  33 #123458: objid=533088 seq=0 parent=[0x21417:0x19734d61:0x0]
  34 .PP
  35 This shows that the 3 files in lost+found have decimal object IDs 690670,
  36 614725, and 533088, respectively.  The object sequence number (formerly
  37 object group) is 0 for all current OST objects.
  38 .PP
  39 The MDT parent inode FIDs are hexdecimal numbers of the form
  40 sequence:oid:idx.  Since the sequence number is below 0x100000000 in
  41 all these cases, the FIDs are in the IGIF (legacy Inode and Generation
  42 In FID) namespace and are mapped directly to the MDT inode = seq and
  43 generation = oid values, so the MDT inodes are
  44 0x751c5, 0x18d11, and 0x21417 respectively.  For objects with MDT parent
  45 sequence numbers above 0x200000000, this indicates that the FID needs
  46 to be mapped via the MDT Object Index (OI) file on the MDT to determine
  47 the internal inode number.
  48 .PP
  49 The idx field shows the stripe number of this OST object in the Lustre
  50 RAID-0 striped file.
  51 .SH SEE ALSO
  52 .BR lustre (7),