display free disk space

df [-b | -h | -H | -k | -m | -g | -P] [-ailn] [-t] [-T type] [file | filesystem ...]

displays statistics about the amount of disk space on the specified filesystem or on the filesystem of which file is a part. If neither a file or a filesystem operand is specified, statistics for all mounted filesystems are displayed (subject to the -t option below).

     -a      Show all mount points, including those that were mounted with the MNT_IGNORE flag.

     -b      Use 512-byte blocks.  override $BLOCKSIZE 

Default -P Use (the default) 512-byte blocks. (supresses inode infomation) -k Use 1024-byte (Kbyte) blocks, Note that this overrides the BLOCKSIZE specification from the environment. -m Use 1048576-byte (Mbyte) blocks. -g Use 1073741824-byte (Gbyte) blocks. -H "Human-readable" output using base 10. suffixes: Byte, Kilobyte, Megabyte, Gigabyte, Terabyte and Petabyte -h "Human-readable" using base 2 for sizes. -i Include the number of free inodes.
-P to suppress this output. -l Only display locally-mounted filesystems. -n ouptput previously obtained statistics. useful if a filesystem is in a state that they will not be able to provide statistics without a long delay. -T type[,…] Only output information for filesystems of the specified types.
More than one type may be specified in a comma separated list. The list types can be prefixed with no to specify types for which action should not be taken. For example
df -T nonfs,mfs
lists all filesystems except those of type NFS and MFS.
With no arguments, this option is a no-op (Mac OS X already prints the total allocated-space figures).
If used with an argument, it acts like -T, but this usage is deprecated and should not be relied upon.


$BLOCKSIZE If the environment variable BLOCKSIZE is set, the block counts will be displayed in units of that size block. BUGS The -n and -t flags are ignored if a file or filesystem is specified. LEGACY DESCRIPTION The "capacity" percentage is normally rounded up to the next higher integer.
In legacy mode, it is rounded down to the next lower integer.

When the -P option and the -k option are used together, sizes are reported in 1024-blocks.
In legacy mode, when the -P option and -k option are used together, the last option specified dictates the reported block size.

The -t option is normally a no-op (Mac OS X already prints the total allocated-space figures).
In legacy mode, it is equivalent to -T. For more information about legacy mode, see compat(5). SEE ALSO lsvfs(1), quota(1), fstatfs(2), getfsstat(2), statfs(2), getmntinfo(3), compat(5), fstab(5), mount(8), quot(8) o