dus.1

   1 .TH "DUS" "1.3" "Apr 2011" "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-i\fR, \fB--ignore-protected\fR
  36 do not exit when trying to access files and directories for which we do not have permission
  37 .TP
  38 \fB-f\fR, \fB--fancy\fR
  39 display floating point size with K, M and G units
  40 .TP
  41 \fB-r\fR, \fB--reverse-order\fR
  42 reverse the sorting order (big to small instead of small to big)
  43 .TP
  44 \fB-t\fR, \fB--show-top\fR
  45 show the top of the list instead of the bottom
  46 .TP
  47 \fB-c \fI<cols>\fR, \fB--nb-columns \fI<cols>\fR
  48 force the number of columns, -1 means no limit (it is by default no
  49 limits if the stdout is not a tty and the tty width otherwise)
  50 .TP
  51 \fB-l \fI<lines>\fR, \fB--nb-lines \fI<lines>\fR
  52 same as \fB-c\fR but for the number of lines
  53 .TP
  54 \fB-m \fI<size min>\fR, \fB--min-size \fI<size min>\fR
  55 restrict the printing of files and directories to these of size bigger
  56 than a lower bound. The size can be specified using the G, M, K, and B
  57 units
  58
  59 .SH "EXAMPLE"
  60
  61 .B dus -m 1M -rt ~/private/
  62
  63 .fi
  64 List the largest files and directories present in ~/private/, of sizes
  65 greater than 1024kb, sorted in decreasing order.
  66
  67 .SH "BUGS"
  68
  69 None known, probably many though.
  70
  71 .SH "AUTHOR"
  72
  73 Written by Francois Fleuret <francois@fleuret.org> and distributed
  74 under the terms of the GNU General Public License version 3 as
  75 published by the Free Software Foundation. This is free software: you
  76 are free to change and redistribute it. There is NO WARRANTY, to the
  77 extent permitted by law.