du(C)                         06 January 1993                          du(C)


 Name

    du - summarize disk usage

 Syntax

    du [ -afrsu ] [ names ]

 Description

    The du command gives the number of blocks contained in all files and
    directories recursively within each directory and file specified by the
    names argument.  The block count includes the indirect blocks of the
    file.  If names is missing, the current directory is used.

    The -s option causes only the grand total (for each of the specified
    names) to be given.  The -a option causes an entry to be generated for
    each file.  Absence of either causes an entry to be generated for each
    directory only.

    The -f option causes du to display the usage of files in the current
    filesystem only. Directories containing mounted filesystems will be
    ignored. The -u option causes du to ignore files that have more than one
    link.

    du is normally silent about directories that cannot be read, files that
    cannot be opened, and so on.  The -r option will cause du to generate
    messages in such instances.

    A file with two or more links is only counted once. Symbolic links are
    not followed, but the disk space used to hold the actual symbolic link is
    counted.

 See also

    df(C)

 Notes

    If the -a option is not used, non-directories given as arguments are not
    listed.

    Files with holes in them will get an incorrect block count.

    This utility reports sizes in 512-byte blocks.  du interprets 1 block
    from a 1024-byte block system as 2 of its own 512-byte blocks; thus, du
    would report a 500-byte file as using 2 blocks rather than 1.

 Standards conformance

    du is conformant with:

    AT&T SVID Issue 2;
    and X/Open Portability Guide, Issue 3, 1989.