raw/man1/du.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.022.
   2 .TH DU "1" "October 2003" "du (coreutils) 5.0" FSF
   3 .SH NAME
   4 du \- estimate file space usage
   5 .SH SYNOPSIS
   6 .B du
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .SH DESCRIPTION
   9 .\" Add any additional description here
  10 .PP
  11 Summarize disk usage of each FILE, recursively for directories.
  12 .PP
  13 Mandatory arguments to long options are mandatory for short options too.
  14 .TP
  15 \fB\-a\fR, \fB\-\-all\fR
  16 write counts for all files, not just directories
  17 .TP
  18 \fB\-\-apparent\-size\fR
  19 print apparent sizes, rather than disk usage; although
  20 the apparent size is usually smaller, it may be
  21 larger due to holes in (`sparse') files, internal
  22 fragmentation, indirect blocks, and the like
  23 .HP
  24 \fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR use SIZE-byte blocks
  25 .TP
  26 \fB\-b\fR, \fB\-\-bytes\fR
  27 equivalent to `--apparent-size \fB\-\-block\-size\fR=\fI1\fR'
  28 .TP
  29 \fB\-c\fR, \fB\-\-total\fR
  30 produce a grand total
  31 .TP
  32 \fB\-D\fR, \fB\-\-dereference\-args\fR
  33 dereference FILEs that are symbolic links
  34 .TP
  35 \fB\-h\fR, \fB\-\-human\-readable\fR
  36 print sizes in human readable format (e.g., 1K 234M 2G)
  37 .TP
  38 \fB\-H\fR, \fB\-\-si\fR
  39 likewise, but use powers of 1000 not 1024
  40 .TP
  41 \fB\-k\fR
  42 like \fB\-\-block\-size\fR=\fI1K\fR
  43 .TP
  44 \fB\-l\fR, \fB\-\-count\-links\fR
  45 count sizes many times if hard linked
  46 .TP
  47 \fB\-L\fR, \fB\-\-dereference\fR
  48 dereference all symbolic links
  49 .TP
  50 \fB\-S\fR, \fB\-\-separate\-dirs\fR
  51 do not include size of subdirectories
  52 .TP
  53 \fB\-s\fR, \fB\-\-summarize\fR
  54 display only a total for each argument
  55 .TP
  56 \fB\-x\fR, \fB\-\-one\-file\-system\fR
  57 skip directories on different filesystems
  58 .TP
  59 \fB\-X\fR FILE, \fB\-\-exclude\-from\fR=\fIFILE\fR
  60 Exclude files that match any pattern in FILE.
  61 .HP
  62 \fB\-\-exclude\fR=\fIPATTERN\fR Exclude files that match PATTERN.
  63 .TP
  64 \fB\-\-max\-depth\fR=\fIN\fR
  65 print the total for a directory (or file, with \fB\-\-all\fR)
  66 only if it is N or fewer levels below the command
  67 line argument;  \fB\-\-max\-depth\fR=\fI0\fR is the same as
  68 \fB\-\-summarize\fR
  69 .TP
  70 \fB\-\-help\fR
  71 display this help and exit
  72 .TP
  73 \fB\-\-version\fR
  74 output version information and exit
  75 .PP
  76 SIZE may be (or may be an integer optionally followed by) one of following:
  77 kB 1000, K 1024, MB 1,000,000, M 1,048,576, and so on for G, T, P, E, Z, Y.
  78 .SH PATTERNS
  79 PATTERN is a shell pattern (not a regular expression).  The pattern
  80 .BR ?
  81 matches any one character, whereas
  82 .BR *
  83 matches any string (composed of zero, one or multiple characters).  For
  84 example,
  85 .BR *.o
  86 will match any files whose names end in
  87 .BR .o .
  88 Therefore, the command
  89 .IP
  90 .B du --exclude='*.o'
  91 .PP
  92 will skip all files and subdirectories ending in
  93 .BR .o
  94 (including the file
  95 .BR .o
  96 itself).
  97 .SH AUTHOR
  98 Written by Torbjorn Granlund, David MacKenzie, Larry McVoy, Paul Eggert, and Jim Meyering.
  99 .SH "REPORTING BUGS"
 100 Report bugs to <bug-coreutils@gnu.org>.
 101 .SH COPYRIGHT
 102 Copyright \(co 2003 Free Software Foundation, Inc.
 103 .br
 104 This is free software; see the source for copying conditions.  There is NO
 105 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 106 .SH "SEE ALSO"
 107 The full documentation for
 108 .B du
 109 is maintained as a Texinfo manual.  If the
 110 .B info
 111 and
 112 .B du
 113 programs are properly installed at your site, the command
 114 .IP
 115 .B info du
 116 .PP
 117 should give you access to the complete manual.