DF(1) | General Commands Manual | DF(1) |
df
— display free
disk space
df |
[-aclMnqW ] [-G |
-bkP | -bfgHhikmN ]
[-t type]
[file | file_system]... |
df
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, all
sizes are reported in 512-byte block counts. If neither a file or a
file_system operand is specified, statistics for all
mounted, and not hidden (i.e.: not mounted with
MNT_IGNORE
), file systems are displayed (subject to
the -a
, -l
and
-t
options below).
Note that the printed count of available blocks takes minfree into account, and thus will be negative when the number of free blocks on the file system is less than minfree.
The following options are available:
-a
MNT_IGNORE
flag. Note that for
file systems specified on the command line, that mount option is never
considered.-b
BLOCKSIZE
.-c
-f
only the total for the mount points which
otherwise would be included is shown, not the individual entries.-f
-i
,
free inodes) in a minimal format. When there is to be only one line of
output, only the value is shown, otherwise the value and the mount point,
separated by a single space, are printed. For free space, the
-b
, -g
,
-H
, -h
,
-k
and -m
options, and
BLOCKSIZE
are all used as normal. This option
implies -N
and is incompatible with
-P
and -G
.-G
-f
,
-i
or -P
options, and is
modelled after the Solaris -g
option. This option
will override the -b
, -g
,
-H
, -h
,
-k
and -m
options, as well
as any setting of BLOCKSIZE
.-g
-g
option causes size numbers to be reported
in gigabytes (1024*1024*1024 bytes).-h
-H
-h
but using powers of 10 (1000) rather
than 2 (1024).-i
-f
only the number of free inodes is shown.-k
BLOCKSIZE
environment variable is set. The
-k
option causes the size numbers to be reported
in kilobytes (1024 bytes).-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.-M
-m
-m
option causes size numbers to be reported
in megabytes (1024*1024 bytes).-N
-G
which has no header line to ignore, and with
-P
which requires the header line to maintain the
portable format it is designed to emulate.-n
df
will
not request new statistics from the file systems, but will respond with
the possibly stale statistics that were previously obtained.-P
The output will be preceded by the following header line:
"Filesystem <blksize>-blocks Used Available Capacity Mounted on\n"
The header line is followed by data formatted as follows:
"%s %d %d %d %d%% %s\n", <file system name>, <total space>, <space used>, <space free>, <percentage used>, <file system root>
Note that the -i
option may not be
specified with -P
, and the
blksize is required to be 512 or 1024.
-q
-t
type-W
-W
option is silently ignored for those file
systems.If more than one of -b
,
-g
, -H
,
-h
, -k
or
-m
is given, the last of those specified is
used.
BLOCKSIZE
BLOCKSIZE
is set, and
none of the -b
, -g
,
-H
, -h
,
-k
and -m
options are
specified, the block counts will be displayed in units of that size
block.quota(1), fstatvfs(2), getvfsstat(2), statvfs(2), getbsize(3), getmntinfo(3), humanize_number(3), fs(5), fstab(5), mount(8), quot(8), tunefs(8)
A df
utility appeared in
Version 1 AT&T UNIX. The
-f
option was added in NetBSD
10.
August 3, 2024 | NetBSD 10.99 |