du(1)							      General Commands Manual							     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

       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.  Displays only the grand total for each of the specified directories, or for a  file  if  used  with  -a.
	      Displays	block  count  in  kilobytes (1024 bytes) instead of multiples of 512 bytes.  [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.	Displays an error  message
	      when du encounters an inaccessible directory, or an inaccessible file when used with -a.	Displays information about only the speci-
	      fied 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

       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  pro-
       vided, 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: Successful completion.  An error occurred.

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 dis-
	      play 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.  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: 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 vari-
       ables  contain  an  invalid setting, the utility behaves as if none of the variables had been defined.  If set to a non-empty string value,
       overrides the values of all the other internationalization variables.  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).	Determines the locale for the for-
       mat and contents of diagnostic messages written to standard error.  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)

																	     du(1)