[HADOOP-12374] Description of hdfs expunge command is confusing

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 2.7.0, 2.7.1
• Fix Version/s: 2.8.0, 2.7.3, 3.0.0-alpha1
• Component/s: documentation, trash
• Labels: docuentation newbie suggestions trash
• Target Version/s: 2.8.0
• Assignee: Weiwei Yang
• Reporter: Weiwei Yang
• Created: 02/Sep/15 06:28
• Updated: 11/Jan/19 17:56
• Resolved: 16/Sep/15 03:06

Description

Usage: hadoop fs -expunge

Empty the Trash. Refer to the HDFS Architecture Guide for more information on the Trash feature.

this description is confusing. It gives user the impression that this command will empty trash, but actually it only removes old checkpoints. If user sets a pretty long value for fs.trash.interval, this command will not remove anything until checkpoints exist longer than this value.

Issue Links

• relates to: HADOOP-16140 hadoop fs expunge to add -immediate option to purge trash immediately
• relates to: HADOOP-5323 Trash documentation should describe its directory structure and configurations