f938ac455591712eab186b77faf9d3a2d473bf43
[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\fR
24 display help and exit
25 .TP
26 \fB-d\fR
27 ignore files and directories whose name starts with a dot
28 .TP
29 \fB-f\fR
30 display floating point size with K, M and G units
31 .TP
32 \fB-r\fR
33 reverse the sorting order (big to small instead of small to big)
34 .TP
35 \fB-t\fR
36 show the top of the list instead of the bottom
37 .TP
38 \fB-c \fI<cols>\fR
39 impose the number of columns, -1 means no limit (it
40 is by default no limits if the stdout is not a tty and the tty width
41 otherwise)
42 .TP
43 \fB-l \fI<lines>\fR
44 same as \fB-c\fR but for the number of lines
45 .TP
46 \fB-m \fI<size min>\fR
47 restrict the printing of files and directories to these of size bigger
48 than a lower bound
49
50 .SH "BUGS"
51
52 None known, probably many though.
53
54 .SH "AUTHOR"
55
56 Written by Francois Fleuret <francois@fleuret.org> and distributed
57 under the terms of the GNU General Public License version 3 as
58 published by the Free Software Foundation. This is free software: you
59 are free to change and redistribute it. There is NO WARRANTY, to the
60 extent permitted by law.