original/man1/du.1

   1 .\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.35.
   2 .TH DU "1" "April 2010" "GNU coreutils 8.5" "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 only symlinks that are listed on the
  38 command line
  39 .TP
  40 \fB\-\-files0\-from\fR=\fIF\fR
  41 summarize disk usage of the NUL\-terminated file
  42 names specified in file F;
  43 If F is \- then read names from standard input
  44 .TP
  45 \fB\-H\fR
  46 equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
  47 .TP
  48 \fB\-h\fR, \fB\-\-human\-readable\fR
  49 print sizes in human readable format (e.g., 1K 234M 2G)
  50 .TP
  51 \fB\-\-si\fR
  52 like \fB\-h\fR, but use powers of 1000 not 1024
  53 .TP
  54 \fB\-k\fR
  55 like \fB\-\-block\-size\fR=\fI1K\fR
  56 .TP
  57 \fB\-l\fR, \fB\-\-count\-links\fR
  58 count sizes many times if hard linked
  59 .TP
  60 \fB\-m\fR
  61 like \fB\-\-block\-size\fR=\fI1M\fR
  62 .TP
  63 \fB\-L\fR, \fB\-\-dereference\fR
  64 dereference all symbolic links
  65 .TP
  66 \fB\-P\fR, \fB\-\-no\-dereference\fR
  67 don't follow any symbolic links (this is the default)
  68 .TP
  69 \fB\-0\fR, \fB\-\-null\fR
  70 end each output line with 0 byte rather than newline
  71 .TP
  72 \fB\-S\fR, \fB\-\-separate\-dirs\fR
  73 do not include size of subdirectories
  74 .TP
  75 \fB\-s\fR, \fB\-\-summarize\fR
  76 display only a total for each argument
  77 .TP
  78 \fB\-x\fR, \fB\-\-one\-file\-system\fR
  79 skip directories on different file systems
  80 .TP
  81 \fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
  82 exclude files that match any pattern in FILE
  83 .TP
  84 \fB\-\-exclude\fR=\fIPATTERN\fR
  85 exclude files that match PATTERN
  86 .TP
  87 \fB\-\-max\-depth\fR=\fIN\fR
  88 print the total for a directory (or file, with \fB\-\-all\fR)
  89 only if it is N or fewer levels below the command
  90 line argument;  \fB\-\-max\-depth\fR=\fI0\fR is the same as
  91 \fB\-\-summarize\fR
  92 .TP
  93 \fB\-\-time\fR
  94 show time of the last modification of any file in the
  95 directory, or any of its subdirectories
  96 .TP
  97 \fB\-\-time\fR=\fIWORD\fR
  98 show time as WORD instead of modification time:
  99 atime, access, use, ctime or status
 100 .TP
 101 \fB\-\-time\-style\fR=\fISTYLE\fR
 102 show times using style STYLE:
 103 full\-iso, long\-iso, iso, +FORMAT
 104 FORMAT is interpreted like `date'
 105 .TP
 106 \fB\-\-help\fR
 107 display this help and exit
 108 .TP
 109 \fB\-\-version\fR
 110 output version information and exit
 111 .PP
 112 Display values are in units of the first available SIZE from \fB\-\-block\-size\fR,
 113 and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables.
 114 Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).
 115 .PP
 116 SIZE may be (or may be an integer optionally followed by) one of following:
 117 KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T, P, E, Z, Y.
 118 .SH PATTERNS
 119 PATTERN is a shell pattern (not a regular expression).  The pattern
 120 .BR ?
 121 matches any one character, whereas
 122 .BR *
 123 matches any string (composed of zero, one or multiple characters).  For
 124 example,
 125 .BR *.o
 126 will match any files whose names end in
 127 .BR .o .
 128 Therefore, the command
 129 .IP
 130 .B du --exclude=\(aq*.o\(aq
 131 .PP
 132 will skip all files and subdirectories ending in
 133 .BR .o
 134 (including the file
 135 .BR .o
 136 itself).
 137 .SH AUTHOR
 138 Written by Torbjorn Granlund, David MacKenzie, Paul Eggert,
 139 and Jim Meyering.
 140 .SH "REPORTING BUGS"
 141 Report du bugs to bug\-coreutils@gnu.org
 142 .br
 143 GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
 144 .br
 145 General help using GNU software: <http://www.gnu.org/gethelp/>
 146 .br
 147 Report du translation bugs to <http://translationproject.org/team/>
 148 .SH COPYRIGHT
 149 Copyright \(co 2010 Free Software Foundation, Inc.
 150 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 151 .br
 152 This is free software: you are free to change and redistribute it.
 153 There is NO WARRANTY, to the extent permitted by law.
 154 .SH "SEE ALSO"
 155 The full documentation for
 156 .B du
 157 is maintained as a Texinfo manual.  If the
 158 .B info
 159 and
 160 .B du
 161 programs are properly installed at your site, the command
 162 .IP
 163 .B info coreutils \(aqdu invocation\(aq
 164 .PP
 165 should give you access to the complete manual.