maux
Star on GitHub Buy me a coffee

Manual / df

df(1)

DF(1) General Commands Manual DF(1)

df - report volume block usage

df [-Pk] [file...]

The historical df prints the number of free blocks available on a file system. This maux implementation prints the POSIX -P report, always:

Filesystem 512-blocks Used Available Capacity Mounted on
/mnt/MAUX 8192 1689 6503 21% /mnt/MAUX

There is one row per volume. Filesystem and Mounted on are both the volume path: ProDOS has no device name for a volume. Used is the blocks for all files and Available is Total less Used; the volume's own boot, directory and bitmap blocks count as used. Capacity is the used fraction of the total, rounded up. All three numbers come from one GET_FILE_INFO on the volume directory (the ProDOS 8 Technical Reference Manual: the total is returned in aux_type and the blocks for all files in blocks_used).

With no operand, every volume that is online is listed, in unit order. Only non-floppy units are queried: a 5.25-inch drive is never polled to build the list. An operand names the volume holding it: a path on the volume ("/bin/ls"), a bare volume name ("BASIC"), or a relative path ("bin", "./x"), which is checked to exist and reported against the volume of the working directory. The operand "/" lists every volume, like no operand.

Accepted; the report is always in this form.
Use units of 1024 bytes. Total and Used are halved, rounding up; Available is their difference. Capacity is unchanged. A block is 512 bytes, so the default unit is the block.

/usr/man/DF this page

du(1), licenses(1)

Exit status is 0 if every operand was reported, 1 if any could not be accessed ("df: path: cannot access"), 2 for a usage error.

There are no other Unix df options, and no per-volume device column. A volume that goes offline between listing and query is reported as cannot access.

October 7, 2026 maux