Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1‎ > ‎

du


NAME
     du - summarize disk usage

SYNOPSIS
     /usr/bin/du [-adr] [-k | -h]  [-H | -L]  [-o  |  -s]   [file
     ...]

     /usr/xpg4/bin/du [-a | -s]  [-k |  -h]   [-H  |  -L]   [-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 subdirectory 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 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 directory 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.



     -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  symbolic 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  direc-
              tory  which  the  symbolic  link references, rather
              than the link itself.



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



     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.

  /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.



     -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  noth-
              ing 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 speci-
              fied by the file operand.



OPERANDS
     The following operand is supported:

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



OUTPUT
     The output from du consists of the amount of the space allo-
     cated 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  attri-
     butes:

  /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), large-
     file(5), standards(5)

     System Administration Guide: Basic Administration

NOTES
     A file with two or more links is counted only once. If, how-
     ever, 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.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments