lustre/doc/lfs-rm_entry.8

   1 .TH LFS-RMENTRY 8 2017-07-25 "Lustre" "Lustre Utilities"
   2 .SH NAME
   3 lfs-rmentry \- remove only filename from directory
   4 .SH SYNOPSIS
   5 .B lfs rmentry <FILENAME|DIRECTORY>
   6 .SH DESCRIPTION
   7 In cases where an MDT is permanently offline, or if there is an inconsistency
   8 between MDT directory contents and files (e.g. broken striped directory), the
   9 .B lfs rmentry
  10 command removes
  11 .B only
  12 the filename entry from a directory, but does not try to delete the inode
  13 corresponding to the filename.  The MDT inode itself (or a local agent inode
  14 in the case of DNE remote entries) will still remain on the MDT filesystem,
  15 and will be reconnected to the internal MDT lost+found directory when
  16 e2fsck is next run.  Since the MDT inode itself is not deleted, any OST
  17 objects referenced by this inode will also not be destroyed, so no space
  18 will be released.
  19 .SH WARNING
  20 The main reason to use
  21 .B lfs rmentry
  22 is to remove filenames or directory names that are permanently inaccessible,
  23 in order to allow them to be restored from backup, or to avoid application
  24 errors when accessing these filenames.  It should not be used to delete files
  25 that are normally accessible, and can only be run by the root user.
  26 .SH EXAMPLES
  27 .TP
  28 .B lfs rmentry /mnt/testfs/mdt7/newdir
  29 Remove directory entry
  30 .B newdir
  31 on MDT0007 since the remote MDT it is referencing is no longer accessible.
  32 .SH AUTHOR
  33 The \fBlfs rmentry\fR command is part of the Lustre filesystem.
  34 .SH SEE ALSO
  35 .BR lfs (1),
  36 .BR lfs-rmfid (1)