trash - Man Page

Command line trash utility.

Examples (TL;DR)

Send a file to the trash: trash path/to/file
List all files in the trash: trash-list
Interactively restore a file from the trash: trash-restore
Empty the trash: trash-empty
Permanently delete all files in the trash which are older than 10 days: trash-empty 10
Remove all files in the trash, which match a specific blob pattern: trash-rm "*.o"
Remove all files with a specific original location: trash-rm /path/to/file_or_directory

Synopsis

trash [OPTION] ... [Arguments] ... trash-put [OPTION] ... [Arguments] ...

Trash-cli package provides a command line interface trashcan utility compliant with the FreeDesktop.org Trash Specification. It remembers the name, original path, deletion date, and permissions of each trashed file.

Files trashed from the home partition will be in either $XDG_DATA_HOME/Trash or ~/.local/share/Trash/ (if $XDG_DATA_HOME is not defined or empty).

Files trashed from other partitions will be in one of the two places:

- $top_dir/.Trash/$uid
- $top_dir/.Trash-$uid

Where:
- $top_dir is the mount point of the volume containing the file to be removed
- $uid is the numeric ID of the deleting user

The first option $top_dir/.Trash/$uid works only when .Trash dir has the sticky bit set. The second option is used when the first is not viable.

Arguments

Names of files or directories to move to the trash can.

Options

-f: Silently ignore any files or directories that do not exist. Do not print error messages, and do not return a nonzero status to the caller, because of any such nonexistent arguments.
-h, --help: Show help message and exit.
--trash-dir=TRASHDIR: Use TRASHDIR as the trash folder.
-v, --verbose: Explain what is being done.
--version: Show the program's version number and exit.

Examples

$ trash-put foo   # trashes foo

Bugs

Please, report bugs to https://github.com/andreafrancia/trash-cli/issues

If You Want Say Thanks

Tweet (to @andreafrancia or #trash-cli) or donate 1, 2 or 5 euros using paypal: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=93L6PYT4WBN5A

Credits

Trash was written by Andrea Francia <andrea@andreafrancia.it>. The original version of trash-empty was contributed by Einar Orn Olason <eoo@hi.is>. The first version of manual pages was written by Steve Stalcup <vorian@ubuntu.com> and was modified by Massimo Cavalleri <submax@tiscalinet.it>.

Referenced By

trash-empty(1), trash-list(1), trash-restore(1), trash-rm(1).

The man page trash-put(1) is an alias of trash(1).