Debian Codegraph @

upstream/debian-unstable/man1/du.1

raw
1 .\" DO NOT MODIFY THIS FILE! It was generated by help2man 1.50.1.
2 .TH DU "1" "February 2026" "GNU coreutils 9.10" "User Commands"
3 .SH NAME
4 du \- estimate file space usage
5 .SH SYNOPSIS
6 .B du
7 [\fI\,OPTION\/\fR]... [\fI\,FILE\/\fR]...
8 .br
9 .B du
10 [\fI\,OPTION\/\fR]... \fI\,--files0-from=F\/\fR
11 .SH DESCRIPTION
12 .\" Add any additional description here
13 .PP
14 Summarize device usage of the set of FILEs, recursively for directories.
15 .PP
16 Mandatory arguments to long options are mandatory for short options too.
17 .TP
18 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-0'\fB\-0, \-\-null\fP\X'tty: link'
19 end each output line with NUL, not newline
20 .TP
21 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-a'\fB\-a, \-\-all\fP\X'tty: link'
22 write counts for all files, not just directories
23 .TP
24 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-A'\fB\-A, \-\-apparent\-size\fP\X'tty: link'
25 print apparent sizes rather than device usage;
26 although the apparent size is usually smaller, it may be
27 larger due to holes in ('sparse') files,
28 internal fragmentation, indirect blocks, etc.
29 .TP
30 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-B'\fB\-B, \-\-block\-size=\,SIZE\fP\X'tty: link'\/\fR
31 scale sizes by SIZE before printing them; See SIZE format below;
32 E.g., '\-BM' prints sizes in units of 1,048,576 bytes
33 .TP
34 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-b'\fB\-b, \-\-bytes\fP\X'tty: link'
35 equivalent to '\-\-apparent\-size \fB\-\-block\-size\fR=\fI\,1'\/\fR
36 .TP
37 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-c'\fB\-c, \-\-total\fP\X'tty: link'
38 produce a grand total
39 .TP
40 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-D'\fB\-D, \-\-dereference\-args\fP\X'tty: link'
41 dereference only symlinks that are listed on the command line
42 .TP
43 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-d'\fB\-d, \-\-max\-depth=\,N\fP\X'tty: link'\/\fR
44 print the total for a directory (or file, with \fB\-\-all\fR)
45 only if it is N or fewer levels below the command
46 line argument; \fB\-\-max\-depth\fR=\fI\,0\/\fR is the same as \fB\-\-summarize\fR
47 .TP
48 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--files0-from'\fB\-\-files0\-from=F\fP\X'tty: link'
49 summarize device usage of the NUL\-terminated file names
50 specified in file F; if F is \-, read names from standard input
51 .TP
52 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-H'\fB\-H\fP\X'tty: link'
53 equivalent to \fB\-\-dereference\-args\fR (\fB\-D\fR)
54 .TP
55 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-h'\fB\-h, \-\-human\-readable\fP\X'tty: link'
56 print sizes in human readable format (e.g., 1K 234M 2G)
57 .TP
58 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--inodes'\fB\-\-inodes\fP\X'tty: link'
59 list inode usage information instead of block usage
60 .TP
61 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-k'\fB\-k\fP\X'tty: link'
62 like \fB\-\-block\-size\fR=\fI\,1K\/\fR
63 .TP
64 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-L'\fB\-L, \-\-dereference\fP\X'tty: link'
65 dereference all symbolic links
66 .TP
67 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-l'\fB\-l, \-\-count\-links\fP\X'tty: link'
68 count sizes many times if hard linked
69 .TP
70 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-m'\fB\-m\fP\X'tty: link'
71 like \fB\-\-block\-size\fR=\fI\,1M\/\fR
72 .TP
73 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-P'\fB\-P, \-\-no\-dereference\fP\X'tty: link'
74 don't follow any symbolic links (this is the default)
75 .TP
76 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-S'\fB\-S, \-\-separate\-dirs\fP\X'tty: link'
77 for directories do not include size of subdirectories
78 .TP
79 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--si'\fB\-\-si\fP\X'tty: link'
80 like \fB\-h\fR, but use powers of 1000 not 1024
81 .TP
82 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-s'\fB\-s, \-\-summarize\fP\X'tty: link'
83 display only a total for each argument
84 .TP
85 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-t'\fB\-t, \-\-threshold=\,SIZE\fP\X'tty: link'\/\fR
86 exclude entries smaller than SIZE if positive,
87 or entries greater than SIZE if negative
88 .TP
89 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time'\fB\-\-time\fP\X'tty: link'
90 show time of the last modification of any file in the directory,
91 or any of its subdirectories
92 .TP
93 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time'\fB\-\-time=WORD\fP\X'tty: link'
94 show time as WORD instead of modification time:
95 atime, access, use, ctime or status
96 .TP
97 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--time-style'\fB\-\-time\-style=STYLE\fP\X'tty: link'
98 time/date format with \fB\-\-time\fR; see TIME_STYLE below
99 .TP
100 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-X'\fB\-X, \-\-exclude\-from=\,FILE\fP\X'tty: link'\/\fR
101 exclude files that match any pattern in FILE
102 .TP
103 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du--exclude'\fB\-\-exclude=PATTERN\fP\X'tty: link'
104 exclude files that match PATTERN
105 .TP
106 \X'tty: link https://www.gnu.org/software/coreutils/manual/coreutils.html#du-x'\fB\-x, \-\-one\-file\-system\fP\X'tty: link'
107 skip directories on different file systems
108 .TP
109 \X'tty: link https://www.gnu.org/software/coreutils/du#du--help'\fB\-\-help\fP\X'tty: link'
110 display this help and exit
111 .TP
112 \X'tty: link https://www.gnu.org/software/coreutils/du#du--version'\fB\-\-version\fP\X'tty: link'
113 output version information and exit
114 .PP
115 Display values are in units of the first available SIZE from \fB\-\-block\-size\fR,
116 and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables.
117 Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).
118 .PP
119 The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
120 Units are K,M,G,T,P,E,Z,Y,R,Q (powers of 1024) or KB,MB,... (powers of 1000).
121 Binary prefixes can be used, too: KiB=K, MiB=M, and so on.
122 .PP
123 The \fB\-\-time\-style\fR STYLE argument can be full\-iso, long\-iso, iso, or +FORMAT.
124 FORMAT is interpreted like in \fBdate\fP(1).
125 Also the TIME_STYLE environment variable sets the default style to use.
126 .SH PATTERNS
127 PATTERN is a shell pattern (not a regular expression). The pattern
128 .B ?\&
129 matches any one character, whereas
130 .B *
131 matches any string (composed of zero, one or multiple characters). For
132 example,
133 .B *.o
134 will match any files whose names end in
135 .BR .o .
136 Therefore, the command
137 .IP
138 .B du \-\-exclude=\(aq*.o\(aq
139 .PP
140 will skip all files and subdirectories ending in
141 .B .o
142 (including the file
143 .B .o
144 itself).
145 .SH AUTHOR
146 Written by Torbjorn Granlund, David MacKenzie, Paul Eggert,
147 and Jim Meyering.
148 .SH "REPORTING BUGS"
149 Report bugs to: bug\[email protected]
150 .br
151 GNU coreutils home page: <https://www.gnu.org/software/coreutils/>
152 .br
153 General help using GNU software: <https://www.gnu.org/gethelp/>
154 .br
155 Report any translation bugs to <https://translationproject.org/team/>
156 .SH "SEE ALSO"
157 Full documentation <https://www.gnu.org/software/coreutils/du>
158 .br
159 or available locally via: info \(aq(coreutils) du invocation\(aq
160 .PP
161 .br
162 Packaged by Debian (9.10\-1)
163 .br
164 Copyright \(co 2026 Free Software Foundation, Inc.
165 .br
166 License GPLv3+: GNU GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
167 .br
168 This is free software: you are free to change and redistribute it.
169 .br
170 There is NO WARRANTY, to the extent permitted by law.