man/du.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH DU "1" "March 2007" "GNU coreutils 6.9" "User Commands"
   3 .SH NAME
   4 du \- estimate file space usage
   5 .SH SYNOPSIS
   6 .B du
   7 [\fIOPTION\fR]... [\fIFILE\fR]...
   8 .br
   9 .B du
  10 [\fIOPTION\fR]... \fI--files0-from=F\fR
  11 .SH DESCRIPTION
  12 .\" Add any additional description here
  13 .PP
  14 Summarize disk usage of each FILE, recursively for directories.
  15 .PP
  16 Mandatory arguments to long options are mandatory for short options too.
  17 .TP
  18 \fB\-a\fR, \fB\-\-all\fR
  19 write counts for all files, not just directories
  20 .TP
  21 \fB\-\-apparent\-size\fR
  22 print apparent sizes, rather than disk usage; although
  23 the apparent size is usually smaller, it may be
  24 larger due to holes in (`sparse') files, internal
  25 fragmentation, indirect blocks, and the like
  26 .TP
  27 \fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR
  28 use SIZE\-byte blocks
  29 .TP
  30 \fB\-b\fR, \fB\-\-bytes\fR
  31 equivalent to `\-\-apparent\-size \fB\-\-block\-size\fR=\fI1\fR'
  32 .TP
  33 \fB\-c\fR, \fB\-\-total\fR
  34 produce a grand total
  35 .TP
  36 \fB\-D\fR, \fB\-\-dereference\-args\fR
  37 dereference FILEs that are symbolic links
  38 .TP
  39 \fB\-\-files0\-from\fR=\fIF\fR
  40 summarize disk usage of the NUL\-terminated file
  41 names specified in file F
  42 .TP
  43 \fB\-H\fR
  44 like \fB\-\-si\fR, but also evokes a warning; will soon
  45 change to be equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
  46 .TP
  47 \fB\-h\fR, \fB\-\-human\-readable\fR
  48 print sizes in human readable format (e.g., 1K 234M 2G)
  49 .TP
  50 \fB\-\-si\fR
  51 like \fB\-h\fR, but use powers of 1000 not 1024
  52 .TP
  53 \fB\-k\fR
  54 like \fB\-\-block\-size\fR=\fI1K\fR
  55 .TP
  56 \fB\-l\fR, \fB\-\-count\-links\fR
  57 count sizes many times if hard linked
  58 .TP
  59 \fB\-m\fR
  60 like \fB\-\-block\-size\fR=\fI1M\fR
  61 .TP
  62 \fB\-L\fR, \fB\-\-dereference\fR
  63 dereference all symbolic links
  64 .TP
  65 \fB\-P\fR, \fB\-\-no\-dereference\fR
  66 don't follow any symbolic links (this is the default)
  67 .TP
  68 \fB\-0\fR, \fB\-\-null\fR
  69 end each output line with 0 byte rather than newline
  70 .TP
  71 \fB\-S\fR, \fB\-\-separate\-dirs\fR
  72 do not include size of subdirectories
  73 .TP
  74 \fB\-s\fR, \fB\-\-summarize\fR
  75 display only a total for each argument
  76 .TP
  77 \fB\-x\fR, \fB\-\-one\-file\-system\fR
  78 skip directories on different file systems
  79 .TP
  80 \fB\-X\fR FILE, \fB\-\-exclude\-from\fR=\fIFILE\fR
  81 Exclude files that match any pattern in FILE.
  82 .TP
  83 \fB\-\-exclude\fR=\fIPATTERN\fR
  84 Exclude files that match PATTERN.
  85 .TP
  86 \fB\-\-max\-depth\fR=\fIN\fR
  87 print the total for a directory (or file, with \fB\-\-all\fR)
  88 only if it is N or fewer levels below the command
  89 line argument;  \fB\-\-max\-depth\fR=\fI0\fR is the same as
  90 \fB\-\-summarize\fR
  91 .TP
  92 \fB\-\-time\fR
  93 show time of the last modification of any file in the
  94 directory, or any of its subdirectories
  95 .TP
  96 \fB\-\-time\fR=\fIWORD\fR
  97 show time as WORD instead of modification time:
  98 atime, access, use, ctime or status
  99 .TP
 100 \fB\-\-time\-style\fR=\fISTYLE\fR
 101 show times using style STYLE:
 102 full\-iso, long\-iso, iso, +FORMAT
 103 FORMAT is interpreted like `date'
 104 .TP
 105 \fB\-\-help\fR
 106 display this help and exit
 107 .TP
 108 \fB\-\-version\fR
 109 output version information and exit
 110 .PP
 111 SIZE may be (or may be an integer optionally followed by) one of following:
 112 kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
 113 .SH PATTERNS
 114 PATTERN is a shell pattern (not a regular expression).  The pattern
 115 .BR ?
 116 matches any one character, whereas
 117 .BR *
 118 matches any string (composed of zero, one or multiple characters).  For
 119 example,
 120 .BR *.o
 121 will match any files whose names end in
 122 .BR .o .
 123 Therefore, the command
 124 .IP
 125 .B du --exclude='*.o'
 126 .PP
 127 will skip all files and subdirectories ending in
 128 .BR .o
 129 (including the file
 130 .BR .o
 131 itself).
 132 .SH AUTHOR
 133 Written by Torbjorn Granlund, David MacKenzie, Paul Eggert, and Jim Meyering.
 134 .SH "REPORTING BUGS"
 135 Report bugs to <bug\-coreutils@gnu.org>.
 136 .SH COPYRIGHT
 137 Copyright \(co 2007 Free Software Foundation, Inc.
 138 .br
 139 This is free software.  You may redistribute copies of it under the terms of
 140 the GNU General Public License <http://www.gnu.org/licenses/gpl.html>.
 141 There is NO WARRANTY, to the extent permitted by law.
 142 .SH "SEE ALSO"
 143 The full documentation for
 144 .B du
 145 is maintained as a Texinfo manual.  If the
 146 .B info
 147 and
 148 .B du
 149 programs are properly installed at your site, the command
 150 .IP
 151 .B info du
 152 .PP
 153 should give you access to the complete manual.