1DU(1)                            User Commands                           DU(1)
2
3
4

NAME

6       du - estimate file space usage
7

SYNOPSIS

9       du [OPTION]... [FILE]...
10       du [OPTION]... --files0-from=F
11

DESCRIPTION

13       Summarize  device  usage  of the set of FILEs, recursively for directo‐
14       ries.
15
16       Mandatory arguments to long options are  mandatory  for  short  options
17       too.
18
19       -0, --null
20              end each output line with NUL, not newline
21
22       -a, --all
23              write counts for all files, not just directories
24
25       --apparent-size
26              print  apparent sizes rather than device usage; although the ap‐
27              parent size is usually smaller, it may be larger due to holes in
28              ('sparse')  files,  internal fragmentation, indirect blocks, and
29              the like
30
31       -B, --block-size=SIZE
32              scale sizes by SIZE before printing  them;  e.g.,  '-BM'  prints
33              sizes in units of 1,048,576 bytes; see SIZE format below
34
35       -b, --bytes
36              equivalent to '--apparent-size --block-size=1'
37
38       -c, --total
39              produce a grand total
40
41       -D, --dereference-args
42              dereference only symlinks that are listed on the command line
43
44       -d, --max-depth=N
45              print the total for a directory (or file, with --all) only if it
46              is  N  or  fewer  levels  below  the  command   line   argument;
47              --max-depth=0 is the same as --summarize
48
49       --files0-from=F
50              summarize  device  usage of the NUL-terminated file names speci‐
51              fied in file F; if F is -, then read names from standard input
52
53       -H     equivalent to --dereference-args (-D)
54
55       -h, --human-readable
56              print sizes in human readable format (e.g., 1K 234M 2G)
57
58       --inodes
59              list inode usage information instead of block usage
60
61       -k     like --block-size=1K
62
63       -L, --dereference
64              dereference all symbolic links
65
66       -l, --count-links
67              count sizes many times if hard linked
68
69       -m     like --block-size=1M
70
71       -P, --no-dereference
72              don't follow any symbolic links (this is the default)
73
74       -S, --separate-dirs
75              for directories do not include size of subdirectories
76
77       --si   like -h, but use powers of 1000 not 1024
78
79       -s, --summarize
80              display only a total for each argument
81
82       -t, --threshold=SIZE
83              exclude entries  smaller  than  SIZE  if  positive,  or  entries
84              greater than SIZE if negative
85
86       --time show time of the last modification of any file in the directory,
87              or any of its subdirectories
88
89       --time=WORD
90              show time as WORD instead of modification time:  atime,  access,
91              use, ctime or status
92
93       --time-style=STYLE
94              show  times  using STYLE, which can be: full-iso, long-iso, iso,
95              or +FORMAT; FORMAT is interpreted like in 'date'
96
97       -X, --exclude-from=FILE
98              exclude files that match any pattern in FILE
99
100       --exclude=PATTERN
101              exclude files that match PATTERN
102
103       -x, --one-file-system
104              skip directories on different file systems
105
106       --help display this help and exit
107
108       --version
109              output version information and exit
110
111       Display  values  are  in  units  of  the  first  available  SIZE   from
112       --block-size,  and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environ‐
113       ment variables.  Otherwise, units default to  1024  bytes  (or  512  if
114       POSIXLY_CORRECT is set).
115
116       The  SIZE  argument  is  an  integer and optional unit (example: 10K is
117       10*1024).  Units are K,M,G,T,P,E,Z,Y  (powers  of  1024)  or  KB,MB,...
118       (powers  of 1000).  Binary prefixes can be used, too: KiB=K, MiB=M, and
119       so on.
120

PATTERNS

122       PATTERN is a shell pattern (not a regular expression).  The  pattern  ?
123       matches  any  one  character, whereas * matches any string (composed of
124       zero, one or multiple characters).  For example,  *.o  will  match  any
125       files whose names end in .o.  Therefore, the command
126
127              du --exclude='*.o'
128
129       will skip all files and subdirectories ending in .o (including the file
130       .o itself).
131

AUTHOR

133       Written by Torbjorn Granlund, David MacKenzie,  Paul  Eggert,  and  Jim
134       Meyering.
135

REPORTING BUGS

137       GNU coreutils online help: <https://www.gnu.org/software/coreutils/>
138       Report any translation bugs to <https://translationproject.org/team/>
139
141       Copyright  ©  2022  Free Software Foundation, Inc.  License GPLv3+: GNU
142       GPL version 3 or later <https://gnu.org/licenses/gpl.html>.
143       This is free software: you are free  to  change  and  redistribute  it.
144       There is NO WARRANTY, to the extent permitted by law.
145

SEE ALSO

147       Full documentation <https://www.gnu.org/software/coreutils/du>
148       or available locally via: info '(coreutils) du invocation'
149
150
151
152GNU coreutils 9.1                January 2023                            DU(1)
Impressum