TRASHCAN(1) Linux TRASHCAN(1)
System Trashcan 1.0 System Trashcan 1.0
November 3, 1996
NAME
destroy - destroy files without keeping a trashcan copy
lt - list contents of trashcan
purge - purge trashcan contents
restore - restore files from trashcan
rm - remove files (move files to trashcan)
SYNOPSIS
destroy [-dfirvR] [--directory] [--force] [--interactive] [--verbose]
[--recursive] [--help] [--version] files
lt [--help] [--version]
purge [-fiv] [--force] [--interactive] [--verbose] [--help] [--version]
restore [-fiov] [--force] [--interactive] [--overwrite] [--help]
[--version]
rm [-dfirvR] [--directory] [--force] [--interactive] [--verbose]
[--recursive] [--help] [--version] files
DESCRIPTION
This manual page documents Trashcan for Linux. Trashcan is a full
UN*X rm replacement. Trashcan is designed to provide full system-wide
trashcan capabilities on a per user basis.
The Trashcan version of the rm command retains a copy of the deleted
files in the user's trashcan. The user can then, at a later time,
issue a restore command and recover the deleted files.
Ofcourse, a file can only be restored if it is still present in the
trashcan.
The user is expected to empty her trashcan every so often. I have NOT
programmed in any automatic trash emptying engine since such a
functionality can easily be achieved using a cron job.
The rm command is GNU rm compatible with one exception. The
--directory functionality is NOT supported as described in the GNU rm
man pages.
OPTIONS
-d, --directory
This commandline is here for compatibility. It has no effect.
-f, --force
Ignore non-existant files and never prompt the user for input.
- 1 - Formatted: November 5, 2025
TRASHCAN(1) Linux TRASHCAN(1)
System Trashcan 1.0 System Trashcan 1.0
November 3, 1996
-i, --interactive
Prompt the user before any action on a file. If the response
does not begin with a y, the file is skipped.
-o, --overwrite
This option is only applicable to the restore command. When
overwrite is specified the restore command replaces an existing
file with the trashcan copy. The default behaviour is to skip
over existing files. When used in conjunction with -f, the user
is NOT prompted before the replacement.
-v, --verbose
Shows what is being done. In particular, it prints the name of
each file and directory, and the operation being performed upon
it.
--help
Print a usage message on standard output and exit successfully.
--version
Print version information on standard output and exit
successfully.
FILES
/var/trash - System wide trashcan, also root's trashcan. ~/.trash
- Regular user's trashcan.
SEE ALSO
crontab(1), rm(1)
BUGS
The --directory should be supported. May require more extensive man
pages.
AUTHOR
Ahmed Masud <masud@trix.genie.uottawa.ca>
- 2 - Formatted: November 5, 2025
