du(1) - f7

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 disk usage of each FILE, recursively for directories.
14
15       Mandatory  arguments  to  long  options are mandatory for short options
16       too.
17
18       -a, --all
19              write counts for all files, not just directories
20
21       --apparent-size
22              print apparent sizes,  rather  than  disk  usage;  although  the
23              apparent  size is usually smaller, it may be larger due to holes
24              in (`sparse') files, internal  fragmentation,  indirect  blocks,
25              and the like
26
27       -B, --block-size=SIZE
28              use SIZE-byte blocks
29
30       -b, --bytes
31              equivalent to `--apparent-size --block-size=1'
32
33       -c, --total
34              produce a grand total
35
36       -D, --dereference-args
37              dereference FILEs that are symbolic links
38
39       --files0-from=F
40              summarize  disk usage of the NUL-terminated file names specified
41              in file F
42
43       -H     like --si, but also evokes a warning; will  soon  change  to  be
44              equivalent to --dereference-args (-D)
45
46       -h, --human-readable
47              print sizes in human readable format (e.g., 1K 234M 2G)
48
49       --si   like -h, but use powers of 1000 not 1024
50
51       -k     like --block-size=1K
52
53       -l, --count-links
54              count sizes many times if hard linked
55
56       -m     like --block-size=1M
57
58       -L, --dereference
59              dereference all symbolic links
60
61       -P, --no-dereference
62              don't follow any symbolic links (this is the default)
63
64       -0, --null
65              end each output line with 0 byte rather than newline
66
67       -S, --separate-dirs
68              do not include size of subdirectories
69
70       -s, --summarize
71              display only a total for each argument
72
73       -x, --one-file-system
74              skip directories on different file systems
75
76       -X FILE, --exclude-from=FILE
77              Exclude files that match any pattern in FILE.
78
79       --exclude=PATTERN
80              Exclude files that match PATTERN.
81
82       --max-depth=N
83              print the total for a directory (or file, with --all) only if it
84              is  N  or  fewer  levels  below  the  command   line   argument;
85              --max-depth=0 is the same as --summarize
86
87       --time show time of the last modification of any file in the directory,
88              or any of its subdirectories
89
90       --time=WORD
91              show time as WORD instead of modification time:  atime,  access,
92              use, ctime or status
93
94       --time-style=STYLE
95              show  times  using style STYLE: full-iso, long-iso, iso, +FORMAT
96              FORMAT is interpreted like `date'
97
98       --help display this help and exit
99
100       --version
101              output version information and exit
102
103       SIZE may be (or may be an integer optionally followed by) one  of  fol‐
104       lowing: kB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T,
105       P, E, Z, Y.
106

PATTERNS

108       PATTERN is a shell pattern (not a regular expression).  The  pattern  ?
109       matches  any  one  character, whereas * matches any string (composed of
110       zero, one or multiple characters).  For example,  *.o  will  match  any
111       files whose names end in .o.  Therefore, the command
112
113              du --exclude='*.o'
114
115       will skip all files and subdirectories ending in .o (including the file
116       .o itself).
117

AUTHOR

119       Written by Torbjorn Granlund, David MacKenzie,  Paul  Eggert,  and  Jim
120       Meyering.
121

REPORTING BUGS

123       Report bugs to <bug-coreutils@gnu.org>.
124

COPYRIGHT

126       Copyright © 2007 Free Software Foundation, Inc.
127       This  is  free  software.   You may redistribute copies of it under the
128       terms      of      the      GNU      General       Public       License
129       <http://www.gnu.org/licenses/gpl.html>.   There  is NO WARRANTY, to the
130       extent permitted by law.
131