Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
DU(1)			    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 argu-
       ment and	for each directory in the file hierarchy rooted	in each	direc-
       tory argument.  If no file is specified,	the block usage	of the hierar-
       chy 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  dif-
	       ferent  from the	-h, -k,	-m and -g options or setting BLOCKSIZE
	       and gives an estimate of	how much space the examined file hier-
	       archy 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  directo-
	       ries 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 mul-
	       tiple 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 ei-
       ther 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	speci-
       fied 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.

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

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

FreeBSD	8.4-stable		 July 18, 2012				 DU(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=du&sektion=1&manpath=FreeBSD+8.4-RELEASE>

home | help