DU(1)							    BSD General Commands Manual 						     DU(1)

NAME

     du -- display disk usage statistics

SYNOPSIS

     du [-Aclnx] [-H | -L | -P] [-g | -h | -k | -m] [-a | -s | -d depth] [-B blocksize] [-I mask] [-t threshold] [file ...]

DESCRIPTION

     The du utility displays the file system block usage for each file argument and for each directory in the file hierarchy rooted in each direc-
     tory argument.  If no file is specified, the block usage of the hierarchy rooted in the current directory is displayed.

     The options are as follows:

     -A      Display the apparent size instead of the disk usage.  This can be helpful when operating on compressed volumes or sparse files.

     -B blocksize
	     Calculate block counts in blocksize byte blocks.  This is different from the -h, -k, -m and -g options or setting BLOCKSIZE and gives
	     an estimate of how much space the examined file hierarchy would require on a filesystem with the given blocksize.	Unless in -A mode,
	     blocksize is rounded up to the next multiple of 512.

     -H      Symbolic links on the command line are followed, symbolic links in file hierarchies are not followed.

     -I mask
	     Ignore files and directories matching the specified mask.

     -L      Symbolic links on the command line and in file hierarchies are followed.

     -P      No symbolic links are followed.  This is the default.

     -a      Display an entry for each file in a file hierarchy.

     -c      Display a grand total.

     -d depth
	     Display an entry for all files and directories depth directories deep.

     -g      Display block counts in 1073741824-byte (1 GiB) blocks.

     -h      ``Human-readable'' output.  Use unit suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte.

     -k      Display block counts in 1024-byte (1 kiB) blocks.

     -l      If a file has multiple hard links, count its size multiple times.	The default behavior of du is to count files with multiple hard
	     links only once.  When the -l option is specified, the hard link checks are disabled, and these files are counted (and displayed) as
	     many times as they are found.

     -m      Display block counts in 1048576-byte (1 MiB) blocks.

     -n      Ignore files and directories with user ``nodump'' flag (UF_NODUMP) set.

     -r      Generate messages about directories that cannot be read, files that cannot be opened, and so on.  This is the default case.  This
	     option exists solely for conformance with X/Open Portability Guide Issue 4 (``XPG4'').

     -s      Display an entry for each specified file.	(Equivalent to -d 0)

     -t threshold
	     Display only entries for which size exceeds threshold.  If threshold is negative, display only entries for which size is less than
	     the absolute value of threshold.

     -x      File system mount points are not traversed.

     The du utility counts the storage used by symbolic links and not the files they reference unless the -H or -L option is specified.  If either
     the -H or -L option is specified, storage used by any symbolic links which are followed is not counted (or displayed).  The -H, -L and -P
     options override each other and the command's actions are determined by the last one specified.

     The -h, -k and -m options all override each other; the last one specified determines the block counts used.

ENVIRONMENT

     BLOCKSIZE	If the environment variable BLOCKSIZE is set, and the -h, -k or -m options are not specified, the block counts will be displayed
		in units of that block size.  If BLOCKSIZE is not set, and the -h, -k or -m options are not specified, the block counts will be
		displayed in 512-byte blocks.

EXAMPLES

     Show disk usage for all files in the current directory.  Output is in human-readable form:

	   # du -ah

     Summarize disk usage in the current directory:

	   # du -hs

     Summarize disk usage for a specific directory:

	   # du -hs /home

     Show name and size of all C files in a specific directory.  Also display a grand total at the end:

	   # du -ch /usr/src/sys/kern/*.c

SEE ALSO

     df(1), chflags(2), fts(3), symlink(7), quot(8)

HISTORY

     A du command appeared in Version 1 AT&T UNIX.

BSD
								 November 4, 2012							       BSD