du - display the number of disk blocks used per directory or
/usr/ucb/du [-adkLr] [-o | -s] [filename]
The du utility gives the number of kilobytes contained in
all files and, recursively, directories within each speci-
fied directory or file filename. If filename is missing, `.'
(the current directory) is used.
A file that has multiple links to it is only counted once.
The following options are supported:
-a Generates an entry for each file.
-d Does not cross file system boundaries. For example, du
-d / reports usage only on the root partition.
-k Writes the files sizes in units of 1024 bytes, rather
than the default 512-byte units.
-L Processes symbolic links by using the file or direc-
tory that the symbolic link references, rather than
the link itself.
-o Does not add child directories' usage to a parent's
total. Without this option, the usage listed for a
particular directory is the space taken by the files
in that directory, as well as the files in all direc-
tories beneath it. This option does nothing if the -s
option is used.
-r Generates messages about directories that cannot be
read, files that cannot be opened, and so forth,
rather than being silent (the default).
-s Only displays the grand total for each of the speci-
Entries are generated only for each directory in the absence
Example 1: Showing usage of all subdirectories in a direc-
This example uses du in a directory. The pwd(1) command was
used to identify the directory, then du was used to show the
usage of all the subdirectories in that directory. The grand
total for the directory is the last entry in the display:
If any of the LC_* variables, that is, LC_CTYPE,
LC_MESSAGES, LC_TIME, LC_COLLATE, LC_NUMERIC, and
LC_MONETARY (see environ(5)), are not set in the environ-
ment, the operational behavior of du for each corresponding
locale category is determined by the value of the LANG
environment variable. If LC_ALL is set, its contents are
used to override both the LANG and the other LC_* variables.
If none of the above variables is set in the environment,
the "C" (U.S. style) locale determines how du behaves.
Determines how du handles characters. When LC_CTYPE
is set to a valid value, du can display and handle
text and filenames containing valid characters for
that locale. du can display and handle Extended Unix
Code (EUC) characters where any individual character
can be 1, 2, or 3 bytes wide. du can also handle EUC
characters of 1, 2, or more column widths. In the "C"
locale, only characters from ISO 8859-1 are valid.
Determines how diagnostic and informative messages are
presented. This includes the language and style of the
messages, and the correct form of affirmative and
negative responses. In the "C" locale, the messages
are presented in the default form found in the program
itself (in most cases, U.S. English).
See attributes(5) for descriptions of the following attri-
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
| Availability | SUNWscpu |
pwd(1), df(1M), du(1), quot(1M), attributes(5), environ(5)
Filename arguments that are not directory names are ignored,
unless you use -a.
If there are too many distinct linked files, du will count
the excess files more than once.
Man(1) output converted with