File: coreutils.info, Node: df invocation, Next: du invocation, Up: Disk usage
14.1 `df': Report file system disk space usage
==============================================
`df' reports the amount of disk space used and available on file
systems. Synopsis:
df [OPTION]... [FILE]...
With no arguments, `df' reports the space used and available on all
currently mounted file systems (of all types). Otherwise, `df' reports
on the file system containing each argument FILE.
Normally the disk space is printed in units of 1024 bytes, but this
can be overridden (*note Block size::). Non-integer quantities are
rounded up to the next higher unit.
If an argument FILE is a disk device file containing a mounted file
system, `df' shows the space available on that file system rather than
on the file system containing the device node (i.e., the root file
system). GNU `df' does not attempt to determine the disk usage on
unmounted file systems, because on most kinds of systems doing so
requires extremely nonportable intimate knowledge of file system
structures.
The program accepts the following options. Also see *note Common
options::.
`-a'
`--all'
Include in the listing dummy file systems, which are omitted by
default. Such file systems are typically special-purpose
pseudo-file-systems, such as automounter entries.
`-B SIZE'
`--block-size=SIZE'
Scale sizes by SIZE before printing them (*note Block size::).
For example, `-BG' prints sizes in units of 1,073,741,824 bytes.
`--direct'
Do not resolve mount point and show statistics directly for a
file. It can be especially useful for NFS mount points if there is
a boundary between two storage policies behind the mount point.
`--total'
Print a grand total of all arguments after all arguments have been
processed. This can be used to find out the total disk size, usage
and available space of all listed devices.