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

FreeBSD Manual Pages

  
 
  

home | help
du(1)				 User Commands				 du(1)

NAME
       du - summarize disk usage

SYNOPSIS
       /usr/bin/du [-adLr] [-k | -h]  [-o | -s]	 [file ...]

       /usr/xpg4/bin/du	[-a | -s]  [-k | -h]  [-rx] [file ...]

DESCRIPTION
       The  du	utility	 writes	 to standard output the	size of	the file space
       allocated to, and the size of the file space allocated to  each	subdi-
       rectory	of,  the file hierarchy	rooted in each of the specified	files.
       The size	of the file space allocated to a file  of  type	 directory  is
       defined	as  the	 sum total of space allocated to all files in the file
       hierarchy rooted	in the directory  plus	the  space  allocated  to  the
       directory  itself.  This	 sum  will  include the	space allocated	to any
       extended	attributes encountered.

       Files with multiple links will be counted  and  written	for  only  one
       entry.  The  directory entry that is selected in	the report is unspeci-
       fied. By	default, file sizes are	written	in 512-byte units, rounded  up
       to the next 512-byte unit.

   /usr/xpg4/bin/du
       When  du	 cannot	 obtain	 file  attributes  or  read  directories  (see
       stat(2)), it will report	an error condition and the final  exit	status
       will be affected.

OPTIONS
       The    following	   options   are   supported   for   /usr/bin/du   and
       /usr/xpg4/bin/du:

       -a    In	addition to the	default	output,	report the size	of  each  file
	     not  of type directory in the file	hierarchy rooted in the	speci-
	     fied file.	Regardless of the presence  of	the  -a	 option,  non-
	     directories given as file operands	will always be listed.

       -h    All  sizes	 are  scaled  to a human readable format, for example,
	     14K, 234M,	2.7G, or 3.0T. Scaling is done by repetitively	divid-
	     ing by 1024.

       -k    Write  the	 files	sizes  in units	of 1024	bytes, rather than the
	     default 512-byte units.

       -s    Instead of	the default output, report only	the total sum for each
	     of	the specified files.

   /usr/bin/du
       The following options are supported for /usr/bin/du only:

       -d    Do	 not cross filesystem boundaries. For example, du -d / reports
	     usage only	on the root partition.

       -L    Process symbolic links by using the file or directory  which  the
	     symbolic link references, rather than the link itself.

       -o    Do	 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	-s  is
	     used.

       -r    Generate  messages	 about	directories that cannot	be read, files
	     that cannot be opened, and	so forth,  rather  than	 being	silent
	     (the default).

   /usr/xpg4/bin/du
       The following options are supported for /usr/xpg4/bin/du	only:

       -r    By	 default,  generate  messages about directories	that cannot be
	     read, files that cannot be	opened,	and so forth.

       -x    When evaluating file sizes, evaluate only those files  that  have
	     the same device as	the file specified by the file operand.

OPERANDS
       The following operand is	supported:

       file  The  path	name of	a file whose size is to	be written. If no file
	     is	specified, the current directory is used.

OUTPUT
       The output from du consists of the amount of the	space allocated	 to  a
       file and	the name of the	file.

USAGE
       See largefile(5)	for the	description of the behavior of du when encoun-
       tering files greater than or equal to 2 Gbyte ( 2**31 bytes).

ENVIRONMENT VARIABLES
       See environ(5) for descriptions of the following	environment  variables
       that affect the execution of du:	LC_CTYPE, LC_MESSAGES, and NLSPATH.

EXIT STATUS
       The following exit values are returned:

       0     Successful	completion.

       >0    An	error occurred.

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

   /usr/bin/du
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+
       |CSI			     |enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Stable			   |
       +-----------------------------+-----------------------------+

   /usr/xpg4/bin/du
       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWxcu4			   |
       +-----------------------------+-----------------------------+
       |CSI			     |enabled			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Standard			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       ls(1),  stat(2),	 attributes(5),	 environ(5),  fsattr(5), largefile(5),
       XPG4(5)

       System Administration Guide: Basic Administration

NOTES
       A file with two or more links is	counted	only once. If, however,	 there
       are  links between files	in different directories where the directories
       are on separate branches	of the file system hierarchy,  du  will	 count
       the excess files	more than once.

       Files containing	holes will result in an	incorrect block	count.

SunOS 5.9			  19 Nov 2001				 du(1)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | OUTPUT | USAGE | ENVIRONMENT VARIABLES | EXIT STATUS | ATTRIBUTES | SEE ALSO | NOTES

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=du&manpath=SunOS+5.9>

home | help