1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.47.3.
2 .TH DU "1" "January 2016" "GNU coreutils 8.25" "User Commands"
4 du \- estimate file space usage
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
10 [\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR
12 .\" Add any additional description here
14 Summarize disk usage of the set of FILEs, recursively for directories.
16 Mandatory arguments to long options are mandatory for short options too.
18 \fB\-0\fR, \fB\-\-null\fR
19 end each output line with NUL, not newline
21 \fB\-a\fR, \fB\-\-all\fR
22 write counts for all files, not just directories
24 \fB\-\-apparent\-size\fR
25 print apparent sizes, rather than disk usage; although
26 the apparent size is usually smaller, it may be
27 larger due to holes in ('sparse') files, internal
28 fragmentation, indirect blocks, and the like
30 \fB\-B\fR, \fB\-\-block\-size\fR=\fI\,SIZE\/\fR
31 scale sizes by SIZE before printing them; e.g.,
32 \&'\-BM' prints sizes in units of 1,048,576 bytes;
35 \fB\-b\fR, \fB\-\-bytes\fR
36 equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1\/\fR'
38 \fB\-c\fR, \fB\-\-total\fR
41 \fB\-D\fR, \fB\-\-dereference\-args\fR
42 dereference only symlinks that are listed on the
45 \fB\-d\fR, \fB\-\-max\-depth\fR=\fI\,N\/\fR
46 print the total for a directory (or file, with \fB\-\-all\fR)
47 only if it is N or fewer levels below the command
48 line argument; \fB\-\-max\-depth\fR=\fI\,0\/\fR is the same as
51 \fB\-\-files0\-from\fR=\fI\,F\/\fR
52 summarize disk usage of the
53 NUL\-terminated file names specified in file F;
54 if F is \-, then read names from standard input
57 equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
59 \fB\-h\fR, \fB\-\-human\-readable\fR
60 print sizes in human readable format (e.g., 1K 234M 2G)
63 list inode usage information instead of block usage
66 like \fB\-\-block\-size\fR=\fI\,1K\/\fR
68 \fB\-L\fR, \fB\-\-dereference\fR
69 dereference all symbolic links
71 \fB\-l\fR, \fB\-\-count\-links\fR
72 count sizes many times if hard linked
75 like \fB\-\-block\-size\fR=\fI\,1M\/\fR
77 \fB\-P\fR, \fB\-\-no\-dereference\fR
78 don't follow any symbolic links (this is the default)
80 \fB\-S\fR, \fB\-\-separate\-dirs\fR
81 for directories do not include size of subdirectories
84 like \fB\-h\fR, but use powers of 1000 not 1024
86 \fB\-s\fR, \fB\-\-summarize\fR
87 display only a total for each argument
89 \fB\-t\fR, \fB\-\-threshold\fR=\fI\,SIZE\/\fR
90 exclude entries smaller than SIZE if positive,
91 or entries greater than SIZE if negative
94 show time of the last modification of any file in the
95 directory, or any of its subdirectories
97 \fB\-\-time\fR=\fI\,WORD\/\fR
98 show time as WORD instead of modification time:
99 atime, access, use, ctime or status
101 \fB\-\-time\-style\fR=\fI\,STYLE\/\fR
102 show times using STYLE, which can be:
103 full\-iso, long\-iso, iso, or +FORMAT;
104 FORMAT is interpreted like in 'date'
106 \fB\-X\fR, \fB\-\-exclude\-from\fR=\fI\,FILE\/\fR
107 exclude files that match any pattern in FILE
109 \fB\-\-exclude\fR=\fI\,PATTERN\/\fR
110 exclude files that match PATTERN
112 \fB\-x\fR, \fB\-\-one\-file\-system\fR
113 skip directories on different file systems
116 display this help and exit
119 output version information and exit
121 Display values are in units of the first available SIZE from \fB\-\-block\-size\fR,
122 and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables.
123 Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).
125 The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
126 Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000).
128 PATTERN is a shell pattern (not a regular expression). The pattern
130 matches any one character, whereas
132 matches any string (composed of zero, one or multiple characters). For
135 will match any files whose names end in
137 Therefore, the command
139 .B du --exclude=\(aq*.o\(aq
141 will skip all files and subdirectories ending in
147 Written by Torbjorn Granlund, David MacKenzie, Paul Eggert,
150 GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
152 Report du translation bugs to <http://translationproject.org/team/>
154 Copyright \(co 2016 Free Software Foundation, Inc.
155 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
157 This is free software: you are free to change and redistribute it.
158 There is NO WARRANTY, to the extent permitted by law.
160 Full documentation at: <http://www.gnu.org/software/coreutils/du>
162 or available locally via: info \(aq(coreutils) du invocation\(aq