DF(1) | General Commands Manual | DF(1) |
df
— display free
disk space
df |
[-hiklnP ] [-t
type] [[file |
file_system] ...] |
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 no operands are specified, statistics for all
mounted file systems are displayed (subject to the
-l
and -t
options,
below).
The options are as follows:
-h
-P
option.-i
-P
option.-k
-k
option causes the numbers to be reported in
kilobyte counts.-l
MNT_LOCAL
flag set. If a non-local file system is
given as an argument, a warning is issued and no information is given on
that file system.-n
df
will
not request new statistics from the file systems, but will respond with
the possibly stale statistics that were previously obtained.-P
-t
typeIt is not an error to specify more than one of the mutually
exclusive options -h
and -k
.
Where more than one of these options is specified, the last option given
overrides the others.
BLOCKSIZE
BLOCKSIZE
is set, and
the -h
or -k
options are
not specified, the block counts will be displayed in units of that size
block.The df
utility exits 0 on success,
and >0 if an error occurs.
Output, in a strict format suitable for portable scripts, disk space statistics for the /usr file system using kilobyte block sizes:
$ df -kP /usr
quota(1), getfsstat(2), statfs(2), getmntinfo(3), fstab(5), mount(8), quot(8)
The df
utility is compliant with the
IEEE Std 1003.1-2008 (“POSIX.1”)
specification.
The flags [-hiln
], as well as the
BLOCKSIZE
environment variable, are extensions to
that specification.
This implementation provides the traditional
BSD -t
behaviour, which
differs from the X/Open System Interfaces option specification.
A df
utility appeared in
Version 1 AT&T UNIX.
August 10, 2016 | OpenBSD-6.4 |