[Previous] [Contents] [Index] [Next]

Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

du

Estimate disk space usage (POSIX)

Syntax:

du [-a|-s] [-kpqx] [file...]

Options:

-a
Generate a report for each file in the directory tree. If you don't specify this option, du makes a report for each directory only. The report shows the total space allocated to all files under the directory, including the directory itself.
-k
Report the space figures in Kbytes (the default is 512-byte blocks).
-p
Report the space figures in bytes (the default is 512-byte blocks). Also, ensure that du generates error messages when it can't process existing files (unless the -q option is specified).
-q
Be quiet; suppress error messages when du can't provide statistics on files, or can't read directories.
-s
Give the total figures for each of the specified files, rather than the totals for any subdirectories.
-x
Don't span device boundaries (used to determine how much space on a particular device is consumed by a directory tree).
file
The pathname of a file whose size is to be displayed. If you don't specify any files, the current directory is used; du behaves as if the filename dot (.) were given.

Description:

The du utility prints the amount of file space allocated to the specified files. If you name a directory, all files in that directory are reported; subdirectories are traversed recursively. If a file has multiple links, the space allocated to that file is counted only once.

The space figures are displayed in 512-byte blocks by default. If you want du to print the size in bytes, specify the -p option. The sizes output by du when you specify the -p option are accurate with one exception: the numbers may be slightly higher than expected because they include extent blocks that are part of filesystem overhead associated with the file, but don't contain actual data.

If you specify nondirectories, they aren't listed unless you specify the -a option.

All results are written to the standard output. Errors may result in diagnostic messages to the standard error. Standard input isn't used.

Examples:

Estimate disk space consumed by the contents of /tmp, in kbytes:

du -k /tmp

Estimate the total space occupied by the contents of the current directory:

du -s

Exit status:

0
Successful completion.
>0
An error occurred. This doesn't include failure to read files or directories.

[Previous] [Contents] [Index] [Next]