rmd 0.4.0

An improved rm implementation able to remove duplicate files
Documentation

rmd

Build Status crates.io License: MIT

An improved rm implementation able to remove duplicate files

Description

rmd is an rm reimplementation made in pure Rust. It is able to remove files and directories as usual but it also able to remove duplicate file in given directories recursively.

Duplicate file are found by comparing SHA256 hashes. When a file has an hash that has already been found it is removed immediately.

Installation

This tool can be easly installed from sources:

cargo install rmd

Usage

It works in an almost compatible way with the standard rm. To get a full help run:

rmd --help

But the most common scenarios includes:

  • remove files, for example:
rmd FILE_A FILE_B 
  • remove a directory, for example:
rmd -rf DIR_A

Additional Features

Remove Duplicates

  • remove duplicates files in the current directory, and all sub directoris:
rmd -d

or remove duplicates files in a specified directory:

rmd -d /PATH/TO/DIRECTORY

Remove by Last Access

This functionality allows to remove file older or newer then a given time-specification.

Remove File older then time-spec

rmd --older <time-spec> [directory...]

Remove File newer then time-spec

rmd --newer <time-spec> [directory...]

rmd checks if the last access is before (so the file is older) or after (so the file is newer) then the time described by the time-specification. time-specification describes a relative amount of time (in seconds) in the past from the moment when the program is run.

time-specification format

[N+T]+

Where:

  • N is a number (1-9)
  • T is a time descriptor
  • + means one or more

Time Descriptor Table

Short Format Long Format Meaning Value
s second second 1 second
m minute minute 60 seconds
h hour hour 60 minutes
d day day 24 hours
w week week 7 days
M month month 30 days
y year year 365 days
Examples
rmd --older 2y4M5d

will remove in the current directory, and recursivelly in all sub directories, file with a last access time equal or before 2 year, 4 month and 5 days in the past from the time when the program is run.

rmd --newer '4h+30m'

will remove in the current directory, and recursivelly in all sub directories, file with a last access time equal or after 4 hour and 30 minutes in the past from the time when the program is run.

rmd --older '1M 15d' /home/user/temp-store

will remove in /home/user/temp-store and recursivelly in all sub directories, file with a last access time equal or before 1 mounth and 15 days in the past from the time when the program is run.

rmd --newer 30s /home/user/wrong-downloads

will remove in /home/user/wrong-downloads and recursivelly in all sub directories, file with a last access time equal or after 30 seconds in the past from the time when the program is run.

Remove by Size

This functionality allows to remove file smaller or larger then a given size-specification.

Remove File smaller then size-spec

rmd --smaller <size-spec> [directory...]

Remove File larger then size-spec

rmd --larger <size-spec> [directory...]

rmd checks if the file size, in bytes. If larger mode is used rmd checks, for each file in the specified directory, and recursivelly in all sub directories, if the size is larger or equal to the size decribed in size-spec and if so rmd remove the file. Of course if smaller mode is used rmd checks for file smaller or equal to the size in size-spec.

size-specification format

[N+S]+

Where:

  • N is a number (1-9)
  • T is a size descriptor
  • + means one or more

Deciamal Size Descriptor Table

Short Format Long Format Meaning Value
b byte 1 byte
kb kilo kilobyte 1000 byte
mb mega megabyte 1000 kilobyte
gb giga gigabyte 1000 megabyte
tb tera terabyte 1000 gigabyte
pb peta petabyte 1000 terabyte

Binary Size Descriptor Table

Short Format Long Format Meaning Value
b byte 1 byte
kib kibi kibibyte 1024 byte
mib mebi mebibyte 1024 kibibyte
gib gibi gibibyte 1024 mebibyte
tib tebi tebibyte 1024 gibibyte
pib pebi pebibyte 1024 tebibyte

Decimal and Binary size descriptor can be use together

Examples
rmd --smaller '2kb,56mib'

will remove in the current directory, and recursivelly in all sub directories, file with a size smaller or equal to 56 Mebibytes and 2 Kilobytes.

rmd --larger 4gb30mb

will remove in the current directory, and recursivelly in all sub directories, file with a size larger or equal to 4 Gibabytes and 30 Megabytes.

rmd --larger '1 mebi 15 kibi' /home/user/temp-store

will remove in /home/user/temp-store and recursivelly in all sub directories, file with a size larger or equal to 1 Mebibytes and 15 Kibibytes.

rmd --smaller 30kb /home/user/useless-files

will remove in /home/user/useless-files and recursivelly in all sub directories, file with a size smaller or equal to 30 Kilobytes.

Note

  • When working in interactive mode and a remove file is a directory rmd prompts only once for the root directory
  • newer, older, recursive, smaller, larger are mutually exclusive.
  • Specification String, in both time and size remove, can contain any number of non alphanumeric characters between a number and a descriptor or between a descriptor and a number, those characters are simply treated as separators. The important thing are to NOT put sperators into numbers or into descriptors and to properly quote the specification string so it will be treated as a unique argument.