dus.1

   1 .TH "DUS" "1.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 lists files and directories according to their size. It
  18 computes the said sizes by summing recursively exact file sizes
  19 through directories. If a directory has its name appended with '/', it
  20 is not listed, but the elements it contains are. If no files or
  21 directories are provided as arguments, the current directory is used
  22 as default.
  23
  24 .SH "OPTIONS"
  25 .TP
  26 \fB-h\fR, \fB--help\fR
  27 print the help and exit
  28 .TP
  29 \fB-v\fR, \fB--version\fR
  30 print the version number and exit
  31 .TP
  32 \fB-d\fR, \fB--ignore-dots\fR
  33 ignore files and directories whose name starts with a dot
  34 .TP
  35 \fB-f\fR, \fB--fancy\fR
  36 display floating point size with K, M and G units
  37 .TP
  38 \fB-r\fR, \fB--reverse-order\fR
  39 reverse the sorting order (big to small instead of small to big)
  40 .TP
  41 \fB-t\fR, \fB--show-top\fR
  42 show the top of the list instead of the bottom
  43 .TP
  44 \fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
  45 force the number of columns, -1 means no limit (it is by default no
  46 limits if the stdout is not a tty and the tty width otherwise)
  47 .TP
  48 \fB-l \fI<lines>\fR, \fB--nb-lines \fI<lines>\fR
  49 same as \fB-c\fR but for the number of lines
  50 .TP
  51 \fB-m \fI<size min>\fR, \fB--min-size \fI<size min>\fR
  52 restrict the printing of files and directories to these of size bigger
  53 than a lower bound. The size can be specified using the G, M, K, and B
  54 units
  55
  56 .SH "EXAMPLE"
  57
  58 .B dus -m 1M -rt ~/private/
  59
  60 .fi
  61 List the largest files and directories present in ~/private/, of sizes
  62 greater than 1024kb, sorted in decreasing order.
  63
  64 .SH "BUGS"
  65
  66 None known, probably many though.
  67
  68 .SH "AUTHOR"
  69
  70 Written by Francois Fleuret <francois@fleuret.org> and distributed
  71 under the terms of the GNU General Public License version 3 as
  72 published by the Free Software Foundation. This is free software: you
  73 are free to change and redistribute it. There is NO WARRANTY, to the
  74 extent permitted by law.