DU
NAME
du - estimate file space usage
SYNOPSIS
du [options] [file...]
POSIX options:
[-askx]
GNU options (shortest form):
[-abchklmsxDLS]
[--help] [--version] [--]
DESCRIPTION
du
reports the amount of disk space used by the specified files,
and by each directory in the hierarchies rooted at the
specified files.
Here `disk space used' means space used for the entire
file hierarchy below the specified file.
With no arguments,
du
reports the disk space for the current directory.
POSIX DETAILS
The output is in 512-byte units by default, but in
1024-byte units when the -k option is given.
GNU DETAILS
The output is in 1024-byte units (when no units are
specified by options), unless the environment variable
POSIXLY_CORRECT
is set, in which case POSIX is followed.
POSIX OPTIONS
- -a
-
Show counts for all files encountered, not just directories.
- -k
-
Use 1024-byte units instead of the default 512-byte units.
- -s
-
Only output space usage for the actual arguments given,
not for their subdirectories.
- -x
-
Only count space on the same device as the argument given.
GNU OPTIONS
- -a, --all
-
Show counts for all files, not just directories.
- -b, --bytes
-
Print sizes in bytes, instead of kilobytes.
- -c, --total
-
Print a grand total of all arguments after all arguments have been
processed. This can be used to find out the total disk usage of a
given set of files or directories.
- -D, --dereference-args
-
Dereference symbolic links that are command line arguments. Does
not affect other symbolic links. This is helpful for finding out
the disk usage of directories, such as
/usr/tmp,
which are often symbolic links.
- -h, --human-readable
-
Append a size letter, such as
M
for megabytes, to each size.
- -k, --kilobytes
-
Print sizes in kilobytes.
- -l, --count-links
-
Count the size of all files, even if they have appeared already
(as a hard link).
- -L, --dereference
-
Dereference symbolic links (show the disk space used by the file
or directory that the link points to instead of the space used by
the link).
- -m, --megabytes
-
Print sizes in megabyte (that 1,048,576 bytes) blocks.
- -s, --summarize
-
Display only a total for each argument.
- -S, --separate-dirs
-
Report the size of each directory separately, not including the
sizes of subdirectories.
- -x, --one-file-system
-
Skip directories that are on different filesystems from the one
that the argument being processed is on.
GNU STANDARD OPTIONS
- --help
-
Print a usage message on standard output and exit successfully.
- --version
-
Print version information on standard output, then exit successfully.
- --
-
Terminate option list.
BUGS
On BSD systems,
du
reports sizes that are half the correct values
for files that are NFS-mounted from HP-UX systems. On HP-UX systems,
it reports sizes that are twice the correct values for files that are
NFS-mounted from BSD systems. This is due to a flaw in HP-UX; it also
affects the HP-UX
du
program.
ENVIRONMENT
The variable POSIXLY_CORRECT determines the choice of unit.
If it is not set, and the variable BLOCKSIZE has a value starting
with `HUMAN', then behaviour is as for the -h option,
unless overridden by -k or -m options.
The variables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the
usual meaning.
CONFORMING TO
POSIX 1003.2
NOTES
This page describes
du
as found in the fileutils-3.16 package;
other versions may differ slightly. Mail corrections and additions to
aeb@cwi.nl and aw@mail1.bet1.puv.fi and ragnar@lightside.ddns.org .
Report bugs in the program to fileutils-bugs@gnu.ai.mit.edu.