Home Man
Search
Today's Posts
Register

Linux & Unix Commands - Search Man Pages

OpenSolaris 2009.06 - man page for du (opensolaris section 1)

du(1)					  User Commands 				    du(1)

NAME
       du - summarize disk usage

SYNOPSIS
       /usr/bin/du [-dorx] [-a | -s] [-h | -k | -m] [-H | -L]
	    [file ...]

       /usr/xpg4/bin/du [-dorx] [-a | -s] [-h | -k | -m] [-H | -L]
	    [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 subdirectory of, the  file  hierarchy  rooted  in
       each of the specified files. The size of the file space allocated to a file of type direc-
       tory 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 unspecified. 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 direc-
	     tory in the file hierarchy rooted in the specified file. Regardless of the  presence
	     of the -a option, non-directories given as file operands will always be listed.

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

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

       -H    If a symbolic link to a directory is specified on the command line, process the sym-
	     bolic link by using the directory which the symbolic link	references,  rather  than
	     the link itself.

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

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

       -m    Write the files sizes in units of megabytes, rather than the default 512-byte units.

       -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 diagnostic messages about unreadable directories	and  files  whose  status
	     cannot  be  obtained.  /usr/bin/du is silent if these conditions arise and -r is not
	     specified. /usr/xpg4/bin/du acts as though -r is always specified.

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

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

       Specifying more than one of the options in the mutually exclusive pair, -H and -L, is  not
       considered an error. The last option specified determines the output format.

       Specifying  more  than one of the options in the mutually exclusive set of options -h, -k,
       and -m is not considered an error.  The last option specified determines the  output  for-
       mat.

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 encountering 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: LANG, LC_ALL, 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), standards(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.11				    6 Feb 2007					    du(1)


All times are GMT -4. The time now is 11:21 PM.

Unix & Linux Forums Content Copyrightę1993-2018. All Rights Reserved.
UNIX.COM Login
Username:
Password:  
Show Password