du(1)									du(1)



NAME
  du - Displays a summary of disk usage

SYNOPSIS

  du [-a | -s] [-klrx] [file ...] [directory ...]

  The du command gives the number of blocks in all directories (listed recur-
  sively) within each specified directory.

FLAGS

  -a  Displays disk use for each file.	Without -a, du does not report on
      files.

  -s  Displays only the grand total for each of the specified directories, or
      for a file if used with -a.

  -k  Displays block count in kilobytes instead of multiples of 512 bytes.

  -l  Allocates blocks, in files with multiple links, evenly among the links.
      By default, a file with two or more links is counted only once.

  -r  Displays an error message when du encounters an inaccessible directory,
      or an inaccessible file when used with -a.

  -x  Displays information about only the specified file system.  For exam-
      ple, if you want to display information about only the root file sys-
      tem, specify both the -x flag and the root file system (/).

DESCRIPTION

  When the -a flag is specified, du reports the number of blocks in indivi-
  dual files.  The block count includes the indirect blocks of each file and
  is in 512-byte units, independent of the cluster size used by the system.
  If no file or directory name is provided, the du command uses the current
  directory.

NOTES

  If too many files are distinctly linked, du counts the excess files more
  than once.

EXAMPLES

  To display the disk usage of a directory tree and each of its subtrees,
  enter:

       du  /u/fran


  The previous command displays the number of disk blocks in the /u/fran
  directory and each of its subdirectories.

  To display the disk usage of each file, enter:

       du  -a  /u/fran


  The previous command displays the number of disk blocks contained in each
  file and subdirectory of /u/fran.  The number beside a directory is the
  disk usage of that directory tree.  The number beside a regular file is the
  disk usage of that file alone.

  To display only the total disk usage of a directory tree, enter:

       du  -rs	/u/fran


  The previous command displays only the sum total disk usage of /u/fran and
  the files it contains (-s).  The -r flag tells du to display an error mes-
  sage if it cannot read a file or directory.

  To restrict the disk usage information to the root (/) file system, enter:

       du  -x  /


  The previous command displays information only about the root file system
  and does not display information about the file systems located under the
  root file system.

RELATED INFORMATION

  Commands:  df(1), quot(8).