lfs-rmentry(8)

NAME

lfs-rm_entry, lfs-rmentry - remove only filename from directory

SYNOPSIS

DESCRIPTION

In cases where an MDT is permanently offline, or if there is an inconsistency between MDT directory contents and files (e.g. broken striped directory), the lfs rm_entry (or lfs rmentry) command removes only the directory entry name from the parent directory, but does not try to delete the inode corresponding to the filename. The MDT inode itself (or a local agent inode in the case of DNE remote entries) will still remain on the MDT filesystem, and will be reconnected to the internal MDT lost+found directory when e2fsck(8) is next run. Since the MDT inode itself is not deleted, any OST objects referenced by this inode will also not be destroyed, so no space will be released.

WARNING

The main reason to use lfs rm_entry is to remove directory entry names that are permanently inaccessible, in order to allow them to be restored from backup, or to avoid application errors when accessing these names. It should not be used to delete files that are normally accessible.

This command can only be run by the root user (administrator).

EXAMPLES

Remove a directory entry that references an inaccessible remote MDT:

# lfs rm_entry /mnt/lustre/broken_dir

AVAILABILITY

The lfs rm_entry command is part of the lustre(7) filesystem package.

SEE ALSO

e2fsck(8), lfs(1), lfs-rmfid(1)