116 lines
2.8 KiB
Groff
116 lines
2.8 KiB
Groff
.\" Manpage for bin.
|
|
.\" Contact bruce@bruce-hill.com to correct errors or typos.
|
|
.TH man 8 "6 April 2020" "0.5" "bin manual page"
|
|
.SH NAME
|
|
bin \- A shell program for FreeDesktop.org-compliant trash bin management.
|
|
.SH SYNOPSIS
|
|
.B bin
|
|
[\fI-h\fR|\fI--help\fR]
|
|
[\fI-V\fR|\fI--version\fR]
|
|
[\fI-v\fR|\fI--verbose\fR]
|
|
[\fI-i\fR|\fI--interactive\fR]
|
|
[\fI-f\fR|\fI--force\fR]
|
|
[\fI-r\fR|\fI-R\fR|\fI--recursive\fR]
|
|
[
|
|
[\fI-u\fR|\fI--untrash\fR]
|
|
|
|
|
[\fI-e\fR|\fI--empty\fR]
|
|
|
|
|
[\fI-E\fR|\fI--empty-all\fR]
|
|
|
|
|
[\fI-l\fR|\fI--list\fR]
|
|
]
|
|
[[\fI--\fR] \fIfiles...\fR]
|
|
|
|
.SH DESCRIPTION
|
|
\fBbin\fR is a small shell program that helps you send files to a trash bin
|
|
directory (specified by the FreeDesktop.org Trash Specification), restore
|
|
files from there, and empty the trash directory.
|
|
.SH OPTIONS
|
|
.B \-h
|
|
.B \--help
|
|
Print the command line usage and exit.
|
|
|
|
.B \-V
|
|
.B \--version
|
|
Print \fBbin\fR's version and exit.
|
|
|
|
.B \-v
|
|
.B \--verbose
|
|
Print more logging output.
|
|
|
|
.B \-i
|
|
.B \--interactive
|
|
Always ask for confirmation.
|
|
|
|
.B \-f
|
|
.B \--force
|
|
Never ask for confirmation.
|
|
|
|
.B \-r
|
|
.B \-R
|
|
.B \--recursive
|
|
Ignored. (For compatibility with \fBrm -r\fR)
|
|
|
|
.B \-u
|
|
.B \--untrash
|
|
Restore the most recently deleted file(s) matching the given path(s). (see:
|
|
\fBNOTE ON DELETION TIMES\fR)
|
|
|
|
.B \-e
|
|
.B \--empty
|
|
Permanently erase the most recently deleted file(s) matching the given path(s)
|
|
from the trash. (see: \fBNOTE ON DELETION TIMES\fR)
|
|
|
|
.B \-E
|
|
.B \--empty-all
|
|
Empty all files from the trash. Since there is a per-mount-point trash directory,
|
|
any additional path arguments will be used to empty trash from specified mount
|
|
points. Default is the current directory.
|
|
|
|
.B \-l
|
|
.B \--list
|
|
List all files in the trash. The format is: \fB<Trash File>\fR, \fB<Date
|
|
Deleted>\fR, \fB<Original Path>\fR. Fields are separated by the environment
|
|
variable \fIFS\fR (default: tab) and records are separated by the environment
|
|
variable \fIRS\fR (default: newline). Since there is a per-mount-point trash
|
|
directory, any additional path arguments will be used to empty trash from
|
|
specified mount points. Default is the current directory.
|
|
|
|
.I files...
|
|
If none of \fB-u\fR, \fB-e\fR, \fB-E\fR, \fB-l\fR are specified, then delete
|
|
the given files. Otherwise, apply the appropriate action to them.
|
|
|
|
.SH NOTE ON DELETION TIMES
|
|
\fBbin\fR only records the deltion time with 1-second precision, so if
|
|
multiple files were deleted in the same second, the behavior is undefined.
|
|
|
|
.SH EXAMPLES
|
|
.TP
|
|
.B
|
|
bin foo.txt baz.txt
|
|
Send \fIfoo.txt\fR and \fIbaz.txt\fR to the trash bin.
|
|
|
|
.TP
|
|
.B
|
|
bin foo.txt && bin -u foo.txt
|
|
Trash a file and then untrash it.
|
|
|
|
.TP
|
|
.B
|
|
bin -E
|
|
Empty the trash.
|
|
|
|
.TP
|
|
.B
|
|
bin -E /mnt
|
|
Empty the trash on the filesystem mounted at /mnt
|
|
|
|
.TP
|
|
.B
|
|
bin -E $(awk '{print $2}' /proc/mounts)
|
|
Empty all trash directories on all filesystems on the system.
|
|
|
|
.SH AUTHOR
|
|
Bruce Hill (bruce@bruce-hill.com)
|