DF(1)                   System General Commands Manual                   DF(1)

NAME
     df - display free disk space

SYNOPSIS
     df [-aFilw] [-g | -h | -H | -k | -m] [-P | -t] [-B size] [-T type]
        [[file | file_system] ...]

DESCRIPTION
     The df utility displays statistics about the amount of free disk space on
     the specified file_system or on the file system of which file is a part.
     By default, values are displayed as 512-byte block counts.  If neither a
     file nor a file_system operand is specified, statistics for all mounted
     file systems are displayed (subject to the -l and -t options below).

     The options are as follows:

     -a, --all
             Check for all drives. Do not skip the floppy drives
             (/dev/fs/[AB]).

     -B size, --block-size=SIZE
             Base on the environment variable BLOCKSIZE, but will over-ride
             BLOCKSIZE.  This is a user set block size.

     -F      Display the full device name instead of the abbreviated name.

     -h, --human-readble
             "Human-readable" output.  Use unit suffixes: Byte, Kilobyte,
             Megabyte, Gigabyte, Terabyte, Petabyte, Exabyte in order to
             reduce the number of digits to four or less.

     -H, --si
             Similar to the -h option but with a base mulitple of 1000 instead
             of 1024.

     -i, --inodes
             Include statistics on the number of free inodes.

     -g      By default, all sizes are reported in giga-bytes.

     -k      By default, all sizes are reported in 512-byte block counts.  The
             -k option causes the numbers to be reported in kilobytes.

     -l, --local
             Display statistics only about mounted file systems that are local
             to the machine (do not use the LanMan Redirector).  If a non-
             local file system is given as an argument, a warning is issued
             and no information is given on that file system.

     -m      By default, all sizes are reported in mega-byte counts.

     -P, --portability
             Print out information in a stricter format designed to be parsed
             by portable scripts. Cannot be used with the option. Is overrid-
             den when the or -H options are specified.

     -t      This is the default action already. Cannot be used with -P.

     -T type, --type=TYPE
             Indicate the actions should only be taken on file systems of the
             specified type.  More than one type may be specified in a comma-
             separated list.  The list of file system types can be prefixed
             with ``no'' to specify the file system types for which action
             should not be taken.  If a file system is given on the command
             line that is not of the specified type, a warning is issued and
             no information is given on that file system. The recognized types
             currently are all, cdfs, hpfs, nfs, ntfs, ofs, and samba.

     -w      Wide format display all of the information. Do not be constrained
             by the normal 80-column line length limit.

     -v      Ignored. For portability.

     --sync  Ignored. For portability. With Interix there is no cache to sync.

     --nosync
             Ignored. For portability. With Interix there is no cache to sync.

     No more than one of the -B, -h, -H, -g, -k, or -m options may be speci-
     fied together.

ENVIRONMENT
     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -B, -h,
                -H, -g, -k, or -m options are not specified, the block counts
                will be displayed in units of that size block. An invalid
                valid will be treated as 512 bytes (the default).

EXAMPLES
     $ df -kP /usr

     Output, in a strict format suitable for portable scripts, disk space
     statistics for the /usr file system using kilobyte block sizes.

DIAGNOSTICS
     The df utility exits with one of the following values:

     0     Successful completion.

     >0    An error occurred.

SEE ALSO
     getvfsstat(3), statvfs(2), du(1), find(1)

STANDARDS
     The df utility is compliant with the IEEE Std 1003.2-1992 (``POSIX.2'')
     specification and SUS.

HISTORY
     A df utility appeared in Version 3 AT&T UNIX.

Interix                       September 13, 2006                       Interix