df - report filesystem disk space usage
df [options] [file...]
POSIX options: [-kP]
GNU options (shortest form): [-ahikmPv] [-t fstype] [-x
fstype] [--print-type] [--no-sync] [--sync] [--help] [--ver-
df reports the amount of disk space used and available on
With no arguments, df reports the space used and available
on all currently mounted filesystems (of all types). Other-
wise, df reports on the filesystem containing each argument
The output is in 512-byte units by default, but in 1024-byte
units when the -k option is given. The output format is
undefined, unless the -P option is given. If file is not a
regular file, a directory or a FIFO, the result is unspeci-
The output is in 1024-byte units (when no units are speci-
fied by options), unless the environment variable
POSIXLY_CORRECT is set, in which case POSIX is followed.
If an argument file is a disk device file containing a
mounted filesystem, df shows the space available on that
filesystem rather than on the filesystem containing the dev-
-k Use 1024-byte units instead of the default 512-byte
-P Output in six columns, with heading `Filesystem N-
blocks Used Available Capacity Mounted on' (with N=512,
but N=1024 when the -k option is given).
Include in the listing filesystems that have a size of
0 blocks, which are omitted by default. Such filesys-
tems are typically special-purpose pseudo-filesystems,
such as automounter entries. Also, filesystems of type
"ignore" or "auto", supported by some operating sys-
tems, are only included if this option is specified.
Append a size letter such as M for megabytes to each
List inode usage information instead of block usage.
An inode (short for index node) is contains information
about a file such as its owner, permissions, times-
tamps, and location on the disk.
Print sizes in 1024-byte blocks.
Print sizes in megabyte (that's 1,048,576 bytes)
Do not invoke the sync system call before getting any
usage data. This may make df run significantly faster,
but on some systems (notably SunOS) the results may be
slightly out of date. This is the default.
Use the POSIX output format. This is like the default
format except that the information about each filesys-
tem is always printed on exactly one line; a mount dev-
ice is never put on a line by itself. This means that
if the mount device name is more than 20 characters
long (e.g., for some network mounts), the columns are
Invoke the sync system call before getting any usage
data. On some systems (notably SunOS), doing this
yields more up to date results, but in general this
option makes df much slower, especially when there are
many or very busy filesystems.
-t fstype, --type=fstype
Limit the listing to filesystems of type fstype. Multi-
ple filesystem types can be specified by giving multi-
ple -t options. By default, nothing is omitted.
Print each filesystem's type. The types given are
those reported by the system (and are found in a
system-dependent way, for example by reading
/etc/mtab). See also mount(8).
-x fstype, --exclude-type=fstype
Limit the listing to filesystems not of type fstype.
Multiple filesystem types can be eliminated by giving
multiple -x options. By default, no filesystem types
-v Ignored; for compatibility with System V versions of
GNU STANDARD OPTIONS
Print a usage message on standard output and exit suc-
Print version information on standard output, then exit
-- Terminate option list.
The variable POSIXLY_CORRECT determines the choice of unit.
If it is not set, and the variable BLOCKSIZE has a value
starting with `HUMAN', then behaviour is as for the -h
option, unless overridden by -k or -m options. The vari-
ables LANG, LC_ALL, LC_CTYPE and LC_MESSAGES have the usual
This page describes df as found in the fileutils-3.16 pack-
age; other versions may differ slightly. Mail corrections
and additions to firstname.lastname@example.org and email@example.com and
firstname.lastname@example.org . Report bugs in the program to