du(1B)						     SunOS/BSD Compatibility Package Commands						    du(1B)

NAME

       du - display the number of disk blocks used per directory or file

SYNOPSIS

       /usr/ucb/du [-adkLr] [-o | -s] [filename]

DESCRIPTION

       The  du	utility gives the number of kilobytes contained in all files and, recursively, directories within each specified 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.

OPTIONS

       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 directory 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 directories 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 specified filenames.

       Entries are generated only for each directory in the absence of options.

EXAMPLES

       Example 1 Showing usage of all subdirectories in a directory

       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:

	 example% pwd
	 /usr/ralph/misc
	 example% du
	 5	./jokes
	 33	./squash
	 44	./tech.papers/lpr.document
	 217	./tech.papers/new.manager
	 401	./tech.papers
	 144	./memos
	 80	./letters
	 388	./window
	 93	./messages
	 15	./useful.news
	 1211	.

ENVIRONMENT VARIABLES

       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 environment, the operational behavior of du for each corresponding locale category is determined by the value of the LANG envi-
       ronment 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.

       LC_CTYPE       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  indi-
		      vidual  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.

       LC_MESSAGES    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).

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWscpu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       pwd(1), df(1M), du(1), quot(1M), attributes(5), environ(5)

NOTES

       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.

SunOS 5.11							    5 Jun 2001								    du(1B)