Macintosh Terminal Pocket Guide

Name

df — stdin  stdout  - file  -- opt  --help  --version

Synopsis

df [options] [disk devices | files | directories]

The df (disk free) program shows you the size, used space, and free space on a given disk partition. If you supply a file or directory, df describes the disk device on which that file or directory resides. With no arguments, df reports on all mounted filesystems. Here we use the -h option to display in sizes in rounded kilobytes (Ki), gigabytes (Gi), and terabytes (Ti):

➜ df -h
Filesystem     Size   Used  Avail  Capacity  Mounted on
/dev/disk0s2  111Gi   21Gi   90Gi     20%    /
devfs         107Ki  107Ki      0    100%    /dev
/dev/disk1s2  1.8Ti   84Gi  1.7Ti      5%    /Volumes/Music
...

Useful options

-b	List sizes in 512-byte blocks (the default).
-k	List sizes in kilobytes.
-m	List sizes in megabytes.
-h -H	Print human-readable output, and choose the most appropriate unit for each size. For example, if your two disks have 1 gigabyte and 25 kilobytes free, respectively, df -h prints 1G and 25K. The -h option uses powers of 1024, whereas -H uses powers of 1000.
-l	Display only local filesystems, not networked filesystems.
-T type	Display only filesystems of the given type.
-i	Inode mode. Display total, used, and free inodes for each filesystem, instead of disk blocks.