unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

du(1)                            User Commands                           du(1)



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  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
                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  directory  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 deter-
       mines 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. With-
                out 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 oper-
                and.



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: 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
       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE   VALUE   AvailabilitySUNWcsu
       CSIEnabled Interface StabilityStable


   /usr/xpg4/bin/du
       tab()     allbox;     cw(2.750000i)|    cw(2.750000i)    lw(2.750000i)|
       lw(2.750000i).   ATTRIBUTE  TYPEATTRIBUTE  VALUE   AvailabilitySUNWxcu4
       CSIEnabled Interface StabilityStandard


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.10                        5 Oct 2003                             du(1)