df
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 filesystem or on the filesystem where file exists.

If neither file nor filesystem is specified, statistics for all mounted filesystems are displayed (subject to -T).

`-a`	Show all mount points, including those mounted with `MNT_IGNORE` .
`-P`	supresses inode infomation
`-b`	Use 512-byte blocks. override `$BLOCKSIZE` Default
`-k`	Use Kbyte 1,024-byte blocks, overrides `$BLOCKSIZE`
`-m`	Use Mbyte 1,048,576-byte blocks.
`-g`	Use Gbyte 1,073,741,824-byte blocks.
`-H`	"Human-readable" output using base 10. suffixes: `B`yte, `K`ilobyte, `M`egabyte, `G`igabyte, `T`erabyte and `P`etabyte
`-h`	"Human-readable" using base 2 for sizes. Unaligned, with varying blocksize. /bin/df -nPH Filesystem Size Used Avail Capacity Mounted on /dev/disk2s1 40G 28G 11G 73% / devfs 353k 353k 0B 100% /dev /dev/disk0s3 650M 559M 91M 87% /Volumes/Recovery HD /dev/disk1s5 37G 11G 8.3G 58% /Volumes/Photos
`-l`	Only display locally-mounted filesystems. Supresses `/dev, /net, /home`
`-n`	network: ouptput previously obtained statistics for `file \| filesystem`. May return `999999` for size. Useful if a network causes delays.
`-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 If `type` is not specified, display includes the type /bin/df -T Filesystem Type 1K-blocks Used Available Use% Mounted on /dev/root ext4 6389188 5923676 168272 98% / devtmpfs devtmpfs 217240 0 217240 0% /dev tmpfs tmpfs 221564 0 221564 0% /dev/shm /dev/mmcblk0p3 f2fs 6289408 3233316 3056092 52% /varnew /dev/mmcblk0p1 vfat 41853 22759 19094 55% /boot lists all filesystems except those of type NFS and MFS.
`-i`	Include the number of free inodes. default. `-P` suppresses this .

ENVIRONMENT

$BLOCKSIZE

$COMMAND_MODE

If legacy behaves like Mac OS X 10.3 ,
If unix2003 behave like Version 3 of the Single UNIX Specification (SUSv3)
BUGS The -n and -t 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 truncated to the next lower integer.
When -P and -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 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
lsvfs(1), quota(1), fstatfs(2), getfsstat(2), statfs(2), getmntinfo(3), compat(5), fstab(5), mount(8), quot(8)

Apple File System's free space sharing
In APFS free space is "shared" amongst the volumes in a container.
For example : the container in which HighSierra and Photos exist is 39.44GB although 15+11+8+8 = 42
```
/bin/df -g
Filesystem    1G-blocks Used Available Capacity Mounted on
/dev/disk1s1         36   15         8    66%  /Volumes/HighSierra
/dev/disk1s5         36   11         8    58%  /Volumes/Photos
```
o

df display free disk space

ENVIRONMENT

See

Apple File System's free space sharing

df
display free disk space