01cee50e7900c38455eb7deb898d512d508883b7
[dus.git] / dus.1
1 .TH "DUS" 1 "Mar 2010" "Francois Fleuret" "User Commands"
2
3 \" This man page was written by Francois Fleuret <francois@fleuret.org>
4 \" and is distributed under a Creative Commons Attribution-Share Alike
5 \" 3.0 License.
6
7 .SH "NAME"
8
9 dus \- A simple command line utility for size-sorting files
10
11 .SH "SYNOPSIS"
12
13 \fBdus\fP [OPTION]... [FILE]...
14
15 .SH "DESCRIPTION"
16
17 \fBdus\fP is a command line utility to sort files and directories
18 according to their size. It computes the said size by summing
19 recursively exact file sizes through directories.
20
21 .SH "OPTIONS"
22 .TP
23 \fB-h, --help\fR
24 display help and exit
25 .TP
26 \fB-d, --ignore-dots\fR
27 ignore files and directories whose name starts with a dot
28 .TP
29 \fB-f, --fancy\fR
30 display floating point size with K, M and G units
31 .TP
32 \fB-r, --reverse-order\fR
33 reverse the sorting order (big to small instead of small to big)
34 .TP
35 \fB-t, --show-top\fR
36 show the top of the list instead of the bottom
37 .TP
38 \fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
39 force the number of columns, -1 means no limit (it is by default no
40 limits if the stdout is not a tty and the tty width otherwise)
41 .TP
42 \fB-l \fI<lines>\fR, \fB--nb-lines \fI<lines>\fR
43 same as \fB-c\fR but for the number of lines
44 .TP
45 \fB-m \fI<size min>\fR, \fB--min-size \fI<size min>\fR
46 restrict the printing of files and directories to these of size bigger
47 than a lower bound
48
49 .SH "BUGS"
50
51 None known, probably many though.
52
53 .SH "AUTHOR"
54
55 Written by Francois Fleuret <francois@fleuret.org> and distributed
56 under the terms of the GNU General Public License version 3 as
57 published by the Free Software Foundation. This is free software: you
58 are free to change and redistribute it. There is NO WARRANTY, to the
59 extent permitted by law.