NAME    [Toc]    [Back]

     du - display disk usage statistics

SYNOPSIS    [Toc]    [Back]

     du [-H | -L | -P] [-a | -s] [-chkrx] [file ...]

DESCRIPTION    [Toc]    [Back]

     The du utility displays the file system block usage for each
file argument
  and for each directory in the file hierarchy rooted in
each directory
 argument.  Note that the system block  usage  is  usually
greater than
     the  actual  size of the file.  If no file is specified, the
block usage of
     the hierarchy rooted in the current directory is  displayed.

     The options are as follows:

     -H       Symbolic  links  on  the command line are followed.
(Symbolic links
             encountered in the tree traversal are not followed.)

     -L      All symbolic links are followed.

     -P      No symbolic links are followed.

     -a       Display  an entry for each file in the file hierarchy.

     -k      By default, du displays the number of blocks as  returned by the
             stat(2)  system call, i.e., 512-byte blocks.  If the
-k flag is
             specified, the number displayed  is  the  number  of
1024-byte
             blocks.  Partial numbers of blocks are rounded up.

     -c      Display the grand total after all the arguments have
been processed.


     -h      Display numbers in a human readable form.  Use  unit
suffixes:
             Byte,  Kilobyte, Megabyte, Gigabyte, Terabyte in order to reduce
             the number of digits to four or  less.   This  overrides the -k option.


     -s       Display  only  the  grand  total  for the specified
files.

     -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'').

     -x      File system mount points are not traversed.

     du  counts  the  storage  used by symbolic links and not the
files they reference
 unless the -H or -L option is specified.   If  either
the -H or -L
     options  are  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.


     Files having multiple hard links are counted (and displayed)
a single
     time per du execution.

ENVIRONMENT    [Toc]    [Back]

     BLOCKSIZE   Block  counts will be displayed in units of this
size block,
                unless the -k or -h option is specified.

SEE ALSO    [Toc]    [Back]

     df(1), fts(3), symlink(7), quot(8)

HISTORY    [Toc]    [Back]

     A du command appeared in Version 3 AT&T UNIX.

OpenBSD     3.6                         October      4,      1996