Index for Section 1

Alphabetical listing for D

Bottom of page

du(1)
NAME
  du - Displays a summary of disk usage

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

STANDARDS
  Interfaces documented on this reference page conform to industry standards
  as follows:

  du:  XCU5.0

  Refer to the standards(5) reference page for more information about
  industry standards and associated tags.

OPTIONS
  -a  Displays disk use for each file.	Without -a, du does not report on
      files unless directory explicitly names a file.

      [Tru64 UNIX]  When run on an AdvFS clone fileset, du -a displays the
      disk use for each file in the original fileset at the time the clone
      fileset was created.

  -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 (1024 bytes) instead of multiples of
      512 bytes.

  -l  [Tru64 UNIX]  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
      example, if you want to display information about only the root file
      system, specify both the -x option and the root file system (/).

OPERANDS
  directory
      The pathname of a directory to be examined.  All subdirectories of
      directory are examined.

      If directory evaluates to a file name, then only information about the
      file is provided.

DESCRIPTION
  The du command gives the number of blocks in all directories (listed
  recursively) within each specified directory.

  [Tru64 UNIX]	When the -a option is specified, du reports the number of
  blocks in individual 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
  The du utility is marked LEGACY in XCU Issue 5.

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

EXIT STATUS
  The following exit values are returned:

  0   Successful completion.

  >0  An error occurred.

EXAMPLES
   1.  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.

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

   3.  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 option tells du to display an
       error message if it cannot read a file or directory.

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

ENVIRONMENT VARIABLES
  The following environment variables affect the execution of du:

  LANG
      Provides a default value for the internationalization variables that
      are unset or null. If LANG is unset or null, the corresponding value
      from the default locale is used.	If any of the internationalization
      variables contain an invalid setting, the utility behaves as if none of
      the variables had been defined.

  LC_ALL
      If set to a non-empty string value, overrides the values of all the
      other internationalization variables.

  LC_CTYPE
      Determines the locale for the interpretation of sequences of bytes of
      text data as characters (for example, single-byte as opposed to
      multibyte characters in arguments).

  LC_MESSAGES
      Determines the locale for the format and contents of diagnostic
      messages written to standard error.

  NLSPATH
      Determines the location of message catalogues for the processing of
      LC_MESSAGES.

SEE ALSO
  Commands:  df(1), ls(1), quot(8)

  Functions:  lseek(2), stat(2)

  Routines:  fseek(3)

  Standards:  standards(5)

Index for Section 1

Alphabetical listing for D

Top of page