.TH "DUS" "1.3" "Apr 2011" "Francois Fleuret" "User Commands"

\" This man page was written by Francois Fleuret <francois@fleuret.org>
\" and is distributed under a Creative Commons Attribution-Share Alike
\" 3.0 License.

.SH "NAME"

dus \- A simple command line utility for size-sorting files

.SH "SYNOPSIS"

\fBdus\fP [OPTION]... [FILE]...

.SH "DESCRIPTION"

\fBdus\fP lists files and directories according to their size. It
computes the said sizes by summing recursively exact file sizes
through directories. If a directory has its name appended with '/', it
is not listed, but the elements it contains are. If no files or
directories are provided as arguments, the current directory is used
as default.

.SH "OPTIONS"
.TP
\fB-h\fR, \fB--help\fR
print the help and exit
.TP
\fB-v\fR, \fB--version\fR
print the version number and exit
.TP
\fB-d\fR, \fB--ignore-dots\fR
ignore files and directories whose name starts with a dot
.TP
\fB-i\fR, \fB--ignore-protected\fR
do not exit when trying to access files and directories for which we do not have permission
.TP
\fB-f\fR, \fB--fancy\fR
display floating point size with K, M and G units
.TP
\fB-r\fR, \fB--reverse-order\fR
reverse the sorting order (big to small instead of small to big)
.TP
\fB-t\fR, \fB--show-top\fR
show the top of the list instead of the bottom
.TP
\fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
force the number of columns, -1 means no limit (it is by default no
limits if the stdout is not a tty and the tty width otherwise)
.TP
\fB-l \fI<lines>\fR, \fB--nb-lines \fI<lines>\fR
same as \fB-c\fR but for the number of lines
.TP
\fB-m \fI<size min>\fR, \fB--min-size \fI<size min>\fR
restrict the printing of files and directories to these of size bigger
than a lower bound. The size can be specified using the G, M, K, and B
units

.SH "EXAMPLE"

.B dus -m 1M -rt ~/private/

.fi
List the largest files and directories present in ~/private/, of sizes
greater than 1024kb, sorted in decreasing order.

.SH "BUGS"

None known, probably many though.

.SH "AUTHOR"

Written by Francois Fleuret <francois@fleuret.org> and distributed
under the terms of the GNU General Public License version 3 as
published by the Free Software Foundation. This is free software: you
are free to change and redistribute it. There is NO WARRANTY, to the
extent permitted by law.