1
.\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.35.
2
.TH DU "1" "October 2012" "GNU coreutils 8.20" "User Commands"
4
du \- estimate file space usage
7
[\fIOPTION\fR]... [\fIFILE\fR]...
10
[\fIOPTION\fR]... \fI--files0-from=F\fR
12
.\" Add any additional description here
14
Summarize disk usage of each FILE, recursively for directories.
16
Mandatory arguments to long options are mandatory for short options too.
18
\fB\-a\fR, \fB\-\-all\fR
19
write counts for all files, not just directories
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
27
\fB\-B\fR, \fB\-\-block\-size\fR=\fISIZE\fR
28
scale sizes by SIZE before printing them. E.g.,
29
\&'\-BM' prints sizes in units of 1,048,576 bytes.
30
See SIZE format below.
32
\fB\-b\fR, \fB\-\-bytes\fR
33
equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI1\fR'
35
\fB\-c\fR, \fB\-\-total\fR
38
\fB\-D\fR, \fB\-\-dereference\-args\fR
39
dereference only symlinks that are listed on the
42
\fB\-\-files0\-from\fR=\fIF\fR
43
summarize disk usage of the NUL\-terminated file
44
names specified in file F;
45
If F is \- then read names from standard input
48
equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
50
\fB\-h\fR, \fB\-\-human\-readable\fR
51
print sizes in human readable format (e.g., 1K 234M 2G)
54
like \fB\-h\fR, but use powers of 1000 not 1024
57
like \fB\-\-block\-size\fR=\fI1K\fR
59
\fB\-l\fR, \fB\-\-count\-links\fR
60
count sizes many times if hard linked
63
like \fB\-\-block\-size\fR=\fI1M\fR
65
\fB\-L\fR, \fB\-\-dereference\fR
66
dereference all symbolic links
68
\fB\-P\fR, \fB\-\-no\-dereference\fR
69
don't follow any symbolic links (this is the default)
71
\fB\-0\fR, \fB\-\-null\fR
72
end each output line with 0 byte rather than newline
74
\fB\-S\fR, \fB\-\-separate\-dirs\fR
75
do not include size of subdirectories
77
\fB\-s\fR, \fB\-\-summarize\fR
78
display only a total for each argument
80
\fB\-x\fR, \fB\-\-one\-file\-system\fR
81
skip directories on different file systems
83
\fB\-X\fR, \fB\-\-exclude\-from\fR=\fIFILE\fR
84
exclude files that match any pattern in FILE
86
\fB\-\-exclude\fR=\fIPATTERN\fR
87
exclude files that match PATTERN
89
\fB\-d\fR, \fB\-\-max\-depth\fR=\fIN\fR
90
print the total for a directory (or file, with \fB\-\-all\fR)
91
only if it is N or fewer levels below the command
92
line argument; \fB\-\-max\-depth\fR=\fI0\fR is the same as
96
show time of the last modification of any file in the
97
directory, or any of its subdirectories
99
\fB\-\-time\fR=\fIWORD\fR
100
show time as WORD instead of modification time:
101
atime, access, use, ctime or status
103
\fB\-\-time\-style\fR=\fISTYLE\fR
104
show times using style STYLE:
105
full\-iso, long\-iso, iso, +FORMAT
106
FORMAT is interpreted like 'date'
109
display this help and exit
112
output version information and exit
114
Display values are in units of the first available SIZE from \fB\-\-block\-size\fR,
115
and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables.
116
Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).
118
SIZE is an integer and optional unit (example: 10M is 10*1024*1024). Units
119
are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
121
PATTERN is a shell pattern (not a regular expression). The pattern
123
matches any one character, whereas
125
matches any string (composed of zero, one or multiple characters). For
128
will match any files whose names end in
130
Therefore, the command
132
.B du --exclude=\(aq*.o\(aq
134
will skip all files and subdirectories ending in
140
Written by Torbjorn Granlund, David MacKenzie, Paul Eggert,
143
Report du bugs to bug\-coreutils@gnu.org
145
GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
147
General help using GNU software: <http://www.gnu.org/gethelp/>
149
Report du translation bugs to <http://translationproject.org/team/>
151
Copyright \(co 2012 Free Software Foundation, Inc.
152
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
154
This is free software: you are free to change and redistribute it.
155
There is NO WARRANTY, to the extent permitted by law.
157
The full documentation for
159
is maintained as a Texinfo manual. If the
163
programs are properly installed at your site, the command
165
.B info coreutils \(aqdu invocation\(aq
167
should give you access to the complete manual.