df(1M)

NAME

df − report number of free disk blocks and files

SYNOPSIS

df [ −abegiklnt ] [ −F fstype ] [ filesystem | file ] ...

DESCRIPTION

df prints information about the disk space available on the specified filesystem, e.g. “/dev/dsk/0s0”, or on the file system in which the specified file, e.g. “$HOME”, is contained. If no options or file systems are specified, the free space on all of the local and remotely mounted file systems is printed.

df normally displays the number of free 512-byte blocks and the number of free file nodes. With the −k option, it displays the amount of disk space occupied by each file system, used and available space within the file system, and how much of the file system’s total capacity has been used. In this case, the reported numbers are in kilobytes.

Note that the amount of space reported as used and available is less than the amount of space in the file system; this is because the system reserves a fraction of the space in the file system to allow its file system allocation routines to work well. The amount reserved is typically about 10%; this may be adjusted using tunefs(1M). When all the space on the file system except for this reserve is in use, only the super-user can allocate new files and data blocks to existing files. When the file system is overallocated in this way, df may report that the file system is more than 100% utilized.

The options are:

−F fstype All mounted file systems of type fstype are to be reported. fstype may be 4.2 or nfs. This option may not be used when also specifying a filesystem or file.

−a Report on all file systems including the uninteresting ones which have zero total blocks (see automount(1M)).

−b Print only the number of kilobytes free.

−e Print only the number of files free.

−g Print the entire statfs structure. This information is available only for mounted file systems. This option will override the -b, -e, -i, -n, and -t options.

−i Report the number of used and free file nodes.

−k Report numbers in kilobytes, showing available and total disk space and how much of the total capacity has been used.

−l Report on local file systems only. If a remote filesystem is specified along with this option, df will report that the file system cannot be found.

−n Print only the file system type name. This information is available only for mounted file systems.

−t Print full listings with totals. This option will override the -b, -e, and -n options.

NOTES

The function of the −t option has changed recently in order to comply with industry standards. The −F option serves the same purpose as the −t option of previous releases. The default output format has also changed, and is now based on the AT&T version instead of the BSD version. /usr/ucb/df retains the old BSD command line syntax and output format.

FILES

/dev/dsk/∗ special disk devices

/etc/mtab mount table

/etc/fstab list of normally mounted file system

Museum