du(1) - f14

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 only symlinks that are listed on the command line
38
39       --files0-from=F
40              summarize  disk usage of the NUL-terminated file names specified
41              in file F; If F is - then read names from standard input
42
43       -H     equivalent to --dereference-args (-D)
44
45       -h, --human-readable
46              print sizes in human readable format (e.g., 1K 234M 2G)
47
48       --si   like -h, but use powers of 1000 not 1024
49
50       -k     like --block-size=1K
51
52       -l, --count-links
53              count sizes many times if hard linked
54
55       -m     like --block-size=1M
56
57       -L, --dereference
58              dereference all symbolic links
59
60       -P, --no-dereference
61              don't follow any symbolic links (this is the default)
62
63       -0, --null
64              end each output line with 0 byte rather than newline
65
66       -S, --separate-dirs
67              do not include size of subdirectories
68
69       -s, --summarize
70              display only a total for each argument
71
72       -x, --one-file-system
73              skip directories on different file systems
74
75       -X, --exclude-from=FILE
76              exclude files that match any pattern in FILE
77
78       --exclude=PATTERN
79              exclude files that match PATTERN
80
81       --max-depth=N
82              print the total for a directory (or file, with --all) only if it
83              is   N   or  fewer  levels  below  the  command  line  argument;
84              --max-depth=0 is the same as --summarize
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 STYLE: full-iso, long-iso,  iso,  +FORMAT
95              FORMAT is interpreted like `date'
96
97       --help display this help and exit
98
99       --version
100              output version information and exit
101
102       Display   values  are  in  units  of  the  first  available  SIZE  from
103       --block-size, and the DU_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE  environ‐
104       ment  variables.   Otherwise,  units  default  to 1024 bytes (or 512 if
105       POSIXLY_CORRECT is set).
106
107       SIZE may be (or may be an integer optionally followed by) one  of  fol‐
108       lowing: KB 1000, K 1024, MB 1000*1000, M 1024*1024, and so on for G, T,
109       P, E, Z, Y.
110

PATTERNS

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

AUTHOR

123       Written by Torbjorn Granlund, David MacKenzie,  Paul  Eggert,  and  Jim
124       Meyering.
125

REPORTING BUGS

127       Report du bugs to bug-coreutils@gnu.org
128       GNU coreutils home page: <http://www.gnu.org/software/coreutils/>
129       General help using GNU software: <http://www.gnu.org/gethelp/>
130       Report du translation bugs to <http://translationproject.org/team/>
131

COPYRIGHT

133       Copyright  ©  2010  Free Software Foundation, Inc.  License GPLv3+: GNU
134       GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
135       This is free software: you are free  to  change  and  redistribute  it.
136       There is NO WARRANTY, to the extent permitted by law.
137